PodsField_OEmbed

Complexity

Total Complexity

59

Size/Duplication

Total Lines	573
Duplicated Lines	3.14 %

Coupling/Cohesion

Components	2
Dependencies	3

Importance

Changes	1
Bugs	0	Features	0

16 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	2	1
A	schema()	0	5	1
B	display()	0	35	3
B	validate()	0	19	6
A	ui()	0	5	1
A	strip_html()	0	14	2
A	autoembed_callback()	0	7	1
B	options()	0	66	5
B	input()	18	18	7
A	pre_save()	0	16	3
A	autoembed()	0	12	1
B	get_provider()	0	29	5
B	validate_provider()	0	37	6
A	admin_init()	0	4	1
C	admin_ajax_oembed_update_preview()	0	35	8
C	get_providers()	0	37	8

<?php
/**
 * @package Pods\Fields
 */
class PodsField_OEmbed extends PodsField {

	/**
	 * Field Type Group
	 *
	 * @var string
	 * @since 2.0
	 */
	public static $group = 'Relationships / Media';

	/**
	 * Field Type Identifier
	 *
	 * @var string
	 * @since 2.0
	 */
	public static $type = 'oembed';

	/**
	 * Field Type Label
	 *
	 * @var string
	 * @since 2.0
	 */
	public static $label = 'oEmbed';

	/**
	 * Field Type Preparation
	 *
	 * @var string
	 * @since 2.0
	 */
	public static $prepare = '%s';
	
	/**
	 * Available oEmbed providers
	 * 
	 * @var array
	 * @since 2.7
	 */
	private $providers = array();
	
	/**
	 * Current embed width
	 * 
	 * @var int
	 * @since 2.7
	 */
	private $width = 0;
	
	/**
	 * Current embed height
	 * 
	 * @var int
	 * @since 2.7
	 */
	private $height = 0;

	/**
	 * Do things like register/enqueue scripts and stylesheets
	 *
	 * @since 2.0
	 */
	public function __construct () {
	}

	/**
	 * Add admin_init actions
	 *
	 * @since 2.3
	 */
	public function admin_init() {
		// AJAX for Uploads
		add_action( 'wp_ajax_oembed_update_preview', array( $this, 'admin_ajax_oembed_update_preview' ) );
	}

	/**
	 * Add options and set defaults to
	 *
	 * @return array
	 * @since 2.0
	 */
	public function options () {

		$options = array(
			self::$type . '_repeatable' => array(
				'label' => __( 'Repeatable Field', 'pods' ),
				'default' => 0,
				'type' => 'boolean',
				'help' => __( 'Making a field repeatable will add controls next to the field which allows users to Add/Remove/Reorder additional values. These values are saved in the database as an array, so searching and filtering by them may require further adjustments".', 'pods' ),
				'boolean_yes_label' => '',
				'dependency' => true,
				'developer_mode' => true
			),
			self::$type . '_width' => array(
				'label' => __( 'Embed Width', 'pods' ),
				'default' => 0,
				'type' => 'number',
				'help' => __( 'Optional width to use for this oEmbed. Leave as 0 (zero) to default to none.', 'pods' )
			),
			self::$type . '_height' => array(
				'label' => __( 'Embed Height', 'pods' ),
				'default' => 0,
				'type' => 'number',
				'help' => __( 'Optional height to use for this oEmbed. Leave as 0 (zero) to default to none.', 'pods' )
			),
			self::$type . '_show_preview' => array(
				'label' => __( 'Show preview', 'pods' ),
				'default' => 0,
				'type' => 'boolean'
			),
		);

		// Get all unique provider host names
		$unique_providers = array();
		foreach ( $this->get_providers() as $provider ) {
			if ( ! in_array( $provider['host'], $unique_providers ) )
				$unique_providers[] = $provider['host'];
		}
		sort($unique_providers);

		// Only add the options if we have data
		if ( ! empty( $unique_providers ) ) {
			$options[ self::$type . '_restrict_providers' ] = array(
				'label' => __( 'Restrict to providers', 'pods' ),
				'help' => __( 'Restrict input to specific WordPress oEmbed compatible providers.', 'pods' ),
				'type' => 'boolean',
				'default' => 0,
				'dependency' => true,
			);
			$options[ self::$type . '_enable_providers' ] = array(
				'label' => __( 'Select enabled providers', 'pods' ),
				'depends-on' => array( self::$type . '_restrict_providers' => true ),
				'group' => array()
			);
			// Add all the oEmbed providers
			foreach( $unique_providers as $provider ) {
				$options[ self::$type . '_enable_providers' ]['group'][ self::$type . '_enabled_providers_' . tag_escape( $provider ) ] = array(
					'label' => $provider,
					'type' => 'boolean',
					'default' => 0,
				);
			}
		}


		return $options;
	}

