Concept Discussion: User Actions event model

    @name OnUserAction
    @service 6
    @groupname Users

    @param string action - Name of action (past-tense, lowercase, english) [required]
    @param string object - Name of object action was performed on [optional]
    @param int    user   - ID of user committing the action [optional - defaults to session user id]
    @param string f1..f5 - 5 free text fields that can be used to store other data around the action to allow better filtering of records on output

class modUserAction extends xPDOSimpleObject
    var int     user              - The id of the user who commited the action
    var string  action          - Verb describing the action
    var string  object          - Object action was performed on
    var int     timestamp     - Time action occurred
    var str     f1..f5             - Free text fields storing extra data. Will vary by action type.

    /**
     * Logs a manager action.
     * 
     * @param string $action The action to pull from the lexicon module.
     * @param string $class_key The class key that the action is being performed on.
     * @param mixed $item The primary key id or array of keys to grab the object with.
     * @return modManagerLog The newly created modManagerLog object.
     */
    public function logManagerAction($action, $class_key, $item) {
        $userId = 0;
        if ($this->user instanceof modUser) {
            $userId = $this->user->get('id');
        }
        $ml = $this->newObject('modManagerLog');
        $ml->set('user', (integer) $userId);
        $ml->set('occurred', strftime('%Y-%m-%d %H:%M:%S'));
        $ml->set('action', empty($action) ? 'unknown' : $action);
        $ml->set('classKey', empty($class_key) ? 'unknown' : $class_key);
        $ml->set('item', empty($item) ? 'unknown' : $item);

        if (!$ml->save()) {
            $this->log(modX::LOG_LEVEL_ERROR, $this->lexicon('manager_log_err_save'));
            return null;
        }
        return $ml;
    }