In the Joomla administration go to Extensions → Components → HelloMaps
1. Dashboard View
This is the Dashboard where at top show the number of ALL markers geolocated for each plugin enabled as in plugin configuration guide.
2. Configuration View
First click on the button “Configuration” link in the left sidebar or menù.
This screen and divided by 4 tab.
Let’s see the Tabs:
Toolbar & Buttons:
Take note that the overall configuration of the component overrides in some cases individual parameters of individual plugins
if enabled show the left or right sidebar.
if disabled override all plugin settings and not display any plugin tab
2. Load Open
if closed only show vertical buttons
3. Sidebar Position
Left or Right
set min to 350 at least (no need to append pixel)
if enabled show the search field that allow to search component fields setted from plugin params
2. Enable Radius Search
Allow to search/filter markers by area or address and by miles. See image
if enabled show main informations of plugin in the sidebar (title, image, text, link, extra fields, etc…).
Changes depending on the type of plugin tab.
Take a look of this image to find contents div.
show or hide this box area.
2. Type Global or by Plugin
Displays an HTML text defined by the site administrator as global type or refers to the active tab of the plugin in use.
a) by Global
show the same notice box with the component notice text in all map tabs,
b) by Plugins
you can set different notice text for each hellomaps plugins.
You can change this text go to administrator -> plugins manager -> hellomaps plugins.
So, when users click on different sidebar title tabs, the notice box will change.
3. Notice Position
Left or Right
4. Notice Html Text
Html text for Global type option
Shows the total number of markers, the markers shown on the map depending on the zoom or the search results
2. Type Global or by Plugin
3. Results Position
Top or Bottom
insert custom link in the map to fixed bottom positions (bottom-right)
insert url here
1. Enable Satellite
2. Enable Terrain
3. Enable Street
Points 1,2,3 – Choose to enable this type of views for maps.
set the type of the default map when the site load.
1. Enable Cluster
some applications are required to display a large number of locations or markers.
HelloMaps use the MarkerClusterer grid-based library to group markers neighbors and also according to the zoom level.
Useful if you have a large number of markers that creates confusion and to optimize the speed of the map.
2. Custom Cluster Image
choose your custom icon in transparency for all levels of zoom.
1. Enable Infowindow
Enable the box when user click on marker icon. Default is Yes
2. Width & Height
Set the dimensions for this infowindows box.
1. Width & Height
set the dimensions for this map.
You can use also percentage
Map Events Enabled:
There are 3 possible events for the map.
1. Mouse Scroll Zoom
when enabled users can zoom map also using the mouse, else to zoom they need to use the “minus (-)” and “plus (+)” buttons on the sidebar to zoom the map.
2. Marker Mouse Over
when enabled if user go over some marker in the map (except for the cluster image), hellomaps highlights the short information for this marker in the sidebar, bringing the content between the top and without opening the infowindow with the click of a mouse.
3. Sidebar Mouse Over
on the contrary: when enabled if user go over some sidebar content, hellomaps animates and moves the corresponding marker in the map.
At this point you choose the options of initial loading of the map.
1. AutoCenter Markers
when map load, if this is enabled, the zoom settings and the map are automatically adjusted to display and center all the markers. If markers are so many, in some cases, this process may take longer.
2. Center on User Position
when map load, causes the browser asks to show the location of the user and centers the map on this result, if user agree by pressing the button “allow”.
3. Default Latitude & Longitude
If the params “AutoCenter Markers” is set to “No”, here you can insert your default coordinates to fit markers based on this and center map in a specific location.
To retrieve the latitude and longitude i suggest you to use this tool: www.latlong.net
Choose default buttons to show on the sidebar
1. Zoom IN/OUT
the icons (+) and (-) for the map zoom
2. User Position
the browser ask for user current position
3. Street View
the “man” icon that enable google street view.
by pressing this in some area in max level zoom it show the real google images if avaiables.
4. List View
Reduce or Increase in Vertical mode the sidebar
with this option users can filter the markers based on the plugin by enabling/disabling their set of markers.
6. Expand/Collapse Sidebar
View Toolbar Horizontal or Vertical
7. Full Screen
Enable Full screen button. So uses by pressing this can use this mode.
3. Display the Map by the component
What I will show you now is how to load the map by creating a menu link that calls the component.
But in the next chapter you will also see how to use a module and how to customize it further.
You are free to choose which method to use based on your needs.
a) Now in the Joomla administration go to Menù → Your Menù → Add New Menù Item
b) In the Menù Item Type select HelloMaps → HelloMap.
c) There are not other params to configure for HelloMaps. The options are those that we configured earlier.
d) you can see direct link by typing www.yoursitename.com/index.php?option=com_hellomaps
Via the menu link you can configure a map with the default options, and that loads all plugins at once,
while through the use of the module for HelloMaps installed in the package we see in the next driving you can use and duplicate the module to have maps with configurations and views different.
In some ways a more flexible method.
Back To Top
Here we will not explain how to set up a joomla module for displaying it in a position of your template.
This now seems pretty obvious even for those beginning with Joomla.
What is shown in this guide module is primarily:
1. the ability to set which set of markers related to the plugin to show the map
2. set the parameters of the module
In the Joomla administration go to Extensions → Module Manager and search HelloMaps
as we explain in point 1 pay attention to following main parameters:
1. Choose Plugins
when you click on this field you can select a list of hellomaps plugins that you have enabled in Extensions → Plugin Manager -> HelloMaps Plugins.
In this way, for example, you can choose to show only the marker of some plugins for this module for example jomsocial and jevent, or only the articles, or easysocial and k2 or ALL, ect …
If you want so, you can duplicate this module and select other plugins and assign this in other page…
2. Use Settings by Component or Module
if you set by Component you don’t need to see other params tabs because it takes the global configuration for component,
else if you set by Module you can ovverride as you want for this module only.
As see the tabs of the parameters are equal to those of the component and that is:
Layout Settings Tab – Map Settings Tab – Toolbar & Buttons Settings.
For the explanation of these module parameters see the options on the previous guide for component as they have the same meaning.
Note: the only global parameter managed by the component is just the radius search.
3. Default Map Type
Street – Terrain – Satellite – Hybrid on module load
4. Map Dimensions
width and height. You can use for example percentage width 100%.
At this point there is nothing else. You can view HelloMaps in your site.
Back To Top
Access over SSL (HTTPS)
Back To Top
If you have problems of multi language you must follow these simple steps.
In this example, we will use HelloMaps AdsManager Plugin (you can apply these changes to all HelloMaps Plugins)
Open the file [root]\plugins\hellomaps\adsmanager\adsmanager.php
Now, find this string: $language->load(‘plg_hellomaps_adsmanager’, JPATH_ADMINISTRATOR, $language->getName(), true);
and replace with: $language->load(‘plg_hellomaps_adsmanager’, JPATH_ADMINISTRATOR, $language->getTag(), true);
Done. Save and close.
If you have other question contact us.
Back To Top