Welcart 0.6 をリリースいたしました。
修正内容は以下の通りです。是非WordPress3.0 でお使いください。

• 代引き手数料を段階的に設定できるよう改善
• Welcart 問い合わせフォームのＳＳＬ対応
• 受注データ編集で送信する管理メールを管理者にも同報されるよう改善
• 商品編集時のメディア・ライブラリにアイキャッチ画像のリンクが出ない不具合を修正
• 会員登録時に管理者へ報告メールが届くよう改善

そこで、特に報告の多い「Lightbox 2」と「FuncyBox for WordPress」の2つのプラグインでの対処法を説明いたします。つまり本体へのハックです。（フックが無かったのでハックするしかありませんでした）

Lightbox 2 での対処

修正箇所は2箇所です。

1. lightbox2.php 内にある関数、lightbox_styles() を次のように書き換えます。

function lightbox_styles() {
	/* What version of WP is running? */
	global $wp_version;
	global $stimuli_lightbox_plugin_prefix;
    /* The next line figures out where the javascripts and images and CSS are installed,
    relative to your wordpress server's root: */
    $lightbox_2_theme = urldecode(get_option('lightbox_2_theme'));
    $lightbox_style = ($stimuli_lightbox_plugin_prefix."Themes/".$lightbox_2_theme."/");

	wp_enqueue_style('lightbox_styles_customize', $lightbox_style."lightbox.css");
}

2.最後から2行目のアクションフックを変更します。

add_action('wp_head', 'lightbox_styles');
↓
add_action('init', 'lightbox_styles');

FuncyBox for WordPress での対処

変更はfancybox.php 内、2箇所です。

1. 関数mfbfw_css() 内にある次の行を1行削除します。

	echo "\n".'<link rel="stylesheet" href="'. FBFW_URL . '/css/fancybox.css" type="text/css" media="screen" />'."\n";

2. コードの一番最後に次のコードを付け足します。

add_action('init', 'mfbfw_css_customize');
function mfbfw_css_customize(){
	$url = FBFW_URL . '/css/fancybox.css';
	wp_enqueue_style('mfbfw_css_customize', $url);
}

どちらのプラグインも、スタイルシートをインクルードする際はwp_enqueue_style（） 関数を使うように変更しているだけです。

汎用性を持たせるために、WordPress には様々な関数が用意されていますが、wp_enqueue はこんなに重要だったんですね。プラグインを作るときは気をつけましょう。

WCEX とは、Welcart 専用の拡張プラグインを表しています。

ページの表示領域を有効に！「WCEX スライド・ショーケース」

Welcart Home にもスライド・ショーケースが使われています

WCEX スライド・ショーケース Slide Showcase は、商品サムネイルを横に並べ、スライドさせて見せるための拡張プラグインです。情報量の多いショップでは、お勧めや新着商品をスライド式にして表示領域を有効利用できます。
また、オートスクロール機能を使うことでページに動きを持たせる事ができます。

縦に並べて縦スクロールというのも簡単。サイドバーに縦に並べてオートスクロールなんてなかなか面白いかも。

スライド・ショーケース設定画面

設定は全て管理画面で行い、後はテンプレートタグを1行、表示したいページのテンプレートに挿入するだけ。
<?php wcex_slide_showcase(‘welcart_1′); ?>

その他、カテゴリーごとの絞込み、複数のショーケースを一括管理など機能が有ります。もちろんスタイルシートや画像を修正して独自のデザインにすることも可能です。

このプラグインは、Jan Sorgalla 氏の jQuery plugin、「jCarousel」を簡単にWelcart に使えるようにと開発されています。


WCEX Slide Showcase の詳細

DL販売専用ネットショップに！「WCEX DL Seller（ダウンロード・セラー）」

WCEX DL Seller は、通常物販のWelcart をファイルのダウンロード販売用のカートに変更する拡張プラグインです。

商品編集画面

ダウンロード失敗やファイルのアップデートなどの事態に備えて再ダウンロード（期限指定可）が可能となっています。その為カートは会員制になっていますが、名前とメールアドレスのみで会員登録できるよう簡素化されています。

弊社では、ケータイのコンテンツ・ダウンロード公式サイトの作成・運営を行っていますが、そのノウハウを取り入れ、不正ダウンロードの無い安心できる運営が可能です。

