[WordPress] 外掛分享： RHJ4 Notifications

前言介紹

• 這款 WordPress 外掛「RHJ4 Notifications」是 2014-09-19 上架。
• 目前尚無安裝啟用數，是個很新的外掛。如有要安裝使用，建議多測試確保功能沒問題！
• 上一次更新是 2014-09-23，距離現在已有 3876 天。超過一年沒更新，安裝要確認版本是否可用。以及後續維護問題！
• 外掛最低要求 WordPress 3.0.1 以上版本才可以安裝。
• 尚未有人給過這款外掛評分。
• 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。

外掛協作開發者

rhj4 |

外掛標籤

popups | diagnostics | Error Messages | user interface |

內容簡介

RHJ4 Notifications 和它的姊妹產品 RHJ4 Diagnostics 解決了長期困擾軟體開發者的問題：如何在程式任何地方顯示清晰、明確、視覺上一致的訊息給使用者。

通知訊息可以從瀏覽器的 jQuery 代碼或伺服器端的 PHP 代碼傳送。任何一種訊息都可以立即顯示或在下一個頁面載入後排入佇列顯示。

通知會在螢幕右下角以彈出視窗出現，使用者可以直接點擊或在5秒後消失。

透過這個外掛，只需要一行 PHP 代碼就可以輕鬆傳送訊息：

rhj4_notification('警告！危險，威爾森機器人！', NOTIFICATION_TYPE_WARNING);

同樣的訊息也可以由在瀏覽器上執行的 jQuery 代碼傳送：

jQuery.notification('警告！危險，威爾森機器人！',
jQuery.notification.type('warning'));

通知訊息預設會在5秒後從螢幕上消失；但是，如果要讓通知訊息固定顯示，可以在 PHP 或 jQuery 函數的第三個參數中加入 true：

jQuery.notification('警告！危險，威爾森機器人！',
jQuery.notification.type('warning'), true);

通知可以立即顯示或排入佇列，以便稍後顯示。當啟用外掛時，會建立 wp_notifications 資料表。要 "啟用" 這個外掛，請查看設定並勾選 "啟用" 核取方塊。

RHJ4 Notifications 支援15種通知類型。

使用方法

通知訊息包括以下三個部分：

訊息 — 提示訊息內容。
通知類型 — 在 -1..13 範圍內的整數，表示通知的樣式。
固定 — 表示訊息是否在幾秒後消失，或是先維持在螢幕上。

通知類型

以下常數位於全域命名空間：

NOTIFICATION_TYPE_DIAGNOSTIC = -1;
NOTIFICATION_TYPE_LOG = 0;
NOTIFICATION_TYPE_SYSTEM = 1;
NOTIFICATION_TYPE_ERROR = 2;
NOTIFICATION_TYPE_WARNING = 3;
NOTIFICATION_TYPE_CONFIRMATION = 4;
NOTIFICATION_TYPE_MESSAGE = 5;
NOTIFICATION_TYPE_TEST = 6;
NOTIFICATION_TYPE_DATA = 7;
NOTIFICATION_TYPE_COMMENT = 8;
NOTIFICATION_TYPE_TIP = 9;
NOTIFICATION_TYPE_REMINDER = 10;
NOTIFICATION_TYPE_DATE = 11;
NOTIFICATION_TYPE_VALIDATION = 12;
NOTIFICATION_TYPE_TIMER = 13;

通知外掛提供四種不同的介面：

全域函數
類別方式
jQuery 外掛
簡碼

PHP 全域函數
建立通知
rhj4_notification($message, $type = NOTIFICATION_TYPE_MESSAGE, $sticky = FALSE);

PHP 類別方式
RHJ4Notifications::instance()

返回此外掛的實例。多處程式碼都可以使用相同的實例，而不必每次都重新初始化外掛。

範例：

$myInstance = RHJ4Notifications::instance()

init($args)

初始化外掛，使用任何

原文外掛簡介

