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

Custom Logging Service

外掛說明

This plugin is derived from the no longer supported
WordPress Logging Service.
Despite that it is not compatiple with it, and there is no upgrade path from one
to the other.

Features

  • No log entries generated by the plugin itself, all come from external API calls
  • Organisation of log entries in freetext categories
  • Severity levels
  • Freetext log messages
  • Entries can be marked as seen and then filtered from being displayed again
  • Filtering by minimum severity level
  • Sort by date, category, user name, severity or blog name (in Multisite installations)
  • Access to the log page can be granted by user role

API

Constants

Check to test if the plugin is active:

CLGS = true

Defined severity levels:

CLGS_NOSEVERITY = 0
CLGS_INFO = 1
CLGS_NOTICE = 2
CLGS_WARNING = 3
CLGS_ERROR = 4
CLGS_FATALERROR = 5

Functions

clgs_is_registered ( $category )
  • string $category

returns true if $category is registered.

clgs_register ( $category, $description )

registers $category as a log category. $description will be shown in the
management page.
It is good practice to use unique categories for each plugin that publishes
log messages.

  • string $category At most 190 (unicode) characters
  • string $description can contain HTML same as comments (filtered by
    wp_kses_data)

returns false if the category is already registered or it is too long.

clgs_clear ( $category )

deletes all log entries of $category.

  • string $description existing category

returns number of deleted entries or false if action failed.

clgs_unregister( $category );

deletes all log entries and then removes $category.

  • string $description existing category

returns false if false if action failed.

clgs_log( $category, $text, $severity = null, $user = null, $blog_id = null, $date = null );

writes a new log entry in the specified category

  • string $description a registered category name
  • string $text the logged message, can contain HTML same as comments (filtered
    by wp_kses_data)
  • int $severity one of defined severity levels (see above); if missing defaults to
    CLGS_NOCATEGORY
  • int | string | WP_User $user user id, slug or WP user object are aceptable; if missing
    defaults to current user (or a placeholder if none is logged in)
  • int $blog_id blog id; if missing defaults to current blog
  • int | double | string $date a UNIX timestamp or a string recognized by strtotime();
    if missing defaults to current time

returns false if entering the log failed.

螢幕擷圖

  • Settings screen
  • Log page

安裝方式

  1. Install from Plugins -> Add New
  2. Or download the .zip and extract to wp-content/plugins
  3. Activate the plugin from the Plugins menu. In Multisite installations, feel free
    to activate as a network plugin or to leave it to individual blogs.
  4. Go to Settings -> Custom Logging Service for the next steps

Settings

  • Minimum severity for notification: You will see the number of unseen log entries
    of that level or above next to the menu entry for the log page.
  • Default minimum severity filter: Which severity levels you will see in the log page.
    You can change this filter later on the page.
  • Roles that can manage Custom Logs: Decide who can see and interact with the log page.
  • Log entries per page: Set the number of entries per page.

Generating Log messages

This plugin does not generate any log messages by itself. You need other plugins to
interact with it through the API; see the API section for details.

常見問題集

Where are the logs?

Find them under Dashboard -> Selected Logs.

I can’t find the option to add roles for log management!

If the plugin has been installed network-wide in Multisite, only the Super Admin
has access to the logs. Sorry, I don’t understand role management in Multisite.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Custom Logging Service〉的開發相關工作。

參與者

〈Custom Logging Service〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Custom Logging Service〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

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

變更記錄

1.0.3

Compatibility with WP 4.7

1.0.2

Compatibility with WP 4.6

1.0.1

Compatibility with WP 4.5

1.0.0

First version, derived from zaantar’s
WordPress Logging Service