PHP Класс PodsData, pods

Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$aliases array
$api PodsAPI
$data
$detail_page
$display_errors boolean
$field_id string
$field_index string
$field_slug string
$fields array
$filters array
$id integer
$insert_id
$instance PodsData
$join string
$limit integer
$orderby string
$page integer
$page_var string
$pagination boolean
$pod null
$pod_data array | boolean | mixed | null | void
$row
$row_number integer
$search boolean
$search_fields array
$search_mode string
$search_query string
$search_var string
$search_where string
$select null
$sql string Last select() query SQL
$table null
$total
$total_found
$total_found_calculated boolean
$total_sql string Last total sql
$traversal array Holds Traversal information about Pods
$traverse array Holds custom Traversals to be included
$where array
$where_default array

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

Свойство Тип Описание
$field_types array
$prefix string

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

Метод Описание
__construct ( string $pod = null, integer $id, boolean $strict = true ) : PodsData Data Abstraction Class for Pods
build ( array $params ) : boolean | mixed | string Build/Rewrite dynamic SQL and handle search/filter/sort
calculate_totals ( )
delete ( string $table, array $where, array $where_format = null ) : array | boolean | mixed | null | void Delete an item
fetch ( integer $row = null, boolean $explicit_set = true ) : mixed Fetch a new row for the current pod_data
get_column_data ( string $column_name, string $table ) : array Gets column data information from a table
get_sql ( $sql ) Get the complete sql
get_table_columns ( string $table ) : array Gets column information from a table
get_tables ( boolean $wp_core = true, boolean $pods_tables = true ) : array Gets all tables in the WP database, optionally exclude WP core tables, and/or Pods table by settings the parameters to false.
init ( string $pod = null, integer $id, boolean $strict = true ) : PodsData Singleton handling for a basic pods_data() request
insert ( string $table, array $data, array $format = null ) : integer | boolean Insert an item, eventually mapping to WPDB::insert
insert_on_duplicate ( string $table, array $data, array $formats = [] ) : mixed
nth ( integer | string $nth ) : boolean Fetch the nth state
position ( ) : integer Fetch the current position in the loop (starting at 1)
prepare ( string $sql, array $data ) : boolean | null | string Prepare values for the DB
query ( string | array $sql, string $error = 'Database Error', null $results_error = null, null $no_results_error = null ) : array | boolean | mixed | null | void
query_field ( string | integer $field, array | string $q, array $pod = null, object &$params = null ) : string | null Get the string to use in a query for matching, uses WP_Query meta_query arguments
query_fields ( array $fields, array $pod = null, object &$params = null ) : string | null Get the string to use in a query for WHERE/HAVING, uses WP_Query meta_query arguments
reorder ( string $table, string $weight_field, string $id_field, array $ids ) : boolean Reorder Items
reset ( integer $row = null ) : mixed Reset the current data
select ( array $params ) : array | boolean | mixed Select items, eventually building dynamic query
table ( array | string $table, string $object = '' ) Handle tables like they are Pods (for traversal in select/build)
table_alter ( string $table, string $changes ) : array | boolean | mixed | null | void Alter a Table
table_create ( string $table, string $fields, boolean $if_not_exists = false ) : array | boolean | mixed | null | void Create a Table
table_drop ( string $table ) : array | boolean | mixed | null | void Drop a Table
table_truncate ( string $table ) : array | boolean | mixed | null | void Truncate a Table
total ( ) : integer Fetch the total row count returned
total_found ( ) : integer Fetch the total row count total
traverse ( array $fields = null, null $all_fields = null, object $params = null ) : array Recursively join tables based on fields
traverse_build ( array $fields = null, object $params = null ) : array Setup fields for traversal
traverse_recurse ( array $traverse_recurse ) : array Recursively join tables based on fields
update ( string $table, array $data, array $where, array $format = null, array $where_format = null ) : boolean Update an item, eventually mapping to WPDB::update
zebra ( ) : boolean Fetch the zebra state

Приватные методы

Метод Описание
do_hook ( ) Handle filters / actions for the class

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

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

Data Abstraction Class for Pods
С версии: 2.0
public __construct ( string $pod = null, integer $id, boolean $strict = true ) : PodsData
$pod string Pod name
$id integer Pod Item ID
$strict boolean If true throws an error if a pod is not found.
Результат PodsData

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

Build/Rewrite dynamic SQL and handle search/filter/sort
С версии: 2.0
public build ( array $params ) : boolean | mixed | string
$params array
Результат boolean | mixed | string

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

public calculate_totals ( )

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

Delete an item
С версии: 2.0
public delete ( string $table, array $where, array $where_format = null ) : array | boolean | mixed | null | void
$table string Table name
$where array A named array of WHERE clauses (in column => value pairs). Multiple clauses will be joined with ANDs. Both $where columns and $where values should be "raw".
$where_format array (optional) An array of formats to be mapped to each of the values in $where.
Результат array | boolean | mixed | null | void

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

