Contents

---

Introduction

---

The GoogleMap plugin is used to insert a map using Google global map, which can be integrated into any CMSimple page by means of the CMSimple scripting command or it can also be integrated into CMSimple template.

Disclaimer : No warranties whatsoever, use at your own risk !
Requirements : The CMSimple plugin loader must be installed and operational !

Back to contents

Installation instructions

• Always make a full backup of your current CMSimple installation. I can't be held responsible for any data lost or corrupted!
• If not already installed, please download the Plugin-Loader from http://cmsimpleplugins.svarrer.dk/?Plugin_Loader and install it according to the instructions.
• Download the googlemap.zip file and unzip to a local folder on your computer, do not change the predefined folder structure.
• Using your FTP program, upload the folder googlemaps and it's content as a subfolder of the folder called plugins (from the plugin loader installation) on your remote machine (web server).

   

• The picture below shows the googlemap plugin folder structure

  

• folder permissions: please see the picture below and check these minimum folder permissions for the googlemap plugin.

folder name	chmod
config	755
help	755
languages	755
map	777

change all files in the root of the googlemap folder to 444 (chmod 444)

• config folder: contains the configuration file (config.php) which holds all plugin related configuration settings

Set the config.php file permissions to 666 (chmod 666)

• map folder: contains the map generation file, called "google.html".
  

Set google.html file permissions to 777 (chmod 777)

• help folder: contains this help file
  
  
• languages folder: contains the different googlemap language files (administration).
  
  Currently, the following languages are supported:
  • english (en.php)
  • lithuanian (lt.php)
  • polish (pl.php)

  If your native language isn't included in this language list, you are encouraged to contribute to this plugin by translating the plugin messages into your language and sending them to: mmgprojektas@gmail.com. The translation will be included in the googlemap plugin package.
  
  Your effort is much appreciated...
  

Set the language file permissions to 755 (chmod 755)

The GoogleMap plugin is installed now

Before you can use the Googlemap plugin, it's necessary to

1. SignUp for the Google APIkey on http://www.google.com/apis/maps/signup.html
2. Configure the Latitude and Longitude of Your map You would like to show using this plugin

Back to contents

Configuration settings

---

The configuration settings of the GoogleMap plugin are integrated into the CMSimple administrative module. So, first login into this module.

Select Googlemap from the list of available plugins.

Select Configuration from the dropdown list.

• APIkey: [string]
  • here You need to enter Your generated APIkey from http://www.google.com/apis/maps/signup.html
    
    
    
• align: [string]
  • used to set googlemap alignment
  • possible values:
    • center
    • left
    • right
      
      
      
• controls: 
  • mapmovement:[true|false] -enables or disables movement menu on the map
  • maptype: [true|false] - enables or disables map type menu on the map (map, sattelite, hybrid)
    
    
    
• mapsize: [pixels|percents]
  • height: height of the map
  • width: width of the map
  
  
  
• messagebox: 
  • enable: shows the message box for Your point on the map
  • text: text that is shown on the message box
  
  
  
  
• position: 
  • latitude: set the latitude of Your map
  • longitude: set the longitude of Your map
  
  
  
• zoomlevel: [number]
  • type in the zoom level of Your map

Back to contents

Language settings

---

The language settings of the Googlemap plugin are integrated into the CMSimple administrative module.
So, first login into this module.

Select Googlemap from the list of available plugins.

Select Language from the dropdown list.

Change the language settings according to your needs and use the save button to save the modifications you make.

Back to contents

Show GoogleMaps on a CMSimple page

The googlemap is called by means of a special function named : googlemap().
This function has no required parameters

If you want to show your googlemap on a CMSimple page, please follow the steps listed below:

• login into the CMSimple administration module
• select edit mode
• select the page you want the googlemap to appear or just create a new page
• change your editor to html mode, and type the code as listed below:

#cmsimple $output.=googlemap();#

• change your editor to back to normal mode, and save the page changes

• test your googlemap by navigating to page containing your googlemap.

• the googlemap is ready to be used by your site visitors.

Back to contents

Put the googlemap into the site template

To display a googlemap within your template, please follow the steps listed below:

• login into the CMSimple administration module
• select settings from the CMSimple menu and select edit template from System files list.
• Add the following php script into the template code on the location you want the googlemap to appear:

   <?php echo googlemap();?>

• save your template modification
• verify if the googlemap appears on the site

Back to contents