نمایش منو های ثبت شده در تم وردپرس - wp_nav_menu

wp_nav_menu( array $args = array() )

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

#پارامتر ها

•  args

این پارامتر از نوع آرایه و اختیاری می باشد که شامل آرگومان های ارسالی برای سفارشی سازی نمایش آن منو می باشد. مقدار پیش فرض آن یک آرایه می باشد.

• • menu
• این آرگومان می تواند از نوع رشته, عدد یا آبجکت WP_Term باشد که اجازه می دهد یک منوی خاص را انتخاب کرد.
• • menu_class
• این آرگومان یک رشته دریافت می کند که میتواند کلاس های CSS باشند. این کلاس ها به المنت ul اصلی اضافه میشود, مقدار پیش فرض آن menu می باشد.
• • menu_id
•  این آرگومان از نوع رشته می باشد که میتوانید آی دی المنت ul منوی اصلی را با آن تغییر بدهید. مقدار پیش فرض آن slug منو می باشد.
• • container
• این آرگومان از نوع رشته می باشد و برای تغییر المنت اصلی که منو را تشکل می دهد استفاده میشود, المنت پیش فرض آن ul است که بعنوان مثال می توانید به div تغییر بدهید.
• • container_class
• این آرگومان از نوع رشته می باشد و مقدار آن به صورت ‘menu-{menu slug}-container’ به کلاس المنت اصلی اضافه میشود.
• • container_id
• این آرگومان از نوع رشته می باشد که میتوانید آی دی المنت بدنه را با آن تغییر بدهید.
• • container_aria_label
• این آرگومان از نوع رشته می باشد که اتریبیوت aria-label زمانی که بدنه اصلی nav باشد به آن اضافه میشود.
• • fallback_cb
• این آرگومان یک متد یا مقدار false دریافت میکند, اگر منو وجود نداشته باشد این تابع فراخوانی می شود,  مقدار پیش فرض آن ‘wp_page_menu’ می باشد, در صورتی که متد خاصی ندارید مقدار آن را false بگذارید.
• • before
• این آرگومان از نوع رشته می باشد که با آن می توانید متن قبل از تگ لینک را مشخص کنید.
• • after
• این آرگومان از نوع رشته می باشد که با آن می توانید متن بعد از تگ لینک را مشخص کنید.
• • link_before
• این آرگومان از نوع رشته می باشد که با آن می توانید متن قبل از لینک را مشخص کنید.
• • link_after
• این آرگومان از نوع رشته می باشد که با آن می توانید متن بعد از لینک را مشخص کنید.
• • echo
• این آرگومان از نوع بولین می باشد که میتوانید مشخص کنید که محتوا را برگرداند یا آن را چاپ کند.
• • depth
• این آرگومان از نوع عدد می باشد که می توانید مشخص بکنید که تا چه عمقی از منو نمایش داده شود, مقدار پیش فرض آن 0 می باشد که نشان میدهد تمام عمق آن استفاده شود.
• • walker
• این آرگومان از نوع آبجکت می باشد که یک نمونه از کلاس Walker سفارشی شما برای نمایش منو ها می باشد.
• • theme_location
• این آرگومان از نوع رشته می باشد که slugی را که زمانی که از متد register_nav_menu استفاده میکردید باید وارد کنید.
• • items_wrap
• این آرگومان از نوع رشته می باشد که با استفاده از آن مشخص میکند که آیتم ها چگونه چیده شوند. پیش فرض آن یک ul با آی دی و کلاس خاص می باشد.
• • item_spacing
• این آرگومان از نوع رشته می باشد که مشخص میکند که آیا فاصله بین منو ها رعایت شود یا خیر, که مقادیر  ‘preserve’  یا ‘discard’ را قبول میکند و مقدار پیش فرض آن ‘preserve’ می باشد.

#مقدار بازگشتی

این تابع سه نوع پاسخ می تواند برگرداند, زمانی که مقدار echo برابر با true باشد هیچ مقداری برگشت داده نمیشود, اگر مقدار echo برابر با false باشد مقدار رشته برگشت داده میشود و اگر هیچ آیتم یا منو آن یافت نشود مقدار false را برمیگرداند.