Skip to content

Instantly share code, notes, and snippets.

@sc0ttkclark

sc0ttkclark/PodsAPI.php

Forked from hotzeplotz/PodsAPI.php
Created October 27, 2013 13:54
Show Gist options
  • Save sc0ttkclark/7182408 to your computer and use it in GitHub Desktop.
Save sc0ttkclark/7182408 to your computer and use it in GitHub Desktop.
Download ZIP
Raw
PodsAPI.php
<?php
/**
* @package Pods
*/
class PodsAPI {
/**
* @var PodsAPI
*/
static $instance = null;
/**
* @var bool
*/
public $display_errors = false;
/**
* @var array|bool|mixed|null|void
*/
public $pod_data;
/**
* @var
*/
public $pod;
/**
* @var
*/
public $pod_id;
/**
* @var
*/
public $fields;
/**
* @var
* @deprecated 2.0
*/
public $format = null;
/**
* @var
*/
private $deprecated;
/**
* Singleton handling for a basic pods_api() request
*
* @param string $pod (optional) The pod name
* @param string $format (deprecated) Format for import/export, "php" or "csv"
*
* @return \PodsAPI
*
* @since 2.3.5
*/
public static function init ( $pod = null, $format = null ) {
if ( null !== $pod || null !== $format ) {
return new PodsAPI( $pod, $format );
}
elseif ( !is_object( self::$instance ) ) {
self::$instance = new PodsAPI();
}
return self::$instance;
}
/**
* Store and retrieve data programatically
*
* @param string $pod (optional) The pod name
* @param string $format (deprecated) Format for import/export, "php" or "csv"
*
* @return \PodsAPI
*
* @license http://www.gnu.org/licenses/gpl-2.0.html
* @since 1.7.1
*/
public function __construct ( $pod = null, $format = null ) {
if ( null !== $pod && 0 < strlen( (string) $pod ) ) {
if ( null !== $format ) {
$this->format = $format;
pods_deprecated( 'pods_api( $pod, $format )', '2.0', 'pods_api( $pod )' );
}
$pod = pods_clean_name( $pod );
$pod = $this->load_pod( array( 'name' => $pod, 'table_info' => true ), false );
if ( !empty( $pod ) ) {
$this->pod_data = $pod;
$this->pod = $pod[ 'name' ];
$this->pod_id = $pod[ 'id' ];
$this->fields = $pod[ 'fields' ];
}
}
}
/**
* Save a WP object and its meta
*
* @param string $object_type Object type: post|user|comment|setting
* @param array $data All post data to be saved
* @param array $meta (optional) Associative array of meta keys and values
* @param bool $strict (optional) Decides whether the previous saved meta should be deleted or not
* @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
*
* @return bool|mixed
*
* @since 2.0
*/
public function save_wp_object ( $object_type, $data, $meta = array(), $strict = false, $sanitized = false ) {
if ( in_array( $object_type, array( 'post_type', 'media' ) ) )
$object_type = 'post';
if ( $sanitized ) {
$data = pods_unsanitize( $data );
$meta = pods_unsanitize( $meta );
}
if ( in_array( $object_type, array( 'post', 'user', 'comment' ) ) )
return call_user_func( array( $this, 'save_' . $object_type ), $data, $meta, $strict, false );
elseif ( 'settings' == $object_type ) {
// Nothing to save
if ( empty( $meta ) )
return true;
return $this->save_setting( pods_var( 'option_id', $data ), $meta, false );
}
return false;
}
/**
* Delete a WP object
*
* @param string $object_type Object type: post|user|comment
* @param int $id Object ID
* @param bool $force_delete (optional) Force deletion instead of trashing (post types only)
*
* @return bool|mixed
*
* @since 2.0
*/
public function delete_wp_object ( $object_type, $id, $force_delete = true ) {
if ( in_array( $object_type, array( 'post_type', 'media' ) ) )
$object_type = 'post';
if ( empty( $id ) )
return false;
if ( in_array( $object_type, array( 'post' ) ) )
return wp_delete_post( $id, $force_delete );
if ( function_exists( 'wp_delete_' . $object_type ) )
return call_user_func( 'wp_delete_' . $object_type, $id );
return false;
}
/**
* Save a post and it's meta
*
* @param array $post_data All post data to be saved (using wp_insert_post / wp_update_post)
* @param array $post_meta (optional) All meta to be saved (set value to null to delete)
* @param bool $strict (optional) Whether to delete previously saved meta not in $post_meta
* @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
*
* @return mixed|void
*
* @since 2.0
*/
public function save_post ( $post_data, $post_meta = null, $strict = false, $sanitized = false ) {
$conflicted = pods_no_conflict_check( 'post' );
if ( !$conflicted )
pods_no_conflict_on( 'post' );
if ( !is_array( $post_data ) || empty( $post_data ) )
$post_data = array( 'post_title' => '' );
if ( !is_array( $post_meta ) )
$post_meta = array();
if ( $sanitized ) {
$post_data = pods_unsanitize( $post_data );
$post_meta = pods_unsanitize( $post_meta );
}
if ( !isset( $post_data[ 'ID' ] ) || empty( $post_data[ 'ID' ] ) )
$post_data[ 'ID' ] = wp_insert_post( $post_data, true );
elseif ( 2 < count( $post_data ) || !isset( $post_data[ 'post_type' ] ) )
wp_update_post( $post_data );
if ( is_wp_error( $post_data[ 'ID' ] ) ) {
if ( !$conflicted )
pods_no_conflict_off( 'post' );
/**
* @var $post_error WP_Error
*/
$post_error = $post_data[ 'ID' ];
return pods_error( $post_error->get_error_message(), $this );
}
$this->save_post_meta( $post_data[ 'ID' ], $post_meta, $strict );
if ( !$conflicted )
pods_no_conflict_off( 'post' );
return $post_data[ 'ID' ];
}
/**
* Save a post's meta
*
* @param int $id Post ID
* @param array $post_meta All meta to be saved (set value to null to delete)
* @param bool $strict Whether to delete previously saved meta not in $post_meta
*
* @return int Id of the post with the meta
*
* @since 2.0
*/
public function save_post_meta ( $id, $post_meta = null, $strict = false ) {
$conflicted = pods_no_conflict_check( 'post' );
if ( !$conflicted )
pods_no_conflict_on( 'post' );
if ( !is_array( $post_meta ) )
$post_meta = array();
$id = (int) $id;
$meta = get_post_meta( $id );
foreach ( $meta as $k => $value ) {
if ( is_array( $value ) && 1 == count( $value ) )
$meta[ $k ] = current( $value );
}
foreach ( $post_meta as $meta_key => $meta_value ) {
if ( null === $meta_value || ( $strict && '' === $post_meta[ $meta_key ] ) ) {
$old_meta_value = '';
if ( isset( $meta[ $meta_key ] ) )
$old_meta_value = $meta[ $meta_key ];
delete_post_meta( $id, $meta_key, $old_meta_value );
}
else
update_post_meta( $id, $meta_key, $meta_value );
}
if ( $strict ) {
foreach ( $meta as $meta_key => $meta_value ) {
if ( !isset( $post_meta[ $meta_key ] ) )
delete_post_meta( $id, $meta_key, $meta_value );
}
}
if ( !$conflicted )
pods_no_conflict_off( 'post' );
return $id;
}
/**
* Save a user and it's meta
*
* @param array $user_data All user data to be saved (using wp_insert_user / wp_update_user)
* @param array $user_meta (optional) All meta to be saved (set value to null to delete)
* @param bool $strict (optional) Whether to delete previously saved meta not in $user_meta
* @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
*
* @return int Returns user id on success
*
* @since 2.0
*/
public function save_user ( $user_data, $user_meta = null, $strict = false, $sanitized = false ) {
if ( !is_array( $user_data ) || empty( $user_data ) )
return pods_error( __( 'User data is required but is either invalid or empty', 'pods' ), $this );
$conflicted = pods_no_conflict_check( 'user' );
if ( !$conflicted )
pods_no_conflict_on( 'user' );
if ( !is_array( $user_meta ) )
$user_meta = array();
if ( $sanitized ) {
$user_data = pods_unsanitize( $user_data );
$user_meta = pods_unsanitize( $user_meta );
}
// Set role
if ( isset( $user_meta[ 'role' ] ) ) {
$user_data[ 'role' ] = $user_meta[ 'role' ];
unset( $user_meta[ 'role' ] );
}
if ( !isset( $user_data[ 'ID' ] ) || empty( $user_data[ 'ID' ] ) )
$user_data[ 'ID' ] = wp_insert_user( $user_data );
elseif ( 1 < count( $user_data ) )
wp_update_user( $user_data );
if ( is_wp_error( $user_data[ 'ID' ] ) ) {
if ( !$conflicted )
pods_no_conflict_off( 'user' );
/**
* @var $user_error WP_Error
*/
$user_error = $user_data[ 'ID' ];
return pods_error( $user_error->get_error_message(), $this );
}
$this->save_user_meta( $user_data[ 'ID' ], $user_meta, $strict );
if ( !$conflicted )
pods_no_conflict_off( 'user' );
return $user_data[ 'ID' ];
}
/**
* Save a user meta
*
* @param int $id User ID
* @param array $user_meta (optional) All meta to be saved (set value to null to delete)
* @param bool $strict (optional) Whether to delete previously saved meta not in $user_meta
*
* @return int User ID
*
* @since 2.0
*
*/
public function save_user_meta ( $id, $user_meta = null, $strict = false ) {
$conflicted = pods_no_conflict_check( 'user' );
if ( !$conflicted )
pods_no_conflict_on( 'user' );
if ( !is_array( $user_meta ) )
$user_meta = array();
$id = (int) $id;
$meta = get_user_meta( $id );
foreach ( $user_meta as $meta_key => $meta_value ) {
if ( null === $meta_value ) {
$old_meta_value = '';
if ( isset( $meta[ $meta_key ] ) )
$old_meta_value = $meta[ $meta_key ];
delete_user_meta( $id, $meta_key, $old_meta_value );
}
else
update_user_meta( $id, $meta_key, $meta_value );
}
if ( $strict ) {
foreach ( $meta as $meta_key => $meta_value ) {
if ( !isset( $user_meta[ $meta_key ] ) )
delete_user_meta( $id, $meta_key, $user_meta[ $meta_key ] );
}
}
if ( !$conflicted )
pods_no_conflict_off( 'user' );
return $id;
}
/**
* Save a comment and it's meta
*
* @param array $comment_data All comment data to be saved (using wp_insert_comment / wp_update_comment)
* @param array $comment_meta (optional) All meta to be saved (set value to null to delete)
* @param bool $strict (optional) Whether to delete previously saved meta not in $comment_meta
* @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
*
* @return int Comment ID
*
* @since 2.0
*/
public function save_comment ( $comment_data, $comment_meta = null, $strict = false, $sanitized = false ) {
if ( !is_array( $comment_data ) || empty( $comment_data ) )
return pods_error( __( 'Comment data is required but is either invalid or empty', 'pods' ), $this );
$conflicted = pods_no_conflict_check( 'comment' );
if ( !$conflicted )
pods_no_conflict_on( 'comment' );
if ( !is_array( $comment_meta ) )
$comment_meta = array();
if ( $sanitized ) {
$comment_data = pods_unsanitize( $comment_data );
$comment_meta = pods_unsanitize( $comment_meta );
}
if ( !isset( $comment_data[ 'comment_ID' ] ) || empty( $comment_data[ 'comment_ID' ] ) )
$comment_data[ 'comment_ID' ] = wp_insert_comment( $comment_data );
elseif ( 1 < count( $comment_data ) )
wp_update_comment( $comment_data );
if ( is_wp_error( $comment_data[ 'comment_ID' ] ) ) {
if ( !$conflicted )
pods_no_conflict_off( 'comment' );
/**
* @var $comment_error WP_Error
*/
$comment_error = $comment_data[ 'comment_ID' ];
return pods_error( $comment_error->get_error_message(), $this );
}
$this->save_comment_meta( $comment_data[ 'comment_ID' ], $comment_meta, $strict );
if ( !$conflicted )
pods_no_conflict_off( 'comment' );
return $comment_data[ 'comment_ID' ];
}
/**
* Save a comment meta
*
* @param int $id Comment ID
* @param array $comment_meta (optional) All meta to be saved (set value to null to delete)
* @param bool $strict (optional) Whether to delete previously saved meta not in $comment_meta
*
* @return int Comment ID
*
* @since 2.0
*/
public function save_comment_meta ( $id, $comment_meta = null, $strict = false ) {
$conflicted = pods_no_conflict_check( 'comment' );
if ( !$conflicted )
pods_no_conflict_on( 'comment' );
if ( !is_array( $comment_meta ) )
$comment_meta = array();
$id = (int) $id;
$meta = get_comment_meta( $id );
foreach ( $comment_meta as $meta_key => $meta_value ) {
if ( null === $meta_value ) {
$old_meta_value = '';
if ( isset( $meta[ $meta_key ] ) )
$old_meta_value = $meta[ $meta_key ];
delete_comment_meta( $id, $meta_key, $old_meta_value );
}
else
update_comment_meta( $id, $meta_key, $meta_value );
}
if ( $strict ) {
foreach ( $meta as $meta_key => $meta_value ) {
if ( !isset( $comment_meta[ $meta_key ] ) )
delete_comment_meta( (int) $id, $meta_key, $comment_meta[ $meta_key ] );
}
}
if ( !$conflicted )
pods_no_conflict_off( 'comment' );
return $id;
}
/**
* Save a taxonomy's term
*
* @param int $term_ID Term ID, leave empty to add
* @param string $term Term name
* @param string $taxonomy Taxonomy name
* @param array $term_data All term data to be saved (using wp_insert_term / wp_update_term)
* @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
*
* @return int Term ID
*
* @since 2.0
*/
public function save_term ( $term_ID, $term, $taxonomy, $term_data, $sanitized = false ) {
$conflicted = pods_no_conflict_check( 'taxonomy' );
if ( !$conflicted )
pods_no_conflict_on( 'taxonomy' );
if ( !is_array( $term_data ) )
$term_data = array();
$term_ID = (int) $term_ID;
if ( $sanitized ) {
$term = pods_unsanitize( $term );
$taxonomy = pods_unsanitize( $taxonomy );
$term_data = pods_unsanitize( $term_data );
}
if ( empty( $term_ID ) )
$term_ID = wp_insert_term( $term, $taxonomy, $term_data );
else {
if ( 0 < strlen( $term ) )
$term_data[ 'term' ] = $term;
if ( empty( $term_data ) ) {
if ( !$conflicted )
pods_no_conflict_off( 'taxonomy' );
return pods_error( __( 'Taxonomy term data is required but is either invalid or empty', 'pods' ), $this );
}
wp_update_term( $term_ID, $taxonomy, $term_data );
}
if ( is_wp_error( $term_ID ) ) {
if ( !$conflicted )
pods_no_conflict_off( 'taxonomy' );
return pods_error( $term_ID->get_error_message(), $this );
}
elseif ( is_array( $term_ID ) )
$term_ID = $term_ID[ 'term_id' ];
if ( !$conflicted )
pods_no_conflict_off( 'taxonomy' );
return $term_ID;
}
/**
* Save a set of options
*
* @param string $setting Setting group name
* @param array $option_data All option data to be saved
* @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
*
* @return bool
*
* @since 2.3
*/
public function save_setting ( $setting, $option_data, $sanitized = false ) {
if ( !is_array( $option_data ) || empty( $option_data ) )
return pods_error( __( 'Setting data is required but is either invalid or empty', 'pods' ), $this );
$conflicted = pods_no_conflict_check( 'settings' );
if ( !$conflicted )
pods_no_conflict_on( 'settings' );
if ( $sanitized )
$option_data = pods_unsanitize( $option_data );
foreach ( $option_data as $option => $value ) {
if ( !empty( $setting ) )
$option = $setting . '_' . $option;
update_option( $option, $value );
}
if ( !$conflicted )
pods_no_conflict_off( 'settings' );
return true;
}
/**
* Rename a WP object's type
*
* @param string $object_type Object type: post|taxonomy|comment|setting
* @param string $old_name The old name
* @param string $new_name The new name
*
* @return bool
*
* @since 2.0
*/
public function rename_wp_object_type ( $object_type, $old_name, $new_name ) {
/**
* @var $wpdb wpdb
*/
global $wpdb;
if ( 'post_type' == $object_type )
$object_type = 'post';
if ( 'post' == $object_type ) {
pods_query( "UPDATE `{$wpdb->posts}` SET `post_type` = %s WHERE `post_type` = %s", array(
$new_name,
$old_name
) );
}
elseif ( 'taxonomy' == $object_type ) {
pods_query( "UPDATE `{$wpdb->term_taxonomy}` SET `taxonomy` = %s WHERE `taxonomy` = %s", array(
$new_name,
$old_name
) );
}
elseif ( 'comment' == $object_type ) {
pods_query( "UPDATE `{$wpdb->comments}` SET `comment_type` = %s WHERE `comment_type` = %s", array(
$new_name,
$old_name
) );
}
elseif ( 'settings' == $object_type ) {
pods_query( "UPDATE `{$wpdb->options}` SET `option_name` = REPLACE( `option_name`, %s, %s ) WHERE `option_name` LIKE '" . pods_sanitize_like( $old_name ) . "_%'", array(
$new_name . '_',
$old_name . '_'
) );
}
return true;
}
/**
* Get a list of core WP object fields for a specific object
*
* @param string $object The pod type to look for, possible values: post_type, user, comment, taxonomy
* @param array $pod Array of Pod data
* @param boolean $refresh Whether to force refresh the information
*
* @return array Array of fields
*
* @since 2.0
*/
public function get_wp_object_fields ( $object = 'post_type', $pod = null, $refresh = false ) {
$pod_name = pods_var_raw( 'name', $pod, $object, null, true );
if ( 'media' == $pod_name ) {
$object = 'post_type';
$pod_name = 'attachment';
}
$fields = false;
if ( pods_api_cache() )
$fields = pods_transient_get( trim( 'pods_api_object_fields_' . $object . $pod_name . '_', '_' ) );
if ( false !== $fields && !$refresh )
return $this->do_hook( 'get_wp_object_fields', $fields, $object, $pod );
$fields = array();
if ( 'post_type' == $object ) {
$fields = array(
'post_title' => array(
'name' => 'post_title',
'label' => 'Title',
'type' => 'text',
'alias' => array( 'title', 'name' ),
'options' => array(
'display_filter' => 'the_title',
'display_filter_args' => array( 'post_ID' )
)
),
'post_content' => array(
'name' => 'post_content',
'label' => 'Content',
'type' => 'wysiwyg',
'alias' => array( 'content' ),
'options' => array(
'wysiwyg_allowed_html_tags' => '',
'display_filter' => 'the_content',
'pre_save' => 0
)
),
'post_excerpt' => array(
'name' => 'post_excerpt',
'label' => 'Excerpt',
'type' => 'paragraph',
'alias' => array( 'excerpt' ),
'options' => array(
'paragraph_allow_html' => 1,
'paragraph_allowed_html_tags' => '',
'display_filter' => 'the_excerpt',
'pre_save' => 0
)
),
'post_author' => array(
'name' => 'post_author',
'label' => 'Author',
'type' => 'pick',
'alias' => array( 'author' ),
'pick_object' => 'user',
'options' => array(
'pick_format_type' => 'single',
'pick_format_single' => 'autocomplete',
'default_value' => '{@user.ID}'
)
),
'post_date' => array(
'name' => 'post_date',
'label' => 'Publish Date',
'type' => 'datetime',
'alias' => array( 'created', 'date' )
),
'post_date_gmt' => array(
'name' => 'post_date_gmt',
'label' => 'Publish Date (GMT)',
'type' => 'datetime',
'alias' => array(),
'hidden' => true
),
'post_status' => array(
'name' => 'post_status',
'label' => 'Status',
'type' => 'pick',
'pick_object' => 'post-status',
'default' => $this->do_hook( 'default_status_' . $pod_name, pods_var( 'default_status', pods_var_raw( 'options', $pod ), 'draft', null, true ), $pod ),
'alias' => array( 'status' )
),
'comment_status' => array(
'name' => 'comment_status',
'label' => 'Comment Status',
'type' => 'text',
'default' => get_option( 'default_comment_status', 'open' ),
'alias' => array(),
'data' => array(
'open' => __( 'Open', 'pods' ),
'closed' => __( 'Closed', 'pods' )
)
),
'ping_status' => array(
'name' => 'ping_status',
'label' => 'Ping Status',
'default' => get_option( 'default_ping_status', 'open' ),
'type' => 'text',
'alias' => array(),
'data' => array(
'open' => __( 'Open', 'pods' ),
'closed' => __( 'Closed', 'pods' )
)
),
'post_password' => array(
'name' => 'post_password',
'label' => 'Password',
'type' => 'text',
'alias' => array()
),
'post_name' => array(
'name' => 'post_name',
'label' => 'Permalink',
'type' => 'slug',
'alias' => array( 'slug', 'permalink' )
),
'to_ping' => array(
'name' => 'to_ping',
'label' => 'To Ping',
'type' => 'text',
'alias' => array(),
'hidden' => true
),
'pinged' => array(
'name' => 'pinged',
'label' => 'Pinged',
'type' => 'text',
'alias' => array(),
'hidden' => true
),
'post_modified' => array(
'name' => 'post_modified',
'label' => 'Last Modified Date',
'type' => 'datetime',
'alias' => array( 'modified' ),
'hidden' => true
),
'post_modified_gmt' => array(
'name' => 'post_modified_gmt',
'label' => 'Last Modified Date (GMT)',
'type' => 'datetime',
'alias' => array(),
'hidden' => true
),
'post_content_filtered' => array(
'name' => 'post_content_filtered',
'label' => 'Content (filtered)',
'type' => 'paragraph',
'alias' => array(),
'hidden' => true,
'options' => array(
'paragraph_allow_html' => 1,
'paragraph_oembed' => 1,
'paragraph_wptexturize' => 1,
'paragraph_convert_chars' => 1,
'paragraph_wpautop' => 1,
'paragraph_allow_shortcode' => 1,
'paragraph_allowed_html_tags' => ''
)
),
'post_parent' => array(
'name' => 'post_parent',
'label' => 'Parent',
'type' => 'pick',
'pick_object' => 'post_type',
'pick_val' => '__current__',
'alias' => array( 'parent' ),
'data' => array(),
'hidden' => true
),
'guid' => array(
'name' => 'guid',
'label' => 'GUID',
'type' => 'text',
'alias' => array(),
'hidden' => true
),
'menu_order' => array(
'name' => 'menu_order',
'label' => 'Menu Order',
'type' => 'number',
'alias' => array()
),
'post_type' => array(
'name' => 'post_type',
'label' => 'Type',
'type' => 'text',
'alias' => array( 'type' ),
'hidden' => true
),
'post_mime_type' => array(
'name' => 'post_mime_type',
'label' => 'Mime Type',
'type' => 'text',
'alias' => array(),
'hidden' => true
),
'comment_count' => array(
'name' => 'comment_count',
'label' => 'Comment Count',
'type' => 'number',
'alias' => array(),
'hidden' => true
)
);
if ( !empty( $pod ) ) {
$taxonomies = get_object_taxonomies( $pod_name, 'objects' );
foreach ( $taxonomies as $taxonomy ) {
$fields[ $taxonomy->name ] = array(
'name' => $taxonomy->name,
'label' => $taxonomy->labels->name,
'type' => 'taxonomy',
'pick_object' => 'taxonomy',
'pick_val' => $taxonomy->name,
'alias' => array(),
'hidden' => true,
'options' => array(
'taxonomy_format_type' => 'multi'
)
);
}
}
}
elseif ( 'user' == $object ) {
$fields = array(
'user_login' => array(
'name' => 'user_login',
'label' => 'Title',
'type' => 'text',
'alias' => array( 'login' ),
'options' => array(
'required' => 1
)
),
'user_nicename' => array(
'name' => 'user_nicename',
'label' => 'Permalink',
'type' => 'slug',
'alias' => array( 'nicename', 'slug', 'permalink' )
),
'display_name' => array(
'name' => 'display_name',
'label' => 'Display Name',
'type' => 'text',
'alias' => array( 'title', 'name' )
),
'user_pass' => array(
'name' => 'user_pass',
'label' => 'Password',
'type' => 'text',
'alias' => array( 'password', 'pass' ),
'options' => array(
'required' => 1,
'text_format_type' => 'password'
)
),
'user_email' => array(
'name' => 'user_email',
'label' => 'E-mail',
'type' => 'text',
'alias' => array( 'email' ),
'options' => array(
'required' => 1,
'text_format_type' => 'email'
)
),
'user_url' => array(
'name' => 'user_url',
'label' => 'URL',
'type' => 'text',
'alias' => array( 'url', 'website' ),
'options' => array(
'required' => 1,
'text_format_type' => 'website',
'text_format_website' => 'normal'
)
),
'user_registered' => array(
'name' => 'user_registered',
'label' => 'Registration Date',
'type' => 'date',
'alias' => array( 'created', 'date', 'registered' ),
'options' => array(
'date_format_type' => 'datetime'
)
)
);
}
elseif ( 'comment' == $object ) {
$fields = array(
'comment_content' => array(
'name' => 'comment_content',
'label' => 'Content',
'type' => 'wysiwyg',
'alias' => array( 'content' )
),
'comment_approved' => array(
'name' => 'comment_approved',
'label' => 'Approved',
'type' => 'number',
'alias' => array( 'approved' )
),
'comment_post_ID' => array(
'name' => 'comment_post_ID',
'label' => 'Post',
'type' => 'pick',
'alias' => array( 'post', 'post_id' ),
'data' => array()
),
'user_id' => array(
'name' => 'user_id',
'label' => 'Author',
'type' => 'pick',
'alias' => array( 'author' ),
'pick_object' => 'user',
'data' => array()
),
'comment_date' => array(
'name' => 'comment_date',
'label' => 'Date',
'type' => 'date',
'alias' => array( 'created', 'date' ),
'options' => array(
'date_format_type' => 'datetime'
)
)
);
}
elseif ( 'taxonomy' == $object ) {
$fields = array(
'name' => array(
'name' => 'name',
'label' => 'Title',
'type' => 'text',
'alias' => array( 'title' )
),
'slug' => array(
'name' => 'slug',
'label' => 'Permalink',
'type' => 'slug',
'alias' => array( 'permalink' )
),
'description' => array(
'name' => 'description',
'label' => 'Description',
'type' => 'wysiwyg',
'alias' => array( 'content' )
),
'taxonomy' => array(
'name' => 'taxonomy',
'label' => 'Taxonomy',
'type' => 'pick',
'alias' => array()
),
'parent' => array(
'name' => 'parent',
'label' => 'Parent',
'type' => 'pick',
'pick_object' => 'taxonomy',
'pick_val' => '__current__',
'alias' => array( 'parent' ),
'data' => array(),
'hidden' => true
),
'term_taxonomy_id' => array(
'name' => 'term_taxonomy_id',
'label' => 'Term Taxonomy ID',
'type' => 'number',
'alias' => array( 'term_taxonomy_id' ),
'hidden' => true
),
'term_group' => array(
'name' => 'term_group',
'label' => 'Term Group',
'type' => 'number',
'alias' => array( 'term_group' ),
'hidden' => true
),
'count' => array(
'name' => 'count',
'label' => 'Count',
'type' => 'number',
'alias' => array( 'count' ),
'hidden' => true
)
);
}
$fields = $this->do_hook( 'get_wp_object_fields', $fields, $object, $pod );
foreach ( $fields as $field => $options ) {
if ( !isset( $options[ 'alias' ] ) )
$options[ 'alias' ] = array();
else
$options[ 'alias' ] = (array) $options[ 'alias' ];
if ( !isset( $options[ 'name' ] ) )
$options[ 'name' ] = $field;
$fields[ $field ] = $options;
}
$fields = PodsForm::fields_setup( $fields );
if ( did_action( 'init' ) && pods_api_cache() )
pods_transient_set( trim( 'pods_api_object_fields_' . $object . $pod_name . '_', '_' ), $fields );
return $fields;
}
/**
*
* @see PodsAPI::save_pod
*
* Add a Pod via the Wizard
*
* $params['create_extend'] string Create or Extend a Content Type
* $params['create_pod_type'] string Pod Type (for Creating)
* $params['create_name'] string Pod Name (for Creating)
* $params['create_label_plural'] string Plural Label (for Creating)
* $params['create_label_singular'] string Singular Label (for Creating)
* $params['create_storage'] string Storage Type (for Creating Post Types)
* $params['create_storage_taxonomy'] string Storage Type (for Creating Taxonomies)
* $params['extend_pod_type'] string Pod Type (for Extending)
* $params['extend_post_type'] string Post Type (for Extending Post Types)
* $params['extend_taxonomy'] string Taxonomy (for Extending Taxonomies)
* $params['extend_storage'] string Storage Type (for Extending Post Types / Users / Comments)
*
* @param array $params An associative array of parameters
*
* @return bool|int Pod ID
* @since 2.0
*/
public function add_pod ( $params ) {
$defaults = array(
'create_extend' => 'create',
'create_pod_type' => 'post_type',
'create_name' => '',
'create_label_singular' => '',
'create_label_plural' => '',
'create_storage' => 'meta',
'create_storage_taxonomy' => 'none',
'create_setting_name' => '',
'create_label_title' => '',
'create_label_menu' => '',
'create_menu_location' => 'settings',
'extend_pod_type' => 'post_type',
'extend_post_type' => 'post',
'extend_taxonomy' => 'category',
'extend_table' => '',
'extend_storage_taxonomy' => 'table',
'extend_storage' => 'meta'
);
$params = (object) array_merge( $defaults, (array) $params );
if ( empty( $params->create_extend ) || !in_array( $params->create_extend, array( 'create', 'extend' ) ) )
return pods_error( __( 'Please choose whether to Create or Extend a Content Type', 'pods' ), $this );
$pod_params = array(
'name' => '',
'label' => '',
'type' => '',
'storage' => 'table',
'object' => '',
'options' => array()
);
if ( 'create' == $params->create_extend ) {
$label = ucwords( str_replace( '_', ' ', $params->create_name ) );
if ( !empty( $params->create_label_singular ) )
$label = $params->create_label_singular;
$pod_params[ 'name' ] = $params->create_name;
$pod_params[ 'label' ] = ( !empty( $params->create_label_plural ) ? $params->create_label_plural : $label );
$pod_params[ 'type' ] = $params->create_pod_type;
$pod_params[ 'options' ] = array(
'label_singular' => ( !empty( $params->create_label_singular ) ? $params->create_label_singular : $pod_params[ 'label' ] ),
'public' => 1,
'show_ui' => 1
);
// Auto-generate name if not provided
if ( empty( $pod_params[ 'name' ] ) && !empty( $pod_params[ 'options' ][ 'label_singular' ] ) )
$pod_params[ 'name' ] = pods_clean_name( $pod_params[ 'options' ][ 'label_singular' ] );
if ( 'post_type' == $pod_params[ 'type' ] ) {
if ( empty( $pod_params[ 'name' ] ) )
return pods_error( 'Please enter a Name for this Pod', $this );
$pod_params[ 'storage' ] = $params->create_storage;
if ( pods_tableless() )
$pod_params[ 'storage' ] = 'meta';
}
elseif ( 'taxonomy' == $pod_params[ 'type' ] ) {
if ( empty( $pod_params[ 'name' ] ) )
return pods_error( 'Please enter a Name for this Pod', $this );
$pod_params[ 'storage' ] = $params->create_storage_taxonomy;
if ( pods_tableless() )
$pod_params[ 'storage' ] = 'none';
}
elseif ( 'pod' == $pod_params[ 'type' ] ) {
if ( empty( $pod_params[ 'name' ] ) )
return pods_error( 'Please enter a Name for this Pod', $this );
if ( pods_tableless() ) {
$pod_params[ 'type' ] = 'post_type';
$pod_params[ 'storage' ] = 'meta';
}
}
elseif ( 'settings' == $pod_params[ 'type' ] ) {
$pod_params[ 'name' ] = $params->create_setting_name;
$pod_params[ 'label' ] = ( !empty( $params->create_label_title ) ? $params->create_label_title : ucwords( str_replace( '_', ' ', $params->create_setting_name ) ) );
$pod_params[ 'options' ] = array(
'menu_name' => ( !empty( $params->create_label_menu ) ? $params->create_label_menu : $pod_params[ 'label' ] ),
'menu_location' => $params->create_menu_location
);
$pod_params[ 'storage' ] = 'none';
// Auto-generate name if not provided
if ( empty( $pod_params[ 'name' ] ) && !empty( $pod_params[ 'label' ] ) )
$pod_params[ 'name' ] = pods_clean_name( $pod_params[ 'label' ] );
if ( empty( $pod_params[ 'name' ] ) )
return pods_error( 'Please enter a Name for this Pod', $this );
}
}
elseif ( 'extend' == $params->create_extend ) {
$pod_params[ 'type' ] = $params->extend_pod_type;
if ( 'post_type' == $pod_params[ 'type' ] ) {
$pod_params[ 'storage' ] = $params->extend_storage;
if ( pods_tableless() )
$pod_params[ 'storage' ] = 'meta';
$pod_params[ 'name' ] = $params->extend_post_type;
}
elseif ( 'taxonomy' == $pod_params[ 'type' ] ) {
$pod_params[ 'storage' ] = $params->extend_storage_taxonomy;
if ( pods_tableless() )
$pod_params[ 'storage' ] = 'none';
$pod_params[ 'name' ] = $params->extend_taxonomy;
}
elseif ( 'table' == $pod_params[ 'type' ] ) {
$pod_params[ 'storage' ] = 'table';
$pod_params[ 'name' ] = $params->extend_table;
}
else {
$pod_params[ 'storage' ] = $params->extend_storage;
if ( pods_tableless() )
$pod_params[ 'storage' ] = 'meta';
$pod_params[ 'name' ] = $params->extend_pod_type;
}
$pod_params[ 'label' ] = ucwords( str_replace( '_', ' ', $pod_params[ 'name' ] ) );
$pod_params[ 'object' ] = $pod_params[ 'name' ];
}
if ( empty( $pod_params[ 'object' ] ) ) {
if ( 'post_type' == $pod_params[ 'type' ] ) {
$check = get_post_type_object( $pod_params[ 'name' ] );
if ( !empty( $check ) )
return pods_error( sprintf( __( 'Post Type %s already exists, try extending it instead', 'pods' ), $pod_params[ 'name' ] ), $this );
$pod_params[ 'options' ][ 'supports_title' ] = 1;
$pod_params[ 'options' ][ 'supports_editor' ] = 1;
}
elseif ( 'taxonomy' == $pod_params[ 'type' ] ) {
$check = get_taxonomy( $pod_params[ 'name' ] );
if ( !empty( $check ) )
return pods_error( sprintf( __( 'Taxonomy %s already exists, try extending it instead', 'pods' ), $pod_params[ 'name' ] ), $this );
}
}
if ( !empty( $pod_params ) )
return $this->save_pod( $pod_params );
return false;
}
/**
* Add or edit a Pod
*
* $params['id'] int The Pod ID
* $params['name'] string The Pod name
* $params['label'] string The Pod label
* $params['type'] string The Pod type
* $params['object'] string The object being extended (if any)
* $params['storage'] string The Pod storage
* $params['options'] array Options
*
* @param array $params An associative array of parameters
* @param bool $sanitized (optional) Decides whether the params have been sanitized before being passed, will sanitize them if false.
* @param bool|int $db (optional) Whether to save into the DB or just return Pod array.
*
* @return int Pod ID
* @since 1.7.9
*/
public function save_pod ( $params, $sanitized = false, $db = true ) {
$tableless_field_types = PodsForm::tableless_field_types();
$simple_tableless_objects = PodsForm::field_method( 'pick', 'simple_objects' );
$load_params = (object) $params;
if ( isset( $load_params->id ) && isset( $load_params->name ) )
unset( $load_params->name );
if ( isset( $load_params->old_name ) )
$load_params->name = $load_params->old_name;
$load_params->table_info = true;
$pod = $this->load_pod( $load_params, false );
$params = (object) $params;
if ( false === $sanitized )
$params = pods_sanitize( $params );
$old_id = $old_name = $old_storage = null;
$old_fields = $old_options = array();
if ( isset( $params->name ) )
$params->name = pods_clean_name( $params->name );
if ( !empty( $pod ) ) {
if ( isset( $params->id ) && 0 < $params->id )
$old_id = $params->id;
$params->id = $pod[ 'id' ];
$old_name = $pod[ 'name' ];
$old_storage = $pod[ 'storage' ];
$old_fields = $pod[ 'fields' ];
$old_options = $pod[ 'options' ];
if ( !isset( $params->name ) && empty( $params->name ) )
$params->name = $pod[ 'name' ];
if ( $old_name != $params->name && false !== $this->pod_exists( array( 'name' => $params->name ) ) )
return pods_error( sprintf( __( 'Pod %s already exists, you cannot rename %s to that', 'pods' ), $params->name, $old_name ), $this );
if ( $old_name != $params->name && in_array( $pod[ 'type' ], array( 'user', 'comment', 'media' ) ) && in_array( $pod[ 'object' ], array( 'user', 'comment', 'media' ) ) )
return pods_error( sprintf( __( 'Pod %s cannot be renamed, it extends an existing WP Object', 'pods' ), $old_name ), $this );
if ( $old_name != $params->name && in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && !empty( $pod[ 'object' ] ) && $pod[ 'object' ] == $old_name )
return pods_error( sprintf( __( 'Pod %s cannot be renamed, it extends an existing WP Object', 'pods' ), $old_name ), $this );
if ( $old_id != $params->id ) {
if ( $params->type == $pod[ 'type' ] && isset( $params->object ) && $params->object == $pod[ 'object' ] )
return pods_error( sprintf( __( 'Pod using %s already exists, you can not reuse an object across multiple pods', 'pods' ), $params->object ), $this );
else
return pods_error( sprintf( __( 'Pod %s already exists', 'pods' ), $params->name ), $this );
}
}
elseif ( in_array( $params->name, array( 'order','orderby','post_type' ) ) && 'post_type' == pods_var( 'type', $params ) ) {
return pods_error( sprintf( 'There are certain names that a Custom Post Types cannot be named and unfortunately, %s is one of them.', $params->name ), $this );
}
else {
$pod = array(
'id' => 0,
'name' => $params->name,
'label' => $params->name,
'description' => '',
'type' => 'pod',
'storage' => 'table',
'object' => '',
'alias' => '',
'options' => array(),
'fields' => array()
);
}
// Blank out fields and options for AJAX calls (everything should be sent to it for a full overwrite)
if ( defined( 'DOING_AJAX' ) && DOING_AJAX ) {
$pod[ 'fields' ] = array();
$pod[ 'options' ] = array();
}
// Setup options
$options = get_object_vars( $params );
if ( isset( $options[ 'method' ] ) )
unset( $options[ 'method' ] );
$options_ignore = array(
'object_type',
'object_name',
'table',
'meta_table',
'pod_table',
'field_id',
'field_index',
'field_slug',
'field_type',
'field_parent',
'field_parent_select',
'meta_field_id',
'meta_field_index',
'meta_field_value',
'pod_field_id',
'pod_field_index',
'object_fields',
'join',
'where',
'where_default',
'orderby',
'pod',
'recurse',
'table_info',
'attributes',
'group',
'grouped',
'developer_mode',
'dependency',
'depends-on',
'excludes-on'
);
foreach ( $options_ignore as $ignore ) {
if ( isset( $options[ $ignore ] ) )
unset( $options[ $ignore ] );
}
$exclude = array(
'id',
'name',
'label',
'description',
'type',
'storage',
'object',
'alias',
'options',
'fields'
);
foreach ( $exclude as $k => $exclude_field ) {
$aliases = array( $exclude_field );
if ( is_array( $exclude_field ) ) {
$aliases = array_merge( array( $k ), $exclude_field );
$exclude_field = $k;
}
foreach ( $aliases as $alias ) {
if ( isset( $options[ $alias ] ) ) {
$pod[ $exclude_field ] = pods_trim( $options[ $alias ] );
unset( $options[ $alias ] );
}
}
}
if ( pods_tableless() && !in_array( $pod[ 'type' ], array( 'settings', 'table' ) ) ) {
if ( 'pod' == $pod[ 'type' ] )
$pod[ 'type' ] = 'post_type';
if ( 'table' == $pod[ 'storage' ] ) {
if ( 'taxonomy' == $pod[ 'type' ] )
$pod[ 'storage' ] = 'none';
else
$pod[ 'storage' ] = 'meta';
}
}
$pod[ 'options' ][ 'type' ] = $pod[ 'type' ];
$pod[ 'options' ][ 'storage' ] = $pod[ 'storage' ];
$pod[ 'options' ][ 'object' ] = $pod[ 'object' ];
$pod[ 'options' ][ 'alias' ] = $pod[ 'alias' ];
$pod[ 'options' ] = array_merge( $pod[ 'options' ], $options );
/**
* @var WP_Query
*/
global $wp_query;
$reserved_query_vars = array_keys( $wp_query->fill_query_vars( array() ) );
if ( isset( $pod[ 'options' ][ 'query_var_string' ] ) ) {
if ( in_array( $pod[ 'options' ][ 'query_var_string' ], $reserved_query_vars ) ) {
$pod[ 'options' ][ 'query_var_string' ] = $pod[ 'options' ][ 'type' ] . '_' . $pod[ 'options' ][ 'query_var_string' ];
}
}
elseif ( isset( $pod[ 'options' ][ 'query_var' ] ) ) {
if ( in_array( $pod[ 'options' ][ 'query_var' ], $reserved_query_vars ) ) {
$pod[ 'options' ][ 'query_var' ] = $pod[ 'options' ][ 'type' ] . '_' . $pod[ 'options' ][ 'query_var' ];
}
}
if ( strlen( $pod[ 'label' ] ) < 1 )
$pod[ 'label' ] = $pod[ 'name' ];
if ( 'post_type' == $pod[ 'type' ] ) {
// Max length for post types are 20 characters
$pod[ 'name' ] = substr( $pod[ 'name' ], 0, 20 );
}
elseif ( 'taxonomy' == $pod[ 'type' ] ) {
// Max length for taxonomies are 32 characters
$pod[ 'name' ] = substr( $pod[ 'name' ], 0, 32 );
}
$params->id = $pod[ 'id' ];
$params->name = $pod[ 'name' ];
if ( null !== $old_name && $old_name != $params->name && empty( $pod[ 'object' ] ) ) {
if ( 'post_type' == $pod[ 'type' ] ) {
$check = get_post_type_object( $params->name );
if ( !empty( $check ) )
return pods_error( sprintf( __( 'Post Type %s already exists, you cannot rename %s to that', 'pods' ), $params->name, $old_name ), $this );
}
elseif ( 'taxonomy' == $pod[ 'type' ] ) {
$check = get_taxonomy( $params->name );
if ( !empty( $check ) )
return pods_error( sprintf( __( 'Taxonomy %s already exists, you cannot rename %s to that', 'pods' ), $params->name, $old_name ), $this );
}
}
$field_table_operation = true;
// Add new pod
if ( empty( $params->id ) ) {
if ( strlen( $params->name ) < 1 )
return pods_error( __( 'Pod name cannot be empty', 'pods' ), $this );
$post_data = array(
'post_name' => $pod[ 'name' ],
'post_title' => $pod[ 'label' ],
'post_content' => $pod[ 'description' ],
'post_type' => '_pods_pod',
'post_status' => 'publish'
);
if ( 'pod' == $pod[ 'type' ] && ( !is_array( $pod[ 'fields' ] ) || empty( $pod[ 'fields' ] ) ) ) {
$pod[ 'fields' ] = array();
$pod[ 'fields' ][ 'name' ] = array(
'name' => 'name',
'label' => 'Name',
'type' => 'text',
'options' => array(
'required' => '1'
)
);
$pod[ 'fields' ][ 'created' ] = array(
'name' => 'created',
'label' => 'Date Created',
'type' => 'datetime',
'options' => array(
'datetime_format' => 'ymd_slash',
'datetime_time_type' => '12',
'datetime_time_format' => 'h_mm_ss_A'
)
);
$pod[ 'fields' ][ 'modified' ] = array(
'name' => 'modified',
'label' => 'Date Modified',
'type' => 'datetime',
'options' => array(
'datetime_format' => 'ymd_slash',
'datetime_time_type' => '12',
'datetime_time_format' => 'h_mm_ss_A'
)
);
$pod[ 'fields' ][ 'author' ] = array(
'name' => 'author',
'label' => 'Author',
'type' => 'pick',
'pick_object' => 'user',
'options' => array(
'pick_format_type' => 'single',
'pick_format_single' => 'autocomplete',
'default_value' => '{@user.ID}'
)
);
$pod[ 'fields' ][ 'permalink' ] = array(
'name' => 'permalink',
'label' => 'Permalink',
'type' => 'slug',
'description' => 'Leave blank to auto-generate from Name'
);
if ( !isset( $pod[ 'options' ][ 'pod_index' ] ) )
$pod[ 'options' ][ 'pod_index' ] = 'name';
}
$pod = $this->do_hook( 'save_pod_default_pod', $pod, $params, $sanitized, $db );
$field_table_operation = false;
}
else {
$post_data = array(
'ID' => $pod[ 'id' ],
'post_name' => $pod[ 'name' ],
'post_title' => $pod[ 'label' ],
'post_content' => $pod[ 'description' ],
'post_status' => 'publish'
);
}
if ( true === $db ) {
if ( !has_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ) ) )
add_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ), 100, 6 );
$conflicted = false;
// Headway compatibility fix
if ( has_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 ) ) {
remove_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
$conflicted = true;
}
$params->id = $this->save_wp_object( 'post', $post_data, $pod[ 'options' ], true, true );
if ( $conflicted )
add_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
if ( false === $params->id )
return pods_error( __( 'Cannot save Pod', 'pods' ), $this );
}
elseif ( empty( $params->id ) )
$params->id = (int) $db;
$pod[ 'id' ] = $params->id;
// Setup / update tables
if ( 'table' != $pod[ 'type' ] && 'table' == $pod[ 'storage' ] && $old_storage != $pod[ 'storage' ] && $db ) {
$definitions = array( "`id` BIGINT(20) UNSIGNED AUTO_INCREMENT PRIMARY KEY" );
$defined_fields = array();
foreach ( $pod[ 'fields' ] as $field ) {
if ( !is_array( $field ) || !isset( $field[ 'name' ] ) || in_array( $field[ 'name' ], $defined_fields ) )
continue;
$defined_fields[] = $field[ 'name' ];
if ( !in_array( $field[ 'type' ], $tableless_field_types ) || ( 'pick' == $field[ 'type' ] && in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) ) ) {
$definition = $this->get_field_definition( $field[ 'type' ], array_merge( $field, pods_var_raw( 'options', $field, array() ) ) );
if ( 0 < strlen( $definition ) )
$definitions[] = "`{$field['name']}` " . $definition;
}
}
pods_query( "DROP TABLE IF EXISTS `@wp_pods_{$params->name}`" );
$result = pods_query( "CREATE TABLE `@wp_pods_{$params->name}` (" . implode( ', ', $definitions ) . ") DEFAULT CHARSET utf8", $this );
if ( empty( $result ) )
return pods_error( __( 'Cannot add Database Table for Pod', 'pods' ), $this );
}
elseif ( 'table' != $pod[ 'type' ] && 'table' == $pod[ 'storage' ] && $pod[ 'storage' ] == $old_storage && null !== $old_name && $old_name != $params->name && $db ) {
$result = pods_query( "ALTER TABLE `@wp_pods_{$old_name}` RENAME `@wp_pods_{$params->name}`", $this );
if ( empty( $result ) )
return pods_error( __( 'Cannot update Database Table for Pod', 'pods' ), $this );
}
/**
* @var $wpdb wpdb
*/
global $wpdb;
if ( null !== $old_name && $old_name != $params->name && $db ) {
// Rename items in the DB pointed at the old WP Object names
if ( 'post_type' == $pod[ 'type' ] && empty( $pod[ 'object' ] ) ) {
$this->rename_wp_object_type( 'post', $old_name, $params->name );
}
elseif ( 'taxonomy' == $pod[ 'type' ] && empty( $pod[ 'object' ] ) ) {
$this->rename_wp_object_type( 'taxonomy', $old_name, $params->name );
}
elseif ( 'comment' == $pod[ 'type' ] && empty( $pod[ 'object' ] ) ) {
$this->rename_wp_object_type( 'comment', $old_name, $params->name );
}
elseif ( 'settings' == $pod[ 'type' ] ) {
$this->rename_wp_object_type( 'settings', $old_name, $params->name );
}
// Sync any related fields if the name has changed
$fields = pods_query( "
SELECT `p`.`ID`
FROM `{$wpdb->posts}` AS `p`
LEFT JOIN `{$wpdb->postmeta}` AS `pm` ON `pm`.`post_id` = `p`.`ID`
LEFT JOIN `{$wpdb->postmeta}` AS `pm2` ON `pm2`.`post_id` = `p`.`ID`
WHERE
`p`.`post_type` = '_pods_field'
AND `pm`.`meta_key` = 'pick_object'
AND (
`pm`.`meta_value` = 'pod'
OR `pm`.`meta_value` = '" . $pod[ 'type' ] . "'
)
AND `pm2`.`meta_key` = 'pick_val'
AND `pm2`.`meta_value` = '{$old_name}'
" );
if ( !empty( $fields ) ) {
foreach ( $fields as $field ) {
update_post_meta( $field->ID, 'pick_object', $pod[ 'type' ] );
update_post_meta( $field->ID, 'pick_val', $params->name );
}
}
$fields = pods_query( "
SELECT `p`.`ID`
FROM `{$wpdb->posts}` AS `p`
LEFT JOIN `{$wpdb->postmeta}` AS `pm` ON `pm`.`post_id` = `p`.`ID`
WHERE
`p`.`post_type` = '_pods_field'
AND `pm`.`meta_key` = 'pick_object'
AND (
`pm`.`meta_value` = 'pod-{$old_name}'
OR `pm`.`meta_value` = '" . $pod[ 'type' ] . "-{$old_name}'
)
" );
if ( !empty( $fields ) ) {
foreach ( $fields as $field ) {
update_post_meta( $field->ID, 'pick_object', $pod[ 'type' ] );
update_post_meta( $field->ID, 'pick_val', $params->name );
}
}
}
// Sync built-in options for post types and taxonomies
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && empty( $pod[ 'object' ] ) && $db ) {
// Build list of 'built_in' for later
$built_in = array();
foreach ( $pod[ 'options' ] as $key => $val ) {
if ( false === strpos( $key, 'built_in_' ) )
continue;
elseif ( false !== strpos( $key, 'built_in_post_types_' ) )
$built_in_type = 'post_type';
elseif ( false !== strpos( $key, 'built_in_taxonomies_' ) )
$built_in_type = 'taxonomy';
else
continue;
if ( $built_in_type == $pod[ 'type' ] )
continue;
if ( !isset( $built_in[ $built_in_type ] ) )
$built_in[ $built_in_type ] = array();
$built_in_object = str_replace( array( 'built_in_post_types_', 'built_in_taxonomies_' ), '', $key );
$built_in[ $built_in_type ][ $built_in_object ] = (int) $val;
}
$lookup_option = $lookup_built_in = false;
$lookup_name = $pod[ 'name' ];
if ( 'post_type' == $pod[ 'type' ] ) {
$lookup_option = 'built_in_post_types_' . $lookup_name;
$lookup_built_in = 'taxonomy';
}
elseif ( 'taxonomy' == $pod[ 'type' ] ) {
$lookup_option = 'built_in_taxonomies_' . $lookup_name;
$lookup_built_in = 'post_type';
}
if ( !empty( $lookup_option ) && !empty( $lookup_built_in ) && isset( $built_in[ $lookup_built_in ] ) ) {
foreach ( $built_in[ $lookup_built_in ] as $built_in_object => $val ) {
$search_val = 1;
if ( 1 == $val )
$search_val = 0;
$query = "SELECT p.ID FROM {$wpdb->posts} AS p
LEFT JOIN {$wpdb->postmeta} AS pm ON pm.post_id = p.ID AND pm.meta_key = '{$lookup_option}'
LEFT JOIN {$wpdb->postmeta} AS pm2 ON pm2.post_id = p.ID AND pm2.meta_key = 'type' AND pm2.meta_value = '{$lookup_built_in}'
LEFT JOIN {$wpdb->postmeta} AS pm3 ON pm3.post_id = p.ID AND pm3.meta_key = 'object' AND pm3.meta_value = ''
WHERE p.post_type = '_pods_pod' AND p.post_name = '{$built_in_object}'
AND pm2.meta_id IS NOT NULL
AND ( pm.meta_id IS NULL OR pm.meta_value = {$search_val} )";
$results = pods_query( $query );
if ( !empty( $results ) ) {
foreach ( $results as $the_pod ) {
delete_post_meta( $the_pod->ID, $lookup_option );
add_post_meta( $the_pod->ID, $lookup_option, $val );
}
}
}
}
}
$saved = array();
$errors = array();
$field_index_change = false;
$field_index_id = 0;
$id_required = false;
$field_index = pods_var( 'pod_index', $pod[ 'options' ], 'id', null, true );
if ( 'pod' == $pod[ 'type' ] && !empty( $pod[ 'fields' ] ) && isset( $pod[ 'fields' ][ $field_index ] ) )
$field_index_id = $pod[ 'fields' ][ $field_index ];
if ( isset( $params->fields ) || ( defined( 'DOING_AJAX' ) && DOING_AJAX ) ) {
$fields = array();
if ( isset( $params->fields ) ) {
$params->fields = (array) $params->fields;
$weight = 0;
foreach ( $params->fields as $field ) {
if ( !is_array( $field ) || !isset( $field[ 'name' ] ) )
continue;
if ( !isset( $field[ 'weight' ] ) ) {
$field[ 'weight' ] = $weight;
$weight++;
}
$fields[ $field[ 'name' ] ] = $field;
}
}
$weight = 0;
$saved_field_ids = array();
foreach ( $pod[ 'fields' ] as $k => $field ) {
if ( !empty( $old_id ) && ( !is_array( $field ) || !isset( $field[ 'name' ] ) || !isset( $fields[ $field[ 'name' ] ] ) ) ) {
// Iterative change handling for setup-edit.php
if ( !is_array( $field ) && isset( $old_fields[ $k ] ) )
$saved[ $old_fields[ $k ][ 'name' ] ] = true;
continue;
}
if ( !empty( $old_id ) )
$field = array_merge( $field, $fields[ $field[ 'name' ] ] );
$field[ 'pod' ] = $pod;
if ( !isset( $field[ 'weight' ] ) ) {
$field[ 'weight' ] = $weight;
$weight++;
}
if ( 0 < $field_index_id && pods_var( 'id', $field ) == $field_index_id )
$field_index_change = $field[ 'name' ];
if ( 0 < pods_var( 'id', $field ) )
$id_required = true;
if ( $id_required )
$field[ 'id_required' ] = true;
$field_data = $field;
$field = $this->save_field( $field_data, $field_table_operation, true, $db );
if ( true !== $db ) {
$pod[ 'fields' ][ $k ] = $field;
$saved_field_ids[] = $field[ 'id' ];
}
else {
if ( !empty( $field ) && 0 < $field ) {
$saved[ $field_data[ 'name' ] ] = true;
$saved_field_ids[] = $field;
}
else
$errors[] = sprintf( __( 'Cannot save the %s field', 'pods' ), $field_data[ 'name' ] );
}
}
if ( true === $db ) {
foreach ( $old_fields as $field ) {
if ( isset( $pod[ 'fields' ][ $field[ 'name' ] ] ) || isset( $saved[ $field[ 'name' ] ] ) || in_array( $field[ 'id' ], $saved_field_ids ) )
continue;
if ( $field[ 'id' ] == $field_index_id )
$field_index_change = 'id';
elseif ( $field[ 'name' ] == $field_index )
$field_index_change = 'id';
$this->delete_field( array(
'id' => (int) $field[ 'id' ],
'name' => $field[ 'name' ],
'pod' => $pod
), $field_table_operation );
}
}
// Update field index if the name has changed or the field has been removed
if ( false !== $field_index_change && true === $db )
update_post_meta( $pod[ 'id' ], 'pod_index', $field_index_change );
}
if ( !empty( $errors ) )
return pods_error( $errors, $this );
$this->cache_flush_pods( $pod );
if ( 'post_type' == $pod[ 'type' ] )
PodsMeta::$post_types[ $pod[ 'id' ] ] = $this->load_pod( array( 'name' => $pod[ 'name' ] ) );
elseif ( 'taxonomy' == $pod[ 'type' ] )
PodsMeta::$taxonomies[ $pod[ 'id' ] ] = $this->load_pod( array( 'name' => $pod[ 'name' ] ) );
elseif ( 'media' == $pod[ 'type' ] )
PodsMeta::$media[ $pod[ 'id' ] ] = $this->load_pod( array( 'name' => $pod[ 'name' ] ) );
elseif ( 'user' == $pod[ 'type' ] )
PodsMeta::$user[ $pod[ 'id' ] ] = $this->load_pod( array( 'name' => $pod[ 'name' ] ) );
elseif ( 'comment' == $pod[ 'type' ] )
PodsMeta::$comment[ $pod[ 'id' ] ] = $this->load_pod( array( 'name' => $pod[ 'name' ] ) );
// Register Post Types / Taxonomies post-registration from PodsInit
if ( !empty( PodsInit::$content_types_registered ) && in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && empty( $pod[ 'object' ] ) ) {
global $pods_init;
$pods_init->setup_content_types( true );
}
if ( true === $db )
return $pod[ 'id' ];
else
return $pod;
}
/**
* Add or edit a field within a Pod
*
* $params['id'] int Field ID (id OR pod_id+pod+name required)
* $params['pod_id'] int Pod ID (id OR pod_id+pod+name required)
* $params['pod'] string Pod name (id OR pod_id+pod+name required)
* $params['name'] string Field name (id OR pod_id+pod+name required)
* $params['label'] string (optional) Field label
* $params['type'] string (optional) Field type (avatar, boolean, code, color, currency, date, datetime, email, file, number, paragraph, password, phone, pick, slug, text, time, website, wysiwyg)
* $params['pick_object'] string (optional) Related Object (for relationships)
* $params['pick_val'] string (optional) Related Object name (for relationships)
* $params['sister_id'] int (optional) Related Field ID (for bidirectional relationships)
* $params['weight'] int (optional) Order in which the field appears
* $params['options'] array (optional) Options
*
* @param array $params An associative array of parameters
* @param bool $table_operation (optional) Whether or not to handle table operations
* @param bool $sanitized (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
* @param bool|int $db (optional) Whether to save into the DB or just return field array.
*
* @return int|array The field ID or field array (if !$db)
* @since 1.7.9
*/
public function save_field ( $params, $table_operation = true, $sanitized = false, $db = true ) {
/**
* @var $wpdb wpdb
*/
global $wpdb;
if ( true !== $db )
$table_operation = false;
$tableless_field_types = PodsForm::tableless_field_types();
$simple_tableless_objects = PodsForm::field_method( 'pick', 'simple_objects' );
$params = (object) $params;
if ( false === $sanitized )
$params = pods_sanitize( $params );
if ( isset( $params->pod_id ) )
$params->pod_id = pods_absint( $params->pod_id );
if ( true !== $db )
$params->pod_id = (int) $db;
$pod = null;
$save_pod = false;
$id_required = false;
if ( isset( $params->id_required ) ) {
unset( $params->id_required );
$id_required = true;
}
if ( ( !isset( $params->pod ) || empty( $params->pod ) ) && ( !isset( $params->pod_id ) || empty( $params->pod_id ) ) )
return pods_error( __( 'Pod ID or name is required', 'pods' ), $this );
if ( isset( $params->pod ) && is_array( $params->pod ) ) {
$pod = $params->pod;
$save_pod = true;
}
elseif ( ( !isset( $params->pod_id ) || empty( $params->pod_id ) ) && ( true === $db || 0 < $db ) )
$pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => true ) );
elseif ( !isset( $params->pod ) && ( true === $db || 0 < $db ) )
$pod = $this->load_pod( array( 'id' => $params->pod_id, 'table_info' => true ) );
elseif ( true === $db || 0 < $db )
$pod = $this->load_pod( array( 'id' => $params->pod_id, 'name' => $params->pod, 'table_info' => true ) );
if ( empty( $pod ) && true === $db )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$params->pod_id = $pod[ 'id' ];
$params->pod = $pod[ 'name' ];
$params->pod_data = $pod;
$params->name = pods_clean_name( $params->name, true, ( 'meta' == $pod[ 'storage' ] ? false : true ) );
if ( !isset( $params->id ) )
$params->id = 0;
if ( empty( $params->name ) )
return pods_error( 'Pod field name is required', $this );
$field = $this->load_field( $params );
unset( $params->pod_data );
$old_id = $old_name = $old_type = $old_definition = $old_simple = $old_options = $old_sister_id = null;
if ( !empty( $field ) ) {
$old_id = pods_var( 'id', $field );
$old_name = pods_clean_name( $field[ 'name' ], true, ( 'meta' == $pod[ 'storage' ] ? false : true ) );
$old_type = $field[ 'type' ];
$old_options = $field[ 'options' ];
$old_sister_id = (int) pods_var( 'sister_id', $old_options, 0 );
$old_simple = ( 'pick' == $old_type && in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) );
if ( isset( $params->name ) && !empty( $params->name ) )
$field[ 'name' ] = $params->name;
if ( $old_name != $field[ 'name' ] && false !== $this->field_exists( $params ) )
return pods_error( sprintf( __( 'Field %s already exists, you cannot rename %s to that', 'pods' ), $field[ 'name' ], $old_name ), $this );
if ( ( $id_required || !empty( $params->id ) ) && ( empty( $old_id ) || $old_id != $params->id ) )
return pods_error( sprintf( __( 'Field %s already exists', 'pods' ), $field[ 'name' ] ), $this );
if ( empty( $params->id ) )
$params->id = $old_id;
if ( !in_array( $old_type, $tableless_field_types ) || $old_simple ) {
$definition = $this->get_field_definition( $old_type, array_merge( $field, $old_options ) );
if ( 0 < strlen( $definition ) )
$old_definition = "`{$old_name}` " . $definition;
}
}
else {
$field = array(
'id' => 0,
'pod_id' => $params->pod_id,
'name' => $params->name,
'label' => $params->name,
'description' => '',
'type' => 'text',
'pick_object' => '',
'pick_val' => '',
'sister_id' => '',
'weight' => null,
'options' => array()
);
}
// Setup options
$options = get_object_vars( $params );
$options_ignore = array(
'method',
'table_info',
'attributes',
'group',
'grouped',
'developer_mode',
'dependency',
'depends-on',
'excludes-on'
);
foreach ( $options_ignore as $ignore ) {
if ( isset( $options[ $ignore ] ) )
unset( $options[ $ignore ] );
}
if ( isset( $options[ 'method' ] ) )
unset( $options[ 'method' ] );
elseif ( isset( $options[ 'table_info' ] ) )
unset( $options[ 'table_info' ] );
$exclude = array(
'id',
'pod_id',
'pod',
'name',
'label',
'description',
'type',
'pick_object',
'pick_val',
'sister_id',
'weight',
'options'
);
foreach ( $exclude as $k => $exclude_field ) {
$aliases = array( $exclude_field );
if ( is_array( $exclude_field ) ) {
$aliases = array_merge( array( $k ), $exclude_field );
$exclude_field = $k;
}
foreach ( $aliases as $alias ) {
if ( isset( $options[ $alias ] ) ) {
$field[ $exclude_field ] = pods_trim( $options[ $alias ] );
unset( $options[ $alias ] );
}
}
}
if ( strlen( $field[ 'label' ] ) < 1 )
$field[ 'label' ] = $field[ 'name' ];
$field[ 'options' ][ 'type' ] = $field[ 'type' ];
if ( in_array( $field[ 'options' ][ 'type' ], $tableless_field_types ) ) {
// Clean up special drop-down in field editor and save out pick_val
$field[ 'pick_object' ] = pods_var( 'pick_object', $field, '', null, true );
if ( 0 === strpos( $field[ 'pick_object' ], 'pod-' ) ) {
$field[ 'pick_val' ] = pods_str_replace( 'pod-', '', $field[ 'pick_object' ], 1 );
$field[ 'pick_object' ] = 'pod';
}
elseif ( 0 === strpos( $field[ 'pick_object' ], 'post_type-' ) ) {
$field[ 'pick_val' ] = pods_str_replace( 'post_type-', '', $field[ 'pick_object' ], 1 );
$field[ 'pick_object' ] = 'post_type';
}
elseif ( 0 === strpos( $field[ 'pick_object' ], 'taxonomy-' ) ) {
$field[ 'pick_val' ] = pods_str_replace( 'taxonomy-', '', $field[ 'pick_object' ], 1 );
$field[ 'pick_object' ] = 'taxonomy';
}
elseif ( 'table' == $field[ 'pick_object' ] && 0 < strlen( pods_var_raw( 'pick_table', $field[ 'options' ] ) ) ) {
$field[ 'pick_val' ] = $field[ 'options' ][ 'pick_table' ];
$field[ 'pick_object' ] = 'table';
}
elseif ( false === strpos( $field[ 'pick_object' ], '-' ) && !in_array( $field[ 'pick_object' ], array( 'pod', 'post_type', 'taxonomy' ) ) )
$field[ 'pick_val' ] = '';
$field[ 'options' ][ 'pick_object' ] = $field[ 'pick_object' ];
$field[ 'options' ][ 'pick_val' ] = $field[ 'pick_val' ];
$field[ 'options' ][ 'sister_id' ] = pods_var( 'sister_id', $field );
unset( $field[ 'pick_object' ] );
unset( $field[ 'pick_val' ] );
if ( isset( $field[ 'sister_id' ] ) )
unset( $field[ 'sister_id' ] );
}
$field[ 'options' ] = array_merge( $field[ 'options' ], $options );
$object_fields = (array) pods_var_raw( 'object_fields', $pod, array(), null, true );
if ( 0 < $old_id && defined( 'PODS_FIELD_STRICT' ) && !PODS_FIELD_STRICT )
$params->id = $field[ 'id' ] = $old_id;
// Add new field
if ( !isset( $params->id ) || empty( $params->id ) || empty( $field ) ) {
if ( $table_operation && in_array( $field[ 'name' ], array( 'created', 'modified' ) ) && !in_array( $field[ 'type' ], array( 'date', 'datetime' ) ) && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
if ( $table_operation && 'author' == $field[ 'name' ] && 'pick' != $field[ 'type' ] && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
if ( in_array( $field[ 'name' ], array( 'id', 'ID' ) ) )
return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
foreach ( $object_fields as $object_field => $object_field_opt ) {
if ( $object_field == $field[ 'name' ] || in_array( $field[ 'name' ], $object_field_opt[ 'alias' ] ) )
return pods_error( sprintf( __( '%s is reserved for internal WordPress or Pods usage, please try a different name. Also consider what WordPress and Pods provide you built-in.', 'pods' ), $field[ 'name' ] ), $this );
}
if ( in_array( $field[ 'name' ], array( 'rss' ) ) ) // Reserved post_name values that can't be used as field names
$field[ 'name' ] .= '2';
if ( 'slug' == $field[ 'type' ] && true === $db ) {
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy', 'user' ) ) )
return pods_error( __( 'This pod already has an internal WordPress permalink field', 'pods' ), $this );
$slug_field = get_posts( array(
'post_type' => '_pods_field',
'orderby' => 'menu_order',
'order' => 'ASC',
'posts_per_page' => 1,
'post_parent' => $field[ 'pod_id' ],
'meta_query' => array(
array(
'key' => 'type',
'value' => 'slug'
)
)
) );
if ( !empty( $slug_field ) )
return pods_error( __( 'This pod already has a permalink field', 'pods' ), $this );
}
// Sink the new field to the bottom of the list
if ( null === $field[ 'weight' ] ) {
$field[ 'weight' ] = 0;
$bottom_most_field = get_posts( array(
'post_type' => '_pods_field',
'orderby' => 'menu_order',
'order' => 'DESC',
'posts_per_page' => 1,
'post_parent' => $field[ 'pod_id' ]
) );
if ( !empty( $bottom_most_field ) )
$field[ 'weight' ] = pods_absint( $bottom_most_field[ 0 ]->menu_order ) + 1;
}
$field[ 'weight' ] = pods_absint( $field[ 'weight' ] );
$post_data = array(
'post_name' => $field[ 'name' ],
'post_title' => $field[ 'label' ],
'post_content' => $field[ 'description' ],
'post_type' => '_pods_field',
'post_parent' => $field[ 'pod_id' ],
'post_status' => 'publish',
'menu_order' => $field[ 'weight' ]
);
}
else {
if ( in_array( $field[ 'name' ], array( 'id', 'ID' ) ) ) {
if ( null !== $old_name )
return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
else
return pods_error( sprintf( __( '%s is not editable', 'pods' ), $field[ 'name' ] ), $this );
}
if ( null !== $old_name && $field[ 'name' ] != $old_name && in_array( $field[ 'name' ], array( 'created', 'modified' ) ) && !in_array( $field[ 'type' ], array( 'date', 'datetime' ) ) && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
if ( null !== $old_name && $field[ 'name' ] != $old_name && 'author' == $field[ 'name' ] && 'pick' != $field[ 'type' ] && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
foreach ( $object_fields as $object_field => $object_field_opt ) {
if ( $object_field != $field[ 'name' ] && !in_array( $field[ 'name' ], $object_field_opt[ 'alias' ] ) )
continue;
if ( null !== $old_name )
return pods_error( sprintf( __( '%s is reserved for internal WordPress or Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
else
return pods_error( sprintf( __( '%s is not editable', 'pods' ), $field[ 'name' ] ), $this );
}
$post_data = array(
'ID' => $field[ 'id' ],
'post_name' => $field[ 'name' ],
'post_title' => $field[ 'label' ],
'post_content' => $field[ 'description' ]
);
if ( null !== $field[ 'weight' ] ) {
$field[ 'weight' ] = pods_absint( $field[ 'weight' ] );
$post_data[ 'menu_order' ] = $field[ 'weight' ];
}
}
if ( true === $db ) {
if ( !has_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ) ) )
add_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ), 100, 6 );
$conflicted = false;
// Headway compatibility fix
if ( has_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 ) ) {
remove_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
$conflicted = true;
}
$params->id = $this->save_wp_object( 'post', $post_data, $field[ 'options' ], true, true );
if ( $conflicted )
add_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
if ( false === $params->id )
return pods_error( __( 'Cannot save Field', 'pods' ), $this );
}
else
$params->id = $field[ 'name' ];
$field[ 'id' ] = $params->id;
$simple = ( 'pick' == $field[ 'type' ] && in_array( pods_var( 'pick_object', $field[ 'options' ] ), $simple_tableless_objects ) );
$definition = false;
if ( !in_array( $field[ 'type' ], $tableless_field_types ) || $simple ) {
$field_definition = $this->get_field_definition( $field[ 'type' ], array_merge( $field, $field[ 'options' ] ) );
if ( 0 < strlen( $field_definition ) )
$definition = '`' . $field[ 'name' ] . '` ' . $field_definition;
}
$sister_id = (int) pods_var( 'sister_id', $field[ 'options' ], 0 );
if ( $table_operation && 'table' == $pod[ 'storage' ] && !pods_tableless() ) {
if ( !empty( $old_id ) ) {
if ( $field[ 'type' ] != $old_type && empty( $definition ) )
pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` DROP COLUMN `{$old_name}`", false );
elseif ( 0 < strlen( $definition ) ) {
if ( $old_name != $field[ 'name' ] ) {
$test = false;
if ( 0 < strlen( $old_definition ) )
$test = pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` CHANGE `{$old_name}` {$definition}", false );
// If the old field doesn't exist, continue to add a new field
if ( false === $test )
pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` ADD COLUMN {$definition}", __( 'Cannot create new field', 'pods' ) );
}
elseif ( null !== $old_definition && $definition != $old_definition ) {
$test = pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` CHANGE `{$old_name}` {$definition}", false );
// If the old field doesn't exist, continue to add a new field
if ( false === $test )
pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` ADD COLUMN {$definition}", __( 'Cannot create new field', 'pods' ) );
}
}
}
elseif ( 0 < strlen( $definition ) ) {
$test = false;
if ( 0 < strlen( $old_definition ) )
$test = pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` CHANGE `" . $field[ 'name' ] . "` {$definition}", false );
// If the old field doesn't exist, continue to add a new field
if ( false === $test )
pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` ADD COLUMN {$definition}", __( 'Cannot create new field', 'pods' ) );
}
}
if ( !empty( $old_id ) && 'meta' == $pod[ 'storage' ] && $old_name != $field[ 'name' ] && $pod[ 'meta_table' ] != $pod[ 'table' ] ) {
$prepare = array(
$field[ 'name' ],
$old_name
);
// Users don't have a type
if ( !empty( $pod[ 'field_type' ] ) )
$prepare[] = $pod[ 'name' ];
pods_query( "
UPDATE `{$pod[ 'meta_table' ]}` AS `m`
LEFT JOIN `{$pod[ 'table' ]}` AS `t`
ON `t`.`{$pod[ 'field_id' ]}` = `m`.`{$pod[ 'meta_field_id' ]}`
SET
`m`.`{$pod[ 'meta_field_index' ]}` = %s
WHERE
`m`.`{$pod[ 'meta_field_index' ]}` = %s
" . ( !empty( $pod[ 'field_type' ] ) ? " AND `t`.`{$pod[ 'field_type' ]}` = %s" : "" ),
$prepare
);
}
if ( $field[ 'type' ] != $old_type && in_array( $old_type, $tableless_field_types ) ) {
delete_post_meta( $old_sister_id, 'sister_id' );
if ( true === $db ) {
pods_query( "
DELETE pm
FROM {$wpdb->postmeta} AS pm
LEFT JOIN {$wpdb->posts} AS p
ON p.post_type = '_pods_field'
AND p.ID = pm.post_id
WHERE
p.ID IS NOT NULL
AND pm.meta_key = 'sister_id'
AND pm.meta_value = %d
", array(
$params->id
)
);
if ( !pods_tableless() ) {
pods_query( "DELETE FROM @wp_podsrel WHERE `field_id` = {$params->id}", false );
pods_query( "
UPDATE `@wp_podsrel`
SET `related_field_id` = 0
WHERE `field_id` = %d
", array(
$old_sister_id
)
);
}
}
}
elseif ( 0 < $sister_id ) {
update_post_meta( $sister_id, 'sister_id', $params->id );
if ( true === $db && ( !pods_tableless() ) ) {
pods_query( "
UPDATE `@wp_podsrel`
SET `related_field_id` = %d
WHERE `field_id` = %d
",
array(
$params->id,
$sister_id
)
);
}
}
elseif ( 0 < $old_sister_id ) {
delete_post_meta( $old_sister_id, 'sister_id' );
if ( true === $db && ( !pods_tableless() ) ) {
pods_query( "
UPDATE `@wp_podsrel`
SET `related_field_id` = 0
WHERE `field_id` = %d
", array(
$old_sister_id
)
);
}
}
if ( !empty( $old_id ) && $old_name != $field[ 'name' ] && true === $db ) {
pods_query( "
UPDATE `@wp_postmeta`
SET `meta_value` = %s
WHERE
`post_id` = %d
AND `meta_key` = 'pod_index'
AND `meta_value` = %s
", array(
$field[ 'name' ],
$pod[ 'id' ],
$old_name
)
);
}
if ( !$save_pod )
$this->cache_flush_pods( $pod );
else {
pods_transient_clear( 'pods_field_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
if ( !empty( $old_id ) && $old_name != $field[ 'name' ] )
pods_transient_clear( 'pods_field_' . $pod[ 'name' ] . '_' . $old_name );
}
if ( true === $db )
return $params->id;
else
return $field;
}
/**
* Fix Pod / Field post_name to ensure they are exactly as saved (allow multiple posts w/ same post_name)
*
* @param string $slug Unique slug value
* @param int $post_ID Post ID
* @param string $post_status Post Status
* @param string $post_type Post Type
* @param int $post_parent Post Parent ID
* @param string $original_slug Original slug value
*
* @return string Final slug value
*
* @since 2.3.3
*/
public function save_slug_fix ( $slug, $post_ID, $post_status, $post_type, $post_parent = 0, $original_slug = null ) {
if ( in_array( $post_type, array( '_pods_field', '_pods_pod' ) ) && false !== strpos( $slug, '-' ) )
$slug = $original_slug;
return $slug;
}
/**
* Add or Edit a Pods Object
*
* $params['id'] int The Object ID
* $params['name'] string The Object name
* $params['type'] string The Object type
* $params['options'] Associative array of Object options
*
* @param array|object $params An associative array of parameters
* @param bool $sanitized (optional) Decides whether the params have been sanitized before being passed, will sanitize them if false.
*
* @return int The Object ID
* @since 2.0
*/
public function save_object ( $params, $sanitized = false ) {
$params = (object) $params;
if ( false === $sanitized )
$params = pods_sanitize( $params );
if ( !isset( $params->name ) || empty( $params->name ) )
return pods_error( __( 'Name must be given to save an Object', 'pods' ), $this );
if ( !isset( $params->type ) || empty( $params->type ) )
return pods_error( __( 'Type must be given to save an Object', 'pods' ), $this );
$object = array(
'id' => 0,
'name' => $params->name,
'type' => $params->type,
'code' => '',
'options' => array()
);
// Setup options
$options = get_object_vars( $params );
if ( isset( $options[ 'method' ] ) )
unset( $options[ 'method' ] );
$exclude = array(
'id',
'name',
'helper_type',
'code',
'options',
'status'
);
foreach ( $exclude as $k => $exclude_field ) {
$aliases = array( $exclude_field );
if ( is_array( $exclude_field ) ) {
$aliases = array_merge( array( $k ), $exclude_field );
$exclude_field = $k;
}
foreach ( $aliases as $alias ) {
if ( isset( $options[ $alias ] ) ) {
$object[ $exclude_field ] = pods_trim( $options[ $alias ] );
unset( $options[ $alias ] );
}
}
}
if ( 'helper' == $object[ 'type' ] )
$object[ 'options' ][ 'helper_type' ] = $object[ 'helper_type' ];
if ( isset( $object[ 'options' ][ 'code' ] ) )
unset( $object[ 'options' ][ 'code' ] );
$object[ 'options' ] = array_merge( $object[ 'options' ], $options );
$post_data = array(
'post_name' => pods_clean_name( $object[ 'name' ], true),
'post_title' => $object[ 'name' ],
'post_content' => $object[ 'code' ],
'post_type' => '_pods_' . $object[ 'type' ],
'post_status' => 'publish'
);
if ( !empty( $object[ 'id' ] ) )
$post_data[ 'ID' ] = $object[ 'id' ];
if ( null !== pods_var( 'status', $object, null, null, true ) )
$post_data[ 'post_status' ] = pods_var( 'status', $object, null, null, true );
remove_filter( 'content_save_pre', 'balanceTags', 50 );
$post_data = pods_sanitize( $post_data );
$params->id = $this->save_post( $post_data, $object[ 'options' ], true, true );
pods_transient_clear( 'pods_objects_' . $params->type );
pods_transient_clear( 'pods_objects_' . $params->type . '_get' );
return $params->id;
}
/**
* @see PodsAPI::save_object
*
* Add or edit a Pod Template
*
* $params['id'] int The template ID
* $params['name'] string The template name
* $params['code'] string The template code
*
* @param array|object $params An associative array of parameters
* @param bool $sanitized (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
*
* @return int The Template ID
*
* @since 1.7.9
*/
public function save_template ( $params, $sanitized = false ) {
$params = (object) $params;
$params->type = 'template';
return $this->save_object( $params, $sanitized );
}
/**
* @see PodsAPI::save_object
*
* Add or edit a Pod Page
*
* $params['id'] int The page ID
* $params['name'] string The page URI
* $params['code'] string The page code
*
* @param array|object $params An associative array of parameters
* @param bool $sanitized (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
*
* @return int The page ID
* @since 1.7.9
*/
public function save_page ( $params, $sanitized = false ) {
$params = (object) $params;
if ( !isset( $params->name ) ) {
$params->name = $params->uri;
unset( $params->uri );
}
if ( isset( $params->phpcode ) ) {
$params->code = $params->phpcode;
unset( $params->phpcode );
}
$params->name = trim( $params->name, '/' );
$params->type = 'page';
return $this->save_object( $params, $sanitized );
}
/**
* @see PodsAPI::save_object
*
* Add or edit a Pod Helper
*
* $params['id'] int The helper ID
* $params['name'] string The helper name
* $params['helper_type'] string The helper type ("pre_save", "display", etc)
* $params['code'] string The helper code
*
* @param array $params An associative array of parameters
* @param bool $sanitized (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
*
* @return int The helper ID
* @since 1.7.9
*/
public function save_helper ( $params, $sanitized = false ) {
$params = (object) $params;
if ( isset( $params->phpcode ) ) {
$params->code = $params->phpcode;
unset( $params->phpcode );
}
if ( isset( $params->type ) ) {
$params->helper_type = $params->type;
unset( $params->type );
}
$params->type = 'helper';
return $this->save_object( $params, $sanitized );
}
/**
* Add or edit a single pod item
*
* $params['pod'] string The Pod name (pod or pod_id is required)
* $params['pod_id'] string The Pod ID (pod or pod_id is required)
* $params['id'] int The item ID
* $params['data'] array (optional) Associative array of field names + values
* $params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
*
* @param array|object $params An associative array of parameters
*
* @return int The item ID
*
* @since 1.7.9
*/
public function save_pod_item ( $params ) {
$params = (object) pods_str_replace( '@wp_', '{prefix}', $params );
$tableless_field_types = PodsForm::tableless_field_types();
$repeatable_field_types = PodsForm::repeatable_field_types();
$simple_tableless_objects = PodsForm::field_method( 'pick', 'simple_objects' );
// @deprecated 2.0
if ( isset( $params->datatype ) ) {
pods_deprecated( '$params->pod instead of $params->datatype', '2.0' );
$params->pod = $params->datatype;
unset( $params->datatype );
if ( isset( $params->pod_id ) ) {
pods_deprecated( '$params->id instead of $params->pod_id', '2.0' );
$params->id = $params->pod_id;
unset( $params->pod_id );
}
if ( isset( $params->data ) && !empty( $params->data ) && is_array( $params->data ) ) {
$check = current( $params->data );
if ( is_array( $check ) ) {
pods_deprecated( 'PodsAPI::save_pod_items', '2.0' );
return $this->save_pod_items( $params, $params->data );
}
}
}
// @deprecated 2.0
if ( isset( $params->tbl_row_id ) ) {
pods_deprecated( '$params->id instead of $params->tbl_row_id', '2.0' );
$params->id = $params->tbl_row_id;
unset( $params->tbl_row_id );
}
// @deprecated 2.0
if ( isset( $params->columns ) ) {
pods_deprecated( '$params->data instead of $params->columns', '2.0' );
$params->data = $params->columns;
unset( $params->columns );
}
if ( !isset( $params->pod ) )
$params->pod = false;
if ( isset( $params->pod_id ) )
$params->pod_id = pods_absint( $params->pod_id );
else
$params->pod_id = 0;
if ( isset( $params->id ) )
$params->id = pods_absint( $params->id );
else
$params->id = 0;
if ( !isset( $params->from ) )
$params->from = 'save';
if ( !isset( $params->clear_slug_cache ) ) {
$params->clear_slug_cache = true;
}
// Support for bulk edit
if ( isset( $params->id ) && !empty( $params->id ) && is_array( $params->id ) ) {
$ids = array();
$new_params = $params;
foreach ( $params->id as $id ) {
$new_params->id = $id;
$ids[] = $this->save_pod_item( $new_params );
}
return $ids;
}
// Allow Helpers to know what's going on, are we adding or saving?
$is_new_item = false;
if ( empty( $params->id ) )
$is_new_item = true;
if ( isset( $params->is_new_item ) )
$is_new_item = (boolean) $params->is_new_item;
// Allow Helpers to bypass subsequent helpers in recursive save_pod_item calls
$bypass_helpers = false;
if ( isset( $params->bypass_helpers ) && false !== $params->bypass_helpers )
$bypass_helpers = true;
// Allow Custom Fields not defined by Pods to be saved
$allow_custom_fields = false;
if ( isset( $params->allow_custom_fields ) && false !== $params->allow_custom_fields )
$allow_custom_fields = true;
// Get array of Pods
$pod = $this->load_pod( array( 'id' => $params->pod_id, 'name' => $params->pod, 'table_info' => true ) );
if ( false === $pod )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$params->pod = $pod[ 'name' ];
$params->pod_id = $pod[ 'id' ];
if ( 'settings' == $pod[ 'type' ] )
$params->id = $pod[ 'id' ];
$fields = $pod[ 'fields' ];
$object_fields = (array) pods_var_raw( 'object_fields', $pod, array(), null, true );
$fields_active = array();
$custom_data = array();
// Find the active fields (loop through $params->data to retain order)
if ( !empty( $params->data ) && is_array( $params->data ) ) {
$custom_fields = array();
foreach ( $params->data as $field => $value ) {
if ( isset( $object_fields[ $field ] ) ) {
$object_fields[ $field ][ 'value' ] = $value;
$fields_active[] = $field;
}
elseif ( isset( $fields[ $field ] ) ) {
if ( 'save' == $params->from || true === PodsForm::permission( $fields[ $field ][ 'type' ], $field, $fields[ $field ], $fields, $pod, $params->id, $params ) ) {
$fields[ $field ][ 'value' ] = $value;
$fields_active[] = $field;
}
elseif ( !pods_has_permissions( $fields[ $field ][ 'options' ] ) && pods_var( 'hidden', $fields[ $field ][ 'options' ], false ) ) {
$fields[ $field ][ 'value' ] = $value;
$fields_active[] = $field;
}
}
else {
$found = false;
foreach ( $object_fields as $object_field => $object_field_opt ) {
if ( in_array( $field, $object_field_opt[ 'alias' ] ) ) {
$object_fields[ $object_field ][ 'value' ] = $value;
$fields_active[] = $object_field;
$found = true;
break;
}
}
if ( $allow_custom_fields && !$found )
$custom_fields[] = $field;
}
}
if ( $allow_custom_fields && !empty( $custom_fields ) ) {
foreach ( $custom_fields as $field ) {
$custom_data[ $field ] = $params->data[ $field ];
}
}
unset( $params->data );
}
if ( 'pod' == $pod[ 'type' ] ) {
if ( empty( $params->id ) && !in_array( 'created', $fields_active ) && isset( $fields[ 'created' ] ) ) {
$fields[ 'created' ][ 'value' ] = current_time( 'mysql' );
$fields_active[] = 'created';
}
if ( !in_array( 'modified', $fields_active ) && isset( $fields[ 'modified' ] ) ) {
$fields[ 'modified' ][ 'value' ] = current_time( 'mysql' );
$fields_active[] = 'modified';
}
if ( empty( $params->id ) && !empty( $pod[ 'pod_field_index' ] ) && in_array( $pod[ 'pod_field_index' ], $fields_active ) && !in_array( $pod[ 'pod_field_slug' ], $fields_active ) && isset( $fields[ $pod[ 'pod_field_slug' ] ] ) ) {
$fields[ $pod[ 'pod_field_slug' ] ][ 'value' ] = ''; // this will get picked up by slug pre_save method
$fields_active[] = $pod[ 'pod_field_slug' ];
}
}
// Handle hidden fields
if ( empty( $params->id ) ) {
foreach ( $fields as $field => $field_data ) {
if ( in_array( $field, $fields_active ) )
continue;
if ( in_array( $params->from, array( 'save', 'process_form' ) ) || true === PodsForm::permission( $fields[ $field ][ 'type' ], $field, $fields[ $field ], $fields, $pod, $params->id, $params ) ) {
$value = PodsForm::default_value( pods_var_raw( $field, 'post' ), $field_data[ 'type' ], $field, pods_var_raw( 'options', $field_data, $field_data, null, true ), $pod, $params->id );
if ( null !== $value && '' !== $value && false !== $value ) {
$fields[ $field ][ 'value' ] = $value;
$fields_active[] = $field;
}
}
}
}
$columns =& $fields; // @deprecated 2.0
$active_columns =& $fields_active; // @deprecated 2.0
$params->tbl_row_id =& $params->id; // @deprecated 2.0
$pre_save_helpers = $post_save_helpers = array();
if ( false === $bypass_helpers ) {
$pieces = array(
'fields',
'params',
'pod',
'fields_active',
'object_fields',
'custom_fields',
'custom_data'
);
// Plugin hooks
$hooked = $this->do_hook( 'pre_save_pod_item', compact( $pieces ), $is_new_item, $params->id );
if ( is_array( $hooked ) && !empty( $hooked ) )
extract( $hooked );
$hooked = $this->do_hook( "pre_save_pod_item_{$params->pod}", compact( $pieces ), $is_new_item, $params->id );
if ( is_array( $hooked ) && !empty( $hooked ) )
extract( $hooked );
if ( $is_new_item ) {
$hooked = $this->do_hook( 'pre_create_pod_item', compact( $pieces ) );
if ( is_array( $hooked ) && !empty( $hooked ) )
extract( $hooked );
$hooked = $this->do_hook( "pre_create_pod_item_{$params->pod}", compact( $pieces ) );
if ( is_array( $hooked ) && !empty( $hooked ) )
extract( $hooked );
}
else {
$hooked = $this->do_hook( 'pre_edit_pod_item', compact( $pieces ), $params->id );
if ( is_array( $hooked ) && !empty( $hooked ) )
extract( $hooked );
$hooked = $this->do_hook( "pre_edit_pod_item_{$params->pod}", compact( $pieces ), $params->id );
if ( is_array( $hooked ) && !empty( $hooked ) )
extract( $hooked );
}
// Call any pre-save helpers (if not bypassed)
if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
if ( !empty( $pod[ 'options' ] ) && is_array( $pod[ 'options' ] ) ) {
$helpers = array( 'pre_save_helpers', 'post_save_helpers' );
foreach ( $helpers as $helper ) {
if ( isset( $pod[ 'options' ][ $helper ] ) && !empty( $pod[ 'options' ][ $helper ] ) )
${$helper} = explode( ',', $pod[ 'options' ][ $helper ] );
}
}
if ( !empty( $pre_save_helpers ) ) {
pods_deprecated( sprintf( __( 'Pre-save helpers are deprecated, use the action pods_pre_save_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
foreach ( $pre_save_helpers as $helper ) {
$helper = $this->load_helper( array( 'name' => $helper ) );
if ( false !== $helper )
eval( '?>' . $helper[ 'code' ] );
}
}
}
}
$table_data = $table_formats = $update_values = $rel_fields = $rel_field_ids = array();
$object_type = $pod[ 'type' ];
$object_ID = 'ID';
if ( 'comment' == $object_type )
$object_ID = 'comment_ID';
$object_data = $object_meta = $post_term_data = array();
if ( 'settings' == $object_type )
$object_data[ 'option_id' ] = $pod[ 'name' ];
elseif ( !empty( $params->id ) )
$object_data[ $object_ID ] = $params->id;
$fields_active = array_unique( $fields_active );
// Loop through each active field, validating and preparing the table data
foreach ( $fields_active as $field ) {
if ( isset( $object_fields[ $field ] ) )
$field_data = $object_fields[ $field ];
elseif ( isset( $fields[ $field ] ) )
$field_data = $fields[ $field ];
else
continue;
$value = $field_data[ 'value' ];
$type = $field_data[ 'type' ];
$options = pods_var( 'options', $field_data, array() );
// WPML AJAX compatibility
if ( is_admin() && isset( $_GET[ 'page' ] ) && false !== strpos( $_GET[ 'page' ], '/menu/languages.php' ) && isset( $_POST[ 'icl_ajx_action' ] ) && isset( $_POST[ '_icl_nonce' ] ) && wp_verify_nonce( $_POST[ '_icl_nonce' ], $_POST[ 'icl_ajx_action' ] . '_nonce' ) )
$options[ 'unique' ] = $fields[ $field ][ 'options' ][ 'unique' ] = $options[ 'required' ] = $fields[ $field ][ 'options' ][ 'required' ] = 0;
else {
// Validate value
$validate = $this->handle_field_validation( $value, $field, $object_fields, $fields, $pod, $params );
if ( false === $validate )
$validate = sprintf( __( 'There was an issue validating the field %s', 'pods' ), $field_data[ 'label' ] );
elseif ( true !== $validate )
$validate = (array) $validate;
if ( !is_bool( $validate ) && !empty( $validate ) )
return pods_error( $validate, $this );
}
$value = PodsForm::pre_save( $field_data[ 'type' ], $value, $params->id, $field, array_merge( $field_data, $options ), array_merge( $fields, $object_fields ), $pod, $params );
$field_data[ 'value' ] = $value;
if ( isset( $object_fields[ $field ] ) ) {
if ( 'taxonomy' == $object_fields[ $field ][ 'type' ] ) {
$post_term_data[ $field ] = $value;
}
else {
$object_data[ $field ] = $value;
}
}
else {
$simple = ( 'pick' == $type && in_array( pods_var( 'pick_object', $field_data ), $simple_tableless_objects ) );
$simple = (boolean) $this->do_hook( 'tableless_custom', $simple, $field_data, $field, $fields, $pod, $params );
// Handle Simple Relationships
if ( $simple ) {
if ( !is_array( $value ) )
$value = explode( ',', $value );
$pick_limit = (int) pods_var_raw( 'pick_limit', $options, 0 );
if ( 'single' == pods_var_raw( 'pick_format_type', $options ) )
$pick_limit = 1;
if ( 'custom-simple' == pods_var( 'pick_object', $field_data ) ) {
$custom = pods_var_raw( 'pick_custom', $options, '' );
$custom = apply_filters( 'pods_form_ui_field_pick_custom_values', $custom, $field_data[ 'name' ], $value, array_merge( $field_data, $options ), $pod, $params->id );
if ( empty( $value ) || empty( $custom ) )
$value = '';
elseif ( !empty( $custom ) ) {
if ( !is_array( $custom ) ) {
$custom = explode( "\n", $custom );
$custom_values = array();
foreach ( $custom as $c => $cv ) {
if ( 0 < strlen( $cv ) ) {
$custom_label = explode( '|', $cv );
if ( !isset( $custom_label[ 1 ] ) )
$custom_label[ 1 ] = $custom_label[ 0 ];
$custom_values[ $custom_label[ 0 ] ] = $custom_label[ 1 ];
}
}
}
else
$custom_values = $custom;
$values = array();
foreach ( $value as $k => $v ) {
$v = pods_unsanitize( $v );
if ( isset( $custom_values[ $v ] ) )
$values[ $k ] = $v;
}
$value = $values;
}
}
if ( 0 < $pick_limit && !empty( $value ) )
$value = array_slice( $value, 0, $pick_limit );
// Don't save an empty array, just make it an empty string
if ( empty( $value ) )
$value = '';
elseif ( is_array( $value ) ) {
// If there's just one item, don't save as an array, save the string
if ( 1 == $pick_limit || 1 == count( $value ) )
$value = implode( '', $value );
// If storage is set to table, json encode, otherwise WP will serialize automatically
elseif ( 'table' == pods_var( 'storage', $pod ) )
$value = version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $value, JSON_UNESCAPED_UNICODE ) : json_encode( $value );
}
}
// Prepare all table / meta data
if ( !in_array( $type, $tableless_field_types ) || $simple ) {
if ( in_array( $type, $repeatable_field_types ) && 1 == pods_var( $type . '_repeatable', $field_data, 0 ) ) {
// Don't save an empty array, just make it an empty string
if ( empty( $value ) )
$value = '';
elseif ( is_array( $value ) ) {
// If there's just one item, don't save as an array, save the string
if ( 1 == count( $value ) )
$value = implode( '', $value );
// If storage is set to table, json encode, otherwise WP will serialize automatically
elseif ( 'table' == pods_var( 'storage', $pod ) )
$value = version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $value, JSON_UNESCAPED_UNICODE ) : json_encode( $value );
}
}
$table_data[ $field ] = str_replace( array( '{prefix}', '@wp_' ), array( '{/prefix/}', '{prefix}' ), $value ); // Fix for pods_query
$table_formats[] = PodsForm::prepare( $type, $options );
$object_meta[ $field ] = $value;
}
// Store relational field data to be looped through later
else {
// Convert values from a comma-separated string into an array
if ( !is_array( $value ) )
$value = explode( ',', $value );
$rel_fields[ $type ][ $field ] = $value;
$rel_field_ids[] = $field_data[ 'id' ];
}
}
}
if ( 'post_type' == $pod[ 'type' ] ) {
$post_type = $pod[ 'name' ];
if ( !empty( $pod[ 'object' ] ) )
$post_type = $pod[ 'object' ];
$object_data[ 'post_type' ] = $post_type;
}
if ( ( 'meta' == $pod[ 'storage' ] || 'settings' == $pod[ 'type' ] ) && !in_array( $pod[ 'type' ], array( 'taxonomy', 'pod', 'table', '' ) ) ) {
if ( $allow_custom_fields && !empty( $custom_data ) )
$object_meta = array_merge( $custom_data, $object_meta );
$params->id = $this->save_wp_object( $object_type, $object_data, $object_meta, false, true );
if ( !empty( $params->id ) && 'settings' == $object_type )
$params->id = $pod[ 'id' ];
}
else {
if ( !in_array( $pod[ 'type' ], array( 'taxonomy', 'pod', 'table', '' ) ) )
$params->id = $this->save_wp_object( $object_type, $object_data, array(), false, true );
elseif ( 'taxonomy' == $pod[ 'type' ] ) {
$term = pods_var( $object_fields[ 'name' ][ 'name' ], $object_data, '', null, true );
$term_data = array();
if ( empty( $params->id ) || !empty( $term_data ) ) {
$taxonomy = $pod[ 'name' ];
if ( !empty( $pod[ 'object' ] ) )
$taxonomy = $pod[ 'object' ];
$params->id = $this->save_term( $params->id, $term, $taxonomy, $term_data, true );
}
}
if ( 'table' == $pod[ 'storage' ] ) {
// Every row should have an id set here, otherwise Pods with nothing
// but relationship fields won't get properly ID'd
if ( empty( $params->id ) )
$params->id = 0;
$table_data = array( 'id' => $params->id ) + $table_data;
array_unshift( $table_formats, '%d' );
if ( !empty( $table_data ) ) {
$sql = pods_data()->insert_on_duplicate( "@wp_pods_{$params->pod}", $table_data, $table_formats );
$id = pods_query( $sql, 'Cannot add/save table row' );
if ( empty( $params->id ) )
$params->id = $id;
}
}
}
$params->id = (int) $params->id;
// Save terms for taxonomies associated to a post type
if ( 0 < $params->id && 'post_type' == $pod[ 'type' ] && !empty( $post_term_data ) ) {
foreach ( $post_term_data as $post_taxonomy => $post_terms ) {
wp_set_object_terms( $params->id, $post_terms, $post_taxonomy );
}
}
$no_conflict = pods_no_conflict_check( $pod[ 'type' ] );
if ( !$no_conflict )
pods_no_conflict_on( $pod[ 'type' ] );
// Save relationship / file data
if ( !empty( $rel_fields ) ) {
foreach ( $rel_fields as $type => $data ) {
// Only handle tableless fields
if ( !in_array( $type, $tableless_field_types ) )
continue;
foreach ( $data as $field => $values ) {
$pick_val = pods_var( 'pick_val', $fields[ $field ][ 'options' ] );
if ( 'table' == pods_var( 'pick_object', $fields[ $field ][ 'options' ] ) )
$pick_val = pods_var( 'pick_table', $fields[ $field ][ 'options' ], $pick_val, null, true );
if ( '__current__' == $pick_val ) {
if ( is_object( $pod ) )
$pick_val = $pod->pod;
elseif ( is_array( $pod ) )
$pick_val = $pod[ 'name' ];
elseif ( 0 < strlen( $pod ) )
$pick_val = $pod;
}
$fields[ $field ][ 'options' ][ 'table_info' ] = pods_api()->get_table_info( pods_var( 'pick_object', $fields[ $field ][ 'options' ] ), $pick_val, null, null, $fields[ $field ][ 'options' ] );
$search_data = pods_data();
$search_data->table( $fields[ $field ][ 'options' ][ 'table_info' ] );
if ( isset( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ] ) && !empty( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ] ) && isset( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ][ 'name' ] ) ) {
$search_data->pod = $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ][ 'name' ];
$search_data->fields = $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ][ 'fields' ];
}
$related_limit = (int) pods_var_raw( $type . '_limit', $fields[ $field ][ 'options' ], 0 );
if ( 'single' == pods_var_raw( $type . '_format_type', $fields[ $field ][ 'options' ] ) )
$related_limit = 1;
// Enforce integers / unique values for IDs
$value_ids = array();
foreach ( $values as $v ) {
if ( !empty( $v ) ) {
if ( !is_array( $v ) ) {
if ( !preg_match( '/[^0-9]*/', $v ) )
$v = (int) $v;
// File handling
elseif ( in_array( $type, PodsForm::file_field_types() ) ) {
// Get ID from GUID
$v = pods_image_id_from_field( $v );
// If file not found, add it
if ( empty( $v ) )
$v = pods_attachment_import( $v );
}
// Reference by slug
else {
$v_data = $search_data->fetch( $v );
if ( !empty( $v_data ) && isset( $v_data[ $search_data->field_id ] ) )
$v = (int) $v_data[ $search_data->field_id ];
}
// @todo Handle simple relationships eventually
}
elseif ( in_array( $type, PodsForm::file_field_types() ) && isset( $v[ 'id' ] ) )
$v = (int) $v[ 'id' ];
else
continue;
if ( !empty( $v ) && !in_array( $v, $value_ids ) )
$value_ids[] = $v;
}
}
$value_ids = array_unique( array_filter( $value_ids ) );
// Limit values
if ( 0 < $related_limit && !empty( $value_ids ) )
$value_ids = array_slice( $value_ids, 0, $related_limit );
// Get current values
if ( 'pick' == $type && isset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ] ) && isset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ][ 'current_ids' ] ) )
$related_ids = PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ][ 'current_ids' ];
else
$related_ids = $this->lookup_related_items( $fields[ $field ][ 'id' ], $pod[ 'id' ], $params->id, $fields[ $field ], $pod );
// Get ids to remove
$remove_ids = array_diff( $related_ids, $value_ids );
// Delete relationships
if ( !empty( $remove_ids ) )
$this->delete_relationships( $params->id, $remove_ids, $pod, $fields[ $field ] );
// Save relationships
if ( !empty( $value_ids ) )
$this->save_relationships( $params->id, $value_ids, $pod, $fields[ $field ] );
// Run save function for field type (where needed)
PodsForm::save( $type, $values, $params->id, $field, array_merge( $fields[ $field ], $fields[ $field ][ 'options' ] ), array_merge( $fields, $object_fields ), $pod, $params );
}
// Unset data no longer needed
if ( 'pick' == $type ) {
foreach ( $data as $field => $values ) {
if ( isset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ] ) ) {
unset( PodsField_Pick::$related_data[ PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ][ 'related_field' ][ 'id' ] ] );
unset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ] );
}
}
}
}
}
if ( !$no_conflict )
pods_no_conflict_off( $pod[ 'type' ] );
if ( false === $bypass_helpers ) {
$pieces = array(
'fields',
'params',
'pod',
'fields_active',
'object_fields',
'custom_fields',
'custom_data'
);
$pieces = compact( $pieces );
// Plugin hooks
$this->do_hook( 'post_save_pod_item', $pieces, $is_new_item, $params->id );
$this->do_hook( "post_save_pod_item_{$params->pod}", $pieces, $is_new_item, $params->id );
if ( $is_new_item ) {
$this->do_hook( 'post_create_pod_item', $pieces, $params->id );
$this->do_hook( "post_create_pod_item_{$params->pod}", $pieces, $params->id );
}
else {
$this->do_hook( 'post_edit_pod_item', $pieces, $params->id );
$this->do_hook( "post_edit_pod_item_{$params->pod}", $pieces, $params->id );
}
// Call any post-save helpers (if not bypassed)
if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
if ( !empty( $post_save_helpers ) ) {
pods_deprecated( sprintf( __( 'Post-save helpers are deprecated, use the action pods_post_save_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
foreach ( $post_save_helpers as $helper ) {
$helper = $this->load_helper( array( 'name' => $helper ) );
if ( false !== $helper && ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) )
eval( '?>' . $helper[ 'code' ] );
}
}
}
}
// Clear cache
pods_cache_clear( $params->id, 'pods_items_' . $pod[ 'name' ] );
if ( $params->clear_slug_cache && !empty( $pod[ 'field_slug' ] ) ) {
$slug = pods( $pod[ 'name' ], $params->id )->field( $pod[ 'field_slug' ] );
if ( 0 < strlen( $slug ) ) {
pods_cache_clear( $slug, 'pods_items_' . $pod[ 'name' ] );
}
}
// Clear WP meta cache
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy', 'user', 'comment' ) ) ) {
$meta_type = $pod[ 'type' ];
if ( 'post_type' == $meta_type )
$meta_type = 'post';
wp_cache_delete( $params->id, $meta_type . '_meta' );
wp_cache_delete( $params->id, 'pods_' . $meta_type . '_meta' );
}
// Success! Return the id
return $params->id;
}
/**
* @see PodsAPI::save_pod_item
* Add multiple pod items
*
* $params['pod'] string The Pod name (pod or pod_id is required)
* $params['pod_id'] string The Pod ID (pod or pod_id is required)
* $params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
*
* $data['id'] int The item ID (optional)
* $data['data'] array An associative array of field names + values
*
* @param array|object $params An associative array of parameters, data excluded
* @param array $data An associative array of pod ids and field names + values (arrays of field data)
*
* @return int The item ID
* @since 2.0
*/
public function save_pod_items ( $params, $data ) {
$params = (object) $params;
$ids = array();
foreach ( $data as $fields ) {
$params->data = $fields;
if ( isset( $fields[ 'id' ] ) && isset( $fields[ 'data' ] ) ) {
$params->id = $fields[ 'id' ];
$params->data = $fields[ 'data' ];
}
$ids[] = $this->save_pod_item( $params );
}
return $ids;
}
/**
* Save relationships
*
* @param int $id ID of item
* @param int|array $related_id ID or IDs to save
* @param array $pod Pod data
* @param array $field Field data
*/
public function save_relationships ( $id, $related_ids, $pod, $field ) {
// Get current values
if ( 'pick' == $field[ 'type' ] && isset( PodsField_Pick::$related_data[ $field[ 'id' ] ] ) && isset( PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'current_ids' ] ) )
$current_ids = PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'current_ids' ];
else
$current_ids = $this->lookup_related_items( $field[ 'id' ], $pod[ 'id' ], $id, $field, $pod );
if ( !is_array( $related_ids ) )
$related_ids = implode( ',', $related_ids );
foreach ( $related_ids as $k => $related_id ) {
$related_ids[ $k ] = (int) $related_id;
}
$related_ids = array_unique( array_filter( $related_ids ) );
$related_limit = (int) pods_var_raw( $field[ 'type' ] . '_limit', $field[ 'options' ], 0 );
if ( 'single' == pods_var_raw( $field[ 'type' ] . '_format_type', $field[ 'options' ] ) )
$related_limit = 1;
// Limit values
if ( 0 < $related_limit && !empty( $related_ids ) )
$related_ids = array_slice( $related_ids, 0, $related_limit );
// Post Types, Media, Users, and Comments (meta-based)
if ( in_array( $pod[ 'type' ], array( 'post_type', 'media', 'user', 'comment' ) ) ) {
$object_type = $pod[ 'type' ];
if ( 'post_type' == $object_type || 'media' == $object_type )
$object_type = 'post';
delete_metadata( $object_type, $id, $field[ 'name' ] );
if ( !empty( $related_ids ) ) {
update_metadata( $object_type, $id, '_pods_' . $field[ 'name' ], $related_ids );
foreach ( $related_ids as $related_id ) {
add_metadata( $object_type, $id, $field[ 'name' ], $related_id );
}
}
else
delete_metadata( $object_type, $id, '_pods_' . $field[ 'name' ] );
}
// Custom Settings Pages (options-based)
elseif ( 'settings' == $pod[ 'type' ] ) {
if ( !empty( $related_ids ) )
update_option( $pod[ 'name' ] . '_' . $field[ 'name' ], $related_ids );
else
delete_option( $pod[ 'name' ] . '_' . $field[ 'name' ] );
}
$related_pod_id = $related_field_id = 0;
if ( 'pick' == $field[ 'type' ] && isset( PodsField_Pick::$related_data[ $field[ 'id' ] ] ) && !empty( PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'related_field' ] ) ) {
$related_pod_id = PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'related_pod' ][ 'id' ];
$related_field_id = PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'related_field' ][ 'id' ];
}
// Relationships table
if ( !pods_tableless() ) {
$related_weight = 0;
foreach ( $related_ids as $related_id ) {
if ( in_array( $related_id, $current_ids ) ) {
pods_query( "
UPDATE `@wp_podsrel`
SET
`pod_id` = %d,
`field_id` = %d,
`item_id` = %d,
`related_pod_id` = %d,
`related_field_id` = %d,
`related_item_id` = %d,
`weight` = %d
WHERE
`pod_id` = %d
AND `field_id` = %d
AND `item_id` = %d
AND `related_item_id` = %d
", array(
$pod[ 'id' ],
$field[ 'id' ],
$id,
$related_pod_id,
$related_field_id,
$related_id,
$related_weight,
$pod[ 'id' ],
$field[ 'id' ],
$id,
$related_id,
) );
}
else {
pods_query( "
INSERT INTO `@wp_podsrel`
(
`pod_id`,
`field_id`,
`item_id`,
`related_pod_id`,
`related_field_id`,
`related_item_id`,
`weight`
)
VALUES ( %d, %d, %d, %d, %d, %d, %d )
", array(
$pod[ 'id' ],
$field[ 'id' ],
$id,
$related_pod_id,
$related_field_id,
$related_id,
$related_weight
) );
}
$related_weight++;
}
}
}
/**
* Duplicate a Pod
*
* $params['id'] int The Pod ID
* $params['name'] string The Pod name
* $params['new_name'] string The new Pod name
*
* @param array $params An associative array of parameters
* @param bool $strict (optional) Makes sure a pod exists, if it doesn't throws an error
*
* @return int New Pod ID
* @since 2.3
*/
public function duplicate_pod ( $params, $strict = false ) {
if ( !is_object( $params ) && !is_array( $params ) ) {
if ( is_numeric( $params ) )
$params = array( 'id' => $params );
else
$params = array( 'name' => $params );
$params = (object) pods_sanitize( $params );
}
else
$params = (object) pods_sanitize( $params );
$params->table_info = false;
$pod = $this->load_pod( $params, $strict );
if ( empty( $pod ) ) {
if ( false !== $strict )
return pods_error( __( 'Pod not found', 'pods' ), $this );
return false;
}
elseif ( in_array( $pod[ 'type' ], array( 'media', 'user', 'comment' ) ) ) {
if ( false !== $strict )
return pods_error( __( 'Pod not allowed to be duplicated', 'pods' ), $this );
return false;
}
elseif ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && 0 < strlen( $pod[ 'object' ] ) ) {
$pod[ 'object' ] = '';
}
unset( $pod[ 'id' ] );
if ( isset( $params->new_name ) )
$pod[ 'name' ] = $params->new_name;
$try = 1;
$check_name = $pod[ 'name' ];
$new_label = $pod[ 'label' ];
while ( $this->load_pod( array( 'name' => $check_name, 'table_info' => false ), false ) ) {
$try++;
$check_name = $pod[ 'name' ] . $try;
$new_label = $pod[ 'label' ] . $try;
}
$pod[ 'name' ] = $check_name;
$pod[ 'label' ] = $new_label;
foreach ( $pod[ 'fields' ] as $field => $field_data ) {
unset( $pod[ 'fields' ][ $field ][ 'id' ] );
}
return $this->save_pod( $pod );
}
/**
* Duplicate a Field
*
* $params['pod_id'] int The Pod ID
* $params['pod'] string The Pod name
* $params['id'] int The Field ID
* $params['name'] string The Field name
* $params['new_name'] string The new Field name
*
* @param array $params An associative array of parameters
* @param bool $strict (optional) Makes sure a field exists, if it doesn't throws an error
*
* @return int New Field ID
* @since 2.3.10
*/
public function duplicate_field( $params, $strict = false ) {
if ( !is_object( $params ) && !is_array( $params ) ) {
if ( is_numeric( $params ) ) {
$params = array( 'id' => $params );
}
else {
$params = array( 'name' => $params );
}
}
$params = (object) pods_sanitize( $params );
$params->table_info = false;
$field = $this->load_field( $params, $strict );
if ( empty( $field ) ) {
if ( false !== $strict ) {
return pods_error( __( 'Field not found', 'pods' ), $this );
}
return false;
}
unset( $field[ 'id' ] );
if ( isset( $params->new_name ) ) {
$field[ 'name' ] = $params->new_name;
}
$try = 1;
$check_name = $field[ 'name' ];
$new_label = $field[ 'label' ];
while ( $this->load_field( array( 'pod_id' => $field[ 'pod_id' ], 'name' => $check_name, 'table_info' => false ), false ) ) {
$try++;
$check_name = $field[ 'name' ] . $try;
$new_label = $field[ 'label' ] . $try;
}
$field[ 'name' ] = $check_name;
$field[ 'label' ] = $new_label;
return $this->save_field( $field );
}
/**
* @see PodsAPI::save_pod_item
*
* Duplicate a pod item
*
* $params['pod'] string The Pod name
* $params['id'] int The item's ID from the wp_pods_* table
*
* @param array $params An associative array of parameters
*
* @return int The table row ID
* @since 1.12
*/
public function duplicate_pod_item ( $params ) {
$params = (object) pods_sanitize( $params );
$pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => false ) );
if ( false === $pod )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$pod = pods( $params->pod, $params->id );
$params->pod = $pod->pod;
$params->pod_id = $pod->pod_id;
$fields = (array) pods_var_raw( 'fields', $pod->pod_data, array(), null, true );
$object_fields = (array) pods_var_raw( 'object_fields', $pod->pod_data, array(), null, true );
if ( !empty( $object_fields ) )
$fields = array_merge( $object_fields, $fields );
$save_params = array(
'pod' => $params->pod,
'data' => array()
);
foreach ( $fields as $field ) {
$value = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'ids' ) );
if ( !empty( $value ) || ( !is_array( $value ) && 0 < strlen( $value ) ) )
$save_params[ 'data' ][ $field[ 'name' ] ] = $value;
}
$save_params = $this->do_hook( 'duplicate_pod_item', $save_params, $pod->pod, $pod->id(), $params );
$id = $this->save_pod_item( $save_params );
return $id;
}
/**
* @see pods()
*
* Export a pod item
*
* $params['pod'] string The Pod name
* $params['id'] int The item's ID from the wp_pods_* table
* $params['fields'] array The fields to export
* $params['depth'] int How many levels deep to export data
*
* @param array $params An associative array of parameters
* @param object $pod (optional) Pods object
*
* @return int The table row ID
* @since 1.12
*/
public function export_pod_item ( $params, $pod = null ) {
if ( !is_object( $pod ) || 'Pods' != get_class( $pod ) ) {
if ( empty( $params ) )
return false;
$params = (object) pods_sanitize( $params );
$pod = pods( $params->pod, $params->id, false );
if ( empty( $pod ) )
return false;
}
$fields = (array) pods_var_raw( 'fields', $params, array(), null, true );
$depth = (int) pods_var_raw( 'depth', $params, 2, null, true );
$object_fields = (array) pods_var_raw( 'object_fields', $pod->pod_data, array(), null, true );
$flatten = (boolean) pods_var( 'flatten', $params, false, null, true );
if ( empty( $fields ) ) {
$fields = $pod->fields;
$fields = array_merge( $fields, $object_fields );
}
$data = $this->export_pod_item_level( $pod, $fields, $depth, $flatten );
$data = $this->do_hook( 'export_pod_item', $data, $pod->pod, $pod->id(), $pod, $fields, $depth, $flatten );
return $data;
}
/**
* Export a pod item by depth level
*
* @param Pods $pod Pods object
* @param array $fields Fields to export
* @param int $depth Depth limit
* @param boolean $flatten Whether to flatten arrays for display
* @param int $current_depth Current depth level
*
* @return array Data array
*
* @since 2.3
*/
private function export_pod_item_level ( $pod, $fields, $depth, $flatten = false, $current_depth = 1 ) {
$tableless_field_types = PodsForm::tableless_field_types();
$simple_tableless_objects = PodsForm::field_method( 'pick', 'simple_objects' );
$object_fields = (array) pods_var_raw( 'object_fields', $pod->pod_data, array(), null, true );
$export_fields = array();
foreach ( $fields as $k => $field ) {
if ( !is_array( $field ) ) {
$field = array(
'id' => 0,
'name' => $field
);
}
if ( isset( $pod->fields[ $field[ 'name' ] ] ) ) {
$field = $pod->fields[ $field[ 'name' ] ];
$field[ 'lookup_name' ] = $field[ 'name' ];
if ( in_array( $field[ 'type' ], $tableless_field_types ) && !in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) ) {
if ( 'pick' == $field[ 'type' ] ) {
if ( empty( $field[ 'table_info' ] ) )
$field[ 'table_info' ] = $this->get_table_info( pods_var_raw( 'pick_object', $field ), pods_var_raw( 'pick_val', $field ), null, null, $field );
if ( !empty( $field[ 'table_info' ] ) )
$field[ 'lookup_name' ] .= '.' . $field[ 'table_info' ][ 'field_id' ];
}
elseif ( in_array( $field[ 'type' ], PodsForm::file_field_types() ) )
$field[ 'lookup_name' ] .= '.guid';
}
$export_fields[ $field[ 'name' ] ] = $field;
}
elseif ( isset( $object_fields[ $field[ 'name' ] ] ) ) {
$field = $object_fields[ $field[ 'name' ] ];
$field[ 'lookup_name' ] = $field[ 'name' ];
$export_fields[ $field[ 'name' ] ] = $field;
}
elseif ( $field[ 'name' ] == $pod->pod_data[ 'field_id' ] ) {
$field[ 'type' ] = 'number';
$field[ 'lookup_name' ] = $field[ 'name' ];
$export_fields[ $field[ 'name' ] ] = $field;
}
}
$data = array();
foreach ( $export_fields as $field ) {
// Return IDs (or guid for files) if only one level deep
if ( 1 == $depth )
$data[ $field[ 'name' ] ] = $pod->field( array( 'name' => $field[ 'lookup_name' ], 'output' => 'arrays' ) );
// Recurse depth levels for pick fields if $depth allows
elseif ( ( -1 == $depth || $current_depth < $depth ) && 'pick' == $field[ 'type' ] && !in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) ) {
$related_data = array();
$related_ids = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'ids' ) );
if ( !empty( $related_ids ) ) {
$related_ids = (array) $related_ids;
$pick_object = pods_var_raw( 'pick_object', $field );
$related_pod = pods( pods_var_raw( 'pick_val', $field ), null, false );
// If this isn't a Pod, return data exactly as Pods does normally
if ( empty( $related_pod ) || ( 'pod' != $pick_object && $pick_object != $related_pod->pod_data[ 'type' ] ) || $related_pod->pod == $pod->pod )
$related_data = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'arrays' ) );
else {
$related_object_fields = (array) pods_var_raw( 'object_fields', $related_pod->pod_data, array(), null, true );
$related_fields = array_merge( $related_pod->fields, $related_object_fields );
foreach ( $related_ids as $related_id ) {
if ( $related_pod->fetch( $related_id ) ) {
$related_item = $this->export_pod_item_level( $related_pod, $related_fields, $depth, $flatten, ( $current_depth + 1 ) );
$related_data[ $related_id ] = $this->do_hook( 'export_pod_item_level', $related_item, $related_pod->pod, $related_pod->id(), $related_pod, $related_fields, $depth, $flatten, ( $current_depth + 1 ) );
}
}
if ( $flatten && !empty( $related_data ) )
$related_data = pods_serial_comma( array_values( $related_data ), array( 'and' => '', 'field_index' => $related_pod->pod_data[ 'field_index' ] ) );
}
}
$data[ $field[ 'name' ] ] = $related_data;
}
// Return data exactly as Pods does normally
else
$data[ $field[ 'name' ] ] = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'arrays' ) );
if ( $flatten && is_array( $data[ $field[ 'name' ] ] ) )
$data[ $field[ 'name' ] ] = pods_serial_comma( $data[ $field[ 'name' ] ], array( 'field' => $field[ 'name' ], 'fields' => $export_fields, 'and' => '' ) );
}
return $data;
}
/**
* Reorder a Pod
*
* $params['pod'] string The Pod name
* $params['field'] string The field name of the field to reorder
* $params['order'] array The key => value array of items to reorder (key should be an integer)
*
* @param array $params An associative array of parameters
*
* @return bool
*
* @since 1.9.0
*/
public function reorder_pod_item ( $params ) {
$params = (object) pods_sanitize( $params );
// @deprecated 2.0
if ( isset( $params->datatype ) ) {
pods_deprecated( __( '$params->pod instead of $params->datatype', 'pods' ), '2.0' );
$params->pod = $params->datatype;
unset( $params->datatype );
}
if ( null === pods_var_raw( 'pod', $params, null, null, true ) )
return pods_error( __( '$params->pod is required', 'pods' ), $this );
if ( !is_array( $params->order ) )
$params->order = explode( ',', $params->order );
$pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => true ) );
$params->name = $pod[ 'name' ];
if ( false === $pod )
return pods_error( __( 'Pod is required', 'pods' ), $this );
foreach ( $params->order as $order => $id ) {
if ( isset( $pod[ 'fields' ][ $params->field ] ) || isset( $pod[ 'object_fields' ][ $params->field ] ) ) {
if ( 'table' == $pod[ 'storage' ] && ( !pods_tableless() ) ) {
if ( isset( $pod[ 'fields' ][ $params->field ] ) )
pods_query( "UPDATE `@wp_pods_{$params->name}` SET `{$params->field}` = " . pods_absint( $order ) . " WHERE `id` = " . pods_absint( $id ) . " LIMIT 1" );
else
pods_query( "UPDATE `{$pod['table']}` SET `{$params->field}` = " . pods_absint( $order ) . " WHERE `{$pod['field_id']}` = " . pods_absint( $id ) . " LIMIT 1" );
}
else
$this->save_pod_item( array( 'pod' => $params->pod, 'pod_id' => $params->pod_id, 'id' => $id, 'data' => array( $params->field => pods_absint( $order ) ) ) );
}
}
return true;
}
/**
*
* Delete all content for a Pod
*
* $params['id'] int The Pod ID
* $params['name'] string The Pod name
*
* @param array $params An associative array of parameters
* @param array $pod Pod data
*
* @return bool
*
* @uses pods_query
* @uses pods_cache_clear
*
* @since 1.9.0
*/
public function reset_pod ( $params, $pod = false ) {
$params = (object) pods_sanitize( $params );
$params->table_info = true;
if ( empty( $pod ) )
$pod = $this->load_pod( $params );
if ( false === $pod )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$params->id = $pod[ 'id' ];
$params->name = $pod[ 'name' ];
if ( !pods_tableless() ) {
if ( 'table' == $pod[ 'storage' ] ) {
try {
pods_query( "TRUNCATE `@wp_pods_{$params->name}`", false );
}
catch ( Exception $e ) {
// Allow pod to be reset if the table doesn't exist
if ( false === strpos( $e->getMessage(), 'Unknown table' ) )
return pods_error( $e->getMessage(), $this );
}
}
pods_query( "DELETE FROM `@wp_podsrel` WHERE `pod_id` = {$params->id} OR `related_pod_id` = {$params->id}", false );
}
// @todo Delete relationships from tableless relationships
// Delete all posts/revisions from this post type
if ( in_array( $pod[ 'type' ], array( 'post_type', 'media' ) ) ) {
$type = pods_var( 'object', $pod, $pod[ 'name' ], null, true );
$sql = "
DELETE `t`, `r`, `m`
FROM `{$pod['table']}` AS `t`
LEFT JOIN `{$pod['meta_table']}` AS `m`
ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
LEFT JOIN `{$pod['table']}` AS `r`
ON `r`.`post_parent` = `t`.`{$pod['field_id']}` AND `r`.`post_status` = 'inherit'
WHERE `t`.`{$pod['field_type']}` = '{$type}'
";
pods_query( $sql, false );
}
// Delete all terms from this taxonomy
elseif ( 'taxonomy' == $pod[ 'type' ] ) {
$type = pods_var( 'object', $pod, $pod[ 'name' ], null, true );
$sql = "
DELETE FROM `{$pod['table']}` AS `t`
" . $pod['join']['tt'] . "
WHERE " . implode( ' AND ', $pod['where'] ) . "
";
pods_query( $sql, false );
}
// Delete all users except the current one
elseif ( 'user' == $pod[ 'type' ] ) {
$sql = "
DELETE `t`, `m`
FROM `{$pod['table']}` AS `t`
LEFT JOIN `{$pod['meta_table']}` AS `m`
ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
WHERE `t`.`{$pod['field_id']}` != " . (int) get_current_user_id() . "
";
pods_query( $sql, false );
}
// Delete all comments
elseif ( 'comment' == $pod[ 'type' ] ) {
$type = pods_var( 'object', $pod, $pod[ 'name' ], null, true );
$sql = "
DELETE `t`, `m`
FROM `{$pod['table']}` AS `t`
LEFT JOIN `{$pod['meta_table']}` AS `m`
ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
WHERE `t`.`{$pod['field_type']}` = '{$type}'
";
pods_query( $sql, false );
}
pods_cache_clear( true ); // only way to reliably clear out cached data across an entire group
return true;
}
/**
* Delete a Pod and all its content
*
* $params['id'] int The Pod ID
* $params['name'] string The Pod name
*
* @param array $params An associative array of parameters
* @param bool $strict (optional) Makes sure a pod exists, if it doesn't throws an error
* @param bool $delete_all (optional) Whether to delete all content from a WP object
*
* @uses PodsAPI::load_pod
* @uses wp_delete_post
* @uses pods_query
*
* @return bool
* @since 1.7.9
*/
public function delete_pod ( $params, $strict = false, $delete_all = false ) {
/**
* @var $wpdb wpdb
*/
global $wpdb;
if ( !is_object( $params ) && !is_array( $params ) ) {
if ( is_numeric( $params ) )
$params = array( 'id' => $params );
else
$params = array( 'name' => $params );
$params = (object) pods_sanitize( $params );
}
else
$params = (object) pods_sanitize( $params );
$params->table_info = false;
$pod = $this->load_pod( $params, $strict );
if ( empty( $pod ) ) {
if ( false !== $strict )
return pods_error( __( 'Pod not found', 'pods' ), $this );
return false;
}
$params->id = (int) $pod[ 'id' ];
$params->name = $pod[ 'name' ];
foreach ( $pod[ 'fields' ] as $field ) {
$field[ 'pod' ] = $pod;
$this->delete_field( $field, false );
}
// Only delete the post once the fields are taken care of, it's not required anymore
$success = wp_delete_post( $params->id );
if ( !$success )
return pods_error( __( 'Pod unable to be deleted', 'pods' ), $this );
// Reset content
if ( $delete_all )
$this->reset_pod( $params, $pod );
if ( !pods_tableless() ) {
if ( 'table' == $pod[ 'storage' ] ) {
try {
pods_query( "DROP TABLE IF EXISTS `@wp_pods_{$params->name}`", false );
}
catch ( Exception $e ) {
// Allow pod to be deleted if the table doesn't exist
if ( false === strpos( $e->getMessage(), 'Unknown table' ) )
return pods_error( $e->getMessage(), $this );
}
}
pods_query( "DELETE FROM `@wp_podsrel` WHERE `pod_id` = {$params->id} OR `related_pod_id` = {$params->id}", false );
}
// @todo Delete relationships from tableless relationships
// Delete any relationship references
$sql = "
DELETE `pm`
FROM `{$wpdb->postmeta}` AS `pm`
LEFT JOIN `{$wpdb->posts}` AS `p`
ON `p`.`post_type` = '_pods_field'
AND `p`.`ID` = `pm`.`post_id`
LEFT JOIN `{$wpdb->postmeta}` AS `pm2`
ON `pm2`.`meta_key` = 'pick_object'
AND `pm2`.`meta_value` = 'pod'
AND `pm2`.`post_id` = `pm`.`post_id`
WHERE
`p`.`ID` IS NOT NULL
AND `pm2`.`meta_id` IS NOT NULL
AND `pm`.`meta_key` = 'pick_val'
AND `pm`.`meta_value` = '{$params->name}'
";
pods_query( $sql );
$this->cache_flush_pods( $pod );
return true;
}
/**
* Drop a field within a Pod
*
* $params['id'] int The field ID
* $params['name'] int The field name
* $params['pod'] string The Pod name
* $params['pod_id'] string The Pod name
*
* @param array $params An associative array of parameters
* @param bool $table_operation Whether or not to handle table operations
*
* @uses PodsAPI::load_field
* @uses wp_delete_post
* @uses pods_query
*
* @return bool
* @since 1.7.9
*/
public function delete_field ( $params, $table_operation = true ) {
/**
* @var $wpdb wpdb
*/
global $wpdb;
$tableless_field_types = PodsForm::tableless_field_types();
$simple_tableless_objects = PodsForm::field_method( 'pick', 'simple_objects' );
$params = (object) pods_sanitize( $params );
if ( !isset( $params->pod ) )
$params->pod = '';
if ( !isset( $params->pod_id ) )
$params->pod_id = 0;
$pod = $params->pod;
$save_pod = false;
if ( !is_array( $pod ) )
$pod = $this->load_pod( array( 'name' => $pod, 'id' => $params->pod_id, 'table_info' => false ) );
else
$save_pod = true;
if ( empty( $pod ) )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$params->pod_id = $pod[ 'id' ];
$params->pod = $pod[ 'name' ];
if ( !isset( $params->name ) )
$params->name = '';
if ( !isset( $params->id ) )
$params->id = 0;
$field = $this->load_field( array( 'name' => $params->name, 'id' => $params->id ) );
if ( false === $field )
return pods_error( __( 'Field not found', 'pods' ), $this );
$params->id = $field[ 'id' ];
$params->name = $field[ 'name' ];
$simple = ( 'pick' == $field[ 'type' ] && in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) );
$simple = (boolean) $this->do_hook( 'tableless_custom', $simple, $field, $pod, $params );
if ( $table_operation && 'table' == $pod[ 'storage' ] && ( !in_array( $field[ 'type' ], $tableless_field_types ) || $simple ) )
pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` DROP COLUMN `{$params->name}`", false );
$success = wp_delete_post( $params->id );
if ( !$success )
return pods_error( __( 'Field unable to be deleted', 'pods' ), $this );
$wpdb->query( $wpdb->prepare( "DELETE pm FROM {$wpdb->postmeta} AS pm
LEFT JOIN {$wpdb->posts} AS p
ON p.post_type = '_pods_field' AND p.ID = pm.post_id
WHERE p.ID IS NOT NULL AND pm.meta_key = 'sister_id' AND pm.meta_value = %d", $params->id ) );
if ( ( !pods_tableless() ) && $table_operation ) {
pods_query( "DELETE FROM `@wp_podsrel` WHERE (`pod_id` = {$params->pod_id} AND `field_id` = {$params->id}) OR (`related_pod_id` = {$params->pod_id} AND `related_field_id` = {$params->id})", false );
}
// @todo Delete tableless relationship meta
if ( true === $save_pod )
$this->cache_flush_pods( $pod );
return true;
}
/**
* Drop a Pod Object
*
* $params['id'] int The object ID
* $params['name'] string The object name
* $params['type'] string The object type
*
* @param array|object $params An associative array of parameters
*
* @uses wp_delete_post
*
* @return bool
* @since 2.0
*/
public function delete_object ( $params ) {
$params = (object) $params;
$object = $this->load_object( $params );
if ( empty( $object ) )
return pods_error( sprintf( __( "%s Object not found", 'pods' ), ucwords( $params->type ) ), $this );
$success = wp_delete_post( $params->id );
if ( !$success )
return pods_error( sprintf( __( "%s Object not deleted", 'pods' ), ucwords( $params->type ) ), $this );
pods_transient_clear( 'pods_objects_' . $params->type );
return true;
}
/**
* @see PodsAPI::delete_object
*
* Drop a Pod Template
*
* $params['id'] int The template ID
* $params['name'] string The template name
*
* @param array $params An associative array of parameters
*
* @return bool
* @since 1.7.9
*/
public function delete_template ( $params ) {
$params = (object) $params;
$params->type = 'template';
return $this->delete_object( $params );
}
/**
* @see PodsAPI::delete_object
*
* Drop a Pod Page
*
* $params['id'] int The page ID
* $params['uri'] string The page URI
*
* @param array $params An associative array of parameters
*
* @return bool
* @since 1.7.9
*/
public function delete_page ( $params ) {
$params = (object) $params;
if ( isset( $params->uri ) ) {
$params->name = $params->uri;
unset( $params->uri );
}
if ( isset( $params->name ) )
$params->name = trim( $params->name, '/' );
$params->type = 'page';
return $this->delete_object( $params );
}
/**
* @see PodsAPI::delete_object
*
* Drop a Pod Helper
*
* $params['id'] int The helper ID
* $params['name'] string The helper name
*
* @param array $params An associative array of parameters
*
* @return bool
* @since 1.7.9
*/
public function delete_helper ( $params ) {
$params = (object) $params;
$params->type = 'helper';
return $this->delete_object( $params );
}
/**
* Drop a single pod item
*
* $params['id'] int (optional) The item's ID from the wp_pod_* table (used with datatype parameter)
* $params['pod'] string (optional) The Pod name (used with id parameter)
* $params['pod_id'] int (optional) The Pod ID (used with id parameter)
* $params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
*
* @param array $params An associative array of parameters
* @param bool $wp Whether to run WP object delete action
*
* @return bool
* @since 1.7.9
*/
public function delete_pod_item ( $params, $wp = true ) {
$params = (object) pods_sanitize( $params );
// @deprecated 2.0
if ( isset( $params->datatype_id ) || isset( $params->datatype ) || isset( $params->tbl_row_id ) ) {
if ( isset( $params->tbl_row_id ) ) {
pods_deprecated( __( '$params->id instead of $params->tbl_row_id', 'pods' ), '2.0' );
$params->id = $params->tbl_row_id;
unset( $params->tbl_row_id );
}
if ( isset( $params->pod_id ) ) {
pods_deprecated( __( '$params->id instead of $params->pod_id', 'pods' ), '2.0' );
$params->id = $params->pod_id;
unset( $params->pod_id );
}
if ( isset( $params->dataype_id ) ) {
pods_deprecated( __( '$params->pod_id instead of $params->datatype_id', 'pods' ), '2.0' );
$params->pod_id = $params->dataype_id;
unset( $params->dataype_id );
}
if ( isset( $params->datatype ) ) {
pods_deprecated( __( '$params->pod instead of $params->datatype', 'pods' ), '2.0' );
$params->pod = $params->datatype;
unset( $params->datatype );
}
}
if ( !isset( $params->id ) )
return pods_error( __( 'Pod Item not found', 'pods' ), $this );
$params->id = pods_absint( $params->id );
if ( !isset( $params->pod ) )
$params->pod = '';
if ( !isset( $params->pod_id ) )
$params->pod_id = 0;
$pod = $this->load_pod( array( 'name' => $params->pod, 'id' => $params->pod_id, 'table_info' => false ) );
if ( false === $pod )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$params->pod_id = $pod[ 'id' ];
$params->pod = $pod[ 'name' ];
// Allow Helpers to bypass subsequent helpers in recursive delete_pod_item calls
$bypass_helpers = false;
if ( isset( $params->bypass_helpers ) && false !== $params->bypass_helpers )
$bypass_helpers = true;
$pre_delete_helpers = $post_delete_helpers = array();
if ( false === $bypass_helpers ) {
// Plugin hook
$this->do_hook( 'pre_delete_pod_item', $params, $pod );
$this->do_hook( "pre_delete_pod_item_{$params->pod}", $params, $pod );
// Call any pre-save helpers (if not bypassed)
if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
if ( !empty( $pod[ 'options' ] ) && is_array( $pod[ 'options' ] ) ) {
$helpers = array( 'pre_delete_helpers', 'post_delete_helpers' );
foreach ( $helpers as $helper ) {
if ( isset( $pod[ 'options' ][ $helper ] ) && !empty( $pod[ 'options' ][ $helper ] ) )
${$helper} = explode( ',', $pod[ 'options' ][ $helper ] );
}
}
if ( !empty( $pre_delete_helpers ) ) {
pods_deprecated( sprintf( __( 'Pre-delete helpers are deprecated, use the action pods_pre_delete_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
foreach ( $pre_delete_helpers as $helper ) {
$helper = $this->load_helper( array( 'name' => $helper ) );
if ( false !== $helper )
eval( '?>' . $helper[ 'code' ] );
}
}
}
}
// Delete object from relationship fields
$this->delete_object_from_relationships( $params->id, $pod );
if ( 'table' == $pod[ 'storage' ] )
pods_query( "DELETE FROM `@wp_pods_{$params->pod}` WHERE `id` = {$params->id} LIMIT 1" );
if ( $wp && 'taxonomy' == $pod[ 'type' ] ) {
$taxonomy = $pod[ 'name' ];
if ( !empty( $pod[ 'object' ] ) )
$taxonomy = $pod[ 'object' ];
wp_delete_term( $params->id, $taxonomy );
}
elseif ( $wp && !in_array( $pod[ 'type' ], array( 'pod', 'table', '', 'taxonomy' ) ) )
$this->delete_wp_object( $pod[ 'type' ], $params->id );
if ( false === $bypass_helpers ) {
// Plugin hook
$this->do_hook( 'post_delete_pod_item', $params, $pod );
$this->do_hook( "post_delete_pod_item_{$params->pod}", $params, $pod );
// Call any post-save helpers (if not bypassed)
if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
if ( !empty( $post_delete_helpers ) ) {
pods_deprecated( sprintf( __( 'Post-delete helpers are deprecated, use the action pods_post_delete_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
foreach ( $post_delete_helpers as $helper ) {
$helper = $this->load_helper( array( 'name' => $helper ) );
if ( false !== $helper )
eval( '?>' . $helper[ 'code' ] );
}
}
}
}
pods_cache_clear( $params->id, 'pods_items_' . $params->pod );
return true;
}
/**
* Delete an object from tableless fields
*
* @param int $id
* @param string $type
* @param string $name
*
* @return bool
*
* @since 2.3
*/
public function delete_object_from_relationships ( $id, $object, $name = null ) {
/**
* @var $pods_init \PodsInit
*/
global $pods_init;
$pod = false;
// Run any bidirectional delete operations
if ( is_array( $object ) )
$pod = $object;
elseif ( is_object( $pods_init ) )
$pod = PodsInit::$meta->get_object( $object, $name );
if ( !empty( $pod ) ) {
$object = $pod[ 'type' ];
$name = $pod[ 'name' ];
foreach ( $pod[ 'fields' ] as $field ) {
PodsForm::delete( $field[ 'type' ], $id, $field[ 'name' ], array_merge( $field, $field[ 'options' ] ), $pod );
}
}
// Lookup related fields (non-bidirectional)
$params = array(
'where' => array(
array(
'key' => 'type',
'value' => 'pick'
),
array(
'key' => 'pick_object',
'value' => $object
)
)
);
if ( !empty( $name ) && $name != $object ) {
$params[ 'where' ][] = array(
'key' => 'pick_val',
'value' => $name
);
}
$fields = $this->load_fields( $params, false );
if ( !empty( $pod ) && 'media' == $pod[ 'type' ] ) {
$params[ 'where' ] = array(
array(
'key' => 'type',
'value' => 'file'
)
);
$fields = array_merge( $fields, $this->load_fields( $params, false ) );
}
if ( is_array( $fields ) && !empty( $fields ) ) {
foreach ( $fields as $related_field ) {
$related_pod = $this->load_pod( array( 'id' => $related_field[ 'pod_id' ], 'fields' => false ), false );
if ( empty( $related_pod ) )
continue;
$related_from = $this->lookup_related_items_from( $related_field[ 'id' ], $related_pod[ 'id' ], $id, $related_field, $related_pod );
$this->delete_relationships( $related_from, $id, $related_pod, $related_field );
}
}
if ( !empty( $pod ) && !pods_tableless() ) {
pods_query( "
DELETE FROM `@wp_podsrel`
WHERE
(
`pod_id` = %d
AND `item_id` = %d
)
OR (
`related_pod_id` = %d
AND `related_item_id` = %d
)
", array(
$pod[ 'id' ],
$id,
$pod[ 'id' ],
$id
) );
}
return true;
}
/**
* Delete relationships
*
* @param int|array $related_id IDs for items to save
* @param int|array $id ID or IDs to remove
* @param array $related_pod Pod data
* @param array $related_field Field data
*
* @return void
*
* @since 2.3
*/
public function delete_relationships ( $related_id, $id, $related_pod, $related_field ) {
if ( is_array( $related_id ) ) {
foreach ( $related_id as $rid ) {
$this->delete_relationships( $rid, $id, $related_pod, $related_field );
}
return;
}
if ( is_array( $id ) ) {
foreach ( $id as $rid ) {
$this->delete_relationships( $related_id, $rid, $related_pod, $related_field );
}
return;
}
$id = (int) $id;
if ( empty( $id ) )
return;
$related_ids = $this->lookup_related_items( $related_field[ 'id' ], $related_pod[ 'id' ], $related_id, $related_field, $related_pod );
if ( empty( $related_ids ) )
return;
elseif ( !in_array( $id, $related_ids ) )
return;
unset( $related_ids[ array_search( $id, $related_ids ) ] );
$no_conflict = pods_no_conflict_check( $related_pod[ 'type' ] );
if ( !$no_conflict )
pods_no_conflict_on( $related_pod[ 'type' ] );
// Post Types, Media, Users, and Comments (meta-based)
if ( in_array( $related_pod[ 'type' ], array( 'post_type', 'media', 'user', 'comment' ) ) ) {
$object_type = $related_pod[ 'type' ];
if ( 'post_type' == $object_type || 'media' == $object_type )
$object_type = 'post';
delete_metadata( $object_type, $related_id, $related_field[ 'name' ] );
if ( !empty( $related_ids ) ) {
update_metadata( $object_type, $related_id, '_pods_' . $related_field[ 'name' ], $related_ids );
foreach ( $related_ids as $rel_id ) {
add_metadata( $object_type, $related_id, $related_field[ 'name' ], $rel_id );
}
}
else
delete_metadata( $object_type, $related_id, '_pods_' . $related_field[ 'name' ] );
}
// Custom Settings Pages (options-based)
elseif ( 'settings' == $related_pod[ 'type' ] ) {
if ( !empty( $related_ids ) )
update_option( $related_pod[ 'name' ] . '_' . $related_field[ 'name' ], $related_ids );
else
delete_option( $related_pod[ 'name' ] . '_' . $related_field[ 'name' ] );
}
// Relationships table
if ( !pods_tableless() ) {
pods_query( "
DELETE FROM `@wp_podsrel`
WHERE
(
`pod_id` = %d
AND `field_id` = %d
AND `item_id` = %d
AND `related_item_id` = %d
)
OR (
`related_pod_id` = %d
AND `related_field_id` = %d
AND `related_item_id` = %d
AND `item_id` = %d
)
", array(
$related_pod[ 'id' ],
$related_field[ 'id' ],
$related_id,
$id,
$related_pod[ 'id' ],
$related_field[ 'id' ],
$related_id,
$id
) );
}
if ( !$no_conflict )
pods_no_conflict_off( $related_pod[ 'type' ] );
}
/**
* Check if a Pod exists
*
* $params['id'] int Pod ID
* $params['name'] string Pod name
*
* @param array $params An associative array of parameters
*
* @return bool True if exists
*
* @since 1.12
*/
public function pod_exists ( $params, $type = null ) {
if ( is_string( $params ) )
$params = array( 'name' => $params );
$params = (object) pods_sanitize( $params );
if ( !empty( $params->id ) || !empty( $params->name ) ) {
if ( !isset( $params->name ) )
$pod = get_post( $dummy = (int) $params->id );
else {
$pod = get_posts( array(
'name' => $params->name,
'post_type' => '_pods_pod',
'posts_per_page' => 1
) );
}
if ( !empty( $pod ) && ( empty( $type ) || $type == get_post_meta( $pod->ID, 'type', true ) ) )
return true;
}
return false;
}
/**
* Load a Pod and all of its fields
*
* $params['id'] int The Pod ID
* $params['name'] string The Pod name
* $params['fields'] bool Whether to load fields (default is true)
*
* @param array|object $params An associative array of parameters or pod name as a string
* @param bool $strict Makes sure the pod exists, throws an error if it doesn't work
*
* @return array|bool|mixed|void
* @since 1.7.9
*/
public function load_pod ( $params, $strict = true ) {
/**
* @var $sitepress SitePress
*/
global $sitepress, $icl_adjust_id_url_filter_off;
$current_language = false;
$load_fields = true;
// WPML support
if ( is_object( $sitepress ) && !$icl_adjust_id_url_filter_off )
$current_language = pods_sanitize( ICL_LANGUAGE_CODE );
// Polylang support
elseif ( function_exists( 'pll_current_language' ) )
$current_language = pll_current_language( 'slug' );
if ( !is_array( $params ) && !is_object( $params ) )
$params = array( 'name' => $params, 'table_info' => false, 'fields' => true );
if ( is_object( $params ) && isset( $params->fields ) && !$params->fields )
$load_fields = false;
elseif ( is_array( $params ) && isset( $params[ 'fields' ] ) && !$params[ 'fields' ] )
$load_fields = false;
$transient = 'pods_pod';
if ( !empty( $current_language ) )
$transient .= '_' . $current_language;
if ( !$load_fields )
$transient .= '_nofields';
if ( pods_var_raw( 'table_info', $params, false ) )
$transient .= '_tableinfo';
if ( is_object( $params ) && isset( $params->post_name ) ) {
$pod = false;
if ( pods_api_cache() )
$pod = pods_transient_get( $transient . '_' . $params->post_name );
if ( false !== $pod && isset( $pod[ 'table' ] ) ) {
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && is_object( $sitepress ) && !$icl_adjust_id_url_filter_off )
$pod = array_merge( $pod, $this->get_table_info( $pod[ 'type' ], $pod[ 'object' ], $pod[ 'name' ], $pod ) );
return $pod;
}
$_pod = get_object_vars( $params );
}
else {
$params = (object) pods_sanitize( $params );
if ( ( !isset( $params->id ) || empty( $params->id ) ) && ( !isset( $params->name ) || empty( $params->name ) ) ) {
if ( $strict )
return pods_error( 'Either Pod ID or Name are required', $this );
return false;
}
if ( isset( $params->name ) ) {
$pod = false;
if ( '_pods_pod' == $params->name ) {
$pod = array(
'id' => 0,
'name' => $params->name,
'label' => __( 'Pods', 'pods' ),
'type' => 'post_type',
'storage' => 'meta',
'options' => array(
'label_singular' => __( 'Pod', 'pods' )
),
'fields' => array()
);
}
elseif ( '_pods_field' == $params->name ) {
$pod = array(
'id' => 0,
'name' => $params->name,
'label' => __( 'Pod Fields', 'pods' ),
'type' => 'post_type',
'storage' => 'meta',
'options' => array(
'label_singular' => __( 'Pod Field', 'pods' )
),
'fields' => array()
);
}
elseif ( pods_api_cache() )
$pod = pods_transient_get( $transient . '_' . $params->name );
if ( false !== $pod && ( !pods_var_raw( 'table_info', $params, true ) || isset( $pod[ 'table' ] ) ) ) {
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && is_object( $sitepress ) && !$icl_adjust_id_url_filter_off )
$pod = array_merge( $pod, $this->get_table_info( $pod[ 'type' ], $pod[ 'object' ], $pod[ 'name' ], $pod ) );
return $pod;
}
}
if ( !isset( $params->name ) )
$pod = get_post( $dummy = (int) $params->id );
else {
$pod = get_posts( array(
'name' => $params->name,
'post_type' => '_pods_pod',
'posts_per_page' => 1
) );
}
if ( empty( $pod ) ) {
if ( $strict )
return pods_error( __( 'Pod not found', 'pods' ), $this );
return false;
}
if ( is_array( $pod ) )
$pod = $pod[ 0 ];
$_pod = get_object_vars( $pod );
}
$pod = false;
if ( pods_api_cache() )
$pod = pods_transient_get( $transient . '_' . $_pod[ 'post_name' ] );
if ( false !== $pod && ( !pods_var_raw( 'table_info', $params, true ) || isset( $pod[ 'table' ] ) ) ) {
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && is_object( $sitepress ) && !$icl_adjust_id_url_filter_off )
$pod = array_merge( $pod, $this->get_table_info( $pod[ 'type' ], $pod[ 'object' ], $pod[ 'name' ], $pod ) );
return $pod;
}
$pod = array(
'id' => $_pod[ 'ID' ],
'name' => $_pod[ 'post_name' ],
'label' => $_pod[ 'post_title' ],
'description' => $_pod[ 'post_content' ]
);
if ( strlen( $pod[ 'label' ] ) < 1 )
$pod[ 'label' ] = $pod[ 'name' ];
// @todo update with a method to put all options in
$defaults = array(
'show_in_menu' => 1,
'type' => 'post_type',
'storage' => 'meta',
'object' => '',
'alias' => ''
);
$pod[ 'options' ] = get_post_meta( $pod[ 'id' ] );
foreach ( $pod[ 'options' ] as $option => $value ) {
if ( is_array( $value ) ) {
foreach ( $value as $k => $v ) {
if ( !is_array( $v ) )
$value[ $k ] = maybe_unserialize( $v );
}
if ( 1 == count( $value ) )
$value = current( $value );
}
else
$value = maybe_unserialize( $value );
$pod[ 'options' ][ $option ] = $value;
}
$pod[ 'options' ] = array_merge( $defaults, $pod[ 'options' ] );
$pod[ 'type' ] = $pod[ 'options' ][ 'type' ];
$pod[ 'storage' ] = $pod[ 'options' ][ 'storage' ];
$pod[ 'object' ] = $pod[ 'options' ][ 'object' ];
$pod[ 'alias' ] = $pod[ 'options' ][ 'alias' ];
unset( $pod[ 'options' ][ 'type' ] );
unset( $pod[ 'options' ][ 'storage' ] );
unset( $pod[ 'options' ][ 'object' ] );
unset( $pod[ 'options' ][ 'alias' ] );
if ( false !== pods_var_raw( 'table_info', $params, true ) )
$pod = array_merge( $this->get_table_info( $pod[ 'type' ], $pod[ 'object' ], $pod[ 'name' ], $pod ), $pod );
if ( isset( $pod[ 'pod' ] ) )
unset( $pod[ 'pod' ] );
$pod[ 'fields' ] = array();
$pod[ 'object_fields' ] = array();
if ( 'pod' != $pod[ 'type' ] )
$pod[ 'object_fields' ] = $this->get_wp_object_fields( $pod[ 'type' ], $pod );
$fields = get_posts( array(
'post_type' => '_pods_field',
'posts_per_page' => -1,
'nopaging' => true,
'post_parent' => $pod[ 'id' ],
'orderby' => 'menu_order',
'order' => 'ASC'
) );
if ( !empty( $fields ) ) {
foreach ( $fields as $field ) {
$field->pod = $pod[ 'name' ];
$field->table_info = (boolean) pods_var_raw( 'table_info', $params, true );
if ( $load_fields ) {
$field = $this->load_field( $field );
$field = PodsForm::field_setup( $field, null, $field[ 'type' ] );
}
else {
$field = array(
'id' => $field->ID,
'name' => $field->post_name,
'label' => $field->post_title,
'type' => get_post_meta( $field->ID, 'type', true )
);
}
$pod[ 'fields' ][ $field[ 'name' ] ] = $field;
}
}
if ( did_action( 'init' ) && pods_api_cache() )
pods_transient_set( $transient . '_' . $pod[ 'name' ], $pod );
return $pod;
}
/**
* Load a list of Pods based on filters specified.
*
* $params['type'] string/array Pod Type(s) to filter by
* $params['object'] string/array Pod Object(s) to filter by
* $params['options'] array Pod Option(s) key=>value array to filter by
* $params['orderby'] string ORDER BY clause of query
* $params['limit'] string Number of Pods to return
* $params['where'] string WHERE clause of query
* $params['ids'] string|array IDs of Objects
* $params['count'] boolean Return only a count of Pods
* $params['names'] boolean Return only an array of name => label
* $params['ids'] boolean Return only an array of ID => label
* $params['fields'] boolean Return pod fields with Pods (default is true)
* $params['key_names'] boolean Return pods keyed by name
*
* @param array $params An associative array of parameters
*
* @return array|mixed
*
* @uses PodsAPI::load_pod
*
* @since 2.0
*/
public function load_pods ( $params = null ) {
/**
* @var $sitepress SitePress
*/
global $sitepress, $icl_adjust_id_url_filter_off;
$current_language = false;
// WPML support
if ( is_object( $sitepress ) && !$icl_adjust_id_url_filter_off )
$current_language = pods_sanitize( ICL_LANGUAGE_CODE );
// Polylang support
elseif ( function_exists( 'pll_current_language' ) )
$current_language = pll_current_language( 'slug' );
$params = (object) pods_sanitize( $params );
$order = 'ASC';
$orderby = 'menu_order title';
$limit = -1;
$ids = false;
$meta_query = array();
$cache_key = '';
if ( isset( $params->type ) && !empty( $params->type ) ) {
if ( !is_array( $params->type ) )
$params->type = array( trim( $params->type ) );
sort( $params->type );
$meta_query[] = array(
'key' => 'type',
'value' => $params->type,
'compare' => 'IN'
);
if ( 1 == count( $params->type ) )
$cache_key .= '_type_' . trim( implode( '', $params->type ) );
}
if ( isset( $params->object ) && !empty( $params->object ) ) {
if ( !is_array( $params->object ) )
$params->object = array( $params->object );
$params->object = pods_trim( $params->object );
sort( $params->object );
$meta_query[] = array(
'key' => 'object',
'value' => $params->object,
'compare' => 'IN'
);
if ( 1 == count( $params->object ) )
$cache_key .= '_object_' . trim( implode( '', $params->object ) );
}
if ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) {
foreach ( $params->options as $option => $value ) {
if ( !is_array( $value ) )
$value = array( $value );
$value = pods_trim( $value );
sort( $value );
$meta_query[] = array(
'key' => $option,
'value' => pods_sanitize( $value ),
'compare' => 'IN'
);
}
$cache_key = '';
}
if ( isset( $params->where ) && is_array( $params->where ) )
$meta_query = array_merge( $meta_query, (array) $params->where );
if ( isset( $params->order ) && !empty( $params->order ) && in_array( strtoupper( $params->order ), array( 'ASC', 'DESC' ) ) )
$order = strtoupper( $params->order );
if ( isset( $params->orderby ) && !empty( $params->orderby ) )
$orderby = strtoupper( $params->orderby );
if ( isset( $params->limit ) && !empty( $params->limit ) )
$limit = pods_absint( $params->limit );
if ( isset( $params->ids ) && !empty( $params->ids ) ) {
$ids = $params->ids;
if ( !is_array( $ids ) )
$ids = explode( ',', $ids );
}
if ( empty( $ids ) )
$ids = false;
$pre_key = '';
if ( !empty( $current_language ) )
$pre_key .= '_' . $current_language;
if ( isset( $params->count ) && $params->count )
$pre_key .= '_count';
if ( isset( $params->ids ) && $params->ids && !empty( $ids ) )
$pre_key .= '_ids_' . implode( '_', $ids );
if ( isset( $params->names ) && $params->names )
$pre_key .= '_names';
elseif ( isset( $params->names_ids ) && $params->names_ids )
$pre_key .= '_names_ids';
if ( isset( $params->key_names ) && $params->key_names )
$pre_key .= '_namekeys';
if ( isset( $params->fields ) && !$params->fields )
$pre_key .= '_nofields';
if ( isset( $params->table_info ) && $params->table_info )
$pre_key .= '_tableinfo';
$pre_key .= '_get';
if ( empty( $cache_key ) )
$cache_key = 'pods' . $pre_key . '_all';
else
$cache_key = 'pods' . $pre_key . $cache_key;
if ( pods_api_cache() && !empty( $cache_key ) && ( 'pods' . ( !empty( $current_language ) ? '_' . $current_language : '' ) . '_get_all' != $cache_key || empty( $meta_query ) ) && $limit < 1 && ( empty( $orderby ) || 'menu_order title' == $orderby ) && empty( $ids ) ) {
$the_pods = pods_transient_get( $cache_key );
if ( false === $the_pods )
$the_pods = pods_cache_get( $cache_key, 'pods' );
if ( !is_array( $the_pods ) && 'none' == $the_pods )
return array();
elseif ( false !== $the_pods )
return $the_pods;
}
$the_pods = array();
$_pods = get_posts( array(
'post_type' => '_pods_pod',
'nopaging' => true,
'posts_per_page' => $limit,
'order' => $order,
'orderby' => $orderby,
'meta_query' => $meta_query,
'post__in' => $ids
) );
$export_ignore = array(
'object_type',
'object_name',
'table',
'meta_table',
'pod_table',
'field_id',
'field_index',
'field_slug',
'field_type',
'field_parent',
'field_parent_select',
'meta_field_id',
'meta_field_index',
'meta_field_value',
'pod_field_id',
'pod_field_index',
'object_fields',
'join',
'where',
'where_default',
'orderby',
'pod',
'recurse',
'table_info',
'attributes',
'group',
'grouped',
'developer_mode',
'dependency',
'depends-on',
'excludes-on'
);
$total_fields = 0;
if ( isset( $params->count ) && $params->count )
$the_pods = count( $_pods );
else {
foreach ( $_pods as $pod ) {
if ( isset( $params->names ) && $params->names )
$the_pods[ $pod->post_name ] = $pod->post_title;
elseif ( isset( $params->names_ids ) && $params->names_ids )
$the_pods[ $pod->ID ] = $pod->post_name;
else {
if ( isset( $params->fields ) && !$params->fields )
$pod->fields = false;
$pod = $this->load_pod( $pod );
// Remove extra data not needed
if ( pods_var( 'export', $params, false ) && ( !isset( $params->fields ) || $params->fields ) ) {
foreach ( $export_ignore as $ignore ) {
if ( isset( $pod[ $ignore ] ) )
unset( $pod[ $ignore ] );
}
foreach ( $pod[ 'fields' ] as $field => $field_data ) {
if ( isset( $pod[ 'fields' ][ $field ][ 'table_info' ] ) )
unset( $pod[ 'fields' ][ $field ][ 'table_info' ] );
}
}
$total_fields += count( $pod[ 'fields' ] );
if ( isset( $params->key_names ) && $params->key_names )
$the_pods[ $pod[ 'name' ] ] = $pod;
else
$the_pods[ $pod[ 'id' ] ] = $pod;
}
}
}
if ( ( !function_exists( 'pll_current_language' ) || ( isset( $params->refresh ) && $params->refresh ) ) && !empty( $cache_key ) && ( 'pods' != $cache_key || empty( $meta_query ) ) && $limit < 1 && ( empty( $orderby ) || 'menu_order title' == $orderby ) && empty( $ids ) ) {
// Too many Pods can cause issues with the DB when caching is not enabled
if ( 15 < count( $the_pods ) || 75 < count( $total_fields ) ) {
pods_transient_clear( $cache_key );
if ( pods_api_cache() ) {
if ( empty( $the_pods ) && ( !isset( $params->count ) || !$params->count ) )
pods_cache_set( $cache_key, 'none', 'pods' );
else
pods_cache_set( $cache_key, $the_pods, 'pods' );
}
}
else {
pods_cache_clear( $cache_key, 'pods' );
if ( pods_api_cache() ) {
if ( empty( $the_pods ) && ( !isset( $params->count ) || !$params->count ) )
pods_transient_set( $cache_key, 'none' );
else
pods_transient_set( $cache_key, $the_pods );
}
}
}
return $the_pods;
}
/**
* Check if a Pod's field exists
*
* $params['pod_id'] int The Pod ID
* $params['id'] int The field ID
* $params['name'] string The field name
*
* @param array $params An associative array of parameters
*
* @return bool
*
* @since 1.12
*/
public function field_exists ( $params ) {
$params = (object) pods_sanitize( $params );
if ( ( !empty( $params->id ) || !empty( $params->name ) ) && isset( $params->pod_id ) && !empty( $params->pod_id ) ) {
if ( !isset( $params->name ) )
$field = get_post( $dummy = (int) $params->id );
else {
$field = get_posts( array(
'name' => $params->name,
'post_type' => '_pods_field',
'posts_per_page' => 1,
'post_parent' => $params->pod_id
) );
}
if ( !empty( $field ) )
return true;
}
return false;
}
/**
* Load a field
*
* $params['pod_id'] int The Pod ID
* $params['pod'] string The Pod name
* $params['id'] int The field ID
* $params['name'] string The field name
* $params['table_info'] boolean Whether to lookup a pick field's table info
*
* @param array $params An associative array of parameters
* @param boolean $strict Whether to require a field exist or not when loading the info
*
* @return array|bool Array with field data, false if field not found
* @since 1.7.9
*/
public function load_field ( $params, $strict = false ) {
$params = (object) $params;
if ( !isset( $params->table_info ) )
$params->table_info = false;
$pod = array();
$field = array();
if ( isset( $params->post_title ) )
$_field = $params;
elseif ( isset( $params->id ) && !empty( $params->id ) )
$_field = get_post( $dumb = (int) $params->id );
else {
if ( !isset( $params->pod ) )
$params->pod = '';
if ( !isset( $params->pod_id ) )
$params->pod_id = 0;
if ( isset( $params->pod_data ) )
$pod = $params->pod_data;
else {
$pod = $this->load_pod( array( 'name' => $params->pod, 'id' => $params->pod_id, 'table_info' => false ), false );
if ( false === $pod ) {
if ( $strict )
return pods_error( __( 'Pod not found', 'pods' ), $this );
return false;
}
}
$params->pod_id = $pod[ 'id' ];
$params->pod = $pod[ 'name' ];
if ( empty( $params->name ) && empty( $params->pod ) && empty( $params->pod_id ) )
return pods_error( __( 'Either Field Name or Field ID / Pod ID are required', 'pods' ), $this );
$params->name = pods_clean_name( $params->name, true, ( 'meta' == $pod[ 'storage' ] ? false : true ) );
if ( isset( $pod[ 'fields' ][ $params->name ] ) && isset( $pod[ 'fields' ][ $params->name ][ 'id' ] ) )
return $pod[ 'fields' ][ $params->name ];
$field = false;
if ( pods_api_cache() )
$field = pods_transient_get( 'pods_field_' . $params->pod . '_' . $params->name );
if ( empty( $field ) ) {
$field = get_posts( array(
'name' => $params->name,
'post_type' => '_pods_field',
'posts_per_page' => 1,
'post_parent' => $params->pod_id
) );
if ( empty( $field ) ) {
if ( $strict )
return pods_error( __( 'Field not found', 'pods' ), $this );
return false;
}
$_field = $field[ 0 ];
$field = array();
}
}
if ( empty( $_field ) ) {
if ( $strict )
return pods_error( __( 'Field not found', 'pods' ), $this );
return false;
}
$_field = get_object_vars( $_field );
if ( !isset( $pod[ 'name' ] ) && !isset( $_field[ 'pod' ] ) ) {
if ( 0 < $_field[ 'post_parent' ] )
$pod = $this->load_pod( array( 'id' => $_field[ 'post_parent' ], 'table_info' => false ), false );
if ( empty( $pod ) ) {
if ( $strict )
return pods_error( __( 'Pod for field not found', 'pods' ), $this );
return false;
}
}
if ( empty( $field ) ) {
if ( pods_api_cache() && ( isset( $pod[ 'name' ] ) || isset( $_field[ 'pod' ] ) ) )
$field = pods_transient_get( 'pods_field_' . pods_var( 'name', $pod, pods_var( 'pod', $_field ), null, true ) . '_' . $_field[ 'post_name' ] );
if ( empty( $field ) ) {
$defaults = array(
'type' => 'text'
);
$field = array(
'id' => $_field[ 'ID' ],
'name' => $_field[ 'post_name' ],
'label' => $_field[ 'post_title' ],
'description' => $_field[ 'post_content' ],
'weight' => $_field[ 'menu_order' ],
'pod_id' => $_field[ 'post_parent' ],
'pick_object' => '',
'pick_val' => '',
'sister_id' => '',
'table_info' => array()
);
if ( isset( $pod[ 'name' ] ) )
$field[ 'pod' ] = $pod[ 'name' ];
elseif ( isset( $_field[ 'pod' ] ) )
$field[ 'pod' ] = $_field[ 'pod' ];
$field[ 'options' ] = get_post_meta( $field[ 'id' ] );
$options_ignore = array(
'method',
'table_info',
'attributes',
'group',
'grouped',
'developer_mode',
'dependency',
'depends-on',
'excludes-on'
);
foreach ( $options_ignore as $ignore ) {
if ( isset( $field[ 'options' ][ $ignore ] ) )
unset( $field[ 'options' ][ $ignore ] );
}
foreach ( $field[ 'options' ] as $option => $value ) {
if ( is_array( $value ) ) {
foreach ( $value as $k => $v ) {
if ( !is_array( $v ) )
$value[ $k ] = maybe_unserialize( $v );
}
if ( 1 == count( $value ) )
$value = current( $value );
}
else
$value = maybe_unserialize( $value );
$field[ 'options' ][ $option ] = $value;
}
$field[ 'options' ] = array_merge( $defaults, $field[ 'options' ] );
$field[ 'type' ] = $field[ 'options' ][ 'type' ];
unset( $field[ 'options' ][ 'type' ] );
if ( isset( $field[ 'options' ][ 'pick_object' ] ) ) {
$field[ 'pick_object' ] = $field[ 'options' ][ 'pick_object' ];
unset( $field[ 'options' ][ 'pick_object' ] );
}
if ( isset( $field[ 'options' ][ 'pick_val' ] ) ) {
$field[ 'pick_val' ] = $field[ 'options' ][ 'pick_val' ];
unset( $field[ 'options' ][ 'pick_val' ] );
}
if ( isset( $field[ 'options' ][ 'sister_id' ] ) ) {
$field[ 'sister_id' ] = $field[ 'options' ][ 'sister_id' ];
unset( $field[ 'options' ][ 'sister_id' ] );
}
if ( isset( $field[ 'options' ][ 'sister_field_id' ] ) )
unset( $field[ 'options' ][ 'sister_field_id' ] );
if ( pods_api_cache() && ( isset( $pod[ 'name' ] ) || isset( $_field[ 'pod' ] ) ) )
pods_transient_set( 'pods_field_' . pods_var( 'name', $pod, pods_var( 'pod', $_field ), null, true ) . '_' . $field[ 'name' ], $field );
}
}
$field[ 'table_info' ] = array();
if ( 'pick' == $field[ 'type' ] && true === $params->table_info )
$field[ 'table_info' ] = $this->get_table_info( $field[ 'pick_object' ], $field[ 'pick_val' ], null, null, $field );
return $field;
}
/**
* Load fields by Pod, ID, Name, and/or Type
*
* $params['pod_id'] int The Pod ID
* $params['pod'] string The Pod name
* $params['id'] array The field IDs
* $params['name'] array The field names
* $params['type'] array The field types
* $params['options'] array Field Option(s) key=>value array to filter by
* $params['where'] string WHERE clause of query
*
* @param array $params An associative array of parameters
* @param bool $strict Whether to require a field exist or not when loading the info
*
* @return array Array of field data.
*
* @since 1.7.9
*/
public function load_fields ( $params, $strict = false ) {
$params = (object) pods_sanitize( $params );
if ( !isset( $params->pod ) || empty( $params->pod ) )
$params->pod = '';
if ( !isset( $params->pod_id ) || empty( $params->pod_id ) )
$params->pod_id = 0;
if ( !isset( $params->name ) || empty( $params->name ) )
$params->name = array();
else
$params->name = (array) $params->name;
if ( !isset( $params->id ) || empty( $params->id ) )
$params->id = array();
else {
$params->id = (array) $params->id;
foreach ( $params->id as &$id ) {
$id = pods_absint( $id );
}
}
if ( !isset( $params->type ) || empty( $params->type ) )
$params->type = array();
else
$params->type = (array) $params->type;
$fields = array();
if ( !empty( $params->pod ) || !empty( $params->pod_id ) ) {
$pod = $this->load_pod( array( 'name' => $params->pod, 'id' => $params->pod_id, 'table_info' => true ), false );
if ( false === $pod ) {
if ( $strict )
return pods_error( __( 'Pod not found', 'pods' ), $this );
return $fields;
}
$pod[ 'fields' ] = array_merge( pods_var_raw( 'object_fields', $pod, array() ), $pod[ 'fields' ] );
foreach ( $pod[ 'fields' ] as $field ) {
if ( empty( $params->name ) && empty( $params->id ) && empty( $params->type ) )
$fields[ $field[ 'name' ] ] = $field;
elseif ( in_array( $fields[ 'name' ], $params->name ) || in_array( $fields[ 'id' ], $params->id ) || in_array( $fields[ 'type' ], $params->type ) )
$fields[ $field[ 'name' ] ] = $field;
}
}
elseif ( ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) || ( isset( $params->where ) && !empty( $params->where ) && is_array( $params->where ) ) ) {
$order = 'ASC';
$orderby = 'menu_order title';
$limit = -1;
$ids = false;
$meta_query = array();
if ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) {
foreach ( $params->options as $option => $value ) {
if ( !is_array( $value ) )
$value = array( $value );
$value = pods_trim( $value );
sort( $value );
$meta_query[] = array(
'key' => $option,
'value' => pods_sanitize( $value ),
'compare' => 'IN'
);
}
}
if ( isset( $params->where ) && !empty( $params->where ) && is_array( $params->where ) )
$meta_query = array_merge( $meta_query, (array) $params->where );
$args = array(
'post_type' => '_pods_field',
'nopaging' => true,
'posts_per_page' => $limit,
'order' => $order,
'orderby' => $orderby,
'meta_query' => $meta_query,
'post__in' => $ids
);
$fields = false;
if ( pods_api_cache() )
$fields = pods_cache_get( md5( json_encode( $args ) ), 'pods_load_fields' );
if ( false !== $fields )
return $fields;
$fields = array();
$_fields = get_posts( $args );
foreach ( $_fields as $field ) {
$field = $this->load_field( $field, false );
if ( !empty( $field ) )
$fields[ $field[ 'id' ] ] = $field;
}
if ( pods_api_cache() )
pods_cache_set( md5( json_encode( $args ) ), $fields, 'pods_load_fields' );
}
else {
if ( empty( $params->name ) && empty( $params->id ) && empty( $params->type ) )
return pods_error( __( 'Either Field Name / Field ID / Field Type, or Pod Name / Pod ID are required', 'pods' ), $this );
$lookup = array();
if ( !empty( $params->name ) ) {
$fields = implode( "', '", $params->name );
$lookup[] = "`post_name` IN ( '{$fields}' )";
}
if ( !empty( $params->id ) ) {
$fields = implode( ", ", $params->id );
$lookup[] = "`ID` IN ( {$fields} )";
}
$lookup = implode( ' AND ', $lookup );
$fields = false;
if ( pods_api_cache() )
$fields = pods_cache_get( md5( $lookup ), 'pods_load_fields' );
if ( false !== $fields )
return $fields;
$result = pods_query( "SELECT `ID`, `post_name`, `post_parent` FROM `@wp_posts` WHERE `post_type` = '_pods_field' AND ( {$lookup} )" );
$fields = array();
if ( !empty( $result ) ) {
foreach ( $result as $field ) {
$field = $this->load_field( array(
'id' => $field->ID,
'name' => $field->post_name,
'pod_id' => $field->post_parent
), false );
if ( !empty( $field ) && ( empty( $params->type ) || in_array( $field[ 'type' ], $params->type ) ) )
$fields[ $field[ 'id' ] ] = $field;
}
}
if ( pods_api_cache() )
pods_cache_set( md5( $lookup ), $fields, 'pods_load_fields' );
}
return $fields;
}
/**
* Load a Pods Object
*
* $params['id'] int The Object ID
* $params['name'] string The Object name
* $params['type'] string The Object type
*
* @param array|object $params An associative array of parameters
* @param bool $strict
*
* @return array|bool
* @since 2.0
*/
public function load_object ( $params, $strict = false ) {
if ( is_object( $params ) && isset( $params->post_title ) )
$_object = get_object_vars( $params );
else {
$params = (object) pods_sanitize( $params );
if ( !isset( $params->type ) || empty( $params->type ) )
return pods_error( __( 'Object type is required', 'pods' ), $this );
if ( ( !isset( $params->id ) || empty( $params->id ) ) && ( !isset( $params->name ) || empty( $params->name ) ) )
return pods_error( __( 'Either Object ID or Name are required', 'pods' ), $this );
/**
* @var $wpdb wpdb
*/
global $wpdb;
if ( isset( $params->name ) )
$_object = pods_by_title( $params->name, ARRAY_A, '_pods_' . $params->type, 'publish' );
else {
$object = $params->id;
$_object = get_post( $object, ARRAY_A );
}
if ( empty( $_object ) ) {
if ( $strict )
return pods_error( __( 'Object not found', 'pods' ), $this );
return false;
}
}
$object = array(
'id' => $_object[ 'ID' ],
'name' => $_object[ 'post_title' ],
'code' => $_object[ 'post_content' ],
'type' => str_replace( '_pods_', '', $_object[ 'post_type' ] ),
'slug' => $_object[ 'post_name' ]
);
$object[ 'options' ] = get_post_meta( $object[ 'id' ] );
foreach ( $object[ 'options' ] as $option => &$value ) {
if ( is_array( $value ) && 1 == count( $value ) )
$value = current( $value );
}
return $object;
}
/**
* Load Multiple Pods Objects
*
* $params['type'] string The Object type
* $params['options'] array Pod Option(s) key=>value array to filter by
* $params['orderby'] string ORDER BY clause of query
* $params['limit'] string Number of objects to return
* $params['where'] string WHERE clause of query
* $params['ids'] string|array IDs of Objects
*
* @param array|object $params An associative array of parameters
*
* @return array
* @since 2.0
*/
public function load_objects ( $params ) {
$params = (object) pods_sanitize( $params );
if ( !isset( $params->type ) || empty( $params->type ) )
return pods_error( __( 'Pods Object type is required', 'pods' ), $this );
$order = 'ASC';
$orderby = 'menu_order';
$limit = -1;
$ids = false;
$meta_query = array();
$cache_key = '';
if ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) {
foreach ( $params->options as $option => $value ) {
if ( !is_array( $value ) )
$value = array( $value );
$value = pods_trim( $value );
sort( $value );
$meta_query[] = array(
'key' => $option,
'value' => pods_sanitize( $value ),
'compare' => 'IN'
);
}
}
if ( isset( $params->where ) && is_array( $params->where ) )
$meta_query = array_merge( $meta_query, (array) $params->where );
if ( isset( $params->order ) && !empty( $params->order ) && in_array( strtoupper( $params->order ), array( 'ASC', 'DESC' ) ) )
$order = strtoupper( $params->order );
if ( isset( $params->orderby ) && !empty( $params->orderby ) )
$orderby = strtoupper( $params->orderby );
if ( isset( $params->limit ) && !empty( $params->limit ) )
$limit = pods_absint( $params->limit );
if ( isset( $params->ids ) && !empty( $params->ids ) ) {
$ids = $params->ids;
if ( !is_array( $ids ) )
$ids = explode( ',', $ids );
}
if ( empty( $ids ) )
$ids = false;
if ( pods_api_cache() && empty( $meta_query ) && empty( $limit ) && ( empty( $orderby ) || 'menu_order' == $orderby ) && empty( $ids ) ) {
$cache_key = 'pods_objects_' . $params->type;
$the_objects = pods_transient_get( $cache_key );
if ( false !== $the_objects )
return $the_objects;
}
$the_objects = array();
$objects = get_posts( array(
'post_type' => '_pods_' . $params->type,
'nopaging' => true,
'posts_per_page' => $limit,
'order' => $order,
'orderby' => $orderby,
'meta_query' => $meta_query,
'post__in' => $ids
) );
foreach ( $objects as $object ) {
$object = $this->load_object( $object );
$the_objects[ $object[ 'name' ] ] = $object;
}
if ( pods_api_cache() && !empty( $cache_key ) )
pods_transient_set( $cache_key, $the_objects );
return $the_objects;
}
/**
* @see PodsAPI::load_object
*
* Load a Pod Template
*
* $params['id'] int The template ID
* $params['name'] string The template name
*
* @param array $params An associative array of parameters
*
* @return array|bool
* @since 1.7.9
*/
public function load_template ( $params ) {
if ( !class_exists( 'Pods_Templates' ) )
return false;
$params = (object) $params;
$params->type = 'template';
return $this->load_object( $params );
}
/**
* @see PodsAPI::load_objects
*
* Load Multiple Pod Templates
*
* $params['where'] string The WHERE clause of query
* $params['options'] array Pod Option(s) key=>value array to filter by
* $params['orderby'] string ORDER BY clause of query
* $params['limit'] string Number of templates to return
*
* @param array $params (optional) An associative array of parameters
*
* @return array
*
* @since 2.0
*/
public function load_templates ( $params = null ) {
if ( !class_exists( 'Pods_Templates' ) )
return array();
$params = (object) $params;
$params->type = 'template';
return $this->load_objects( $params );
}
/**
* @see PodsAPI::load_object
*
* Load a Pod Page
*
* $params['id'] int The page ID
* $params['name'] string The page URI
*
* @param array $params An associative array of parameters
*
* @return array|bool
*
* @since 1.7.9
*/
public function load_page ( $params ) {
if ( !class_exists( 'Pods_Pages' ) )
return false;
$params = (object) $params;
if ( !isset( $params->name ) && isset( $params->uri ) ) {
$params->name = $params->uri;
unset( $params->uri );
}
$params->type = 'page';
return $this->load_object( $params );
}
/**
* @see PodsAPI::load_objects
*
* Load Multiple Pod Pages
*
* $params['where'] string The WHERE clause of query
* $params['options'] array Pod Option(s) key=>value array to filter by
* $params['orderby'] string ORDER BY clause of query
* $params['limit'] string Number of pages to return
*
* @param array $params (optional) An associative array of parameters
*
* @return array
*
* @since 2.0
*/
public function load_pages ( $params = null ) {
if ( !class_exists( 'Pods_Pages' ) )
return array();
$params = (object) $params;
$params->type = 'page';
return $this->load_objects( $params );
}
/**
* @see PodsAPI::load_object
*
* Load a Pod Helper
*
* $params['id'] int The helper ID
* $params['name'] string The helper name
*
* @param array $params An associative array of parameters
*
* @return array|bool
*
* @since 1.7.9
*/
public function load_helper ( $params ) {
if ( !class_exists( 'Pods_Helpers' ) )
return false;
$params = (object) $params;
$params->type = 'helper';
return $this->load_object( $params );
}
/**
* @see PodsAPI::load_objects
*
* Load Multiple Pod Helpers
*
* $params['where'] string The WHERE clause of query
* $params['options'] array Pod Option(s) key=>value array to filter by
* $params['orderby'] string ORDER BY clause of query
* $params['limit'] string Number of pages to return
*
* @param array $params (optional) An associative array of parameters
*
* @return array
*
* @since 2.0
*/
public function load_helpers ( $params = null ) {
if ( !class_exists( 'Pods_Helpers' ) )
return array();
$params = (object) $params;
$params->type = 'helper';
return $this->load_objects( $params );
}
/**
* Load the pod item object
*
* $params['pod'] string The datatype name
* $params['id'] int (optional) The item's ID
*
* @param array $params An associative array of parameters
*
* @return bool|\Pods
*
* @uses pods()
*
* @since 2.0
*/
public function load_pod_item ( $params ) {
$params = (object) pods_sanitize( $params );
if ( !isset( $params->pod ) || empty( $params->pod ) )
return pods_error( __( 'Pod name required', 'pods' ), $this );
if ( !isset( $params->id ) || empty( $params->id ) )
return pods_error( __( 'Item ID required', 'pods' ), $this );
$pod = false;
if ( pods_api_cache() )
$pod = pods_cache_get( $params->id, 'pods_item_object_' . $params->pod );
if ( false !== $pod )
return $pod;
$pod = pods( $params->pod, $params->id );
if ( pods_api_cache() )
pods_cache_set( $params->id, $pod, 'pods_item_object_' . $params->pod );
return $pod;
}
/**
* Load potential sister fields for a specific field
*
* $params['pod'] int The Pod name
* $params['related_pod'] string The related Pod name
*
* @param array $params An associative array of parameters
* @param array $pod (optional) Array of Pod data to use (to avoid lookup)
*
* @return array|bool
*
* @since 1.7.9
*
* @uses PodsAPI::load_pod
*/
public function load_sister_fields ( $params, $pod = null ) {
$params = (object) pods_sanitize( $params );
if ( empty( $pod ) ) {
$pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => false ), false );
if ( false === $pod )
return pods_error( __( 'Pod not found', 'pods' ), $this );
}
$params->pod_id = $pod[ 'id' ];
$params->pod = $pod[ 'name' ];
$type = false;
if ( 0 === strpos( $params->related_pod, 'pod-' ) ) {
$params->related_pod = pods_str_replace( 'pod-', '', $params->related_pod, 1 );
$type = 'pod';
}
elseif ( 0 === strpos( $params->related_pod, 'post_type-' ) ) {
$params->related_pod = pods_str_replace( 'post_type-', '', $params->related_pod, 1 );
$type = 'post_type';
}
elseif ( 0 === strpos( $params->related_pod, 'taxonomy-' ) ) {
$params->related_pod = pods_str_replace( 'taxonomy-', '', $params->related_pod, 1 );
$type = 'taxonomy';
}
$related_pod = $this->load_pod( array( 'name' => $params->related_pod, 'table_info' => false ), false );
if ( false === $related_pod || ( false !== $type && 'pod' != $type && $type != $related_pod[ 'type' ] ) )
return pods_error( __( 'Related Pod not found', 'pods' ), $this );
$params->related_pod_id = $related_pod[ 'id' ];
$params->related_pod = $related_pod[ 'name' ];
$sister_fields = array();
foreach ( $related_pod[ 'fields' ] as $field ) {
if ( 'pick' == $field[ 'type' ] && in_array( $field[ 'pick_object' ], array( $pod[ 'type' ], 'pod' ) ) && ( $params->pod == $field[ 'pick_object' ] || $params->pod == $field[ 'pick_val' ] ) )
$sister_fields[ $field[ 'id' ] ] = esc_html( $field[ 'label' ] . ' (' . $field[ 'name' ] . ')' );
}
return $sister_fields;
}
/**
* Takes a sql field such as tinyint and returns the pods field type, such as num.
*
* @param string $sql_field The SQL field to look for
*
* @return string The field type
*
* @since 2.0
*/
public static function detect_pod_field_from_sql_data_type ( $sql_field ) {
$sql_field = strtolower( $sql_field );
$field_to_field_map = array(
'tinyint' => 'number',
'smallint' => 'number',
'mediumint' => 'number',
'int' => 'number',
'bigint' => 'number',
'float' => 'number',
'double' => 'number',
'decimal' => 'number',
'date' => 'date',
'datetime' => 'datetime',
'timestamp' => 'datetime',
'time' => 'time',
'year' => 'date',
'varchar' => 'text',
'text' => 'paragraph',
'mediumtext' => 'paragraph',
'longtext' => 'paragraph'
);
return ( array_key_exists( $sql_field, $field_to_field_map ) ) ? $field_to_field_map[ $sql_field ] : 'paragraph';
}
/**
* Gets all field types
*
* @return array Array of field types
*
* @uses PodsForm::field_loader
*
* @since 2.0
* @deprecated
*/
public function get_field_types () {
return PodsForm::field_types();
}
/**
* Gets the schema definition of a field.
*
* @param string $type Field type to look for
* @param array $options (optional) Options of the field to pass to the schema function.
*
* @return array|bool|mixed|null
*
* @since 2.0
*/
private function get_field_definition ( $type, $options = null ) {
$definition = PodsForm::field_method( $type, 'schema', $options );
return $this->do_hook( 'field_definition', $definition, $type, $options );
}
/**
* @see PodsForm:validate
*
* Validates the value of a field.
*
* @param mixed $value The value to validate
* @param string $field Field to use for validation
* @param array $object_fields Fields of the object we're validating
* @param array $fields Array of all fields data
* @param array|Pods $pod Array of pod data (or Pods object)
* @param array|object $params Extra parameters to pass to the validation function of the field.
*
* @return array|bool
*
* @uses PodsForm::validate
*
* @since 2.0
*/
public function handle_field_validation ( &$value, $field, $object_fields, $fields, $pod, $params ) {
$tableless_field_types = PodsForm::tableless_field_types();
$fields = array_merge( $fields, $object_fields );
$options = $fields[ $field ];
$id = ( is_object( $params ) ? $params->id : ( is_object( $pod ) ? $pod->id() : 0 ) );
if ( is_object( $pod ) )
$pod = $pod->pod_data;
$type = $options[ 'type' ];
$label = $options[ 'label' ];
$label = empty( $label ) ? $field : $label;
// Verify required fields
if ( 1 == pods_var( 'required', $options[ 'options' ], 0 ) && 'slug' != $type ) {
if ( '' == $value || null === $value || array() === $value )
return pods_error( sprintf( __( '%s is empty', 'pods' ), $label ), $this );
if ( 'multi' == pods_var( 'pick_format_type', $options[ 'options' ] ) && 'autocomplete' != pods_var( 'pick_format_multi', $options[ 'options' ] ) ) {
$has_value = false;
$check_value = (array) $value;
foreach ( $check_value as $val ) {
if ( '' != $val && null !== $val && 0 !== $val && '0' !== $val ) {
$has_value = true;
continue;
}
}
if ( !$has_value )
return pods_error( sprintf( __( '%s is required', 'pods' ), $label ), $this );
}
}
// @todo move this to after pre-save preparations
// Verify unique fields
if ( 1 == pods_var( 'unique', $options[ 'options' ], 0 ) && '' !== $value && null !== $value && array() !== $value && 0 !== $value && '0' !== $value ) {
if ( empty( $pod ) )
return false;
if ( !in_array( $type, $tableless_field_types ) ) {
$exclude = '';
if ( !empty( $id ) )
$exclude = "AND `id` != {$id}";
$check = false;
$check_value = pods_sanitize( $value );
// @todo handle meta-based fields
// Trigger an error if not unique
if ( 'table' == $pod[ 'storage' ] )
$check = pods_query( "SELECT `id` FROM `@wp_pods_" . $pod[ 'name' ] . "` WHERE `{$field}` = '{$check_value}' {$exclude} LIMIT 1", $this );
if ( !empty( $check ) )
return pods_error( sprintf( __( '%s needs to be unique', 'pods' ), $label ), $this );
}
else {
// @todo handle tableless check
}
}
$validate = PodsForm::validate( $options[ 'type' ], $value, $field, array_merge( $options, pods_var( 'options', $options, array() ) ), $fields, $pod, $id, $params );
$validate = $this->do_hook( 'field_validation', $validate, $value, $field, $object_fields, $fields, $pod, $params );
return $validate;
}
/**
* Find items related to a parent field
*
* @param int $field_id The Field ID
* @param int $pod_id The Pod ID
* @param mixed $ids A comma-separated string (or array) of item IDs
* @param array $field Field data array
* @param array $pod Pod data array
*
* @return array
*
* @since 2.0
*
* @uses pods_query()
*/
public function lookup_related_items ( $field_id, $pod_id, $ids, $field = null, $pod = null ) {
$related_ids = array();
if ( !is_array( $ids ) )
$ids = explode( ',', $ids );
foreach ( $ids as $k => $id ) {
$ids[ $k ] = (int) $id;
}
$ids = array_unique( array_filter( $ids ) );
$tableless_field_types = PodsForm::tableless_field_types();
$field_type = pods_var( 'type', $field );
if ( empty( $ids ) || !in_array( $field_type, $tableless_field_types ) )
return array();
$related_pick_limit = 0;
if ( empty( $field ) ) {
$field = $this->load_field( array( 'id' => $field_id ) );
}
if ( !empty( $field ) ) {
$options = (array) pods_var_raw( 'options', $field, $field, null, true );
$related_pick_limit = (int) pods_var( pods_var( 'type', $field ) . '_limit', $options, 0 );
if ( 'single' == pods_var_raw( pods_var( 'type', $field ) . '_format_type', $options ) )
$related_pick_limit = 1;
// Temporary hack until there's some better handling here
$related_pick_limit = $related_pick_limit * count( $ids );
}
if ( 'taxonomy' == $field_type ) {
$related = wp_get_object_terms( $ids, pods_var( 'name', $field ), array( 'fields' => 'ids' ) );
if ( !is_wp_error( $related ) ) {
$related_ids = $related;
}
}
elseif ( !pods_tableless() ) {
$ids = implode( ', ', $ids );
$field_id = (int) $field_id;
$sister_id = (int) pods_var_raw( 'sister_id', $field, 0 );
$related_where = "
`field_id` = {$field_id}
AND `item_id` IN ( {$ids} )
";
$sql = "
SELECT *
FROM `@wp_podsrel`
WHERE
{$related_where}
ORDER BY `weight`
";
$relationships = pods_query( $sql );
if ( !empty( $relationships ) ) {
foreach ( $relationships as $relation ) {
if ( $field_id == $relation->field_id && !in_array( $relation->related_item_id, $related_ids ) )
$related_ids[] = (int) $relation->related_item_id;
elseif ( 0 < $sister_id && $field_id == $relation->related_field_id && !in_array( $relation->item_id, $related_ids ) )
$related_ids[] = (int) $relation->item_id;
}
}
}
else {
if ( !is_array( $pod ) )
$pod = $this->load_pod( array( 'id' => $pod_id, 'table_info' => false ), false );
if ( !empty( $pod ) && in_array( $pod[ 'type' ], array( 'post_type', 'media', 'user', 'comment', 'settings' ) ) ) {
$meta_type = $pod[ 'type' ];
if ( in_array( $pod[ 'type' ], array( 'post_type', 'media' ) ) )
$meta_type = 'post';
$no_conflict = pods_no_conflict_check( $meta_type );
if ( !$no_conflict )
pods_no_conflict_on( $meta_type );
foreach ( $ids as $id ) {
if ( 'settings' == $meta_type ) {
$related_id = get_option( '_pods_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
if ( empty( $related_id ) )
$related_id = get_option( $pod[ 'name' ] . '_' . $field[ 'name' ] );
if ( is_array( $related_id ) && !empty( $related_id ) ) {
foreach ( $related_id as $related ) {
if ( is_array( $related ) && !empty( $related ) ) {
if ( isset( $related[ 'id' ] ) )
$related_ids[] = (int) $related[ 'id' ];
else {
foreach ( $related as $r ) {
$related_ids[] = (int) $r;
}
}
}
else
$related_ids[] = (int) $related;
}
}
}
else {
$related_id = get_metadata( $meta_type, $id, '_pods_' . $field[ 'name' ], true );
if ( empty( $related_id ) )
$related_id = get_metadata( $meta_type, $id, $field[ 'name' ] );
if ( is_array( $related_id ) && !empty( $related_id ) ) {
foreach ( $related_id as $related ) {
if ( is_array( $related ) && !empty( $related ) ) {
if ( isset( $related[ 'id' ] ) )
$related_ids[] = (int) $related[ 'id' ];
else {
foreach ( $related as $r ) {
if ( isset( $related[ 'id' ] ) )
$related_ids[] = (int) $r[ 'id' ];
else
$related_ids[] = (int) $r;
}
}
}
else
$related_ids[] = (int) $related;
}
}
}
}
if ( !$no_conflict )
pods_no_conflict_off( $meta_type );
}
}
if ( is_array( $related_ids ) ) {
$related_ids = array_unique( array_filter( $related_ids ) );
if ( 0 < $related_pick_limit && !empty( $related_ids ) )
$related_ids = array_slice( $related_ids, 0, $related_pick_limit );
}
return $related_ids;
}
/**
* Find related items related to an item
*
* @param int $field_id The Field ID
* @param int $pod_id The Pod ID
* @param int $id Item ID to get related IDs from
* @param array $field Field data array
* @param array $pod Pod data array
*
* @return array|bool
*
* @since 2.3
*
* @uses pods_query()
*/
public function lookup_related_items_from ( $field_id, $pod_id, $id, $field = null, $pod = null ) {
$related_ids = false;
$id = (int) $id;
$tableless_field_types = PodsForm::tableless_field_types();
if ( empty( $id ) || !in_array( pods_var( 'type', $field ), $tableless_field_types ) )
return false;
$related_pick_limit = 0;
if ( !empty( $field ) ) {
$options = (array) pods_var_raw( 'options', $field, $field, null, true );
$related_pick_limit = (int) pods_var( 'pick_limit', $options, 0 );
if ( 'single' == pods_var_raw( 'pick_format_type', $options ) )
$related_pick_limit = 1;
}
if ( !pods_tableless() ) {
$field_id = (int) $field_id;
$sister_id = (int) pods_var_raw( 'sister_id', $field, 0 );
$related_where = "
`field_id` = {$field_id}
AND `related_item_id` = {$id}
";
$sql = "
SELECT *
FROM `@wp_podsrel`
WHERE
{$related_where}
ORDER BY `weight`
";
$relationships = pods_query( $sql );
if ( !empty( $relationships ) ) {
$related_ids = array();
foreach ( $relationships as $relation ) {
if ( $field_id == $relation->field_id && !in_array( $relation->item_id, $related_ids ) )
$related_ids[] = (int) $relation->item_id;
elseif ( 0 < $sister_id && $field_id == $relation->related_field_id && !in_array( $relation->related_item_id, $related_ids ) )
$related_ids[] = (int) $relation->related_item_id;
}
}
}
else {
// @todo handle meta-based lookups
return false;
if ( !is_array( $pod ) )
$pod = $this->load_pod( array( 'id' => $pod_id, 'table_info' => false ), false );
if ( !empty( $pod ) && in_array( $pod[ 'type' ], array( 'post_type', 'media', 'user', 'comment', 'settings' ) ) ) {
$related_ids = array();
$meta_type = $pod[ 'type' ];
if ( in_array( $pod[ 'type' ], array( 'post_type', 'media' ) ) )
$meta_type = 'post';
$no_conflict = pods_no_conflict_check( $meta_type );
if ( !$no_conflict )
pods_no_conflict_on( $meta_type );
if ( 'settings' == $meta_type ) {
$related_id = get_option( '_pods_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
if ( empty( $related_id ) )
$related_id = get_option( $pod[ 'name' ] . '_' . $field[ 'name' ] );
if ( is_array( $related_id ) && !empty( $related_id ) ) {
foreach ( $related_id as $related ) {
if ( is_array( $related ) && !empty( $related ) ) {
if ( isset( $related[ 'id' ] ) )
$related_ids[] = (int) $related[ 'id' ];
else {
foreach ( $related as $r ) {
$related_ids[] = (int) $r;
}
}
}
else
$related_ids[] = (int) $related;
}
}
}
else {
$related_id = get_metadata( $meta_type, $id, '_pods_' . $field[ 'name' ], true );
if ( empty( $related_id ) )
$related_id = get_metadata( $meta_type, $id, $field[ 'name' ] );
if ( is_array( $related_id ) && !empty( $related_id ) ) {
foreach ( $related_id as $related ) {
if ( is_array( $related ) && !empty( $related ) ) {
if ( isset( $related[ 'id' ] ) )
$related_ids[] = (int) $related[ 'id' ];
else {
foreach ( $related as $r ) {
if ( isset( $related[ 'id' ] ) )
$related_ids[] = (int) $r[ 'id' ];
else
$related_ids[] = (int) $r;
}
}
}
else
$related_ids[] = (int) $related;
}
}
}
if ( !$no_conflict )
pods_no_conflict_off( $meta_type );
}
}
if ( is_array( $related_ids ) )
$related_ids = array_unique( array_filter( $related_ids ) );
return $related_ids;
}
/**
* Get information about an objects MySQL table
*
* @param string $object_type
* @param string $object The object to look for
* @param null $name (optional) Name of the pod to load
* @param array $pod (optional) Array with pod information
* @param array $field (optional) Array with field information
*
* @return array|bool
*
* @since 2.0
*/
public function get_table_info ( $object_type, $object, $name = null, $pod = null, $field = null ) {
/**
* @var $wpdb wpdb
* @var $sitepress SitePress
* @var $icl_adjust_id_url_filter_off boolean
*/
global $wpdb, $sitepress, $icl_adjust_id_url_filter_off, $polylang;
// @todo Handle $object arrays for Post Types, Taxonomies, Comments (table pulled from first object in array)
$info = array(
//'select' => '`t`.*',
'object_type' => $object_type,
'type' => null,
'object_name' => $object,
'object_hierarchical' => false,
'table' => $object,
'meta_table' => $object,
'pod_table' => $wpdb->prefix . 'pods_' . ( empty( $object ) ? $name : $object ),
'field_id' => 'id',
'field_index' => 'name',
'field_slug' => null,
'field_type' => null,
'field_parent' => null,
'field_parent_select' => null,
'meta_field_id' => 'id',
'meta_field_index' => 'name',
'meta_field_value' => 'name',
'pod_field_id' => 'id',
'pod_field_index' => 'name',
'pod_field_slug' => null,
'pod_field_parent' => null,
'join' => array(),
'where' => null,
'where_default' => null,
'orderby' => null,
'pod' => null,
'recurse' => false
);
if ( empty( $object_type ) ) {
$object_type = 'post_type';
$object = 'post';
}
$pod_name = $pod;
if ( is_array( $pod_name ) )
$pod_name = pods_var_raw( 'name', $pod_name, ( version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $pod_name, JSON_UNESCAPED_UNICODE ) : json_encode( $pod_name ) ), null, true );
$field_name = $field;
if ( is_array( $field_name ) )
$field_name = pods_var_raw( 'name', $field_name, ( version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $pod_name, JSON_UNESCAPED_UNICODE ) : json_encode( $field_name ) ), null, true );
$transient = 'pods_get_table_info_' . md5( $object_type . '_object_' . $object . '_name_' . $name . '_pod_' . $pod_name . '_field_' . $field_name );
$current_language = false;
$current_language_t_id = $current_language_tt_id = 0;
// WPML support
if ( is_object( $sitepress ) && !$icl_adjust_id_url_filter_off )
$current_language = pods_sanitize( ICL_LANGUAGE_CODE );
// Polylang support
elseif ( is_object( $polylang ) && function_exists( 'pll_current_language' ) ) {
$current_language = pods_sanitize( pll_current_language( 'slug' ) );
if ( !empty( $current_language ) ) {
$current_language_t_id = (int) $polylang->get_language( $current_language )->term_id;
$current_language_tt_id = (int) $polylang->get_language( $current_language )->term_taxonomy_id;
}
}
if ( !empty( $current_language ) )
$transient = 'pods_get_table_info_' . $current_language . '_' . md5( $object_type . '_object_' . $object . '_name_' . $name . '_pod_' . $pod_name . '_field_' . $field_name );
$_info = false;
if ( pods_api_cache() )
$_info = pods_transient_get( $transient );
if ( pods_api_cache() && false === $_info && !did_action( 'init' ) )
$_info = pods_transient_get( $transient . '_pre_init' );
if ( false !== $_info )
$info = $_info;
else {
if ( 'pod' == $object_type && null === $pod ) {
if ( empty( $name ) ) {
$prefix = 'pod-';
// Make sure we actually have the prefix before trying anything with the name
if ( 0 === strpos( $object_type, $prefix ) )
$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
}
if ( empty( $name ) && !empty( $object ) )
$name = $object;
$pod = $this->load_pod( array( 'name' => $name, 'table_info' => false ), false );
if ( !empty( $pod ) ) {
$object_type = $pod[ 'type' ];
$name = $pod[ 'name' ];
$object = $pod[ 'object' ];
$info[ 'pod' ] = $pod;
}
}
elseif ( null === $pod ) {
if ( empty( $name ) ) {
$prefix = $object_type . '-';
// Make sure we actually have the prefix before trying anything with the name
if ( 0 === strpos( $object_type, $prefix ) )
$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
}
if ( empty( $name ) && !empty( $object ) )
$name = $object;
if ( !empty( $name ) ) {
$pod = $this->load_pod( array( 'name' => $name, 'table_info' => false ), false );
if ( !empty( $pod ) && ( null === $object_type || $object_type == $pod[ 'type' ] ) ) {
$object_type = $pod[ 'type' ];
$name = $pod[ 'name' ];
$object = $pod[ 'object' ];
$info[ 'pod' ] = $pod;
}
}
}
elseif ( !empty( $pod ) )
$info[ 'pod' ] = $pod;
if ( 0 === strpos( $object_type, 'pod' ) ) {
if ( empty( $name ) ) {
$prefix = 'pod-';
// Make sure we actually have the prefix before trying anything with the name
if ( 0 === strpos( $object_type, $prefix ) )
$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
}
$object_type = 'pod';
$info[ 'table' ] = $info[ 'meta_table' ] = $wpdb->prefix . 'pods_' . ( empty( $object ) ? $name : $object );
if ( is_array( $info[ 'pod' ] ) && 'pod' == pods_var( 'type', $info[ 'pod' ] ) ) {
$info[ 'pod_field_index' ] = $info[ 'field_index' ] = $info[ 'meta_field_index' ] = $info[ 'meta_field_value' ] = pods_var( 'pod_index', $info[ 'pod' ][ 'options' ], 'id', null, true );
$slug_field = get_posts( array(
'post_type' => '_pods_field',
'posts_per_page' => 1,
'nopaging' => true,
'post_parent' => $info[ 'pod' ][ 'id' ],
'orderby' => 'menu_order',
'order' => 'ASC',
'meta_query' => array(
array(
'key' => 'type',
'value' => 'slug',
)
)
) );
if ( !empty( $slug_field ) ) {
$slug_field = $slug_field[ 0 ];
$info[ 'field_slug' ] = $info[ 'pod_field_slug' ] = $slug_field->post_name;
}
if ( 1 == pods_var( 'hierarchical', $info[ 'pod' ][ 'options' ], 0 ) ) {
$parent_field = pods_var( 'pod_parent', $info[ 'pod' ][ 'options' ], 'id', null, true );
if ( !empty( $parent_field ) && isset( $info[ 'pod' ][ 'fields' ][ $parent_field ] ) ) {
$info[ 'object_hierarchical' ] = true;
$info[ 'pod_field_parent' ] = $info[ 'field_parent' ] = $parent_field . '_select';
$info[ 'field_parent_select' ] = '`' . $parent_field . '`.`id` AS `' . $info[ 'field_parent' ] . '`';
}
}
}
}
if ( 0 === strpos( $object_type, 'post_type' ) || 'media' == $object_type || in_array( pods_var_raw( 'type', $info[ 'pod' ] ), array( 'post_type', 'media' ) ) ) {
$info[ 'table' ] = $wpdb->posts;
$info[ 'meta_table' ] = $wpdb->postmeta;
$info[ 'field_id' ] = 'ID';
$info[ 'field_index' ] = 'post_title';
$info[ 'field_slug' ] = 'post_name';
$info[ 'field_type' ] = 'post_type';
$info[ 'field_parent' ] = 'post_parent';
$info[ 'field_parent_select' ] = '`t`.`' . $info[ 'field_parent' ] . '`';
$info[ 'meta_field_id' ] = 'post_id';
$info[ 'meta_field_index' ] = 'meta_key';
$info[ 'meta_field_value' ] = 'meta_value';
if ( 'media' == $object_type )
$object = 'attachment';
if ( empty( $name ) ) {
$prefix = 'post_type-';
// Make sure we actually have the prefix before trying anything with the name
if ( 0 === strpos( $object_type, $prefix ) )
$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
}
if ( 'media' != $object_type )
$object_type = 'post_type';
$post_type = pods_sanitize( ( empty( $object ) ? $name : $object ) );
if ( 'attachment' == $post_type || 'media' == $object_type )
$info[ 'pod_table' ] = $wpdb->prefix . 'pods_media';
else
$info[ 'pod_table' ] = $wpdb->prefix . 'pods_' . pods_clean_name( $post_type, true, false );
$post_type_object = get_post_type_object( $post_type );
if ( is_object( $post_type_object ) && $post_type_object->hierarchical )
$info[ 'object_hierarchical' ] = true;
$post_stati = $this->do_hook( 'get_table_info_default_post_status', array( 'publish' ), $post_type, $info, $object_type, $object, $name, $pod, $field );
$info[ 'where' ] = array(
//'post_status' => '`t`.`post_status` IN ( "inherit", "publish" )', // @todo Figure out what statuses Attachments can be
'post_type' => '`t`.`' . $info[ 'field_type' ] . '` = "' . $post_type . '"'
);
if ( 'post_type' == $object_type )
$info[ 'where_default' ] = '`t`.`post_status` IN ( "' . implode( '", "', $post_stati ) . '" )';
$info[ 'orderby' ] = '`t`.`menu_order`, `t`.`' . $info[ 'field_index' ] . '`, `t`.`post_date`';
// WPML support
if ( is_object( $sitepress ) && $sitepress->is_translated_post_type( $post_type ) && !$icl_adjust_id_url_filter_off ) {
$info[ 'join' ][ 'wpml_translations' ] = "
LEFT JOIN `{$wpdb->prefix}icl_translations` AS `wpml_translations`
ON `wpml_translations`.`element_id` = `t`.`ID`
AND `wpml_translations`.`element_type` = 'post_{$post_type}'
AND `wpml_translations`.`language_code` = '{$current_language}'
";
$info[ 'join' ][ 'wpml_languages' ] = "
LEFT JOIN `{$wpdb->prefix}icl_languages` AS `wpml_languages`
ON `wpml_languages`.`code` = `wpml_translations`.`language_code` AND `wpml_languages`.`active` = 1
";
$info[ 'where' ][ 'wpml_languages' ] = "`wpml_languages`.`code` IS NOT NULL";
}
// Polylang support
elseif( is_object( $polylang ) && !empty( $current_language ) && function_exists( 'pll_is_translated_post_type' ) && pll_is_translated_post_type( $post_type ) ) {
$info[ 'join' ][ 'polylang_languages' ] = "
LEFT JOIN `{$wpdb->term_relationships}` AS `polylang_languages`
ON `polylang_languages`.`object_id` = `t`.`ID`
AND `polylang_languages`.`term_taxonomy_id` = {$current_language_tt_id}
";
$info[ 'where' ][ 'polylang_languages' ] = "`polylang_languages`.`object_id` IS NOT NULL";
}
$info[ 'object_fields' ] = $this->get_wp_object_fields( $object_type, $info[ 'pod' ] );
}
elseif ( 0 === strpos( $object_type, 'taxonomy' ) || in_array( $object_type, array( 'nav_menu', 'post_format' ) ) || 'taxonomy' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
$info[ 'table' ] = $info[ 'meta_table' ] = $wpdb->terms;
$info[ 'join' ][ 'tt' ] = "LEFT JOIN `{$wpdb->term_taxonomy}` AS `tt` ON `tt`.`term_id` = `t`.`term_id`";
$info[ 'field_id' ] = $info[ 'meta_field_id' ] = 'term_id';
$info[ 'field_index' ] = $info[ 'meta_field_index' ] = $info[ 'meta_field_value' ] = 'name';
$info[ 'field_slug' ] = 'slug';
$info[ 'field_type' ] = 'taxonomy';
$info[ 'field_parent' ] = 'parent';
$info[ 'field_parent_select' ] = '`tt`.`' . $info[ 'field_parent' ] . '`';
if ( 'nav_menu' == $object_type )
$object = 'nav_menu';
elseif ( 'post_format' == $object_type )
$object = 'post_format';
if ( empty( $name ) ) {
$prefix = 'taxonomy-';
// Make sure we actually have the prefix before trying anything with the name
if ( 0 === strpos( $object_type, $prefix ) )
$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
}
if ( !in_array( $object_type, array( 'nav_menu', 'post_format' ) ) )
$object_type = 'taxonomy';
$taxonomy = pods_sanitize( ( empty( $object ) ? $name : $object ) );
$info[ 'pod_table' ] = $wpdb->prefix . 'pods_' . pods_clean_name( $taxonomy, true, false );
$taxonomy_object = get_taxonomy( $taxonomy );
if ( is_object( $taxonomy_object ) && $taxonomy_object->hierarchical )
$info[ 'object_hierarchical' ] = true;
$info[ 'where' ] = array(
'tt.taxonomy' => '`tt`.`' . $info[ 'field_type' ] . '` = "' . $taxonomy . '"'
);
// WPML Support
if ( is_object( $sitepress ) && $sitepress->is_translated_taxonomy( $taxonomy ) && !$icl_adjust_id_url_filter_off ) {
$info[ 'join' ][ 'wpml_translations' ] = "
LEFT JOIN `{$wpdb->prefix}icl_translations` AS `wpml_translations`
ON `wpml_translations`.`element_id` = `tt`.`term_taxonomy_id`
AND `wpml_translations`.`element_type` = 'tax_{$taxonomy}'
AND `wpml_translations`.`language_code` = '{$current_language}'
";
$info[ 'join' ][ 'wpml_languages' ] = "
LEFT JOIN `{$wpdb->prefix}icl_languages` AS `wpml_languages`
ON `wpml_languages`.`code` = `wpml_translations`.`language_code` AND `wpml_languages`.`active` = 1
";
$info[ 'where' ][ 'wpml_languages' ] = "`wpml_languages`.`code` IS NOT NULL";
}
// Polylang support
elseif ( is_object( $polylang ) && !empty( $current_language ) && function_exists( 'pll_is_translated_taxonomy' ) && pll_is_translated_taxonomy( $taxonomy ) ) {
$info[ 'join' ][ 'polylang_languages' ] = "
LEFT JOIN `{$wpdb->termmeta}` AS `polylang_languages`
ON `polylang_languages`.`term_id` = `t`.`term_id`
AND `polylang_languages`.`meta_value` = {$current_language_t_id}
";
$info[ 'where' ][ 'polylang_languages' ] = "`polylang_languages`.`term_id` IS NOT NULL";
}
$info[ 'object_fields' ] = $this->get_wp_object_fields( $object_type, $info[ 'pod' ] );
}
elseif ( 'user' == $object_type || 'user' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
$info[ 'table' ] = $wpdb->users;
$info[ 'meta_table' ] = $wpdb->usermeta;
$info[ 'pod_table' ] = $wpdb->prefix . 'pods_user';
$info[ 'field_id' ] = 'ID';
$info[ 'field_index' ] = 'display_name';
$info[ 'field_slug' ] = 'user_nicename';
$info[ 'meta_field_id' ] = 'user_id';
$info[ 'meta_field_index' ] = 'meta_key';
$info[ 'meta_field_value' ] = 'meta_value';
$info[ 'where' ] = array(
'user_status' => '`t`.`user_status` = 0'
);
$info[ 'object_fields' ] = $this->get_wp_object_fields( $object_type, $info[ 'pod' ] );
}
elseif ( 'comment' == $object_type || 'comment' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
//$info[ 'object_hierarchical' ] = true;
$info[ 'table' ] = $wpdb->comments;
$info[ 'meta_table' ] = $wpdb->commentmeta;
$info[ 'pod_table' ] = $wpdb->prefix . 'pods_comment';
$info[ 'field_id' ] = 'comment_ID';
$info[ 'field_index' ] = 'comment_date';
$info[ 'field_type' ] = 'comment_type';
$info[ 'field_parent' ] = 'comment_parent';
$info[ 'field_parent_select' ] = '`t`.`' . $info[ 'field_parent' ] . '`';
$info[ 'meta_field_id' ] = 'comment_id';
$info[ 'meta_field_index' ] = 'meta_key';
$info[ 'meta_field_value' ] = 'meta_value';
$object = 'comment';
$comment_type = ( empty( $object ) ? $name : $object );
$comment_type_clause = '`t`.`' . $info[ 'field_type' ] . '` = "' . $comment_type . '"';
if ( 'comment' == $comment_type ) {
$comment_type_clause = '( ' . $comment_type_clause . ' OR `t`.`' . $info[ 'field_type' ] . '` = "" )';
}
$info[ 'where' ] = array(
'comment_approved' => '`t`.`comment_approved` = 1',
'comment_type' => $comment_type_clause
);
$info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` DESC, `t`.`' . $info[ 'field_id' ] . '`';
}
elseif ( in_array( $object_type, array( 'option', 'settings' ) ) || 'settings' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
$info[ 'table' ] = $wpdb->options;
$info[ 'meta_table' ] = $wpdb->options;
$info[ 'field_id' ] = 'option_id';
$info[ 'field_index' ] = 'option_name';
$info[ 'meta_field_id' ] = 'option_id';
$info[ 'meta_field_index' ] = 'option_name';
$info[ 'meta_field_value' ] = 'option_value';
$info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC';
}
elseif ( is_multisite() && ( in_array( $object_type, array( 'site_option', 'site_settings' ) ) || 'site_settings' == pods_var_raw( 'type', $info[ 'pod' ] ) ) ) {
$info[ 'table' ] = $wpdb->sitemeta;
$info[ 'meta_table' ] = $wpdb->sitemeta;
$info[ 'field_id' ] = 'site_id';
$info[ 'field_index' ] = 'meta_key';
$info[ 'meta_field_id' ] = 'site_id';
$info[ 'meta_field_index' ] = 'meta_key';
$info[ 'meta_field_value' ] = 'meta_value';
$info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC';
}
elseif ( is_multisite() && 'network' == $object_type ) { // Network = Site
$info[ 'table' ] = $wpdb->site;
$info[ 'meta_table' ] = $wpdb->sitemeta;
$info[ 'field_id' ] = 'id';
$info[ 'field_index' ] = 'domain';
$info[ 'meta_field_id' ] = 'site_id';
$info[ 'meta_field_index' ] = 'meta_key';
$info[ 'meta_field_value' ] = 'meta_value';
$info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC, `t`.`path` ASC, `t`.`' . $info[ 'field_id' ] . '`';
}
elseif ( is_multisite() && 'site' == $object_type ) { // Site = Blog
$info[ 'table' ] = $wpdb->blogs;
$info[ 'field_id' ] = 'blog_id';
$info[ 'field_index' ] = 'domain';
$info[ 'field_type' ] = 'site_id';
$info[ 'where' ] = array(
'archived' => '`t`.`archived` = 0',
'spam' => '`t`.`spam` = 0',
'deleted' => '`t`.`deleted` = 0',
'site_id' => '`t`.`' . $info[ 'field_type' ] . '` = ' . (int) get_current_site()->id
);
$info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC, `t`.`path` ASC, `t`.`' . $info[ 'field_id' ] . '`';
}
elseif ( 'table' == $object_type || 'table' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
$info[ 'table' ] = ( empty( $object ) ? $name : $object );
$info[ 'pod_table' ] = $wpdb->prefix . 'pods_' . $info[ 'table' ];
if ( !empty( $field ) && is_array( $field ) ) {
$info[ 'table' ] = pods_var_raw( 'pick_table', pods_var_raw( 'options', $field, $field ) );
$info[ 'field_id' ] = pods_var_raw( 'pick_table_id', pods_var_raw( 'options', $field, $field ) );
$info[ 'field_index' ] = $info[ 'meta_field_index' ] = $info[ 'meta_field_value' ] = pods_var_raw( 'pick_table_index', pods_var_raw( 'options', $field, $field ) );
}
}
$info[ 'table' ] = pods_clean_name( $info[ 'table' ], false, false );
$info[ 'meta_table' ] = pods_clean_name( $info[ 'meta_table' ], false, false );
$info[ 'pod_table' ] = pods_clean_name( $info[ 'pod_table' ], false, false );
$info[ 'field_id' ] = pods_clean_name( $info[ 'field_id' ], false, false );
$info[ 'field_index' ] = pods_clean_name( $info[ 'field_index' ], false, false );
$info[ 'field_slug' ] = pods_clean_name( $info[ 'field_slug' ], false, false );
$info[ 'meta_field_id' ] = pods_clean_name( $info[ 'meta_field_id' ], false, false );
$info[ 'meta_field_index' ] = pods_clean_name( $info[ 'meta_field_index' ], false, false );
$info[ 'meta_field_value' ] = pods_clean_name( $info[ 'meta_field_value' ], false, false );
if ( empty( $info[ 'orderby' ] ) )
$info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '`, `t`.`' . $info[ 'field_id' ] . '`';
if ( 'table' == pods_var_raw( 'storage', $info[ 'pod' ] ) && !in_array( $object_type, array( 'pod', 'table' ) ) ) {
$info[ 'join' ][ 'd' ] = 'LEFT JOIN `' . $info[ 'pod_table' ] . '` AS `d` ON `d`.`id` = `t`.`' . $info[ 'field_id' ] . '`';
//$info[ 'select' ] .= ', `d`.*';
}
if ( !empty( $info[ 'pod' ] ) && is_array( $info[ 'pod' ] ) )
$info[ 'recurse' ] = true;
$info[ 'type' ] = $object_type;
$info[ 'object_name' ] = $object;
if ( pods_api_cache() ) {
if ( did_action( 'init' ) )
pods_transient_set( $transient, $info );
else
pods_transient_set( $transient . '_pre_init', $info );
}
}
$info = $this->do_hook( 'get_table_info', $info, $object_type, $object, $name, $pod, $field );
return $info;
}
/**
* Export a package
*
* $params['pod'] string Pod Type IDs to export
* $params['template'] string Template IDs to export
* $params['podpage'] string Pod Page IDs to export
* $params['helper'] string Helper IDs to export
*
* @param array $params An associative array of parameters
*
* @return array|bool
*
* @since 1.9.0
* @deprecated 2.0
*/
public function export_package ( $params ) {
if ( class_exists( 'Pods_Migrate_Packages' ) )
return Pods_Migrate_Packages::export( $params );
return false;
}
/**
* Replace an existing package
*
* @param mixed $data (optional) An associative array containing a package, or the json encoded package
*
* @return bool
*
* @since 1.9.8
* @deprecated 2.0
*/
public function replace_package ( $data = false ) {
return $this->import_package( $data, true );
}
/**
* Import a package
*
* @param mixed $data (optional) An associative array containing a package, or the json encoded package
* @param bool $replace (optional) Replace existing items when found
*
* @return bool
*
* @since 1.9.0
* @deprecated 2.0
*/
public function import_package ( $data = false, $replace = false ) {
if ( class_exists( 'Pods_Migrate_Packages' ) )
return Pods_Migrate_Packages::import( $data, $replace );
return false;
}
/**
* Validate a package
*
* @param array|string $data (optional) An associative array containing a package, or the json encoded package
* @param bool $output (optional)
*
* @return array|bool
*
* @since 1.9.0
* @deprecated 2.0
*/
public function validate_package ( $data = false, $output = false ) {
return true;
}
/**
* Import data from an array or a CSV file.
*
* @param mixed $import_data PHP associative array or CSV input
* @param bool $numeric_mode Use IDs instead of the name field when matching
* @param string $format Format of import data, options are php or csv
*
* @return array IDs of imported items
*
* @since 1.7.1
* @todo This needs some love and use of table_info etc for relationships
*/
public function import ( $import_data, $numeric_mode = false, $format = null ) {
/**
* @var $wpdb wpdb
*/
global $wpdb;
if ( null === $format && null !== $this->format )
$format = $this->format;
if ( 'csv' == $format && !is_array( $import_data ) ) {
$data = pods_migrate( 'sv', ',' )->parse( $import_data );
$import_data = $data[ 'items' ];
}
pods_query( "SET NAMES utf8" );
pods_query( "SET CHARACTER SET utf8" );
// Loop through the array of items
$ids = array();
// Test to see if it's an array of arrays
if ( !is_array( @current( $import_data ) ) )
$import_data = array( $import_data );
$pod = $this->load_pod( array( 'name' => $this->pod ) );
if ( false === $pod )
return pods_error( __( 'Pod not found', 'pods' ), $this );
$fields = array_merge( $pod[ 'fields' ], $pod[ 'object_fields' ] );
$simple_tableless_objects = PodsForm::field_method( 'pick', 'simple_objects' );
foreach ( $import_data as $key => $data_row ) {
$data = array();
// Loop through each field (use $fields so only valid fields get parsed)
foreach ( $fields as $field_name => $field_data ) {
if ( !isset( $data_row[ $field_name ] ) && !isset( $data_row[ $field_data[ 'label' ] ] ) )
continue;
$field_id = $field_data[ 'id' ];
$type = $field_data[ 'type' ];
$pick_object = isset( $field_data[ 'pick_object' ] ) ? $field_data[ 'pick_object' ] : '';
$pick_val = isset( $field_data[ 'pick_val' ] ) ? $field_data[ 'pick_val' ] : '';
if ( isset( $data_row[ $field_name] ) )
$field_value = $data_row[ $field_name ];
else
$field_value = $data_row[ $field_data[ 'label' ] ];
if ( null !== $field_value && false !== $field_value && '' !== $field_value ) {
if ( 'pick' == $type || in_array( $type, PodsForm::file_field_types() ) ) {
$field_values = is_array( $field_value ) ? $field_value : array( $field_value );
$pick_values = array();
foreach ( $field_values as $pick_value ) {
if ( in_array( $type, PodsForm::file_field_types() ) || 'media' == $pick_object ) {
$where = "`guid` = '" . pods_sanitize( $pick_value ) . "'";
if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
$where = "`ID` = " . pods_absint( $pick_value );
$result = pods_query( "SELECT `ID` AS `id` FROM `{$wpdb->posts}` WHERE `post_type` = 'attachment' AND {$where} ORDER BY `ID`", $this );
if ( !empty( $result ) )
$pick_values[] = $result[ 0 ]->id;
}
// @todo This could and should be abstracted better and simplified
elseif ( 'pick' == $type ) {
$related_pod = false;
if ( 'pod' == $pick_object )
$related_pod = $this->load_pod( array( 'name' => $pick_val, 'table_info' => true ), false );
if ( empty( $related_pod ) ) {
$related_pod = array(
'id' => 0,
'type' => $pick_object
);
}
if ( in_array( 'taxonomy', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
$where = "`t`.`name` = '" . pods_sanitize( $pick_value ) . "'";
if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
$where = "`tt`.`term_id` = " . pods_absint( $pick_value );
$result = pods_query( "SELECT `t`.`term_id` AS `id` FROM `{$wpdb->term_taxonomy}` AS `tt` LEFT JOIN `{$wpdb->terms}` AS `t` ON `t`.`term_id` = `tt`.`term_id` WHERE `taxonomy` = '{$pick_val}' AND {$where} ORDER BY `t`.`term_id`", $this );
if ( !empty( $result ) )
$pick_values[] = $result[ 0 ]->id;
}
elseif ( in_array( 'post_type', array( $pick_object, $related_pod[ 'type' ] ) ) || in_array( 'media', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
$where = "`post_title` = '" . pods_sanitize( $pick_value ) . "'";
if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
$where = "`ID` = " . pods_absint( $pick_value );
$result = pods_query( "SELECT `ID` AS `id` FROM `{$wpdb->posts}` WHERE `post_type` = '{$pick_val}' AND {$where} ORDER BY `ID`", $this );
if ( !empty( $result ) )
$pick_values[] = $result[ 0 ]->id;
}
elseif ( in_array( 'user', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
$where = "`user_login` = '" . pods_sanitize( $pick_value ) . "'";
if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
$where = "`ID` = " . pods_absint( $pick_value );
$result = pods_query( "SELECT `ID` AS `id` FROM `{$wpdb->users}` WHERE {$where} ORDER BY `ID`", $this );
if ( !empty( $result ) )
$pick_values[] = $result[ 0 ]->id;
}
elseif ( in_array( 'comment', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
$where = "`comment_ID` = " . pods_absint( $pick_value );
$result = pods_query( "SELECT `comment_ID` AS `id` FROM `{$wpdb->comments}` WHERE {$where} ORDER BY `ID`", $this );
if ( !empty( $result ) )
$pick_values[] = $result[ 0 ]->id;
}
elseif ( in_array( $pick_object, $simple_tableless_objects ) )
$pick_values[] = $pick_value;
elseif ( !empty( $related_pod[ 'id' ] ) ) {
$where = "`" . $related_pod[ 'field_index' ] . "` = '" . pods_sanitize( $pick_value ) . "'";
if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
$where = "`" . $related_pod[ 'field_id' ] . "` = " . pods_absint( $pick_value );
$result = pods_query( "SELECT `" . $related_pod[ 'field_id' ] . "` AS `id` FROM `" . $related_pod[ 'table' ] . "` WHERE {$where} ORDER BY `" . $related_pod[ 'field_id' ] . "`", $this );
if ( !empty( $result ) )
$pick_values[] = $result[ 0 ]->id;
}
}
}
$field_value = implode( ',', $pick_values );
}
$data[ $field_name ] = $field_value;
}
}
if ( !empty( $data ) ) {
$params = array(
'pod' => $this->pod,
'data' => $data
);
$ids[] = $this->save_pod_item( $params );
}
}
return $ids;
}
/**
* Export data from a Pod
*
* @param string|object $pod The pod name or Pods object
* @param array $params An associative array of parameters
*
* @return array Data arrays of all exported pod items
* @since 1.7.1
*/
public function export ( $pod = null, $params = null ) {
if ( empty( $pod ) ) {
$pod = $this->pod;
}
$find = array(
'limit' => -1,
'search' => false,
'pagination' => false
);
if ( !empty( $params ) && isset( $params[ 'params' ] ) ) {
$find = array_merge( $find, (array) $params[ 'params' ] );
unset( $params[ 'params' ] );
$pod = pods( $pod, $find );
}
elseif ( !is_object( $pod ) ) {
$pod = pods( $pod, $find );
}
$data = array();
while ( $pod->fetch() ) {
$data[ $pod->id() ] = $this->export_pod_item( $params, $pod );
}
$data = $this->do_hook( 'export', $data, $pod->pod, $pod );
return $data;
}
/**
* Convert CSV to a PHP array
*
* @param string $data The CSV input
*
* @return array
* @since 1.7.1
*
* @deprecated 2.3.5
*/
public function csv_to_php ( $data, $delimiter = ',' ) {
pods_deprecated( "PodsAPI->csv_to_php", '2.3.5' );
$data = pods_migrate( 'sv', $delimiter, $data )->parse();
return $data[ 'items' ];
}
/**
* Clear Pod-related cache
*
* @param array $pod
*
* @return void
*
* @since 2.0
*/
public function cache_flush_pods ( $pod = null ) {
/**
* @var $wpdb wpdb
*/
global $wpdb;
pods_transient_clear( 'pods' );
pods_transient_clear( 'pods_components' );
if ( null !== $pod && is_array( $pod ) ) {
pods_transient_clear( 'pods_pod_' . $pod[ 'name' ] );
pods_cache_clear( $pod[ 'name' ], 'pods-class' );
foreach ( $pod[ 'fields' ] as $field ) {
pods_transient_clear( 'pods_field_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
}
if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) )
pods_transient_clear( 'pods_wp_cpt_ct' );
}
else
pods_transient_clear( 'pods_wp_cpt_ct' );
$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_pods%'" );
$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_timeout_pods%'" );
pods_cache_clear( true );
pods_transient_set( 'pods_flush_rewrites', 1 );
}
/**
* Process a Pod-based form
*
* @param mixed $params
* @param object $obj Pod object
* @param array $fields Fields being submitted in form ( key => settings )
* @param string $thank_you URL to send to upon success
*
* @return mixed
*
* @since 2.0
*/
public function process_form ( $params, $obj = null, $fields = null, $thank_you = null ) {
$this->display_errors = false;
$form = null;
$nonce = pods_var( '_pods_nonce', $params );
$pod = pods_var( '_pods_pod', $params );
$id = pods_var( '_pods_id', $params );
$uri = pods_var( '_pods_uri', $params );
$form = pods_var( '_pods_form', $params );
if ( is_object( $obj ) ) {
$pod = $obj->pod;
$id = $obj->id();
}
if ( !empty( $fields ) ) {
$fields = array_keys( $fields );
$form = implode( ',', $fields );
}
else
$fields = explode( ',', $form );
if ( empty( $nonce ) || empty( $pod ) || empty( $uri ) || empty( $fields ) )
return pods_error( __( 'Invalid submission', 'pods' ), $this );
$uid = @session_id();
if ( is_user_logged_in() )
$uid = 'user_' . get_current_user_id();
$action = 'pods_form_' . $pod . '_' . $uid . '_' . $id . '_' . $uri . '_' . wp_hash( $form );
if ( empty( $uid ) )
return pods_error( __( 'Access denied for your session, please refresh and try again.', 'pods' ), $this );
if ( wp_verify_nonce( $nonce, $action ) )
return pods_error( __( 'Access denied, please refresh and try again.', 'pods' ), $this );
$data = array();
foreach ( $fields as $field ) {
$data[ $field ] = pods_var_raw( 'pods_field_' . $field, $params, '' );
}
$params = array(
'pod' => $pod,
'id' => $id,
'data' => $data,
'from' => 'process_form'
);
$id = $this->save_pod_item( $params );
if ( 0 < $id && !empty( $thank_you ) ) {
$thank_you = str_replace( 'X_ID_X', $id, $thank_you );
pods_redirect( $thank_you );
}
return $id;
}
/**
* Handle filters / actions for the class
*
* @since 2.0
*/
private function do_hook () {
$args = func_get_args();
if ( empty( $args ) )
return false;
$name = array_shift( $args );
return pods_do_hook( "api", $name, $args, $this );
}
/**
* Handle variables that have been deprecated
*
* @since 2.0
*/
public function __get ( $name ) {
$name = (string) $name;
if ( !isset( $this->deprecated ) ) {
require_once( PODS_DIR . 'deprecated/classes/PodsAPI.php' );
$this->deprecated = new PodsAPI_Deprecated( $this );
}
$var = null;
if ( isset( $this->deprecated->{$name} ) ) {
pods_deprecated( "PodsAPI->{$name}", '2.0' );
$var = $this->deprecated->{$name};
}
else
pods_deprecated( "PodsAPI->{$name}", '2.0' );
return $var;
}
/**
* Handle methods that have been deprecated
*
* @since 2.0
*/
public function __call ( $name, $args ) {
$name = (string) $name;
if ( !isset( $this->deprecated ) ) {
require_once( PODS_DIR . 'deprecated/classes/PodsAPI.php' );
$this->deprecated = new PodsAPI_Deprecated( $this );
}
if ( method_exists( $this->deprecated, $name ) )
return call_user_func_array( array( $this->deprecated, $name ), $args );
else
pods_deprecated( "PodsAPI::{$name}", '2.0' );
}
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment