آموزش جامع مدیریت و بهبود تابع the_excerpt وردپرس

سلام دوستان خوبم.در آموزش امروز قصد داریم بر روی خلاصه مطالب مدیریت داشته باشیم.منظور من را زمانی می فهمید که مثلا در یک باکس می خواهید تعداد خاصی از کلمات به صورت کامل نمایش داده بشه.

باید بدانید که در حالت عادی با قرار دادن دستور زیر :

[php]

<?php the_excerpt(); ?>

[/php]

بطور خلاصه به نمایش مطالب می پردازیم که این خاصیت بیشتر در صفحات archive.php یا صفحه اول دیده میشود تا بتوان بطور خلاصه تعداد مطالب بیشتری را نمایش داد.امیدوارم تا اینجا در جریان قرار گرفته باشید که چیکار میخواهیم بکنیم.برای شروع کار فایل functions.php خود را باز کنید و اگر ندارید بسازید و کد زیر را در آن قرار دهید :

[php]// 3zar.ir excerpt length.
function print_excerpt($length) { // Max excerpt length. Length is set in characters
global $post;
$text = $post->post_excerpt;
if ( ” == $text ) {
$text = get_the_content(”);
$text = apply_filters(‘the_content’, $text);
$text = str_replace(‘]]>’, ‘]]>’, $text);
}
$text = strip_shortcodes($text); // optional, recommended
$text = strip_tags($text); // use ‘ $text = strip_tags($text,'<p><a>’); ‘ if you want to keep some tags

$text = substr($text,0,$length);
$excerpt = reverse_strrchr($text, ‘.’, 1);
if( $excerpt ) {
echo apply_filters(‘the_excerpt’,$excerpt);
} else {
echo apply_filters(‘the_excerpt’,$text);
}
}

// Returns the portion of haystack which goes until the last occurrence of needle
function reverse_strrchr($haystack, $needle, $trail) {
return strrpos($haystack, $needle) ? substr($haystack, 0, strrpos($haystack, $needle) + $trail) : false;
}
[/php]

توضیح : شما در کد بالا تابعی تعریف میکنید با نام “print_excerpt” که می توانید در هر جا که خواستید داخل حلقه while جهت نمایش مطالب آن را فراخوانی کنید.

خوب حالا در مکانی که میخواهین خلاصه مطلب را نمایش بدید به جای دستورات زیر :

[php]

<?php the_excerpt(); ?>

یا

<?php the_content(); ?>

[/php]

از دستور زیر استفاده کنید :

[php]

<?php print_excerpt(50); ?>

[/php]

درکد بالا بنا به نیاز عدد 50 را تغییر دهید.

روش دوم : خوب دوستان عزیز شما تا اینجا با روش خلاصه کردن آشنا شدید, میخواهم روش دیگری که با آموزش بالا فرق دارد را بهتون یاد بدم که جالب تر است.

ابتدا بهتر بدونیم بدونیم تابع excerpt از کجا فراخوانی میشود.این تابع در فایل مورد نظر در مسیر زیر قرار دارد :

[php]

wp-includes/formatting.php

[/php]

در خط 2111 تابع wp_trim_excerpt را مشاهده میکنید که کد زیر را دارد :

[php]

function wp_trim_excerpt($text = ”) {
$raw_excerpt = $text;
if ( ” == $text ) {
$text = get_the_content(”);

$text = strip_shortcodes( $text );

$text = apply_filters(‘the_content’, $text);
$text = str_replace(‘]]>’, ‘]]&gt;’, $text);
$excerpt_length = apply_filters(‘excerpt_length’, 55);
$excerpt_more = apply_filters(‘excerpt_more’, ‘ ‘ . ‘[…]’);
$text = wp_trim_words( $text, $excerpt_length, $excerpt_more );
}
return apply_filters(‘wp_trim_excerpt’, $text, $raw_excerpt);
}

[/php]

دوستان خوبم توجه کنید ما نمی خواهیم هسته وردپرس را از بین ببریم.خوب حالا از کد بالا یک کپی بگیرید و فایل functions.php را باز کنید و کد را در آن بگزارید.کار ما شروع میشود این تابع در خط اول با نام

[php]

wp_trim_excerpt()

[/php]

