4 users Sign-in to change your status

A world map plugin JavaScript Widget jQuery

• Homepage
• Repository
• Download package
• Browse source

A Symfony plugin that displays a vectorial map and shows associated data

Developers

Name	Status	Email
Pierre FAYOLLE	lead	rf.dillit <<ta>> erreip

License

Copyright (c) 2012 Pierre Fayolle
Using jvector-map 0.1, (c)2011, Kirill Lebedev

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Releases for sf 1.4

Releases for sf 1.3

Join this plugin team

Other releases

Release 0.0.4 - 24/05/2012

Release 0.0.3 - 16/05/2012

tiWorldMapPlugin (for Symfony 1.4)

The tiWorldMapPlugin allows you to include a world map in your web page and to easily display some data on it. All country names are available in two languages : English and French. The plugin also provides lots of options to help you personalize the way it renders. This plugin relies on jquery, so you will also need jquery.

Installation

• Installation via package system

  symfony plugin:install tiWorldMapPlugin
  

• Installation via a git checkout

  git clone git://github.com/Tillid/tiWorldMapPlugin.git plugins/tiWorldMapPlugin
  

• Plugin activation in the file config/ProjectConfiguration.class.php

  class ProjectConfiguration extends sfProjectConfiguration
  {
      public function setup()
      {
          $this->enablePlugins(array(
          'sfDoctrinePlugin', 
          'tiWorldMapPlugin',
          '...'
          ));
      }
  }

• Rebuild your model, update your database tables by startng from scratch and load the fixtures (it will delete all the existing tables, then re-create them)

  symfony doctrine:build --all --and-load --no-confirmation
  

• Enable the tiWorldMapPlugin in your settings.yml

  all:
      .settings:
      enabled_modules:      [default, tiWorldMapPlugin]
  

• Publish the plugin assets

  symfony plugin:publish-assets
  

• Clear your cache

  symfony cc
  

How to use

Including the worldmap in a symfony template

To use the tiWorldMapPlugin, you have to include the worldmap in your page with include_component

include_component('tiWorldMap', 'worldmap', array());

Options

You can use several options by putting them in the third argument array. These possible options are:

• width : sets the width of the worldmap (default value: 500px)

• height : sets the height of the worldmap (default value: 300px)

• class : sets a css class to the worldmap (default value: tiWorldMapPlugin_map)

• backgroundColor : sets the worldmap background color (default value: #808080)

• color : sets the normal color of the countries (default value: #FFFFFF)

• hoverColor : sets the color of the countries under the mouse pointer (default value: #000000)

• scaleColorStart : sets the starting scaling color when representing data with color gradient (default value: #FFFFFF)

• scaleColorEnd : sets the ending scaling color when representing data with color gradient (default value: #FF0000)

• normalizeFunction : sets the function used to calculate color when representing data with color gradient (default value: linear, possible values: linear/polynomial)

• zoomStep : sets the zoom coefficient (default value: 1.4)

• zoomMaxStep : sets the number of time you can zoom in (default value: 4)

• zoomCurStep : sets the current zoom step (default value: 1)

• onLabelShow : allows you to call a javascript function just before a country label is shown. Received parameters: event, label, code.

• onRegionOver : allows you to call a javascript function when the mouse pointer enters a country region. Received parameters: event, code.

• onRegionOut : allows you to call a javascript function when the mouse pointer leaves a country region. Received parameters: event, code.

• onRegionClick : allows you to call a javascript function when a country is clicked. Received parameters: event, code.

All these options can also be specified in the app.yml file of your application. The option names are just all in lowercase and prefixed with tiworldmapplugin. Example:

    all:
        tiworldmapplugin_width: 1000px
        tiworldmapplugin_height: 600px

It is also the same as:

    all:
        tiworldmapplugin:
            width: 1000px
            height: 600px

If an option is set with both method, the option passed directly through include_component in taken.

Data visualization

The tiWorldMapPlugin provides you with two way of visualize data:

1. Setting directly the country color: you can specify for each country the color you want. This is done by passing an array colors which associates the country code with the desired color.

2. Using a color gradient to represent data variations. This is done by passing an array values which associates the country code with the data value to represent.

Miscellaneous

• The list of the countries with their code can be found in the file modules/templates/_worldmapjs.php

• You can use the javascript function getNameFromCode to get the full country name from the country code