vBulletin v6.1.0

vB_DataManager_Moderator extends vB_DataManager
in package

vBulletin

Class to do data save/delete operations for MODERATORS

Example usage (inserts a new moderator):

$f = new vB_DataManager_Moderator(); $f->set_info('moderatorid', 12); $f->save();

Properties

$bitfields : array<string|int, mixed>: Array of field names that are bitfields, together with the name of the variable in the registry with the definitions.
$condition : string: Condition to be used. Can be either ['keyfield' => 'value'] or a valid assertor vB_dB_Query::CONDITIONS_KEY setting.
$config : mixed
$error_handler : string: The error handler for this object
$errors : array<string|int, mixed>: Array to store any errors encountered while building data
$existing : array<string|int, mixed>: Array to store existing data
$info : array<string|int, mixed>: Array to store information
$moderator : array<string|int, mixed>: Array to store stuff to save to moderator table
$table : string: The main table this class deals with

Methods

__construct() : mixed: Constructor - checks that the registry object has been passed correctly.
__serialize() : array<string|int, mixed>
__sleep() : array<string|int, mixed>
__unserialize() : void
__wakeup() : void
check_required() : bool: Checks through the required fields for this object and ensures that all required fields have a value
db_insert() : int: Creates and runs an INSERT query to save the data from the object into the database
db_update() : bool: Creates and runs an UPDATE query to save the data from the object into the database
delete() : mixed: Deletes a moderator
do_set() : mixed: Takes valid data and sets it as part of the data to be saved
do_unset() : mixed: Unsets a values that has already been set
error() : mixed: Shows an error message and halts execution
fetch_field() : mixed: Fetches info about the current data object - if a new value is set, it returns this, otherwise it will return the existing data
get_errors() : array<string|int, mixed>: Returns the array of errors
get_exception() : mixed
has_errors() : bool: Check if the DM currently has errors. Will kill execution if it does and $die is true.
is_bitfield_set() : bool: Determines if a bitfield value has been set
is_field_defined() : mixed
is_field_set() : mixed: Determines if a field is set
post_save_each() : mixed: Additional data to update after a save call (such as denormalized values in other tables).
post_save_once() : mixed: Additional data to update after a save call (such as denormalized values in other tables).
pre_save() : bool: Any checks to run immediately before saving. If returning false, the save will not take place.
save() : mixed: Saves the data from the object into the specified database tables
set() : bool: Overriding version of the set() function to deal with the selecting userid from username
set_bitfield() : bool: Sets a bit in a bitfield
set_condition() : mixed: Sets the condition to be used in WHERE clauses, based upon the $this->existing data and the $this->condition_constuct condition template.
set_existing() : bool: Sets the existing data
set_info() : mixed: Rather like set(), but sets data into the $this->info array instead. Use setr_info if $value if a reference to value is to be passed
setr() : bool: Sets the supplied data to be part of the data to be saved
setr_info() : mixed: Rather like set(), but sets reference to data into the $this->info array instead
update_user_failed_insert() : mixed: Callback function that is hit when inserting a new moderator, and his/her usergroup or member groups fail to be changed.
verify() : bool: Verifies that the supplied data is one of the fields used by this object
verify_date_array() : bool: Verifies a date array as a valid unix timestamp
verify_email() : bool: Verifies that an email address is valid
verify_link() : bool: Verifies that a hyperlink is valid
verify_md5() : bool: Verifies that a string is an MD5 string
verify_nodeid() : bool: Verifies that the specified node exists
verify_permissions() : bool: Converts an array of 1/0 options into the permissions bitfield
verify_permissions2() : bool: Converts an array of 1/0 options into the permissions bitfield
verify_userid() : bool: Verifies that the specified user exists
verify_username() : bool: Verifies that the provided username is valid, and attempts to correct it if it is not valid

$bitfields

Array of field names that are bitfields, together with the name of the variable in the registry with the definitions.


    public
        array<string|int, mixed>
    $bitfields
     = ['permissions' => 'bf_misc_moderatorpermissions', 'permissions2' => 'bf_misc_moderatorpermissions2']

$condition

Condition to be used. Can be either ['keyfield' => 'value'] or a valid assertor vB_dB_Query::CONDITIONS_KEY setting.


    public
        string
    $condition
     = \null

$config


    public
        mixed
    $config
     = []

$error_handler

The error handler for this object


    public
        string
    $error_handler
     = \vB_DataManager_Constants::ERRTYPE_STANDARD

$errors

Array to store any errors encountered while building data


    public
        array<string|int, mixed>
    $errors
     = []

$existing

Array to store existing data


    public
        array<string|int, mixed>
    $existing
     = []

$info

Array to store information


    public
        array<string|int, mixed>
    $info
     = []

$moderator

Array to store stuff to save to moderator table


    public
        array<string|int, mixed>
    $moderator
     = []

$table

The main table this class deals with


    public
        string
    $table
     = 'vBForum:moderator'

__construct()

Constructor - checks that the registry object has been passed correctly.


    public
                    __construct([mixed $registry = null ][, mixed $errtype = null ]) : mixed

