myCRED_History Object

myCRED_History

Codex / mycred/log / Objects / myCRED_History

Description

This object contains log related data for a given myCRED balance. It contains an array of data to help with certain history checks, such as checking if a user got a record of getting points for a certain object ID (e.g. post or page).

Note that this object is not available if the Log module has been disabled!

Available since version 1.8

Object Properties

Note that the constructor class will auto populate these values when the class is constructed.

	Property	Type	Description
`myCRED_History Object (`
	public `$has_history`	bool	Indicates if a given user has any log entries in the database.
	public `$should_log`	bool	Indicates if the given users actions should be logged.
	public `$data`	array	An associative array of log entry data that belongs to the user. These log entries are grouped by reference, with the following data being available for each one: `rows` The total number of log entries that exists for this reference and user. `reference` The reference key. `total` The sum of all log entries added up for this reference and user. `last_entry` The timestamp of the latest log entry for this reference and user. `reference_ids` An array of reference IDs amongst the log entries for this reference and user. Note that this array will only contain unique integers.
	public `$total_data`	int	The total number of log entries that exists in the database for the given user.
`)`

Object Methods

	Variable	Type	Required	Description
public function `__construct( $user_id = NULL, $point_type = MYCRED_DEFAULT_TYPE_KEY )` {
	Description:	Constructs the history object for a specific user and for a specific point type.
	`$user_id`	int	Yes	The users numeric ID.
	`$point_type`	string	Yes	The point type key.
}

	Variable	Type	Required	Description
public function `update_data( $reference = '', $value = '' )` {
	Description:	Updates the data array for a given reference. Note that this only updates the object values, it does not actually save the given value anywhere, that should be done before using this method.
	`$reference`	string	Yes	The reference key to update.
	`$value`	array	Yes	The actual data to add to the given reference.
}

Object Example

myCRED_History Object
(
    [has_history] => 1
    [should_log] => 1
    [data] => Array
        (
            [buy_scratch_card] => stdClass Object
                (
                    [rows] => 10
                    [reference] => buy_scratch_card
                    [total] => -100
                    [last_entry] => 1505848450
                    [reference_ids] => Array
                        (
                            [0] => 149
                            [1] => 48
                        )
                )
            [win_scratch_card] => stdClass Object
                (
                    [rows] => 1
                    [reference] => win_scratch_card
                    [total] => 500
                    [last_entry] => 1498573857
                    [reference_ids] => Array
                        (
                            [1] => 48
                        )
                )
        )
    [total_data] => 11
)