概要
elementor/template_library/sources/local/register_post_type_argsは、Elementorプラグインがローカルテンプレートライブラリ用にカスタム投稿タイプを登録する際に使用されるフックです。このアクションを利用することにより、カスタム投稿タイプのさまざまな属性を調整することができます。特に以下の機能を実装する際に役立ちます。
- カスタム投稿タイプのラベルや特徴のカスタマイズ
- テンプレートの権限設定を調整
- カスタムエディターの設定変更
- 投稿タイプの表示設定(管理画面上での表示方法など)
- カスタム投稿タイプのサポート機能の追加
- カスタムタクソノミーとの連携
構文
add_action('elementor/template_library/sources/local/register_post_type_args', 'custom_register_post_type_args');
パラメータ
$args: 投稿タイプの設定配列
戻り値
- なし
使用可能なプラグインおよびバージョン
- Elementor: バージョン3.0以降
- WordPress: バージョン5.0以降
サンプルコード
サンプル1: 投稿タイプのラベルカスタマイズ
このコードは、templateというカスタム投稿タイプのラベルを変更します。
add_action('elementor/template_library/sources/local/register_post_type_args', function($args) {
if ('template' === $args['name']) {
$args['labels']['name'] = 'カスタムテンプレート';
$args['labels']['singular_name'] = 'カスタムテンプレート';
}
return $args;
});
このコードの引用元: https://developer.wordpress.org/reference/hooks/
サンプル2: 管理画面のメニュー位置設定
管理画面でのメニュー位置を変更するサンプルです。
add_action('elementor/template_library/sources/local/register_post_type_args', function($args) {
if ('template' === $args['name']) {
$args['menu_position'] = 5; // 投稿の下に表示
}
return $args;
});
このコードの引用元: https://developer.wordpress.org/reference/hooks/
サンプル3: テンプレートのサポート設定
カスタム投稿タイプに抜粋をサポートさせるためのコードです。
add_action('elementor/template_library/sources/local/register_post_type_args', function($args) {
if ('template' === $args['name']) {
$args['supports'][] = 'excerpt'; // 抜粋をサポート
}
return $args;
});
このコードの引用元: https://developer.wordpress.org/reference/hooks/
サンプル4: タクソノミーの追加
特定のタクソノミーをカスタム投稿タイプに関連付けるサンプルです。
add_action('elementor/template_library/sources/local/register_post_type_args', function($args) {
if ('template' === $args['name']) {
$args['taxonomies'][] = 'category'; // カテゴリを追加
}
return $args;
});
このコードの引用元: https://developer.wordpress.org/reference/hooks/
サンプル5: 権限のカスタマイズ
カスタム投稿タイプへのアクセス権限をカスタマイズする例です。
add_action('elementor/template_library/sources/local/register_post_type_args', function($args) {
if ('template' === $args['name']) {
$args['capability_type'] = 'page'; // ページの権限を使用
}
return $args;
});
このコードの引用元: https://developer.wordpress.org/reference/hooks/
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | |
| template_redirect | |
| get_header | |
| wp_head |