WordPress.org

Related posts Map

By default the 'related posts' map is enabled and displayed at the bottom of blog posts. If you want to disable this map, uncheck the 'display map on posts' option on the plugin configuration page.

Shortcode

The Just Map It! shortcode makes it easy to include the map of you choice in any post and page. It is a self-closing shortcode with a list of parameters

Here is an example of the syntax to use: [JMI height=640 width=480] In this case it will display a map with a global view of the 50 last blog posts. The size of the map will be 640 by 480 pixels.

Shortcode parameters

All shortcode parameters are optional. If no parameter is given, default values are taken, see the parameters descriptions below:

• height: height of the map in pixels. Default value: the one set on the configuration page in posts display tab

• width: width of the map in pixels. Default value: the one set on the configuration page in posts display tab

• analysisprofile: kind of processing profile to use to generate the map. 3 values are allowed:

  • GlobalProfile (default value): give a global view of the blog data. It is not centered on one item.
  • DiscoveryProfile: map centered on a node
  • AnalysisProfile: map with focus on a link

• invert: should the map be inverted ? If set to true, the elements that are normally links on the map are displayed as nodes. It is a boolean and can take 2 values:

  • true (default value): Nodes on the map are blog posts and links are tags.
  • false: Nodes on the map are tags and links are posts

• attributeid: id of the element on which the map should be centered. It must be specified if the DiscoveryProfile is selected.

• entityid: id of the element on which to focus on the map. It must be set if the AnalysisProfile is selected.

• json_controller: name of the service to query to get blog data. It can be one of the following:

  • last_posts: get last blog posts and their tags. Additional parameters:

    • id (optional): id of a post to include the result list
    • max (optional): max number of posts to get

  • related posts: get posts with the same tags as the one with the id given in parameter Additional parameters:

    • id (required): id of the post for which the tags are taken to make the request
    • max (optional): max number of posts to get

  • tag_posts: get posts containing the tag with id given in parameter Additional parameters:

    • id (required): id of a tag
    • max (optional): max number of posts to get

  • category_posts: get posts containing the category with id given in parameter Additional parameters:

    • id (required): id of a category
    • max (optional): max number of posts to get

• id: id parameter to pass to the json service (see above)

• max: max parameter to pass to the json service (see above)

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 theme directory :

• tag.php

<?php
    if(class_exists('Jmi') && isset($jmi)) {
        echo $jmi->getMap(array(
            'width'           => '650',
            'height'          => '400',
            'analysisProfile' => 'DiscoveryProfile',
            'attributeId'     => $tag_id, 
            'json_controller' => 'tag_posts',
            'id'              => $tag_id,
            'invert'          => false
            )
        );
    } 
?>

• category.php

<?php
    if(class_exists('Jmi') && isset($jmi)) {
        echo $jmi->getMap(array(
            'width'           => '650',
            'height'          => '400',
            'analysisProfile' => 'GlobalProfile',
            'json_controller' => 'category_posts',
            'id'              => get_query_var('cat'),
            'invert'          => true
            )
        );
    }
?>

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 blog 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.