#contents

* インストールにあたっての注意事項 [#ia061d57]

-MT4i は文字コード UTF-8(*.cgi, *.pl)及び Shift_JIS(*.tmpl)、改行コードLFで書かれています。ファイルの編集には、必ずこれらを扱えるエディタを使用し、文字コード及び改行コードを変更しないようご注意ください。
-FTPクライアントには、アップロードの際に自動で文字コード及び改行コードの変換を行うものがあります。この時、文字コード及び改行コードが変換されないよう、ご注意ください。
-[[Encode:http://search.cpan.org/~dankogai/Encode-2.40/]] と [[HTML::Template:http://search.cpan.org/~samtregar/HTML-Template-2.9/]] が必須です(リンクは現時点での最新のバージョンに貼っていますが、インストールされる時点での最新のもので問題ないかと)。
--Encode モジュールは、お使いの Perl のバージョンが 5.8 以降であれば、標準でインストールされているはずです。
--HTML::Template モジュールのインストール手順はこちら。→ [[MT4i/HTML::Template のインストール方法]]

* アップロード前の準備 [#n42d4eb5]

+ダウンロードした「mt4i31x.zip」を解凍してください。
+解凍してできるファイルは以下の通りです。
 mt4i.cgi    ----- MT4i本体。
 mt4imgr.cgi ----- MT4i Manager。MT4i設定プログラム。
 purge_old_cache.pl ----- 古いキャッシュをクリアする為のスクリプト
 lib
  mt4i
   Ad.pl     ----- バナーエクスチェンジ。
   Cache.pl  ----- キャッシュ読み書き。
   Config.pl ----- 設定ファイル読み込み。
   Log.pl    ----- ログ読み書き。
   Enc.pl    ----- 文字コード関連。
   Func.pl   ----- その他外部関数。
 plugins
  mt4i-purge-cache.pl ----- キャッシュをクリアする為のプラグイン
 tmpl
  mt4i
   blog_list.tmpl
   comment.tmpl         ----- コメント一覧テンプレート
   comment_form.tmpl    ----- コメント投稿フォーム
   error.tmpl           ----- エラーページ
   footer.tmpl          ----- フッター
   header.tmpl          ----- ヘッダー
   image.tmpl           ----- 画像表示ページ
   index.tmpl           ----- インデックステンプレート
   individual.tmpl      ----- 個別記事ページテンプレート
   post_comment.tmpl    ----- コメント投稿フォームテンプレート
   recent_comments.tmpl ----- 最近のコメントページ
   redirector.tmpl      ----- リダイレクトページ
    search_results.tmpl  ----- 検索結果画面テンプレート
   trackback.tmpl       ----- トラックバック一覧テンプレート
+「mt4i.cgi」及び「mt4imgr.cgi」をエディタで開き、一行目のPerlパスをインストールする環境に合わせて編集、保存して下さい。配布時は以下のようになっています。
 #!/usr/bin/perl
さくらインターネット及びロリポップでは、このままで変更の必要はありません。環境によっては以下の場合もあります。
 #!/usr/local/bin/perl
良く分からない場合は、サーバの管理者に問合せてください。~
~
* インストール手順 [#f5a45fb1]

** 新規インストール [#d2c90b5f]

+ テンプレートのキャッシュを溜め込む為のディレクトリが必要です。MT ホームディレクトリの直下に、以下の構成でディレクトリを作成して下さい。パーミッションは、適宜 cgi の実行ユーザーが書き込めるよう変更してください。
 MT ホームディレクトリ
  mt4i
      cache
          tmpl
+ ファイル「mt4i.cgi」「mt4imgr.cgi」、ディレクトリ(フォルダ)「lib」、「tmpl」をサーバーの任意の場所にアップロード(すべて同階層に置くこと)。アップロード場所は、上記で作成した MT ホームディレクトリ直下の mt4i ディレクトリ内でなくてかまいません。
+ 「mt4i.cgi」と「mt4imgr.cgi」のパーミッションを「705」あるいはプロバイダ等で指定されているCGIプログラムを動かす際のパーミッション値に変更。
+Webブラウザより「mt4imgr.cgi」にアクセス。
+ 「まず最初に、MT4i Manager にログインする為のパスワードを設定してください。」と表示されるので、希望のパスワードを入力して「保存」ボタンを押下。
+ 「MT4i Manager のパスワードを設定しました。」と表示されるので、「戻る」ボタンを押下。
+ パスワードを入力してログイン。
+ 「メニュー」の「設定を編集する。」にチェックをして、「ENTER」ボタンを押下。
+ 設定を編集して保存。設定値にはすべてデフォルト値が用意されているので、MovableTypeと同階層(mt.cgiのある場所)にインストールする場合は、何もしないで保存してもOK。ただし管理者モードを使用する場合は、「AdminPassword - 「管理者向けURL取得」の為のパスワード」の変更が必須となるので注意。
+ Webブラウザより「mt4i.cgi」にアクセスして動作確認。

** 3.0 以上からのアップグレード [#l8716919]

- ダウンロードして解凍したファイルを、既存のファイルにすべて上書きしてください。
-- ただしテンプレートのカスタマイズをしている場合は、テンプレートは上書きせずに適宜変更するなどしてください。
- 必ず一度はブラウザより MT4i Manager を開き、設定の保存ボタンを押してください。新しい設定項目にデフォルト値を、持たせる為に必要です。
-- テンプレートに手を加えており、CHTML にて使い続けたい場合には、Content-Type の設定がデフォルト XHTML となっている為、HTML への変更が必要です。MT4i Manager にて設定してください。
-- スクリプトの文字コードを EUC-JP から UTF-8 に変更した為、設定項目のいくつかが文字化けする可能性があります。申し訳ございませんが、下記項目を見直して再入力し直すなどしてください。その他、文字化けしていないか一通り確認して頂くようお願いします。すいません。
+++ モバイル変換ゲートウェイ周りの設定
+++ 管理者名

** 2.0β6 以上、3.0 未満からのアップグレード [#bb4c4144]

- 「[[MT4i/3.0/インストール]]」を参照してください。

** 2.0β1〜5、2.0未満(Tonkey版、ヴァリウム男爵版含む)からのアップグレード [#b9395eef]

- 「[[MT4i/2.0/インストール]]」を参照してください。

* 各機能を使うには [#gdc71030]

** デザイン(テンプレート)を編集するには [#i708e048]
- 「tmpl」ディレクトリ以下の「*.tmpl」ファイルを編集してください。
- 「[[MT4i/テンプレートタグ]]」(整備中)を参考にしてください。
- テンプレートファイルは文字コード Shift_JIS で書かれています。文字コードを誤って変更しないようお気をつけ下さい。

** 管理者モードを使用するには [#t0e55d67]
+ MT4i Manager にて『AdminPassword - 「管理者向けURL取得」の為のパスワード』をデフォルトより変更して保存。
+ 「メニューに戻る」ボタンを押下し、メニューに戻る。
+ 「管理者用のURLを取得する。」というメニューが現れるので選択し、「ENTER」ボタンを押下する。
+ 「管理者用URL取得パスワード」の入力欄が現れるので、先ほど設定したパスワードを入力し、「ENTER」ボタンを押下する。
+ 表示される「管理者用URLはこちらです。」の「こちら」が、管理者モードへのリンクとなっている。

** ページのテキストキャッシュ機能を使用するには [#y28d4abd]
+ ページのテキストキャッシュ機能では、Storable モジュールの機能を使用しています。ご使用のサーバーにインストールされているかご確認ください。インストールされていなければ、インストールしてください。
+ ページのテキストキャッシュを溜め込む為のディレクトリが必要です。MT ホームディレクトリの直下に、以下の構成でディレクトリを作成して下さい。パーミッションは、適宜 cgi の実行ユーザーが書き込めるよう変更してください。
 MT ホームディレクトリ
  mt4i
      cache
          page
+ plugins/mt4i-purge-cache.pl を、MT ホームディレクトリの plugins フォルダにアップロードしてください。
 MT ホームディレクトリ
  plugins
      mt4i-purge-cache.pl
+ MT4i Manager にて、「CacheTime - キャッシュの保持期間」に 1 以上の数字を設定してください。この設定を保存した時点から、キャッシュ機能が ON になります。
+ キャッシュはプラグインなどにより、エントリーやコメントの投稿などによってクリアされます。しかし、中身を消すだけでファイル自体は消えません。この為、ほとんどアクセスされないようなページのキャッシュも、永遠に残ってしまいます。これをクリアするには purge_old_cache.pl を使用してください。mt4i.cgi と同じ場所にアップロードし、MT4i Manager にて「PurgeCacheScript - purge_old_cache.pl スクリプトに関する設定」を設定してください。あとは purge_old_cache.pl を cron に登録すれば、古いキャッシュファイルを定期的に削除します。

*** purge_old_cache.pl について [#u28cafae]
cron を使用するなど、多少テクニカルです。
- purge_old_cache.pl は Perl のプログラムです。mt4i.cgi と同階層に設置して使用します。CGI としては動作しませんので、通常、ブラウザから叩いても動作しません。cron に登録するなどしてください。例えば、crontab に以下のように登録して使用します。
 30 4 * * * perl /home/user-name/www/blog/mt4i/purge_old_cache.pl
上記例ですと、毎日 4:30 に「perl 〜」のコマンドを実行します。cron については各自調べて勉強してください。

** モバイル向け Adsense の設置方法 [#k7b48ea6]
- モバイル向け Adsense のコードを取得。
-- 文字エンコードには「日本語(Shift_JIS)」、サーバー サイドのスクリプト言語には「CGI/Perl」を選択すること。
--マークアップも本当なら「chtml」なのだけれど、配色なんかとの兼ね合いがあるので各自調整要。
- 取得したコードを、ディレクトリ「lib/mt4i」以下に「Adsense.pl」というファイル名で保存。コードの変更は一切しないこと。
 lib
  mt4i
    Adsense.pl
- テンプレートの任意の場所に、下記のタグを挿入。
 <TMPL_VAR NAME="ADSENSE">

** MT4i/Google Analytics の設置方法 [#ie98e378]

- [[MT4i/Google Analytics の設置方法]]を参照してください。

** 検索機能について [#ff7af68c]

- 検索機能を使用して、得た結果のリンクをクリックした際、PCではなく MT4i へ遷移させる為には、あいのり機能(Mobile Link Discovery)を正しく設定する必要があります。あいのり機能の設定方法につきましては、以下を参照してください。
-- [[MT4i/機能解説:http://www.hazama.nu/pukiwiki/index.php?cmd=read&page=MT4i%2F%B5%A1%C7%BD%B2%F2%C0%E2&word=%A4%A2%A4%A4%A4%CE%A4%EA#bce075db]]

** 絵文字機能を使用するには [#d34cf499]
PC 等で絵文字を表示する為の画像と、Encode::JP::Emoji モジュールが必要です。
+ MT4i の絵文字対応は、[[Yoshimatsu:http://www.luckypines.com/mt/]] 氏の作成・配布されている MT で絵文字を使用するプラグインが前提です。下記リンク先より導入してください。
--[[MTでも絵文字使おうぜプラグイン、アリマス - Kickstart my heart:http://www.luckypines.com/mt/2008/05/mt.html]]
--ただしこのプラグイン、MT5 では動作しないようです。MT 側での絵文字入力はできませんが、MT4i 側で入力された絵文字を PC その他で表示する為にその画像を使用しているので、最低でも画像の設置だけはしてください。
+MT4i の絵文字対応には Encode::JP::Emoji が必須です。絵文字の変換は基本的に Encode::JP::Emoji 任せです。なのでインストールしてください。Encode::JP::Emoji は導入が容易で、ダウンロードして解凍してコピーするだけで済みます。
++[[ここ:http://mtl.recruit.co.jp/blog/2009/07/encodejpemoji_emoji4unicode_pe.html]]から辿って最新バージョンをダウンロードしてください。
++解凍してできた lib ディレクトリ以下を、MT4i の lib ディレクトリ配下にコピーしてください。
++以下のような階層になります。
 lib
  mt4i
  Encode
    JP
      Emoji.pm
      Emoji
+MT のコメント設定、コメントポリシーにて HTML を許可していないと、コメント欄に入力された絵文字が表示されませんので、設定してあげる必要があります。
++「設定」-「コメント」を開き、「コメントポリシー」の「HTMLを許可」にチェックを入れます。
++出現した選択肢の「カスタム設定」を選択し、以下の内容をそのテキストボックスに入力、変更を保存してください。
 a href,b,i,br/,p,strong,em,ul,ol,li,blockquote,pre,img class src alt style
既にこちらの値を変更されている場合には、太字の部分、「img class src alt style」を追加してください。

* FAQ [#ta5dbb45]

-''「500 Internal Server Error」というエラーが表示される''
--MT本体でBerkeleyDBまたはSQL Lightを使用しており、MTホームディレクトリ(mt.cgiが有るディレクトリ)と別の場所にインストールした場合に発生するエラーです。MTホームディレクトリにあるmt.cfgを開き、DataSourceの指定を相対パス(./db)から絶対パスに変更して下さい。
--その他考えられる原因としては、パーミッションが適切に設定されていない、MTホームディレクトリの最後が"/"で終わっていない、文字コードが EUC-JP以外でアップロードされている、改行コードがLF以外でアップロードされている、blog IDが全角文字で指定されている、など。
--MT4i Managerが自動生成するはずの「mt4icfg.cgi」というファイルが生成されていない場合があります。mt4imgr.cgiと同階層に同ファイルが見当たらない場合、「mt4icfg.cgi」という空のファイルを作成した後、再度MT4i Managerにて設定を保存して試してみてください。
-''画像が表示されない''
--画像の自動縮小表示機能を使用する場合、Entry内のimgタグで指定するURLに、転送アドレスは使用しないで下さい。必ず転送先の、実体があるURLを指定して下さい。転送アドレスを指定してしまうと、画像を取得できず、表示することができません。
--自宅サーバーなどで運用されている場合、画像の自動縮小表示機能が正常に動作しない(画像が表示されない)場合があります。自サイト内の画像を取得する際、ドメインの名前解決にグローバルIPを取得してしまい、取得に失敗する為と考えられます。自宅サーバーなどで運用され、画像が表示されない場合は、hostsファイルの「127.0.0.1 localhost」となっている行を、「127.0.0.1 localhost 貴サイトのドメイン名」と書き換えてみてください(参考:[[KIKI ::GOLFとゴルフを楽しむページ:MT4Iで画像が表示されなかったら:http://kiki.minidns.net/archives/000025.html#more]])。あるいは、MT4i Managerにて「Photo_Host_Original/Replace」の値を設定してみてください。
--Entry内のimgタグで指定するURLパスに、半角スペースが使用されている場合、画像の自動縮小表示機能が正常に動作しません(画像が表示されない)。
--[[XREA:http://www.xrea.com/]]では画像の自動縮小表示機能が動作せず、画像が表示されないようです。ただし広告が免除される有料の[[XREA+:http://www.xrea.com/?action=adfree]]では、正常に画像が表示されるとの報告を受けています。
-''"〜"、"−" 等が文字化けする''
-- 3.0 にて解消されたはず。現象が発生した場合は、発生時のできる限り詳細な情報(投稿は PC からか携帯からか、PC からなら OS は何か、ブラウザは何か、携帯からならキャリアはどこか、機種は何か、等)を添えてご報告頂けると非常に助かります。
- ''Loading template '/hoge/tmpl/mt4i/index.tmpl' failed: HTML::Template->new() : can't mkdir /hoge/mt4i/cache/tmpl (file_cache => 1): No such file or directory at index.cgi line xxx''
-- 上記インストール手順最初の、「テンプレートのキャッシュを溜め込む為のディレクトリの作成」を行いましたか?
- ''"Can't locate HTML/Template.pm in @INC (@INC contains: 〜" というエラーが発生する''
-- HTML::Template.pm モジュールがサーバーにインストールされていないようです。以下のいずれかの選択肢でインストールしてください。
++ 自分でインストールする。
++ サーバー管理者にお願いしてインストールしてもらう。
++ MT4i インストールディレクトリ配下にコピーして対応する。
+++ [[こちら:http://search.cpan.org/~samtregar/HTML-Template-2.9/]]にて「Download」リンクをクリックし、アーカイブをダウンロードする。
+++ 解凍して、できたディレクトリ配下の Template.pm を、MT4i の lib ディレクトリ配下に「HTML」というディレクトリを作成し、その中にコピーしてください。
+++ 以下のような階層になります。
 lib
  mt4i
  HTML
    Template.pm

トップ   編集 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS