My Maps locationのドキュメント

前書き

ユーザーが場所を検索して表示を希望通りに設定できるようにします。 My maps locationは単にJoomlaのための最も先進的なGoogleマップの統合です。

 

マイマップロケーションメイン

 

主な特徴:

  • 作成した場所を検索する
  • 自動位置情報
  • マップソースは、Googleマップ、Bingマップ、またはMapboxです。
  • 地図デザインを追加
  • Googleの場所から情報を入手する
  • .csvファイルからインポート/エクスポート/同期の場所
  • フロントエンドロケーションの送信
  • 多くのサードパーティエクステンション統合

I. MY MAPS LOCATIONのインストールと更新

1.1インストール

私たちのコンポーネントはJoomla 3.x互換です。 すべての機能とサードパーティの統合はすべてのメンバーシップに含まれています。
私たちのコンポーネントをインストールするには、拡張子.zipファイルをダウンロードして、標準のJoomlaインストーラを使わなければなりません。

 

joomla-install

 

それからBrowse> Upload and Installボタンをクリックすると、コンポーネント、モジュール、プラグインがデフォルトで有効になってインストールされます。

1.2更新と自動更新

My Maps locationをアップデートするには、JoomUnitedからZIPファイルをダウンロードすることによって古いバージョンの上に新しいバージョンをインストールするか、自動アップデータを使用することができます(推奨)。

 

mmlアップデート

 

更新通知をプッシュする自動アップデータは、インストールしたJoomla拡張機能に組み込まれています。 そのため、ダッシュボードの他の拡張子やメニューを使用して通知を受け取ることができます。 「拡張機能」>「管理」>「更新」メニュー

 

アカウントにログインして更新する

JoomUnited Joomla拡張機能をすべて更新するには、JoomUnitedアカウントにログインする必要があります。 ログインアクセスするには、コンポーネントのメイン設定にアクセスしてください。 ライブアップデートタブ。 一番下には、ログインボタンがあります。

 

ライブアップデート

 

あなたのJoomUnited認証情報を入力してください、あなたがここにログインするのに使用するのと同じ@ www.joomunited.com

 

ログイン統合

 

ボタンがオレンジ色に変わります、おめでとうございます。 これで、このWebサイト上のすべてのJoomUnited拡張機能を更新することができます。 会員の有効期限が切れている場合は、更新リンクとそれを説明するテキストが表示されます。

 

アカウントにリンク

 

注:1回のログインで、JoomUnitedのすべての拡張機能を更新できます(メンバーシップに関して)。 切断しない限り、ログインは期限切れになりません。

II。 所在地とカテゴリ

2.1 Google Maps APIキーを入手する

Google Maps APIを使用するたびに、ドメインが2016年6月22日以降に作成されている場合は、リクエストを検証するためにキーを含める必要があります。
キーを入手してAPIを有効にします。 https://developers.google.com/maps/documentation/javascript/get-api-key

詳しくは: https://developers.google.com/maps/documentation/javascript/usage?hl=ja

最初のステップは、プロジェクトを作成し、プロジェクトの名前を入力することです。

 

create-api-key

 