RHJ4 Notifications and its sibling, RHJ4 Diagnostics solve problems that have plagued programmers for years: How to communicate with users in a clean, clear and visually consistent fashion regardless of where in the program the message originates.
A notification message can be sent from jQuery code in the browser or from PHP code in the server. Either type of message can be displayed immediately or queued for display after the next page turn.
Notifications appear as popup messages on the bottom right corner of the screen and can stay on the screen until the user clicks on them or they can disappear after five seconds.
Using this plugin, a message can be sent easily from a single line of PHP code:
rhj4_notification('Warning! Danger, Will Robinson!', NOTIFICATION_TYPE_WARNING);

The same messsage can be sent from jQuery code running in the browser:
jQuery.notification('Warning! Danger, Will Robinson!',
jQuery.notification.type('warning'));

By default, notifications will disappear from the screen after five seconds; however, to make a notification “sticky”, add true as the third argument to either the PHP or jQuery functions:
jQuery.notification('Warning! Danger, Will Robinson!',
jQuery.notification.type('warning'), true);

Notifications can be displayed immediately or queued in the wp_notifications table for display later. The wp_notifications table is created when the plugin is enabled. To “enable” this plugin, see Settings and click on the “Enable” checkbox.
RHJ4 Notifications supports 15 types of notifications
Usage
A notification consists of a:

Message – some text to be shown to the user.
Notification Type – an integer in the range -1..13 that indicates the style of the notification.
Sticky – a boolean that indicates whether the message should disappear after a few seconds or “stick” around.

Notification Types
These constants are in the global name space:

NOTIFICATION_TYPE_DIAGNOSTIC = -1;
NOTIFICATION_TYPE_LOG = 0;
NOTIFICATION_TYPE_SYSTEM = 1;
NOTIFICATION_TYPE_ERROR = 2;
NOTIFICATION_TYPE_WARNING = 3;
NOTIFICATION_TYPE_CONFIRMATION = 4;
NOTIFICATION_TYPE_MESSAGE = 5;
NOTIFICATION_TYPE_TEST = 6;
NOTIFICATION_TYPE_DATA = 7;
NOTIFICATION_TYPE_COMMENT = 8;
NOTIFICATION_TYPE_TIP = 9;
NOTIFICATION_TYPE_REMINDER = 10;
NOTIFICATION_TYPE_DATE = 11;
NOTIFICATION_TYPE_VALIDATION = 12;
NOTIFICATION_TYPE_TIMER = 13;

There are four different interfaces available in the Notifications plugin:

Global Functions
Class Methods
jQuery plugin
Short Codes

PHP Global Functions
Generate a notification
rhj4_notification($message, $type = NOTIFICATION_TYPE_MESSAGE, $sticky = FALSE);

PHP Class Methods
RHJ4Notifications::instance()
Return an instance of this plugin. This usage allows code in multiple places to use the same instance without having to reinitialize the plugin every time.
Example:
$myInstance = RHJ4Notifications::instance()

init($args)
Initialize plugin using any of the options defined in $args (see “options” for a list of supported options).
kill()
Kill the current instance.
activate()
Activate this plugin.
deactivate()
Deactivate this plugin.
options ($options = null)
Validate options and return valid array. The supported options are:
–enable: enable generation of diagnostic messages.
–log = {true|false}: enable log notifications
–system = {true|false}: enable system notifications
–error = {true|false}: enable error notifications
–warning = {true|false}: enable warning notifications
–confirmation = {true|false}: enable confirmation notifications
–message = {true|false}: enable message notifications
–test = {true|false}: enable test notifications
–data = {true|false}: enable data notifications
–comment = {true|false}: enable comment notifications
–tip = {true|false}: enable tip notifications
–reminder = {true|false}: enable reminder notifications
–date = {true|false}: enable date notifications
–validation = {true|false}: enable validation notifications
–timer = {true|false}: enable timer notifications
set($options = NULL)
Establish default options and save them in wp_options. See “options” for a list of supported options.
reset()
Reset options to their default values.
enable()
Enable this plugin. This function requires admin privileges and should only be called when setting up a site. It creates a database table (first deleting if if it exists) that stores queued notifications.
This function can be accessed from the settings panel or called directly in your code.
All notifications are stored (temporarily) in a common database table that is keyed by Session ID.
save($message_text, $message_type = 1, $is_sticky = 0)
Save a message for display on next page turn or explicit call from jQuery.
@param int $message_type
@param bool $is_sticky
@param string $message_text

