آشنایی با هوک get_the_excerpt در وردپرس
هوکها در وردپرس به ما این امکان را میدهند که قابلیتی را به سیستم اضافه کنیم یا عملکردهای موجود را تغییر دهیم. یکی از هوکهای مفید در وردپرس، هوک get_the_excerpt
است. این هوک هنگامی فراخوانی میشود که تابع the_excerpt()
اجرا میشود. در واقع، این هوک به ما اجازه میدهد تا متن خلاصه پستها را سفارشی کنیم.
شما میتوانید از این هوک برای ایجاد تغییرات خاص در متن خلاصه، مانند افزودن یا حذف برخی از عناصر HTML، تغییر متون مرتبط، یا حتی افزودن اطلاعات بیشتر استفاده کنید. این امکان به خصوص برای طراحان و توسعهدهندگان وب که میخواهند وبسایت خود را شخصیسازی کنند، بسیار مفید است.
برای استفاده از get_the_excerpt
، شما به راحتی میتوانید کد زیر را به فایل functions.php قالب خود اضافه کنید. با اضافه کردن این کد میتوانید خلاصه پستهای خود را بصورت دلخواه تغییر دهید.
یکی از مزایای استفاده از هوکها در وردپرس این است که میتوانیم بدون تغییر در هسته اصلی نرمافزار، عملکردها را بهبود دهیم. این قابلیت به ما کمک میکند تا کدهای خود را مرتب نگهداریم و از ایجاد مشکل در نسخههای بعدی جلوگیری کنیم.
نمونه کد
function my_custom_excerpt($excerpt) {
return $excerpt . ' ... ادامه مطلب';
}
add_filter('get_the_excerpt', 'my_custom_excerpt');
توضیحات کد
کد 1: تعریف تابع سفارشی
function my_custom_excerpt($excerpt) {
این خط یک تابع جدید به نام
my_custom_excerpt
تعریف میکند که به عنوان ورودی متن خلاصه را دریافت میکند.کد 2: تغییر متن خلاصه
return $excerpt . ' ... ادامه مطلب';
این خط متن خلاصه را با افزودن عبارت
... ادامه مطلب
به انتهای آن تغییر میدهد.کد 3: افزودن فیلتر
add_filter('get_the_excerpt', 'my_custom_excerpt');
این خط فیلتر
get_the_excerpt
را به تابع my_custom_excerpt
متصل میکند، بنابراین هر بار که the_excerpt()
فراخوانی شود، تابع ما اجرا خواهد شد.