تابع فعال سازی افزونه وردپرس

وردپرس دارای یکسری توابع رایج است که شما می توانید از آنها در تمام افزونه هایی که توسعه می دهید از آنها استفاده کنید .

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

تابع فعال سازی افزونه زمانی اجرا می شود که افزونه در وردپرس فعال می شود .

تابع فعال سازی افزونه وردپرس register_activation_hook() نام دارد .

یکی از کاربردهای اصلی این تابع ، تنظیم گزینه های پیش فرض افزونه شما می باشد .

همچنین تایید می کند که نسخه وردپرس با افزونه شما سازگار است .

این تابع 2 پارامتر را دریافت می کند که در زیر به بررسی آنها می پردازیم :

<?php register_activation_hook( $file, $function ); ?>

1	<?php register_activation_hook( $file, $function ); ?>

پارامتر $file – الزامی و رشته ای است و به فایل اصلی افزونه اشاره می کند .

پارامتر $function – الزامی و رشته ای است و تابعی است که در زمان فعال شدن افزونه اجرا می شود .

به مثال زیر توجه کنید :

<?php

register_activation_hook( __FILE__, ‘boj_myplugin_install’ );

function boj_myplugin_install() {

//do cool activation stuff

}

?>

<?php

register_activation_hook( __FILE__, ‘boj_myplugin_install’ );

function boj_myplugin_install() {

//do cool activation stuff

}

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

اکنون که شما عملکرد تابع register_activation_hook() را یاد گرفتید ، به یک مثال واقعی توسط این تابع دقت کنید . در این مثال سازگار بودن نسخه فعلی وردپرس با افزونه بررسی می شود .

<?php
register_activation_hook( __FILE__, ‘rwpp_install’ );
function rwpp_install() {
	If ( version_compare( get_bloginfo( ‘version’ ), ‘3.1’, ‘<’ ) ) {
		deactivate_plugins( basename( __FILE__ ) ); // Deactivate our plugin
	}
}
?>

<?php

register_activation_hook( __FILE__, ‘rwpp_install’ );

function rwpp_install() {

If ( version_compare( get_bloginfo( ‘version’ ), ‘3.1’, ‘<’ ) ) {

deactivate_plugins( basename( __FILE__ ) ); // Deactivate our plugin

}

تابع نصب rwpp_install() از تابع get_bloginfo() نسخه فعلی وردپرس اجرا شده توسط کاربر را دریافت می کند . سپس با استفاده از تابع version_compare() بررسی می شود که آیا نسخه فعلی وردپرس حداقل 3.1 می باشد یا خیر . چنانچه نسخه وردپرس از 3.1 کمتر باشد توسط تابع deactivate_plugin() افزونه غیرفعال می شود .

تعیین مسیر URL ها در توسعه افزونه وردپرسایجاد تنظیمات پیش فرض هنگام فعال سازی افزونه وردپرس