چرا سایدبار قالب شما ناپدید می‌شود؟ راهنمای تابع get_sidebar
تابع get_sidebar برای بارگذاری sidebar.php یا نسخه سفارشی در وردپرس؛ بررسی پارامترها، ساختار چندستونه، رفتار در Child Theme و اشتباهات رایج.
7 دقیقه مطالعه
چرا سایدبار در قالب مدرن اهمیت دارد؟
سایدبار در قالب‌های مدرن ممکن است در ظاهر کاهش اهمیت داشته باشد، اما در پروژه‌های محتوامحور، فروشگاهی و خبری همچنان نقش کلیدی ایفا می‌کند. این بخش، فضای ارزشمندی برای نمایش ویجت‌ها، جستجو، دسته‌بندی‌ها، آخرین نوشته‌ها و بخش‌های جانبی فراهم می‌کند. اگر سایدبار به‌درستی بارگذاری نشود، چیدمان قالب ناقص می‌شود و تجربه کاربر آسیب می‌بیند. تابعget_sidebar() ابزار استاندارد وردپرس برای مدیریت این بخش است و شناخت دقیق آن برای هر توسعه‌دهنده قالب ضروری است.
تابع get_sidebar چیست؟
تابعget_sidebar() یک تابع هسته وردپرس است که در فایل wp-includes/general-template.php تعریف شده است. این تابع فایل sidebar.php را از قالب فعال بارگذاری می‌کند و اگر نام فایل سفارشی داده شود، همان فایل را بارگذاری می‌کند.
مکانیزم این تابع مشابه get_footer و get_header است: ابتدا در Child Theme جستجو می‌کند و سپس در Parent Theme. این رفتار امکان Override ساده در Child Theme را فراهم می‌کند.
نکته مهم این است که این تابع تنها فایل را بارگذاری می‌کند؛ ویجت‌ها باید از قبل با register_sidebar ثبت شده باشند.
امضای تابع و پارامترها
امضای این تابع به‌شکل زیر است:function get_sidebar( $name = null ) {
do_action( "get_sidebar", $name );
$templates = array();
if ( isset( $name ) ) {
$templates[] = "sidebar-{$name}.php";
}
$templates[] = 'sidebar.php';
return locate_template( $templates, true, false );
}sidebar-{name}.php می‌گردد و اگر پیدا نشد، به sidebar.php برمی‌گردد.
نکته مهم: این تابع پارامتر آرایه‌ای برای پاس دادن داده ندارد. اگر بخواهید داده به فایل سایدبار بدهید، باید از locate_template مستقیم استفاده کنید یا از متغیرهای جهانی بهره ببرید.
سازوکار داخلی و ترتیب بارگذاری
وقتیget_sidebar() فراخوانی می‌شود، مراحل زیر اجرا می‌شوند:
- هوک get_sidebar با نامک سایدبار اجرا می‌شود
- اگر نامک داده شده باشد، فایل sidebar-{name}.php به فهرست جستجو اضافه می‌شود
- فایل sidebar.php نیز به فهرست اضافه می‌شود
- تابع locate_template ابتدا در Child Theme، سپس در Parent Theme جستجو می‌کند
- در صورت پیدا شدن، فایل بارگذاری می‌شود
اگر هیچ فایلی پیدا نشود، هیچ خطایی نمایش داده نمی‌شود اما بخشی از چیدمان ناقص می‌ماند.
ثبت سایدبار با register_sidebar
پیش از استفاده ازget_sidebar، باید سایدبارها با register_sidebar ثبت شده باشند. این کار معمولاً در هوک widgets_init انجام می‌شود.
نمونه ثبت سایدبار اصلی:
add_action( 'widgets_init', 'mytheme_register_sidebars' );
function mytheme_register_sidebars() {
register_sidebar( array(
'name' => __( 'سایدبار اصلی', 'mytheme' ),
'id' => 'primary-sidebar',
'description' => __( 'سایدبار کنار محتوای اصلی', 'mytheme' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
) );
}id) باید انگلیسی و یکتا باشد. برای مطالعه بیشتر درباره ثبت ویجت سفارشی، به راهنمای register_widget و راهنمای WP_Widget مراجعه کنید.
کاربردهای عملی در چیدمان
الگوی استاندارد در فایل‌های قالب:<div class="content-area">
<main class="site-main">
<?php while ( have_posts() ) : the_post(); ?>
<?php get_template_part( 'parts/content' ); ?>
<?php endwhile; ?>
</main>
<?php get_sidebar(); ?>
</div>get_sidebar( 'shop' );sidebar-shop.php می‌گردد و اگر پیدا نشد، از sidebar.php استفاده می‌کند.
نمونه ساده فایل sidebar.php:
<aside id="secondary" class="widget-area">
<?php if ( is_active_sidebar( 'primary-sidebar' ) ) : ?>
<?php dynamic_sidebar( 'primary-sidebar' ); ?>
<?php endif; ?>
</aside>dynamic_sidebar مسئول نمایش ویجت‌های ثبت‌شده در یک سایدبار مشخص است. اگر این تابع فراخوانی نشود، ویجت‌ها نمایش داده نمی‌شوند.
نمایش شرطی سایدبار
در برخی طراحی‌ها، سایدبار در همه صفحات نمایش داده نمی‌شود. برای کنترل این رفتار، از شرایط وردپرس استفاده کنید:if ( is_active_sidebar( 'primary-sidebar' ) && ! is_page_template( 'templates/full-width.php' ) ) {
get_sidebar();
}رفتار در Child Theme
تابعget_sidebar ابتدا در Child Theme جستجو می‌کند. برای سفارشی‌سازی سایدبار در Child Theme، فایل sidebar.php را از Parent به Child کپی و ویرایش کنید.
اگر بخواهید تنها یک سایدبار خاص را سفارشی کنید، مثلاً sidebar-shop.php، فقط همان فایل را در Child بسازید و بقیه سایدبارها از Parent بارگذاری می‌شوند.
برای مطالعه درباره ساختار Child Theme به راهنمای get_stylesheet_directory و راهنمای get_template_directory مراجعه کنید.
نکات امنیتی و اشتباهات رایج
اشتباه اول، نبود فایلsidebar.php است. اگر این فایل وجود نداشته باشد، get_sidebar هیچ خطایی نمی‌دهد اما چیدمان ناقص می‌ماند.
اشتباه دوم، نبود شرط is_active_sidebar است. اگر سایدبار ویجتی نداشته باشد، فضای خالی نمایش داده می‌شود. همیشه این شرط را بررسی کنید.
اشتباه سوم، نبود dynamic_sidebar در فایل سایدبار است. اگر این تابع فراخوانی نشود، ویجت‌ها حتی پس از ثبت، نمایش داده نمی‌شوند.
اشتباه چهارم، نبود escape در خروجی است. اگر در سایدبار اطلاعات پویا چاپ می‌کنید، از توابع escape استفاده کنید. راهنمای این تابع در صفحه esc_html آمده است.
اشتباه پنجم، نبود تست موبایل است. سایدبار در موبایل معمولاً به پایین صفحه منتقل می‌شود یا پنهان می‌شود. باید این رفتار را تست کنید.
اشتباه ششم، نبود توجه به ترتیب بارگذاری است. سایدبار معمولاً پس از محتوای اصلی و پیش از فوتر بارگذاری می‌شود.
اشتباه هفتم، نبود توجه به Accessibility است. ساختار سایدبار باید با تگ aside و برچسب مناسب طراحی شود.
تحلیل فنی پیشرفته
در نگاه مهندسی، تابعget_sidebar() یک نقطه معماری در لایه رندر است که بر چند جنبه از سیستم اثر می‌گذارد. لایه اول لایه Override است. مکانیزم locate_template امکان تعریف سایدبارهای متعدد و اختصاصی را فراهم می‌کند و این ساختار در پروژه‌های بزرگ با چند نوع صفحه بسیار کاربردی است.
لایه دوم لایه اتصال Widget است. سایدبارها در واقع نقاطی برای نمایش ویجت‌ها هستند و تابع dynamic_sidebar این اتصال را برقرار می‌کند. بدون این اتصال، سایدبار تنها یک ظرف خالی است.
لایه سوم لایه کشینگ است. خروجی سایدبار معمولاً کش می‌شود اما اگر ویجتی داده‌های پویا نمایش دهد (مانند آخرین دیدگاه‌ها)، باید استراتژی کش مناسب انتخاب شود.
لایه چهارم لایه امنیت است. ویجت‌هایی که توسط کاربر یا افزونه‌ها ثبت می‌شوند، ممکن است کد ناامن داشته باشند. باید در انتخاب افزونه‌های ویجت، کیفیت و امنیت را در نظر بگیرید.
لایه پنجم لایه Performance است. سایدبار می‌تواند شامل کوئری‌های اضافی باشد (مانند آخرین نوشته‌ها، محبوب‌ترین‌ها). این کوئری‌ها در هر بار بارگذاری صفحه اجرا می‌شوند و می‌توانند سرعت را کاهش دهند. استفاده از کش توصیه می‌شود.
لایه ششم لایه Responsive است. در موبایل، سایدبار معمولاً به پایین صفحه منتقل می‌شود. این رفتار با CSS Grid یا Flexbox و Media Query پیاده می‌شود.
لایه هفتم لایه Accessibility است. سایدبار باید با تگ aside و برچسب مناسب طراحی شود و مدیریت فوکوس کیبورد در آن رعایت شود.
لایه هشتم لایه Multisite است. در شبکه‌های Multisite، هر سایت می‌تواند ویجت‌های متفاوتی داشته باشد و get_sidebar در هر سایت بر پایه داده‌های همان سایت کار می‌کند.
مفاهیم پایه‌ای چیدمان وب در Page Layout در ویکی‌پدیا توضیح داده شده است.
برای مطالعه بیشتر روی توابع مرتبط، می‌توانید به راهنمای get_header، راهنمای get_footer، راهنمای get_template_part، راهنمای body_class، راهنمای register_widget و راهنمای register_sidebar مراجعه کنید.
پرسش‌های پرتکرار
تفاوتget_sidebar و dynamic_sidebar چیست؟ اولی فایل sidebar.php را بارگذاری می‌کند و دومی ویجت‌های یک سایدبار را نمایش می‌دهد.
آیا get_sidebar خطا می‌دهد اگر فایل نباشد؟ خیر، خطا نمی‌دهد اما بخشی از چیدمان ناقص می‌ماند.
چطور سایدبار را در Child Theme سفارشی کنیم؟ با کپی sidebar.php از Parent به Child.
آیا می‌توان چند سایدبار در یک صفحه داشت؟ بله، با فراخوانی get_sidebar با نامک‌های مختلف و ثبت سایدبارهای متعدد.
چطور سایدبار را در موبایل پنهان کنیم؟ با CSS Media Query و کلاس مخصوص.
نتیجه و مسیر ادامه
تابعget_sidebar() ابزار استاندارد وردپرس برای بارگذاری فایل سایدبار است. استفاده درست از آن یعنی ترکیب با register_sidebar، بررسی is_active_sidebar، استفاده از dynamic_sidebar در فایل و طراحی موبایل مناسب. اشتباه‌های کوچک در این تابع اغلب به ناپدید شدن سایدبار یا شکستن چیدمان منجر می‌شوند.
اگر این تابع را در پروژه‌ای واقعی به کار برده‌اید و رفتار غیرمنتظره‌ای دیده‌اید — به‌خصوص در ترکیب با Child Theme یا طراحی موبایل — تجربه‌تان می‌تواند راهگشای دیگران باشد. کدام بخش بیشترین زمان را از شما گرفت؟ دیدگاه خود را بنویسید.
سعید کریمه
نویسنده
نویسنده در وردپرس کار.