Title: Activity Logs
Author: tbuteler
Published: <strong>5 сар 25, 2013</strong>
Last modified: 5 сар 25, 2013

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/activity-logs.svg)

# Activity Logs

 By [tbuteler](https://profiles.wordpress.org/tbuteler/)

[Download](https://downloads.wordpress.org/plugin/activity-logs.1.1.zip)

 * [Details](https://mn.wordpress.org/plugins/activity-logs/#description)
 * [Reviews](https://mn.wordpress.org/plugins/activity-logs/#reviews)
 *  [Installation](https://mn.wordpress.org/plugins/activity-logs/#installation)
 * [Development](https://mn.wordpress.org/plugins/activity-logs/#developers)

 [Support](https://wordpress.org/support/plugin/activity-logs/)

## Description

The Activity Logs plugin will record most of the changes that occur in your WordPress
blog or multisite network, making it easy for you to keep on track of what everyone
is doing, or to catch up on what happened since you last checked in.

It’s a very simple to use plugin (though it offers good extensibility to advanced
users and plugin authors): just activate it and the logs will be recorded automatically,
and an activity stream will appear on your dashboard.

The Activity Logs plugin keeps track of post, pages, custom post types and comments
transitions, settings changes, plugin activations, import, export, user and site
management in a simple, seamless way.

### Feedback and Support

Comments are welcome. You can contact me directly via tbuteler@gmail.com.
 If you
think you’ve found a bug, or you want to make this plugin better, go to [GitHub](https://github.com/tbuteler/ck_activity_logs).
Did you find this helpful? Did it save you precious programming time? Please consider
[donating](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5H36WT4G7XBKQ).

## Screenshots

 * [[
 * The Activity Log widget rendered on the default dashboard.

## Installation

 1. Unpackage contents to your wp-content/plugins/ directory;
 2. Activate the plugin through the ‘Plugins’ menu in WordPress;
 3. That’s it! The plugin will install required tables and configure itself on first
    run.

## FAQ

### I don’t see a settings page for this plugin. Can I configure it somehow?

A little bit, yes. Although the idea is to allow users to install and forget, admins
have some configuration options available. To do so, define the constants below 
in your `wp-config.php` file (or anywhere else, as long as they’re defined before
the `init` action takes place).

Values defined here are the plugins defaults, which can be overriden.

Time range, in seconds, that will cause our activity log to ignore repeat actions.
Note that activity will still be logged, but won’t be displayed in the dashboard:

    ```
    // Logs 60 seconds apart will be treated as the same action (same type, same logger only)
    define('CK_LOG_TIME_IGNORE', 60);
    ```

Maximum number of rows reserved for activity logs in custom table:

    ```
    // 0 means no limit
    define('CK_LOG_MAX_ROWS', 0);
    ```

Amount of logs to load on dashboard widget at a time:

    ```
    define('CK_LOG_DEFAULT_LIMIT', 25);
    ```

### Can I create my own loggers?

Yes. There are many filters and actions to hook into, but the default loggers take
into account core functionality only. This includes custom post types, but not custom
functionality which most plugins add to WordPress. Luckily, you can easily set your
own loggers by using the following function:

    ```
    cookspin_register_logger(
        $name,      // A slug-like name for this logger, shorter than 255 characters
        $category,  // A slug-like name for the logger's category. For the default list, see below
        $args       // See below
    );
    ```

Here are the default categories (and slugs) for loggers. These are meant to mimick
the default sections of the WordPress admin menu. Your custom logger can go into
any of these, and you can create your own categories as well (though you will have
to specify labels and CSS / icons via filters):

 1. Sites: `blogs`
 2. Posts: `posts`
 3. Media: `media`
 4. Users: `users`
 5. Settings: `preferences`
 6. Appearance: `comments`
 7. Plugins: `appearance`
 8. Tools: `tools`

The third and final argument of the function is actually an array of arguments. 
Let’s go through the options one by one. (Note that omitting “required” arguments
might not cause the function to fail, but will prevent the log from displaying properly.)

 1. `hook` (string)(required): Which action should we hook to? Every time it fires,
    our log will record an entry. **Important:** If you’re hooking to filters and not
    actions, set the `hook_to_filter` argument to `true`
 2. `priority` (integer)(optional): Priority of the logger function compared to all
    other functions hooked to this action.
 3. `n_params` (integer)(optional): How many arguments does the logger function need
    from the action? If more than one, this has to be specified.
 4. `cb` (string)(required): The actual callback which will define what information
    gets recorded on the database.
 5. `print_cb` (string)(required): A callback which is used to generate a readable 
    version of the log.
 6. `hook_to_filter` (boolean)(optional): Do you want to log something everytime a 
    _filter_ is applied? You can do that too, but you **need to set this to true**.
    Failure to do so will prevent the filter you’re hooking to from working properly,
    and can break stuff.
 7. `ignore_cmp` (string or array of strings)(optional): Sometimes ignoring logs based
    on the time they were recorded is not enough to prevent you from showing actions
    which have no actual impact. Here you can specify any of the following, which correspond
    to the activity log’s table columns: ‘object_type’, ‘object_id’, ‘log_code’, ‘user_id’.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Activity Logs” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ tbuteler ](https://profiles.wordpress.org/tbuteler/)

[Translate “Activity Logs” into your language.](https://translate.wordpress.org/projects/wp-plugins/activity-logs)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/activity-logs/), check
out the [SVN repository](https://plugins.svn.wordpress.org/activity-logs/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/activity-logs/) 
by [RSS](https://plugins.trac.wordpress.org/log/activity-logs/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1

 * Initial public release.

## Meta

 *  Version **1.1**
 *  Last updated **13 жил ago**
 *  Active installations **20+**
 *  WordPress version ** 3.0.1 or higher **
 *  Tested up to **3.5.2**
 *  Language
 * [English (US)](https://wordpress.org/plugins/activity-logs/)
 * Tag
 * [activity](https://mn.wordpress.org/plugins/tags/activity/)
 *  [Advanced View](https://mn.wordpress.org/plugins/activity-logs/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/activity-logs/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/activity-logs/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/activity-logs/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/activity-logs/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/activity-logs/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/activity-logs/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/activity-logs/reviews/)

## Contributors

 *   [ tbuteler ](https://profiles.wordpress.org/tbuteler/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/activity-logs/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5H36WT4G7XBKQ)