WordPress.org

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.
2. $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).
3. __FILE__: This is the file where the event occurred, please note __FILE__ is a PHP predefined variable. This value determines the source.
4. __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);
    }