※当アーティクルは状況に合わせて随時更新します。何か質問があれば気軽にリプライつけてください。
過去ログに書いてありそうなことでも気軽にどうぞ。
MODxのインストール手順（2008年2月10日時点の最新情報）
はじめにこれからインストールするサーバに
既知の問題点がないかを事前にチェック。XoopsやMovable Typeがインストールできるサーバならたいてい大丈夫だと思いますが、フレンドリーURL (※後述) は対応できないサーバが時々あるので注意。
本体のインストール1.
最新版をダウンロード。そして解凍。
2.解凍したそのままをサーバにアップロード。index.phpがサイトのトップページになります。
3.アップロードしたディレクトリにブラウザでアクセス。
ここまでは簡単。4.指示に従ってインストールを進めていく。パーミッション変更を求められた場合は、ディレクトリに対しては777、ファイルに対しては666を。config.inc.phpがナントカと書かれている場合は、config.inc.phpという名前の空ファイルを作ってアップロードし、同画面からリトライ。
ここだけちょっとめんどくさい。5. インストール完了。MODxのインストーラの要求どおりに動くサーバであれば後始末も自動的にされますが、そうでなければinstallディレクトリを手作業で削除。削除を忘れても、管理画面にアクセスした時に優しく叱ってくれます。
日本語設定1. http ://(インストールurl)/manager から管理画面にアクセスする。この時点では英語。
2. 「Administration」 → 「System configuration」を開く。
3. 1ページ目の「Site settings」で「Language」を「Japanese-UTF8」に設定し、ペイン左上の「Save」をクリック。これにて日本語化完了！
おつかれさまでした。最低限必要な設定はここまで。3分ほどでチャチャッとできましたか？（転送時間は別として）
※MODxではUTF-8を始めEUCなど合計7種類の日本語エンコードに対応していますが、現時点ではUTF-8対応の日本語ファイルのみしか作っていません。EUC対応は簡単ですので、必要でしたら当フォーラムでご連絡ください。なお携帯対応などで需要がありそうなShiftJISはエンコード設定と言語ファイルの対応だけでは文字化けが一部発生するため、別途にプラグイン処理が必要になります。
インストール後の確認正常に表示されているように見えても必要な確認。MODxは入力・出力に関してやや高度な処理を行なっているので、ちょっとしたチェックをする必要があります。たとえばサーバとの相性問題がある場合、文字化けでページの内容をまるごと失ったり、いつまで待っても検索エンジンに拾ってもらえなかったりといったことがあります。特にxreaは要確認。最低限、IEとFirefoxの両方で確認。
1.
IEでの初回アクセス時の白紙出力問題。現在、xreaでのみこの問題を確認。検索エンジンには拾われているのに妙にアクセス数が少ないな？ということになる。
2.
MODx Parse Error 関係。現在、xreaでのみこの問題を確認。正常に表示できているように見えるのに検索エンジンからは嫌われることがある。たとえば
html-lintで構文チェックした時にたまたま確認できることがあります。このエラーが確認できる場合は「訪問の記録」をオフにする必要がある。アクセス解析をしたい場合はslimstatやBBClone・Google AnalyticsなどをMODxに組み込むことができるので、それらを利用。むしろ推奨。MODx本体のアクセス解析機能はキーワードなどを拾えずいまひとつです。
3. ShiftJISの日本語ファイルを設定した場合、
文字化けがないかどうか。特にIE。ShiftJISの文字化けは文字単位のため気付きにくいので要注意。問題がある場合は「ソ」の字が確実に化けるので「パソコンソフト」と書いてみればすぐに分かります。
フレンドリーURLで運用する場合の設定フレンドリーURLを設定すると「?」「&」「=」などを含まないURLを生成するため、「1.html」「2.html」というふうに見た目に静的htmlサイトのような感じのサイトを構成できます。さらにドキュメントごとにエイリアス名を設定すれば、ページ名やディレクトリ名までコントロールできます。キャッシュ制御のため表示も軽いですし、少し見ただけではCMSで作られているとは分かりません。
検索エンジン対策に有効という説もありますが、実際のところはどうでしょう？「?」「&」「=」という文字自体を判定基準にしているわけではないだろうし。MODxの場合は、フレンドリーURLにしなくてもパラメータの渡し方が単純なため効果は変わらないと思います。見た目の分かりやすさの実現のためのフレンドリーURLをおすすめします。
1. ht.accessを.htaccessにリネーム。ルートとmanagerディレクトリにあります。
2. 管理画面にログイン。そして「管理」→「MODx設定」を開きます。
3. 2ページ目の「フレンドリーURL設定」を開き、「フレンドリーURLの使用」を「Yes」にする。
4. 「フレンドリーエイリアス」と「エイリアスパス」と「重複エイリアスを許可」を「Yes」に。設定完了。
※「重複エイリアスを許可」が「No」の場合、サイト全体を通じた一意のエイリアスをつける必要があります。たとえばディレクトリごとに「index.html」というページを作りたい時は「Yes」にする必要があります。普通はYesでいいでしょう。MODxのフレンドリーURL機能がディレクトリ表現に正式対応してなかった時代の名残なので、単純にこういうものだと理解しておく程度でいいと思います。
その他推奨設定1. 「管理」→「MODx設定」→ 「サイト設定」。必要に応じて「サイト名」「公開デフォルト」を設定。
2. 「管理」→「MODx設定」→ 「インターフェース & エディタ設定」。デフォルトでリッチテキストエディタを使うかどうかなど。
参考URLhttp://resonance.s76.xrea.com/blog/archives/2006/05/modx1.php (MODx体験記 - [RS]Resonanced Sky*: )
http://www.1km.info/modx_site/modx_install.html (MODxのインストール - 1km.info)
http://oss.moongift.jp/review/i-1601.html (MODxレビュー - MOONGIFT)
http://kohizuka.ddo.jp/blog/2006/05/02/26/ (MODxのインストール - メモ帳であり備忘録でありブログであり・・・)
http://dora-kou.cocolog-nifty.com/doralog/2006/04/modx__9112.html (MODx 導入 - 空はただ蒼く)
文字化けで困ったらhttp://modxcms.com/forums/index.php/topic,3317.0.htmlhttp://nanabit.net/install-modx-0.9.2.1.html#usingutf8デフォルトのテンプレートについてデフォルトのテンプレートをそのまま使う場合は、metaタグのcharset指定を以下のように書き換えることをおすすめします。最近のブラウザは賢いので実際の文字コードをちゃんと判別してくれることが多いですが、よけいな仕事をさせる必要もないでしょう。
<meta http-equiv="Content-Type" content="text/html; charset=[(etomite_charset)]" />
MODxプラスとりあえずインストールできた。ついでに入れといたほうがいいモノってある？特に理由もなく何かプラスアルファが欲しくなる人の気持ちも分からなくはありません。
http://modxcms.com/forums/index.php/topic,4666.0.htmlQuickEditバーの文字化け対策。これを入れておかなくてもたいていのブラウザでは問題ないみたいですが。これがないと、本当はイレギュラーです。
http://modxcms.com/forums/index.php/topic,4715.0.htmlDropMenu。MODx最新版の0.92に標準でインストールされてますが、バージョンがかなり古いです。最新版を貼り付けておきましょう。ActiveTreeOnlyなどの有用なオプションが追加されています。
http://modxcms.com/forums/index.php/topic,4221.0.htmlFCKEditor最新版。これも標準でインストールされているものは古いです。最新のFckEditorをインストールする場合は、既存のFCKEditorを削除してからインストールしてください。そうしないと、なぜか上書きではなく別途にインストールされるためFckEditorが2つある状態になり混乱します。その時に消してもいいですが。
http://modxcms.com/forums/index.php/topic,3873.0.htmlNewsListing。これも標準でインストールされているものが古いので。できればDittoのほうがおすすめですが。
http://modxcms.com/forums/index.php/topic,5671.0.htmlTinyMCE。FCKEditorの代わりに使えるエディタです。よくできてます。
http://modxcms.com/Xinha-586.htmlXinha。FCKEditorの代わりに使えるエディタです。よくできてます。TinyMCEやFCKEditorほど話題にのぼることはありませんが、これが最も多機能でしょう。ダブルクリックで画像のプロパティを開くように設定できるので、ユーザビリティもいいです。右クリックメニューも対応。ソースの美しさはTinyMCEに一歩譲るか。
http://modxcms.com/forums/index.php/topic,4823.0.htmlBottomButtonBar。
http://modxcms.com/forums/index.php/topic,4919.0.htmlAJAX Menu Index。
http://modxcms.com/forums/index.php/topic,4852.0.htmlBreadcrumbs。もしパン屑リストを使うなら。
http://modxcms.com/forums/index.php/topic,5585.0.htmlhttp://modxcms.com/forums/index.php/board,4.0.html
テンプレートデザイン。標準でインストールされるデザインでは物足りず、かといって自分でデザインするのも苦手なら。
http://modxcms.com/forums/index.php/board,114.0.htmlその他、何か興味のあるものがあれば試してみてください。
最後にフォーラムの情報を十分に活用してみてください。英語情報が大半ですが、単語レベルで分かる内容も多いです。ダメでもともとでログを検索してみて、たった数十秒で答えが見つかれば儲けモノです。フェイスマークを使うユーザも多いので、どのあたりの文章で問題が解決してるのかが雰囲気的に分かりやすい、ってこともあります。私はフェイスマークを使わない派でしたが、英語フォーラムでは意外と重宝しています。
今のところ日本語フォーラムは「過去ログを読め」という雰囲気でもないので気軽に質問していただくのもいいと思います。利用者のワクを広げること自体が大局的には日本語圏でのノウハウ充実を深めることにもつながります。MODxに興味がある人がそれぞれのレベルでコミュニティに参加することを歓迎します。
