分かっているSmarty2との非互換性

シンタクス

Smarty 3 APIはシンタクスが新しくなりました。Smarty2のシンタクスはサポートしますが、将来サポートが保証されない可能性があります。

PHPのバージョン

Smarty3はPHP5のみ対応します。PHP4では動きません。

{php}タグ

{php}タグはデフォルトでは無効になりました。{php}タグを使うことは非推奨です。$smarty->allow_php_tag=true;で{php}タグを有効にすることができます。

しかし、複数の{php}タグにまたがるPHPコードは、これ以上は動かないでしょう。

デリミタとホワイトスペース

ホワイトスペースに囲まれたデリミタは今後、Smartyのタグとして扱われません。したがって、{ foo }はタグとしてコンパイルされません。この場合、コンパイルするには{foo}とする必要があります。この変更により、{literal}が必要とならないので、Javascript/CSSが扱いやすくなります。なお、$smarty->auto_literal = false;でこの設定を無効化できます。

クォートされなかった文字列

Smarty2は、パラメータにクォートしていない文字列が現れたとき、大雑把で曖昧な面がありました。一方、Smarty3はより厳密です。といっても、特別な文字(A-Za-z0-9_以外)を含まない限り、今でもクォーテーションなしの文字列を使うことはできます。

例えば、ファイル名の文字列はクォートしなければなりません。

{include file='path/foo.tpl'}

Smartyクラスの拡張

Smarty3は初期化するのに、__constructメソッドを使います。Smartyクラスを拡張するとき、もし、小クラスが独自のコンストラクタを定義すると、Smartyのコンストラクタは実行されません。Smartyのコンストラクタを実行する必要があれば、小クラスのコンストラクタでparent::__construct()を実行してください。

class MySmarty extends Smarty {
   function __construct() {
       parent::__construct();
    
       // your initialization code goes here

   }
}

オートローダー

Smarty3はspl_autoload_registerで独自のオートローダーを登録します。もしあなたのコード中に__autoload関数が存在するのなら、 それを明示的に__autoloadスタックに登録しなければなりません。 詳しくは、http://us3.php.net/manual/en/function.spl-autoload-register.php を御覧下さい。

プラグインファイル名

Smarty3ではPHP spl_autoloaderをサポートしています。このオートローダーは、ファイル名を小文字にすることを要求しています。したがって、Smartyプラグインのファイル名は小文字である必要があります。Smarty2では、大文字小文字が混在したファイル名でも動作しました。

特別なSmarty変数のスコープ

Smarty2では特別なSmarty変数(例えば、$smarty.section...や$smarty.foreach)がグローバルスコープでした。もし、同じ名前のループがサブテンプレートにあると、親テンプレートの変数を上書きしていまします。

Smarty3では特別なSmarty変数は、ループがあるテンプレートのローカルスコープになります。もし、親テンプレートの変数をサブテンプレートに渡す場合は、パラメータにする必要があります。

{include file='path/foo.tpl' index=$smarty.section.foo.index}

SMARTY_RESOURCE_CHAR_SET

Smarty3はutf-8をデフォルトcharsetとして、定数SMARTY_RESOURCE_CHAR_SETに定義します。これは、escapeのような修飾子のデフォルトcharsetとして使われるようになります。もし、utf-8以外のcharsetをテンプレートで使う場合、適宜にSMARTY_RESOURCE_CHAR_SETを定義することに注意してください。そうしなければ、なにも出力されない可能性があります。

改行での{if}タグ

テンプレートのソースに予期される改行の出力を得るために、{if},{else},{elseif},{/if}タグのコンパイル後コードに¥nが追加されました。もし、{if}タグなどが行末にある場合、HTMLの出力結果が改行されます。

パスワードは定期的に変更するほうがより安全と言われています。PasswordLimitterは、XOOPSのユーザのパスワードに期限を設け、期限がすぎたユーザに対しては、ログイン時にパスワード変更を促すメッセージを表示します。

インストール方法

