You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
329 lines
9.4 KiB
329 lines
9.4 KiB
<?php
|
|
/**
|
|
* Plugin public functions.
|
|
*/
|
|
|
|
if ( ! function_exists( 'rwmb_meta' ) ) {
|
|
/**
|
|
* Get post meta.
|
|
*
|
|
* @param string $key Meta key. Required.
|
|
* @param array $args Array of arguments. Optional.
|
|
* @param int|null $post_id Post ID. null for current post. Optional.
|
|
*
|
|
* @return mixed
|
|
*/
|
|
function rwmb_meta( $key, $args = [], $post_id = null ) {
|
|
$args = wp_parse_args( $args );
|
|
$field = rwmb_get_field_settings( $key, $args, $post_id );
|
|
|
|
/*
|
|
* If field is not found, which can caused by registering meta boxes for the backend only or conditional registration.
|
|
* Then fallback to the old method to retrieve meta (which uses get_post_meta() as the latest fallback).
|
|
*/
|
|
if ( false === $field ) {
|
|
return apply_filters( 'rwmb_meta', rwmb_meta_legacy( $key, $args, $post_id ) );
|
|
}
|
|
$meta = in_array( $field['type'], [ 'oembed', 'map', 'osm' ], true ) ?
|
|
rwmb_the_value( $key, $args, $post_id, false ) :
|
|
rwmb_get_value( $key, $args, $post_id );
|
|
return apply_filters( 'rwmb_meta', $meta, $key, $args, $post_id );
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_set_meta' ) ) {
|
|
/**
|
|
* Set meta value.
|
|
*
|
|
* @param int $object_id Object ID. Required.
|
|
* @param string $key Meta key. Required.
|
|
* @param mixed $value Meta value. Required.
|
|
* @param array $args Array of arguments. Optional.
|
|
*/
|
|
function rwmb_set_meta( $object_id, $key, $value, $args = [] ) {
|
|
$args = wp_parse_args( $args );
|
|
$field = rwmb_get_field_settings( $key, $args, $object_id );
|
|
|
|
if ( false === $field ) {
|
|
return;
|
|
}
|
|
|
|
$old = RWMB_Field::call( $field, 'raw_meta', $object_id );
|
|
$new = RWMB_Field::process_value( $value, $object_id, $field );
|
|
|
|
RWMB_Field::call( $field, 'save', $new, $old, $object_id );
|
|
|
|
// For MB Custom Table to flush data from the cache to the database.
|
|
do_action( 'rwmb_flush_data', $object_id, $field, $args );
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_get_field_settings' ) ) {
|
|
/**
|
|
* Get field settings.
|
|
*
|
|
* @param string $key Meta key. Required.
|
|
* @param array $args Array of arguments. Optional.
|
|
* @param int|null $object_id Object ID. null for current post. Optional.
|
|
*
|
|
* @return array
|
|
*/
|
|
function rwmb_get_field_settings( $key, $args = [], $object_id = null ) {
|
|
$args = wp_parse_args( $args, [
|
|
'object_type' => 'post',
|
|
'type' => '',
|
|
] );
|
|
|
|
/**
|
|
* Filter meta type from object type and object id.
|
|
*
|
|
* @var string Meta type, default is post type name.
|
|
* @var string Object type.
|
|
* @var string|int Object id.
|
|
*/
|
|
$type = apply_filters( 'rwmb_meta_type', $args['type'], $args['object_type'], $object_id );
|
|
if ( ! $type ) {
|
|
$type = get_post_type( $object_id );
|
|
}
|
|
|
|
return rwmb_get_registry( 'field' )->get( $key, $type, $args['object_type'] );
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_meta_legacy' ) ) {
|
|
/**
|
|
* Get post meta.
|
|
*
|
|
* @param string $key Meta key. Required.
|
|
* @param array $args Array of arguments. Optional.
|
|
* @param int|null $post_id Post ID. null for current post. Optional.
|
|
*
|
|
* @return mixed
|
|
*/
|
|
function rwmb_meta_legacy( $key, $args = [], $post_id = null ) {
|
|
$args = wp_parse_args( $args, [
|
|
'type' => 'text',
|
|
'multiple' => false,
|
|
'clone' => false,
|
|
] );
|
|
$field = [
|
|
'id' => $key,
|
|
'type' => $args['type'],
|
|
'clone' => $args['clone'],
|
|
'multiple' => $args['multiple'],
|
|
];
|
|
|
|
$method = 'get_value';
|
|
switch ( $args['type'] ) {
|
|
case 'taxonomy':
|
|
case 'taxonomy_advanced':
|
|
$field['taxonomy'] = $args['taxonomy'];
|
|
break;
|
|
case 'map':
|
|
case 'osm':
|
|
case 'oembed':
|
|
$method = 'the_value';
|
|
break;
|
|
}
|
|
$field = RWMB_Field::call( 'normalize', $field );
|
|
|
|
return RWMB_Field::call( $method, $field, $args, $post_id );
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_get_value' ) ) {
|
|
/**
|
|
* Get value of custom field.
|
|
* This is used to replace old version of rwmb_meta key.
|
|
*
|
|
* @param string $field_id Field ID. Required.
|
|
* @param array $args Additional arguments. Rarely used. See specific fields for details.
|
|
* @param int|null $post_id Post ID. null for current post. Optional.
|
|
*
|
|
* @return mixed false if field doesn't exist. Field value otherwise.
|
|
*/
|
|
function rwmb_get_value( $field_id, $args = [], $post_id = null ) {
|
|
$args = wp_parse_args( $args );
|
|
$field = rwmb_get_field_settings( $field_id, $args, $post_id );
|
|
|
|
// Get field value.
|
|
$value = $field ? RWMB_Field::call( 'get_value', $field, $args, $post_id ) : false;
|
|
|
|
/*
|
|
* Allow developers to change the returned value of field.
|
|
* For version < 4.8.2, the filter name was 'rwmb_get_field'.
|
|
*
|
|
* @param mixed $value Field value.
|
|
* @param array $field Field parameters.
|
|
* @param array $args Additional arguments. Rarely used. See specific fields for details.
|
|
* @param int|null $post_id Post ID. null for current post. Optional.
|
|
*/
|
|
$value = apply_filters( 'rwmb_get_value', $value, $field, $args, $post_id );
|
|
|
|
return $value;
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_the_value' ) ) {
|
|
/**
|
|
* Display the value of a field
|
|
*
|
|
* @param string $field_id Field ID. Required.
|
|
* @param array $args Additional arguments. Rarely used. See specific fields for details.
|
|
* @param int|null $post_id Post ID. null for current post. Optional.
|
|
* @param bool $echo Display field meta value? Default `true` which works in almost all cases. We use `false` for the [rwmb_meta] shortcode.
|
|
*
|
|
* @return string
|
|
*/
|
|
function rwmb_the_value( $field_id, $args = [], $post_id = null, $echo = true ) {
|
|
$args = wp_parse_args( $args );
|
|
$field = rwmb_get_field_settings( $field_id, $args, $post_id );
|
|
|
|
if ( ! $field ) {
|
|
return '';
|
|
}
|
|
|
|
$output = RWMB_Field::call( 'the_value', $field, $args, $post_id );
|
|
|
|
/*
|
|
* Allow developers to change the returned value of field.
|
|
* For version < 4.8.2, the filter name was 'rwmb_get_field'.
|
|
*
|
|
* @param mixed $value Field HTML output.
|
|
* @param array $field Field parameters.
|
|
* @param array $args Additional arguments. Rarely used. See specific fields for details.
|
|
* @param int|null $post_id Post ID. null for current post. Optional.
|
|
*/
|
|
$output = apply_filters( 'rwmb_the_value', $output, $field, $args, $post_id );
|
|
|
|
if ( $echo ) {
|
|
echo $output; // phpcs:ignore WordPress.Security.EscapeOutput
|
|
}
|
|
|
|
return $output;
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_get_object_fields' ) ) {
|
|
/**
|
|
* Get defined meta fields for object.
|
|
*
|
|
* @param int|string $type_or_id Object ID or post type / taxonomy (for terms) / user (for users).
|
|
* @param string $object_type Object type. Use post, term.
|
|
*
|
|
* @return array
|
|
*/
|
|
function rwmb_get_object_fields( $type_or_id, $object_type = 'post' ) {
|
|
$meta_boxes = rwmb_get_registry( 'meta_box' )->get_by( [ 'object_type' => $object_type ] );
|
|
array_walk( $meta_boxes, 'rwmb_check_meta_box_supports', [ $object_type, $type_or_id ] );
|
|
$meta_boxes = array_filter( $meta_boxes );
|
|
|
|
$fields = [];
|
|
foreach ( $meta_boxes as $meta_box ) {
|
|
foreach ( $meta_box->fields as $field ) {
|
|
$fields[ $field['id'] ] = $field;
|
|
}
|
|
}
|
|
|
|
return $fields;
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_check_meta_box_supports' ) ) {
|
|
/**
|
|
* Check if a meta box supports an object.
|
|
*
|
|
* @param object $meta_box Meta Box object.
|
|
* @param int $key Not used.
|
|
* @param array $object_data Object data (type and ID).
|
|
*/
|
|
function rwmb_check_meta_box_supports( &$meta_box, $key, $object_data ) {
|
|
list( $object_type, $type_or_id ) = $object_data;
|
|
|
|
$type = null;
|
|
$prop = null;
|
|
switch ( $object_type ) {
|
|
case 'post':
|
|
$type = is_numeric( $type_or_id ) ? get_post_type( $type_or_id ) : $type_or_id;
|
|
$prop = 'post_types';
|
|
break;
|
|
case 'term':
|
|
$type = $type_or_id;
|
|
if ( is_numeric( $type_or_id ) ) {
|
|
$term = get_term( $type_or_id );
|
|
$type = is_wp_error( $term ) || ! $term ? null : $term->taxonomy;
|
|
}
|
|
$prop = 'taxonomies';
|
|
break;
|
|
case 'user':
|
|
$type = 'user';
|
|
$prop = 'user';
|
|
break;
|
|
case 'setting':
|
|
$type = $type_or_id;
|
|
$prop = 'settings_pages';
|
|
break;
|
|
}
|
|
if ( ! $type ) {
|
|
$meta_box = false;
|
|
return;
|
|
}
|
|
if ( isset( $meta_box->meta_box[ $prop ] ) && ! in_array( $type, $meta_box->meta_box[ $prop ], true ) ) {
|
|
$meta_box = false;
|
|
}
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_get_registry' ) ) {
|
|
/**
|
|
* Get the registry by type.
|
|
* Always return the same instance of the registry.
|
|
*
|
|
* @param string $type Registry type.
|
|
*
|
|
* @return object
|
|
*/
|
|
function rwmb_get_registry( $type ) {
|
|
static $data = [];
|
|
|
|
$class = 'RWMB_' . RWMB_Helpers_String::title_case( $type ) . '_Registry';
|
|
if ( ! isset( $data[ $type ] ) ) {
|
|
$data[ $type ] = new $class();
|
|
}
|
|
|
|
return $data[ $type ];
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_get_storage' ) ) {
|
|
/**
|
|
* Get storage instance.
|
|
*
|
|
* @param string $object_type Object type. Use post or term.
|
|
* @param RW_Meta_Box $meta_box Meta box object. Optional.
|
|
* @return RWMB_Storage_Interface
|
|
*/
|
|
function rwmb_get_storage( $object_type, $meta_box = null ) {
|
|
$class = 'RWMB_' . RWMB_Helpers_String::title_case( $object_type ) . '_Storage';
|
|
$class = class_exists( $class ) ? $class : 'RWMB_Post_Storage';
|
|
$storage = rwmb_get_registry( 'storage' )->get( $class );
|
|
|
|
return apply_filters( 'rwmb_get_storage', $storage, $object_type, $meta_box );
|
|
}
|
|
}
|
|
|
|
if ( ! function_exists( 'rwmb_request' ) ) {
|
|
/**
|
|
* Get request object.
|
|
*
|
|
* @return RWMB_Request
|
|
*/
|
|
function rwmb_request() {
|
|
static $request;
|
|
if ( ! $request ) {
|
|
$request = new RWMB_Request();
|
|
}
|
|
return $request;
|
|
}
|
|
}
|