【WordPressショートコード】任意のnameを設定して出力結果が変わるショートコードを作成する

2021/10/29

前回、ショートコードに関して記事を書かせていただきました。
WordPressでショートコード化をするメリット・方法

今回は同じモジュールで文言やリンク先が変わる場合に使いやすいショートコードを作成出来ないかを考えました。

指定する番号によって出力する結果を変更する

ショートコードに任意の番号を設定して、出力結果を変えました。具体的にはif文を用いて指定した番号によって変数の値を上書きしただけです。

functions.phpに以下のコードを書いて、ショートコードを登録します

function fruit_func ( $atts ) {
        extract( shortcode_atts( array(
            ‘id’ => ”, 
        ), $atts ) );
        if($id === “1”){ 
            $title = ‘バナナ’;
        }
        else if ($id === “2”) {
            $title = ‘リンゴ’
        }
        return ‘<h2>’.$title.'</h2>’;
    }
    add_shortcode(‘fruit’, ‘fruit_func’);

functions.phpでショートコードを登録した後に作っていきます。

ショートコードを書く際にIDを指定することで出力の結果を変えることが出来ます。
以下のコードをテキストエディタに書きます。

[fruit id="1"]

idを1に設定した場合はバナナが出力されて、2に設定するとリンゴが出力されます。

番号ではなく任意の文字で出力結果を変える

番号で管理するとどんなものが出力されるか分かりづらくなってしまいますよね。そこで番号ではなく、わかりやすい文字で指定するコードにしました。

extract( shortcode_atts( array(
            'id' => '', 
        ), $atts ) );

先程紹介したfunctions.phpに登録するコードのidの部分をnameに変更しました。nameとすればどんな出力結果が容易に想像できて、自分以外の人がコードを書くときも分かりやすくなりますね。

そちら踏まえて以下のコードを作ってみました。

function linkpage_func ( $atts ) {
        extract( shortcode_atts( array(
            ‘name’ => ”, //出力したい事柄
        ), $atts ) );
        if($name === ‘soichiro’){ 
            $link = ‘https://soichiro.co.jp/’;
            $title = ‘株式会社Soichiro’;
        }
        else if ($name === ‘company’) {
            $link = ‘https://soichiro.co.jp/company/’;
            $title = ‘会社概要’;
        }
        return ‘<a href=”‘. $link .'”‘ .’>’. $title. ‘</a>’;
    }
    add_shortcode(‘pagelink’, ‘linkpage_func’);

登録したsoichiroやcompanyをnameに指定することで出力結果が変えられます。

そして表示させたい部分でショートコードを書きます。