/**
* Add a meta group of fields to add/edit forms
*
* @see PodsMeta::group_add
*
* @param string|array $pod The pod or type of element to attach the group to.
* @param string $label Title of the edit screen section, visible to user.
* @param string|array $fields Either a comma separated list of text fields or an associative array containing field information.
* @param string $context (optional) The part of the page where the edit screen section should be shown ('normal', 'advanced', or 'side').
* @param string $priority (optional) The priority within the context where the boxes should show ('high', 'core', 'default' or 'low').
* @param string $type (optional) Type of the post to attach to.
*
* @return void
*
* @since 2.0
* @link http://pods.io/docs/pods-group-add/
*/
function pods_group_add($pod, $label, $fields, $context = 'normal', $priority = 'default', $type = null)
{
if (!is_array($pod) && null !== $type) {
$pod = array('name' => $pod, 'type' => $type);
}
pods_meta()->group_add($pod, $label, $fields, $context, $priority);
}
/**
* Load Pods Meta
*/
public function load_meta()
{
self::$meta = pods_meta()->core();
}
/**
* Setup related objects
*
* @param boolean $force Whether to force refresh of related objects
* @return bool True when data has been loaded
* @since 2.3
*/
public function setup_related_objects($force = false)
{
$new_data_loaded = false;
if (!$force && empty(self::$related_objects)) {
// Only load transient if we aren't forcing a refresh
self::$related_objects = pods_transient_get('pods_related_objects');
if (false !== self::$related_objects) {
$new_data_loaded = true;
}
} elseif ($force) {
// If we are rebuilding, make sure we start with a clean slate
self::$related_objects = array();
}
if (empty(self::$related_objects)) {
// Do a complete build of related_objects
$new_data_loaded = true;
// Custom
self::$related_objects['custom-simple'] = array('label' => __('Simple (custom defined list)', 'pods'), 'group' => __('Custom', 'pods'), 'simple' => true);
// Pods
$pod_options = array();
// Include PodsMeta if not already included
pods_meta();
// Advanced Content Types
$_pods = PodsMeta::$advanced_content_types;
foreach ($_pods as $pod) {
$pod_options[$pod['name']] = $pod['label'] . ' (' . $pod['name'] . ')';
}
// Settings
$_pods = PodsMeta::$settings;
foreach ($_pods as $pod) {
$pod_options[$pod['name']] = $pod['label'] . ' (' . $pod['name'] . ')';
}
asort($pod_options);
foreach ($pod_options as $pod => $label) {
self::$related_objects['pod-' . $pod] = array('label' => $label, 'group' => __('Pods', 'pods'), 'bidirectional' => true);
}
// Post Types
$post_types = get_post_types();
asort($post_types);
$ignore = array('attachment', 'revision', 'nav_menu_item');
foreach ($post_types as $post_type => $label) {
if (in_array($post_type, $ignore) || empty($post_type)) {
unset($post_types[$post_type]);
continue;
} elseif (0 === strpos($post_type, '_pods_') && apply_filters('pods_pick_ignore_internal', true)) {
unset($post_types[$post_type]);
continue;
}
$post_type = get_post_type_object($post_type);
self::$related_objects['post_type-' . $post_type->name] = array('label' => $post_type->label . ' (' . $post_type->name . ')', 'group' => __('Post Types', 'pods'), 'bidirectional' => true);
}
// Taxonomies
$taxonomies = get_taxonomies();
asort($taxonomies);
$ignore = array('nav_menu', 'post_format');
foreach ($taxonomies as $taxonomy => $label) {
if (in_array($taxonomy, $ignore) || empty($taxonomy)) {
unset($taxonomies[$taxonomy]);
continue;
} elseif (0 === strpos($taxonomy, '_pods_') && apply_filters('pods_pick_ignore_internal', true)) {
unset($taxonomies[$taxonomy]);
continue;
}
$taxonomy = get_taxonomy($taxonomy);
self::$related_objects['taxonomy-' . $taxonomy->name] = array('label' => $taxonomy->label . ' (' . $taxonomy->name . ')', 'group' => __('Taxonomies', 'pods'), 'bidirectional' => true);
}
// Other WP Objects
self::$related_objects['user'] = array('label' => __('Users', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'bidirectional' => true);
self::$related_objects['role'] = array('label' => __('User Roles', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_roles'));
self::$related_objects['capability'] = array('label' => __('User Capabilities', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_capabilities'));
self::$related_objects['media'] = array('label' => __('Media', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'bidirectional' => true);
self::$related_objects['comment'] = array('label' => __('Comments', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'bidirectional' => true);
self::$related_objects['image-size'] = array('label' => __('Image Sizes', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_image_sizes'));
self::$related_objects['nav_menu'] = array('label' => __('Navigation Menus', 'pods'), 'group' => __('Other WP Objects', 'pods'));
self::$related_objects['post_format'] = array('label' => __('Post Formats', 'pods'), 'group' => __('Other WP Objects', 'pods'));
self::$related_objects['post-status'] = array('label' => __('Post Status', 'pods'), 'group' => __('Other WP Objects', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_post_stati'));
do_action('pods_form_ui_field_pick_related_objects_other');
self::$related_objects['country'] = array('label' => __('Countries', 'pods'), 'group' => __('Predefined Lists', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_countries'));
self::$related_objects['us_state'] = array('label' => __('US States', 'pods'), 'group' => __('Predefined Lists', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_us_states'));
self::$related_objects['days_of_week'] = array('label' => __('Calendar - Days of Week', 'pods'), 'group' => __('Predefined Lists', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_days_of_week'));
self::$related_objects['months_of_year'] = array('label' => __('Calendar - Months of Year', 'pods'), 'group' => __('Predefined Lists', 'pods'), 'simple' => true, 'data_callback' => array($this, 'data_months_of_year'));
do_action('pods_form_ui_field_pick_related_objects_predefined');
if (did_action('init')) {
pods_transient_set('pods_related_objects', self::$related_objects);
}
}
foreach (self::$custom_related_objects as $object => $related_object) {
if (!isset(self::$related_objects[$object])) {
$new_data_loaded = true;
self::$related_objects[$object] = $related_object;
}
}
return $new_data_loaded;
}
/**
* Take over the avatar served from WordPress
*
* @param string $avatar Default Avatar Image output from WordPress
* @param int|string|object $id_or_email A user ID, email address, or comment object
* @param int $size Size of the avatar image
* @param string $default URL to a default image to use if no avatar is available
* @param string $alt Alternate text to use in image tag. Defaults to blank
* @return string <img> tag for the user's avatar
*/
public function get_avatar($avatar, $id_or_email, $size, $default = '', $alt = '')
{
// Don't replace for the Avatars section of the Discussion settings page
if (is_admin()) {
$current_screen = get_current_screen();
if (!is_null($current_screen) && 'options-discussion' == $current_screen->id && 32 == $size) {
return $avatar;
}
}
$_user_ID = 0;
if (is_numeric($id_or_email) && 0 < $id_or_email) {
$_user_ID = (int) $id_or_email;
} elseif (is_object($id_or_email) && isset($id_or_email->user_id) && 0 < $id_or_email->user_id) {
$_user_ID = (int) $id_or_email->user_id;
} elseif (is_object($id_or_email) && isset($id_or_email->ID) && isset($id_or_email->user_login) && 0 < $id_or_email->ID) {
$_user_ID = (int) $id_or_email->ID;
} elseif (!is_object($id_or_email) && false !== strpos($id_or_email, '@')) {
$_user = get_user_by('email', $id_or_email);
if (!empty($_user)) {
$_user_ID = (int) $_user->ID;
}
}
// Include PodsMeta if not already included
pods_meta();
if (0 < $_user_ID && !empty(PodsMeta::$user)) {
$avatar_cached = pods_cache_get($_user_ID . '-' . $size, 'pods_avatars');
if (!empty($avatar_cached)) {
$avatar = $avatar_cached;
} else {
$avatar_field = pods_transient_get('pods_avatar_field');
$user = current(PodsMeta::$user);
if (empty($avatar_field)) {
foreach ($user['fields'] as $field) {
if ('avatar' == $field['type']) {
$avatar_field = $field['name'];
pods_transient_set('pods_avatar_field', $avatar_field);
break;
}
}
} elseif (!isset($user['fields'][$avatar_field])) {
$avatar_field = false;
}
if (!empty($avatar_field)) {
$user_avatar = get_user_meta($_user_ID, $avatar_field . '.ID', true);
if (!empty($user_avatar)) {
$attributes = array('alt' => '', 'class' => 'avatar avatar-' . $size . ' photo');
if (!empty($alt)) {
$attributes['alt'] = $alt;
}
$user_avatar = pods_image($user_avatar, array($size, $size), 0, $attributes);
if (!empty($user_avatar)) {
$avatar = $user_avatar;
pods_cache_set($_user_ID . '-' . $size, $avatar, 'pods_avatars');
}
}
}
}
}
return $avatar;
}
