هوک get_the_excerpt در وردپرس

wordpress get the excerpt hook
20 آذر 1403

آشنایی با هوک 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() فراخوانی شود، تابع ما اجرا خواهد شد.

سوالات متداول

؟

هوک get_the_excerpt چیه؟

؟

چطور می‌توانم از این هوک استفاده کنم؟

؟

آیا می‌توانم چندین تغییر را روی خلاصه‌ها اعمال کنم؟

؟

آیا هوک‌ها به عملکرد وردپرس آسیب می‌زنند؟