今日、社内で「開発中にXOOPSのテンプレートを毎回モジュール更新で反映させるのが面倒！！」と言ったら、プログラマ全員からツッコミを受けました。 開発中はthemesの下にファイル置いて開発すると楽だよとか、 自動更新preloadがあるよとか、 コマンドラインでモジュールアップデートするPHPプログラムがあるよとか、 Altsysでそんな機能があるよとか、色々と言われました。

$tplsadmin_autoupdate_dirnames = array('module');
include XOOPS_TRUST_PATH . '/libs/altsys/include/autoupdate_from_module.inc.php';

こんな感じで書いて、全般設定から「themes/ ディレクトリからの自動アップデートを有効にする」をはいにするだけで 特にインストールとか必要なくて楽そうなのでとりあえずAltsysの機能を使ってやってみようと思います。

こんにちわ。なおとです。

XOOPSでなにか開発しているときに、「あれ、どうやって書くのだっけ?」と書き方が咄嗟に出てこないときがあります。 そういった時に役立つのが、チートシートです。
(→XOOPS Cube Legacyでモジュール開発中に手元におきたいチートシート)

元RYUSメンバーのsuinさんが作成したものを使おうと思ったら、残念なことになんとオリジナルはダウンロードできなくなっていているようでした。(※復活しました！詳しくはこの記事のコメントからsuinさんの元記事を見てください。) さいわい印刷済の日本語版と、gusagiさんからもらった英語版のPDFはあったので、これを元にhtmlで再作成しました。

また社内ではテンプレート変数とデータベース操作、特にクライテリアの使いかたについてもチートシートが欲しいという話が持ちあがって、それも作成しました。

基本的には既存の技術情報から参考になる部分を集めて、検証しながら編集しました。
その際に、「XOOPS CUBE LEGACY デベロッパーバイブル」がたいへん参考になりました。 この本は開発者には必携です！実際には参考にしたという以上のものがあります(笑)。

また、テンプレートについてはXOOPS2時代の技術情報から参照しました。
TECH/テーマで使えるテンプレート変数 - xoops2 wiki

Cube Legacyでの実装も調べました。
SourceForge.net: xoopscube » Legacy_Theme_Smarty;ja

こちらのwikiは、ちょうど１年前にRYUSに入社したときに全ページを読んで勉強しました。 ここも重要なことがたくさん書いてあるので必見です。

さて前置きばかりが長くなってしまいましたが、最後に今回作成したバージョンにリンクしておきます。 A4に１枚で収まるように、説明などはほとんど無くて項目の羅列ばかりの内容になっています。 詳細は別途検索するなりして(よろしければ)使ってください。

• XOOPS Cube Legacy 2.x Cheat-sheet 1.0 b (A4縦)
• XCL 共通のテンプレート変数 (A4横)
• XCL Criteria

XOOPS Cube Legacyのユーザモジュールにメール一括配信をする「メールジョブ管理」というメニューがあります。

このメールジョブ管理からメール（PM送信も可能）を送るときに、本文に特殊な記述をすることで、送信先ユーザのアカウント名やメールアドレスなどを本文にうめこむことが可能です。

現在（XOOPS Cube Legacy 2.1.6a）で使えるようになってるのは下記の3つです。

もし他にも一括配信メールにいろいろ埋め込みたい場合は、preloadでこれを拡張できるようになっています。

というわけで、埋め込みタグを拡張するpreloadのサンプルを作ってみました。

・RyusExmailString

サンプルで追加したタグは次の2つです

このファイル内で実際に置き換えを実行しているのは、下記の部分になりますので、ここをお好みにあわせて変更していただければ、いくらでも好きなタグを定義できます。

	/**
	 * 
	 * @param $t_body string メール本文
	 * @param $to_user XoopsUser 送り先 
	 * @param $from_user XoopsUser 送信者
	 * @return void
	 */
	function _replace(& $string, &$to_user, &$from_user)
	{
		/*
		 * ここに置き換えを追加すれば、本文もタイトルでも置き換えタグを拡張できます。
		 */
		$to_user_name = $to_user->get('name');
		$to_user_name = empty($to_user_name) ? $to_user->get('uname') : $to_user_name;
		$string = str_replace('{X_NAME}', $to_user_name, $string);
		$string = str_replace('{X_TODAY}', formatTimestamp(time(), 's', $to_user->get('timezone_offset')), $string);
		
	}

メールの件名も置き換えたかったんですが、こちらはXOOPS Cube Legacy2.1.6aでは、デリゲートの宣言はあったのですが、実際には呼び出されてなかったため機能しませんでした。
XOOPS Cube オフィシャルサイト日本語フォーラムに要望だしておいたので、もし採用されれば使えるようになります。（もちろん自力で直してしまっても使えるようになります）