No description or website provided.
JavaScript CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
nbproject
public_html
LICENSE.txt
README.md
pom.xml
somospnt.myplaces.jquery.json

README.md

jQuery MyPlaces

Description

jQuery MyPlaces uses Google Maps API (v.3) to locate and display a set of determined places on the map.

It allows:

  • To locate an address on the map and display the nearby determined places.
  • Show customized information about the location.
  • To define the template for customizing user interface (maps, search bar, location information)

Requirements

  • jQuery v. 1.10+
  • JsRender

Getting Started

Include the minified plugin JS file:

<script type="text/javascript" src="../../dist/jquery.myplaces.min-1.0.js"></script>

Or include all the plugin JS files:

<script type="text/javascript" src="../../src/js/app/somospnt.js"></script>
<script type="text/javascript" src="../../src/js/app/util/util.js"></script>
<script type="text/javascript" src="../../src/js/app/util/ui/ui.js"></script>
<script type="text/javascript" src="../../src/js/app/util/ui/map/map.js"></script>
<script type="text/javascript" src="../../src/js/app/util/ui/places/places.js"></script>
<script type="text/javascript" src="../../src/js/app/util/ui/searcher/searcher.js"></script>
<script type="text/javascript" src="../../src/js/app/util/ui/filter/filter.js"></script>
<script type="text/javascript" src="../../src/js/app/plugin/myplaces.js"></script>

Add the CSS file (or append contents to your own stylesheet):

<link href="../css/myplaces.css" type="text/css" rel="stylesheet">

Add the container:

  <div class="container">
  </div>

To initialize:

// places
var places = [
    {
        "name": "My House",
        "mapIcon": "http://r-ec.bstatic.com/images/hotel/square40/146/14694220.jpg",
        "lat": -34.6390944,
        "lng": -58.389152,
        "tags": ["House", "Good Place"]
    },
    {
        "id": "1",
        "name": "The Simpsons house",
        "address": "742 Evergreen Terrace",
        "state": "Springfield",
        "shortDescription": "The Simpsons house",
        "longDescription": "The Simpsons House was designed by Kaufman and Broad homebuilders",
        "mapIcon": "https://si0.twimg.com/profile_images/3663934134/d2b2a7fcacec55ba63c06474d10de385_normal.jpeg",
        "lat": -34.6090943,
        "lng": -58.389159,
        "tags": ["Simpsons", "House"]
    }
];


// default
$('.container').myplaces({places: places});

// or with custom settings
$('.container').myplaces({
    places: places,
    country: 'AR',
    onLoad: function() {
      alert('Congratulation');
    }
});

Settings

Key Default Values Description
places [] Array
country AR ISO 3166-1 country code Two letter ISO 3166-1 country code used for suggest adress in the search bar
placeListTemplate <li>Enter a template for the list of places</li> String Template or its id to render the locations list with jsRender
placeInfoTemplate <div>Enter a template for the information of the place</div> String Template or its id to render the selected location detail with jsRender
popUpMapTemplate <div>Enter a template for the pop-up of the place</div> String Template or its id to render the selected location tooltip in the map with jsRender
mapOptions {zoom: 12, center: new google.maps.LatLng(-34.60909440, -58.3891520), mapTypeId: google.maps.MapTypeId.ROADMAP} Object It's a MapOptions object to customize the map.
onLoad function Callback function, which is called when the map has been loaded
onPlacesChange function Callback function, which is called when the locations list change
onClickPlace function Callback function, which is called when click in a place

Required attributes of places key

Attribute Description
lat location latitude
lng location longitude
mapIcon icon that represent the place in the map
name place name
tags to categorized places

License

Mozilla Public License Version 2.0 http://www.mozilla.org/MPL/2.0/