	/**
	 * Define the current field's schema for DB table storage
	 *
	 * @param array $options
	 *
	 * @return array
	 * @since 2.0
	 */
	public function schema ( $options = null ) {
		$schema = 'LONGTEXT';

		return $schema;
	}

	/**
	 * Change the way the value of the field is displayed with Pods::get
	 *
	 * @param mixed $value
	 * @param string $name
	 * @param array $options
	 * @param array $fields

There is no parameter named $fields. Was it maybe removed?

	 * @param array $pod
	 * @param int $id
	 *
	 * @since 2.0
	 */
	public function display ( $value = null, $name = null, $options = null, $pod = null, $id = null ) {
		$value = $this->pre_save( $value, $id, $name, $options, null, $pod );

		$width = (int) pods_v( self::$type . '_width', $options );
		$height = (int) pods_v( self::$type . '_height', $options );
		$args = array();
		if ( $width > 0 ) {
			$args['width'] = $width;
		}
		if ( $height > 0 ) {
			$args['height'] = $height;
		}

		$value = wp_oembed_get( $value, $args );

		/**
		 * @var $embed WP_Embed
		 */
		/*$embed = $GLOBALS[ 'wp_embed' ];

38% of this comment could be valid code. Did you maybe forget this after debugging?

		if ( 0 < $width && 0 < $height ) {
			$this->width = $width;
			$this->height = $height;
			
			// Setup [embed] shortcodes with set width/height
			$value = $this->autoembed( $value );
			
			// Run [embed] shortcodes
			$value = $embed->run_shortcode( $value );
		} else {
			// Autoembed URL normally
			$value = $embed->autoembed( $value );
		}*/
		return $value;
	}

	/**
	 * Customize output of the form field
	 *
	 * @param string $name
	 * @param mixed $value
	 * @param array $options
	 * @param array $pod
	 * @param int $id
	 *
	 * @since 2.0
	 */
	public function input ( $name, $value = null, $options = null, $pod = null, $id = null ) {

This method seems to be duplicated in your project.

		$options = (array) $options;
		$form_field_type = PodsForm::$field_type;

The property field_type cannot be accessed from this context as it is declared private in class PodsForm.

		if ( is_array( $value ) )
			$value = implode( ' ', $value );

		if ( isset( $options[ 'name' ] ) && false === PodsForm::permission( self::$type, $options[ 'name' ], $options, null, $pod, $id ) ) {
			if ( pods_var( 'read_only', $options, false ) )
				$options[ 'readonly' ] = true;
			else
				return;
		}
		elseif ( !pods_has_permissions( $options ) && pods_var( 'read_only', $options, false ) )
			$options[ 'readonly' ] = true;

		pods_view( PODS_DIR . 'ui/fields/oembed.php', compact( array_keys( get_defined_vars() ) ) );
	}

	/**
	 * Validate a value before it's saved
	 *
	 * @param mixed $value
	 * @param string $name
	 * @param array $options
	 * @param array $fields
	 * @param array $pod
	 * @param int $id
	 *
	 * @param null $params
	 * @return array|bool
	 * @since 2.0
	 */
	public function validate ( $value, $name = null, $options = null, $fields = null, $pod = null, $id = null, $params = null ) {
		$errors = array();

		$check = $this->pre_save( $value, $id, $name, $options, $fields, $pod, $params );

		if ( is_array( $check ) )
			$errors = $check;
		else {
			if ( 0 < strlen( $value ) && strlen( $check ) < 1 ) {
				if ( 1 == (bool) pods_v( 'required', $options ) )
					$errors[] = __( 'This field is required.', 'pods' );
			}
		}

		if ( !empty( $errors ) )
			return $errors;

		return true;
	}

