افزودن محتوا و اعلان خودکار به ابتدای مقالات وردپرس (Content Before Post)
با فیلتر `the_content` باکس اخطار یا اعلان را قبل از `$content` الحاق کنید.
مشخصات فنی و شناسنامه کد (Code Information)
بازبینی: 1405/06/29<?php
/**
* افزودن کادر اطلاعرسانی مهم به بالاتر از متن اصلی تمام مقالات
*/
function bisco_prepend_content_before_post( $content ) {
if ( is_single() && is_main_query() && 'post' === get_post_type() ) {
$notice_box = '
<div class="bisco-before-post-notice" style="background:#fffbeb; border-right:4px solid #f59e0b; padding:12px 16px; margin-bottom:24px; border-radius:4px;">
<p style="margin:0; font-size:14px; color:#92400e;">
<strong>نکته فنی:</strong> کدهای این مقاله برای PHP 8.2 و بالاتر و آخرین نسخه پایدار وردپرس بازبینی و تایید شدهاند.
</p>
</div>';
$content = $notice_box . $content;
}
return $content;
}
add_filter( 'the_content', 'bisco_prepend_content_before_post' );
کد را کجا قرار دهیم؟ (Placement Guide)
کد را در functions.php ذخیره کنید.
این کد چگونه کار میکند؟ (How it Works)
متن اعلان قبل از بدنه اصلی مقاله قرار گرفته و به عنوان اولین بخش از محتوای the_content به مرورگر ارسال میشود.
چه زمانی از این کد استفاده کنیم؟ (Use Cases)
برای درج اخطارهای بروزرسانی، سلب مسئولیت حقوقی، یا اعلان مهم در مقالات.
چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)
اگر قصد دارید فقط در یک نوشته خاص پیام بگذارید (در این صورت از بلاکهای گوتنبرگ استفاده کنید).
پیشنیازهای اجرا
وردپرس ۳.۰ به بالا.
نحوه تست و اطمینان از عملکرد
یکی از مقالات را باز کنید؛ اعلان زرد رنگ در ابتدای متن مشاهده خواهد شد.
نحوه بازگردانی سریع (Rollback)
کد را حذف کنید.
خطاهای رایج و راهحل رفع
فراموش کردن برگرداندن return $content که باعث سفید شدن کل متن مقاله میشود.
ملاحظات و نکات امنیتی
عدم استفاده از ورودیهای ناامن کاربر در متن اعلان.
تاثیر بر سرعت و پرفورمنس
سبک و بدون کوئری دیتابیس.