Search:

# CWIS Developers Documentation

# EventLog Class Reference

Class for storing and retrieving event information from database. More...

## Public Member Functions
| EventLog ($DB, $UserId=-1, $LoggingEnabled=TRUE)
| Object constructor.
| Log ($Type, $DataOne="", $DataTwo="")
| Add event to log.
| FindEvents ($StartDate=NULL, $EndDate=NULL, $EventCount=999999999, $EventType)
| Retrieve specified range of events.
| ExcludeUsersWithPrivilegesForFind ($Operator, $Value)
| Add privilege to exclude from FindEvents() results.
| AddSqlConditionForFind ($Conditions)
| Add SQL condition to apply to FindEvents().
| LimitFindToUser ($UserId=NULL)
| Limit FindEvents() results to user with specified ID.
| ModifyEvents ($EventType, $EventDate, $UserId, $DataOne=NULL, $DataTwo=NULL, $Condition=NULL)
| Modify existing events.

List of all members.

## Detailed Description

Class for storing and retrieving event information from database.

Definition at line 22 of file EventLog.php.

Inheritance diagram for EventLog:

[legend]

## Member Function Documentation

EventLog::AddSqlConditionForFind | ( | $ | Conditions | ) |

Add SQL condition to apply to FindEvents().

Multiple conditions are ANDed. Pass in NULL to clear all current conditions.

Parameters:

  | Conditions | String with single condition or array with multiple conditions.

Definition at line 192 of file EventLog.php.

Referenced by LimitFindToUser().

Here is the caller graph for this function:

EventLog::EventLog | ( | $ | DB,
|  | $ | UserId = `-1`,
|  | $ | LoggingEnabled = `TRUE` |
| ) |  |  |

Object constructor.

Parameters:

  | DB | Database object.
  | UserId | ID of current user. (OPTIONAL)
  | LoggingEnabled | Whether event logging is currently enabled. (OPTIONAL, defaults to TRUE)

Definition at line 33 of file EventLog.php.

Referenced by SPTEventLog::SPTEventLog().

Here is the caller graph for this function:

EventLog::ExcludeUsersWithPrivilegesForFind | ( | $ | Operator,
|  | $ | Value |
| ) |  |  |

Add privilege to exclude from FindEvents() results.

Operators should be SQL-compatible (i.e. "=" for equals, not "=="). Multiple operator/value conditions are ORed together. Pass in NULL for Operator and NULL for Value to clear all current exclusions.

Parameters:

  | Operator | Numerical comparison operator to use with privilege (for example: "=", ">", "<=", "!=" etc)..
  | Value | Privilege value to compare.

Definition at line 169 of file EventLog.php.

EventLog::FindEvents | ( | $ | StartDate = `NULL`,
|  | $ | EndDate = `NULL`,
|  | $ | EventCount = `999999999`,
|  | $ | EventType |
| ) |  |  |

Retrieve specified range of events.

Takes a variable number of arguments, with as many EventType parameters as desired. Dates are inclusive.

Parameters:

  | StartDate | Start date of range to search in SQL-compatible format. (OPTIONAL, pass NULL to omit)
  | EndDate | End date of range to search in SQL-compatible format. (OPTIONAL, pass NULL to omit)
  | EventCount | Maximum number of events to retrieve. (OPTIONAL)
  | EventType | Type of event to find. (OPTIONAL)

Returns:
  Array of event records, with each record having the indexes "EventType", "EventDate", "UserId", "DataOne", and "DataTwo".

Definition at line 72 of file EventLog.php.

EventLog::LimitFindToUser | ( | $ | UserId = `NULL` | ) |

Limit FindEvents() results to user with specified ID.

Parameters:

  | UserId | User ID to return results for. (OPTIONAL, defaults to NULL which uses user ID passed in to EventLog())

Definition at line 217 of file EventLog.php.

References AddSqlConditionForFind().

EventLog::Log | ( | $ | Type,
|  | $ | DataOne = `""`,
|  | $ | DataTwo = `""` |
| ) |  |  |

Add event to log.

Parameters:

  | Type | Type of event.
  | DataOne | First data value for event. (OPTIONAL)
  | DataTwo | Second data value for event. (OPTIONAL)

Definition at line 46 of file EventLog.php.

EventLog::ModifyEvents | ( | $ | EventType,
|  | $ | EventDate,
|  | $ | UserId,
|  | $ | DataOne = `NULL`,
|  | $ | DataTwo = `NULL`,
|  | $ | Condition = `NULL` |
| ) |  |  |

Modify existing events.

All parameters are ANDed to select which events are modified.

Parameters:

  | EventType | Code for type of events to modify.
  | EventDate | SQL-compatible date for events to modify.
  | UserId | ID for user for events to modify.
  | DataOne | New value for DataOne field. (OPTIONAL, pass in NULL to not modify field)
  | DataTwo | New value for DataTwo field. (OPTIONAL, pass in NULL to not modify field)
  | Condition | SQL condition to apply to select events to modify.

Definition at line 236 of file EventLog.php.

The documentation for this class was generated from the following file:

- EventLog.php