آموزش ثبت ناحیه قالب سایدبار در وردپرس (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، می‌توان بخش‌های مختلف پوسته را ساده‌تر کنترل کرد. این رویکرد، برای توسعه‌دهندگان پوسته و پروژه‌های قابل گسترش بسیار کاربردی است.