Geeklogのコンフィギュレーション

コンフィギュレーション用ファイル

旧バージョンのGeeklogでは、主要な設定を網羅したconfig.php という巨大なファイルを使用していました。Geeklog 1.5.0では、設定の大部分をデータベースに記録し、ユーザーは管理者機能のコンフィギュレーション(Configuration)からアクセスできるようになりました。

技術上の理由で、ファイルに保存しなければならない設定もあります。次の2つです:

• db-config.php
• siteconfig.php

この2つのファイルはGeeklogをインストールするときに更新されるだけなので、ふつう、手動で編集する必要はありません。

コンフィギュレーションオプション

Geeklogのコンフィギュレーションオプションは以下のようにグループ分けされています。

• サイト(Site)
• 記事とトラックバック(Articles and Trackback)
• テーマ(Theme)
• ブロック(Blocks)
• ユーザーと投稿(Users and Submissions)
• 画像(Images)
• 言語とロケール(Languages and Locale)
• その他(Miscellaneous)
• ファイルマネージャー(File Manager)

サイト

サイト: サイト

サイト: メール

サイト: フィード

Geeklogでは、記事の見出しを様々なフォーマット(RSS, RDF, Atom)でフィードとして出力できます。これにより、他のサイトと記事を共有できます。(ヒント：Geeklogサイトで他のサイトの記事のフィードを読み込むために、管理者のブロックメニューでポータルブロックを作成してください。)

Geeklog 1.3.9以降、フィードは管理者メニュー(フィード)から作成・設定できます。以下の設定は、管理者メニューからフィードを新規作成するときの デフォルト としてのみ使用されます。

<p>[Original Article: <a href="%s">%s</a>%s%s]\n

 記事の投稿者: <a href="%s">%s</a>

, Comment By: <a href="%s">%s</a>

サイト: パス

サイト: データベース

サイト: 検索

記事とトラックバック

記事とトラックバック: 記事

記事とトラックバック: トラックバック

記事とトラックバック: ピングバック

テーマ

テーマ: テーマ

テーマ: テーマの拡張設定

ブロック

ブロック: 管理者ブロック

ブロック: 話題ブロック

ブロック: オンラインユーザーブロック

ブロック: 新着情報ブロック

ユーザーと投稿

ユーザーと投稿: ユーザー

ユーザーと投稿: Spam-X

ユーザーと投稿: ログイン

ユーザーと投稿: ユーザーによる投稿

ユーザーと投稿: 投稿設定

ユーザーと投稿: コメント

画像

画像: 画像ライブラリ

画像: アップロード

画像: 記事の画像

画像: 話題アイコン

画像: ユーザーの写真

画像: Gravatar

言語とロケール

言語とロケール: 言語

Geeklog Wikiの多言語サポート(Multi-Language Support)も参照してください。

言語とロケール: ロケール

その他

その他: クッキー

以下の設定では、Geeklogが使用するクッキー名を指定します。他のソフトウェアが使用するクッキーと名前が重複する場合は簡単に変更できます。

その他: その他

その他: デバッグ

その他: デイリーダイジェスト

その他: HTMLフィルター

その他: バッドワードチェック(Censoring)

その他: IPアドレス検索

その他: パーミッション

その他: Webサービス

Geeklog WikiのWebサービスを使用する(Using the Webservices)も参照してください。

その他: パンくずリスト

ファイルマネージャー(File Manager)

Geeklog-2.1.0では、MITライセンスでSimon Georgetが公開しているオープンソースのファイルブラウザー Filemanager を組み込みました。

新規インストール時には、Root管理者、記事管理者(Story Admins)、静的ページ管理者(Static Page Admins)だけがファイルマネージャーを使用できます。

ファイルマネージャー: 全般

ファイルマネージャー: アップロード

ファイルマネージャー: 画像

ファイルマネージャー: ビデオ

ファイルマネージャー: オーディオ

db-config.php

その名が示すように、db-config.phpファイルには、データベースの設定が記述されています。この情報はインストール時に書き込まれるので、ふつう、手動で編集する必要はありません。

siteconfig.php

siteconfig.phpファイルには、データベースに保存できない設定が記述されています。設定の大半はインストール時に書き込まれるので、ふつう、このファイルを手動で編集する必要はありません。

URLリライト

Geeklogには、単純でありながら役に立つURLリライト機能が含まれており、クローラーに適した(つまり、検索エンジンのインデックス作成用ボットがサイトを訪問しやすくなる)URLを出力できます。この機能は、記事・話題・静的ページ・記事一覧・リンクプラグインのURLでサポートされています。

URL書き換えにより、たとえば

https://www.geeklog.net/article.php?story=20021022234959146

というURLは、

https://www.geeklog.net/article.php/20021022234959146

