[WordPress] 外掛分享： WordPress GPS

前言介紹

• 這款 WordPress 外掛「WordPress GPS」是 2012-06-21 上架。
• 目前有 10 個安裝啟用數。
• 上一次更新是 2017-02-05，距離現在已有 3010 天。超過一年沒更新，安裝要確認版本是否可用。以及後續維護問題！
• 外掛最低要求 WordPress 3.3.0 以上版本才可以安裝。
• 尚未有人給過這款外掛評分。
• 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。

外掛協作開發者

lpointet |

外掛標籤

help | admin | pointers | scenario | tutorial |

內容簡介

關於這個外掛

WordPress GPS 嘗試導航人們穿越 WordPress 管理後台的叢林。告訴它你想要做什麼，讓它帶領你，搭配漂亮的 WP 指針功能。

功能

這個外掛提供了一個帶有場景選擇的管理面板，預設提供一些場景，包括教你如何：

新增文章
新增媒體
新增使用者
…

每個場景都定義了使用者必須具備的能力：如果使用者沒有這些能力，該場景將不會顯示在選擇框中。

WordPress GPS 可在 Github 上取得：https://github.com/lpointet/WordPress-GPS
請隨意向我提交拉取請求、問題、需求等。

API

WordPress GPS 提供一些外掛程序的鉤子：

一個過濾器，可以新增、刪除或排序預設的場景 (gb_gps_default_scenarios)
一個創建新「指針」的功能：gb_gps_create_pointer
一個單一功能，可以註冊新的場景：gb_gps_register_scenario

gb_gps_create_pointer

使用方式
$pointer_config = array(
'selector' => '#menu-posts',
'content' => '

標題

內容

',
'position' => array(
'edge' => 'top',
'align' => 'right',
),
);

$pointer = gb_gps_create_pointer($pointer_config);

參數

selector
(字串) 要附加指針的 DOM 選取器。
預設值：「#」

content
(字串) 指針的內容。
預設值：「#」

position
(陣列) 傳遞給 jQuery UI 位置小物件的引數的引數 (請參見文件：http://jqueryui.com/demos/position/#options)。

gb_gps_register_scenario

使用方式
$args = array(
'pointers' => $pointers,
'label' => $label,
'description' => $description,
'capabilities' => array('edit_post'),
);

gb_gps_register_scenario($args);

參數

pointers
(陣列) 包含如下結構的 GBGPS_Pointer 陣列：[ 'hook' => [ $pointer_obj, $pointer_obj2 ], 'hook2' => [ $pointer_obj3 ] ]，其中「hook」通常是 WordPress 管理後台的腳本名稱 ('edit.php' 等) 或關鍵字「all」。

label
(字串) 場景標籤，會顯示在選擇框中。

description
(字串) 場景描述，會顯示在管理面板中。

capabilities
(陣列) 包含 WordPress 或其他外掛定義的能力 (例如 'edit_post') 的陣列。

原文外掛簡介

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' => '

title

content

',
'position' => array(
'edge' => 'top',
'align' => 'right',
),
);

$pointer = gb_gps_create_pointer($pointer_config);

Parameters

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);

Parameters

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

各版本下載點

• 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
• 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「WordPress GPS」來進行安裝。

（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。

---

1.0.1 | 1.0.2 | 1.0.3 | 1.0.4 | 1.0.5 | 1.0.6 | 1.0.7 | 1.0.8 | 1.0.9 | trunk | 1.0.10 | 1.0.11 | 1.0.13 | 1.0.14 | 1.0.15 | 1.0.16 |

延伸相關外掛（你可能也想知道）

• Disable Pointers 》當 WordPress 增加新功能時，管理介面上會顯示各種有用的提示（工具提示）以協助使用者操作。此簡單外掛可讓所有使用者停用這些提示。無需設定，只需安裝並啟...。