プレゼン資料 » WordCamp Tokyo 2009

テーマの一部として導入

presenadmin — Sat, 28 Mar 2009 03:42:31 +0000

利用するテーマの functions.php
テーマ変更⇒ショートコード無効

利用するテーマのディレクトリにある functions.php (テーマの関数を格納する場所) でショートコードを定義することができる。

この場合、テーマを変更すると、functions.php に書いたショートコードが無効になる。

プラグインとして導入

presenadmin — Sat, 28 Mar 2009 03:19:26 +0000

wp-content/plugins へアップロード
管理画面で有効化

プラグインとして導入する場合は、通常のプラグインと同様に、プラグインディレクトリ (wp-content/plugins) へアップロードする。

管理画面から有効化を選択すると、利用可能になる。

ショートコードにする

presenadmin — Wed, 25 Mar 2009 23:08:21 +0000

add_shortcode(ショートコード名, 関数名)
ショートコード名: qrcode 記事中の名前
関数名: qrcode_output_func 定義した関数の名前

関数を定義しただけでは、ショートコードとして認識されない。

add_shortcode を使用する。

ショートコード属性の処理

presenadmin — Wed, 25 Mar 2009 01:22:07 +0000

shortcode_atts( array(
‘size’ => ’150′,
‘errorlv’ => ‘L’,
), $atts ));
array(属性 => デフォルト値)
$atts は投稿で指定された生データ
[qrcode size=”200″]
shortcode_atts でデータ処理

余計な属性を削除
未指定ならデフォルト値付与

array(ショートコード属性, デフォルト値) でデフォルト値を設定する。属性は複数でも良い。属性が無い場合は、array() にする。

$atts は、投稿記事で [コード属性1=値1 属性2=値2] のように指定した属性と値の配列。

$atts の生データがショートコード実行に適切とは限らないので、shortcode_atts で処理する。

ソース紹介

presenadmin — Tue, 24 Mar 2009 01:03:32 +0000

function qrcode_output_func( $atts, $content = null ) {
	extract( shortcode_atts( array(
					'size' => '150',
					'errorlv' => 'L',
					), $atts ));
	if ( "" == $content ) {
		$content = get_permalink();
	}
	return '';
}
add_shortcode( 'qrcode', 'qrcode_output_func' );

作り方

presenadmin — Mon, 23 Mar 2009 06:53:26 +0000

function 関数名($atts, $content = null) {
extract(shortcode_atts(array(デフォルト値の定義), $atts ))
PHP (WP 関数を含む) で処理
return 戻り値
add_shortcode(ショートコード名, 関数名)

関数の定義は PHP のフォーマットにしたがう。$atts は属性、$content は中身 ([ショートコード]ココ[/ショートコード])。

shortcode_atts は、ショートコードの属性を処理する関数。属性が指定されなければデフォルト値を用いる。想定外の属性は削除する。

return でショートコード実行時に値を返す。

add_shortcode で、ショートコード名 ([ココ]) を定義する。

ログインユーザーにのみ表示

presenadmin — Sun, 22 Mar 2009 03:38:43 +0000

is_user_logged_in()
(準)会員制サイト
ex. 会員は割引価格

[sc_is_user_logged_in]メンバー限定メッセージ [/sc_is_user_logged_in]

ショートコードを無効にすると、生テキストがそのまま表示される。重大な情報の場合は、WP 本体のパスワード機能や、.htaccess 等を利用したほうが良い。

このように、訪問者によって、表示するページを臨機応変に変更できるのは、動的生成のメリット。

function sc_is_user_logged_in_func( $atts, $content = null ) {
	extract( shortcode_atts( array(
					), $atts ));
	if ( is_user_logged_in() ) {
		return do_shortcode($content);
	} else {
        return "Sorry, logged in member only.";
	}
}
add_shortcode( 'sc_is_user_logged_in', 'sc_is_user_logged_in_func' );

詳細はカスタムフィールド／ログインしているユーザーに表示を参照。

カスタムフィールドとショートコード

presenadmin — Tue, 17 Mar 2009 14:52:51 +0000

カスタムフィールド: データを MYSQL データベースに格納するのに便利
ショートコード: データを取り出すのに便利

カスタムフィールドの値を取得

presenadmin — Tue, 17 Mar 2009 12:33:11 +0000

[sc_post_custom key=” “]
key=フィールドキー
フィールド値を表示

値が複数のとき
separator=区切り

WordPress の便利な機能「カスタムフィールド」と連携。(最近 Movable Type にも実装されたらしい)

function sc_post_custom_func( $atts, $content = null ) {
	extract( shortcode_atts( array(
					'key' => '',
					'separator' => ', ',
					), $atts ));
	if ( is_array(post_custom($key)) ) {
		return implode($separator,post_custom($key));
	} else {
		return post_custom($key);
	}
}
add_shortcode( 'sc_post_custom', 'sc_post_custom_func' );

詳細はカスタムフィールドのデータ表示を参照。

アマゾンのリンク作成

presenadmin — Tue, 17 Mar 2009 10:32:30 +0000

リンクを自動表示

アマゾンのサイトへ行く
検索語を入力
HTML タグ取得
ブログに貼り付ける

検索語を指定してアマゾンアソシエイトリンクを生成する。amazon リンク作成でダウンロード可能。

[sc_amazon]検索語[/sc_amazon] のように記述する。複数語の場合は半角スペースで区切る。

オプション属性でリンクの大きさや、文字、背景、リンクの色等が設定可能。