توضیحات

The Open Graph protocol enables any web page to become a rich object in a social graph. Most notably, this allows for these pages to be used with Facebook’s Share Button and Graph API as well as within Twitter posts.

پلاگین Open Graph متادیتای Open Graph را در پست‌ها و صفحات وردپرس وارد می‌کند و یک مکانیسم توسعه ساده برای سایر افزونه‌ها و مضامین فراهم می‌کند تا این داده‌ها را لغو کنند یا داده‌های Open Graph اضافی را ارائه دهند.

This plugin does not directly add social plugins like the Facebook Share Button to your pages (though they’re pretty simple to add). It will however make your pages look great when shared using those kinds of tools.

سوالات متداول

چگونه افزونه Open Graph را پیکربندی کنم؟

شما نمی کنید. چیزی برای پیکربندی وجود ندارد و هیچ صفحه مدیریتی وجود ندارد. به‌طور پیش‌فرض، از هر داده استاندارد وردپرس برای پر کردن داده‌های Open Graph استفاده می‌کند. فیلترهای بسیار ساده و در عین حال قدرتمندی وجود دارد که می‌توانید از آنها برای اصلاح یا گسترش ابرداده‌های بازگردانده شده توسط افزونه استفاده کنید که در زیر توضیح داده شده است.

چگونه افزونه Open Graph را گسترش دهم؟

There are two main ways to provide Open Graph metadata from your plugin or theme. First, you can implement the filter for a specific property. These filters are of the form opengraph_{name} where {name} is the unqualified Open Graph property name. For example, if you have a plugin that defines a custom post type named “movie”, you could override the Open Graph type property for those posts using a function like:

function my_og_type( $type ) {
    if ( get_post_type() == "movie" ) {
        $type = "movie";
    }
    return $type;
}
add_filter( 'opengraph_type', 'my_og_type' );

This will work for all of the core Open Graph properties. However, if you want to add a custom property, such as fb:admins, then you would need to hook into the opengraph_metadata filter. This filter is passed an associative array, whose keys are the qualified Open Graph property names. For example:

function my_og_metadata( $metadata ) {
    $metadata['fb:admins'] = '12345,67890';
    return $metadata;
}
add_filter( 'opengraph_metadata', 'my_og_metadata' );

توجه داشته باشید که ممکن است لازم باشد پیشوند RDFa را برای ویژگی های خود تعریف کنید. این کار را با استفاده از فیلتر opengraph_prefixes انجام دهید.

How does the plugin choose the images?

The plugin uses the featured image first, then the images in the post content, then the images attached to the post. If there is no image at all, it uses the site icon, the custom logo or the header image.

By default the plugin adds up to 3 images. You can change that by adding the following line to your wp-config.php

define( 'OPENGRAPH_MAX_IMAGES', 1 );

or with the opengraph_max_images filter. To add or remove image sources, use the opengraph_image_sources filter. Each source is a callable that gets the post ID and returns attachment IDs:

function my_og_image_sources( $sources ) {
    // Only use the featured image.
    return array( 'opengraph_thumbnail_image_ids' );
}
add_filter( 'opengraph_image_sources', 'my_og_image_sources' );

Does it work with Jetpack?

Yes. Jetpack also adds Open Graph metadata, so the plugin disables the Jetpack output to avoid duplicate tags. To get the Jetpack output back, deactivate this plugin.

نحوه فعال/غیرفعال کردن “حالت سخت”

The plugin populates the meta ‘name’ attribute alongside the ‘property’ attribute by default. Because both, the og:* and twitter:* names, are actually registered at https://wiki.whatwg.org/wiki/MetaExtensions, this stays compliant with the HTML5 spec. If you want to use a more strict way anyways, you can enable the strict mode by adding the following line to your wp-config.php

define( 'OPENGRAPH_STRICT_MODE', true );

نقد و بررسی‌ها

Данияр НАУРЫЗ مارچ 10, 2025

Иә, қарапайым әрі мықты қондырма. Бәрі көңілдегідей.

Chise Hachiroku آکتوبر 29, 2024

This plugin does what it says it does – it adds open graph metadata on website. No configuration and do the work just as advertised. Simply excellent.

jvasquez1000 آگست 31, 2023

El plugin funciona muy bien, solo lo instalé y pude compartir los productos de mi tienda en FB sin problema. Hasta ahorita todo bien.

Generasi Muda Khonghucu Indonesia آگست 7, 2022

Very easy to install and add ability to have open graph for my website

MI جولای 26, 2021

Wow thank you for making this plugin!!! I was so stressed about thumbnails errors but now I don't need to worry about it! Thanks!

stargirl1 جون 29, 2021

Great plug-in! I just installed it last night and now the og:image (large image preview) is looking correct on my posts when shared to Facebook. I normally don't leave reviews but noticed this plug-in had very few. It worked like a charm on my website to show the big preview when others (including some well known ones) wouldn't. I was getting frustrated and wasting time googling plug-ins that didn't work on my site for some reason. Finally this one worked! It does what it says, and is very simple to use, no configuration needed.

خواندن تمامی 13 نقد و بررسی‌

توسعه دهندگان و همکاران

“Open Graph” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

ترجمه “Open Graph” به زبان شما.

علاقه‌ مند به توسعه هستید؟

کد را مرور کنید, را بررسی کنید مخزن SVN, یا مشترک شوید گزارش توسعه توسط RSS.

گزارش تغییرات

Project maintained on github at pfefferle/wordpress-opengraph.

3.0.1 (Sep 25, 2026)

