この記事の最初の部分では、組み込み関数を使用して WordPress.org と通信し、プラグインの詳細を取得する方法について説明しました。
このチュートリアルでは理論を実践し、ショートコードを使用して WordPress.org でホストされているプラグインの詳細を WordPress Web サイトに表示できるようにする簡単なプラグインを作成します。 p>
あなたはプラグイン開発者であり、基本を知っていると思いますが、疑問がある場合は、次の 2 つの記事を読むことをお勧めします。
このプラグインでは、[mpi slug='my-plugin-information' field='version']
のようなショートコードを作成します。これは、「slug」と「slug」の 2 つの属性を受け入れることができます。 「フィールド」に基づいて、WordPress.org リポジトリでホストされているプラグインの情報を取得して表示します。
まず、wp-content/pluginsディレクトリ内にmy-plugin-informationというフォルダーを作成します。その中にmy-plugin-info.phpという名前のファイルを作成し、次のコードを貼り付けます:
リーリー上記のコードでは、プラグイン クラスDOT_MyPluginInfo
を作成して初期化します。これには、__construct()
メソッドなど、あらゆるプラグインに共通のブロックが含まれています。
関数init_my_plugin_info
init
アクションにフックして、WordPress がロードされた後、ヘッダーが送信される前に実行されるようにします。関数init_my_plugin_info
では、add_shortcode
関数を使用してショートコードを登録します。
注:add_shortcode
の詳細については、コーデックスを確認してください。
上記のプラグインには、WordPress がプラグイン ダッシュボードから認識できる十分なコードが含まれています。指示に従ってファイルを作成した場合は、プラグインページにアクセスして、このプラグインをアクティブ化できます。
プラグインに関して表示する情報を柔軟に選択できるようにしたかったため、2 つのプロパティを持つショートコードを作成しました。 「slug」と呼ばれる最初のものは、どのプラグインのデータを取得する必要があるかを指定するために使用されます。 2 番目の属性「フィールド」は、表示する必要があるプラグインの特定の情報を指定するために使用されます。
たとえば、プラグインのダウンロード数を表示したい場合は、ポスト エディターの下にテキストを追加するだけで、最終結果は「100 回ダウンロードされました」のようなものになるはずです。 p> リーリー
add_shortcodeを使用してショートコードを登録し、投稿コンテンツ内でショートコードが見つかるたびに、関数
render_mpi()が呼び出されて処理されます。今後、残りのコードはこの関数内に配置され、ショートコードを処理します。
を使用します
render_api関数に次のコードを追加します:
リーリー
リーリー
上記のコードは、「slug」が存在するかどうかをチェックし、存在しない場合は false を返します。 「slug」が存在する場合は、引き続き「field」属性のチェックが行われます。プラグインに関する特定の情報を表示するショートコードを作成しているだけなので、さらに処理を進める前にこれら 2 つのプロパティの存在を確認することで、WordPress.org プラグイン API への不要な呼び出しを節約できます。 ここで、「slug」属性と「field」属性の値がショートコードで提供されている場合、最初にこれら 2 つの値を削除します。リーリー
プラグイン データを一時的な状態で保存する このショートコードを含むページが読み込まれるたびに WordPress.org にリクエストを送信しないようにするには、プラグイン情報をローカルに保存する必要があります。このようにして、同じプラグインの異なる詳細を表示する複数のショートコードを配置する場合、サイト上でローカルに保存された情報のデータを表示することでプロセスを高速化できます。しかし、プラグインが更新されても古いデータが表示され続けたらどうなるでしょうか?この問題を解決するには、Transients API を使用して個人のプラグイン データを保存し、有効期限データを設定するのが最も簡単なオプションです。
もう 1 つの問題は、さまざまなプラグインに関するデータを取得するショートコードがある場合です。単一の一時的な名前を使用してそれらを保存すると、予期しない結果が生じる可能性があります。この問題を解決するには、「slug」属性を使用して、保存されたトランジェントに一意の名前を付けます。让我们首先创建一个变量$mpi_transient_name
来保存基于“slug”属性的唯一瞬态名称。
// Create a empty array with variable name different based on plugin slug $mpi_transient_name = 'mpi-' . $slug;
接下来我们检查瞬态是否已经存在:
/** * Check if transient with the plugin data exists */ $mpi_info = get_transient( $mpi_transient_name );
如果瞬态存在,我们将继续根据“field”属性显示数据,否则我们使用plugins_api
连接到 WordPress.org 并请求插件信息。
if ( empty( $mpi_info ) ) { /** * Connect to WordPress.org using plugins_api * About plugins_api - * https://code.tutsplus.com/tutorials/communicating-with-the-wordpress-org-plugin-api--wp-33069 */ require_once( ABSPATH . 'wp-admin/includes/plugin-install.php' ); $mpi_info = plugins_api( 'plugin_information', array( 'slug' => $slug ) ); // Check for errors with the data returned from WordPress.org if ( ! $mpi_info or is_wp_error( $mpi_info ) ) { return false; } // Set a transient with the plugin data // Use Options API with auto update cron job in next version. set_transient( $mpi_transient_name, $mpi_info, 1 * HOUR_IN_SECONDS ); }
在上面的代码中,我们做了三件事:
$mpi_info
的变量中现在,如果 slug 属性的值为“my-plugin-information
”,那么存储插件信息的瞬态名称将为“mpi-my-plugin-information
”。
注意:要了解有关plugins_api
的更多信息,请参阅本系列的第一篇文章,如本文顶部所示。
最后一步涉及根据“field”属性的值返回特定信息。为此,我们只需使用单独的检查即可。
if ( $field == "downloaded" ) { return $mpi_info->downloaded; } if ( $field == "name" ) { return $mpi_info->name; } if ( $field == "slug" ) { return $mpi_info->slug; } if ( $field == "version" ) { return $mpi_info->version; } if ( $field == "author" ) { return $mpi_info->author; } if ( $field == "author_profile" ) { return $mpi_info->author_profile; } if ( $field == "last_updated" ) { return $mpi_info->last_updated; } if ( $field == "download_link" ) { return $mpi_info->download_link; }
完整的插件代码:
'', //foo is a default value 'field' => '' ), $atts)); /** * Check if slug exists */ if ( ! $slug ) { return false; } /** * Check if field exists * Return value based on the field attribute */ if ( ! $field ) { return false; } else { // Sanitize attributes $slug = sanitize_title( $slug ); $field = sanitize_title( $field ); // Create a empty array with variable name different based on plugin slug $mpi_transient_name = 'mpi' . $slug; /** * Check if transient with the plugin data exists */ $mpi_info = get_transient( $mpi_transient_name ); if ( empty( $mpi_info ) ) { /** * Connect to WordPress.org using plugins_api * About plugins_api - * https://code.tutsplus.com/tutorials/communicating-with-the-wordpress-org-plugin-api--wp-33069 */ require_once( ABSPATH . 'wp-admin/includes/plugin-install.php' ); $mpi_info = plugins_api( 'plugin_information', array( 'slug' => $slug ) ); // Check for errors with the data returned from WordPress.org if ( ! $mpi_info or is_wp_error( $mpi_info ) ) { return false; } // Set a transient with the plugin data // Use Options API with auto update cron job in next version. set_transient( $mpi_transient_name, $mpi_info, 1 * HOUR_IN_SECONDS ); } if ( $field == "downloaded" ) { return $mpi_info->downloaded; } if ( $field == "name" ) { return $mpi_info->name; } if ( $field == "slug" ) { return $mpi_info->slug; } if ( $field == "version" ) { return $mpi_info->version; } if ( $field == "author" ) { return $mpi_info->author; } if ( $field == "author_profile" ) { return $mpi_info->author_profile; } if ( $field == "last_updated" ) { return $mpi_info->last_updated; } if ( $field == "download_link" ) { return $mpi_info->download_link; } } // $field check } // render_mpi() } // end class new DOT_MyPluginInfo(); } ?>
此插件代码可在 GitHub 上找到,您也可以从 WordPress.org 下载
现在您只需转到帖子编辑器并添加一个短代码,例如:
Downloaded [mpi slug='my-plugin-information' field='downloaded'] times.
它会显示:
Downloaded 10 times.
通过替换“field”属性的值,您可以显示不同的信息,例如:
[mpi slug='my-plugin-information' field='name']
[mpi slug='my-plugin-information' field='version']
[mpi slug='my-plugin-information' field='slug']
[mpi slug='my-plugin-information' field='author']
[mpi slug='my-plugin-information' field='author_profile']
[mpi slug='my-plugin-information' field='last_updated']
[mpi slug='my-plugin-information' field='download_link']
为了简单起见,我使用瞬态来保存插件信息。然而,瞬态从来就不是用来保存重要数据的。另一种方法是使用选项 API、add_options()
或作为 post meta 保存插件数据,然后安排一个 cron 任务每小时更新一次数据。
使用plugins_api
,我们已经演示了通信和检索 WordPress.org 上托管的任何插件的信息是多么容易。
您可能还想查看其他插件,例如 Plugin Info(也使用plugins_api
和 I Make Plugins,看看它们如何完成相同的任务。
以上がWeb サイト上の WordPress.org プラグインに関する情報を表示します。の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。