	/**
	 * Change the value or perform actions after validation but before saving to the DB
	 *
	 * @param mixed $value
	 * @param int $id
	 * @param string $name
	 * @param array $options
	 * @param array $fields
	 * @param array $pod
	 * @param object $params
	 *
	 * @return mixed|string
	 * @since 2.0
	 */
	public function pre_save ( $value, $id = null, $name = null, $options = null, $fields = null, $pod = null, $params = null ) {
		$value = $this->strip_html( $value, $options );

		// Only allow ONE URL
		if ( ! empty( $value ) ) {
			$value = explode( ' ', $value );
			$value = esc_url( $value[0] );
		}

		if ( $this->validate_provider( $value, $options ) ) {
			return $value;
		} else {
			return false;
		}

	}

	/**
	 * Customize the Pods UI manage table column output
	 *
	 * @param int $id
	 * @param mixed $value
	 * @param string $name
	 * @param array $options
	 * @param array $fields
	 * @param array $pod
	 *
	 * @return mixed|string
	 * @since 2.0
	 */
	public function ui ( $id, $value, $name = null, $options = null, $fields = null, $pod = null ) {
		$value = $this->pre_save( $value, $id, $name, $options, $fields, $pod );

		return $value;
	}

	/**
	 * Strip HTML based on options
	 *
	 * @param string $value
	 * @param array $options
	 *
	 * @return string
	 */
	public function strip_html ( $value, $options = null ) {

The parameter $options is not used and could be removed.

		if ( is_array( $value ) )
			$value = @implode( ' ', $value );

		$value = trim( $value );

		// Strip HTML
		$value = strip_tags( $value );

		// Strip shortcodes
		$value = strip_shortcodes( $value );

		return $value;
	}

	/**
	 * Passes any unlinked URLs that are on their own line to {@link WP_Embed::shortcode()} for potential embedding.
	 *
	 * @see WP_Embed::autoembed()
	 * @see WP_Embed::autoembed_callback()
	 * 
	 * @uses PodsField_OEmbed::autoembed_callback()
	 *
	 * @param string $content The content to be searched.
	 * @return string Potentially modified $content.
	 * 
	 * @since 2.7
	 */
	public function autoembed( $content ) {

		// Replace line breaks from all HTML elements with placeholders.
		$content = wp_replace_in_html_tags( $content, array( "\n" => '<!-- wp-line-break -->' ) );

		// Find URLs that are on their own line.
		$content = preg_replace_callback( '|^(\s*)(https?://[^\s"]+)(\s*)$|im', array( $this, 'autoembed_callback' ), $content );

		// Put the line breaks back.
		return str_replace( '<!-- wp-line-break -->', "\n", $content );

	}

	/**
	 * Callback function for {@link WP_Embed::autoembed()}.
	 *
	 * @param array $match A regex match array.
	 * @return string The embed shortcode
	 * 
	 * @since 2.7
	 */
	public function autoembed_callback( $match ) {
		
		$shortcode = '[embed width="' . $this->width . '" height="' . $this->height . '"]' . $match[2] . '[/embed]';
		
		return $shortcode;

	}

	/**
	 * Get a list of available providers from the WP_oEmbed class
	 *
	 * @see wp-includes/class-oembed.php
	 * @return array $providers {
	 *     Array of provider data with regex as key
	 * 
	 *     @type string URL for this provider
	 *     @type int
	 *     @type string Hostname for this provider
	 * }
	 * 
	 * @since 2.7
	 */
	public function get_providers() {

		// Return class property if already set
		if ( ! empty( $this->providers ) ) {
			return $this->providers;
		}
		
		if ( file_exists( ABSPATH . WPINC . '/class-oembed.php' ) )
			require_once( ABSPATH . WPINC . '/class-oembed.php' );

		if ( function_exists( '_wp_oembed_get_object' ) ) {
			$wp_oembed = _wp_oembed_get_object();
			$providers = $wp_oembed->providers;
			foreach ( $providers as $key => $provider ) {
				$url = parse_url( $provider[0] );
				$host = $url['host'];
				$tmp = explode('.', $host);
				if ( count( $tmp ) == 3 ) {
					// Take domain names like .co.uk in consideration
					if ( ! in_array( 'co', $tmp ) ) {
						unset( $tmp[0] );
					}
				} elseif ( count( $tmp ) == 4 ) {
					// Take domain names like .co.uk in consideration
					unset( $tmp[0] );
				}
				$host = implode( '.', $tmp );
				$providers[ $key ]['host'] = $host;
			}
			$this->providers = $providers;
			return $providers;
		}
		
		// Return an empty array if no providers could be found
		return array();

	}

