LogStore is a 'meta' plugin that allows other plugins to log data easily.
Author: | Andre Wyrwa (profile at wordpress.org) |
WordPress version required: | 3.1 |
WordPress version tested: | 3.1.4 |
Plugin version: | 0.1.2 |
Added to WordPress repository: | 28-02-2011 |
Last updated: | 28-02-2011
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: | |
Total downloads: | 1 000 |
Click to start download |
LogStore can be used to log (important) data from within your plugin.
It provides a simple interface to log entries and a friendly administration interface for viewing and managing the log entries.
While LogStore can be used to log debug output or system events, it’s main intention is to log more extensive data, such as:
- system emails sent your users
- data received from remote API calls
Usage
To use LogStore in your plugin, add the following line to your plugin’s ‘plugins_loaded’ callback function:
if (class_exists('LogStore')) $this->log = new LogStore('slug', __('Title'));
- The ‘slug’ should be a unique identifier for your logger.
- The ‘Title’ will be the title used in menu entries, options and page titles.
Once that’s done you can then start logging your data from anywhere within your plugin by using the following:
if (!empty($this->log)) $this->log->log(__('My log message'), $my_log_data, 'status', 'tag');
- ‘My log message.’ is any arbitrary message to describe your log entry.
- $my_log_data is the extended data you want to log. This can be either an array or string.
- ‘status’ is one of ‘none’, ‘ok’, ‘warn’, ‘critical’ or ‘fatal’.
- ‘tag’ can be any kind of singular tag to further classification to your log entries.add
If you use LogStore in your plugin, you should check for it’s presence in
- your ‘plugins_loaded’ callback
- your plugin activation callback
You should either make LogStore use optional or notify the user that they need to install LogStore for your plugin to work properly.
Plugin Hooks
In the following hooks, *myname*
stands for the name with which you instanciated the LogStore class.
Action Hooks
logstore_init-*myname*
– runs during the execution of WP’sinit
action hook, passes a single boolean parameter indicating if logging is active or inactive for this logger
Filter Hooks
logstore_new_entry-*myname*
– runs during the creation of a new entry, passes a single array containing all values for that entry (‘time’, ‘message’, ‘data’, ‘status’ and ‘tag’)logstore_entry-*myname*
– runs before displaying an entry on screen, passes a single array containting all values for the entry (‘time’, ‘message’, ‘data’, ‘status’ and ‘tag’)logstore_format_entry_data-*myname*
– runs before displaying the formatted data on screen, passes the formatted data as string
Further Notes
Please note that the ‘bulk actions’ in the log viewer are currently not
working.
Screenshots
FAQ
ChangeLog