اسکیمای ساختاریافته سازمان و کسبوکار در وردپرس (Organization Schema JSON-LD)
با هوک `wp_head` یک بلاک اسکریپت `application/ld+json` معتبر حاوی اطلاعات برند و شبکههای اجتماعی در صفحه اصلی درج کنید.
مشخصات فنی و شناسنامه کد (Code Information)
بازبینی: 1405/06/29<?php
/**
* تزریق اسکیمای معتبر دادههای سازمان (Organization) به صورت JSON-LD در هدر
*/
function bisco_output_organization_schema() {
// اسکیمای سازمان را منحصراً در صفحه اصلی درج میکنیم تا از تکرار در کل صفحات پرهیز شود
if ( ! is_front_page() ) {
return;
}
$schema = array(
'@context' => 'https://schema.org',
'@type' => 'Organization',
'@id' => esc_url( home_url( '/#organization' ) ),
'name' => get_bloginfo( 'name' ),
'url' => esc_url( home_url( '/' ) ),
'logo' => array(
'@type' => 'ImageObject',
'url' => esc_url( home_url( '/logo.png' ) ), // نشانی مستقیم فایل لوگوی رسمی
'width' => 512,
'height' => 512,
),
'contactPoint' => array(
'@type' => 'ContactPoint',
'telephone' => '+98-21-12345678',
'contactType' => 'customer service',
'areaServed' => 'IR',
'availableLanguage' => array( 'Persian' ),
),
'sameAs' => array(
'https://www.instagram.com/yourbrand',
'https://t.me/yourbrand',
'https://x.com/yourbrand',
'https://www.linkedin.com/company/yourbrand',
),
);
echo '<script type="application/ld+json">' . wp_json_encode( $schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT ) . '</script>' . "
";
}
add_action( 'wp_head', 'bisco_output_organization_schema', 2 );
کد را کجا قرار دهیم؟ (Placement Guide)
کد را در functions.php ذخیره کرده و تلفن، آدرس لوگو و لینکهای شبکههای اجتماعی را ویرایش کنید.
این کد چگونه کار میکند؟ (How it Works)
هنگام تولید هدر صفحه نخست، تابع آرایه دادهها را به ساختار استاندارد Schema.org مپ کرده و با wp_json_encode به صورت امن چاپ مینماید.
چه زمانی از این کد استفاده کنیم؟ (Use Cases)
در تمام وبسایتهای شرکتی، فروشگاهی و برندی برای تقویت سئوی هویتی و ثبت Knowledge Panel.
چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)
اگر افزونه سئو (نظیر یواست یا رنکمث) از قبل این اسکیما را به درستی تولید میکند.
پیشنیازهای اجرا
وردپرس ۳.۰ به بالا و لوگوی ابعاد مربع باکیفیت.
نحوه تست و اطمینان از عملکرد
آدرس صفحه اصلی را در ابزار Google Rich Results Test بررسی کنید؛ باید تاییدیه سبز برای Organization مشاهده شود.
نحوه بازگردانی سریع (Rollback)
کد را حذف کنید.
خطاهای رایج و راهحل رفع
فراموش کردن پروتکل بینالمللی برای تلفن (مانند +98) که استاندارد گوگل را نقض میکند.
ملاحظات و نکات امنیتی
استفاده از wp_json_encode مانع از حملات XSS در تگهای اسکریپت میشود.
تاثیر بر سرعت و پرفورمنس
خروجی متنی بسیار سبک بدون ایجاد درخواست به پایگاه داده اضافی.