تابع the_excerpt در وردپرس

تابع the_excerpt() در وردپرس یکی از توابع پرکاربرد برای نمایش خلاصه‌ای از نوشته‌ها یا مطالب است. این تابع معمولاً در صفحه‌های آرشیو، دسته‌بندی‌ها (category)، برچسب‌ها (tag)، نتایج جستجو و صفحه اصلی بلاگ استفاده می‌شود. هدف آن نمایش بخشی کوتاه از محتوا برای جلب توجه کاربر و بهبود تجربه کاربری و سئوی سایت است.

وظیفه تابع the_excerpt()

تابع the_excerpt() خلاصه‌ای از محتوای هر پست را نمایش می‌دهد. اگر نویسنده در بخش ویرایشگر وردپرس، خلاصه (Excerpt) اختصاصی نوشته باشد، همان متن نمایش داده می‌شود. در غیر این صورت، وردپرس به‌صورت خودکار ۵۵ کلمه اول محتوای پست را به عنوان خلاصه تولید می‌کند.

ساختار تابع the_excerpt()

<?php the_excerpt(); ?>

این تابع معمولاً در داخل حلقه (Loop) وردپرس استفاده می‌شود. حلقه، وظیفه دارد نوشته‌ها را از پایگاه داده واکشی و نمایش دهد. بنابراین the_excerpt() فقط درون حلقه معنی دارد.

نمونه ساده استفاده از the_excerpt()

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
    <h2><?php the_title(); ?></h2>
    <div class="post-excerpt">
        <?php the_excerpt(); ?>
    </div>
<?php endwhile; endif; ?>

در این مثال، ابتدا با تابع have_posts() بررسی می‌شود که آیا نوشته‌ای برای نمایش وجود دارد یا خیر. سپس با the_post() داده‌های هر پست فراخوانی شده و در نهایت با the_excerpt() خلاصه مطلب نمایش داده می‌شود.

تفاوت the_excerpt() و the_content()

بنابراین، زمانی که هدف شما نمایش خلاصه‌ای کوتاه برای جذب کاربر است، باید از the_excerpt() استفاده کنید. اما اگر قصد نمایش کامل محتوا را دارید، the_content() گزینه مناسب‌تری است.

تغییر طول خلاصه در the_excerpt()

به‌صورت پیش‌فرض، وردپرس فقط ۵۵ کلمه از متن را نمایش می‌دهد. اگر بخواهید این مقدار را تغییر دهید، می‌توانید از فیلتر excerpt_length در فایل functions.php استفاده کنید:

function custom_excerpt_length( $length ) {
    return 30; // تعداد کلمات مورد نظر
}
add_filter( 'excerpt_length', 'custom_excerpt_length' );

در این مثال، خلاصه به ۳۰ کلمه محدود شده است. مقدار را می‌توانید بر اساس طراحی قالب یا نیاز محتوایی تنظیم کنید.

تغییر عبارت “Continue Reading” یا “ادامه مطلب”

تابع the_excerpt() معمولاً پس از نمایش خلاصه، عبارت “Continue reading” یا “…” اضافه می‌کند. برای تغییر آن از فیلتر excerpt_more استفاده کنید:

function custom_excerpt_more( $more ) {
    return '... <a href="' . get_permalink() . '">ادامه مطلب</a>';
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );

در اینجا، با کلیک روی عبارت «ادامه مطلب»، کاربر به صفحه کامل پست هدایت می‌شود. استفاده از این روش باعث بهبود تجربه کاربری و نرخ کلیک (CTR) می‌شود.

نوشتن خلاصه سفارشی برای هر پست

وردپرس در صفحه ویرایش هر پست، بخشی با عنوان خلاصه (Excerpt) دارد. اگر در آن بخش متنی وارد کنید، همان متن بدون هیچ‌گونه کوتاه‌سازی نمایش داده می‌شود. در غیر این صورت، وردپرس به‌صورت خودکار بخشی از محتوا را خلاصه می‌کند.

حذف تگ‌های HTML از خلاصه

وردپرس به‌صورت پیش‌فرض بیشتر تگ‌های HTML را از متن خلاصه حذف می‌کند تا ساختار سایت حفظ شود. اما اگر بخواهید برخی تگ‌ها (مثل <strong> یا <em>) حفظ شوند، می‌توانید از فیلتر wp_trim_excerpt استفاده کنید:

function custom_excerpt_with_tags( $excerpt ) {
    $allowed_tags = '<strong><em><a>';
    return strip_tags( $excerpt, $allowed_tags );
}
add_filter( 'the_excerpt', 'custom_excerpt_with_tags' );

در این کد، فقط تگ‌های <strong>، <em> و <a> مجاز باقی می‌مانند.

نمایش خلاصه دستی بدون استفاده از the_excerpt()

اگر بخواهید خارج از حلقه وردپرس یا در مکان خاصی از سایت خلاصه را نمایش دهید، می‌توانید از تابع get_the_excerpt() استفاده کنید:

<?php echo get_the_excerpt( $post_id ); ?>

در این روش، مقدار بازگشتی از تابع get_the_excerpt() قابل کنترل است و می‌توان آن را در متغیرها یا سایر توابع استفاده کرد.

نکات مهم و بهترین روش‌ها (Best Practices)

• همیشه تابع the_excerpt() را داخل حلقه اصلی وردپرس استفاده کنید.
• برای کنترل بهتر روی متن خلاصه، حتماً بخش “خلاصه” در ویرایشگر پست‌ها را فعال کنید.
• از فیلترهای excerpt_length و excerpt_more برای شخصی‌سازی استفاده کنید.
• در طراحی قالب، خلاصه را با ساختار HTML مناسب (مثل <p> یا <div>) احاطه کنید تا از نظر CSS بهینه باشد.
• اگر از زبان فارسی استفاده می‌کنید، به جهت نمایش درست “…” و “ادامه مطلب” توجه کنید تا با فونت فارسی هماهنگ باشد.

نمونه نهایی و بهینه‌سازی‌شده در قالب وردپرس

<article class="post-item">
    <h2 class="post-title">
        <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
    </h2>
    <div class="post-meta">
        <span>منتشر شده در: <?php the_date(); ?></span>
    </div>
    <div class="post-excerpt">
        <?php the_excerpt(); ?>
    </div>
</article>

در این ساختار، هر پست با عنوان، تاریخ و خلاصه نمایش داده می‌شود. این قالب برای صفحه اصلی وبلاگ یا آرشیو دسته‌ها بسیار مناسب است و از نظر سئو نیز بهینه محسوب می‌شود.

جمع‌بندی نکات کلیدی

• the_excerpt() تابعی برای نمایش خلاصه مطالب در وردپرس است.
• در صورت عدم وجود خلاصه دستی، وردپرس ۵۵ کلمه اول محتوا را استفاده می‌کند.
• می‌توانید طول و عبارت پایانی خلاصه را با فیلترهای excerpt_length و excerpt_more تغییر دهید.
• بهتر است خلاصه‌ها را دستی بنویسید تا از برش‌های نامناسب و ناقص جلوگیری شود.
• استفاده صحیح از این تابع به بهبود تجربه کاربر و سئو سایت کمک می‌کند.

لطفاً از کمبود ها و مشکلات این محتوا برای ما بنویسید

ارسال