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-配置