# Geeklogテーマエディタープラグイン [v1.2.1]

by mystral-kk [geeklog@mystral-kk.net]
2012年 4月22日

## 目次

- 概要
- 改訂履歴
- 謝辞
- プラグインのインストール
- プラグインのアンインストール
- プラグインのアップグレード
- 使用法
- ライセンス

### 概要

テーマエディターを使うと、オンラインでテンプレートファイル(*.thtml)とカスケィディングスタイルシートファイル(*.css)を編集できます。このプラグインを使えば、テンプレートファイルを変更する度にアップロードする必要はなくなります。

### 改訂履歴

日付 | バージョン | 説明
--- | --- | ---
2012年 4月22日 | 1.2.1 | 修正 アンインストール時に、環境によってはエラーが発生するバグを修正しました。
2011年11月 6日 | 1.2.0 | 修正 Geeklog-1.6で導入された自動インストールに対応しました。
2010年 7月 4日 | 1.1.5 | 修正 不適切な<meta>、<br>タグを修正しました。
2009年11月 4日 | 1.1.4 | 修正 英語・日本語以外の言語を選択した場合に文字化けが起こるバグを修正しました。
2008年 9月26日 | 1.1.3 | 修正 大文字小文字を区別しないファイルシステム（MS Windowsなど）で、インクルードファイルが直接アクセスされるのを防ぐ措置を追加しました。
2008年 9月14日 | 1.1.2 | 修正 PHP-4.xで起こるエラーを避けるため、htmlentities(), html_entity_decode()関数を使用しないようにしました。
2008年 8月18日 | 1.1.1 | 修正 DokuWikiプラグインと協調できるように修正しました。
2008年 8月11日 | 1.1.0 | 新規 Geeklog-1.5.0でも動作するよう更新。 新規 Geeklog-1.5.0のコンフィギュレーションUIを使用するよう更新。
2007年 3月29日 | 1.0.5 | 修正 アポストロフィを含むパスを正しく処理するように変更。 新規 すべてのテーマを自動的に利用可能にするオプションを追加。（プラグインの設定を参照のこと。） 新規 テーマに関するすべてのファイル(*.thtml, *.css)を自動的に利用可能にするオプションを追加。（プラグインの設定を参照のこと。）
2006年12月21日 | 1.0.4 | 新規 各テーマディレクトリ下の images ディレクトリに画像をアップロードする機能を追加。 新規 ファイル名ドロップダウンリストで、ファイル名ではなく機能名を表示するように変更。
2006年11月 7日 | 1.0.3 | 修正 デフォルトの言語が日本語の場合に対応(Thanks, Kemal and Tsuchi)。 新規 テンプレートファイル名を大幅に追加(Thanks, Ivy)。
2006年11月 2日 | 1.0.2 | 修正 magic_quotes_gpcがオンの場合に対応(Thanks, samstone)。
2006年10月 1日 | 1.0.0 | 初期バージョン

### 謝辞

- 有益なアイデアを提供してくれたGeeklog.jpのメンバーに、
- Geeklogを開発・維持してくれるGeeklogのコア開発チームに、

感謝します。

### プラグインのインストール

以下の説明で、

- <geeklog_dir>は、システムの config.php が存在するディレクトリ
- <admin>は、管理者用ファイルが存在するディレクトリ（ふつうは、<public_html>ディレクトリの下）

を表しています。

1. テーマエディタープラグインはテーブルを追加するので、管理者メニューの「DBのバックアップ」やphpMyAdminを使用して、事前にGeeklogのデータベースをバックアップしておきます。
2. テーマエディタープラグインのアーカイブを<geeklog_dir>/pluginsディレクトリに展開します。themeditという名前のディレクトリができます。
3. adminディレクトリを作ります。<admin>/plugins/ ディレクトリの下に themeditという名前のディレクトリを作ります。
4. <geeklog_dir>/plugins/themedit/ ディレクトリに移動します。adminディレクトリの内容を、3.で作成した <admin>/plugins/themedit/ ディレクトリにコピーします。
5. themeditディレクトリの config.php ファイルを編集し、データベースのテーブルのプレフィックスと編集対象テーマ、編集対象ファイルなどを設定します。デフォルトでは、Geeklogのテーブルのプレフィックスを使用し、themedit admin以外のアクセスを認めないようになっています。
6. Rootユーザーとしてログインし、プラグインエディターからインストールを実行します。失敗した場合には、エラーログ（error.log）を調べます。この時点で、テーマエディタープラグインはインストールされ、機能しているはずです。テーマエディターアイコンをクリックすると、管理機能ページへジャンプするでしょう。
7. セキュリティを設定します。インストール直後には、テーマエディタープラグインの管理権限(themedit admin)を持っているのは、Rootユーザーだけです。ユーザーエディターやグループエディターを使用して、管理権限を他の人やグループに委譲することができます
8. [***** 注意1 *****]編集するテーマが入っているディレクトリのパーミッションを757、編集するファイルのパーミッションを646に変更する必要があります。
9. [***** 注意2 *****] <admin>/plugins/ ディレクトリ内の preview.html と preview.css のパーミッションを646に変更する必要があります。

注意: テーマエディタープラグインではかなりJavaScriptを使用しています。快適な操作性を得るには、JavaScriptをオンにすることを強くお勧めします。

### プラグインのアンインストール

1. プラグインエディターから、テーマエディタープラグインをアンインストールします。このとき、テーマエディタープラグインが使用していたテーブルは破棄され、その中に記録されていたデータも削除されます。
2. インストールの過程で作成した 2つのディレクトリ（<geeklog-dir>/plugins/themedit/ と <admin>/plugins/themedit/ を削除します。
3. [***** 注意 *****]インストール時に変更したディレクトリとファイルのパーミッションを元に戻します。たとえば、ディレクトリは755、ファイルは644に変更します。

### プラグインのアップグレード

新しいアーカイブを展開（解凍）してできたファイルをすべてWebサーバにアップロードし、プラグインエディターから「編集」-「更新」を実行するだけです。

### 使用法

テーマエディタープラグインはとてもシンプルなので、ほとんど直感的に使えます。

1. 編集したいテーマをドロップダウンリストから選択します。
   注意：選択できるテーマ名は `config.php` 中の `$_THM_CONF['allowed_themes']` で定義されています。必要に応じて変更してください。
2. 編集したいファイルをドロップダウンリストから選択します。
   注意：選択できるファイル名は `config.php` 中の `$_THM_CONF['allowed_files']` で定義されています。必要に応じて変更してください。
3. 使用可能なテンプレート変数の一覧が表示されます。
4. テンプレート変数名が書かれたボタンをクリックすると、編集画面のキャレットの位置に対応するタグが挿入されます。
   注意: JavaScriptを有効にしないとこのボタンは使えません。
5. 「プレビュー」ボタンをクリックすると、編集内容のプレビューが別のページで表示されます。
6. 「保存」ボタンをクリックすると、編集内容がWeb上に保存されます。
7. 「初期設定に戻す」ボタンをクリックすると、ファイルの内容はこのプラグインがインストールされた時点の内容に戻ります。
8. 「画像」ボタンをクリックすると、シンプルな画像ブラウザーが表示されます。サポートされている画像タイプは'jpg', 'jpeg', 'png', 'gif'です。テーマ名とディレクトリ名のドロップダウンリストを選択することでブラウズできます。画像をアップロードするときには、「参照...」ボタンをクリックして選択し、「アップロード」ボタンをクリックします。画像ファイルを削除したい場合は、該当のファイルにチェックを入れて、「削除」ボタンをクリックします。削除は確認なしに行われるので、注意してください。やり直しはできません。

### ライセンス

テーマエディタープラグインはGPLv2以降です。

Copyright © 2006-2012 mystral-kk