PHP Класс WC_Data

Implemented by classes using the same CRUD(s) pattern.
Автор: WooThemes
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$cache_group string A group must be set to to enable caching.
$changes array Core data changes for this object.
$data array Core data for this object. Name value pairs (name + default value).
$data_store object Contains a reference to the data store for this class.
$default_data array Set to _data on construct so we can track and reset data if needed.
$extra_data array Used as a standard way for sub classes (like product types) to add additional information to an inherited class.
$id integer ID for this object.
$meta_data array Stores additonal meta data.
$object_read boolean This is false until the object is read from the DB.

Открытые методы

Метод Описание
__construct ( integer | object | array $read ) Default constructor.
__toString ( ) : string Change data to JSON format.
add_meta_data ( string $key, string $value, boolean $unique = false ) Add meta data.
apply_changes ( ) Merge changes with data and clear.
delete ( boolean $force_delete = false ) : boolean Delete an object, set the ID to 0, and return result.
delete_meta_data ( array $key ) Delete meta data.
delete_meta_data_by_mid ( integer $mid ) Delete meta data.
get_changes ( ) : array Return data changes only.
get_data ( ) : array Returns all data for this object.
get_data_keys ( ) : array Returns array of expected data keys for this object.
get_data_store ( ) : object Get the data store.
get_extra_data_keys ( ) : array Returns all "extra" data keys for an object (for sub objects like product types).
get_id ( ) : integer Returns the unique ID for this object.
get_meta ( string $key = '', boolean $single = true, string $context = 'view' ) : mixed Get Meta Data by Key.
get_meta_data ( ) : array Get All Meta Data.
get_object_read ( ) : boolean Get object read property.
read_meta_data ( boolean $force_read = false ) Read Meta Data from the database. Ignore any internal properties.
save ( ) : integer Save should create or update based on object existance.
save_meta_data ( ) Update Meta Data in the database.
set_defaults ( ) Set all props to default values.
set_id ( integer $id ) Set ID.
set_meta_data ( array $data ) Set all meta data from array.
set_object_read ( boolean $read = true ) Set object read property.
set_props ( array $props, $context = 'set' ) : WP_Error | boolean Set a collection of props in one go, collect any errors, and return the result.
update_meta_data ( string $key, string $value, integer $meta_id = '' ) Update meta data by key or ID, if provided.

Защищенные методы

Метод Описание
error ( string $error_code, string $error_message ) When invalid data is found, throw an exception unless reading from the DB.
filter_null_meta ( $meta ) : boolean Filter null meta values from array.
get_hook_prefix ( ) : string Prefix for action and filter hooks on data.
get_prop ( string $prop, string $context = 'view' ) : mixed Gets a prop for a getter method.
set_prop ( string $prop, mixed $value ) Sets a prop for a setter method.

Описание методов

__construct() публичный Метод

Default constructor.
public __construct ( integer | object | array $read )
$read integer | object | array ID to load from the DB (optional) or already queried data.

__toString() публичный Метод

Change data to JSON format.
public __toString ( ) : string
Результат string Data in JSON format.

add_meta_data() публичный Метод

Add meta data.
С версии: 2.6.0
public add_meta_data ( string $key, string $value, boolean $unique = false )
$key string Meta key
$value string Meta value
$unique boolean Should this be a unique key?

apply_changes() публичный Метод

Merge changes with data and clear.
С версии: 2.7.0
public apply_changes ( )

delete() публичный Метод

Delete an object, set the ID to 0, and return result.
public delete ( boolean $force_delete = false ) : boolean
$force_delete boolean
Результат boolean result

delete_meta_data() публичный Метод

Delete meta data.
С версии: 2.6.0
public delete_meta_data ( array $key )
$key array Meta key

delete_meta_data_by_mid() публичный Метод

Delete meta data.
С версии: 2.6.0
public delete_meta_data_by_mid ( integer $mid )
$mid integer Meta ID

error() защищенный Метод

When invalid data is found, throw an exception unless reading from the DB.
protected error ( string $error_code, string $error_message )
$error_code string Error code.
$error_message string Error message.

filter_null_meta() защищенный Метод

Filter null meta values from array.
protected filter_null_meta ( $meta ) : boolean
Результат boolean

get_changes() публичный Метод

