مقتطف WordPress عبر وظيفة the_excerpt() هو ملخص مختصر لمنشور من مدونة WordPress الخاصة بك والذي يظهر حيث يتم استدعاؤه، عادةً على صفحات الأرشيف (الفئات، العلامات، صفحات المؤلف)، نتائج البحث، وفي بعض الحالات، على الصفحة الرئيسية صفحة موقعك، ولكن أيضًا في موجز RSS وفي ما يتم إرساله أحيانًا إلى الشبكات الاجتماعية عبر ملحقات محددة.
افتراضيًا، يستخدم WordPress 55 كلمة كحد أقصى لطول المقتطف. يرجى ملاحظة أن بعض السمات تسمح لك بتعريف هذا المستخرج عبر وظيفة "التخصيص"، لكن البعض الآخر لا يسمح بذلك وفي بعض الأحيان لا تزال بحاجة إلى تخصيص ذلك عبر جزء من التعليمات البرمجية.
وظيفة لتخصيص طول المقتطف من خلال عدد الكلمات
لزيادة حجم هذا المستخرج أو تقليله، إليك طريقة بسيطة لإضافتها إلى ملف function.php الخاص بموضوعك، أو عبر مكون إضافي مثل مقتطفات الشفرة.
وظيفة custom_excerpt_length($length) {
العودة 100؛ // قم بتغيير هذا الرقم إلى طول الاستثناء المطلوب
}
add_filter('excerpt_length', 'custom_excerpt_length', 999);
في هذا المقتطف نحدد وظيفة جديدة تسمى "custom_excerpt_length" والتي تستدعي وظيفة طول WordPress، والتي تحدد طول مقتطف من منشور أو صفحة WordPress، والتي قمنا بضبطها على "100" كلمة على سبيل المثال، عبر تعليمات "return" ، وبعد ذلك نضيف هذا الفلتر الجديد مع المعلمة 999 للتأكد من أنه يأتي بعد أي مرشح آخر محتمل يحتوي على تعليمات متناقضة بشأن وظيفة "الطول" للمستخلص.
لكن كن حذرًا، لكي يتم أخذ ذلك في الاعتبار من جانب السمة، تأكد من أن السمة الخاصة بك تستدعي الوظيفة استثناء في مكان ما تريد أن يظهر فيه مقتطف المقالة في حلقتك، عبر الكود <?php echo get_excerpt(); ?>
هناك أيضًا طريقة أخرى لتخصيص طول مقتطف منشور WordPress، والذي يعتمد على عدد الفقرات.
وظيفة لتخصيص طول المقتطف عبر عدد الفقرات
تعتبر هذه الميزة مفيدة بشكل خاص إذا كنت تريد تجنب قطع الجملة في المنتصف. للقيام بذلك، انسخ هذا الجزء من التعليمات البرمجية والصقه في ملف "functions.php" الخاص بك، أو عبر ملحق Code Snippets أو أي مكون إضافي آخر يسمح بإضافة وظائف PHP إلى تثبيت WordPress الخاص بك:
add_filter( "wp_trim_excerpt", "استثناء_مخصص", 10, 2 );
وظيفة my_custom_exception($text, $raw_excerpt) {
لو( ! $raw_excerpt ) {
محتوى $ = Apply_filters( 'المحتوى', get_the_content() );
$text = اسم( محتوى $, 0, com.strpos( محتوى $, '</p>' ) + 4 );
}
يعود $text;
باستخدام وظيفة wp_trim_excerpt، يتجاوز WordPress طول المقتطف من حيث الكلمات أو الأحرف ويعتبر الفقرة الأولى هي المقتطف، بل إنه يعمل مع Elementor.