=== Web Maps for WordPress ===

Contributors: GEO-Jobe GIS Consulting
Free Version Upgrade to Pro Version See http://geo-jobe.com/wp/upgrade
Tags: maps, map, web maps, webmaps, GIS, arcgis, geo jobe, mapthis, online, mapping, add a map, button, esri, authoritative, post, posts, embed, search, searching, AGOL, ArcGIS Online
Requires at least: 4.6
Tested up to: 5.1.1
Stable tag: 1.4
License: GPLv3

The Web Maps for WordPress plugin (aka. WebMaps for Wordpress) integrates the power of “where” into your pages and posts with interactive maps exposing authoritative content. Web Maps is designed to bridge the gap between authoritative maps registered with ArcGIS Online and WordPress (the most widely used CMS on the market). Note, you are not required to have an ArcGIS Online account to use/take advantage of this plugin, however, for users that do, you can use your org's AGOL content within the plug-in, making it even more powerful!

== Description ==

Quickly and easily search and add interactive maps to your pages and posts with the "Add a Map" button. Designed similar to the familiar "Add Media" button.

Integrate the power of "where" into your pages and posts with interactive maps exposing authoritative content. Designed to bridge the gap between authoritative maps registered with ArcGIS Online and WordPress.

= Functionality =
While editing pages or posts, you'll notice the addition of an "Add Map" button next to "Add Media". The Add Map button is designed to provide WordPress users with a more streamlined process for embedding web maps in their pages and posts. While very similar to the Add Media button, Add Map puts millions of interactive maps at the fingertips of bloggers, website creators, media outlets and news organizations. For the first time, millions of WordPress users will be able to seamlessly enhance the information they're communicating with authoritative maps exposing authoritative content from authoritative sources.

<u>The following outlines various features of the Add Map button:</u>

<em>Searching for Maps:</em>
<ul>
<li>Search millions of interactive web maps using one or more keywords.</li>
<li>All public web maps registered with ArcGIS Online that have a name or contain tags matching your keywords will be returned.</li>
<li>Search results will be displayed in a grid-view showing the name and image of the map.</li>
<li>Maps provide additional details (owner, description, etc.) that will help to inform users on whether or not this map is showcasing the right content.</li>
<li>A map details link will take you to the ArcGIS Online item details page where a variety of additional information about this map is available.</li>
</ul>

<em>Configuring Maps:</em>
<ul>
<li>Once a map has been selected, the user is presented with a variety of settings that can be configured before the map is embedded.</li>
<li>Size, Show Zoom Control, Show Scale Bar, Show Legend, Show Description, Show Location Search, Show Basemap Selector, Show "View Larger Map" Link</li>
<li>Set your own custom map extents and create a map marker to display.</li>
</ul>

<em>Viewing Maps:</em>
<ul>
<li>Embedded maps are fully interactive, which means that users can zoom in/out and identify features on the map.</li>
<li>All visible data and capabilities exposed on each map layer are controlled within ArcGIS Online by the map creator.</li>
<li>For layers with pop-ups enabled, users can click on features to see additional information in a pop-up dialog.</li>
<li>Additional map controls exposed to the user (scale bar, legend, etc.) are determined on the WordPress side by the map settings.</li>
<li>For users that want a more robust experience for interacting with the map, they can click the "view larger map" link which will open the web map up in the ArcGIS Online map viewer.</li>
</ul>

= Configure (Pro Version Only) =
1. After uploading the plugin.
1. Click on "Settings" from the menu bar in your admin panel.
1. Click the "Web Maps Pro" link to go to the plugin's settings.
1. Under the Account Settings" tab, insert your ArcGIS Online Organization's URL
1. Under the "Advanced Content Tree Widget Settings" tab enter your "Items Summary Page ID". Leave blank if you are unsure.
1. Click "Save Changes" button once all chances are finalized.

= Want even more functionality? Go Pro =

The plugin is designed to interact directly with a single ArcGIS Online organization (primary organization).  On the general configuration page for the plugin, you specify the URL for the primary organization that you wish to interact with via the plugin. While the plugin is configured to a single ArcGIS Online organization, it honors cross-organization sharing of items via groups that contain items owned by other ArcGIS Online organizations (secondary organizations) and shared with “Everyone (public)”. See [http://www.geo-jobe.com/web-maps-for-wordpress/pro/](http://www.geo-jobe.com/web-maps-for-wordpress/pro/)

= Contact =
Go to [http://geo-jobe.com](http://geo-jobe.com) or contact [connect@geo-jobe.com](mailto:connect@geo-jobe.com) for questions or to request demos of the Pro Version.

Connect with GEO Jobe on [Twitter](https://twitter.com/GEOjobeGIS) and [Instagram](https://www.instagram.com/geojobegis).

Support our vision to spread the use of GIS by engaging with our blog at [http://www.geo-jobe.com/blog/](http://www.geo-jobe.com/blog/)

== Installation ==

Download and unzip the plugin file
Upload the entire file into the "/wp-content/plugins directory of your WordPress site.
Activate "Web Maps for Wordpress Plugin" in the Plugins admin panel

OR

Download and unzip the plugin
Upload the plugin file by clicking on "Plugins" from the menu bar in your admin panel.  Click the "Add New" link within the plugin menu bar.  Click the "Upload" link at the top of the Install Plugins Page.  Choose File, Find the file.  Click "Open." Then click "Install Now" button.
Activate the plugin through the Plugins menu in WordPress (if it is not already activated).

== Screenshots ==

1. The "Add Map" button enables users to quickly and easily insert maps into their post and is designed similar to the Add Media button.
2. The latest featured maps from ArcGIS Online are initially shown in the search directory.
3. You can search and browse for maps by using keywords that are related to your post.
4. Once a map is chosen, you have several options for formatting and customizing your maps within the post.
5. The map is embedded in your post and interacts with your readers.
6. Advanced plugin settings and functionality is available on the Pro Version.

== Changelog ==
= 1.4 =
* Updated for Gutenberg Compatibility: "Add Web Map" block added to editor.

==Disclaimer==
Our company accepts no liability for the use of Web Maps for WordPress, or for the consequences of any actions taken. Any use of Web Maps for WordPress for illegal activity is strictly prohibited. Any views or opinions presented in Web Maps for WordPress are solely those of the author and do not necessarily represent those of the company.