となります。1番目の形式のURLを解釈する検索エンジンもありますが、Googleは2番目の形式を好み、1番目の形式を無視するようです。(訳注)この記述は現在では当てはまりません。

注意:この機能はすべてのWebサーバーで機能するとは限りません。Apache(全バージョン)では機能しますが、IIS(の少なくとも一部のバージョン)では動作しない ことが知られています。サイトを公開する前に検証してください。

注意: トップページが1ページ目以外の場合、話題のURLを使用します。 トップページを表す話題IDはダッシュ "-" です。これはURLルーティングにも当てはまります。

URLルーティング

この機能は上述のURLリライトを拡張し、public_html/index.phpを 疑似フロントコントローラーとして使用します。したがって、URLルーティング機能を使うには、 URLリライトを有効にする必要があります。

現時点では以下のルールが定義されています(URLリライトが有効なコンテンツを網羅しています):

表の1行目をご覧ください。"http://yourdomain/index.php/article/@sid/print"にアクセスすると、 "http://yourdomain/article.php?story=@sid&mode=print"にリダイレクトされることを意味しています。 @sidは記事のIDです。

次に3行目をご覧ください。@の後にアルファベットが続くものがプレースホルダーです。たとえば、 "http://yourdomain/index.php/archives/all/2016/1" にアクセすると、ルールの中の @topicが"all"に、@year が "2016" に、そして @month が "1" にマッチします。その後、ルートの中の プレースホルダーがマッチした値に置き換えられ、"http://yourdomain/directory.php?topic=all&year=2016&month=1" にリダイレクトされます。

ルールの中に"/index.php"を含める必要はありません。

無限ループになるので、ルートの先頭は "/index.php/" にしないでください("/index.php?" は大丈夫です)。

プレースホルダーは@で始まり、アルファベットが続きます。プレースホルダーは大文字・小文字を区別します。

URLルーティングは逆向きにも働きます。自作のプラグインやカスタム関数の中でURLを出力する時に、 COM_buildURL 関数を使い、URLルーティング(admin/router.php)で独自のルールとルートを設定する ことでURLルーティングを行うことができます。

注意: この機能は全てのWebサーバーで使えるとは限りません。PHPの $_SERVER['PATH_INFO'] 変数を使用します。サイトを公開する前に検証してください。

高度な機能: Webサーバーとして IIS を使用し、ユーザーがアクセスするURLから "index.php" を取り除きたいなら、適切なリダイレクトを設定した web.config ファイルを lib-common.php と同じディレクトリに作成する必要があります。

1. まだ設定していないなら、リライトモジュールをwebサーバーにインストールしてください(Microsoft Web Platform Installer を使用してください)。
2. Geeklogをインストールした公開領域のディレクトリ(lib-common.phpのあるディレクトリ)に "web.config" という名前の ファイルを作成し、以下の行を追加します。Geeklogをドキュメントルートのサブディレクトリにインストールしている場合には、少し変更する必要があるでしょう。
   

           <configuration>
               <system.webServer>
                   <rewrite>
                       <rules>
                           <rule name="Imported Rule 1" stopProcessing="true">
                               <match url="^(.*)$" ignoreCase="false" />
                               <conditions>
                                   <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
                                   <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
                               </conditions>
                               <action type="Rewrite" url="/index.php/{R:1}" />
                           </rule>
                       </rules>
                   </rewrite>
               </system.webServer>
           </configuration>
       

3. 最後に、管理者としてログインし、コンフィギュレーションでURLルーティングの設定を 「有効(index.phpなし)」に変えます。

注意: URLルーティングを使用するが、定義済みのルートを削除したり無効にしたりすると、そのルートはURLリライトの設定に従って表示されます。例外は話題だけです。話題のルートを削除したり無効にしたりすると、話題のURLは "https://www.example.com/@topic"、2ページ目以降は "https://www.example.com/@topic/@page" となります。topicプレースホルダーはありません(上述のURLリライトの例をごらんください)。これは現在のGeeklogとルーターの制限ですが、必要なら、URLリライトを反映するルートを変更することができるので、問題にはならないはずです。

注意: ステータスコードは200だけを使用すべきです。他のオプションは現時点ではうまく機能しないため、使用すると予想できない問題を引き起こす可能性があります。

高度な機能: WebサーバーとしてApacheを使用し、ユーザーがアクセするURLから "index.php" を取り除きたいなら、以下のことを行います。警告! Webサーバーの 設定を熟知していない場合は、この機能を使わない方が良いでしょう。

1. Webサーバーの rewrite モジュールを有効にします。"httpd.conf" の中で次の行を探します。
   # LoadModule rewrite_module modules/mod_rewrite.so
   そして行頭の#を取り除いてコメントを外します。Webサーバーを再起動するのを忘れないでください。
