WordPress
ショートコード

ショートコード導入

ショートコードは、より複雑な要素を通常のコンテンツエディタにインラインで追加できるようにする場合に便利です。

短いコードは次のようになります。

function my_shortcode( ){
    return "This is a shortcode";
}
add_shortcode( 'my_shortcode', 'my_shortcode' );

これは"This is a shortcode"というテキストを出力し、コンテンツエディタに[my_shortcode]と書くことで使用します。

ボタンショートコード

単純なボタンのショートコードの例を次に示します。

<?php
function my_button_shortcode( $atts ) {

    // Parse the input attributes and assgn default values for the 
    // attributes that are not specified on the shortcode
    $a = shortcode_atts( array(
        'id' => '',
        'url' => '#',
        'class' => '',
        'text' => ''
    ), $atts );

    // Open the anchor tag and add role=button for better accessibility
    $btn_html = '<a role="button"';

    // Add the href(link) attribute
    $btn_html .= ' href="' . $a['url'] . '"';

    // Add id attribute to output if specified
    if ( !empty( $a['id'] ) ) {
        $btn_html .= ' id="' . $a['id'] . '"';
    }

    $btn_classes = 'button';


    // Add class attribute to output
    $btn_html .= ' class="button ' . ( !empty(a['class']) ? $a['class'] : '' ) . '"';

    // Close opening anchor tag
    $btn_html .= '>'.
        // Add button text
        $a['text'].
        // Add closing anchor tag
        '</a>'."\n";

    return $btn_html;
}
add_shortcode( 'button', 'my_button_shortcode' );

このショートコードは、 [button url="/my-other-page" id="my-other-page-button" class="dark" text="Click me!"]と入力すると使用でき、次のHTML：

<a role="button" href="/my-other-page" id="my-other-page-button" 
class="button dark">Click me!</a>