	/**
	 * Takes a URL and returns the corresponding oEmbed provider's URL, if there is one.
	 * This function is ripped from WP since Pods has support from 3.8 and in the WP core this function is 4.0+
	 * We've stripped the autodiscover part from this function to keep it basic
	 *
	 * @since 2.7
	 * @access public
	 *
	 * @see WP_oEmbed::get_provider()
	 *
	 * @param string        $url  The URL to the content.
	 * @return false|string False on failure, otherwise the oEmbed provider URL.
	 */
	public function get_provider( $url ) {

		$provider = false;

		foreach ( $this->providers as $matchmask => $data ) {
			if ( isset( $data['host'] ) ) {
				unset( $data['host'] );
			}
			reset( $data );

			list( $providerurl, $regex ) = $data;

			$match = $matchmask;

			// Turn the asterisk-type provider URLs into regex
			if ( !$regex ) {
				$matchmask = '#' . str_replace( '___wildcard___', '(.+)', preg_quote( str_replace( '*', '___wildcard___', $matchmask ), '#' ) ) . '#i';
				$matchmask = preg_replace( '|^#http\\\://|', '#https?\://', $matchmask );
			}

			if ( preg_match( $matchmask, $url ) ) {
				//$provider = str_replace( '{format}', 'json', $providerurl ); // JSON is easier to deal with than XML

50% of this comment could be valid code. Did you maybe forget this after debugging?

				$provider = $match;
				break;
			}
		}

		return $provider;
	}

	/**
	 * Validate a value with the enabled oEmbed providers (if required)
	 * 
	 * @since 2.7
	 * @param string $value
	 * @param array $options Field options
	 * @return bool
	 */
	public function validate_provider( $value, $options ) {

		// Do we even need to validate?
		if ( false == (int) pods_v( self::$type . '_restrict_providers', $options ) ) {

It seems like you are loosely comparing (int) pods_v(self::$type . '_restrict_providers', $options) of type integer to the boolean false. If you are specifically checking for 0, consider using something more explicit like === 0 instead.

			return true;
		}

		$providers = $this->get_providers();

		// Filter existing providers
		foreach( $providers as $key => $provider ) {
			$fieldname = self::$type . '_enabled_providers_' . tag_escape( $provider['host'] );

			/**
			 * @todo Future compat to enable serialised strings as field options
			 */
			/*if ( empty( $options[ self::$type . '_enabled_providers_' ][ $provider['host'] ] ) ) {

60% of this comment could be valid code. Did you maybe forget this after debugging?

				unset( $providers[ $key ] );
			} else*/

			/**
			 * Current solution: all separate field options
			 */
			if ( empty( $options[ $fieldname ] ) ) {
				unset( $providers[ $key ] );
			}
		}

		// Value validation
		$provider_match = $this->get_provider( $value );
		foreach ( $providers as $match => $provider ) {
			if ( $provider_match == $match ) {
				return true;
			}
		}
		return false;
	}

	/**
	 * Handle update preview AJAX
	 *
	 * @since 2.7
	 */
	public function admin_ajax_oembed_update_preview() {

		// Sanitize input
		$params = pods_unslash( (array) $_POST );

		if (   ! empty( $params['_nonce_pods_oembed'] ) 
			&& ! empty( $params['pods_field_oembed_value'] ) 
			&& wp_verify_nonce( $params['_nonce_pods_oembed'], 'pods_field_oembed_preview' ) 
		) {
			$value = $this->strip_html( $params['pods_field_oembed_value'] );
			$name = ( ! empty( $params['pods_field_oembed_name'] ) ) ? $this->strip_html( $params['pods_field_oembed_name'] ) : '';
			$options = ( ! empty( $params['pods_field_oembed_options'] ) ) ? $params['pods_field_oembed_options'] : array();

			// Load the field to get it's options
			$options = pods_api()->load_field( (object) $options );

			// Field options are stored here, if not, just stay with the full options array
			if ( ! empty( $options['options'] ) ) {
				$options = $options['options'];
			}

			// Run display function to run oEmbed
			$value = $this->display( $value, $name, $options );

			if ( empty( $value ) ) {
				$value = __( 'Please choose a valid oEmbed URL.', 'pods' );
				wp_send_json_error( $value );
			} else {
				wp_send_json_success( $value );
			}
		}
		wp_send_json_error( __( 'Unauthorized request', 'pods' ) );

		die(); // Kill it!

The method admin_ajax_oembed_update_preview() contains an exit expression.

	}

}