My Maps location文檔

介紹

讓您的用戶搜索位置並根據需要配置顯示。 My maps location是Joomla最先進的Google Maps集成。

 

我-地圖定位,主

 

主要特點:

  • 搜索您創建的位置
  • 自動地理定位
  • 地圖來源可以是Google地圖,Bing地圖或Mapbox
  • 添加地圖設計
  • 從Google地方獲取信息
  • 從.csv文件導入/導出/同步位置
  • 前端位置提交
  • 很多第三方擴展集成

I. MY MAPS LOCATION安裝和更新

1.1安裝

我們的組件是Joomla 3.x兼容。 所有會員都包含所有功能和第三方集成。
要安裝我們的組件,您必須下載擴展名.zip文件並使用標準的Joomla安裝程序。

 

的Joomla安裝

 

然後單擊“瀏覽”>“上載並安裝”按鈕,默認情況下將安裝組件,模塊和插件。

1.2更新和自動更新程序

要更新My Maps location,您可以通過從JoomUnited下載ZIP文件或使用自動更新程序(推薦)來安裝新版本的舊版本。

 

MML更新

 

推送更新通知的自動更新程序嵌入在您安裝的Joomla擴展中。 因此,您會像儀表板中的任何其他擴展程序或使用菜單一樣收到通知: Extension> Manage> Update菜單。

 

登錄您的帳戶進行更新

您需要登錄您的JoomUnited帳戶才能更新所有JoomUnited Joomla擴展程序。 要登錄訪問組件的主要配置,請單擊 實時更新選項卡。 在底部,您將找到一個登錄按鈕。

 

實時更新

 

輸入您的JoomUnited憑據,與您在此處登錄@ www.joomunited.com使用的憑據相同

 

登錄-joomunited

 

按鈕會變成橙色,恭喜! 您現在可以更新本網站上的所有JoomUnited擴展! 如果您的會員資格已過期,您將獲得續訂鏈接和解釋該信息的文本。

 

帳戶鏈接

 

注意:一次登錄將允許您更新所有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=en

第一步是創建項目,然後鍵入項目的名稱。

 

創建-API密鑰

 

