blog.alumican.net

『 WordPressにFlashを貼り付けるプラグインWP-Al-SWFObject 』

2009 年 4 月 19 日

English is here.

WP-Al-SWFObject
WordPressのエントリにswfを簡単に貼り付けるためのプラグインを作ったので紹介します。WP-SWFObjectよりも細かくパラメータを指定できます。

ダウンロード
 使い方
 使い方（エントリー以外の場所に貼り付ける）
管理画面
 使用例
 使用するSWFObjectのバージョン
 ライセンス

・ダウンロード
>>Download （英語版）
>>Download （日本語版）

・使い方

ダウンロードしたzipを解凍するとwp-al-swfobjectフォルダができるので、フォルダごとサーバのwp-content/pluginsディレクトリにアップロードします。
WordPressの設定画面->プラグインから、WP-Al-SWFObjectプラグインを有効化します。
エントリー内のswfを貼り付けたい位置に以下のコードを記述します。[／embedSWF]は[/embedSWF]に置き換えてください。

[embedSWF]swf, width, height, align, version, expressInstall, flashvars, params, attributes[／embedSWF]

赤字のパラメータは必須、黒字のパラメータはオプション(省略可能)です。

swf（必須）･･･貼り付けるswfへのパスを記述します。
width（省略可）･･･ swfの幅を指定します。省略するとプラグインの設定ページで指定したデフォルト値が用いられます。
height（省略可）･･･ swfの高さを指定します。省略するとプラグインの設定ページで指定したデフォルト値が用いられます。
align（省略可）･･･ swfを貼り付ける際の位置を指定します。左寄せ、右寄せ、中央寄せに対してそれぞれleft、right、centerで指定します。省略すると特に指定されません。
version（省略可）･･･必要なFlashPlayerのバージョンを記述します。省略すると9.0.0となります。
expressInstall（省略可）･･･プレイヤーが要件を満たさない場合に表示するswfへのパスを記述します。省略するとSWFObjectデフォルトのexpressInstall.swfを表示します。
flashvars（省略可）･･･ HTMLからflashに渡す変数（flashvars）を、{変数名1:”値1″, 変数名2:”値2″}という形式で記述します。
params（省略可）･･･ swfを貼り付ける際のパラメータを、flashvarsと同形式で記述します。
attributes（省略可）･･･ swfを貼り付ける際のhtml属性を、flashvarsと同形式で記述します。

・使い方（エントリー以外の場所に貼り付ける）
ヘッダーやサイドバーなど、エントリ以外の場所に貼り付ける場合は、貼り付けたい場所で以下のphp関数を呼び出します。引数として、エントリー内に貼り付ける場合のタグと同様のものをまるごと文字列で渡します。

<?php wp_al_swfobject_echo('[embedSWF]swf, width, height, align, version, expressInstall, flashvars, params, attributes[／embedSWF]'); ?>

・管理画面
WP-Al-SWFObjectは管理画面から各パラメータのデフォルト値を設定できます。
デフォルト値はWP-Al-SWFObjectによって貼られる全てのswfに適用されます。
同じ変数を複数の箇所で設定した場合の優先順位は
[embedSWF]タグ内 > 設定画面の{変数名1:”値1″, 変数名2:”値2″} > 設定画面の補助設定（paramsのみ設定可）
となっており、優先順位の高い変数に上書きされます。また、flashvars、params、attributesに関しては各変数ごとに上書き判定がなされます。

例えば、管理画面からflashvarsの項目に

aaa:"30", bbb:"50"

を設定すると、WP-Al-SWFObjectを使って貼る全てのswfに aaa=”30″, bbb=”50″ としてflashvarsが渡されます。この状態で、以下のようにしてswfを貼り付けます。

[embedSWF]hoge.swf,,,,,,{aaa:"10"}[／embedSWF]

この場合、タグ内でデフォルト値と同名の変数名aaaでflashvarsを指定しているため、デフォルト値は変数aaaに対して適用されません。つまり、このswfは aaa=”10″, bbb=”50″ としてflashvarsを受け取ることになります。

・使用例
オプションを指定せずに貼り付ける（管理画面で幅300、高さ50に設定してあります）

[embedSWF]hoge.swf[／embedSWF]