1. PasswordLimitter.class.phpを/preloadにアップロード
2. 管理アカウントで、http://あなたのXOOPS/misc.php?password_limitter=adminにアクセス
3. 「INSTALL」をクリックしてインストールを実行
4. その後、設定ページで期限日数を設定する

アンインストール方法

1. 管理アカウントで、http://あなたのXOOPS/misc.php?password_limitter=adminにアクセス
2. 「UNINSTALL」をクリックしてインストールを実行
3. PasswordLimitter.class.phpを/preloadから削除

変更点 1.0 => 1.2

• ユーザ新規登録時に有効期限がセットされないバグを修正。

1.1とばしてしまった…orz

開発情報

• リポジトリ

• この情報は古いです。新しい情報を御覧下さい。

パスワードは定期的に変更するほうがより安全と言われています。PasswordLimitterは、XOOPSのユーザのパスワードに期限を設け、期限がすぎたユーザに対しては、ログイン時にパスワード変更を促すメッセージを表示します。

インストール方法

1. PasswordLimitter.class.phpを/preloadにアップロード
2. 管理アカウントで、http://あなたのXOOPS/misc.php?password_limitter=adminにアクセス
3. 「INSTALL」をクリックしてインストールを実行
4. その後、設定ページで期限日数を設定する

アンインストール方法

1. 管理アカウントで、http://あなたのXOOPS/misc.php?password_limitter=adminにアクセス
2. 「UNINSTALL」をクリックしてインストールを実行
3. PasswordLimitter.class.phpを/preloadから削除

開発情報

• リポジトリ

PidginはWindowsで使える統合メッセンジャーです。なので、Pidginをインストールするだけで、MSNメッセンジャー・Googleトーク・Yahooメッセンジャーなどを同時に使うことができ便利です。

NateOnは韓国で最もシェアのあるインスタントメッセンジャーです。Windowsであれば、NateOnをインストールすることができます。しかし、韓国語のソフトであるためか、日本語Windowsでは文字化けを起こすことがしばしばあります。また、NateOnは基本的に韓国語のインターフェイスになるので、韓国語に不慣れな人には操作が難しい面もあります。

そこで、NateOnを日本語にきちんと対応してあるPidginで使うことをおすすめします。PidginでNateOnを使うためには、以下のファイルをダウンロードします。

• Pidgin本体
• Pidgin用NateOnプラグイン

Pidgin本体のダウンロード手順

1. http://www.pidgin.im/(英語)にアクセス。
2. Pidginをダウンロードする。

   

Pidgin用NateOnプラグインのダウンロード手順

1. 配布先にアクセス。
2. pidgin-nateon_svn140.zipをダウンロードする。

   

Pidginをインストール

ダウンロードしてきたPidgin本体をダブルクリックしてインストールします。インストールは手順にしたがって行います。

NateOnをPidginに統合する

Pidginを起動している場合は一端終了してください。pidgin-nateon_svn140.zipを解凍します。解凍すると、locale, pixmaps, pluginsの3つのフォルダが現れます。それらを、C:\Program Files\Pidginにコピーします。上書きが必要な場合は、上書きします。

これで、NateOnがPidginで使えるようになったはずです。Pidginを起動して、NateOnが使えるか確認します。NateOnのアカウントの追加は、以下の手順で行います。

1. 「アカウント」→「Manage Accounts」

   

2. 「Add」をクリック

   

3. 「プロトコル：NateOn」「ユーザ名」「パスワード」「パスワードを保存する」を設定します。その後、「追加」をクリック。

   

ハングル文字化け対策

このままだと、ハングルが文字化けしています。Pidginを立ち上げてみると、「□」がたくさん並んでいるのがわかると思います。これは、Pidginのフォントがハングルに対応していないためです。

そこで、ハングル対応のフォントに置き換えます。編集するさいには、Emeditorなどのテキストエディタを使ってください。

gtk-font-name = "XXXX"

gtk-font-name = "Arial Unicode MS 10"

style "user-font"
{
    font_name="Arial Unicode MS 10"
}
widget_class "*" style "user-font"

