WordPress GPS

plugin banner

Help people navigate through the WordPress backend thanks to the pretty WordPress Pointers.

Author:Lionel POINTET (profile at wordpress.org)
WordPress version required:3.3.0
WordPress version tested:4.7.23
Plugin version:1.0.16
Added to WordPress repository:22-06-2012
Last updated:05-02-2017
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:0
Rated by:0
Plugin URI:https://github.com/lpointet/wordpress-gps
Total downloads:2 440
Active installs:10+
plugin download
Click to start download

About this plugin

WordPress GPS tries to guide people throughout the WordPress admin jungle. Tell it what you want to do and let it show you the way, with the pretty WP Pointers feature.

Features

This plugin provides an admin panel with a scenario selection. It comes with some default scenarios, which will teach you for example how to:

  • add a new post
  • add a media
  • add an user

Each scenario is defined with capabilities the user must have to play it: if the user doesn’t have these capabilities, the scenario won’t be in the select box.

WordPress GPS is available on Github: https://github.com/lpointet/WordPress-GPS
Please feel free to send me pull requests, issues, evolution requests etc.

API

WordPress GPS provides some hooks to plugin writers:

  • a filter to add, remove or order the default scenarios (gb_gps_default_scenarios)
  • a function to create a new “pointer”: gb_gps_create_pointer
  • a single function to register a new scenario: gb_gps_register_scenario

gb_gps_create_pointer

Usage

$pointer_config = array(
    'selector' => '#menu-posts',
    'content' => '<h3>title</h3><p>content</p>',
    'position' => array(
        'edge' => 'top',
        'align' => 'right',
    ),
);

$pointer = gb_gps_create_pointer($pointer_config);<h3>Parameters</h3>

selector
(string) The DOM selector of the element on which the pointer will be attached.
Default: ”

content
(string) The content of the pointer.
Default: ”

position
(array) An array of arguments to pass to a jQuery UI Position Widget (see the documentation: http://jqueryui.com/demos/position/#options).

gb_gps_register_scenario

Usage

$args = array(
    'pointers' => $pointers,
    'label' => $label,
    'description' => $description,
    'capabilities' => array('edit_post'),
);

gb_gps_register_scenario($args);<h3>Parameters</h3>

pointers
(array) An array of GBGPS_Pointer with this structure: [ ‘hook’ => [ $pointer_obj, $pointer_obj2 ], ‘hook2’ => [ $pointer_obj3 ] ], where “hook” is typically the script’s name on the WordPress admin (‘edit.php’) or the keyword “all”.

label
(string) The scenario label, which will appear on the select box.

description
(string) The scenario description, which will appear on the admin panel.

capabilities
(array) An array of capabilities as defined by WordPress or even plugins (‘edit_post’ for example).


Screenshots
FAQ
ChangeLog