決済方法は自由に設定できます。クレジット決済（決済モジュールが必要）を選んだ場合は即ダウンロードが可能となり、振込みを選んだ場合は入金を確認してからダウンロードできるようになります。

Welcart は会員がその商品を購入したかどうか、いつ購入したかなどをチェックして再ダウンロードページや決済ページへ誘導します。期限付きの再ダウンロード商品の管理に威力を発揮します。



WCEX DL Seller はダウンロード販売専用となりますので、同時に物販も行うことはできません。
ファイルは全て一旦ダウンロードされます。mp3 やavi などのファイルはストリーミング再生はされません。


WCEX DL Seller の詳細




次回は商品一覧ページを自動レイアウトしてくれる拡張プラグイン「WCEX Item List Layout」をご紹介します。

フックとは何か

WordPress のプラグインAPI は、固定で出力される部分をユーザーが自由に変更できる仕組み（フィルター）と、特定のタイミングで独自の処理をさせる事ができる仕組み（アクション）の2通りの機能を持っています。しかも、この仕組みは本体を改変することは無いのでアップグレードの際にカスタマイズが消えてしまうということは有りません。

例えば記事タイトルを表示する処理に、ユーザーが作成した処理を割り込ませてタイトルを書き換えてしまったり、記事がデータベースに保存されるタイミングで別の処理を実行させたりと、ユーザーはかなりいろんな事ができるようになっています。

前もって作った関数を、本体の特定の位置（フック）に引っ掛けておきます。そこへ処理が流れてきた時にその関数が実行されるという仕組みになっているのです。

2つのフック

• フィルター・フック apply_filters() ・・・・ htmlなどテキストを修正して返すフック
• アクション・フック do_action() ・・・・ 処理を実行するのみで値は返さないフック

下記のコードは、ベストセラー・ウィジェットのリストを生成しているテンプレートタグusces_list_bestseller() のコードの一部で、フィルター･フックの例です。
このコードは本体に書かれているもので、これを改変してはいけません。

	$htm = '<ul>';
	for($i=0; $i<$num; $i++){
		if(isset($ids[$i])){
			$post = get_post($ids[$i]);
			$disp_text = apply_filters('usces_widget_bestseller_auto_text', wp_specialchars($post->post_title), $ids[$i]);
			$list = '<li><a href="' . get_permalink($ids[$i]) . '">' . $disp_text . '</a></li>';
			$htm .= apply_filters('usces_filter_bestseller', $list, $ids[$i], $i);
		}
	}
	$htm .= '</ul>';

apply_filters() の第1引数はフック名です。この場合 usces_filter_bestseller という名前のフックということになります。
第2引数は、何も無ければ表示されるデフォルトのテキストです。
第3引数以降は任意で、ユーザーが必要だろうと思われるデータが設置されています。

この apply_filters() は、ユーザー関数が無ければ第2引数をそのまま返し、あればユーザー関数の返り値を返すという動きをします。

どうやってフックに引っ掛けるか

フックが有ってユーザー関数がある。では、ユーザー関数はどの様にしてフックに紐付け（フックに引っ掛け）られるのかを見て行きます。

2つの紐付け関数

• add_filter() ・・・・ ユーザー関数をフィルター･フックに紐付ける
• add_action() ・・・・ ユーザー関数をアクション･フックに紐付ける

下記のコードは、ベストセラー・ウィジェットのリストを整形するためのコードです。
このコードは、ユーザーが利用中のテーマのフォルダ内にある functios.php などに記述します。

add_filter('usces_filter_bestseller', 'my_bestseller_func', 10, 3);
function my_bestseller_func() {
	$args = func_get_args();
	list($html, $post_id, $index) = $args;
	$post = get_post($post_id);
	$list = '<li>第' . ($index+1) . '位<a href="' . get_permalink($post_id) . '">' . $post->post_title . '</a></li>';
	return $list;
}

add_filter() が紐付け関数です。

第1引数が引っ掛けるフックの名前です。

第2引数はユーザー関数名。自由に名前を付けられます。バッティングしないように気をつけます。

第3引数は優先度。 このフックを利用するユーザー関数が複数有った場合の優先度です。とりあえず10にしておきましょう。