なお、Arial Unicode MSは様々な文字に対応したユニバーサルフォントです。あまり、綺麗なフォントとは言えませんが、とりあえず読めることが重要なので、Arial Unicode MSを使います。

参考

Pidgin用プラグイン開発者さん http://blog.haz3.com/205(韓国語)

SuinDebugプリロードは、たったひとつのファイルで、あなたのXOOPS Cube Legacyでのデバッグをよりスムースにするためのサイトプリロードです。

HD画質なので、フルスクリーンで見るのをおすすめします。

特徴

• サイト(開発環境)を汚さない

  SuinDebugは、たったひとつのファイルからなるサイトプリロードです。{stdout_buffer}をテーマに書くことでテーマが汚れるデメリットや、デバッグ関連のファイルをいくつもアップロードすることで、開発パッケージに余分なファイルがあふれるデメリット、デバッグ関連の情報をデータベースに保存することで、データベースに不必要な情報が紛れ込むデメリットが一切ありません。

• エラーで画面を汚さない

  SuinDebugは、PHPやMySQLなどのデバッグ情報をウェブページに直接出力しません。デバッグ情報などによる、レイアウト崩れ・ソースの汚損からま逃れることができます。

• ポップアップウィンドウを開かない

  SuinDebugを使えば、デバッグのためにこれ以上ポップアップウィンドウを開く必要はありません。デバッグ情報はJavaScriptによるモーダルウィンドウで表示されます。つまり、ひとつのウィンドで完結するので、ポップアップからくるストレスを軽減できます。

• それなりのインターフェイス

  エラーSQLやDelegateのハイライト機能など、視覚的な面が考慮されています。また、デバッグモードを切り替える必要なしに、SQL, Delegate, XoopsTpl, stdout_buffer, PHP Errorsを一様に閲覧することができます。

使い方

1. SuinDebugをダウンロードします。
2. それを解凍して、{XOOPS_ROOT}/preload/に保存します。
3. JavaScriptをONにした状態で、管理者アカウントでログインします。
4. 管理画面でPHPデバッグモードをONにします。
5. ウィンドウ上端から100pxくらいのところにカーソルを移動するとメニューが表示されます。

注意

SuinDebugを公開サイトにアップロードしないでください。あくまで、このプリロードは非公開の開発環境で使用することを想定しています。たとえば、VMwareやXAMPP・MAMPで構築されたローカル開発環境。なお、サイトを公開する場合は、SuinDebugを削除してください。

SuinDebug description

SuinDebug is a site preload. It will help your debugging when you develop modules in XOOPS Cube Legacy.

Features

• SuinDebug doesn't litter your XOOPS

  SuinDebug consists of only one site preload file. You never have to write {stdout_buffer} in your theme. You never have to upload too many files for debugging. You never have to add any information into your database. You only have to upload SuinDebug preload.

• SuinDebug doesn't litter your webpages with errors

  SuinDebug doesn't directory output debugging information into your webpages such as PHP or MySQL. So, it doesn't break webpage layout with debugginf information.

• SuinDebug never opens popup windows any more

  To show debugging informaiton, SuinDebug uses mordal window. So it never annoy you with popup windows.

• SuinDebug has good interface

  Without changing debugging mode, you can browse SQL, Delegate, XoopsTpl, stdout_buffer, PHP Errors at the same time in the same window.

How to Use

1. Please Download SuinDebug.
2. Please Upload it to {XOOPS_ROOT}/preload/
3. Please Turn on JavaScript and login as site admin.
4. Please Turn on PHP debugging mode in legacy module.
5. Please Move your pointer by near 100px from window top.

Notice

Please DO NOT upload SuinDebug to public website. SuinDebug should be used only in local developing envenment; for example, VMware, XAMMP, MAMP and so on. When you public your website, please remove SuinDebug.

]]> Fri, 12 Feb 2010 15:40:56 +0900 http://suin.asia/2010/02/12/suin_debug_preload XOOPS プリロード ダウンロード SuinDebug http://suin.asia/2010/02/06/how_to_cancel_atok Windows付属のIMEがいやでいやでATOK(月額制)を使っていました。しかし、ATOKの必要性がそこまでなくなってきました。というのも、Google日本語入力が出てからすっかりATOKを使わなくなってきたのです。なので、ATOKを使わなのに毎月315円を払うのも勿体無い。そう思い、ATOK月額制を解約してきました。ということで、ATOK解約方法を画像を交えて説明したいと思います。

