• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/register activation hook」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(Process Flow: リンク)
(プロセスの流れ: link)
43行目: 43行目:
  
 
<!-- If you are interested in doing something just after a plugin has been activated it is important to note that the hook process performs an instant redirect after it fires.-->   
 
<!-- If you are interested in doing something just after a plugin has been activated it is important to note that the hook process performs an instant redirect after it fires.-->   
So it is impossible to use <tt>[[関数リファレンス/add_action | add_action()]]</tt> or <tt>[[関数リファレンス/add_filter | add_filter()]]</tt> type calls until the redirect has occurred (e.g., only two hooks are fired after the plugin's activation hook: <tt>[[Plugin_API/アクションリファレンス/activated_plugin | 'activated_plugin']]</tt> and <tt>[[Plugin_API/アクションリファレンス/shutdown | 'shutdown']]</tt>).  A quick workaround to this quirk is to use <tt>[[Function_Reference/add_option | add_option()]]</tt> like so:
+
So it is impossible to use <tt>[[関数リファレンス/add_action | add_action()]]</tt> or <tt>[[関数リファレンス/add_filter | add_filter()]]</tt> type calls until the redirect has occurred (e.g., only two hooks are fired after the plugin's activation hook: <tt>[[Plugin_API/アクションリファレンス/activated_plugin | 'activated_plugin']]</tt> and <tt>[[Plugin_API/アクションリファレンス/shutdown | 'shutdown']]</tt>).  A quick workaround to this quirk is to use <tt>[[関数リファレンス/add_option | add_option()]]</tt> like so:
  
 
<pre>
 
<pre>
71行目: 71行目:
 
You can check out the full post @ http://stackoverflow.com/questions/7738953/is-there-a-way-to-determine-if-a-wordpress-plugin-is-just-installed/13927297#13927297.
 
You can check out the full post @ http://stackoverflow.com/questions/7738953/is-there-a-way-to-determine-if-a-wordpress-plugin-is-just-installed/13927297#13927297.
  
However, it '''is''' possible to use <tt>[[Function_Reference/do_action | do_action()]]</tt>, like this:
+
However, it '''is''' possible to use <tt>[[関数リファレンス/do_action | do_action()]]</tt>, like this:
  
 
<pre>
 
<pre>

2015年6月5日 (金) 09:29時点における版

関数register_activation_hook(WordPress2.0より導入)はプラグインが有効化されたときに実行される関数を登録します。

これはアクション・フックactivate_{$PLUGIN_NAME}を利用するよりも簡単です。

使用法

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

パラメータ

$file
string) (必須wp-content/pluginsディレクトリにあるメインプラグインファイルへのパス。フルパスが有効です。
初期値: なし
$function
callback) (必須) プラグインが有効化されたときに実行される関数。PHPにおける疑似的な型callbackとして許可されたものである必要があります。
初期値: なし

使用例

関数myplugin_activate()メインプラグインファイルに定義されていて、下記の場所いずれかに置かれているものとします。

  • wp-content/plugins/myplugin.php
  • wp-content/plugins/myplugin/myplugin.php

コード:

register_activation_hook( __FILE__, 'myplugin_activate' );

このコードはプラグイン有効化のときに関数myplugin_activate()を呼び出します。アクション・フックactivate_PLUGIN_NAMEを使うよりも信頼性の高い方法です。

プロセスの流れ

このページ「関数リファレンス/register activation hook」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

プラグインがアクティブになっている直後に何かをすることに興味があるなら、発動後のフック処理は、インスタントのリダイレクトを実行することに注意することが重要です。

So it is impossible to use add_action() or add_filter() type calls until the redirect has occurred (e.g., only two hooks are fired after the plugin's activation hook: 'activated_plugin' and 'shutdown'). A quick workaround to this quirk is to use add_option() like so:

/* メインプラグインファイル */
...
function my_plugin_activate() {

  add_option( 'Activated_Plugin', 'Plugin-Slug' );

  /* ここでアクティベーションコード */
}
register_activation_hook( __FILE__, 'my_plugin_activate' );

function load_plugin() {

    if ( is_admin() && get_option( 'Activated_Plugin' ) == 'Plugin-Slug' ) {

        delete_option( 'Activated_Plugin' );

        /* do stuff once right after activation */
        // example: add_action( 'init', 'my_init_function' );
    }
}
add_action( 'admin_init', 'load_plugin' );

You can check out the full post @ http://stackoverflow.com/questions/7738953/is-there-a-way-to-determine-if-a-wordpress-plugin-is-just-installed/13927297#13927297.

However, it is possible to use do_action(), like this:

function my_plugin_activate() {

     do_action( 'my_plugin_activate' );
}
register_activation_hook( __FILE__, 'my_plugin_activate' );

Included plugin files and even other plugins will be able to hook into this action.

注意点

  • 稼働するコードを例として挙げている関連トピック: http://wordpress.org/support/topic/312342
  • プラグインの中でplugins_loadedフックを使っても時既に遅しで稼働しません。

変数のスコープに関する注意点

もしグローバル変数を使っているのなら、register_activation_hook()に渡した関数は呼び出された時点においてグローバル変数へのアクセス権を持っていないということを念頭に置いてください。これは以下のようにグローバルスコープへの参照を宣言しても同じことです。

$myvar='whatever';

function myplugin_activate() {
  global $myvar;
  echo $myvar; // 'whatever'にはならない
}

register_activation_hook( __FILE__, 'myplugin_activate' );

これは初めてのインクルードであるため、まだグローバルスコープにインクルードされないのです。プラグインファイルはactivate_plugin関数内で読み込まれており、プラグン本体はまだグローバルスコープにあるわけではないのです。

この点は明白に理解しておく必要があります。もし変数がグローバルスコープにあってほしいのなら、そのように宣言し、どこからでも使えるようにする必要があります。プラグイン本体の中で使っている変数ならば、グローバル変数として宣言する必要があります。

プラグインが有効化されると、あなたのプラグインは別の関数から読み込まれ、その関数内であなたの登録した関数myplugin_activate()は有効化が完了した時点で実行されます(正確に言うとactivate_plugin())。そのため、あなたがグローバルスコープとして宣言しない限り、プラグイン本体の変数は関数activate_plugin()のスコープにあってグローバルではありません。

global $myvar;
$myvar='whatever';

function myplugin_activate() {
  global $myvar;
  echo $myvar; // this will be 'whatever'
}

register_activation_hook( __FILE__, 'myplugin_activate' );

これに関する詳しい情報はこちら: http://wordpress.org/support/topic/201309

外部リソース

更新履歴

  • 新規導入: 2.0

ソースファイル

register_activation_hook()wp-includes/plugin.phpにあります。


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function_Reference/register_activation_hook最新版との差分