وردپرس | هوک create_{$taxonomy}

wordpress hooks create taxonomy
27 فروردین 1404

سلام! امروز می‌خواهیم درباره یکی از امکانات فوق‌العاده وردپرس به نام "هوک‌ها" صحبت کنیم. هوک‌ها به شما این امکان را می‌دهند که کدهای شخصی‌سازی شده‌ای را در زمان‌های مشخصی از یک عملیات خاص اجرا کنید. یکی از این هوک‌ها، هوک create_{$taxonomy} است که به شما کمک می‌کند تا به محض ایجاد یک دسته‌بندی یا برچسب جدید (که به عنوان taxonomy شناخته می‌شود) عمل خاصی را انجام دهید.

زمانی که یک taxonomy جدید ایجاد می‌شود، این هوک فعال می‌شود و می‌توانید از آن برای انجام کارهایی مانند ذخیره تنظیمات اضافی یا ایجاد خودکار اطلاعات دیگر استفاده کنید. به‌طور کلی، هوک‌ها به دو دسته اکشن و فیلتر تقسیم می‌شوند که create_{$taxonomy} جزو دسته اکشن‌هاست. این یعنی شما می‌توانید کدی را به تابع خود اضافه کنید که بلافاصله پس از ایجاد taxonomy اجرا شود.

بیایید نگاهی به ساختار این هوک بیندازیم. فرمت آن به شکل create_{$taxonomy} است که در آن {$taxonomy} نام taxonomy شما خواهد بود. به عنوان مثال، اگر شما یک taxonomy به نام "کتگوری" دارید، این هوک به شکل create_category خواهد بود.

حالا به سراغ کد می‌رویم! ما یک تابع ساده برای این هوک ایجاد می‌کنیم تا بتوانیم عملیاتی را به محض ایجاد یک taxonomy جدید اجرا کنیم. در ادامه، کد مورد نظر خود را بررسی خواهیم کرد و با مثال‌هایی نشان می‌دهیم که چگونه می‌توان این هوک را پیاده‌سازی کرد.

function my_custom_function( $term_id ) {
// این تابع یک عمل خاص را پس از ایجاد taxonomy جدید انجام می‌دهد
$term = get_term( $term_id ); // اطلاعات taxonomy جدید را دریافت می‌کنیم
// می‌توانیم کارهای دیگری مانند ذخیره اطلاعات یا ارسال ایمیل انجام دهیم
}
add_action( 'create_category', 'my_custom_function' ); // این هوک را به تابع اضافه می‌کنیم

بیایید کد بالا را خط به خط بررسی کنیم:

تحلیل خط به خط کد

function my_custom_function( $term_id ) {
ابتدا یک تابع به نام my_custom_function ایجاد می‌کنیم که یک پارامتر به نام $term_id می‌گیرد. این پارامتر شناسه taxonomy جدید است.

$term = get_term( $term_id );
در این خط، ما از تابع get_term برای دریافت اطلاعات taxonomy جدید استفاده می‌کنیم. این اطلاعات شامل نام، توضیحات و غیره می‌باشد.

add_action( 'create_category', 'my_custom_function' );
در آخرین خط، ما هوک create_category را به تابع خود my_custom_function متصل می‌کنیم. به این ترتیب، به محض ایجاد یک برچسب جدید، تابع ما اجرا می‌شود.

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

؟

هوک create_{$taxonomy} چه کاربردی دارد؟

؟

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

؟

آیا می‌توانم چندین تابع برای یک هوک داشته باشم؟

؟

چطور می‌توان اطلاعات taxonomy را در هوک دسترسی پیدا کرد؟