فراخوانی میشود.پس اول اسم آن را به

[php]

improved_trim_excerpt()
[/php]

تغییر دهید.شما الان در خط اول باید کدی مطابق زیر داشته باشید :

[php]

function improved_trim_excerpt($text) {

[/php]

حالا بر روی کد بصورت تخصصی تر کار میکنیم.میخواهیم طول کلمات چکیده و خلاصه مطلب را زیاد کنیم, برای این کار در خط 8 کد بالا متغییری بصورت زیر تعریف شده است :

[php]

$excerpt_length = 55;
[/php]

که شما میتوانید تعداد کلمات را با تغییر عدد 55 افزایش یا کاهش دهید.
خوب حالا میخواهیم یه مشکل دیگه خلاصه مطلب را برطرف کنیم آن هم در پاراگراف بندی است. برای این کار کد زیر را در 8 جایگزاری نمائید:

[php]

$text = strip_tags($text, ‘<p>’);
[/php]

شما می توانید تعداد تگ های بیشتری هم بدین طریق اضافه کنید.حالا میخواهیم روی کد های جاوا اسکریپت کار کنیم.معمولا اگه دیده باشید اگر در خط های اول نوشته های مطالبتون کدی گذاشته باشید که کاربرا آن را ببینند وقتی خلاصه اون را نمایش میدهید ظاهر آن جالب نیست و برای حل این مشکل استفاده از کد زیر راهکار خوبی است, در خط 8 کد زیر را جایگزاری نمائید :

[php]

$text = preg_replace(‘@<script[^>]*?>.*?</script>@si’, ”, $text);
[/php]

بسیار خوب دوستان خوبم, تا اینجا کار ما به پایان رسیده است. حال برای اینکه ببینید نتیجه کارتان را خروجی کد های بالای شما پس از تغییر باید چیزی شبیه این باشد :

[php]

function improved_trim_excerpt($text) {
global $post;
if ( ” == $text ) {
$text = get_the_content(”);
$text = apply_filters(‘the_content’, $text);
$text = str_replace(‘\]\]\>’, ‘]]&gt;’, $text);
$text = preg_replace(‘@<script[^>]*?>.*?</script>@si’, ”, $text);
$text = strip_tags($text, ‘<p>’);
$excerpt_length = 80;
$words = explode(‘ ‘, $text, $excerpt_length + 1);
if (count($words)> $excerpt_length) {
array_pop($words);
array_push($words, ‘[…]’);
$text = implode(‘ ‘, $words);
}
}
return $text;
}

[/php]

خوب برای پایان کار باید به این هسته وردپرس بگوئیم که از از تابع جدید ما یعنی improved_trim_excerpt بجای wp_trim_excerpt استفاده کند.چاره کار در اضافه کردن 2 خط کد زیر است, اول برای عدم فراخوانی و دومی برای فراخوانی :

[php]

remove_filter(‘get_the_excerpt’, ‘wp_trim_excerpt’);
add_filter(‘get_the_excerpt’, ‘improved_trim_excerpt’);

[/php]

بسیار خوب کد نهایی شما این چنین می شود :

[php]

remove_filter(‘get_the_excerpt’, ‘wp_trim_excerpt’);
add_filter(‘get_the_excerpt’, ‘improved_trim_excerpt’);
function improved_trim_excerpt($text) {
global $post;
if ( ” == $text ) {
$text = get_the_content(”);
$text = apply_filters(‘the_content’, $text);
$text = str_replace(‘\]\]\>’, ‘]]&gt;’, $text);
$text = preg_replace(‘@<script[^>]*?>.*?</script>@si’, ”, $text);
$text = strip_tags($text, ‘<p>’);
$excerpt_length = 80;
$words = explode(‘ ‘, $text, $excerpt_length + 1);
if (count($words)> $excerpt_length) {
array_pop($words);
array_push($words, ‘[…]’);
$text = implode(‘ ‘, $words);
}
}
return $text;
}
[/php]

کار تمام شد حالا شما از تابع زیر در هر جا که میخواهید استفاده کنید:

[php]

<?php the_excerpt(); ?>

[/php]

امیدوارم از این آموزش استفاده لازم را ببرید.
شادی از آن لحظه های شما …