fixed a fatal error on ClassicPress, which does not ship the HTML API (#50)

3.0.0 (Sep 18, 2026)

simpler image handling: one pass over the post content, catches gallery, media & text and nested block images
new opengraph_image_sources filter to add or remove image sources
the property filters get the metadata collected so far as second argument
twitter card is summary_large_image whenever the post has an image, summary for the fallback images
use the current page of a multipage post and the  teaser for the description (#9)
fixed merging into an existing prefix attribute
fixed a fatal error with The Events Calendar (#39)
breaking: removed opengraph_block_image, opengraph_parsed_image, opengraph_attached_image, opengraph_ensure_max_image and opengraph_site_supports_blocks (and its filter), use the opengraph_image_sources filter instead
minimum WordPress version is now 6.2
added phpunit tests

2.0.2 (Feb 25, 2025)

Add a constant to easily change the max number of images to be included in the OpenGraph meta tags.

2.0.1 (Dec 16, 2024)

Fixed a warning
Improved opengraph_max_images handling

2.0.0 (Dec 01, 2024)

complete rewrite of image handling
added support for block images
added parsing of HTML <img> tags
improved WordPress Coding Standards compliance

1.12.2 (Nov 17, 2024)

optimized readme and updated dependencies

1.12.1 (Jul 15, 2024)

fix fediverse account normalization

1.12.0 (Jul 3, 2024)

support <meta name="fediverse:creator" />

1.11.3 (Jun 4, 2024)

don’t return description for password protected posts

1.11.2 (Nov 13, 2023)

برچسب‌ها را از عنوان، نام سایت و توضیحات حذف کنید

1.11.1 (Apr 03, 2023)

یک اشتباه تایپی را رفع کرد

1.11.0 (Oct 21, 2021)

مشکل پیوست رفع شد
رفع مشکل PHP 7.4

1.10.0 (Apr 20, 2020)

پشتیبانی اولیه ویدیو
پشتیبانی صوتی اولیه

1.9.0 (Mai 14, 2019)

فقط تصویر ویژه را در صورت موجود نشان دهید
تصاویر هدر را به نماد سایت ترجیح دهید
از آواتار برای صفحات نمایه استفاده کنید
در صورت خالی بودن عنوان، به توضیحات بازگردید
مدیریت کارت توییتر بهتر است

1.8.3 (Jan 27, 2019)

فرار برای ویژگی های از دست رفته اضافه شده است

1.8.2 (Nov 21, 2018)

رفع مشکل هشدار PHP: https://wordpress.org/support/topic/php-warning-count-parameter-must-be-an-array-or-an-object-that-implements-c/

1.8.1 (Nov 19, 2016)

og:image را برای استفاده از اندازه کامل تصویر تغییر دهید (props @torenord)

1.8.0 (Jan 29, 2016)

ویژگی article:author ثابت شد
article:modified_time را اضافه کرد
دسته اول را به عنوان article:section اضافه کرد

1.7.0 (Jan 18, 2016)

تنظیم “حالت سخت” اضافه شده است
توییتر: مدیریت کارت
توییتر اصلی: پشتیبانی خالق
استاندارد کدنویسی وردپرس

1.6 (Dec 30, 2014)

اجرا شد get_the_archive_title و get_the_archive_description (جدید در وردپرس 4.1)
پشتیبانی اولیه از کارت های توییتر (به لطف elroyjetson)
replace $post->post_title with get_the_title() (see #17 for details)

1.5.1 (Nov 13, 2012)

رفع نشانه گذاری opengraph تکراری هنگام استفاده با پلاگین جت پک(واقعی)

1.5 (Nov 13, 2012)

شامل توضیحات در صفحات برچسب و دسته
شامل متاداده نمایه در صفحات نویسنده
رفع اشکال با 404 صفحه شامل مقادیر اضافی og:image است
پاکسازی کد عمومی (از جمله حذف وابستگی به vars جهانی)
هنگام استفاده از پلاگین جت پک، نشانه گذاری opengraph تکراری را برطرف کنید

1.4 (Aug 24, 2012)

توضیحات پیش فرض بهتر
شامل تمام تصاویری که به یک پست پیوست شده اند، باشد تا کاربران بتوانند انتخاب کنند
که هنگام اشتراک گذاری صفحه از آن استفاده کنید. اگر پست دارای تصویر کوچک پست باشد، آن
هنوز به عنوان تصویر اصلی استفاده می شود.

1.3 (May 21, 2012)

فیلتر ‘opengraph_prefixes’ را برای تعریف پیشوندهای اضافی اضافه کنید
ویژگی های پایه جدید را اضافه کنید و برخی از ویژگی های قدیمی را حذف کنید. این یک شکست است
برای هر کسی که از ویژگی های قدیمی استفاده می کند تغییر کند، اما همیشه می تواند باشد
با استفاده از فیلتر ‘opengraph_metadata’ اضافه شد. (برای جزئیات به f476552 مراجعه کنید)
به روز رسانی به بسیاری از مقادیر پیش فرض، به ویژه برای پست ها و صفحات جداگانه
(با تشکر pfefferle)
پشتیبانی اولیه برای مقادیر آرایه اضافه کنید (دیدن d987eb7)

1.2 (Feb 21, 2012)

به جای فضاهای نام XML به نحو پیشوند RDFa جدیدتر بروید (props
پففرل)

1.1 (Nov 7, 2011)

رفع خطای تعریف نشده عملکرد زمانی که طرح زمینه از تصاویر کوچک پست پشتیبانی نمی کند

1.0 (Apr 24, 2010)

انتشار عمومی اولیه

Бұл қондырма жақсы істейді

Excellent and just do the job

Funciona perfectamente bien

Easy Plugin to Add Open Graph

Works amazing!!

worked on my website when others wouldn’t