LANCARD.LAB｜ランカードコムのスタッフブログ

本日の「忘れないうちに書いとくぜ！baserCMSネタ」のお時間がやってまいりました。

baserCMS 2系でテーマヘルパーが追加されました。
http://basercms.net/functions/theme_helper

弊社サイトはlancardというテーマを作ってその下で構築しています。

現在、その中で、これから追加や編集をしていく予定があり、書き方が複雑だけど規則性がある、「ホームページのピックアップ(上部の画像切替)」と「ウィジェットのバナー表示」についてテーマヘルパーを利用して更新コストを下げています。

参考に、バナー表示用のヘルパーのコードを抽出して貼ります（ピックアップについては複雑なので）。
app/webroot/themed/lancard/helpers/lancard.php

BcBaser->getUrl('/themed/lancard/img/bunner/'.$imgFile, true)
.')';
$this->BcBaser->link(
$title,
$url,
$linkAttributes
);
}
}
?>

使用方法はこんな感じ。

bunner('OSSダウンサイジング', 'downsizing.jpg', '/it-model') ?>

と書くと

OSSダウンサイジング

と出力されます。便利です。

しかし、このテーマヘルパー、注意して扱わないと大変ヒドイ目にあいます。

テーマヘルパー用のディレクトリに「正しいテーマヘルパー以外のファイル」を置くとサイトのルーティングが全滅します。管理ページもアクセス不能！ 初めてこの現象に遭遇したときは超ビビリました。

ヘルパーを読み込もうとしてエラーが発生するわけですが、その影響範囲が想定の範囲外！

私がやってしまったパターン

• テーマヘルパー開発中に動作確認しようとしたらサイトが全滅してた。
• テーマヘルパーを更新するときに旧ファイルをlancard.php_oldとリネームしたら全滅。

 
いかがでしょうか。恐ろしいですね。

しかしこの副作用、次のチケットでかなり解決しそうですので一時的な問題だと思います。
TODO #2604 「テーマヘルパの読み込みはテーマ名のヘルパのみにする」

そうそう、ヘルパー名は上記チケットの内容にしたがってつけておきましょうね。

baserCMS のバージョンは 2.0.1 です。

baserCMSにはサイトマップを出力するヘルパーがあって、

sitemap() ?>

と書くと固定ページについてはサイトマップを自動で更新してくれて便利です。

なのですが、いろいろと不満もあるヘルパーです。

• 固定ページ以外(Blogとかメールフォーム等)はダメ。
• カテゴリのindexにページ名をつけるとカテゴリとページで同じURLが表示されてダブる。

てなわけでカスタマイズしました。

baser/views/helpers/bc_baser.php を読んでヘルパーの仕組みを調べると再帰的にページをたどっていること、テンプレート baser/views/elements/sitemap.php を使用していることが分かりました。

検討した結果、「固定ページ以外はダメ」に関して根本的な解決は出来ないのですがテンプレートのカスタマイズで対応することにしました。
データの取得方法から変更した独自ヘルパーの作成も考えたのですが、結局どこかに「Blogやメールフォームを何処に表示するか」という情報を持たせなければならないので完全自動化はできない。それならデータ取得は既存の方法を使って必要な追加設定はテンプレート内で配列にでももたせるか、と。

まず、baserCMS カスタマイズの常道としてbaserディレクトリのファイルを自分のテーマの同階層にコピー。これでコピーしたファイルが有効になるのでこのファイルを改造していきます。

改造した結果、こうなっちゃいました。

//ここから設定
//表示しないurl
$disables = array(
'/index_test',
);

//$inserts = array(before_url=>array(title, url),,,)
//before_urlの次に挿入url,titleで作成したアイテムを挿入
//ブログ、メールフォームなどpage以外を途中に挿入することが出来る。
$inserts = array(
'/sitemap' => array('新着情報', '/news'),
'/news' => array('お問い合わせ', '/contact'),
'/it-model/faq' => array('ダウンサイジングについてのお問い合わせ', '/contact_itmodel'),
);
//設定ここまで