Return data changes only.
С версии: 2.7.0
public get_changes ( ) : array
Результат array

get_data() публичный Метод

Returns all data for this object.
public get_data ( ) : array
Результат array

get_data_keys() публичный Метод

Returns array of expected data keys for this object.
С версии: 2.7.0
public get_data_keys ( ) : array
Результат array

get_data_store() публичный Метод

Get the data store.
С версии: 2.7.0
public get_data_store ( ) : object
Результат object

get_extra_data_keys() публичный Метод

Returns all "extra" data keys for an object (for sub objects like product types).
С версии: 2.7.0
public get_extra_data_keys ( ) : array
Результат array

get_hook_prefix() защищенный Метод

Prefix for action and filter hooks on data.
С версии: 2.7.0
protected get_hook_prefix ( ) : string
Результат string

get_id() публичный Метод

Returns the unique ID for this object.
public get_id ( ) : integer
Результат integer

get_meta() публичный Метод

Get Meta Data by Key.
С версии: 2.6.0
public get_meta ( string $key = '', boolean $single = true, string $context = 'view' ) : mixed
$key string
$single boolean return first found meta with key, or all with $key
$context string What the value is for. Valid values are view and edit.
Результат mixed

get_meta_data() публичный Метод

Get All Meta Data.
С версии: 2.6.0
public get_meta_data ( ) : array
Результат array

get_object_read() публичный Метод

Get object read property.
public get_object_read ( ) : boolean
Результат boolean

get_prop() защищенный Метод

Gets the value from either current pending changes, or the data itself. Context controls what happens to the value before it's returned.
С версии: 2.7.0
protected get_prop ( string $prop, string $context = 'view' ) : mixed
$prop string Name of prop to get.
$context string What the value is for. Valid values are view and edit.
Результат mixed

read_meta_data() публичный Метод

Read Meta Data from the database. Ignore any internal properties.
С версии: 2.6.0
public read_meta_data ( boolean $force_read = false )
$force_read boolean True to force a new DB read (and update cache).

save() публичный Метод

Save should create or update based on object existance.
public save ( ) : integer
Результат integer

save_meta_data() публичный Метод

Update Meta Data in the database.
С версии: 2.6.0
public save_meta_data ( )

set_defaults() публичный Метод

Set all props to default values.
public set_defaults ( )

set_id() публичный Метод

Set ID.
public set_id ( integer $id )
$id integer

set_meta_data() публичный Метод

Set all meta data from array.
С версии: 2.6.0
public set_meta_data ( array $data )
$data array Key/Value pairs

set_object_read() публичный Метод

Set object read property.
public set_object_read ( boolean $read = true )
$read boolean

set_prop() защищенный Метод

This stores changes in a special array so we can track what needs saving the the DB later.
С версии: 2.7.0
protected set_prop ( string $prop, mixed $value )
$prop string Name of prop to set.
$value mixed Value of the prop.

set_props() публичный Метод

Only sets using public methods.
public set_props ( array $props, $context = 'set' ) : WP_Error | boolean
$props array Key value pairs to set. Key is the prop and should map to a setter function name.
Результат WP_Error | boolean

update_meta_data() публичный Метод

Update meta data by key or ID, if provided.
С версии: 2.6.0
public update_meta_data ( string $key, string $value, integer $meta_id = '' )
$key string
$value string
$meta_id integer

Описание свойств

$cache_group защищенное свойство

A group must be set to to enable caching.
protected string $cache_group
Результат string

$changes защищенное свойство

Core data changes for this object.
protected array $changes
Результат array

$data защищенное свойство

Core data for this object. Name value pairs (name + default value).
protected array $data
Результат array

$data_store защищенное свойство

Contains a reference to the data store for this class.
protected object $data_store
Результат object

$default_data защищенное свойство

Set to _data on construct so we can track and reset data if needed.
protected array $default_data
Результат array

$extra_data защищенное свойство

Used as a standard way for sub classes (like product types) to add additional information to an inherited class.
protected array $extra_data
Результат array

$id защищенное свойство

ID for this object.
protected int $id
Результат integer

$meta_data защищенное свойство

Stores additonal meta data.
protected array $meta_data
Результат array

$object_read защищенное свойство

This is false until the object is read from the DB.
protected bool $object_read
Результат boolean