ساخت منوی ادمین برای پلاگین وردپرس

در چند پست اخیر، شروع به کار طراحی پلاگین وردپرس را بررسی کرده و در مورد انواع Hooks هم توضیحاتی داده و مثالی هم در این مورد بررسی کردیم. حال برویم سراغ طراحی و ساخت منوی ادمین برای پلاگین وردپرس، که شاید جذابترین جای بحث باشد.

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

برویم سراغ کد نویسی، برای اینکه شما به وردپرس بفهمانید که ما میخواهیم یک منوی دیگر به داشبورد وردپرس اضافه کنیم از فانکشن add_action و هوک admin_menu استفاده خواهیم کرد. تمامی کدها به شرح ذیل می باشد.

add_action( 'admin_menu', 'add_extra_menu' );  
function add_extra_menu(){    
	$page_title = 'عنوان صفحه پلاگین';   
	$menu_title = 'لینک پلاگین';   
	$capability = 'manage_options';   
	$menu_slug  = 'add_extra_menu';   
	$function   = 'extra_data_for_menu';   
	$icon_url   = 'dashicons-megaphone';   
	$position   = 25;    
	add_menu_page( $page_title,$menu_title,$capability,$menu_slug,$function,$icon_url,$position ); 
} 
function extra_data_for_menu(){
	echo"<div>";
	echo"My plugin";
	echo"</div>";
}

خوب با add_action شما فانکشن add_extra_menu را به هوک admin_menu اضافه می کنیم. حال برویم سراغ فانکشن add_extra_menu، متغیرهای داخل این فانکشت خیلی مهم هستند که به ترتیب آنها را توضیح می دهم.

متغیرهای فانکشن مربوطه

• page_title: عنوان صفحه اختصاصی مربوط به پلاگین
• menu_title: عنوان منو که در دسته بندی سمت راست داشبورد دیده می شود.
• capability: در این مثال برابر با manage_options قرار دادیم که به این معنی است که فقط ادمین امکان مشاهده آن را دارد.
• menu_slug: آدرس یا url که به پلاگین دسترسی خواهیم داشت مثلا: admin.php?page=add_extra_menu
• function: فانکشنی که اطلاعات خاصی را در صفحه مربوطه نمایش می دهد. که در این مثال فانکشن extra_data_for_menu عبارت My plugin در صفحه مربوطه چاپ می کند.
• icon_url: آیکون مربوط به لینک می باشد. برای مشاهده آیکون های دیگر به این صفحه مراجعه کنید.
• position: این متغیر مقدار عددی قبول می کند و هر عدد به معنای موقعیت خاصی در منو می باشد. لیست این اعداد به این شرح است:

2 Dashboard 4 Separator 5 Posts 10 Media 15 Links 20 Pages 25 Comments 59 Separator 60 Appearance 65 Plugins 70 Users 75 Tools 80 Settings 99 Separator

با تغییر دادن این اعداد می توانید موقعیت های مختلف قرار گیری منو را امتحان کنید. و در نهایت می رسیم به فانکشن add_menu_page که کار نهایی ساخت منوی پلاگین را انجام می دهد.

جهت سفارش پلاگین وردپرس به این صفحه مراجعه نمایید.