這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

Sewn In Notifications

描述

A plugin for WordPress that creates a very pluggable framework to add notifications on the front end of your application. Notifications can be generated by query variables or through template functions and actions.

This plugin can be used to create site wide notifications, or you can narrow it down to specific pages.

Add the Notification Center to Your Template(s)

The most basic way to add notifications is sitewide. You can add the “show” action to a template like your header.php file. This is the most powerful use for the plugin: uniform, centralized notifications.

<?php do_action( 'sewn/notifications/show' ); ?>

Create Query Variable Notifications

The simplest way to extend the notification center is to add query variable key/value pairs to generate a new message when url query variables are submitted.

<?php
add_filter( 'sewn/notifications/queries', 'custom_add_query_notifications' );
function custom_add_query_notifications( $queries )
{
    $queries[] = array(
        'key' => 'update',
        'value' => 'true',
        'message' => "Updated.",
        'args' => 'fade=true'
    );
    $queries[] = array(
        'key' => 'update',
        'value' => 'failed',
        'message' => "Unable to update.",
        'args' => 'dismiss=true&error=true'
    );
    $queries[] = array(
        'key' => 'update',
        'value' => 'finished',
        'message' => "Finished!",
        'args' => 'fade=10000' // wait ten seconds before fading
    );
    return $queries;
}
?>

Now whenever a query variable is added to the end of a page, a message can be shown in the notification center.

So http://example.com/path/to/page/?update=true will generate the message: “Updated.” in the notification center.

Arguments for Messages

When adding a message, there are arguments you can use to customize the functionality.

  1. error When set to true, this will add the error class to the message. Default: false
  2. fade When set to true, this will fade the message out after 3 seconds. You can change the pause time by setting fade to a number (in milliseconds). Default: false
  3. dismiss Allows a message to be dismissed by the user with a close button. Default: false
  4. event Allows message to be persistent, so that it shows up on each page load unless dismissed. The event tracks the message and updates the user’s meta when the message is dismissed, so it will stop showing up. Default: false
  5. page Lock a message to a specific page only. When page is set, a is_page($page) check will be performed before showing the message. Particularly useful when setting up query variable pairs. Default: false

Maually Generate Notifications

Add notifications manually anywhere before the show action.

if ( $something_happened ) :
    do_action( 'sewn/notifications/add', $message, $args );
endif;

螢幕截圖

  • A basic example of a notification out of the box.

安裝

  • Install plugin either via the WordPress.org plugin directory, or by uploading the files to your server.
  • Activate the plugin via the Plugins admin page.

常見問題

None yet.

評價

There are no reviews for this plugin.

貢獻者及開發者

“Sewn In Notifications” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。

貢獻者

將 Sewn In Notifications 外掛本地化為台灣繁體中文版。

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

修改日誌

1.1.1 – 2015-06-08

  • Launched in the repo