name = 'oembed'; $this->label = __( 'oEmbed', 'acf' ); $this->category = 'content'; $this->description = __( 'An interactive component for embedding videos, images, tweets, audio and other content by making use of the native WordPress oEmbed functionality.', 'acf' ); $this->preview_image = acf_get_url() . '/assets/images/field-type-previews/field-preview-oembed.png'; $this->doc_url = acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/oembed/', 'docs', 'field-type-selection' ); $this->defaults = array( 'width' => '', 'height' => '', ); $this->width = 640; $this->height = 390; $this->supports = array( 'escaping_html' => true, // The OEmbed field only produces html safe content from format_value. ); // extra add_action( 'wp_ajax_acf/fields/oembed/search', array( $this, 'ajax_query' ) ); add_action( 'wp_ajax_nopriv_acf/fields/oembed/search', array( $this, 'ajax_query' ) ); } /* * prepare_field * * This function will prepare the field for input * * @type function * @date 14/2/17 * @since 5.5.8 * * @param $field (array) * @return (int) */ function prepare_field( $field ) { // defaults if ( ! $field['width'] ) { $field['width'] = $this->width; } if ( ! $field['height'] ) { $field['height'] = $this->height; } // return return $field; } /** * Attempts to fetch the HTML for the provided URL using oEmbed. * * @date 24/01/2014 * @since 5.0.0 * * @param string $url The URL that should be embedded. * @param int|string $width Optional maxwidth value passed to the provider URL. * @param int|string $height Optional maxheight value passed to the provider URL. * @return string|false The embedded HTML on success, false on failure. */ function wp_oembed_get( $url = '', $width = 0, $height = 0 ) { $embed = false; $res = array( 'width' => $width, 'height' => $height, ); if ( function_exists( 'wp_oembed_get' ) ) { $embed = wp_oembed_get( $url, $res ); } // try shortcode if ( ! $embed ) { global $wp_embed; $embed = $wp_embed->shortcode( $res, $url ); } return $embed; } /* * ajax_query * * description * * @type function * @date 24/10/13 * @since 5.0.0 * * @param $post_id (int) * @return $post_id (int) */ function ajax_query() { // validate if ( ! acf_verify_ajax() ) { die(); } // get choices $response = $this->get_ajax_query( $_POST ); // return wp_send_json( $response ); } /* * get_ajax_query * * This function will return an array of data formatted for use in a select2 AJAX response * * @type function * @date 15/10/2014 * @since 5.0.9 * * @param $options (array) * @return (array) */ function get_ajax_query( $args = array() ) { // defaults $args = acf_parse_args( $args, array( 's' => '', 'field_key' => '', ) ); // load field $field = acf_get_field( $args['field_key'] ); if ( ! $field ) { return false; } // prepare field to correct width and height $field = $this->prepare_field( $field ); // vars $response = array( 'url' => $args['s'], 'html' => $this->wp_oembed_get( $args['s'], $field['width'], $field['height'] ), ); // return return $response; } /* * render_field() * * Create the HTML interface for your field * * @param $field - an array holding all the field's data * * @type action * @since 3.6 * @date 23/01/13 */ function render_field( $field ) { // atts $atts = array( 'class' => 'acf-oembed', ); // _e("No embed found for the given URL.", 'acf'); // value if ( $field['value'] ) { $atts['class'] .= ' has-value'; } ?>
> 'input-value', 'name' => $field['name'], 'value' => $field['value'], ) ); ?>
'input-search', 'value' => $field['value'], 'placeholder' => __( 'Enter URL', 'acf' ), 'autocomplete' => 'off', ) ); ?>
wp_oembed_get( $field['value'], $field['width'], $field['height'] ); } ?>
__( 'Embed Size', 'acf' ), 'type' => 'text', 'name' => 'width', 'prepend' => __( 'Width', 'acf' ), 'append' => 'px', 'placeholder' => $this->width, ) ); acf_render_field_setting( $field, array( 'label' => __( 'Embed Size', 'acf' ), 'type' => 'text', 'name' => 'height', 'prepend' => __( 'Height', 'acf' ), 'append' => 'px', 'placeholder' => $this->height, '_append' => 'width', ) ); } /** * This filter is appied to the $value after it is loaded from the db and before it is returned to the template. * * @type filter * @since 3.6 * * @param mixed $value The value which was loaded from the database. * @param mixed $post_id The $post_id from which the value was loaded. * @param array $field The field array holding all the field options. * * @return mixed the modified value */ function format_value( $value, $post_id, $field ) { // bail early if no value if ( empty( $value ) ) { return $value; } // prepare field to correct width and height $field = $this->prepare_field( $field ); // get oembed $value = $this->wp_oembed_get( $value, $field['width'], $field['height'] ); // return return $value; } /** * Return the schema array for the REST API. * * @param array $field * @return array */ public function get_rest_schema( array $field ) { $schema = parent::get_rest_schema( $field ); $schema['format'] = 'uri'; return $schema; } } // initialize acf_register_field_type( 'acf_field_oembed' ); endif; // class_exists check ?>