• www.justmyshop.comにアクセスして、ログインします。

  

• 「お客さまカウンター」を開きます。

  

• 「定額利用サービス」の「契約内容の確認・解約」を開きます。

  

• 内容を確認して「解約する」をクリックします。/p>

  

• さらに、「解約する（解約の受付）」をクリックします。

  

• 解約完了画面が出ます。以上です。

  

ATOKさん、お世話になりました。いままでありがとう。Googleさんは、アップデートもいちいち出たりしないで良い人です^-^。

]]> Sat, 06 Feb 2010 00:43:18 +0900 http://suin.asia/2010/02/06/how_to_cancel_atok ATOK http://suin.asia/2010/02/04/the_simplest_plugin_for_jquery jQueryは要素セレクターやクロスブラウザ対応が優れたjavascriptのライブラリで、prototype.jsと並んで広く使われています。そのjQueryでは、独自に自前の関数をプラグインという形で作ることができます。jQueryプラグインの作り方は検索すれば山ほど出てきますが、その第一歩となるプラグインの基本的な書き方が見つからなかったので記事にしておこうと思います。

次のプラグインは、単に文字色を赤くするだけのものです。mypluginがプラグイン名です。$(this).css('color', 'red');の部分以外がプラグインの骨組みとなり、この部分だけ差し替えれば、全く別のプラグインを作ることができます。

(function($){
	$.fn.myplugin = function() {
		return this.each(function() {
			$(this).css('color', 'red');
		});
	};
})(jQuery);

このプラグインの動作デモ

]]> Thu, 04 Feb 2010 08:17:00 +0900 http://suin.asia/2010/02/04/the_simplest_plugin_for_jquery jQuery javascript Tips http://suin.asia/2010/01/30/xoops_cube_legacy_developer_s_cheat-sheet_1.2 XOOPS Cube Legacyでの開発に便利なチートシート「XOOPS Cube Legacy Developer's Cheat-sheet」を更新しました。今回追加したのは、smartyの変数などです。1.1では、ライセンスを明確にしていなかったのですが、1.2からはライセンスをクリエイティブコモンズライセンス 表示2.1としたいと思います。ライセンスの許す範囲でお好きにお使い下さい。

日本語版

• PDF版ダウンロード
• Word2007版ダウンロード

English version

• Download PDF version
• Download Office Word 2007 version


この作品は、クリエイティブ・コモンズ・ライセンスの下でライセンスされています。

]]> Sat, 30 Jan 2010 21:27:16 +0900 http://suin.asia/2010/01/30/xoops_cube_legacy_developer_s_cheat-sheet_1.2 XOOPS ダウンロード http://suin.asia/2010/01/28/xoops_redirect_to_preference モジュールを作っていると、管理画面に一般設定しかないというケースがあります。この場合、管理画面のトップ(/admin/index.php)は空白のページになってしまい、なんとも不格好です。見た目もそうですが、操作性をあげるためにも、管理画面のトップが空白の場合は一般設定に転送してあげましょう。

そして下がそのコード。

require "../../../mainfile.php";

$mid = $xoopsModule->mid();

if ( defined('XOOPS_CUBE_LEGACY') )
{
	$url = sprintf('%s/modules/legacy/admin/index.php?action=PreferenceEdit&confmod_id=%u', XOOPS_URL, $mid);
}
else
{
	$url = sprintf('%s/modules/system/admin.php?fct=preferences&op=showmod&mod=%u', XOOPS_URL, $mid);
}

header('Location: '.$url);

]]> Thu, 28 Jan 2010 00:54:23 +0900 http://suin.asia/2010/01/28/xoops_redirect_to_preference XOOPS Tips PHP http://suin.asia/2010/01/25/preload_block カスタムブロックは、通常legacyモジュールやaltsysで作ることができます。ここでは、プリロードでカスタムブロックを作ることを紹介します。

