【 gabs.log｜おしゃべり好きなWEB制作者のたわごと 】

いつも通りすっかりご無沙汰なBUNですが、Movable Type Advent Calendar 2013 の15日目の記事を書きます。

それにしても、約1年ぶりって。。。
雪も降りしきる訳・・・ですね(｡-_-｡) www

さて、先日 Google Maps JavaScript API v2 の廃止に伴い、過去に制作したサイトで「管理画面に地図は互換表示されてるものの、ジオコーディングが利用できない」ことがありました。
導入していたプラグインに含まれる JavaScript の記述を書き換えることで解消できたのですが、プラグイン自体が既にアップデートされていない・・・という、ままある？状況。

そこで、MT 標準のカスタムフィールドと MTAppjQuery プラグインで地図座標の管理をする方法について共有してみます。

やりたいこと

今回は、（ブログ）記事へカスタムフィールドを追加しつつ、別途用意した JavaScript を読み込ませる形で編集画面に地図を表示させます。あわせて、地図の中心座標やズームレベルの変更にあわせて各フィールドの入力値を変更したり、ジオコーディングで大まかな位置を表示できるようにします。

完成図は、下記のようなイメージです。

なお、 MTAppjQuery プラグインはあらかじめインストールしてある前提で、解説していきます。

カスタムフィールドの追加

はじめに、カスタムフィールドを3つ追加します。
システムオブジェクトは「記事」、種類は「テキスト」とします。

名前：緯度
ベースネーム、および、テンプレートタグ：lat

名前：経度
ベースネーム、および、テンプレートタグ：lng

名前：ズームレベル
ベースネーム、および、テンプレートタグ：zoom

ここで記載しているベースネームとテンプレートタグは、あくまで一例です。
「lng じゃなくて long だろ！」など、思うところがある方はご自由に変更してください w

なお、カスタムフィールドだけを追加する専用テーマを用意しました。
ごちらをご利用の場合は、ダウンロードして ZIP ファイルを解凍後にできるフォルダ（mt）を MT のシステムディレクトリと見立てて、「/themes/」の中身をアップロードしてください。

地図用カスタムフィールド追加テーマ
http://download.d-s-b.jp/MTThemes/theme_cf_googlemaps.zip

アップロード後、任意のウェブサイトまたはブログへテーマを適用します。

JavaScript のアップロードと user.css の修正

導入済みの方はご存知の通り、MTAppjQuery プラグインは「/mt-static/plugins/MTAppjQuery/user-files/」に含まれる JavaScript や CSS を調整してカスタマイズできます。

そこで、Google マップ表示用の JavaScript をこのディレクトリにアップロードして管理することにしましょう。

MTAppjQuery user-files 追加データ
http://download.d-s-b.jp/MTAppjQuery_user-files.zip

ZIP ファイル解凍後、 GoogleMaps.js の2〜11行目をお好みで調整してください。

var lat_basename = 'lat';    // 「緯度」カスタムフィールドのベースネーム
var lng_basename = 'lng';    // 「経度」カスタムフィールドのベースネーム
var zoom_basename = 'zoom';    // 「ズームレベル」カスタムフィールドのベースネーム
var map_wrapper_element = 'map-wrapper';    // 上記3つのカスタムフィールドのラッパーID
var map_element = 'gmap';    // 地図を表示させる要素のID名
var map_search_element	= 'map-serach-box';    // 「地図を検索」部分のラッパーID
var lat_default = 37.400529;    //「緯度」の初期値
var lng_default = 140.359743;    //「経度」の初期値
var zoom_default = 15;    // 「ズームレベル」の初期値

lat_basename・lng_basename・zoom_basename はカスタムフィールドのベースネーム、
lat_default・lng_default・zoom_default には地図座標などの初期値をそれぞれ設定します。

参考までに、 GoogleMaps.js の13行目で「緯度のカスタムフィールドがある場合のみ」それ以降のコードを実行するようにしてあります。

if(jQuery('#customfield_' + lat_basename + '-field').length){

特定のウェブサイト（やブログ）に限定する場合は、ここを調整してください。

// 緯度のカスタムフィールドがあり、かつ、ブログ ID が 2 の場合に限定
if(jQuery('#customfield_' + lat_basename + '-field').length && mtappVars.blog_id == 2){

また、14〜21行目で3つのカスタムフィールドをタイトルの次に並べつつ、ドラッグによるソートを無効にしています。user.js で並び順を制御している場合などは、これらの行を削除してください。

// 必要にあわせてソートを調整
$.MTAppFieldSort({
  sort: 'title, c:' + lat_basename + ', c:' + lng_basename + ', c:' + zoom_basename
});
jQuery('#customfield_' + lat_basename + '-field, #customfield_' + lng_basename + '-field, #customfield_' + zoom_basename + '-field')
  .removeClass('sort-enabled')
  .wrapAll('
');

なお、user.css に追記する内容は下記のとおりです。
既に任意のスタイル定義をしている場合は、行末あたりにコピー＆ペーストでよいかもしれません。要素の ID 名を変更した場合は、調整をお忘れなく。。。

#gmap {
  width: 100%;
  height: 300px;
  background: #ddd;
}
#map-wrapper:after,
#map-serach-box:after {
  display: table;
  content: " ";
  clear: both;
}
#map-wrapper > div.field {
  width: 39%;
  float: left;
  margin-right: 1%;
}
#map-wrapper > div.field:last-child {
  width: 20%;
  margin-right: 0;
}
#map-serach-box {
  padding: 0.5em 0 1em;
}
#map-serach-box input {
  width: 70%;
  float: left;
  margin-right: 1%;
}
#map-serach-box button {
  float: right;
  font-size: 12px;
}

プラグイン設定の調整

最後に MTAppjQuery のプラグイン設定へ script タグを2つ追加します。

<script type="text/javascript" src="//maps.google.com/maps/api/js?sensor=false"></script>
<script type="text/javascript" src="/PATHtoMT/mt-static/plugins/MTAppjQuery/user-files/GoogleMaps.js"></script>

2行目にある mt-static のパスは、適宜修正してください。

個人的には、必要に応じて直後に読み込まれる user.js でゴニョゴニョできるので「変数 mtapp_html_foot に追加（MTAppjQueryのuser.jsの直前）」にセットするのがオススメです。

問題なく設定できていれば、（ブログ）記事の編集画面に Google マップが表示されます。

補足

出力する際は、テンプレートの任意の場所へ従来のカスタムフィールドと同様に MT タグを記述します。

上記は、拙作の jQuery Google Maps プラグインで表示させる場合のサンプルです。
複数マーカーの表示なども比較的簡単に実装できると思うので、よかったら使ってみてください。

jQuery Google Maps プラグイン
http://labs.d-s-b.jp/plugins/jQuery/jQueryGoogleMaps/