=== Just Map It! ===
Tags: jmi, just map it, just map it!, map, social computing, interactive information map, information visualization
Contributors: socialcomputing
Requires at least: 3.0
Tested up to: 3.3.1
Stable tag: 1.0.2

Just Map It! for Wordpress plugin is provided by Social Computing. It enables the visualization of your blog posts as an interactive map.

== Description ==

Just Map It! for Wordpress is a plugin that enables the visualization of a blog
posts map. Posts are positioned in relation to the shared keywords. The map is a
navigation tool : allowing you to center on any post and to discover related
contents around this post. We applied this plugin to our News stream. Just try it!

== Installation ==

= Requirements = 

This plugin depends on the JSON API Plugin available at http://wordpress.org/extend/plugins/json-api/ 
Please follow the installation steps of the that plugin and confirm that it is successfully enabled before trying to install this plugin.

= Installation steps =

1. Put the jmi directory into [wordpress_dir]/wp-content/plugins/
1. Go into the WordPress admin interface and activate the plugin
1. Open the JSON API plugin configuration page and enable the JMI controller
1. Open the Just Map It! configuration page and follow the instructions 

= Configuration =

Go to the plugin configuration page : Admin -> Settings -> Just Map It!

Related posts 

* Height and width: dimension of the map in pixels

* Posts limit: Maximum number of posts to get from the blog to generate the map

* Posts get method: Method used to get other posts from the one being read by the user
    * Last posts: Get last blog posts including the selected one
    * With same tags: Get blog posts containing the same tags as the selected one

Advanced section 

* Server url: location of the Just Map It! server.
  For now only one value is allowed : http://server.just-map-it.com

* Map configuration name:
  The map configuration name passed to the server.

* Login and password: authentication information to provide to access the blog rest service 
  if the access is restricted (disabled by default)

== Usage ==

= Related posts Map =

By default the map is disabled and not displayed at the bottom of blog posts.
To add the map, check the 'display map on posts' option in the plugin configuration page.


= Map on a tag or a category archive page (Optional) =

To add the map on the tag archive and category archive pages, paste the
following snippets, in the following files in your template directory : 

* tag.php

`<?php if(function_exists('jmimap')) : ?>
<?php
    $tag_id = get_query_var('tag_id');
    $options = get_option('jmi_options');
    $wpurl = jmi_get_json_url('tag_posts', array(
                                                'id' => $tag_id
                                            )
                              );
    $map_options = array('width' => '650', 
                         'height' => '400',
                         'analysisProfile' => 'DiscoveryProfile', 
                         'attributeId' => $tag_id, 
                         'invert' => false,
                         'wordpressurl' => $wpurl);
    echo jmimap_js($map_options); 
    the_jmimap($map_options);
?>
<?php endif; ?>`

* category.php

`<?php if(function_exists('jmimap')) : ?>
 <?php
     $options = get_option('jmi_options');
     $wpurl = jmi_get_json_url('category_posts', array(
                                            'id' => get_query_var('cat')
                                        )
                              );
     $map_options = array('width' => '650',
                          'height' => '400',
                          'analysisProfile' => 'GlobalProfile', 
                          'invert' => true, 
                          'wordpressurl' => $wpurl);
     echo jmimap_js($map_options); 
     the_jmimap($map_options);
 ?>
 <?php endif; ?>`

== Additional note ==

We provide a freely accessible Just Map It! server at http://server.just-map-it.com that is hosted on a cloud plateform.
However, we do not give any warranty on this server performance, response time or availablity.
If you want to display a high number of maps or have a high number of users on your wiki and you need some SLA,
please contact us by mail at contact at social-computing dot com or visit our website http://www.social-computing.com/ and fill the contact form.

== Frequently Asked Questions ==

= How can I tell if it's working? =

A interactive map should appear at the bottom of each blog post when the option
is checked. This map shows the relation between the post being read and other
blog posts by the tags they share.

== Changelog ==

= 1.0.2 =

* Bug fix : url encode wordpress url only in non js section

= 1.0.1 =

* Administration section rewritten
    * Default values are set for all parameters
    * Parameters escaping and trim on strings
    * Parameters validation and error messages feedback
    * Add sections and parameters descriptions
    * Preparing i18n
    
* Add posts limit to set the max number of posts to get to generate the map
* Add posts get method, with 2 strategies
* The configuration documentation moved into the installation section in the readme file

* Bug fixes :
    * The blog json api url is constructed automatically and without url rewriting.
    * Registering javascript dependencies
    * Don't create the jmi subdirectory in the wordpress upload directory automatically

= 1.0.0 =

* Initial release of the Just Map It! plugin for Wordpress