如果我想允許來自mydomain的所有請求,那麼要遵循的模式是* .joomunited.com / *
如果您只想允許單個域名,例如mydomain.com,那麼模式將是joomunited.com/*


在localhost環境中,您可以放置​​任何有效密鑰,它將在沒有任何域引用的情況下工作。

 

域的API-圖案


然後生成API密鑰,這是您需要復制以添加到My Maps location的密鑰。

 

API創建

 

將密鑰添加到My Maps Location。

來自 組件> My Maps Location>選項視圖,您可以在配置中添加密鑰。

 

地圖配置

 

粘貼密鑰。

 

插件API密鑰

 

一步一步的簡歷:


所以我遵循的步驟是

  • 轉到Google API控制台
  • 創建或選擇一個項目
  • 點擊 繼續 啟用API和任何相關服務
  • 在“憑據”頁面上,獲取一個 瀏覽器鍵 (並設置API憑據)
  • 為防止配額被盜,請保護您的API密鑰 那些最佳實踐

2.2管理位置類別

位置分類。 這些類別可以在前端顯示為過濾器,或者用作菜單項中的預定義參數以加載某些分類的位置。
 

類別過濾器,前端

 

如果您有很多地點,建議您使用類別。 您可以創建類別和子類別。
要創建類別,請進入 My Maps location>類別,然後單擊新建

 

類別的位置

 

然後,從類別屏幕中,您需要添加標題和父類別,以防您想要創建子類別

 

類別父

 

您還可以使用選項卡在ctaegory中定義位置的默認標記 標記選擇

 

標記類別

 

注意:默認情況下會創建一個名為的類別 “我的類別” 允許您在安裝後直接開始添加位置

2.3創建一個位置

為了創建一個位置,請進去 My Maps location>位置>新建

有3個必填字段:

  • 位置名稱
  • 類別的位置
  • 位置詳情(地址)

 

對於地址,你有3個解決方案來添加它:

  • 使用搜索字段(推薦)
  • 導航到地圖上並使用光標指向一個位置
  • 填寫地址(必須是Google地圖有效)

 

要使用搜索引擎添加位置,請鍵入要添加的位置的名稱。

 

添加位置

 

選擇時,緯度和經度字段將自動填充。 我的地圖也與Google地方集成! 這意味著您可以搜索商店或在Google地圖上註冊的任何其他內容,我們的組件將獲取所有地點信息。

 

谷歌到位

 

 

您也可以在地圖上移動並直接放置標記,結果將相同,您將獲得自動填充的緯度和經度。

 

地圖點

 

如果您手動填寫地址字段和郵政編碼,請小心,它必須與Google地圖已知地址匹配。

 

地址字段

 

位置的詳細視圖中顯示位置的所有其他信息(描述,小時,......)。

位置詳細信息版中的聯繫鏈接可以為每個位置添加聯繫人鏈接,mailto或URL。 在前端,它將是一個聯繫人按鈕,用於打開URL或執行mailto操作。

 

9

 

2.4其他位置信息

在每個位置,您可以添加圖像和標記。

  • 位置圖片: 圖像將在位置的工具提示中顯示為縮略圖,並在位置詳細信息頁面上以更大的尺寸顯示。
  • 使用類別圖標: 使用您放置在我的地圖位置的類別字段中的圖標
  • 標記背景: 選擇背景標記的顏色
  • 標記 將在地圖上顯示為位置標記圖標。 您還為My Maps Location擴展中包含的位置提供了一些不錯的標記集。
  • 使用自定義鏈接 將通過自定義URL覆蓋指向該位置詳細信息的鏈接。

 

標記圖像的位置

 

My Maps location使用Joomla原生多語言功能。 您可以按位置和位置的類別定義語言。 在語言切換時,將像任何其他Joomla內容一樣過濾位置,以顯示語言批准的內容。

 

語言

 

位置描述字段是最重要的字段之一。
它將顯示在位置詳細信息頁面上,並根據主題顯示為搜索結果中位置的介紹文本。 更重要的是,描述是一個WYSIWYG編輯器,內部加載了所有插件,這意味著你可以在其中任何你想要的東西(圖像,視頻......)。

 

位置描述

 

這是位置搜索結果中顯示的介紹文本。

 

文本的定位,結果

 

標記字段與Joomla是相同的標記系統。 您可以添加標籤和子標籤,然後將其作為過濾器加載到前端。 要管理所有標記,只需加載Joomla標記組件: 菜單組件>標籤
在前端,根據配置,標籤可以顯示為複選框(如下圖)或下拉列表。

 

標籤過濾器

 

My Maps Location有額外的字段來填充元信息(對於搜索引擎)。 此字段將加載到位置詳細信息頁面上。

 

元信息

 

2.5顯示前端的位置

要在前端顯示您的位置,您可以使用:

  • 用於顯示位置搜索引擎,單個位置或位置類別的菜單
  • 用於顯示搜索字段或選擇一組位置的模塊
  • 用於在任何編輯器中顯示單個或多個位置的編輯器按鈕

從菜單加載位置

從Joomla菜單管理器中,添加一個元素並選擇類型 “位置搜索和顯示”。 它將顯示帶過濾器的位置搜索引擎。
選擇 “位置詳細信息視圖” 顯示單個預定義位置。

 

位置菜單

 

如果你選擇 “位置搜索和顯示” 你有一些顯示參數。 有些可能會覆蓋默認組件參數。

 

主菜單配置

 

從菜單的主選項卡中,您可以設置:

  • 輸入地址: 您可以強制在頁面加載時顯示默認地址。 它可以留空
  • 距離: 鎖定搜索的距離,參考上面的地址。 它可以保留為-1(默認)
  • 類別: 加載特定類別的位置
  • 搜索限制: 限制搜索結果的數量。 10只會返​​回位置搜索的10個第一個結果
  • 排序: 按日期,標題,距離訂購搜索結果(默認)

 

MML菜單先進

 

然後在 My Maps Location菜單選項卡,你可以設置:

  • 選擇組件: My Maps Location或所有第三方集成,如K2,Jomsocial ......
  • 默認類別ID (第三方擴展):使用第三方擴展時要加載的默認類別,如K2,Hikashop或Adsmanager,社區構建器的CB列表ID
  • 兒童類別地點: 還顯示來自子類別的搜索結果位置,而不僅是上面選擇的位置
  • 主題: 選擇菜單項可用的搜索和結果顯示主題的3個主題中的一個默認,全寬和側邊欄
  • 地圖提供者: 選擇Google地圖,Bing地圖,Mapbox,OpenStreetMap或Mapquest來設置地圖樣式
  • 啟用搜索標籤:允許使用位置標記名稱完成搜索查詢
  • 外觀設計: 根據地圖源,您有多種地圖類型和顏色
  • 地圖圖層: 向地圖添加一些數據(圖層)。 有KML層,交通層,Transit層和Bicycling層。
  • Google地圖圖層網址: 使用數據層存儲自定義數據,或在Google地圖上顯示GeoJSON數據
  • Bing地圖類型: 如果Bing Maps是您的地圖提供者,請選擇Bing Maps的外觀和數據
  • OpenStreetMap類型: 如果OpenStreetMap是您的地圖提供者,那麼您可以向地圖添加一些數據(圖層)
  • 位置工具提示: 在地圖加載時,在位置搜索後自動打開位置工具提示
  • 地圖縮放: 在地圖上定義默認縮放級別
  • 地圖和搜索結果寬度和高度選項

 

基於主題的前端顯示

 

地圖搜索主題

 

單個位置搜索顯示的結果:

布里奇沃特定位


使用模塊顯示位置

My maps location帶有2個用於本地位置的模塊+用於第三方集成的其他模塊(如用於顯示K2項目位置的模塊)

地圖模塊 允許您使用與菜單相同的過濾器但在模塊位置顯示您的位置。 這些位置將顯示為地圖或列表。 您可以選擇一組位置或選擇位置類別。

 

地圖模塊

 

My Maps Location地圖 - 搜索模塊 將顯示一個搜索引擎,其中包含一些過濾器作為選項,如地圖寬度或搜索位置的組件(僅搜索軸樣本的K2位置)。

 

搜索模塊

 

前端顯示模塊:

 

搜索地圖前端模塊

 

 

使用編輯器按鈕顯示位置


編輯器按鈕將加載到您的Joomla編輯器中(通常在文章或HTML自定義模塊中)。 您將看到編輯器底部的按鈕。
點擊後,您會看到一個燈箱,可讓您選擇之前添加的一個或多個位置。

 

地圖編輯器按鈕

 

然後,您可以選擇一個或某個位置,然後按下按鈕將其添加到文章中。 如果您未指定任何縮放級別,它將自動加載以適合您的位置區域。
您將在WYSIWYG編輯器中看到的標記代碼將類似於以下模型: {mymaplocations mapid width height}

例如:{mymaplocation id = 1 width = 58%height = 400px zoom = 10 type = google}此代碼將顯示位置ID = 1的地圖,寬度為58%,高度為400px,縮放為10倍,Google類型。 使用逗號在地圖中添加多個位置。 例如:{mymaplocation id = 1 width = 58%height = 400px zoom = 10 type = google}位置ID = 1,2,3。

 

III。 FRONTEND LOCATION SUBMISSION

3.1添加和管理位置

My maps location提供從前端提交和管理您自己的位置的選項。 首先,您需要創建一個允許前端提交的菜單。

從Joomla菜單管理器中,添加一個元素並選擇類型 “添加位置”。 然後通過點擊它,用戶將在登錄後重定向到位置提交表單。
菜單“我的位置”允許用戶編輯他們先前提交的位置。

 

增加管理的定位,前端

 

前端菜單表單概述:

 

菜單前

 

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文件更新(同步)位置

 

注意:當您直接在數據庫中添加位置時,同步按鈕也可以使用

五,搜索統計

您可以通過啟用“啟用統計信息參數”來查看位置搜索的統計信息 設置>常規配置選項卡。

 

統計月

 

你可以看到下面的頂部位置列表 出口 它也有.csv文件類型。

 

出口統計

 

VI。 參數

6.1設置

該組件有很多選項,有些可能在我們之前看到的菜單視圖中被覆蓋。 點擊 菜單:My Maps Location>選項 訪問界面(屏幕右上角)

Tab1:常規配置

 

Parameters1

 

  • 啟用統計: 啟用位置統計
  • AJAX搜索: 在AJAX中啟用搜索查詢,無需重新加載頁面即可執行搜索
  • 顯示距離: 顯示位置與用戶位置的距離
  • 距離單位: 英里或公里數
  • 地圖提供者: 在Google地圖,Microsoft Bing地圖,Mapbox,Openstreetmap + Leaflet或Mapquest之間進行選擇
  • 自動填充搜索: 進行位置搜索時自動填充建議。 自動填充建議可以來自Google地圖,Bing地圖或Openstreetmap,無論您選擇何種地圖系統
  • 每次使用Google Maps API時,如果您的域名已於2016年6月22日之後創建,則必須包含密鑰, 驗證您的請求。
    更多信息: https://developers.google.com/maps/documentation/javascript/usage?hl=en
    獲取一把鑰匙: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Google地圖類型: 地圖類型:路線圖,衛星,混合或地形
  • 地圖設計: 選擇地圖的默認設計
  • 滾動鼠標圖: 當您懸停地圖時,使用鼠標啟用放大/縮小功能
  • 拖動地圖: 使用鼠標啟用拖動地圖以在其上移動
  • 打開事件標記: 單擊或懸停標記時如何打開位置詳細信息
  • 啟用標記聚類器: 每個具有多個標記的群集都會顯示群集內標記數量的計數
  • 自動縮放功能: 自動調整縮放以顯示地圖的所有標記
  • Bing地圖類型: 地圖類型:空中,鳥眼或道路
  • Bing映射API密鑰: 放一個API密鑰使其工作;)

 

Parameters2

 

  • 隨處搜索: 在radius搜索中添加選項以搜索世界上的任何地方
  • 默認搜索任何地方: 默認情況下,搜索視圖中的半徑選擇器將設置為“任意位置”
  • 搜索中的標記格式: 將標記過濾器顯示為複選框或下拉列表
  • 街景: 在搜索中添加街景視圖作為選項
  • 顯示路線: 顯示用於從用戶位置計算路線的鏈接
  • 路線格式: 在My Maps location上顯示路線或重定向到Google
  • 聯繫鏈接的位置: 添加指向聯繫人頁面的鏈接
  • 聯繫按鈕: 顯示聯繫人按鈕
  • 聯繫目標: 打開聯繫鏈接模式
  • 地圖默認縮放: 首次加載時地圖上的默認縮放級別(將autozoom設置為no)
  • 地圖大小: 地圖和搜索結果寬度和高度
  • 半徑搜索的距離:確定radius搜索下拉列表的值
    防爆。 用戶可以選擇在紐約市周圍搜索10英里。
  • 顯示距離選擇列表: 顯示距離redius搜索選擇​​列表的選項

 

Parameters3

 

  • 搜索結果中的單詞裁剪: 在搜索結果中以一定數量的單詞裁剪位置描述
  • JQuery側邊欄: 將默認側邊欄更改為JQuery一個(更小且平滑的滾動效果)
  • 禁用地理位置: 禁用非https站點上的地理位置。
  • 禁用類別過濾器: 此選項將啟用類別下拉列表過濾器
  • 禁用國首页/地區州: 在搜索視圖中顯示國首页/地區下拉列表
  • 按郵政編碼搜索: 按郵政編碼字段搜索
  • OR按鈕的顏色: 默認主題上的“或”按鈕顏色
  • 按鈕顏色: 默認主題上的“Geolocate me”按鈕顏色
  • 全局字體顏色: 使用此選項設置“我的地圖位置”的全局字體顏色
  • 背景圖片: 圖像在默認主題搜索的背景中
  • 你的標記: 在地圖上添加您的位置並選擇圖像作為標記
  • 默認圖標圖片: 如果圖標不可用,請使用默認圖標圖像
  • 助手覆蓋: 生成一個不受擴展更新影響的Joomla標準佈局覆蓋文件(在/ html文件夾中)

 

6.2 Bing作為地圖來源

要使用Microsoft的Bing地圖作為地圖源,您需要在My Maps location的全局配置中填寫API密鑰。 Bing頁面在這裡: https://www.bingmapsportal.com/

 

全球冰

 

您需要從此處創建免費帳戶並從您的帳戶中復制API密鑰代碼。

 

秉鍵微軟

 

然後,您將能夠使用Bing地圖作為全局配置中的地圖源(默認情況下啟用它)或菜單項。

 

炳配置

 

6.3 Mapbox作為地圖源

要使用Mapbox,開發人員的自定義映射平台,作為地圖源,您需要在中填充Mapbox API My Maps location配置>地圖提供商.
Mapbox主頁在這裡,您需要從那裡創建一個免費帳戶: https://www.mapbox.com/

 

mapbox回首页

 

從那裡,您可以創建一些新的頁面設計或使用推薦的頁面設計並將其存儲在您的帳戶中。

 

圖式

 

要獲取您的憑據,請使用 菜單帳戶 (右上):

  • Mapbox API:使用菜單 帳戶>訪問令牌

因此,您創建的每種地圖樣式都會獲得一個密鑰。

 

mapbox-apikey

 

然後只需將其複製到My Maps location配置即可使用它。

 

mapbox-配置