その前に、ここで紹介するTipsは、管理画面でカスタムブロックを作るより、はるかに回りくどくPHPの知識が必要な点を注意しておきます。なので、特殊な機能や要件を必要としない限り、カスタムブロックは管理画面で作るべきです。

まず、XOOPS Cubeのプリロードでカスタムブロックを作るメリットはいくつかあります。

• ファイルとして配布できる
• ファイルなので、不要になれば削除するだけ
• PHPなどの複雑なロジックが書きやすい（通常のカスタムブロックでもPHPは使えます）

特にこの中でも、ファイルとして扱えるメリットは大きいです。たとえば、開発環境で一定の変数を出力したりとデバッグ用途にブロックをプリロードで実装します。あとは、公開するときにプリロードを削除するだけで、データベースを汚したりすることは一切ありません。管理画面で操作するブロックだと、ついつい消し忘れ・消し損ないなんてこともありますが、プリロードだとファイルを確実に削除すれば、消し損なうこともありません。

ダウンロード

次に、プリロードのソースを紹介します。16行目の$indexが、ブロックを表示する位置になります。l, r, cl, cc, crの順に、左・右・中央左・中央中・中央右を意味します。

18行目から22行目はブロックの表示に関する設定です。nameはブロック名で、アルファベット英数ですきな名前を指定します。titleはブロックの題目で、ブロックの上部に表示されます。contentはブロックの内容で、HTMLなどで書くことができます。weightはブロックの並び順で、数値が小さいほど上に、数値が多きほど下にブロックが表示されます。

<?php
/**
 * A simple description for this script
 *
 * PHP Version 5.2.4 or Upper version
 *
 * @package    PreloadBlock
 * @author     Hidehito NOZAWA aka Suin <http://suin.asia/>
 * @copyright  2009 Hidehito NOZAWA
 * @license    http://www.gnu.org/licenses/gpl-2.0.html GNU GPL v2.0
 *
 */

class PreloadBlock extends XCube_ActionFilter
{
	protected $index = 'l';
	protected $block = array(
		'id'      => -1,
		'name'    => 'preload_block',
		'title'   => 'プリロードブロック',
		'content' => '<i>ブロックの内容</i>',
		'weight'  => -1, // 並び順
	);
	protected $indexes = array(
		'l' => 0,
		'r' => 1,
		'cl' => 3,
		'cr' => 4,
		'cc' => 5
	);
	protected $blocks = array(
		'l' => 'xoops_lblocks',
		'r' => 'xoops_rblocks',
		'cl' => 'xoops_clblocks',
		'cr' => 'xoops_crblocks',
		'cc' => 'xoops_ccblocks'
	);

	public function postFilter()
	{
		if ( $this->mController->_mStrategy->mStatusFlag != LEGACY_CONTROLLER_STATE_PUBLIC )
		{
			return;
		}

		$this->mRoot->mDelegateManager->add('Legacy_RenderSystem.BeginRender', array(&$this, 'beginRender'));
		$this->mRoot->mContext->mAttributes['legacy_BlockShowFlags'][$this->indexes[$this->index]]  = true;
		$this->mRoot->mContext->mAttributes['legacy_BlockContents'][$this->indexes[$this->index]][] = $this->block;
	}

	protected function beginRender(&$tpl)
	{
		if ( !empty($tpl->_tpl_vars['isFileTheme']) )
		{
			uasort($tpl->_tpl_vars[$this->blocks[$this->index]], array(&$this, 'reOrder'));
		}
	}

	protected function reOrder($a, $b)
	{
		if ($a['weight'] == $b['weight'])
		{
			return 0;
		}
		return $a['weight'] > $b['weight'] ? 1 : -1;
	}
}

?>

なお、このプリロードはしゃのさんのnowプリロードを参考にさせていただきました。

]]> Mon, 25 Jan 2010 17:30:10 +0900 http://suin.asia/2010/01/25/preload_block XOOPS プリロード Tips