mydomainからのすべてのリクエストを許可する場合、従うパターンは* .joomunited.com / *です
たとえばmydomain.comのように単一ドメインを許可するだけの場合、パターンはjoomunited.com/*になります。


ローカルホスト環境では、有効なキーを設定すれば、ドメインを参照せずに機能します。

 

domain-api-pattern


その後、APIキーが生成されます。これは、My Maps locationに追加するためにコピーする必要があるキーです。

 

API作成

 

キーをMy Maps Locationに追加します。

から コンポーネント> My Maps Location>オプションビュー設定にキーを追加できます。

 

マップ構成

 

キーを貼り付けます。

 

add-api-key

 

ステップバイステップの履歴書:


だから私が従うステップは

  • Google APIコンソールに移動します
  • プロジェクトを作成または選択する
  • クリック 持続する APIおよび関連サービスを有効にする
  • [資格情報]ページで、 ブラウザキー (そしてAPIクレデンシャルを設定します)
  • クォータの盗難を防ぐために、次のようにAPIキーを保護します それらのベストプラクティス

2.2場所のカテゴリを管理する

場所はカテゴリに分類されます。 これらのカテゴリはフロントエンドでフィルタとして表示することも、メニュー項目で事前定義されたパラメータとして使用してカテゴリ化された場所を読み込むこともできます。
 

category-filter-frontend

 

場所がたくさんある場合は、カテゴリを使用することをお勧めします。 カテゴリとサブカテゴリを作成できます。
カテゴリを作成するには、にアクセスしてください My Maps location>カテゴリと新規をクリック

 

カテゴリの場所

 

次に、カテゴリ画面からサブカテゴリを作成する場合に備えて、タイトルと親カテゴリを追加する必要があります。

 

カテゴリ親

 

タブを使用してカテゴリ内の場所のデフォルトマーカーを定義することもできます。 マーカー選択

 

マーカーカテゴリ

 

注:カテゴリはデフォルトでという名前で作成されます。 「私のカテゴリ」 インストール後すぐに場所の追加を開始できるようにする

2.3場所を作成する

場所を作成するには、にアクセスしてください My Maps location>場所>新しい

3つの必須フィールドがあります。

  • 場所の名前
  • 場所のカテゴリ
  • 場所の詳細(住所)

 

住所については、追加する3つの解決策があります。

  • 検索フィールドを使用する(推奨)
  • 地図上に移動し、カーソルを使って場所を指定します
  • 住所を入力してください(Googleマップの有効な名前である必要があります)

 

検索エンジンで場所を追加するには、追加したい場所の名前を入力します。

 

場所を追加

 

選択すると、緯度と経度のフィールドが自動的に入力されます。 私の地図はグーグルの場所とも統合されています! それはあなたが店やGoogleマップに登録されている他の何かを検索することができることを意味します、私たちのコンポーネントはすべての場所情報を取得します。

 

Googleプレイス

 

 

地図上を移動してマーカーを直接配置することもできます。結果は同じになり、緯度と経度が自動的に入力されます。

 

マップポイント

 

住所フィールドと郵便番号を手動で入力する場合は、Googleマップの既知の住所と一致させる必要があります。

 

アドレスフィールド

 

場所のその他すべての情報(説明、時間など)は、場所の詳細ビューに表示されます。

location detail editionの連絡先リンクは、連絡先リンク、mailto、または場所ごとのURLを追加することができます。 フロントエンドではURLを開くかmailtoアクションを実行するコンタクトボタンになります。

 

9

 

2.4その他の位置情報

それぞれの場所に、画像とマーカーを追加できます。

  • ロケーション画像: 画像は、場所のツールチップにサムネイルとして表示され、場所の詳細ページには大きなサイズで表示されます。
  • カテゴリアイコンを使用: 地図の場所のカテゴリフィールドに配置したアイコンを使用する
  • マーカーの背景: 背景マーカーの色を選ぶ
  • マーカー 地図上に位置マーカーアイコンとして表示されます。 また、My Maps Location拡張機能に含まれるロケーション用の優れたマーカーセットも入手しました。
  • カスタムリンクを使用する カスタムURLによって場所の詳細へのリンクをオーバーライドします。

 

マーカー画像の位置

 

My Maps locationはJoomlaネイティブの多言語機能を使用しています。 場所のカテゴリと場所で言語を定義できます。 言語切り替え時には、言語で承認されたコンテンツを表示するために、他のJoomlaコンテンツと同じように場所がフィルタリングされます。

 

言語

 

場所の説明フィールドは最も重要なものの1つです。
場所の詳細ページに表示され、テーマによっては検索結果の場所の紹介テキストとして表示されます。 もっと重要なのは、説明はすべてのプラグインが内部にロードされたWYSIWYGエディタです、それはあなたがそれにあなたが望む何でもできることを意味します(画像、ビデオ...)。

 

場所の説明

 

これは、ロケーション検索結果に表示されるイントロテキストです。

 

テキスト内の場所の結果

 

tagフィールドはJoomlaと同じタグシステムです。 タグとサブタグを追加してから、フィルタとしてフロントエンドに読み込むことができます。 すべてのタグを管理するには、Joomlaタグコンポーネントを読み込むだけです。 メニューコンポーネント>タグ
フロントエンドでは、設定に応じて、タグをチェックボックス(下のように)またはドロップダウンリストとして表示できます。

 

タグフィルター

 

My Maps Locationは、メタ情報を満たすための追加のフィールドを取得しました(検索エンジン用)。 このフィールドはロケーション詳細ページにロードされます。

 

メタ情報

 

2.5フロントエンドに位置を表示する

あなたの場所をフロントエンドに表示するためには、次のものを使うことができます。

  • 場所検索エンジン、単一の場所、または場所のカテゴリを表示するメニュー
  • 検索フィールドを表示したり一連の場所を選択したりするためのモジュール
  • 任意のエディタで単一または複数の場所を表示するためのエディタボタン

メニューから位置を読み込む

Joomlaのメニューマネージャから、要素を追加してタイプとして選択 「位置検索と表示」 それはフィルタで位置検索エンジンを表示します。
選択する “ロケーション詳細表示” 単一の事前定義場所を表示します。

 

ロケーションメニュー

 

選択した場合 「位置検索と表示」 いくつかの表示パラメータがあります。 デフォルトのコンポーネントパラメータを上書きするものもあります。

 

メインメニュー設定

 

メニューのメインタブから設定できます。

  • 住所を入力してください: デフォルトのアドレスをページロード時に強制的に表示することができます。 空のままにできます
  • 距離: 上記のアドレスを参照して、検索をロックする距離。 -1のままにすることができます(デフォルト)。
  • カテゴリー: 特定のカテゴリの場所を読み込む
  • 検索制限: 検索結果の数を制限します。 10は位置検索の最初の10の結果のみを返します
  • 注文: 検索結果を日付、タイトル、距離で並べ替える(デフォルト)

 

mml-menu-advanced

 

それから My Maps Locationメニュータブあなたが設定することができます:

  • コンポーネントを選択してください: My Maps LocationまたはK2、Jomsocialのようなすべてのサードパーティの統合...
  • デフォルトのカテゴリID (サードパーティの拡張機能):サードパーティの拡張機能が使用されている場合にロードされるデフォルトのカテゴリ(K2、Hikashop、Adsmanagerなど)、コミュニティビルダーのCBリストID
  • 子カテゴリの場所: 上記で選択したものだけでなく、サブカテゴリからの検索結果の場所としても表示する
  • テーマ: メニュー項目で使用可能な検索および結果表示テーマの3つのテーマのデフォルト、全角およびサイドバーのいずれかを選択します。
  • 地図プロバ​​イダー: Googleマップ、Bingマップ、Mapbox、OpenStreetMap、またはMapquestを選択してマップのスタイルを設定します。
  • 検索タグを有効にする:ロケーションタグ名を使用して検索クエリを実行できるようにします
  • デザイン: マップソースに応じて、いくつかのマップタイプと色があります。
  • マップレイヤー あなたの地図にいくつかのデータ(レイヤー)を追加します。 KML層、トラフィック層、トランジット層、自転車層があります。
  • Google Map LayerのURL: カスタムデータを保存したり、GoogleマップにGeoJSONデータを表示したりするには、データレイヤーを使用します。
  • Bing Mapsの種類: Bing Mapsがあなたの地図プロバ​​イダーである場合は、Bing Mapsの外観とデータを選択してください。
  • OpenStreetMapタイプ: OpenStreetMapがあなたの地図プロバ​​イダーであるならば、あなたはあなたの地図にいくつかのデータ(レイヤー)を追加することができます
  • 位置情報のヒント: 地図の読み込み時に、位置検索後に位置ツールチップを自動的に開く
  • 地図のズーム: 地図上のデフォルトのズームレベルを定義する
  • 地図と検索結果の幅と高さのオプション

 

テーマに基づくフロントエンド表示

 

地図検索テーマ

 

単一ロケーション検索表示の結果

ブリッジウォーターの場所


モジュールを使って位置を表示する

My maps locationには、ネイティブロケーション用の2つのモジュールと、サードパーティ統合用の他のモジュール(K2アイテムのロケーションを表示するためのモジュールなど)が付属しています。

Mapモジュール メニューと同じフィルタを使用して自分の位置をモジュール位置に表示することができます。 場所はMapまたはListとして表示されます。 一連の場所を選択することも、場所のカテゴリを選択することもできます。

 

マップモジュール

 

My Maps Locationマップ–検索モジュール マップ幅や場所を検索するコンポーネントなどのオプションとして、いくつかのフィルターを備えた検索エンジンを表示します(axampleのみのK2場所を検索します)。

 

検索モジュール

 

フロントエンドのディスプレイモジュール:

 

search-map-frontend-modules

 

 

エディタボタンを使用して場所を表示する


エディタボタンはあなたのJoomlaエディタにロードされます(通常記事やHTMLカスタムモジュールに)。 エディタの下部にボタンが表示されます。
クリックすると、以前に追加した1つまたは複数の場所を選択できるライトボックスが表示されます。

 

マップエディターボタン

 

それからあなたは1つまたはいくつかの場所を選択してあなたの記事にそれを追加するためにボタンを押すことができます。 ズームレベルを指定しないと、その地域に合わせて自動的にロードされます。
WYSIWYGエディタに表示されるタグコードは、次のモデルのようになります。 {mymaplocations mapidの幅の高さ}

例:{mymaplocation id = 1 width = 58%height = 400px zoom = 10 type = google}このコードは、位置ID = 1の地図を表示します。幅58%、高さ400px、ズーム10倍、Google typeです。 コンマを使用して地図に複数の場所を追加します。 例:{mymaplocation id = 1 width = 58%height = 400px zoom = 10 type = google}ロケーションID = 1、2、3。

 

III。 フロントロケーション送信

3.1場所を追加して管理する

My maps locationはフロントエンドからあなた自身の場所を送信し管理するオプションを提供します。 まずフロントエンドでの投稿を許可するメニューを作成する必要があります。

Joomlaのメニューマネージャから、要素を追加してタイプとして選択 「場所を追加」 それからそれをクリックすることによって、ユーザーはログイン後に、ロケーション送信フォームにリダイレクトされます。
メニュー「私の場所」は、ユーザーが以前に提出された場所を編集することを可能にします。

 

add-manage-location-frontend

 

フロントエンドメニューフォームの概要:

 

メニューフロント

 

3.2アクセス制限

フロントエンドの提出と編集のプロセスはJoomla ACLによって制御されます。 送信を許可されているユーザーを編集するには、をクリックしてください。 [コンポーネント]> [My Maps Location]> [オプション]> [権限]。
そこからあなたはJoomlaユーザーグループができる魔女を制御することができます:

  • 場所を作成
  • 場所を削除
  • 場所を編集
  • 公開状態を編集する
  • 自分の場所を編集する

 

フロントエンドの場所の提出

 

IV。 輸入 - 輸出ロケーション

My Maps locationは.csvまたは.kmlファイル(Google Earthファイル)から場所のインポート - エクスポート - 同期ツールを入手しました。 クリックしてください メニューMy Maps Location>インポート/エクスポート インターフェイスへのアクセスを取得します。

 

インポート-エクスポート-ツール

 

このインターフェースから、次のことができます。

  • .csvファイルまたは.kmlファイルから場所をインポートする
  • .csvファイルまたは.kmlファイルから場所をエクスポートする
  • .csvファイルまたは.kmlファイルから場所を更新(同期)する

 

注:データベースに直接場所を追加した場合も、同期ボタンは機能します。

V.検索統計

[統計情報の有効化]パラメータを有効にすると、現在地検索の統計情報を表示できます。 設定>一般設定タブ。

 

統計月

 

そして、あなたは以下のトップの場所のリストを見ることができます、あなたはすることができます 輸出する .csvファイルタイプでも。

 

輸出統計

 

VI。 パラメーター

6.1設定

コンポーネントにはたくさんのオプションがありますが、前に見たようにメニュービューでオーバーライドされるものもあります。 クリックしてください メニュー:My Maps Location>オプション インターフェース(画面の右上)にアクセスする

Tab1:一般設定

 

Parameters1

 

  • 統計を有効にします。 位置情報を有効にする
  • AJAX検索: AJAXで検索クエリを有効にし、ページをリロードせずに検索を実行する
  • 表示距離: ユーザー位置からの位置の距離を表示します
  • 距離の単位: マイルまたはキロメートル
  • 地図プロバ​​イダー: Googleマップ、Microsoft Bingマップ、Mapbox、OpenStreetmap + LeafletまたはMapquestのいずれかを選択
  • オートコンプリート検索: 位置検索をするときの提案をオートコンプリートします。 あなたが選んだどんな地図システムでも、オートコンプリートの提案はグーグルマップ、BingマップまたはOpenStreetmapから来ることができます
  • Google Maps APIを使用するたびに、ドメインが2016年6月22日以降に作成されている場合は、キーを含める必要があります。 あなたの要求を検証します。
    詳しくは: https://developers.google.com/maps/documentation/javascript/usage?hl=ja
    鍵を入手してください。 https://developers.google.com/maps/documentation/javascript/get-api-key
  • Googleマップの種類: マップタイプ:ロードマップ、衛星、ハイブリッド、または地形
  • 地図デザイン: 地図のデフォルトデザインを選択
  • マウスマップをスクロールします。 地図上にマウスを移動したときにマウスを使用してズームイン/ズームアウトを有効にする
  • 地図をドラッグ: マウスを使用して地図をドラッグして上に移動する
  • オープンイベントマーカー: マーカーをクリックまたはホバーしたときに位置の詳細がどのように開かれるか
  • マーカークラスタを有効にする: 複数のマーカーを持つ各クラスターは、クラスター内のマーカーの数を表示します。
  • オートズーム機能: 自動的にズームを調整して地図のすべてのマーカーを表示する
  • Bing Mapsの種類: 地図の種類:航空写真、鳥瞰図または道路
  • Bing maps APIキー: それを動作させるためにAPIキーを入れてください;)

 

Parameters2

 

  • どこでも検索: 半径検索にオプションを追加して、世界中のどこでも検索できます
  • デフォルトでどこでも検索: デフォルトでは、検索ビューの半径セレクタはどこにでも設定されます。
  • 検索時のタグフォーマット: チェックボックスまたはドロップダウンリストとしてタグフィルタを表示する
  • ストリートビュー: オプションでストリートビューを検索に追加
  • ルート表示: ユーザーの位置から経路を計算するためのリンクを表示する
  • ルートフォーマット: ルートをMy Maps locationで表示するか、Googleにリダイレクトします
  • 場所の連絡先リンク: 連絡先ページへのリンクを追加する
  • 連絡ボタン: 連絡先ボタンを表示する
  • 連絡先リンク先: 連絡先リンクモードを開く
  • 地図のデフォルトズーム: 初回ロード時の地図上のデフォルトのズームレベル(自動ズームをnoに設定)
  • 地図サイズ: 地図と検索結果の幅と高さ
  • 半径検索のための距離:半径検索ドロップダウンリストの値を決定します
    例 ユーザーはニューヨーク市周辺の10マイルを検索することを選択できます。
  • 距離選択リストを表示します。 距離redius検索選択リストを表示するオプション

 

Parameters3

 

  • 検索結果の単語クロップ: 検索結果の特定の単語数で場所の説明を切り取る
  • JQueryサイドバー デフォルトのサイドバーをJQueryのものに変更します(小さくて滑らかなスクロール効果)
  • 位置情報を無効にする: https以外のサイトで位置情報を無効にします。
  • カテゴリフィルタを無効にする: このオプションはカテゴリドロップダウンリストフィルタを有効にします
  • 国の状態フィルタを無効にする: 検索ビューに国の州のドロップダウンを表示する
  • 郵便番号で検索: 郵便番号フィールドで検索
  • ORボタンの色: デフォルトテーマの「OR」ボタンの色
  • ボタンの色 デフォルトテーマの「Geolocate me」ボタンの色
  • グローバルフォントの色: このオプションを使用して、マイマップの場所のグローバルフォントカラーを設定します。
  • 背景画像: デフォルトテーマでの検索の背景にある画像
  • あなたのマーカー: 地図上の位置を追加してマーカーとして画像を選択
  • デフォルトのアイコン画像: アイコンが利用できない場合はデフォルトのアイコン画像を使用
  • ヘルパーオーバーライド: 拡張機能の更新による影響を受けないJoomla標準レイアウト上書きファイルを生成します(/ htmlフォルダ内)。

 

6.2マップソースとしてのBing

MicrosoftのBing Mapsをマップソースとして使用するには、My Maps locationのグローバル設定でAPIキーを入力する必要があります。 Bingのページはこちらです。 https://www.bingmapsportal.com/

 

グローバルビン

 

あなたはここから無料のアカウントを作成し、あなたのアカウントからAPIキーコードをコピーする必要があります。

 

bing-key-microsoft

 

そうすれば、Bingマップをグローバル設定(デフォルトとして有効にするため)またはメニュー項目からのマップソースとして使用できるようになります。

 

bing-config

 

6.3マップソースとしてのMapbox

開発者用のカスタムマッピングプラットフォームであるMapboxをマップのソースとして使用するには、次の場所にMapbox APIを入力する必要があります。 My Maps location構成>マッププロバイダー.
Mapboxのホームページはこちらです。そこから無料アカウントを作成する必要があります。 https://www.mapbox.com/

 

mapbox-home

 

そこから新しいページデザインを作成するか、または推奨されているものを使用してアカウントに保存することができます。

 

地図スタイル

 

認証情報を取得するには、 メニューアカウント (右上):

  • Mapbox API:メニューを使う アカウント>アクセストークン

つまり、作成したマップスタイルごとに1つのキーがあります。

 

mapbox-apikey

 

それを使用するには、My Maps location構成にコピーするだけです。

 

mapbox-config