WordPressのショートコードの作成

WordPress のショートコードは、特に WordPress ベースのウェブサイトをクライアントに引き渡す際に非常に便利です。ショートコードを使用する代わりに、複雑なテンプレートを作成する必要がありますが、それでもショートコードでできることを十分に代替することはできません。私は最近、ブログに新しいショートコードを実装する必要がありましたが、WordPress の API で新しいショートコードを作成するのがいかに簡単かを知って嬉しくなりました。それでは、独自のWordPressショートコードを作成する方法をご紹介します。

まず最初に、テーマの functions.php ファイル内に関数を作成します。この関数は、レンダリングされたコンテンツ内のショートコードを置き換える文字列を返す必要があります。関数には、引数として$argsを渡すことができます。これは、パラメータのkey=>value配列です。

function my_shortcode_routine($args) {
	// $args = array('key1' => 'value1', 'key2' => 'value2')
	$return = '';

	// a bunch of logic and string-building here

	// return the result
	return $return;
}

function my_shortcode_routine($args) {

// $args = array('key1' => 'value1', 'key2' => 'value2')

$return = '';

// a bunch of logic and string-building here

// return the result

return $return;

}

関数はエコーをかけてはいけないことを覚えておいてください。

関数を作成したら、WordPress の add_shortcode 関数を使ってショートコードを登録します。ショートコード名の関数名は、ショートコードと一致する必要はありません。

// Add a shortcode called 'shortcode_name' that runs the 'my_shortcode_routine' function
add_shortcode('shortcode_name', 'my_shortcode_routine');

1 2	// Add a shortcode called 'shortcode_name' that runs the 'my_shortcode_routine' function add_shortcode('shortcode_name', 'my_shortcode_routine');

関数が作成され、ショートコードが登録されたら、今度はそのショートコードを投稿やページ内で使用することができます。

[shortcode_name key1="value1" key2="value2"] 。

ショートコードシステムは非常に美しく、熟練した開発者やトレーニングを受けた顧客の両方にとって大きな価値があり、WordPressが奥深く柔軟なプラットフォームであることを示す典型的な例となっています。