/Leaflet-Maps-Marker

Pin, organize & show your favorite places through OpenStreetMap, Google Maps, Google Earth (KML), GeoJSON, GeoRSS or Augmented-Reality browsers

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

=== Leaflet Maps Marker (Google Maps, OpenStreetMap, Bing Maps) ===
Contributors:      harmr
Plugin Name:       Leaflet Maps Marker
Plugin URI:        http://www.mapsmarker.com
Tags:              Google Maps, OpenStreetMap, OSM, bing maps, googlemaps, google earth, map, maps, kml, travel, location, augmented-reality
Author URI:        http://www.harm.co.at
Author:            Robert Harm
Donate link:       http://www.mapsmarker.com/donations
Requires at least: 3.0
Tested up to:      3.6beta4
Stable tag:        3.6
License:           GPLv2

Pin, organize & show your favorite places through OpenStreetMap, Google Maps, Google Earth (KML), Bing Maps, APIs or Augmented-Reality browsers

== Description ==
Maps Marker allows you to pin, organize and share your favorite spots through your WordPress powered site easily. You can use maps from OpenStreetMap, Google Maps, Google Earth, Bing Maps or custom maps and additionally display your spots in innovative ways like through augmented-reality browsers.

For even more features please try "[Leaflet Maps Marker Pro](http://www.mapsmarker.com)". This plugin includes a pro upgrader which allows you to start a free 30 day trial easily.

= Vision =
We are working hard on delivering the best mapping solution available for WordPress - helping you to share your favorite spots

