세 가지 후크가 있습니다. 다음과 같은 경우에 트리거됩니다.
시나리오 중 기능을 안전하게 트리거하는 방법
다음은 언급 된 동작 중에 트리거되는 콜백 함수를 안전하게 후크 하는 올바른 방법을 보여줍니다 .
이 코드를 사용하는 플러그인에서 사용할 수 있으므로
검사 할 수있는 세 가지 데모 플러그인 을 보여 드리고 나중에 자체 플러그인으로 코드를 구현할 것입니다.
중요한 참고 사항!
이 주제는 매우 어렵고 매우 상세하며 수십 가지 이상의 사례가 있으므로이 답변은 완벽하지 않습니다. 시간이 지남에 따라 계속 개선 할 것이므로 정기적으로 다시 확인하십시오.
(1) 플러그인 활성화 / 비활성화 / 제거
플러그인 설정 콜백은 코어에 의해 트리거되며 코어가이를 수행하는 방법 에는 영향을 미치지 않습니다. 명심해야 할 것이 있습니다.
- 결코 , 이제까지
echo/print설정 콜백 동안 아무것도 (!). 이것은 headers already sent메시지로 이어지고 핵심은 플러그인을 비활성화하고 삭제하는 것이 좋습니다 ... 묻지 않습니다 : 알아요 ...
- 당신은하지 않습니다 볼 시각적 출력을. 그러나 나는
exit()모든 다른 콜백 에 진술을 추가 하여 실제로 일어나는 일에 대한 통찰력을 얻을 수 있습니다. 작동을 확인하려면 주석 처리를 제거하십시오.
__FILE__ != WP_PLUGIN_INSTALL플러그인이 실제로 제거되는지 여부 를 확인하는 것이 매우 중요합니다 . on_deactivation()개발 중에 단순히 콜백을 트리거하는 것이 좋습니다 . 따라서 모든 것을 다시 가져와야하는 시간을 절약 할 수 있습니다. 적어도 이것이 내가하는 일입니다.- 나도 몇 가지 보안 작업을 수행합니다. 일부는 코어로도 이루어 지지만 이봐! 죄송합니다보다 더 안전! .
- 먼저 코어가로드되지 않은 경우 직접 파일 액세스를 허용하지 않습니다.
defined( 'ABSPATH' ) OR exit;
- 그런 다음 현재 사용자가이 작업을 수행 할 수 있는지 확인합니다.
- 마지막 작업으로 리퍼러를 확인합니다. 참고 : 오류가 발생했을 때
wp_die()화면에 적절한 권한을 요청하는 (그리고 다시 시도하려는 경우 ... 예, 확실히 ) 예상치 못한 결과가 발생할 수 있습니다 . 코어, 리디렉션 전류를 설정 이것은 발생 $GLOBALS['wp_list_table']->current_action();에 error_scrape다음의 참조 페이지를 확인 check_admin_referer('plugin-activation-error_' . $plugin);어디에 $plugin이다 $_REQUEST['plugin']. 따라서 리디렉션은 페이지로드의 절반에서 발생 하며이 유선 스크롤 막대와 다이 화면에 노란색 관리자 알림 / 메시지 상자가 나타납니다. 이 경우 : 침착성을 유지하고 exit()단계별 디버깅으로 오류를 검색하십시오 .
(A) 일반 기능 플러그인
함수 정의 전에 콜백을 연결하면 작동하지 않을 수 있습니다.
<?php
defined( 'ABSPATH' ) OR exit;
/**
* Plugin Name: (WCM) Activate/Deactivate/Uninstall - Functions
* Description: Example Plugin to show activation/deactivation/uninstall callbacks for plain functions.
* Author: Franz Josef Kaiser/wecodemore
* Author URL: http://unserkaiser.com
* Plugin URL: http://wordpress.stackexchange.com/questions/25910/uninstall-activate-deactivate-a-plugin-typical-features-how-to/25979#25979
*/
function WCM_Setup_Demo_on_activation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "activate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
function WCM_Setup_Demo_on_deactivation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "deactivate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
function WCM_Setup_Demo_on_uninstall()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
check_admin_referer( 'bulk-plugins' );
// Important: Check if the file is the one
// that was registered during the uninstall hook.
if ( __FILE__ != WP_UNINSTALL_PLUGIN )
return;
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
register_activation_hook( __FILE__, 'WCM_Setup_Demo_on_activation' );
register_deactivation_hook( __FILE__, 'WCM_Setup_Demo_on_deactivation' );
register_uninstall_hook( __FILE__, 'WCM_Setup_Demo_on_uninstall' );
(B) 클래스 기반 / OOP 아키텍처
이것은 오늘날 플러그인에서 가장 일반적인 예입니다.
<?php
defined( 'ABSPATH' ) OR exit;
/**
* Plugin Name: (WCM) Activate/Deactivate/Uninstall - CLASS
* Description: Example Plugin to show activation/deactivation/uninstall callbacks for classes/objects.
* Author: Franz Josef Kaiser/wecodemore
* Author URL: http://unserkaiser.com
* Plugin URL: http://wordpress.stackexchange.com/questions/25910/uninstall-activate-deactivate-a-plugin-typical-features-how-to/25979#25979
*/
register_activation_hook( __FILE__, array( 'WCM_Setup_Demo_Class', 'on_activation' ) );
register_deactivation_hook( __FILE__, array( 'WCM_Setup_Demo_Class', 'on_deactivation' ) );
register_uninstall_hook( __FILE__, array( 'WCM_Setup_Demo_Class', 'on_uninstall' ) );
add_action( 'plugins_loaded', array( 'WCM_Setup_Demo_Class', 'init' ) );
class WCM_Setup_Demo_Class
{
protected static $instance;
public static function init()
{
is_null( self::$instance ) AND self::$instance = new self;
return self::$instance;
}
public static function on_activation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "activate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_deactivation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "deactivate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_uninstall()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
check_admin_referer( 'bulk-plugins' );
// Important: Check if the file is the one
// that was registered during the uninstall hook.
if ( __FILE__ != WP_UNINSTALL_PLUGIN )
return;
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public function __construct()
{
# INIT the plugin: Hook your callbacks
}
}
(C) 외부 설정 객체가있는 클래스 기반 / OOP 아키텍처
이 시나리오는 메인 플러그인 파일과라는 이름의 두 번째 파일 가지고 있다고 가정 setup.php라는 이름의 플러그인의 하위 디렉토리에을 inc: ~/wp-content/plugins/your_plugin/inc/setup.php. 이는 플러그인 폴더가 기본 WP 폴더 구조를 벗어나거나 컨텐츠 디렉토리의 이름이 바뀌거나 설정 파일의 이름이 다른 경우에도 효과적입니다. 만 inc폴더는 플러그인의 루트 디렉토리에서 같은 이름 및 위치 관련을 가지고있다.
참고 : 단순히 세 가지 register_*_hook()*기능과 클래스를 가져 와서 플러그인에 넣을 수 있습니다.
기본 플러그인 파일 :
<?php
defined( 'ABSPATH' ) OR exit;
/**
* Plugin Name: (WCM) Activate/Deactivate/Uninstall - FILE/CLASS
* Description: Example Plugin
* Author: Franz Josef Kaiser/wecodemore
* Author URL: http://unserkaiser.com
* Plugin URL: http://wordpress.stackexchange.com/questions/25910/uninstall-activate-deactivate-a-plugin-typical-features-how-to/25979#25979
*/
register_activation_hook( __FILE__, array( 'WCM_Setup_Demo_File_Inc', 'on_activation' ) );
register_deactivation_hook( __FILE__, array( 'WCM_Setup_Demo_File_Inc', 'on_deactivation' ) );
register_uninstall_hook( __FILE__, array( 'WCM_Setup_Demo_File_Inc', 'on_uninstall' ) );
add_action( 'plugins_loaded', array( 'WCM_Setup_Demo_File', 'init' ) );
class WCM_Setup_Demo_File
{
protected static $instance;
public static function init()
{
is_null( self::$instance ) AND self::$instance = new self;
return self::$instance;
}
public function __construct()
{
add_action( current_filter(), array( $this, 'load_files' ), 30 );
}
public function load_files()
{
foreach ( glob( plugin_dir_path( __FILE__ ).'inc/*.php' ) as $file )
include_once $file;
}
}
설정 파일 :
<?php
defined( 'ABSPATH' ) OR exit;
class WCM_Setup_Demo_File_Inc
{
public static function on_activation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "activate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_deactivation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "deactivate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_uninstall()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
check_admin_referer( 'bulk-plugins' );
// Important: Check if the file is the one
// that was registered during the uninstall hook.
if ( __FILE__ != WP_UNINSTALL_PLUGIN )
return;
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
}
(2) 플러그인 업데이트
자체 DB 테이블 또는 옵션이있는 플러그인을 작성하는 경우 변경하거나 업그레이드해야하는 시나리오가있을 수 있습니다.
슬프게도 지금까지 플러그인 / 테마 설치 또는 업데이트 / 업그레이드에서 무언가를 실행할 가능성이 없습니다. 다행스럽게도 해결 방법이 있습니다 : 사용자 정의 함수를 사용자 정의 옵션에 연결하십시오 (예, 절름발이이지만 작동합니다).
function prefix_upgrade_plugin()
{
$v = 'plugin_db_version';
$update_option = null;
// Upgrade to version 2
if ( 2 !== get_option( $v ) )
{
if ( 2 < get_option( $v ) )
{
// Callback function must return true on success
$update_option = custom_upgrade_cb_fn_v3();
// Only update option if it was an success
if ( $update_option )
update_option( $v, 2 );
}
}
// Upgrade to version 3, runs just after upgrade to version 2
if ( 3 !== get_option( $v ) )
{
// re-run from beginning if previous update failed
if ( 2 < get_option( $v ) )
return prefix_upgrade_plugin();
if ( 3 < get_option( $v ) )
{
// Callback function must return true on success
$update_option = custom_upgrade_cb_fn_v3();
// Only update option if it was an success
if ( $update_option )
update_option( $v, 3 );
}
}
// Return the result from the update cb fn, so we can test for success/fail/error
if ( $update_option )
return $update_option;
return false;
}
add_action('admin_init', 'prefix_upgrade_plugin' );
출처
이 업데이트 기능은 좋지 않은 / 잘 작성된 예이지만, 예를 들면 다음과 같습니다. 이후 업데이트로 개선 할 것입니다.
