vBulletin v6.0.4

vB_DataManager_Tag extends vB_DataManager
in package

Application

Abstract class to do data save/delete operations for a particular data type (such as user, thread, post etc.)

Properties

$condition : string: Condition to be used. Can be either ['keyfield' => 'value'] or a valid assertor vB_dB_Query::CONDITIONS_KEY setting.
$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
$keyField : mixed
$table : mixed
$validfields : array<string|int, mixed>: Array of recognised and required fields for keywords, and their types

Methods

__construct() : mixed: Constructor - Checks for necessity of registry object
__serialize() : array<string|int, mixed>
__sleep() : array<string|int, mixed>
__unserialize() : void
__wakeup() : void
attach_content() : mixed
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() : int: Deletes the specified data item from the database
detach_content() : mixed
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_by_id() : mixed
fetch_by_tagtext() : mixed
fetch_canonical_tag() : mixed
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
fetch_fields() : mixed: Return the array of fields that most the code expects to consume
fetch_synonyms() : mixed
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
is_synonym() : mixed
make_independent() : mixed: Unlink a synonym from its canonical parent.
make_synonym() : mixed: Make this tag a synonym for another tag
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_delete() : mixed
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: Sets the supplied data to be part of the data to be saved. Use setr() if a reference to $value is to be passed
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
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_username() : bool: Verifies that the provided username is valid, and attempts to correct it if it is not valid

$condition

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


    public
        string
    $condition
     = \null

$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
     = []

$keyField


    public
        mixed
    $keyField
     = 'tagid'

$table


    public
        mixed
    $table
     = 'vBForum:tag'

$validfields

Array of recognised and required fields for keywords, and their types


    public
        array<string|int, mixed>
    $validfields
     = ['tagid' => [\vB_Cleaner::TYPE_UINT, \vB_DataManager_Constants::REQ_INCR, \vB_DataManager_Constants::VF_METHOD, 'verify_nonzero'], 'tagtext' => [\vB_Cleaner::TYPE_NOHTML, \vB_DataManager_Constants::REQ_YES, \vB_DataManager_Constants::VF_METHOD, 'verify_nonempty'], 'canonicaltagid' => [\vB_Cleaner::TYPE_UINT, \vB_DataManager_Constants::REQ_NO], 'dateline' => [\vB_Cleaner::TYPE_UNIXTIME, \vB_DataManager_Constants::REQ_YES, \vB_DataManager_Constants::VF_METHOD, 'verify_nonzero']]

Should be protected, but base class is php4 and defines as public by default.

__construct()

Constructor - Checks for necessity of registry object


    public
                    __construct([vB_Registry $registry = NULL ][, int $errtype = NULL ]) : mixed

Note that this method will accept only the $errtype parameter (via some magic checking of the parameters) and this is the preferred way of calling the datamanager functions. The registry object is deprecated and will be created internally for those managers that still need it.

Parameters

$registry : vB_Registry = NULL: -- Instance of the vBulletin data registry object - expected to have the database object as one of its $this->db member.
$errtype : int = 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

attach_content()


    public
                    attach_content(mixed $type, mixed $id) : mixed

Parameters

$type : mixed
$id : mixed

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 the specified data item from the database


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

Parameters

$doquery : mixed = true

Return values

int —

The number of rows deleted

detach_content()


    public
                    detach_content(mixed $type, mixed $id) : mixed

Parameters

$type : mixed
$id : mixed

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_by_id()


    public
                    fetch_by_id(mixed $id) : mixed

Parameters

$id : mixed

fetch_by_tagtext()


    public
                    fetch_by_tagtext(mixed $label) : mixed

Parameters

$label : mixed

fetch_canonical_tag()


    public
                    fetch_canonical_tag() : 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

fetch_fields()

Return the array of fields that most the code expects to consume


    public
                    fetch_fields() : mixed

fetch_synonyms()


    public
                    fetch_synonyms() : mixed

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

is_synonym()


    public
                    is_synonym() : mixed

make_independent()

Unlink a synonym from its canonical parent.


    public
                    make_independent() : mixed

This will not reestablish any relationships between the tag and content that may have been transfered to the parent when the tag was made a synonym.

make_synonym()

Make this tag a synonym for another tag


    public
                    make_synonym(int $canonical_id) : mixed

Any associations between this tag and content will be transfered to the parent.

Parameters

$canonical_id : int: id for the tag that this will become the synonym of

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

In batch updates, is executed for each record updated.

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_delete()


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

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()

Sets the supplied data to be part of the data to be saved. Use setr() if a reference to $value is to be passed


    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 false if the data is rejected for whatever reason

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

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_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_Tag extends vB_DataManager in package Application

Table of Contents

Properties

Methods

Properties

$condition

$error_handler

$errors

$existing

$info

$keyField

$table

$validfields

Methods

__construct()

Parameters

__serialize()

Return values

__sleep()

Return values

__unserialize()

Parameters

__wakeup()

attach_content()

Parameters

check_required()

Return values

db_insert()

Parameters

Return values

db_update()

Parameters

Return values

delete()

Parameters

Return values

detach_content()

Parameters

do_set()

Parameters

do_unset()

Parameters

error()

Parameters

fetch_by_id()

Parameters

fetch_by_tagtext()

Parameters

fetch_canonical_tag()

fetch_field()

Parameters

Return values

fetch_fields()

fetch_synonyms()

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

is_synonym()

make_independent()

make_synonym()

Parameters

post_save_each()

Parameters

post_save_once()

Parameters

pre_delete()

Parameters

pre_save()

Parameters

Return values

vB_DataManager_Tag extends vB_DataManager
in package

Application