====== cnmap Plugin ======

---- plugin ----
description: Embed a China map in your wiki
author     : Lshan
email      : ldg@szzxue.com
type       : syntax
lastupdate : 2019-01-09
compatible : Frusterick Manners
depends    : 
conflicts  : 
similar    : openlayersmap, simplemap
tags       : maps

downloadurl: https://github.com/lshan2018/dokuwiki-plugin-cnmap/zipball/master
bugtracker : https://github.com/lshan2018/dokuwiki-plugin-cnmap/issues
sourcerepo : https://github.com/lshan2018/dokuwiki-plugin-cnmap
donationurl: 

screenshot_img : 
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

Embed a china map of a given latitude and longitude:

  {{cnmap>?lng=116.397428&lat=39.90923}}
  {{cnmap>amap?lng=116.397428&lat=39.90923&width=100%&height=500px&zoom=17&title=title of marker&mark=on&sat=off}}


===== Syntax =====

Basic syntax:

  {{cnmap>MAP PROVIDER?lat=LATITUDE&long=LONGITUDE&zoom=ZOOM&width=WIDTH&height=HEIGHT&mark=MARK&title=TITLE&sat=SAT}}

  * replace:
    * //MAP PROVIDER // --- map render provider(engine) :  can be amap , bmap , default is **amap**
    * //LATITUDE// --- the latitude in decimal degree
    * //LONGITUDE// --- the longitude in decimal degree
    * //ZOOM// --- zoom level(3-19) , default is **15**
    * //WIDTH// -- width , can be xxpx , xx% , default is **100%**
    * //HEIGHT// -- height , can be xxpx , xx% , default is **400px**
    * //MARK//  -- show/hide mark, default is **on**
    * //TITLE// --  title of the mark
    * //SAT// -- show satellite map, default is **off**
===== Configuration and Settings =====

All config options can be set in the [[config|configuration manager]] under the "cnmap Plugin Settings" section. 
===== Development =====
=== Change Log ===

  * [[https://github.com/lshan2018/dokuwiki-plugin-cnmap/commit/2d24e6e02353a9613cf1d9d05145938d8ef7cdcf|add navigation for amap & bmap]] (2019-01-09)
  * [[https://github.com/lshan2018/dokuwiki-plugin-cnmap/commit/2116b460257dd5e1fd8b10cc7539f58a04e30679|Initial release]] (2019-01-04)
==== Bug reports and feature requests ====

Please refer to the [[https://github.com/lshan2018/dokuwiki-plugin-cnmap/issues|Issue Tracker]] for reporting issues.