The official FieldType extension for the Maps module. Simply modify your Map from within your entry.
Make sure your system meets the minimum requirements:
This version is a major update that can only be installed on top of version 2.x or higher. See https://addons.reinos.nl/news/maps-suite-3
For every paid addon you need to validate your license in order to activate the module.
On a local environment, like *.dev
*.local
*.localhost
*.test
the license is valid for testing and building a new or existing sites.
For every other domain, you need to have a valid license.
Once installed, you will asked to enter your license key. When you entered a valid license you can hit the "Save license" button. This will start validating your license and will redirect you to addons.reinos.nl to login into your account. You can also register a new account in this process.
Once logged in, you are asked to use your current account or to login with another one.
Using the current logged in account, the server will check all info related to your license and once valid, it will redirect you back to your site where you see either a success message or an error message.
This module is using a license field to check if the license for the module is valid or not. On addons.reinos.nl you can check your license and add your valid domains.
In the Module CP you can enter then your license
When you enter a wrong license, the module will not work and it shows you an warning
Sometimes it happens that the license system says you have an invalid license. When this happens, make sure you have entered your domain url in your account, next to your license on addons.reinos.nl.
If this will not fix your license problem, please contact us on https://addons.reinos.nl/support
See https://addons.reinos.nl/maps-migration
Once Maps Fieldtype is installed, you can add a Maps field to the Publish page.
When the custom field is created, you can see the Maps Fieldtype in action on the publish field
From here you can start adding markers (circles, polylines etc...), customize markers (circles, polylines etc...), search addresses and customize the map settings.
To modify the settings for the Map, you can click in the bottom on the 'map settings' button.
To search an address, you can click on the search icon at the bottom in the toolbar. After clicking on the icon an input field will be on top of the map where you can search an address.
The icon in the toolbar
The input form with a result
To simply reset the map to the original state, click on the reset icon in the toolbar.
To remove the marker, you can right-click on a marker on another item that will show a context menu.
To show your created map, you can put your custom field tag inside a {exp:channel:entries}
loop. This will show your map that you created from within the CP.
{your_custom_field}
To modify the map (like the map style or anything else) you can use the power of the Maps module. Simply extend your tag with some params from the {exp:reinos_maps:map}
method
{your_custom_field width="100%"}
Please make sure you add the {exp:reinos_maps:html_header}
and {exp:reinos_maps:html_footer}
to your template to include the necessary files
The following tags from the Maps module are supported
tiles
tile_control_position
google_maps:style
center:address
center:latlng
zoom
zoom:max
marker_cluster:enabled
marker_cluster:show_coverage_on_hover
marker_cluster:zoom_to_bounds_on_click
marker_cluster:spiderfy_on_max_zoom
marker_cluster:remove_outside_visible_bounds
div_class
width
height
overlay:html
overlay:position
focus_current_location
scroll_wheel
zoom_control
zoom_control_position
scale_control
Set the offset per feature for the popup
{your_field marker:popup:offset="-10,-100"}
{your_field circle:popup:offset="-10,-100"}
{your_field rectangle:popup:offset="-10,-100"}
{your_field polygon:popup:offset="-10,-100"}
{your_field polyline:popup:offset="-10,-100"}
There are some that filled in automatically because you set them in the entry self.
Below are the Tag Variables. Those Variables can be used in the tag described above
Show the latlng of one marker.
{your_custom_field:marker:n:latlng}
Show all latlng positions with pipeline`s
{your_custom_field:marker:latlng}
Show the title for one marker
{your_custom_field:marker:n:title}
Show all titles with pipeline`s
{your_custom_field:marker:title}
Show one icon
{your_custom_field:marker:n:icon}
Show all icons with pipeline`s
{your_custom_field:marker:icon}
Show the from latlng for use in the route function
{your_custom_field:route:from}
Show the stops latlng for use in the route function
{your_custom_field:route:stops}
Show the to latlng for use in the route function
{your_custom_field:route:to}
Variable that check if there is any marker set
{maps_field_extension:has:markers}
Loop over the Markers
{maps_field_extension:markers}...{/maps_field_extension:markers}
The lat of the marker
{maps_field_extension:markers}{lat}{/maps_field_extension:markers}
The lng of the marker
{maps_field_extension:markers}{lng}{/maps_field_extension:markers}
The title of the marker
{maps_field_extension:markers}{title}{/maps_field_extension:markers}
The icon of the marker
{maps_field_extension:markers}{icon}{/maps_field_extension:markers}
The content of the infowindow
{maps_field_extension:markers}{content}{/maps_field_extension:markers}
Holds the current number, started from 1
{maps_field_extension:markers}{count}{/maps_field_extension:markers}
Holds the current number, started from 0
{maps_field_extension:markers}{abs_count}{/maps_field_extension:markers}
Show the total numbers of markers
{maps_field_extension:markers}{total_results}{/maps_field_extension:markers}
Get the from latlng form the n polyline
{maps_field_extension:polyline:1:from}
Get the stops (latlng pipline seperated) from the n polyline to convert it to the route method
{maps_field_extension:polyline:1:stops}
Get the to latlng form the n polyline
{maps_field_extension:polyline:1:to}
Loop over the polyline positions, where N is the number of the polyline created.
{maps_fieldtype:polyline[OPTIONAL:1]}
{stroke_color}
{stroke_opacity}
{stroke_weight}
{path}
{lat}, {lng}
{/path}
{/maps_fieldtype:polyline[OPTIONAL:1]}
Loop over the polygons, where N is the number of the polygon created.
{maps_fieldtype:polygon[OPTIONAL:1]}
{stroke_color}
{stroke_opacity}
{stroke_weight}
{fill_color}
{fill_opacity}
{path}
{lat}, {lng}
{/path}
{/maps_fieldtype:polygon[OPTIONAL:1]}
Loop over the circles, where N is the number of the circle created.
{maps_fieldtype:circle[OPTIONAL:1]}
{stroke_color}
{stroke_opacity}
{stroke_weight}
{fill_color}
{fill_opacity}
{lat}
{lng}
{radius}
{/maps_fieldtype:circle[OPTIONAL:1]}
Loop over the circles, where N is the number of the circle created.
{maps_fieldtype:rectangle[OPTIONAL:1]}
{stroke_color}
{stroke_opacity}
{stroke_weight}
{fill_color}
{fill_opacity}
{bounds}
{lng}
{lng}
{/bounds}
{/maps_fieldtype:rectangle[OPTIONAL:1]}
Get all map variables
{maps_fieldtype:map}
{map_types}
{map_type}
{zoom_level}
{scroll_wheel}
{zoom_control}
{zoom_control_style}
{zoom_control_position}
{pan_control}
{pan_control_position}
{map_type_control}
{map_type_control_style}
{map_type_control_position}
{street_view_control}
{street_view_control_position}
{google_overlay_html}
{google_overlay_position}
{center}
{/maps_fieldtype:map}
The Maps Fieldtype is fully compatible with Channel Form
You can set for different functions the access level based on the membergroup on the field setting page.
The Fieldtype supports the following modules and extension
{exp:reinos_maps:html_header}
{exp:channel:entries entry_id="1" dynamic="no"}
{ce_field}
{maps_fieldtype}
{value}
{/maps_fieldtype}
{/ce_field}
{/exp:channel:entries}
{exp:reinos_maps:html_footer}
The Maps Fieldtype supports all methods of the Entry API.
To import a new data map via the Entry API, you have to use the following data structure.
array('maps_field' => array(
'markers' => array(
array(
'lat' =>'52.3909176',
'lng' =>'6.049638',
'title' => 'test',
'icon' => null
)
),
'map' => array(
'map_type' => 'roadmap',
'map_types' => array(
'hybrid',
'roadmap',
'satellite',
'terrain'
)
),
'polylines' => array(),
'polygons' => array(),
));
At the moment it is not possible to use enters in your custom field like below;
{custom_field
param1=""
param2=""
param3=""
}
Instead of that you have to use it the following way;
{custom_field param1="" param2="" param3=""}
See also http://expressionengine.stackexchange.com/questions/10726/custom-field-with-params-and-enters or https://support.ellislab.com/bugs/detail/19434
(added in v1.0.0)
ee()->extensions->call('reinos_maps_fieldtype_save_data', $data, $entry_id, $field_id);
This could be happen due to the cache that has been invalid. You could fix this by clearin the cache in the Maps module.
Added: show PHP error in debugging mode for the action urls
marker:popup:offset
polygon:popup:offset
polyline:popup:offset
circle:popup:offset
rectangle:popup:offset
param to set the popup offsetpolygon
polyline
circle
rectangle
{google_maps:style}...{/google_maps:style}
Breaking changes See https://addons.reinos.nl/news/maps-suite-3
You need at least v2.0.0 or higher to upgrade to this version. Inside all v3.x.x releases, there is a v2.x.x. release. You can use this version to upgrade to the latest v2.x.x and after that upgrade you are good to go to update to v3.x.x. Remember, its just replacing files and hit the upgrade button. There is no other action required, it's that simple (but required).
hide edit
action for the marker was not workingtemplate_post_parse
hook does not get called.reinos_
due the release of the EE store (\Breaking changes)***Note: There is a change you will have to validate the license again
\Note:** Because the module has been renamed with a prefix reinos_
there is an update path
by simply add the new update to your site and install it. By installing the module, you are disabling the old module
that can be deleted afterward. Also note that you have to rename the module calls and hooks with a prefix reinos_
See this article about the rename https://addons.reinos.nl/news/modules-renamed
glyph
objectmarkers
circles
polygons
polylines
circles
in a list. Instead you can edit the markers
circles
polygons
polylines
circles
with an context menu. This fix also an issue with the screenjump.