آموزش ثبت ناحیه قالب سایدبار در وردپرس (Template Part Area)

سایدبارها یکی از بخش‌های مهم در طراحی قالب‌های وردپرس هستند. در قالب‌های بلوکی، مدیریت این بخش‌ها ساختارمندتر شده است. برای این کار، لازم است ناحیه قالب به‌درستی تعریف شود. در این مقاله، روش ثبت ناحیه قالب سایدبار در وردپرس با استفاده از هوک فیلتر default_wp_template_part_areas بررسی می‌شود. هدف، آشنایی با یک روش استاندارد و قابل توسعه برای سفارشی‌سازی قالب است.

فهرست مطالب

قطعه کد ثبت ناحیه قالب سایدبار در وردپرس

کد زیر را به فایل functions.php قالب (یا قالب فرزند) خود اضافه کنید و کلمه mytheme را در کد با نامک (slug) قالب (یا قالب فرزند) که نام پوشه آن است جایگزین کنید. اگر با مشکلی مواجه شدید، این مقاله می‌تواند به شما کمک کند: نحوه ویرایش فایل functions.php در قالب‌های وردپرس

/**
 * Registering a custom template part area for sidebars.
 *
 * @param array $areas The template part areas.
 */
function alvandwp_template_part_areas( array $areas ) {
	$areas[] = array(
		'area'        => 'sidebar', // Unique identifier for the area.
		'area_tag'    => 'aside',
		'label'       => esc_html__( 'نوار کناری', 'mytheme' ), // Human-readable label.
		'description' => esc_html__( 'یک قسمت از قالب برای نوارهای کناری.', 'mytheme' ), // Description of the area.
		'icon'        => 'sidebar',
	);

	return $areas;
}
add_filter( 'default_wp_template_part_areas', 'alvandwp_template_part_areas' );

توضیح پارامترهای قطعه کد بالا

1. area با مقدار (sidebar):
   این همان نامک (slug) ناحیه قالب است که برای شناسایی به صورت برنامه‌نویسی شده استفاده می‌شود.
2. area_tag با مقدار (aside):
   این مقدار، تگ HTML است که در خروجی وبسایت استفاده خواهد شد.
3. Label با مقدار (نوار کناری):
   برچسبی خوانا برای انسان برای این ناحیه که در ویرایشگر وردپرس ظاهر می‌شود.
4. Description با مقدار (یک قسمت از قالب برای نوارهای کناری.):
   شرح مختصری از هدف این ناحیه قالب که به کاربران کمک می‌کند تا کاربرد آن را درک کنند.
5. icon با مقدار (sidebar):
   آیکن خاصی که برای ناحیه نوار کناری در ویرایشگر سایت وردپرسی ظاهر می‌شود.

استفاده از ناحیه سفارشی سایدبارها در قالب

پس از ثبت ناحیه قالب سایدبارها (template part area)، می‌توانید با قرار دادن آن در قالب خود، از آن استفاده کنید:

از طریق ویرایشگر کد مورد علاقه‌تان

1. ایجاد یک بخش قالب:
   یک فایل در پوشه parts قالب خود ایجاد کنید (مثل your_theme_root_folder/parts/sidebar.html).
2. ارجاع به بخش قالب:
   برای گنجاندن سایدبار در قالب خود، از بلوک template part (بخش قالب) استفاده کنید:<!-- wp:template-part {"slug":"sidebar","area":"sidebar"} /-->

از طریق ویرایشگر سایت وردپرس

باید هنگام ایجاد یک بخش قالب جدید، ناحیه قالب نوار کناری را انتخاب کنید. برای انجام این کار، وارد پیشخوان مدیریت وردپرس شوید و مراحل زیر را دنبال کنید:

بعد از طراحی این بخش قالب، به قسمت قالب‌ها برگردید، قالب مورد نظر خود را انتخاب کنید و از ابزار درج بلوک برای اضافه کردن آن استفاده کنید.

نتیجه‌گیری

ثبت ناحیه قالب سایدبار در وردپرس به شما کمک می‌کند ساختار قالب را منظم‌تر مدیریت کنید. این روش، انعطاف‌پذیری بیشتری در ویرایش قالب‌های بلوکی فراهم می‌کند. با استفاده از Template Part Area، می‌توان بخش‌های مختلف قالب را ساده‌تر کنترل کرد. این رویکرد، برای توسعه‌دهندگان قالب و پروژه‌های قابل گسترش بسیار کاربردی است.