Fetch a new row for the current pod_data
С версии: 2.0
public fetch ( integer $row = null, boolean $explicit_set = true ) : mixed
$row integer Row number to fetch
$explicit_set boolean Whether to set explicitly (use false when in loop)
Результат mixed

get_column_data() публичный статический Метод

Gets column data information from a table
С версии: 2.0
public static get_column_data ( string $column_name, string $table ) : array
$column_name string Column name
$table string Table name
Результат array

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

Get the complete sql
С версии: 2.0.5
public get_sql ( $sql )

get_table_columns() публичный статический Метод

Gets column information from a table
С версии: 2.0
public static get_table_columns ( string $table ) : array
$table string Table Name
Результат array

get_tables() публичный статический Метод

Gets all tables in the WP database, optionally exclude WP core tables, and/or Pods table by settings the parameters to false.
С версии: 2.0
public static get_tables ( boolean $wp_core = true, boolean $pods_tables = true ) : array
$wp_core boolean
$pods_tables boolean restrict Pods 2.x tables
Результат array

init() публичный статический Метод

Singleton handling for a basic pods_data() request
С версии: 2.3.5
public static init ( string $pod = null, integer $id, boolean $strict = true ) : PodsData
$pod string Pod name
$id integer Pod Item ID
$strict boolean If true throws an error if a pod is not found.
Результат PodsData

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

Insert an item, eventually mapping to WPDB::insert
С версии: 2.0
public insert ( string $table, array $data, array $format = null ) : integer | boolean
$table string Table name
$data array Data to insert (in column => value pairs). Both $data columns and $data values should be "raw" (neither should be SQL escaped).
$format array (optional) An array of formats to be mapped to each of the value in $data.
Результат integer | boolean The ID of the item

insert_on_duplicate() публичный статический Метод

С версии: 2.0
public static insert_on_duplicate ( string $table, array $data, array $formats = [] ) : mixed
$table string Name of the table to update
$data array column => value pairs
$formats array For $wpdb->prepare, uses sprintf formatting
Результат mixed Sanitized query string

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

Fetch the nth state
С версии: 2.3
public nth ( integer | string $nth ) : boolean
$nth integer | string The $nth to match on the PodsData::row_number
Результат boolean Whether $nth matches

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

Fetch the current position in the loop (starting at 1)
С версии: 2.3
public position ( ) : integer
Результат integer Current row number (+1)

prepare() публичный статический Метод

Prepare values for the DB
С версии: 2.0
public static prepare ( string $sql, array $data ) : boolean | null | string
$sql string SQL to prepare
$data array Data to add to the sql prepare statement
Результат boolean | null | string

query() публичный статический Метод

С версии: 2.0
public static query ( string | array $sql, string $error = 'Database Error', null $results_error = null, null $no_results_error = null ) : array | boolean | mixed | null | void
$sql string | array The SQL to execute
$error string Error to throw on problems
$results_error null (optional)
$no_results_error null (optional)
Результат array | boolean | mixed | null | void Result of the query

query_field() публичный статический Метод

Get the string to use in a query for matching, uses WP_Query meta_query arguments
См. также: PodsData::query_fields
С версии: 2.3
public static query_field ( string | integer $field, array | string $q, array $pod = null, object &$params = null ) : string | null
$field string | integer Field name or array index
$q array | string Query array (meta_query) or string for matching
$pod array Related Pod
$params object Parameters passed from select()
Результат string | null Query field string

query_fields() публичный статический Метод

Get the string to use in a query for WHERE/HAVING, uses WP_Query meta_query arguments
С версии: 2.3
public static query_fields ( array $fields, array $pod = null, object &$params = null ) : string | null
$fields array Array of field matches for querying
$pod array Related Pod
$params object Parameters passed from select()
Результат string | null Query string for WHERE/HAVING

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

Reorder Items
С версии: 2.0
public reorder ( string $table, string $weight_field, string $id_field, array $ids ) : boolean
$table string Table name
$weight_field string
$id_field string
$ids array
Результат boolean

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

Reset the current data
С версии: 2.0
public reset ( integer $row = null ) : mixed
$row integer Row number to reset to
Результат mixed

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

Select items, eventually building dynamic query
С версии: 2.0
public select ( array $params ) : array | boolean | mixed
$params array
Результат array | boolean | mixed

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

Handle tables like they are Pods (for traversal in select/build)
public table ( array | string $table, string $object = '' )
$table array | string
$object string

table_alter() публичный статический Метод

Alter a Table
С версии: 2.0
public static table_alter ( string $table, string $changes ) : array | boolean | mixed | null | void
$table string Table name
$changes string
Результат array | boolean | mixed | null | void

table_create() публичный статический Метод

