توضیحات
این پروتکل 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 );
نقد و بررسیها
توسعه دهندگان و همکاران
“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)
- رفع مشکل هشدار 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)
- جایگزین کردن
$post->post_title
withget_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)
- انتشار عمومی اولیه