plugins:mygooglemaps

差分

この文書の現在のバージョンと選択したバージョンの差分を表示します。

この比較画面にリンクする

plugins:mygooglemaps [2011/03/23 21:28]
plugins:mygooglemaps [2011/03/23 21:28] (現在)
ライン 1: ライン 1:
 +====== NP_MyGoogleMaps ======
 +
 +NP_GoogleMapsは、Google Maps上の位置情報とブログの記事とをリンクさせ、Google Mapsからブログ記事を表示するという機能を提供する、Nucleusのプラグインです。
 +
 +単一の地図上に複数の位置情報を表示させることができますので、ある記事が参照している位置情報のみならず、それに近い別の位置情報に関連する記事を、地図から参照することができるようになります。
 +
 +^General Plugin info ^^
 +^作者: | [[plugins:​authors:​emerald|emerald]] |
 +^最新のバージョン:​ | 0.82 |
 +^Nucleus対応バージョン:​ | 3.20 or later |
 +^入手場所:​ | [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1482|フォーラム内の公式アナウンスよりダウンロード]] |  ​
 +^ソース: |  |
 +^動作サンプル:​ | 記事内リンク:​ [[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​118|作者のblog記事]] / マーカー最新一覧:​ [[http://​blog.yoshidakamagasako.com/​kamagasako/​|作者blogページのサイドバー]](日本語) ​ |
 +^フォーラム参照先:​ |[[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1482|Read here]] ​ |
 +
 +
 +===== このプラグインの特徴 =====
 +  * 位置情報はDBに格納しますので、複数の記事から参照できます。 ​
 +  * 登録された位置情報は、ポインタとして地図上に表示されます。 ​
 +  * ポインタをクリックすると、その位置情報の詳細が表示されます (非同期処理)。 ​
 +  * 位置情報を参照するブログ記事がある場合、その記事へのリンクも表示されます。 ​
 +→ これにより、記事とブログの双方向のリンクが生成されます。 ​
 +  * 単一の地図上に、表示できる範囲内のすべての位置情報が表示されます (非同期処理)。 ​
 +→ これにより、位置情報間に緩い関連が生成されます。 ​
 +  * また、位置情報に対して他ブログからトラックバックPingを打てます。 ​
 +→ これにより、他ブログとの情報が連携します。 ​
 +  * 結果、記事と位置、位置と位置、記事と記事、ブログとブログが有機的にリンクされます。 ​
 +  * 地図はポップアップウィンドウで表示されます。 ​
 +  * 地図ウィンドウを一つ開くと、以降は同じウィンドウを使い回します。 ​
 +  * 別の位置情報を開く場合でも、ウィンドウをリロードしません。 ​
 +  * ポップアップウィンドウのサイズを編集画面で設定できます。 ​
 +  * 位置情報の編集画面もポップアップで表示されます。 ​
 +  * プラグインの管理画面からも位置情報を編集できます。 ​
 +  * シンプルな入力値チェックを実装しています。 ​
 +
 +
 +
 +=====インストール方法=====
 +
 +[配布ファイル内 ///​mygooglemaps/​help.html//​ より]
 +
 +  - zipを展開します。 ​
 +  - NP_MyGoogleMaps.phpを、Nucleusのnucleus/​pluginsディレクトリにコピーします。 ​
 +  - 同様に、mygooglemapsディレクトリを中のファイルごと、nucleus/​pluginsディレクトリにコピーします。 ​
 +  - Google Maps API Keyを取得します。 ​
 +  - Nucleusのプラグイン管理画面から、MyGoogleMapsプラグインをインストールします。 ​
 +  - MyGoogleMapsの編集画面から、API Keyを登録します。 ​
 +  - 各スキンのタイプの<​head>​ ~ </​head>​内(skinで読み込むhead.inc等に含まれている場合もあります)に、<​code><​%MyGoogleMaps(script,,​)%></​code>​と挿入して下さい。
 +
 +
 +=====このプラグインの使い方=====
 +
 +
 +==== 位置情報の登録 ====
 +
 +位置情報は、Nucleusのプラグイン管理画面から登録できます。
 +
 +入力支援のリンクから地図を別ウィンドウで開けます。この地図上の中心の座標が、メインウィンドウのフォームに自動的に反映されます。名称や簡単な説明などの項目を入力し、登録して下さい。
 +
 +登録済みのポインタを選択後、フォームの値を変更することで更新できます。
 +
 +画像を登録する場合、画像のサイズも登録できます。フォームから画像のサイズを入力せずに登録した場合は、自動的に画像のサイズを取得します。
 +
 +
 +
 +==== 記事からのリンク作成 ====
 +
 +ブログの記事本文中に <​code><​%MyGoogleMaps(位置ID,​リンク文字列,​ズームレベル)%></​code>​と入力することで、地図へのリンクを作成します。
 +
 +  * 位置IDには、DBに登録済みの位置のIDを指定します。
 +  * 存在しない位置IDを指定した場合の挙動は不定です(現時点での実装では日本全体が表示されます)。
 +  * ズームレベルには 0 (最大ズームイン)から 17 (最大ズームアウト)の数字を指定します。指定しない場合は、デフォルトとしてズームレベル 5 を利用します。
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +=====スキンへの記述=====
 +
 +<​code>​
 +<​%MyGoogleMaps(タイプ,​リンク文字列,​位置ID)%>​
 +</​code>​
 +
 +
 +
 +==== パラメータ(引数)の説明 ====
 +^タイプ ​ |  **edit**(編集) ​ |  **view**(閲覧) ​ |  **script**(スクリプト) ​ |  **list**(マーカ一覧) ​ |
 +^リンク文字列 ​ |  表示するリンクテキスト ​ ||  -  |**new**:​マーカ最新順\\ **old**:​マーカ古い順\\ **link**:​リンク記事の最新順 ​  |
 +^位置ID ​ |  DBに登録済みの位置のID ​ ||  -  |  リンク表示件数(0で全件表示) ​ |
 +
 +
 +
 +==== タイプ別動作の詳細 ====
 +
 +  * edit (編集)
 +位置情報を編集できます。現状、UIがイケていません。将来的にはこのモードを削除し、管理画面のみに移行する可能性があります。ログインユーザのみ、編集モードを利用できます。
 +
 +  * view (閲覧)
 +地図が別ウィンドウで表示されます。地図上のマーカをクリックして表示される情報ウィンドウのリンクをクリックすると、メインウィンドウがそのURLに遷移します。
 +
 +  * script (スクリプト)
 +メインウィンドウ(ブログを表示するウィンドウ)用のスクリプトを出力します。インストール手順にある通り、skinファイルのhead.incに挿入するなどして下さい。
 +
 +  * list (一覧)
 +ページ上にマーカーへのリンク一覧を表示します。
 +
 +
 +=====cssへの記述=====
 +
 +生成されるリンク(a要素)には、class属性として "​mygooglemaps"​ が指定されています。必要に応じて、以下のようにCSSファイルを編集して下さい。
 +  * <code css>
 +.contentbody a.mygooglemaps:​link,​ .contentbody a.mygooglemaps:​visited {
 + background-color:​ #bbffcc;
 +}
 +</​code>​
 +
 +
 +===== バージョンアップ方法 =====
 +[配布ファイル内 ///​mygooglemaps/​help.html//​ より]
 +
 +  * MyGoogleMapsプラグインの編集画面で、プラグインの削除時にテーブルを削除しないよう設定します。 ​
 +  * 同画面からGoogle Maps API Keyをコピーして、別のファイル等にバックアップします。 ​
 +  * プラグイン管理画面から、MyGoogleMapsプラグインを削除します。 ​
 +  * 展開したzipにあるNP_MyGoogleMaps.phpとmygooglemapsディレクトリ、およびその中にあるファイルで既存のファイルを上書きします。 ​
 +  * プラグイン管理画面から、MyGoogleMapsプラグインをインストールします。 ​
 +  * MyGoogleMapsプラグインの編集画面で、バックアップしておいたGoogle Maps API Keyを登録して下さい。 ​
 +  * 必要に応じて、MyGoogleMapsプラグインの管理画面からALTER TABLEを実行して下さい。リンクをクリックするだけでALTER TABLEが実行されます。ただし、Nucleusが利用するMySQLユーザにALTER権限がない場合、これらのALTER TABLE文は実行されません。リンクの文字列をコピペして、ALTER権限のあるMySQLユーザでコマンドライン等から実行して下さい。
 +
 +
 +
 +===== アンインストール方法 =====
 +
 +[配布ファイル内 ///​mygooglemaps/​help.html//​ より]
 +
 +  * head.incやsidebar.incなどでの、MyGoogleMapsスキン変数の呼び出しを削除して下さい。 ​
 +  * ブログ記事の本文から、MyGoogleMapsタグを削除して下さい。 ​
 +  * MyGoogleMapsプラグインの編集画面で、テーブルを削除するかどうか設定して下さい。 ​
 +  * 同画面から、必要に応じてGoogle Maps API Keyをバックアップして下さい。 ​
 +  * プラグインの管理画面から、MyGoogleMapsプラグインを削除して下さい。 ​
 +  * nucleus/​pluginsディレクトリから、NP_MyGoogleMaps.phpとmygooglemapsディレクトリ、およびmygooglemapsディレクトリ内のファイルをすべて削除して下さい。
 +
 +以上で完了です。__テーブルを削除すると位置情報はすべて失われます__。ご注意下さい。
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +=====開発履歴=====
 +  * **version 0.82** [2005-12-09][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​179|Read here]]
 +    * マーカの一覧表示機能を追加。
 +    * ズームレベル指定機能を追加(0.8→0.81)。
 +    * バグフィックス(0.81→0.82)。
 +  * **version 0.7** [2005-10-26][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​138|Read here]]
 +    * 位置情報にトラックバックPing送信機能追加。地図内にTB元へのリンクを表示。
 +  * **version 0.62** [2005-10-17][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​125|Read here]]
 +    * 画像の表示サイズの指定機能追加。
 +    * JavaScriptグローバル変数にプレフィックス mygmap_ を追加。
 +    * 画像サイズを指定しない場合に登録/​更新がされないバグ修正(0.6→0.61)。
 +    * $PREFIX_gmap_loc_itemテーブルのCREATE文を修正(0.61→0.62)。
 +  * **version 0.5** [2005-10-12][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​120|Read here]]
 +    * MySQL 4.0.xに対応。 ​
 +  * **version 0.41** [2005-10-06][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​113|Read here]]
 +    * 位置情報の登録・更新時に、入力値のチェックを行うように。
 +    * 位置情報の新規登録/​更新の確認ダイアログを表示するように。
 +  * **version 0.32** [2005-10-05][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​110|Read here]]
 +    * マイナーバージョンアップ。機能追加なし。
 +  * **version 0.31** [2005-10-04][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​108|Read here]]
 +    * 削除フラグの挙動を実装。
 +    * 地図ウィンドウの使い回し。
 +    *  IEで利用できないDOMのプロパティの見直し。
 +  * **version 0.2** [2005-10-03][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​106|Read here]]
 +    * 文字コードをeuc-jpに変更し、DBに登録されるテキストもeuc-jpになるように。
 +  * **version 0.1** [2005-10-03][[http://​blog.yoshidakamagasako.com/​kamagasako/​item/​104|Read here]]
 +    * 初回リリース。
 +
 +===== 同類のプラグイン =====
 +  * [[plugins:​GoogleMaps|NP_GoogleMaps.php]]
 +  * [[plugins:​GPSMap|NP_GPSMap]]
 +  * [[plugins:​MapBlog|NP_MapBlog]]
 +
 +
  
 
plugins/mygooglemaps.txt · 最終更新: 2011/03/23 21:28 (外部編集)