= Mission Statement =
[Maps Marker](http://www.mapsmarker.com) helps you to share your favorite spots easily. The plugin is based on the famous [leaflet.js library](http://www.leafletjs.com) from [CloudMade](http://www.cloudmade.com) which also powers maps on sites like [Flickr](http://www.flickr.com/map), [Foursquare](http://readwrite.com/2012/02/29/foursquare_dumps_google_goes_open-source_for_maps), [Craigslist](http://www.theverge.com/2012/10/4/3452526/craigslist-map-view-apartment-listings-roll-out), [Wikipedia](http://en.wikipedia.org/wiki/Wikipedia_App) and [Washington Post](http://www.washingtonpost.com/wp-srv/special/politics/election-map-2012/senate/). We use this library as the basis for our plugin and have integrated several other libraries for enhancing its functionality. Our main goal is to provide you with an intuitive and user-friendly interface for organizing your spots within your WordPress powered site. Furthermore we are constantly working on improving our plugin by adding new and innovative ways for managing and showing your spots. Our roadmap for new releases gets aligned to our users' needs - so giving support and talking to our users is essential.

= Plugin's Official Site =
http://mapsmarker.com

* [FAQ](http://www.mapsmarker.com/faq/) - [Docs](http://www.mapsmarker.com/docs/) - [Support](http://mapsmarker.com/support/) - [Github](https://github.com/robertharm/Leaflet-Maps-Marker) - [Donations](http://mapsmarker.com/donations) - [Twitter](http://twitter.com/mapsmarker) - [Facebook](http://facebook.com/mapsmarker) - [Google+](http://www.mapsmarker.com/+) - [Translations](http://translate.mapsmarker.com/projects/lmm)

= Main features =
Leaflet Maps Marker allows you to

* pin your favorites places with markers,
* use integrated address search (Google Places API) for quickly finding your places,
* choose from up to 800 custom free map icons from [Maps Icons Collection](http://mapicons.nicolasmollet.com),
* add popup description text or images for each marker,
* choose individual basemap, size and zoom level for each marker/layer map,
* organize your markers in layers and
* show them thanks to the [Leaflet library from Cloudmade](http://www.leafletjs.com)
* by adding a shortcode (e.g. mapsmarker marker="1")] to posts, pages, widgets or template

on basemaps from

* OpenStreetMap,
* Google Maps (Road, Satellite, Hybrid, Terrain),
* Bing Maps (Aerial, Aerials+Labels, Road),
* MapQuest (Road, Satellite),
* [OGD Vienna Maps](http://data.wien.gv.at) (Road, Aerial, Addresses)
* or any custom WMTS-map

to the visitors of your website.

= Additional features =

* show directions for your locations using Google Maps, yournavigation.org, openrouteservice.org or map.project-osrm.org
* support for Google Maps API key which is required for commercial users
* configure up to 10 WMS servers to display additional information from external geodata providers (like the European Environment Agency) on your maps
* organize markers from different layers in multi-layer-maps
* export your markers as KML file for displaying in Google Earth or Google Maps
* export your markers as GeoJSON file for embedding in external websites or apps
* export your markers as GeoRSS for embedding in external websites or apps
* export your markers as ARML for displaying in the augmented-reality browser from Wikitude
* export your markers as csv-file
* option to switch between simplified and advanced editor
* option to add widgets showing recent marker entries
* configure up to 3 basemaps from Cloudmade with custom styles
* option to add an unobtrusive scale control to maps
* keyboard navigation support for maps
* TinyMCE button for easily searching and adding maps on post/pages edit screen
* display a list of markers below layer maps
* show standalone maps in fullscreen mode
* automatically generated geo sitemap for all maps (for submitting to Google)
* support for microformat geo-markup to make your maps machine-readable
* support for custom marker timestamps for more precise KML animations - [demo video](http://www.youtube.com/watch?v=LXliLaZ4u-E)
* create QR code images for standalone maps in fullscreen mode
* automatically add meta-tags with location information to maps
* automatically add microformat geo-markup to maps
* support for maps that do not reflect the real world (e.g. game, indoor or photo maps)
* option to set Wordpress roles (administrator, editor, author, contributor) which are allowed to add/edit/delete markers and layers
* option to add marker directly to posts or pages without saving them to your database
* audit log for changes on markers & layers (saving first created by/on and last updated by/on info)
* search within your marker list
* mass actions for markers (assignment to layers, deletions)
* option to reset plugin settings to defaults
* option to change the default shortcode '[mapsmarker...]'
* dynamic preview of maps in backend (no need to reload)
* option to select plugin default language in settings for backend and frontend
* WordPress Admin Bar integration to quickly access plugins features (can be disabled)
* "OGD Vienna selector": if a place within boundaries of Vienna/Austria is chosen, OGD Vienna basemaps are automatically selected
* admin dashboard widget showing latest markers and blog posts from mapsmarker.com
* support for google maps and bing map localization (cultures)
* integrated [donation links](http://www.mapsmarker.com/donations) to show your support for this plugin :-)

= Technical details =
* full support for responsive designs (= automatic resizing of maps if viewport is wider than map width)
* Wordpress Multisite compatibility
* Full RTL (Right-to-Left) Language Support
* plugin was successfully tested to ÖNORM 7700 and OWASP TOP 10 for security issues
* full UTF8-support for cyrillic, chinese or other alphabets on marker/layername and marker popup text
* integrated check for known incompatible plugins (and instructions on how to fix)
* support for other languages through .po/.mo-files (please see http://mapsmarker.com/languages for details if you want to contribute a new translation)
* option to select plugin default language in settings for backend and frontend (separately from language set in wp-config.php)
* support for Retina displays to display maps in a higher resolution
* GeoJSON feeds for every marker and layer with [JSONP support](http://www.mapsmarker.com/geojson)
* use of Wordpress settings API for storing options
* TinyMCE editor on backend for editing popuptext
* integrated plugin compatibility check to warn about incompatible plugins
* dynamic changelog to show all changes since your last plugin update
* version check for minimum Wordpress (3.0) and PHP (5.2) requirements
* use of prepared SQL statements to prevent SQL injections
* use of Wordpress nounces on forms to prevent attacks and input mistakes
* use of custom function names and enque plugin scripts/css only on plugin pages to prevent conflicts with other plugins
* update functions implemented for smooth updates of the plugin
* uninstall function to completely remove the plugin and its data (also on WordPress Multisite installations)

= Available translations =
* Bengali (ba_BD) thanks to Nur Hasan
* Bosnian (bs_BA) thanks to Kenan Dervišević
* Bulgarian (bg_BG) thanks to Andon Ivanov
* Catalan (ca) thanks to Vicent Cubells and Efraim Bayarri
* Chinese (zh_CN) thanks to John Shen and ck
* Chinese (zh_TW) thanks to jamesho Ho
* Croatian (hr) thanks to Neven Pausic, Alan Benic and Marijan Rajic
* Czech (cs_CZ) thanks to Viktor Kleiner
* Danish (da_DK) thanks to Mads Dyrmann Larsen
* Dutch (nl_NL) thanks to Marijke Metz and Patrick Ruers
* English (en_US)
* French (fr_FR) thanks to Vincèn Pujol and Rodolphe Quiedeville and Fx Benard
* German (de_DE)
* Hindi (hi_IN) thanks to by Outshine Solutions and Guntupalli Karunakar
* Hungarian (hu_HU) thanks to István Pintér and Csaba Orban
* Indonesian (id_ID) thanks to Emir Hartato
* Italian (it_IT) thanks to Luca Barbetti
* Japanese (ja) thanks to Shu Higashi
* Korean (ko_KR) thanks to Andy Park
* Latvian (lv) thanks to Juris Orlovs and Eriks Remess
* Polish (pl_PL) translation thanks to Pawel Wyszynski and Tomasz Rudnicki
* Portuguese (pt_BR) thanks to Andre Santos and Antonio Hammerl
* Portuguese (pt_PT) translation thanks to Joao Campos
* Romanian (ro_RO) translation thanks to Arian and Daniel Codrea
* Russian (ru_RU) thanks to Ekaterina Golubina, supported by Teplitsa of Social Technologies
* Slovak (sk_SK) thanks to Zdenko Podobny
* Spanish (es_ES) thanks to David Ramirez, Alvaro Lara, Ricardo Viteri and Victor Guevara
* Swedish (sv_SE) thanks to Swedish translation thanks to Olof Odier, Tedy Warsitha and Dan Paulsson
* Turkish (tr_TR) thanks to Emre Erkan
* Ukrainian (uk_UK) thanks to Andrexj
* Yiddish (yi) thanks to Raphael Finkel

For full credits of each translations please visit [http://www.mapsmarker.com/languages](http://www.mapsmarker.com/languages) (had to remove backlinks from readme-file as it is considered as spam by WordPress :-/ )

Leaflet Maps Marker also supports easy switching between translations through a specific plugin setting.
For more information on translations and how to contribute a new translation, please visit [http://translate.mapsmarker.com](http://translate.mapsmarker.com/projects/lmm).

= Leaflet Maps Marker Needs Your Support =
It is hard to continue development and support for this plugin without contributions from users like you. If you enjoy using Leaflet Maps Marker - particularly within a commercial context - please consider [__making a donation__](http://www.mapsmarker.com/donations). Your donation will help keeping the plugin free for everyone and allow me to spend more time on developing, maintaining and support. I´d be happy to accept your donation! Thanks! [Robert Harm](http://www.harm.co.at)

== Installation ==

= The Famous 3-Minute Installation =

1. Login on your WordPress site with your user account (needs to have admin rights!)
2. Select "Add New" from the "Plugins" menu
3. Search for **maps** or **Leaflet Maps Marker**
4. Click on "Install now" below the entry "Leaflet Maps Marker (Google Maps, OpenStreetMap, Bing Maps)"
5. Click on "OK" on the popup "Are you sure you want to install this plugin?"
6. Click "Activate Plugin"

Done. You can create your first marker map (you are getting redirected after first plugin activation automatically)

After installation you will also find a 'Leaflet Maps Marker' menu in your WordPress admin panel and in WordPress Admin Bar.
For basic usage and tutorials, you can also have a look at [http://www.mapsmarker.com/docs](http://www.mapsmarker.com/docs "Docs").

= Detailed Installation Instructions =

If you do not want to use the built-in plugin installation procedure from WordPress, you can also install the plugin manually:

1. Navigate to [http://wordpress.org/plugins/leaflet-maps-marker/](http://wordpress.org/plugins/leaflet-maps-marker/)
2. Click on red button "Download Version X.X" and download the plugin as ZIP-file
3. Login on your WordPress site with your user account (needs to have admin rights!)
4. Select "Add New" from the "Plugins" menu
5. Select "Upload" from the "Install Plugins"-submenu
6. Click on the button and select the previously downloaded ZIP-file
7. Click "Install now"
8. Click "Activate Plugin"

Done. You can create your first marker map (you are getting redirected after first plugin activation automatically)

= Detailed Installation Instructions (via FTP) =

1. Navigate to [http://wordpress.org/plugins/leaflet-maps-marker/](http://wordpress.org/plugins/leaflet-maps-marker/)
2. Click on red button "Download Version X.X" and download the plugin as ZIP-file
3. Login on your WordPress site with your user account (needs to have admin rights!)
4. unzip and upload the leaflet-maps-marker folder to the `/wp-content/plugins/` directory
5. Login on your WordPress site with your user account (needs to have admin rights!)
6. Activate the plugin "Leaflet Maps Marker" through the "Plugins" menu in WordPress

Done. You can create your first marker map (you are getting redirected after first plugin activation automatically)

Note: plugin requires at least PHP 5.2 and Wordpress 3.0!

== Frequently Asked Questions ==
Do you have questions or issues with Leaflet Maps Marker? Please use the following support channels appropriately.
One personal request: before you post a new support ticket in the [Wordpress Support Forum](http://wordpress.org/support/plugin/leaflet-maps-marker), please follow the instructions from [http://www.mapsmarker.com/readme-first](http://www.mapsmarker.com/readme-first) which give you a guideline on how to deal with the most common issues.

1. [FAQ](www.mapsmarker.com/faq/)
2. [Docs](http://www.mapsmarker.com/docs/)
3. [Wordpress Support Forum](http://wordpress.org/support/plugin/leaflet-maps-marker) (free community support)
4. [WP Questions](http://wpquestions.com/affiliates/register/name/robertharm) (paid community support)
5. [WordPress HelpCenter](http://wphelpcenter.com/) (paid professional support)

[More info on support](http://mapsmarker.com/support/)

== Screenshots ==
For demo maps please visit [http://www.mapsmarker.com/demo](http://www.mapsmarker.com/demo).

01. Frontend: marker map (with open popup and image, basemap: OGD Vienna satellite, overlay: OGD Vienna addresses, controlbox: expanded)
02. Frontend: layer map (5 marker, different icons, basemap: OpenStreetMap, controlbox: collapsed)
03. Frontend: map with WMS layer enabled and additional marker
04. Frontend: layer map in Google Earth (via KML export)
05. Frontend: layer map in Google Maps (via KML export)
06. Frontend: showing marker in Wikitude (via Augmented-Reality API)
07. Backend: simplified editor - create maps with an intuitive interface
08. Backend: advanced editor (optional) - allows you to set all available options
09. Backend: add/edit layer - allows you to fully customize the layer map (used basemap & overlays, set center, map size, zoom, controlbox status etc).
10. Backend: markerlist - for easy administration of all your markers
11. Backend: layerlist - for easy administration of all your layers
12. Backend: plugin settings page allows you to easily set all necessary settings & restore the defaults if you messed something up
13. Backend: csv-export of all markers - just copy and paste into your favorite spreadsheet application for use in other applications
14. Backend: tools section - allows mass-actions more markers (assignements, deletions)
15. [youtube http://www.youtube.com/watch?v=LXliLaZ4u-E]

== Other Notes ==

= Licence =
Good news, this plugin is free for everyone! Since it's released under the GPL, you can use it free of charge on your personal or commercial blog. But if you enjoy this plugin, you can thank me and leave a small donation for the time I've spent writing and supporting this plugin. Please see [http://www.mapsmarker.com/donations](http://www.mapsmarker.com/donations) for details.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License included with this plugin for more details.

= Licenses for used libraries, services and images =
* Leaflet - Copyright (c) 2010-2012, CloudMade, Vladimir Agafonkin [http://www.leafletjs.com](http://www.leafletjs.com)
* OpenStreetMap - The Free Wiki World Map: [OpenStreetMap License](http://wiki.openstreetmap.org/wiki/OpenStreetMap_License)
* Map Icons Collection by Nicolas Mollet - [http://mapicons.nicolasmollet.com](http://mapicons.nicolasmollet.com)
* Datasource OGD Vienna maps: Stadt Wien, Creative Commons Attribution (by) [http://data.wien.gv.at](http://data.wien.gv.at)
* Jquery TimePicker, by Trent Richardson, [http://trentrichardson.com/examples/timepicker/](http://trentrichardson.com/examples/timepicker/), licence: GPL
* Adress autocompletion powered by [Google Places API](http://code.google.com/intl/de-AT/apis/maps/documentation/places/autocomplete.html)
* Map center icon [Joseph Wain](http://glyphish.com/) - Creative Commons Attribution (by)
* Plus-, json-, layer-, language- & csv-export icon by icon by [Yusuke Kamiyamane](http://www.pinvoke.com/) - Creative Commons Attribution (by)
* Question Mark icon by [RandomJabber](http://www.randomjabber.com/)
* Home icon by [ Pro Theme Design](http://prothemedesign.com/) - Creative Commons Attribution (by)
* Images for changelog from [Firefox release notes](http://www.mozilla.org/en-US/firefox/11.0/releasenotes/), licence: Creative Commons Attribution ShareAlike (CC BY-SA 3.0)
* Home-Icon from [Pro Theme Design](http://prothemedesign.com), licence: Creative Commons Attribution (by)
* Editor-Switch-Icon by AMAZIGH Aneglus, license: GNU/GPL
* Submenu icons from [Bijou](http://bijou.im) and [Iconic](http://somerandomdude.com/work/iconic/) icon sets (GPL)

= Credits & special thanks to =
* Sindre Wimberger ([http://www.sindre.at](http://www.sindre.at)) for help with bugfixing & geo-consulting
* Julia Loew ([http://www.weiderand.net](http://www.weiderand.net)) for logo and corporate design
* Wordpress-Settings-API-Class by Aliso the geek ([http://alisothegeek.com/2011/01/wordpress-settings-api-tutorial-1/](http://alisothegeek.com/2011/01/wordpress-settings-api-tutorial-1/))
* [Hind](http://www.nanodesu.ru) who originally release a basic Leaflet plugin (not available anymore) which I used partly as a basis for Leaflet Maps Marker plugin
* [shramov](http://psha.org.ru/b/leaflet-plugins.html) for bing and google maps plugins for leaflet

For more information on translations of the plugin and how to contribute a new translation, please visit [http://www.mapsmarker.com/languages](http://www.mapsmarker.com/languages).

= Trademark and copyright =
MapsMarker ® - registration pending
Copyright 2011-2013, Robert Harm, All Rights Reserved

== Upgrade Notice ==
= v3.6 =
MapsMarker API, iD editor and pro upgrader - see http://www.mapsmarker.com/v3.6 for more details

== Changelog ==
[blog post with details about v3.6](http://www.mapsmarker.com/v3.6)

[changelog for all versions](http://www.mapsmarker.com/changelog)