Parameters

$registry : mixed = null: -- Instance of the vBulletin data registry object - expected to have the database object as one of its $this->db member.
$errtype : mixed = null: --One of the ERRTYPE_x constants

__serialize()


    public
                    __serialize() : array<string|int, mixed>

Return values

array<string|int, mixed>

__sleep()


    public
                    __sleep() : array<string|int, mixed>

Return values

array<string|int, mixed>

__unserialize()


    public
                    __unserialize(array<string|int, mixed> $serialized) : void

Parameters

$serialized : array<string|int, mixed>

__wakeup()


    public
                    __wakeup() : void

check_required()

Checks through the required fields for this object and ensures that all required fields have a value


    public
                    check_required() : bool

Return values

bool —

Returns true if all required fields have a valid value set

db_insert()

Creates and runs an INSERT query to save the data from the object into the database


    public
                    db_insert(mixed $tableprefix, mixed $table[, mixed $doquery = true ][, mixed $replace = false ]) : int

Parameters

$tableprefix : mixed
$table : mixed
$doquery : mixed = true
$replace : mixed = false

Return values

int —

Returns the ID of the inserted record

db_update()

Creates and runs an UPDATE query to save the data from the object into the database


    public
                    db_update(mixed $tableprefix, mixed $table[, mixed $condition = null ][, mixed $doquery = true ][, mixed $delayed = false ][, mixed $affected_rows = false ]) : bool

Parameters

$tableprefix : mixed
$table : mixed
$condition : mixed = null
$doquery : mixed = true
$delayed : mixed = false
$affected_rows : mixed = false

Return values

bool —

Returns true on success

delete()

Deletes a moderator


    public
                    delete([mixed $doquery = true ]) : mixed

Parameters

$doquery : mixed = true

Return values

mixed —

The number of affected rows

do_set()

Takes valid data and sets it as part of the data to be saved


    public
                    do_set(mixed $fieldname, mixed &$value[, mixed $table = null ]) : mixed

Parameters

$fieldname : mixed
$value : mixed
$table : mixed = null

do_unset()

Unsets a values that has already been set


    public
                    do_unset(mixed $fieldname[, mixed $table = null ]) : mixed

Parameters

$fieldname : mixed
$table : mixed = null

error()

Shows an error message and halts execution


    public
                    error(mixed $errorphrase) : mixed

Parameters

$errorphrase : mixed

fetch_field()

Fetches info about the current data object - if a new value is set, it returns this, otherwise it will return the existing data


    public
                &    fetch_field(mixed $fieldname[, mixed $table = null ]) : mixed

Parameters

$fieldname : mixed
$table : mixed = null

Return values

mixed —

The requested data

get_errors()

Returns the array of errors


    public
                    get_errors() : array<string|int, mixed>

Return values

array<string|int, mixed> —

get_exception()


    public
                    get_exception() : mixed

has_errors()

Check if the DM currently has errors. Will kill execution if it does and $die is true.


    public
                    has_errors([mixed $die = true ]) : bool

Parameters

$die : mixed = true

Return values

bool —

True if there are errors, false otherwise

is_bitfield_set()

Determines if a bitfield value has been set


    public
                    is_bitfield_set(mixed $fieldname, mixed $bitname) : bool

Parameters

$fieldname : mixed
$bitname : mixed

Return values

bool

is_field_defined()


    public
                    is_field_defined(mixed $fieldname) : mixed

Parameters

$fieldname : mixed

is_field_set()

Determines if a field is set


    public
                    is_field_set(mixed $field) : mixed

Parameters

$field : mixed

post_save_each()

Additional data to update after a save call (such as denormalized values in other tables).


    public
                    post_save_each([mixed $doquery = true ]) : mixed

Parameters

$doquery : mixed = true

post_save_once()

Additional data to update after a save call (such as denormalized values in other tables).


    public
                    post_save_once([mixed $doquery = true ]) : mixed

In batch updates, is executed once after all records are updated.

Parameters

$doquery : mixed = true

pre_save()

Any checks to run immediately before saving. If returning false, the save will not take place.


    public
                    pre_save([mixed $doquery = true ]) : bool

Parameters

$doquery : mixed = true

Return values

bool —

True on success; false if an error occurred

save()

Saves the data from the object into the specified database tables


    public
                    save([mixed $doquery = true ][, mixed $delayed = false ][, mixed $affected_rows = false ][, mixed $replace = false ]) : mixed

Parameters

$doquery : mixed = true
$delayed : mixed = false
$affected_rows : mixed = false
$replace : mixed = false

Return values

mixed —

If this was an INSERT query, the INSERT ID is returned

set()

Overriding version of the set() function to deal with the selecting userid from username


    public
                    set(mixed $fieldname, mixed $value[, mixed $clean = true ][, mixed $doverify = true ][, mixed $table = null ]) : bool

Parameters

$fieldname : mixed
$value : mixed
$clean : mixed = true
$doverify : mixed = true
$table : mixed = null

Return values

bool —

