Lightweight Google Maps 説明書

プラグイン配布ページ
  http://wppluginsj.sourceforge.jp/lightweight-google-maps/

●●概要●●

  Google マップを、各記事または独立の固定ページに表示します。記事に "Lat_Long" 
という名前のカスタムフィールドがあれば、緯度・経度として扱って、以下の要領でマー
カー付きの地図を表示します。

(記事ページ)
・指定された緯度・経度を中心とするミニサイズ (既定値は 300x150 ピクセル) の地図。
・または、指定された緯度・経度を中心とする固定の地図ページへのテキストリンク。

(固定の地図ページ)
・既定値では最新の100箇所にマーカーを打った地図。
・または、指定したカテゴリーすべての地点にマーカーを打った地図。
・または、特定の緯度経度を中心とした地図。

  本プラグインは Plug 'n' Play Google Map プラグイン(*1) を参考に制作しています
が、このプラグインでは必須だった Geo プラグイン(*2)は不要となっています。また、
サムネール表示機能を削除したかわりに、記事の概要を表示させるようにしています。
(*1) http://www.yongfook.com/2006/05/28/plug-n-play-google-map/
(*2) http://dev.wp-plugins.org/wiki/GeoPlugin

  "Lat_Long" カスタムフィールドに位置情報を格納するには、投稿画面で手入力する他、
拙作の Ktai Location プラグイン(*3)も利用できます。

(*3)   http://wppluginsj.sourceforge.jp/ktai_location/

●●対応環境●●

・WordPress 2.0 以降。WordPress ME 2.0.7 で動作確認していますが、おそらく本家版
  2.0 以降なら動くでしょう。
・PHP 4 以降。ただし、動作確認は PHP5.2.0 で行なっていますので、PHP 4 ではバージ
  ョンによって動かないかもしれません。PHP 4.x をご利用の場合は、自己責任にてご利
  用をお願いします。
・管理画面のローカライズは UTF-8, EUC-JP 動作のウェブログに対応 (Shift_JIS は対
  応予定なし)。

●●設置方法●●

 1. 現在、Geo プラグイン、wp-eznavi プラグイン、Plug 'n' Play Google Map プラグ
    イン等を利用している場合は、無効にしておきます。
 2. プラグインをダウンロードして展開し、FTP ソフト等で lightweight-google-maps 
    フォルダごとプラグインディレクトリーに転送します。なお、README-ja_utf8.txt
    および lw_googlemaps-ja_???.po は動作には不要なので削除してかまいません。
    本家版 WordPress を利用していて、日本語リソース(*4)を使っている場合は、
    lw_googlemaps-ja_UTF.mo を lw_googlemaps-ja.mo とリネームしてください。
    (*4) http://svn.automattic.com/wordpress-i18n/ja_JP/tags/

※※プラグインはまだ有効にしないでください。※※

 3. 次は、地図表示の固定ページを作ります。管理画面の投稿→ページ作成で、新規に固
    定ページを作ります。そして、地図を表示させたい部分に
      <div id="google_maps"></div>
    という空の div 要素を置きます。Plug 'n' Play Google Map を利用していた場合、
    "yf_map" という div 要素を修正すれば OK です。
 4. テンプレートを修正します。ページとメインインデックスの両方、またはフッターの
    テンプレートに、
      <?php wp_footer(); ?>
    の記述がなければ追加しておきます。
 5. 各記事へのミニサイズの地図、または固定ページへのリンクは自動的に挿入されます。
    ※ ver 0.8.0 まで lwgm_button() または lwgm_each_map() 関数をテンプレートに
       記入する必要がありましたが、ver 0.9.0 では不要としました。
 6. 地図ページにカテゴリーでの絞り込みメニューと住所・ランドマーク移動フィールド
    をつけるには、ページテンプレートで the_content() の直前に以下のコードを書き
    ます。
      <?php if (function_exists('lwgm_dropdown_cats')) {
        lwgm_dropdown_cats();
        lwgm_geocoding();
      } ?>
    ※ ver 0.9.9 で Geocoding 用関数を追加しました。
 7. いよいよ Lightweight Google Maps プラグインを有効にします。
 8. 管理画面のオプション→Google Maps で設定項目を入力します。API キー、ページス
    ラッグは必須ですが、それ以外の項目は入力しなくても構いません (デフォルト値が
    適用されます)。Google マップの API キーを持っていなければ、Google から取得し
    てください。
      http://www.google.com/apis/maps/signup.html
 9. Plug 'n' Play Google Map プラグインを利用していた場合、設定値が引き継がれて
    います。そのまま「設定を更新する」ボタンを押せば、本プラグインの設定値として
    使われます (更新ボタンを押すまでは無効です)。このとき、Plug 'n' Play Google 
    Map プラグインのオプション値は削除されます。
    ※ver 0.9.8.1 以前を使っていた人も、必ず一度管理画面に入って「設定を更新」を
    実行してください。
