افزودن منو به تم در وردپرس - register_nav_menu

register_nav_menu( string $location, string $description )

در تم هایی که طراحی می شوند طبق شرایطی که ایجاد میشود نیاز است در مکان های مختلفی از صفحه یکسری منو های پیمایشی ایجاد شود تا بتوان بخش های مختلفی از سایت را در دسترس نمایش برای کاربران قرار داد, در وردپرس برای ثبت مکان این منوها از این متد استفاده میشود, که بعد از استفاده نام آن در بخش منوهای تنظیمات در منوی نمایش, در دسترس ادمین قرار میگیرد و می تواند آن را به دلخواه سفارشی سازی کند.

#پارامتر ها

• location

این پارامتر از نوع رشته (string) و ضروری می باشد, در این رشته آی دی مکان منو را باید مشخص کنید.

• description

این پارامتر از نوع رشته (string) و ضروری می باشد که در آن می توانید توصیفی درباره منو در آن اضافه کنید.

#اطلاعات بیشتر

• متد register_nav_menus را نیز بررسی کنید تا نحوه اضافه کردن چند منو همزمان را نیز ببینید.
• این متد به صورت اتوماتیک قابلیت پشتیبانی از منوها را در تم فعال میکنید و نیازی نیست تا متد add_theme_support(‘menus’) را فراخوانی کنید.
• این متد در حقیقت برای ثبت منوها از متد register_nav_menus استفاده میکنید به شکل زیر :

register_nav_menus( array( $location => $description ) );

• برای نمایش منو هم باید از متد wp_nav_menu استفاده کنید.

#منبع

آدرس فایل : wp-includes/nav-menu.php

function register_nav_menu( $location, $description ) {
    register_nav_menus( array( $location => $description ) );
}

#نمونه کد

<?php
add_action( 'after_setup_theme', 'register_my_menu' );
function register_my_menu() {
  register_nav_menu( 'primary', __( 'Primary Menu', 'theme-slug' ) );
}
?>

برای استفاده از این متد ابتدا به اکشن (HOOK) after_setup_theme یک متد وصل کنید تا زمانی این اکشن انجام شد متد شما فراخوانی شود و بتوانید به متد ثبت مکان منو دسترسی داشته باشد.