//関数
$outputPageItem = function ($recursive, $title, $url) use (&$bcBaser) {
?>
link($title, $url) ?>
link($title, $url);
else:
echo $category_title;
endif;
echo PHP_EOL;
};
$outputCategoryItemTail = function () {
?>




element('sitemap', array(
'pageList' => $pageCategories['children'],
'category_title' => $category_title,
'category_url' => $category_url,
'recursive' => $recursive+1
));
endif;
if($outputed_category_li):
$outputCategoryItemTail();
endif;
endforeach;
endif; ?>

「カテゴリのindexにページ名をつけるとカテゴリとページで同じURLが表示されてダブる」のは解消。
追加設定に特定ページを表示したくない時のための$disables配列、Blogやメールフォームを思い通りの場所に挿入するための$inserts配列を用意することで希望する表示ができるようになりました。

しかし、元テンプレートからかけ離れているのはともかくとして、

basercmsのエレメント内で無名関数を定義して再帰呼び出しやってやったぜ〜。ワイルドだろ？

— murave (@murave) June 15, 2012

てなことをやってるので万人にはオススメできない。無名関数を使っているのでPHP5.3以降限定ですし。

関数を定義したのは「処理をパーツ化しないとコードがあまりにもカオス」「処理を再帰呼び出しする必要があった」からです。
無名関数を使ったのは「関数の影響範囲を限定したかった」から。テンプレートが複数回呼び出しされるので関数の再定義エラーがでるという問題もありましたが、これは無名関数にしなくても未定義の場合のみ関数を定義するようにすれば回避できると思います（試してませんが）。

baserCMSでリニューアルした弊社サイトですが、このスタッフブログはWordPressのまま残しました。

そうなるとサイトのフィードはbaserCMSで運用している新着情報とWordPressで運用しているスタッフブログの両方の情報が入っていて欲しい。「両方のデータベースからデータさらってきてフィードを作るプログラムでも書くかなー」などと調査したりしていたのですが、気づきました。

「feedプラグインで合成表示は出来るんだからRSSのフォーマットで出せばいいんじゃね？」

てなわけで、現在弊社のフィード(RSS 2.0) http://www.lancard.com/rss はfeedプラグインでbaserCMSのBlogのフィードとWordPressのフィードを合成して作成しています。

どうやったかといいますと、
feedプラグインで合成したフィードを作成。テンプレートについては後ほど。

フィードのキャッシュ期間ですが、baserCMSのBlogについては更新時にフィードのキャッシュはクリアされるはずなのでとりあえず1日(※2013.7.27追記：公開日時の予約をすると公開時にはキャッシュクリアされないので1時間に変更しました)、外部のスタッフブログについては長くキャッシュされるとまずいので1分にしています。

RSS 2.0 用 のレイアウト作成(ただし、WordPressに合わせて古い項目を追加してます)。
$this->cacheAction = false とすることでサーバーキャッシュは無効化。

テーマ名/layouts/rss2.php

cacheAction = false;
echo "\n";
?>



http://www.lancard.com/
Lancard.com 新着情報とスタッフブログのRSS(RSS 2.0)
feed(3); ?>

ITEM作成用に作成したfeedのテンプレートはこんな感じ。
テーマ名/feed/rss2item.php

 $item): ?>




name; ?>]]>

]]>
]]>

そして固定ページ管理でフィード用のページを作成。

layout = 'rss2'; ?>

以上です。もっといい方法がある気も。

ぶっちゃけ、弊社サイトリニューアルでの話です（baserCMS 2.0.1）。

baserCMSが2系にバージョンアップしたので「まってました！」とサイトをリニューアルしました。
さすがは「コーポレイトサイトにちょうどいい」CMS。作成はサクサクでした。

なのですが公開時に謎のルーティング不具合でハマって「ギニャー！」

どんな症状かといいますと、作成中は表示出来ていたページがなぜか

404 NOT FOUND

Error : The requested address '/recruit' was not found on this server.

app/config/routes.php に直接

Router::connect('/recruit', array('controller' => 'pages', 'action' => 'display', 'recruit'));

と追加すると表示される。どう見てもルーティングがおかしい。

baser/config/routes.php の処理を追っかけてみたりして判明したのはrecruitと渡ってきてほしいurlがrecruit/と末尾に/がついて渡って来ているということ。

公開前までは大丈夫だったのになんでだー？

結論は「apacheのwebrootに旧コンテンツのrecruitディレクトリを残していたためにbaserCMSに渡される前に/をつけられていた」のでした。

.htaccessでbaserCMSに制御をすべて渡すように設定したので、影響でるとは思いもよらず、旧コンテンツを残していたのが不幸の始まり。みなさんもお気をつけください。

ボクはこれで6時間程ハマってました。ネムイヨ。