=== Bluetrait Event Viewer (BTEV) ===
Contributors: mwdmeyer
Tags: admin, btev, events, event viewer, stats, statistics
Requires at least: 2.0.0
Tested up to: 2.1.3
Stable tag: 0.4

This plugin monitors events that occur in your wordpress install.

== Description ==

This plugin monitors events that occur in your wordpress install.

BTEV tracks the following events:

By Default:

* password_reset
* delete_user
* wp_login
* lostpassword_post
* profile_update
* add_attachment
* wp_logout
* user_register
* switch_theme

With wp_login overrride on:

* invalid_username
* invalid_username

== Installation ==

1. Download
1. Unzip (zip contains btev.php)
1. Upload to wp-content/plugins
1. Activate within Wordpress Admin Panel

== Frequently Asked Questions ==

= BTEV isn't tracking failed logins. Why? =

This option needs to be enabled on the settings page (enable wp_login overrride).

== Event API ==

It is possible to add your own events to the event viewer. Simply call the following function when you want add an entry:
        
        btev_trigger_error($error_string, $error_number, __FILE__, __LINE__);
or

        btev_trigger_error($error_string, $error_number);

Argument Descriptions:

1. $error_string: This value can be any string, it is used in the description field in the event viewer
1. $error_number: This value can be one of the following: E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE. These values determine the type of message in the event viewer (Error, Warning, Notice)
1. __FILE__: This is the file where the event occurred, please note __FILE__ is a PHP predefined variable. This value determines the source
1. __LINE__: This is the line where the event occurred, please note __LINE__ is a PHP predefined variable

So an example would be:
        
        btev_trigger_error('Login Successful: "' . $user_login . '"', E_USER_NOTICE);

or
        
        btev_trigger_error('Login Successful: "' . $user_login . '"', E_USER_NOTICE, __FILE__, __LINE__);

NOTE: You should check to make sure that the plugin is active. The easiest way to do this is as follows:

        if (function_exists('btev_trigger_error')) {
        btev_trigger_error('Login Successful: "' . $user_login . '"', E_USER_NOTICE);
        }


== Change Log ==

KEY  
* = Bug fix  
+ = Added feature/function  
- = Something changed (only if not a bug fix)  

Change Log Start

Note: Release Date is DD/MM/YYYY :)

0.4 (Released 07/04/2007)

+++Requires WordPress 2.0.0+++

+New Events Tracked:  
        +Switching Themes  
+Started cron code (not finished)  
+wp_nonce protection stuff.  
+uninstaller  
-removed btev_site table. Two less queries per page now.  
-Updated plugin website link  
-Small code fixes  
-removed btev_site database  

0.3 (Released 01/04/2007)

+Logs file uploads, Logout, Added user, able to override wp_login  
+Able to use set_error_handler  
*fixed Previous/Next Page links  
*stops the file from being run directly  
-cleaned up and commented some code  

0.2 (Released 30/03/2007)

+Date is filled in for an event  
+Update checker  
+More events tracked  
-Moved Event Viewer to link under dashboard  

0.1 (Released 28/03/2007)

+Public release