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;
}
関数はエコーをかけてはいけないことを覚えておいてください。
関数を作成したら、WordPress の add_shortcode 関数を使ってショートコードを登録します。ショートコード名の関数名は、ショートコードと一致する必要はありません。
// 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が奥深く柔軟なプラットフォームであることを示す典型的な例となっています。
Follow me!