第4引数はフックから取得できる変数の数です。この引数の必要性があまり感じられないのですが、省略すると1つしか取得できなくなります。ここではフックが3つのデータをユーザーに送っていますので3として全てを受け取れるようにします。

ユーザー関数

フックからのデータを受け取る

$args = func_get_args();　←　重要！

func_get_args() はフックから送ってくる引数を取得する関数です。

一つしか取得する変数が無い場合はこの様にしてもOKです。

 function my_bestseller_func( $html ) { 

受け取ったデータを下にhtml を生成して、最後に return で返してやります。

例）タイトルに飾り付けを

WordPress 本体に、’the_title’　というフィルター・フックが有ります。これを使って記事タイトルに飾りを付けてみましょう。但し、一覧表示のページ（カテゴリーページなど）のタイトルは変更しないこととします。

add_filter('the_title', 'my_title', 10);
function my_title( $title ){
	if( is_singular() && in_the_loop() ){
		$title = '★' . $title;
	}
	return $title;
}

フィルター･フック ‘the_title’ は、テンプレートタグ the_title() に設置されているフックです。従ってこのテンプレートタグでタイトルを表示している部分全てに影響を与えてしまいます。

そのため、is_singular() という条件分岐タグで単体ページだった場合といった条件をつけます。それでもヘッダーやサイドバーのメニューに★が付いてしまいますので、in_the_loop() で条件をきります。これで単体ページの記事タイトルだけに★マークが付きます。

条件を付けなかった時にどうなるか実際に確認してみてください。

カスタマイズのコツ

この様に、フックをうまく使うことで自分の思い通りの出力ができるわけですが、使い方は解っても実際にカスタマイズとなると、何からどう手を付けていいのかピンと来ないかもしれません。そんな時は次のように整理してみると良いかもしれません。

1. カスタマイズしたい部分はどこに書かれているか
まずはどのファイルのどこに書かれているかを知らなくては始まりません。予想されるキーワードでマルチ検索してコードを探してみましょう。どうしてもわからない場合は「開発フォーラム」で質問してください。

2. 該当箇所にフックがあるか
フックが有った場合はどんな引数を持っているを確認して、その引数やグローバル変数で自分のやりたい事ができるかどうかを判断する。
フックが無い場合は「開発フォーラム」に提案してみましょう。

3. ユーザー関数をどこに設置するか
設置する場所はテーマフォルダ内のfunctions.php になります。ここでは説明しませんでしたが、カスタマイズの規模が大きい場合は拡張プラグインを作成する方が管理しやすいでしょう。プラグインの作成方法はWordPress Codex を参照してください。

カスタマイズは、原則的にフックを利用して行われるべきです。本体は必ずアップグレードされます。その中には脆弱性の修正が含まれているかもしれません。本体を改変することはブランチを作り出すことであり、今後アップグレードができなくなることをクライアントに明確に説明しなくてはいけないでしょう。

参考資料

今回は主にフィルター･フックを例に挙げて説明いたしましたが、アクション･フックもとても便利です。例えば、アクション･フックを使うと注文完了時に自前のデータベース（テーブルに）独自のデータを記録する、何てこともできるでしょう。

また紐付け関数も、上に挙げたもの以外に紐付け関係を解消するためのものなどが有ります。興味が有りましたらWordPress Codex プラグインAPI をご覧ください。

同時に有償サポートサービスも開始しました。フリーのオープンソースにリスクを感じていらっしゃる方には最適です。問題解決のお手伝いをいたします。

この有償サポートサービスの販売も「DLSeller」が活躍しています。「DLSeller」はコンテンツファイルのダウンロード及びサービスの販売ができるようになっています。Welcart Home にて動きを確かめてみてください。（有償サポート用送信フォームは「DLSeller」では無く、単にテンプレートで実現しています）

この「DLSeller」、発売は6月中と告知しておりましたが、遅れに遅れて大変申し訳ありません。Welcart Home での動作を最終確認しましてから発売したいと思います。今しばらくお待ちくださいませ。

「DLSeller」の動きや、各サービス・コンテンツの価格などについて、みなさんのご意見をお聞かせください。

SSLページで一部不具合が出ましたので修正版をリリースしました。

主な修正内容は次の通りです。

• SSLページを閲覧中、リンクが全てhttps になってしまう不具合を修正
• 不要なJavaScript の関数を削除

よろしくお願いいたします。

主な修正内容は次の通りです。

• デフォルトテーマで、会員システムを使っていない場合、固定のログイン・ウィジェットを非表示になるよう修正
• デフォルトテーマで、カスタムメニューの不具合を修正
• 支払い発送方法ページにて情報が遷移されていなかった不具合を修正

よろしくお願いいたします。

早速アップグレードしてみましょう。

WordPress 3.0　+　Welcart 0.5　では商品にカスタムフィールドやコメントが利用できるようになっています。また、新しいWelcart デフォルトテーマではWordPress のカスタムメニューが使えるようになっています。

是非、お楽しみください

Welcart はWordPress をECシステムに変身させるプラグインです。しかしWordPress 本体をハックするようなことはしていません。WordPress には、本体をハックせずに機能を変更・拡張できる仕組みがあります。それが「プラグインAPI」です。
WordPress Codex にはこう書かれています。「WordPress はプラグインを WordPress 本体に “引っ張り込む (hook into)” ためのフックを提供しています。これはつまり、特定のタイミングでプラグインの関数を呼び出したり、それによってプラグインを作動させたりするためのものです。」
Welcart もこの仕組みを利用してWordPress の機能を拡張しています。

Welcart 本体にもフックが有れば、そのフックに引っ掛けて自分の関数を実行できるはず。つまりWelcart をハックせずにカスタマイズが可能ということです。実は、多くのプラグイン制作者がしているように、Welcart にもたくさんの独自のフックが設置されています。例えば’usces_filter_selling_price’ というフックは、「販売価格」という表示ラベルを出力させる際に適用されるフィルターフックです。このフックに対して「受講料」と出力する関数を設置すると、表示ラベルを「販売価格」から「受講料」にカスタマイズする事ができるのです。

現在、Welcart に設置されているフックは、上記のような表示を変えるものから、入力フォームのチェックを変更するものや、インクルードするテンプレートを変更するものなど様々です。他にもどんなフックが存在するのかを調べるには’apply_filters’ 若しくは、’do_action’ のキーワードでコードを検索してみてください。Dreanweaver などのフォルダー内検索で簡単に全てのフックを探し出せます。

しかし、Welcart に設置されているフックは限定的でまだまだ足りないと思っています。もしご自分が変更を加えたいところにフックが存在しなかったら、開発フォーラムで提案してみてください。フックの設置は精査されなくてはいけませんが、まだまだ余裕が有りますのでご要望のフックを設置できる可能性は高いはずです。万が一提案したフックが採用されなかったとしても、ご自分でそのフックの設置を行うことでメンテナンス性をあげる事ができます。なぜならば、「どのファイルのどこにフックを設置した」ということだけを管理していればよいからです。アップグレードのための補修はフックを設置しなおすだけで済みます。

もちろん、Welcart のフックを利用してさえいればメンテナンスを必要としないアップグレードが保障されるというわけでは有りません。仕様の変更でカスタマイズ自身も修正を加えなくてはいけない場面もあるでしょう。それでも、直接本体をハックするよりも格段にメンテナンス性を高める事ができるはずです。

クライアントからの要求を実現させるというビジネスは当然で、Welcart はそういったビジネスを応援します。やむを得ず本体をハックする必要が出てくる場面もあるでしょう。その様な場合、アップグレードの際に必要となる補修（メンテナンス）の工数は直接クライアントの利益となるものです。単に要望を実現できるだけではなく、どれだけメンテナンス性の高いカスタマイズができるかが、真に制作者・開発者に求められているものだと思います。その重要なポイントが「WordPress プラグインAPI」なのです。

Welcart Home では、この様にクライアントサイドに立ったショップ制作ができる業者様をページ上で紹介していきたいと思います。個人・法人は問いません。Welcart を利用して制作したショップを見せて頂き（公開はしません）、どの様にカスタマイズされたかをご説明ください。（コードを見せていただく必要があります）
応募は問合せフォームより送信してください。少し審査に時間がかかるかもしれませんが、こちらから追ってご連絡させて頂きます。

WordPress3.0日本語版にアップグレードして万が一不具合が出たらすぐに「開発フォーラム」にご一報ください。

注意！
WordPress3.0 を利用するためには、Welcart0.5 にアップグレードする必要があります。

よろしくお願いします。