=== Just Map It! ===
Tags: jmi, just map it, just map it!, map, social computing, interactive information map, information visualization, concept mapping, concept map, semantic mapping, knowledge visualization, conceptual graphs, topic mapping, datavisualization, dataviz
Contributors: socialcomputing
Requires at least: 3.0
Tested up to: 3.3.2
Stable tag: 1.2.0

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 keywords they share.
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!

Map features :

* Center on a blog post and explore related posts
* Highlight a tag on the map and the posts annotated with that tag 
* Navigate to a post page to read post content.
* From a tag, go to it's archive page and read posts containing that tag.

If you have any issue or want to give us feedback, please open a new topic on the plugin support forum.
See the link "View support forum" on the right column.

Love this plugin and use it on your blog ? please rate it and inform other wordpress users that you like 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); 
    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);
     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.

= When I attempt to download the Flash client the browser page just goes to white. =

The white page you see when you click on the download link appears because your browser tries to open the flash client instead of offering to download it.
Which means the link is valid but you don't have a download dialog box.
After clicking on the link, when you see the white page, you can save the .swf file by clicking on your browser's menu and selecting the "save as..." entry.
Or you can right click on the download link and select "save link as ..." to start to download the remote flash client.

== Changelog ==

= 1.2.0 =

* Latest Wordpress version tested with the plugin increased to 3.3.2
* The tags urls are now generated server side and published in the Just Map It! JSON REST Services.
* Constructing JMI_JSON url from the blog home url instead of wordpress url

= 1.1.0 =

* i18n and localization for french and english languages
* Display the expected swf location in the installation process

* bugfix: don't display the map if not tags are set for a post

= 1.0.4 =

* Add viewport meta for mobile devices.
* Also add fullScreenOnSelection parameter to the flash application to allow users
  to switch easily to fullscreen mode on tactile devices.

= 1.0.3 =

* bug fix : dynamic js is surrounded by html tags in posts content and html escaping is applied. 
            => javacript is not added in the post content anymore.
               wp_localize_script is used to pass parameters array, see http://www.wpmods.com/using-multidimensional-arrays-with-wp_localize_script/

= 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