delete_user_notifications ($user_id = null)
Delete all notifications for $user_id.
delete_session_notifications ()
Remove all notifications for the current session.
delete_all_notifications ()
Clear notifications table of all pending notifications.
user_queue_size()
list_user_notifications($delete = TRUE)
Return list of all notifications pending for $user_id.
session_queue_size()
list_session_notifications($delete = TRUE)
Return a list of all pending notifications for the current session.
list_all_notifications($delete = TRUE)
Return a list of all notifications.
jQuery Plugin API
The jQuery code included in this plugin is implemented as a jQuery plugin with the class name of “jQuery.notification”.
The functions supported by this class are:
notification(message, type, isSticky, pluginurl)
–message (required) may be a string or an object.
If it is a string, the string is the notification text to be displayed.
If it is an object, the object may contain properties corresponding to any of the options supported by the jQuery.options method.
_type (optional) indicates the notification type as either a string or an integer. If missing, type will use the current option.type value.
_isSticky (optional) indicates whether the notification is sticky. If missing, isSticky will use the value from msgType.
_pluginurl (optional) indicates the url to be called by this function to communicate with the server. If missing, the code will search for a hidden field named #hid_plugin_url.
Examples:
jQuery.notification('This is a notification',3,true);

jQuery.notification({ notification: 'This is a notification',
type: "data",
sticky: true,
queue: false });

defaults
Returns an object containing the default values of all options used by this plugin:
version: version, // code version
type: 'log', // default message type
sticky: true, // if true, don't clear the message automatically
queue: false, // If true, queue the message for later display
class: '', // jGrowl class that styles this message
clear: true, // Delete saved messages after showing them
showOnConsole: true,// Show a copy of the message on the console.log
glue: 'after', // jGrowl property that controls order of displaying messages
sleep:, // sleep in milliseconds before displaying message
closeTemplate: // image to use in close template
header: // '',
notification: '' // Message can be included with options

sleep()
Set notification sleep delay in milliseconds. This value will be remembered by all subsequent calls to $.Notification.
option (key, value)
Get/Set single option:
-version: (read only)
-type: notification type (string or number)
-sticky: boolean
-queue: boolean – save messages in database until explicit request to drain queue
-clear: boolean – clear queue
save (message, code, sticky, handler)
-message: the notification text
-code: notification type
-sticky: stick around for awhile or scram
-handler: (optional) custom function to handle displaying the notification.
messageType (code)
Returns array of messageType objects.
type (type)
Validate notification type value
getSessionId()
Get current session id.
getPluginURL()
Return URL of AJAX handler function.
queue (handler)
Return count of notifications awaiting delivery.
show (clear)
Show all messages in the queue. If clear===true, delete all messages just just retrieved.
erase()
Close any open notification messages on screen.
clear()
Delete all messages to the current session.
showUser (userId)
Notifications can be sent to a specific userId. The messages will be held until that user logs in.
clearUser (userId)
Delete all user notifications from database.
Short Codes

enable=1,3,6 will enable notification types 1,3 and 6.

notify message= type= sticky={true|false}

verbose will cause actions to be echoed on the page.

demo will display a demonstration of using the Notifications plugin.

SUPPORT
I will attempt to answer your email as quickly as I can, but cannot promise immediate response.
I will entertain ideas for enhancements, especially if I hear the same request from multiple people.
Donations will encourage my support… and my thanks.
CONSULTING
I make my living by helping WordPress developers. If I can help you, please contact me.
Bob Jones
[email protected]
http://bellinghamwordpressdevelopers.com/

各版本下載點

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

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

---

最新版本

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

• Display wp_mail Error Messages 》顯示 wp_mail 錯誤訊息, 許多外掛使用 WordPress 函式 wp_mail 來寄送郵件。當發生錯誤時，很難找到問題所在。這個外掛會捕捉 wp_mail 錯誤訊息並顯示它們。,...。
• SC Custom Login 》一個非常簡單的方式來客製化您的登入頁面, 此外掛會自動嵌入以下功能:, , 客製化登入錯誤訊息, 客製化 logo 的網址, 客製化 logo 的標題屬性, 客製化背景 (即...。