Open Graph

توضیحات

این پروتکل Graph را باز کنیدl هر صفحه وب را قادر می سازد تا به یک شی غنی در یک گراف اجتماعی تبدیل شود. مهمتر از همه، این اجازه می دهد تا این صفحات با فیس بوک استفاده شوند مانند دکمه و Graph API و همچنین در پست های توییتر.

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

این افزونه به طور مستقیم افزونه های اجتماعی مانند دکمه لایک فیس بوک را به صفحات شما اضافه نمی کند (اگرچه اضافه کردن آنها بسیار ساده است). با این حال، هنگامی که با استفاده از این نوع ابزارها به اشتراک گذاشته می شود، صفحات شما عالی به نظر می رسند.

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

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

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

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

دو راه اصلی برای ارائه فراداده Open Graph از افزونه یا موضوع شما وجود دارد. ابتدا می توانید فیلتر را برای یک ویژگی خاص پیاده سازی کنید. این فیلترها به شکل opengraph_{name} هستند که در آن {name} نام دارایی Open Graph غیرمجاز است. برای مثال، اگر افزونه‌ای دارید که نوع پست سفارشی به نام «فیلم» را تعریف می‌کند، می‌توانید با استفاده از تابعی مانند «نوع» ویژگی Open Graph را برای آن پست‌ها لغو کنید:

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

این برای تمام ویژگی های اصلی Open Graph کار خواهد کرد. با این حال، اگر می خواهید یک ویژگی سفارشی مانند ‘fb:admin’ اضافه کنید، باید به فیلتر opengraph_metadata متصل شوید. این فیلتر از یک آرایه انجمنی عبور می کند که کلیدهای آن نام ویژگی های Open Graph واجد شرایط هستند. مثلا:

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

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

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

این افزونه به طور پیش فرض ویژگی متا ‘name’ را در کنار ویژگی ‘property’ پر می کند. از آنجایی که هر دو نام og:* و twitter:* در واقع در https://wiki.whatwg.org/wiki/MetaExtensions ثبت شده اند، این مورد مطابق با مشخصات HTML5 اگر به هر حال می‌خواهید از روش سخت‌گیرانه‌تری استفاده کنید، می‌توانید حالت scrict را با افزودن خط زیر به config.php خود فعال کنید.

define( 'OPENGRAPH_STRICT_MODE', true );

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

آکتوبر 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.
آگست 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.
جولای 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!
جون 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.
خواندن تمامی 12 نقد و بررسی‌

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

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

مشارکت کنندگان

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

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

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

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

Project maintained on github at pfefferle/wordpress-opengraph.

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)

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)
  • جایگزین کردن $post->post_title with get_the_title() (دیدن #17 برای جزئیات)

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)

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