وردپرس (WordPress) Filter Hook (the_content) پلتفرم: wordpress مبتدی (Easy) سطح ریسک: پایین و بی‌خطر (Low Risk)

افزودن محتوا و اعلان خودکار به ابتدای مقالات وردپرس (Content Before Post)

تست‌شده و بازبینی‌شده در 1405/06/29 ۷۳۶ بار کپی ۱۰۱۰ مشاهده
پاسخ سریع و خلاصه کاربردی (Quick Answer)

با فیلتر `the_content` باکس اخطار یا اعلان را قبل از `$content` الحاق کنید.

مشخصات فنی و شناسنامه کد (Code Information)

بازبینی: 1405/06/29
پلتفرم اجرایی (Platform) wordpress
نوع کد (Code Type) Filter Hook (the_content)
محل قرارگیری فایل (Location) functions.php
سطح دشواری (Difficulty) مبتدی (Easy)
سطح ریسک (Risk Level) پایین و بی‌خطر (Low Risk)
نیاز به بکاپ اولیه؟ خیر (کم‌ریسک)
سازگاری با وردپرس تمامی نسخه‌ها
سازگاری با ووکامرس و HPOS سازگار
|
<?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 ذخیره کنید.

مسیر فایل: functions.php

این کد چگونه کار می‌کند؟ (How it Works)

متن اعلان قبل از بدنه اصلی مقاله قرار گرفته و به عنوان اولین بخش از محتوای the_content به مرورگر ارسال می‌شود.

چه زمانی از این کد استفاده کنیم؟ (Use Cases)

برای درج اخطارهای بروزرسانی، سلب مسئولیت حقوقی، یا اعلان مهم در مقالات.

چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)

اگر قصد دارید فقط در یک نوشته خاص پیام بگذارید (در این صورت از بلاک‌های گوتنبرگ استفاده کنید).

پیش‌نیازهای اجرا

وردپرس ۳.۰ به بالا.

نحوه تست و اطمینان از عملکرد

یکی از مقالات را باز کنید؛ اعلان زرد رنگ در ابتدای متن مشاهده خواهد شد.

نحوه بازگردانی سریع (Rollback)

کد را حذف کنید.

خطاهای رایج و راه‌حل رفع

فراموش کردن برگرداندن return $content که باعث سفید شدن کل متن مقاله می‌شود.

ملاحظات و نکات امنیتی

عدم استفاده از ورودی‌های ناامن کاربر در متن اعلان.

تاثیر بر سرعت و پرفورمنس

سبک و بدون کوئری دیتابیس.

پرسش‌های متداول پیرامون این کد (FAQ)

خیر، چون شرط is_single تضمین می‌کند کد فقط در صفحه نمایش کامل مقاله اجرا شود.
منابع و مستندات رسمی بررسی‌شده (Official Sources):

سبد خرید شما

0 افزونه

سبد خرید شما خالی است

هنوز محصولی را به سبد خرید اضافه نکرده‌اید. می‌توانید از افزونه‌های اختصاصی ما دیدن فرمایید.

مشاهده فروشگاه افزونه‌ها

ثبت درخواست مشاوره

با تکمیل فرم زیر، کارشناسان فنی بیسکو وب در سریع‌ترین زمان ممکن با شما تماس می‌گیرند.

مشاور
پشتیبانی و مشاوره تخصصی
پاسخگویی سریع کارشناسان
09903336117