10. Geo プラグイン等を使っていた場合は、管理画面の一番下にあるチェックボックスを 
    オンにしておいて、設定を更新します。こうすると、Geo プラグイン用の位置情報 
    (_geo_location カスタムフィールド) が Lat_Long カスタムフィールドに変換され
    ます。
11. これで地図が表示されるはずです。お楽しみください。

●●0.9.8.1 以前からのアップグレード●●

  以前のバージョンからのアップグレードは、以下の手順で行なってください。
1. 念のため、本プラグインを無効にします。
2. すべての php ファイル, mo ファイルを lightweight-google-maps ディレクトリーに
   転送してファイルを上書きします。
3. プラグインを有効にします。
4. 古い設定値が引き継ぐため、管理画面で、オプション→ Google Maps のタブを選択し、
   「設定を更新する」を実行します。これを実行しないと、Google Maps API キーが無
   効という警告が出ます。

●●使用方法●●

・位置情報を登録するには、投稿画面でカスタムフィールドの追加を行います。キー名は
  "Lat_Long" で、値は緯度・経度をコンマ区切りで繋げたものにします。
  (例: 35.608797685462,139.56014977271)
・また、拙作の Ktai Location プラグインを使えば、ケータイからの投稿時に位置情報
  を Lat_Long カスタムフィールドに格納することが可能です。
・位置情報が付与されている記事 (Lat_Long カスタムフィールドを持つ記事) の下に、
  ミニサイズの地図が表示されます。設定によっては、テキストでのリンクが表示されま
  す。地図のマーカーまたはリンクをクリックすると、固定ページの地図にて、その地点
  を中心とした狭い範囲を表示します。
・記事に複数の位置情報があるときは、位置情報の件数だけ地図が複数表示されます。
・いきなり固定の地図ページを表示させた場合、最近の位置情報を100件読み込んでマー
  カーを打ちます。
・地図ページで、カテゴリーをプルダウンメニューから選んで「表示」ボタンを押すと、
  そのカテゴリーで投稿された記事の位置情報をすべて表示します。

●●注意事項●●

・プラグインをインストールするだけでは動作しません。テンプレートの修正および、固
  定ページの作成が必要です。前述の設置方法を良く読んで作業してください。作業方法
  自体は、Plug 'n' Play Google Map プラグインとほぼ同様ですので、そちらの設置方
  法を参考にしてかまいません。
・Ver.0.9.9 以降、プラグインの設定値を Plug 'n' Play Google Map プラグインと共通
  にするのはやめました。ただし、管理画面では、Plug 'n' Play Google Map プラグイ
  ンの設定値を読み込みます。「設定を更新する」ボタンを押すと、本プラグインの設定
  値として設定し、 Plug 'n' Play Google Map プラグインのオプションはすべて削除し
  ます (Use thumbnail など、当プラグインで使ってない機能のオプションも削除)。
