WordPress
ショートコード

ショートコードの登録

ショートコードは、WordPressエディタに追加できる小さなコードで、ページが公開またはプレビューされると別のものが出力されます。

頻繁にショートコードがテーマのfunctions.phpファイルに追加されますが、テーマを変更してもショートコードがfunctions.phpし続けることは期待できません 。代わりに、この機能を追加するプラグインを作成してください 。

ショートコードを登録するための構造は次のとおりです。

function new_shortcode($atts, $content = null){
    // if parameters are needed in the shortcode
    // parameters can be set to default to something
    extract( shortcode_atts( array(
        'param_one' => 'h1'
    ), $atts ) );
    $shortcode = '<'.$param_one'>'.$content.'</'.$param_one.'>';
    return $shortcode;
}
// this is what registers the shortcode with wordpress
add_shortcode('demo-shortcode','new_shortcode');

WordPressのエディタでは、次のように入力できます。

[demo-shortcode param_one="h2"]Demo[/demo-shortcode]
// you don't need to insert param_one into the editor if it has a default value.
// having it in the editor will override the default

ページが公開されると、これは

<h2>Demo</h2>

WordPressバックエンドでのショートコードの使用

[footag foo="value of 1" attribute-2="value of 2"]

WordPressの管理では、事前定義されたショートコードを使用し、ショートコード名を大括弧で囲み、必要に応じて属性をスペースで区切って追加します。

新しいショートコードを追加する

function footag_func( $atts ) {
    return "foo = {$atts['foo']}";
}
add_shortcode( 'footag', 'footag_func' );

プラグインでは、add_shortcode関数を使用してショートコードを追加できます。

ショートコードは、どのWordpressのページでも使用できます。または、角かっこで囲むだけで投稿できます。

[footag]

PHPコード内のショートコードを使う（テーマとプラグイン）

<?php echo do_shortcode("[footag foo='Hi! I am a foo output']"); ?>

PHPを使ってショートコードを印刷するには、 do_shortcode関数を使い、返された値をエコーし​​ます。

ウィジェットでのショートコードの使用

add_filter( 'widget_text', 'shortcode_unautop' );
add_filter( 'widget_text', 'do_shortcode' );enter code here

これをプラグインまたはfunctions.phpファイルに追加して、ウィジェットでショートコードを有効にします。コードはまずWordPressの段落タグへの改行を止めてから、ショートコードを使ってウィジェットを解析します。 2行の順序が重要です。