Geeklogテーマエディタプラグイン [v1.0.3]
by mystral-kk [geeklog@mystral-kk.net]
2006年11月 7日
目次
概要
テーマエディタを使うと,オンラインでテンプレートファイル(*.thtml)とカスケィディングスタイルシートファイル(*.css)を編集できます。このプラグインを使えば,テンプレートファイルを変更する度にアップロードする必要はなくなります。
改訂履歴
日付 | バージョン | 説明 |
2006年11月 7日 | 1.0.3 | [Fix] デフォルトの言語が日本語の場合に対応(Thanks, Kemal and Tsuchi)。 [New] テンプレートファイル名を大幅に追加(Thanks, Ivy)。 |
2006年11月 2日 | 1.0.2 | [Fix] magic_quotes_gpcがオンの場合に対応(Thanks, samstone)。 |
2006年10月 1日 | 1.0.0 | 初期バージョン |
謝辞
- 有益なアイデアを提供してくれたGeeklog.jpのメンバーに,
- Geeklogを開発・維持してくれるGeeklogのコア開発チームに,
感謝します。
プラグインのインストール
以下の説明で,
- <geeklog_dir>は,システムの config.php が存在するディレクトリ
- <admin>は,管理者用ファイルが存在するディレクトリ(ふつうは,<public_html>ディレクトリの下)
を表しています。
- テーマエディタプラグインはテーブルを追加するので,管理者メニューの「DBのバックアップ」やphpMyAdminを使用して,事前にGeeklogのデータベースをバックアップしておきます。
- テーマエディタプラグインのアーカイブを<geeklog_dir>/pluginsディレクトリに展開します。themeditという名前のディレクトリができます。
- adminディレクトリを作ります。<admin>/plugins/ ディレクトリの下に themeditという名前のディレクトリを作ります。
- <geeklog_dir>/plugins/themedit/ ディレクトリに移動します。adminディレクトリの内容を,3.で作成した <admin>/plugins/themedit/ ディレクトリにコピーします。
- themeditディレクトリの config.php ファイルを編集し,データベースのテーブルのプレフィックスと編集対象テーマ,編集対象ファイルなどを設定します。デフォルトでは,Geeklogのテーブルのプレフィックスを使用し,themedit admin以外のアクセスを認めないようになっています。
- Rootユーザーとしてログインし,プラグインエディタからインストールを実行します。失敗した場合には,エラーログ(error.log)を調べます。この時点で,テーマエディタプラグインはインストールされ,機能しているはずです。テーマエディタアイコンをクリックすると,管理機能ページへジャンプするでしょう。
- セキュリティを設定します。インストール直後には,テーマエディタプラグインの管理権限(themedit admin)を持っているのは,Rootユーザーだけです。ユーザーエディタやグループエディタを使用して,管理権限を他の人やグループに委譲することができます
- [***** 注意1 *****] 編集するテーマが入っているディレクトリのパーミッションを757,編集するファイルのパーミッションを646に変更する必要があります。
- [***** 注意2 *****] <admin>/plugins/ ディレクトリ内の preview.html と preview.css のパーミッションを646に変更する必要があります。
注意: テーマエディタプラグインではかなりJavaScriptを使用しています。快適な操作性を得るには,JavaScriptをオンにすることを強くお勧めします。
プラグインのアンインストール
- プラグインエディタから,テーマエディタプラグインをアンインストールします。このとき,テーマエディタプラグインが使用していたテーブルは破棄され,その中に記録されていたデータも削除されます。
- インストールの過程で作成した 2つのディレクトリ(<geeklog-dir>/plugins/themedit/ と <admin>/plugins/themedit/ を削除します。
- [***** 注意 *****] インストール時に変更したディレクトリとファイルのパーミッションを元に戻します。たとえば,ディレクトリは755,ファイルは644に変更します。
プラグインの設定
プラグインのconfig.phpでが,次の値を設定できます:
変数名 | タイプ | 説明 |
$_THM_CONF['allowed_themes'] |
テーマ名の配列 |
このプラグインを使用して編集するテーマ名(大文字小文字を区別します)を設定します。デフォルト値は,'professional' です。 |
$_THM_CONF['allowed_files'] |
ファイル名の配列 |
このプラグインを使用して編集するファイル名(大文字小文字を区別します)を設定します。テンプレートファイル(*.thtml)とカスケィディングスタイルシートファイル(*.css)を指定できます。 |
$_THM_CONF['resync_database'] |
'auto', 'manual', 'ignore'のどれか |
$_THM_CONF['allowed_themes'] にテーマを,$_THM_CONF['allowed_files'] にファイルを追加・削除する度に,テーマエディタプラグインは自動的に検出します。
- 'auto' -- プラグインはデータベースに保存されているデータを更新します。
- 'manual' -- プラグインは更新情報と,「データベースを更新」ボタンを表示します。
- 'igonore' -- プラグインは変更を無視します。
|
プラグインのアップグレード
使用法
テーマエディタプラグインはとてもシンプルなので,ほとんど直感的に使えます。
- 編集したいテーマをドロップダウンリストから選択します。
- 編集したいファイルをドロップダウンリストから選択します。
- 使用可能なテンプレート変数の一覧が表示されます。
- テンプレート変数名が書かれたボタンをクリックすると,編集画面のキャレットの位置に対応するタグが挿入されます。
注意: JavaScriptを有効にしないとこのボタンは使えません。
- 「プレビュー」ボタンをクリックすると,編集内容のプレビューが別のページで表示されます。
- 「保存」ボタンをクリックすると,編集内容がWeb上に保存されます。
- 「初期設定に戻す」ボタンをクリックすると,ファイルの内容はこのプラグインがインストールされた時点の内容に戻ります。
ライセンス
テーマエディタプラグインはGPLです。
Copyright © 2006 mystral-kk