・管理画面は po/mo ファイルを利用するローカライズを行なっています。現時点では 
  UTF-8 動作のウェブログのみ対応ですので、EUC-JP, Shift_JIS で動作させている場合
  は英語の管理画面となります。
・K2 テーマ(*5)を利用している場合、本プラグインはうまく動作しません。K2 に搭載さ
  れている JavaScript が Google Maps API に悪影響があるためなので、K2 が修正され
  るまでは他のテーマに乗り換えてください;-)
  (*5) http://getk2.com/

●●ファイル説明●●

googlemaps.php
  プラグイン本体
Lat_Long.php
  位置情報読み取り用クラス  
locations.php
  AJAX による位置情報送出用スクリプト。googlemaps.php からアクセスされる。
lw_googlemaps-ja_UTF.mo
lw_googlemaps-ja_EUC.mo
  日本語リソース。WordPress が自動的に適切なリソースを選択するので、両方ともサー
  バーに転送しても問題ありません。

(以下はサーバーへの転送が不要なファイル)
lw_googlemaps-ja_UTF.po
lw_googlemaps-ja_EUC.po
  日本語リソースのコンパイル前データー
LICENSE.txt
  GPL2 ライセンス
README-ja_utf8.txt
  説明書 (本ファイル)

●●Plug 'n' Play Google Map との相違点●●

・読み取る位置情報は Geo プラグインと非互換になりました (フォーマットはほぼ同一
  ですが;-)。そのかわり、Geo プラグインなしで動作するようになりました。
・すべての地点をマークせず、表示対象の位置情報を限定するようにしました。
・利用するメモリーが少なくなるよう工夫しています。すべての地点を表示しないため、
  1000箇所以上の位置情報を持っていても、メモリー不足になることはありません。

●●改版履歴●●

ver 0.9.9 (2007-02-17)
  EUC-JP 動作のウェブログでのローカライズに対応しました。
  住所やランドマークを指定して、その位置に移動する機能を追加しました。
  カテゴリーでの絞り込みは、ページの再読み込みをせず Ajax 的な非同期な動作に変更
  しました。
  オプション値を Plug 'n' Play Google Map と共通にするのをやめて、本プラグイン独
  自の設定値としました。管理画面で Plug 'n' Play Google Map の設定値を読み込んで
  本プラグインの値として設定できます。詳細は設置方法／アップグレード方法を参照く
  ださい。
  作者 URI を変更しました。
ver 0.9.8.1 (2007-02-13)
  固定の地図ページでは、位置情報マーカーの取り込みを Ajax 的な非同期な動作に変更
  しました。
  各記事のミニサイズ地図、およびミニサイズ地図からマーカーをクリックして表示され
  る場所指定地図の拡大率を管理画面で指定できるようにしました。
  場所指定地図でにおける位置情報マーカーは、地図が見えている範囲ぎりぎりだけを抽
  出するようにしました (以前のバージョンでは、抽出する範囲の決定がアドホックな不
  正確な方法でした)。
  固定の地図ページでカテゴリー指定したときの拡大率は、すべての位置情報マーカーが
  入るような値を自動調整するようにしました。
ver 0.9.0 (2007-01-31)
  複数の位置情報に対応しました。各記事では、位置情報の数だけ地図を表示します。
  各記事へのミニサイズの地図は、テンプレートの修正なしに表示されるようにしました。
  緯度・経度を指定して固定ページの地図を表示させたとき (各記事のミニサイズの地図
  のマーカーをクリックしたときなど) の表示速度を改善しました。
ver 0.8.0 (2007-01-24)
  PHP 5 専用予約語を削除して PHP 4.x 環境に配慮しました。
  Map View ボタンではなくミニサイズの地図を表示する機能を追加しました。
  Map View ボタンの同梱をやめました。
  配布サイトを WordPress Plugins/JSeries に変更しました。
ver 0.7.0 (2007-01-18)
  新規リリース。

以上