2. Geeklogをインストールしている公開領域のトップのディレクトリ(lib-common.phpがある場所)に ".htaccess" という名前のファイルを設置し、次の行を追加します。

           <IfModule mod_rewrite.c>
               RewriteEngine On
               # RewriteBase /
               # Directs all Geeklog requests through the site index file
               RewriteCond %{REQUEST_FILENAME} !-f
               RewriteCond %{REQUEST_FILENAME} !-d
               RewriteRule ^(.*)$ /index.php/$1 [L]
           </IfModule>
       

   Geeklogをドキュメントルートのサブディレクトリにインストールしている場合は、

               RewriteRule ^(.*)$ /index.php/$1 [L]
       

   を、

               RewriteRule ^(.*)$ [sub_directory]/index.php/$1 [L]
           

   や、

               RewriteRule ^(.*)$ /[sub_directory]/index.php/$1 [L]
           

   に変える必要があるでしょう。
3. 最後に、管理者としてログインし、コンフィギュレーションでURLルーティングの設定を 「有効(index.phpなし)」に変えます。

ローカリゼーション(Localization)

Geeklogをローカライズするのは簡単です。文字列はすべて言語ファイルに格納されています。Geeklogに最初から同梱されているのはenglish.phpです。他の言語への翻訳に関心のある方はGeeklog翻訳(geeklog-translations)メーリングリストへの加入をお勧めします。Geeklogの翻訳に関する重要な情報はみなこのメーリングリストに投稿されます。

ロケールと日時のフォーマット

ロケールと日時のフォーマットの設定はコンフィギュレーションで行えます。ロケールを設定するには、適切な文字列を設定するか空白のままにしておきます。後者の場合は、オペレーティングシステムのロケールの既定値が使用されます。日時のフォーマットはロケールによって処理が決まります。ロケール名はオペレーティングシステムに依存します。ほとんどのUNIX系のホストでは、ロケールコードは/usr/share/locale/locale.alias ファイルに記述されており、locale -a コマンドで利用可能なロケールすべてを表示できるシステムもあります。ロケールが存在しない場合は、localedef コマンドで作成できます。

ロケールに関する詳細は、http://www.opengroup.org/onlinepubs/7908799/xbd/locale.html、
localdef コマンドに関する詳細は、http://www.opengroup.org/onlinepubs/7908799/xcu/localedef.html
を参照してください。

日時のフォーマット

(訳注：以下の表現は、PHPマニュアルの表現を参考に、一部を修正しています。)

• %a - 短縮された曜日の現在のロケールに基づいた名前
• %A - 完全な曜日の現在のロケールに基づいた名前
• %b - 短縮された月の現在のロケールに基づいた名前
• %B - 完全な月の現在のロケールに基づいた名前
• %c - 日付と時刻の現在のロケールに基づいた表現
• %C - (年を100で割って整数とした)世紀(00から99)
• %d - 10進数で表現した日付(01から31)
• %D - "%m/%d/%y"の形式で表現した日付
• %e - 1桁となる場合は前に半角スペースを1つ置いた、10進数で表現した日付(' 1'から'31')
• %h - "%b"と同じ
• %H - 10進数で表現した24時間表示の時間(00から23まで)
• %I - 10進数で表現した12時間表示の時間(01から12まで)
• %j - 10進数で表現した年間の通し番号の日付(001から366)
• %m - 10進数で表現した月(01から12)
• %M - 10進数で表現した分(00から59)
• %n - 改行文字
• %p - `AM'または`PM'の現在のロケールに基づいた表現
• %r - `AM'または`PM'を含んだ12時間表示の時刻の、現在のロケールに基づいた表現
• %R - "%H:%M"の形式で表現した時刻
• %S - 10進数で表現した秒(00から61、閏秒を表現できるため59ではなく61まで)
• %t - タブ文字
• %T - "%H:%M:%S"で表現した時刻
• %u - (月曜日を開始日として)10進数で表現した曜日(1から7)
• %U - (日曜日を開始日として)10進数で表現した年間を通した週の番号(00から53)
• %V - (月曜日を開始日として)10進数で表現した年間を通した週の番号(01から53。ISO 8601の規定によると1月1日を含む週は、その4日以上が新しい年に含まれていると1番目の週となり、そうでない場合は前年の53番目の週となります。)
• %W - (月曜日を開始日として)10進数で表現した週の年間を通した番号(00から53)
• %w - (日曜日を開始日として)10進数で表現した曜日(0から6)
• %x - 時刻を除いた日付の現在のロケールに基づいた表現
• %X - 日付を除いた時刻の現在のロケールに基づいた表現
• %y - 下2桁を10進数として表現した年(00から99)
• %Y - 4桁の10進数で表現した年
• %Z - タイムゾーンの時間差、名前、短縮名
• %% - `%'の文字そのもの