Returns true on success

set_bitfield()

Sets a bit in a bitfield


    public
                    set_bitfield(mixed $fieldname, mixed $bitname, mixed $onoff) : bool

Parameters

$fieldname : mixed
$bitname : mixed
$onoff : mixed

Return values

bool

set_condition()

Sets the condition to be used in WHERE clauses, based upon the $this->existing data and the $this->condition_constuct condition template.


    public
                    set_condition([mixed $params = null ]) : mixed

Parameters

$params : mixed = null

set_existing()

Sets the existing data


    public
                    set_existing(mixed $existing) : bool

Parameters

$existing : mixed

Return values

bool —

Returns true if successful

set_info()

Rather like set(), but sets data into the $this->info array instead. Use setr_info if $value if a reference to value is to be passed


    public
                    set_info(mixed $fieldname, mixed $value) : mixed

Parameters

$fieldname : mixed
$value : mixed

setr()

Sets the supplied data to be part of the data to be saved


    public
                    setr(mixed $fieldname, mixed &$value[, mixed $clean = true ][, mixed $doverify = true ]) : bool

Parameters

$fieldname : mixed
$value : mixed
$clean : mixed = true
$doverify : mixed = true

Return values

bool —

Returns false if the data is rejected for whatever reason

setr_info()

Rather like set(), but sets reference to data into the $this->info array instead


    public
                    setr_info(mixed $fieldname, mixed &$value) : mixed

Parameters

$fieldname : mixed
$value : mixed

update_user_failed_insert()

Callback function that is hit when inserting a new moderator, and his/her usergroup or member groups fail to be changed.


    public
                    update_user_failed_insert(mixed &$user) : mixed

Parameters

$user : mixed

verify()

Verifies that the supplied data is one of the fields used by this object


    public
                    verify(mixed $fieldname, mixed &$value[, mixed $doverify = true ]) : bool

Also ensures that the data is of the correct type, and attempts to correct errors in the supplied data.

Parameters

$fieldname : mixed
$value : mixed
$doverify : mixed = true

Return values

bool —

Returns true if the data is one of the fields used by this object, and is the correct type (or has been successfully corrected to be so)

verify_date_array()

Verifies a date array as a valid unix timestamp


    public
                    verify_date_array(mixed &$date) : bool

Parameters

$date : mixed

Return values

bool

verify_email()

Verifies that an email address is valid


    public
                    verify_email(mixed &$email) : bool

Parameters

$email : mixed

Return values

bool

verify_link()

Verifies that a hyperlink is valid


    public
                    verify_link(mixed &$link[, mixed $strict = false ]) : bool

Parameters

$link : mixed
$strict : mixed = false

Return values

bool

verify_md5()

Verifies that a string is an MD5 string


    public
                    verify_md5(mixed &$md5) : bool

Parameters

$md5 : mixed

Return values

bool

verify_nodeid()

Verifies that the specified node exists


    public
                    verify_nodeid(mixed &$nodeid) : bool

Parameters

$nodeid : mixed

Return values

bool —

Returns true if node exists

verify_permissions()

Converts an array of 1/0 options into the permissions bitfield


    public
                    verify_permissions(mixed &$permissions) : bool

Parameters

$permissions : mixed

Return values

bool —

Returns true on success

verify_permissions2()

Converts an array of 1/0 options into the permissions bitfield


    public
                    verify_permissions2(mixed &$permissions) : bool

Parameters

$permissions : mixed

Return values

bool —

Returns true on success

verify_userid()

Verifies that the specified user exists


    public
                    verify_userid(mixed &$userid) : bool

Parameters

$userid : mixed

Return values

bool —

Returns true if user exists

verify_username()

Verifies that the provided username is valid, and attempts to correct it if it is not valid


    public
                    verify_username(mixed &$username) : bool

Parameters

$username : mixed

Return values

bool —

Returns true if the username is valid, or has been corrected to be valid

vB_DataManager_Moderator extends vB_DataManager in package vBulletin

Tags

Table of Contents

Properties

Methods

Properties

$bitfields

$condition

$config

$error_handler

$errors

$existing

$info

$moderator

$table

Methods

__construct()

Parameters

__serialize()

Return values

__sleep()

Return values

__unserialize()

Parameters

__wakeup()

check_required()

Return values

db_insert()

Parameters

Return values

db_update()

Parameters

Return values

delete()

Parameters

Return values

do_set()

Parameters

do_unset()

Parameters

error()

Parameters

fetch_field()

Parameters

Return values

get_errors()

Return values

get_exception()

has_errors()

Parameters

Return values

is_bitfield_set()

Parameters

Return values

is_field_defined()

Parameters

is_field_set()

Parameters

post_save_each()

Parameters

post_save_once()

Parameters

pre_save()

Parameters

Return values

save()

Parameters

Return values

set()

Parameters

Return values

set_bitfield()

Parameters

Return values

set_condition()

Parameters

set_existing()

Parameters

Return values

set_info()

vB_DataManager_Moderator extends vB_DataManager
in package

vBulletin