Create a Table
С версии: 2.0
public static table_create ( string $table, string $fields, boolean $if_not_exists = false ) : array | boolean | mixed | null | void
$table string Table name
$fields string
$if_not_exists boolean Check if the table exists.
Результат array | boolean | mixed | null | void

table_drop() публичный статический Метод

Drop a Table
С версии: 2.0
public static table_drop ( string $table ) : array | boolean | mixed | null | void
$table string Table name
Результат array | boolean | mixed | null | void

table_truncate() публичный статический Метод

Truncate a Table
С версии: 2.0
public static table_truncate ( string $table ) : array | boolean | mixed | null | void
$table string Table name
Результат array | boolean | mixed | null | void

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

Fetch the total row count returned
С версии: 2.0
public total ( ) : integer
Результат integer Number of rows returned by select()

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

Fetch the total row count total
С версии: 2.0
public total_found ( ) : integer
Результат integer Number of rows found by select()

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

Recursively join tables based on fields
public traverse ( array $fields = null, null $all_fields = null, object $params = null ) : array
$fields array Fields to recurse
$all_fields null (optional) If $fields is empty then traverse all fields, argument does not need to be passed
$params object (optional) Parameters from build()
Результат array Array of joins

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

Setup fields for traversal
С версии: 2.0
public traverse_build ( array $fields = null, object $params = null ) : array
$fields array Associative array of fields data
$params object (optional) Parameters from build()
Результат array Traverse feed

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

Recursively join tables based on fields
С версии: 2.0
public traverse_recurse ( array $traverse_recurse ) : array
$traverse_recurse array Array of traversal options
Результат array Array of table joins

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

Update an item, eventually mapping to WPDB::update
С версии: 2.0
public update ( string $table, array $data, array $where, array $format = null, array $where_format = null ) : boolean
$table string Table name
$data array Data to update (in column => value pairs). Both $data columns and $data values should be "raw" (neither should be SQL escaped).
$where array A named array of WHERE clauses (in column => value pairs). Multiple clauses will be joined with ANDs. Both $where columns and $where values should be "raw".
$format array (optional) An array of formats to be mapped to each of the values in $data.
$where_format array (optional) An array of formats to be mapped to each of the values in $where.
Результат boolean

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

Fetch the zebra state
См. также: PodsData::nth
С версии: 1.12
public zebra ( ) : boolean
Результат boolean Zebra state

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

$aliases публичное свойство

public array $aliases
Результат array

$api публичное свойство

public PodsAPI $api
Результат PodsAPI

$data публичное свойство

public $data

$detail_page публичное свойство

public $detail_page

$display_errors публичное статическое свойство

public static bool $display_errors
Результат boolean

$field_id публичное свойство

public string $field_id
Результат string

$field_index публичное свойство

public string $field_index
Результат string

$field_slug публичное свойство

public string $field_slug
Результат string

$field_types защищенное статическое свойство

protected static array $field_types
Результат array

$fields публичное свойство

public array $fields
Результат array

$filters публичное свойство

public array $filters
Результат array

$id публичное свойство

public int $id
Результат integer

$insert_id публичное свойство

public $insert_id

$instance статическое публичное свойство

static public PodsData $instance
Результат PodsData

$join публичное свойство

public string $join
Результат string

$limit публичное свойство

public int $limit
Результат integer

$orderby публичное свойство

public string $orderby
Результат string

$page публичное свойство

public int $page
Результат integer

$page_var публичное свойство

public string $page_var
Результат string

$pagination публичное свойство

public bool $pagination
Результат boolean

$pod публичное свойство

public null $pod
Результат null

$pod_data публичное свойство

public array|bool|mixed|null|void $pod_data
Результат array | boolean | mixed | null | void

$prefix защищенное статическое свойство

protected static string $prefix
Результат string

$row публичное свойство

public $row

$row_number публичное свойство

public int $row_number
Результат integer

$search_fields публичное свойство

public array $search_fields
Результат array

$search_mode публичное свойство

public string $search_mode
Результат string

$search_query публичное свойство

public string $search_query
Результат string

$search_var публичное свойство

public string $search_var
Результат string

$search_where публичное свойство

public string $search_where
Результат string

$select публичное свойство

public null $select
Результат null

$sql публичное свойство

Last select() query SQL
public string $sql
Результат string

$table публичное свойство

public null $table
Результат null

$total публичное свойство

public $total

$total_found публичное свойство

public $total_found

$total_found_calculated публичное свойство

public bool $total_found_calculated
Результат boolean

$total_sql публичное свойство

Last total sql
public string $total_sql
Результат string

$traversal публичное свойство

Holds Traversal information about Pods
public array $traversal
Результат array

$traverse публичное свойство

Holds custom Traversals to be included
public array $traverse
Результат array

$where публичное свойство

public array $where
Результат array

$where_default публичное свойство

public array $where_default
Результат array