pods-framework / pods

classes/PodsComponents.php

<?php

/**
 * Component managing class
 *
 * @package Pods
 */
class PodsComponents {

	/**
	 * @var PodsComponents
	 */
	public static $instance = null;

	/**
	 * Root of Components directory
	 *
	 * @var string
	 *
	 * @private
	 * @since 2.0
	 */
	private $components_dir = null;

	/**
	 * Available components
	 *
	 * @var array
	 *
	 * @since 2.0
	 */
	public $components = array();

	/**
	 * Components settings
	 *
	 * @var array
	 *
	 * @since 2.0
	 */
	public $settings = array();

	/**
	 * Singleton handling for a basic pods_components() request
	 *
	 * @return \PodsComponents
	 *
	 * @since 2.3.5
	 */
	public static function init() {

		if ( ! is_object( self::$instance ) ) {
			self::$instance = new self();
		}

		return self::$instance;
	}

	/**
	 * Setup actions and get options
	 *
	 * @since 2.0
	 */
	public function __construct() {

		$this->components_dir = realpath( apply_filters( 'pods_components_dir', PODS_DIR . 'components' ) ) . '/';

		$settings = get_option( 'pods_component_settings', '' );

		if ( ! empty( $settings ) ) {
			$this->settings = (array) json_decode( $settings, true );
		}

		if ( ! isset( $this->settings['components'] ) ) {
			$this->settings['components'] = array();
		}

		// Get components (give it access to theme)
		add_action( 'setup_theme', array( $this, 'get_components' ), 11 );

		// Load in components
		add_action( 'setup_theme', array( $this, 'load' ), 12 );

		// AJAX handling
		if ( is_admin() ) {
			add_action( 'wp_ajax_pods_admin_components', array( $this, 'admin_ajax' ) );
			add_action( 'wp_ajax_nopriv_pods_admin_components', array( $this, 'admin_ajax' ) );

			// Add the Pods Components capabilities
			add_filter( 'members_get_capabilities', array( $this, 'admin_capabilities' ) );
		}
	}

	/**
	 * Add menu item
	 *
	 * @param string $parent The parent slug.
	 *
	 * @since 2.0
	 *
	 * @uses  add_submenu_page
	 */
	public function menu( $parent ) {

		global $submenu;

Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

		$custom_component_menus = array();

The variable name $custom_component_menus exceeds the maximum configured length of 20.

		$pods_component_menu_items = array();

The variable name $pods_component_menu_items exceeds the maximum configured length of 20.

		foreach ( $this->components as $component => $component_data ) {
			$component_id = $component_data['ID'];

			$component_data['MustUse'] = apply_filters( 'pods_component_require_' . $component_id, $component_data['MustUse'], $component_data );

			if ( empty( $component_data['MustUse'] ) && ( ! isset( $this->settings['components'][ $component ] ) || 0 === $this->settings['components'][ $component ] ) ) {
				continue;
			}

			if ( ! empty( $component_data['Hide'] ) ) {
				continue;
			}

			if ( ! empty( $component_data['DeveloperMode'] ) && ! pods_developer() ) {
				continue;
			}

			if ( empty( $component_data['TablelessMode'] ) && pods_tableless() ) {
				continue;
			}

			if ( empty( $component_data['MenuPage'] ) ) {
				if ( ! isset( $component_data['object'] ) ) {
					continue;
				} elseif ( ! method_exists( $component_data['object'], 'admin' ) && ! method_exists( $component_data['object'], 'options' ) ) {
					continue;
				}
			}

			if ( false === $component_data['External'] ) {
				$component_data['File'] = realpath( $this->components_dir . $component_data['File'] );
			}

			if ( ! file_exists( $component_data['File'] ) ) {
				pods_message( 'Pods Component not found: ' . $component_data['File'] );

				pods_transient_clear( 'pods_components' );

				continue;
			}

			$capability = 'pods_component_' . str_replace( '-', '_', sanitize_title( $component ) );

			if ( 0 < strlen( $component_data['Capability'] ) ) {
				$capability = $component_data['Capability'];
			}

			if ( ! pods_is_admin( array( 'pods', 'pods_components', $capability ) ) ) {
				continue;
			}

			$menu_page = 'pods-component-' . $component;

			if ( ! empty( $component_data['MenuPage'] ) ) {
				$custom_component_menus[ $menu_page ] = $component_data;
			}

			$pods_component_menu_items[ $component_data['MenuName'] ] = array(
				'menu_page'  => $menu_page,
				'page_title' => $component_data['Name'],
				'capability' => 'read',
				'callback'   => array( $this, 'admin_handler' ),
			);

			if ( isset( $component_data['object'] ) && method_exists( $component_data['object'], 'admin_assets' ) ) {
				$pods_component_menu_items[ $component_data['MenuName'] ]['assets'] = array(
					$component_data['object'],
					'admin_assets',
				);
			}
		}//end foreach

		/**
		 * Add or change the items in the Pods Components Submenu.
		 *
		 * Can also be used to change which menu components is a submenu of or change title of menu.
		 *
		 * @param array $pods_component_menu_items {
		 *      An array of arguments for add_submenu_page
		 *
		 *     @type string $parent_slug The slug name for the parent menu (or the file name of a standard WordPress admin page)
		 *     @type string $page_title  The text to be displayed in the title tags of the page when the menu is selected
		 *     @type string $menu_title  The text to be used for the menu
		 *     @type string $capability  The capability required for this menu to be displayed to the user.
		 *     @type string $menu_slug   The slug name to refer to this menu by (should be unique for this menu)
		 *     @type string $function    The function to be called to output the content for this page.
		 * }
		 *
		 * @since  2.4.1
		 */
		$pods_component_menu_items = apply_filters( 'pods_admin_components_menu', $pods_component_menu_items );

		ksort( $pods_component_menu_items );

		foreach ( $pods_component_menu_items as $menu_title => $menu_data ) {
			if ( ! is_callable( $menu_data['callback'] ) ) {
				continue;
			}

			$page = add_submenu_page( $parent, strip_tags( $menu_data['page_title'] ), '- ' . strip_tags( $menu_title ), pods_v( 'capability', $menu_data, 'read', true ), $menu_data['menu_page'], $menu_data['callback'] );

			if ( isset( $menu_data['assets'] ) && is_callable( $menu_data['assets'] ) ) {
				add_action( 'admin_print_styles-' . $page, $menu_data['assets'] );
			}
		}

		if ( ! empty( $custom_component_menus ) ) {
			foreach ( $custom_component_menus as $menu_page => $component_data ) {
				if ( isset( $submenu[ $parent ] ) ) {
					foreach ( $submenu[ $parent ] as $sub => &$menu ) {
						if ( $menu[2] === $menu_page ) {
							$menu_page = $component_data['MenuPage'];

							$menu[2] = $menu_page;

							$page = current( explode( '?', $menu[2] ) );

							if ( isset( $component_data['object'] ) && method_exists( $component_data['object'], 'admin_assets' ) ) {
								add_action(
									'admin_print_styles-' . $page, array(
										$component_data['object'],
										'admin_assets',
									)
								);
							}

							break;
						}//end if
					}//end foreach
				}//end if
			}//end foreach
		}//end if
	}

	/**
	 * Load activated components and init component
	 *
	 * @since 2.0
	 */
	public function load() {

		do_action( 'pods_components_load' );

		foreach ( (array) $this->components as $component => $component_data ) {
			$component_id = $component_data['ID'];

			$component_data['MustUse'] = apply_filters( 'pods_component_require_' . $component_id, $component_data['MustUse'], $component_data );

			if ( false === $component_data['MustUse'] && ( ! isset( $this->settings['components'][ $component ] ) || 0 === $this->settings['components'][ $component ] ) ) {
				continue;
			}

			if ( ! empty( $component_data['PluginDependency'] ) ) {
				$dependency = explode( '|', $component_data['PluginDependency'] );

				if ( ! pods_is_plugin_active( $dependency[1] ) ) {
					continue;
				}
			}

			if ( ! empty( $component_data['ThemeDependency'] ) ) {
				$dependency = explode( '|', $component_data['ThemeDependency'] );

				$check = strtolower( $dependency[1] );

				if ( strtolower( get_template() ) !== $check && strtolower( get_stylesheet() ) !== $check ) {
					continue;
				}
			}

			if ( false === $component_data['External'] ) {
				$component_data['File'] = realpath( $this->components_dir . $component_data['File'] );
			}

			if ( empty( $component_data['File'] ) ) {
				pods_transient_clear( 'pods_components' );

				continue;
			}

			if ( ! file_exists( $component_data['File'] ) ) {
				pods_message( 'Pods Component not found: ' . $component_data['File'] );

				pods_transient_clear( 'pods_components' );

				continue;
			}

			include_once $component_data['File'];

			if ( ( ! empty( $component_data['Class'] ) && class_exists( $component_data['Class'] ) ) || isset( $component_data['object'] ) ) {
				if ( ! isset( $this->components[ $component ]['object'] ) ) {
					$this->components[ $component ]['object'] = new $component_data['Class']();
				}

				if ( method_exists( $this->components[ $component ]['object'], 'options' ) ) {
					if ( isset( $this->settings['components'][ $component ] ) ) {
						$this->components[ $component ]['options'] = $this->components[ $component ]['object']->options( $this->settings['components'][ $component ] );
					} else {
						$this->components[ $component ]['options'] = $this->components[ $component ]['object']->options( array() );
					}

					$this->options( $component, $this->components[ $component ]['options'] );
				} else {
					$this->options( $component, array() );
				}

				if ( method_exists( $this->components[ $component ]['object'], 'handler' ) ) {
					$this->components[ $component ]['object']->handler( $this->settings['components'][ $component ] );
				}
			}//end if
		}//end foreach
	}

	/**
	 * Get list of components available
	 *
	 * @since 2.0
	 */
	public function get_components() {

		$components = pods_transient_get( 'pods_components' );

		if ( 1 === (int) pods_v( 'pods_debug_components', 'get', 0 ) && pods_is_admin( array( 'pods' ) ) ) {
			$components = array();
		}

		if ( PODS_VERSION !== PodsInit::$version || ! is_array( $components ) || empty( $components ) || ( is_admin() && 'pods-components' === pods_v( 'page' ) && 1 !== (int) pods_transient_get( 'pods_components_refresh' ) ) ) {
			do_action( 'pods_components_get' );

			// @codingStandardsIgnoreLine
			$component_dir   = @opendir( untrailingslashit( $this->components_dir ) );
			$component_files = array();

			if ( false !== $component_dir ) {
				$file = readdir( $component_dir );

				while ( false !== $file ) {
					if ( '.' === substr( $file, 0, 1 ) ) {
						// Get next file
						$file = readdir( $component_dir );

						continue;
					} elseif ( is_dir( $this->components_dir . $file ) ) {
						// @codingStandardsIgnoreLine
						$component_subdir = @opendir( $this->components_dir . $file );

						if ( $component_subdir ) {
							$subfile = readdir( $component_subdir );

							while ( false !== $subfile ) {
								if ( '.' === substr( $subfile, 0, 1 ) ) {
									// Get next file
									$subfile = readdir( $component_subdir );

									continue;
								} elseif ( '.php' === substr( $subfile, - 4 ) ) {
									$component_files[] = str_replace( '\\', '/', $file . '/' . $subfile );
								}

								// Get next file
								$subfile = readdir( $component_subdir );
							}

							closedir( $component_subdir );
						}
					} elseif ( '.php' === substr( $file, - 4 ) ) {
						$component_files[] = $file;
					}//end if

					// Get next file
					$file = readdir( $component_dir );
				}//end while

				closedir( $component_dir );
			}//end if

			$default_headers = array(
				'ID'               => 'ID',
				'Name'             => 'Name',
				'ShortName'        => 'Short Name',
				'PluginName'       => 'Plugin Name',
				'ComponentName'    => 'Component Name',
				'URI'              => 'URI',
				'MenuName'         => 'Menu Name',
				'MenuPage'         => 'Menu Page',
				'MenuAddPage'      => 'Menu Add Page',
				'MustUse'          => 'Must Use',
				'Description'      => 'Description',
				'Version'          => 'Version',
				'Category'         => 'Category',
				'Author'           => 'Author',
				'AuthorURI'        => 'Author URI',
				'Class'            => 'Class',
				'Hide'             => 'Hide',
				'PluginDependency' => 'Plugin Dependency',
				'ThemeDependency'  => 'Theme Dependency',
				'DeveloperMode'    => 'Developer Mode',
				'TablelessMode'    => 'Tableless Mode',
				'Capability'       => 'Capability',
				'Plugin'           => 'Plugin',
			);

			$component_files = apply_filters( 'pods_components_register', $component_files );

			$components = array();

			foreach ( $component_files as $component_file ) {
				$external = false;

				if ( is_array( $component_file ) && isset( $component_file['File'] ) ) {
					$component_file = $component_file['File'];
					$component      = $component_file;

					$external = true;
				} else {
					$component = $this->components_dir . $component_file;
				}

				if ( ! is_readable( $component ) ) {
					continue;
				}

				$component_data = get_file_data( $component, $default_headers, 'pods_component' );

				if ( ( empty( $component_data['Name'] ) && empty( $component_data['ComponentName'] ) && empty( $component_data['PluginName'] ) ) || 'yes' === $component_data['Hide'] ) {
					continue;
				}

				if ( isset( $component_data['Plugin'] ) && pods_is_plugin_active( $component_data['Plugin'] ) ) {
					continue;
				}

				if ( empty( $component_data['Name'] ) ) {
					if ( ! empty( $component_data['ComponentName'] ) ) {
						$component_data['Name'] = $component_data['ComponentName'];
					} elseif ( ! empty( $component_data['PluginName'] ) ) {
						$component_data['Name'] = $component_data['PluginName'];
					}
				}

				if ( empty( $component_data['ShortName'] ) ) {
					$component_data['ShortName'] = $component_data['Name'];
				}

				if ( empty( $component_data['MenuName'] ) ) {
					$component_data['MenuName'] = $component_data['Name'];
				}

				if ( empty( $component_data['Class'] ) ) {
					$component_data['Class'] = 'Pods_' . pods_js_name( basename( $component, '.php' ), false );
				}

				if ( empty( $component_data['ID'] ) ) {
					$component_data['ID'] = $component_data['Name'];
				}

				$component_data['ID'] = sanitize_title( $component_data['ID'] );

				if ( 'on' === strtolower( $component_data['DeveloperMode'] ) || 1 === $component_data['DeveloperMode'] ) {
					$component_data['DeveloperMode'] = true;
				} else {
					$component_data['DeveloperMode'] = false;
				}

				if ( 'on' === strtolower( $component_data['TablelessMode'] ) || 1 === $component_data['TablelessMode'] ) {
					$component_data['TablelessMode'] = true;
				} else {
					$component_data['TablelessMode'] = false;
				}

				$component_data['External'] = (boolean) $external;

				if ( 'on' === strtolower( $component_data['MustUse'] ) || '1' === $component_data['MustUse'] ) {
					$component_data['MustUse'] = true;
				} elseif ( 'off' === strtolower( $component_data['MustUse'] ) || '0' === $component_data['MustUse'] ) {
					$component_data['MustUse'] = false;
				} else {
					$component_data['MustUse'] = $component_data['External'];
				}

				$component_data['File'] = $component_file;

				$components[ $component_data['ID'] ] = $component_data;
			}//end foreach

			ksort( $components );

			pods_transient_set( 'pods_components_refresh', 1, ( 60 * 60 * 12 ) );

			pods_transient_set( 'pods_components', $components );
		}//end if

		if ( 1 === (int) pods_v( 'pods_debug_components', 'get', 0 ) && pods_is_admin( array( 'pods' ) ) ) {
			pods_debug( $components );
		}

		$this->components = $components;

		return $this->components;
	}

	/**
	 * Set component options
	 *
	 * @param string $component Component name.
	 * @param array  $options   Component options.
	 *
	 * @since 2.0
	 */
	public function options( $component, $options ) {

		if ( ! isset( $this->settings['components'][ $component ] ) || ! is_array( $this->settings['components'][ $component ] ) ) {
			$this->settings['components'][ $component ] = array();
		}

		foreach ( $options as $option => $data ) {
			if ( ! isset( $this->settings['components'][ $component ][ $option ] ) && isset( $data['default'] ) ) {
				$this->settings['components'][ $component ][ $option ] = $data['default'];
			}
		}
	}

	/**
	 * Call component specific admin functions
	 *
	 * @since 2.0
	 */
	public function admin_handler() {

		$component = str_replace( 'pods-component-', '', pods_v_sanitized( 'page' ) );

		if ( isset( $this->components[ $component ] ) && isset( $this->components[ $component ]['object'] ) && is_object( $this->components[ $component ]['object'] ) ) {
			// Component init
			if ( method_exists( $this->components[ $component ]['object'], 'init' ) ) {
				$this->components[ $component ]['object']->init( $this->settings['components'][ $component ], $component );
			}

			if ( method_exists( $this->components[ $component ]['object'], 'admin' ) ) {
				// Component Admin handler
				$this->components[ $component ]['object']->admin( $this->settings['components'][ $component ], $component );
			} elseif ( method_exists( $this->components[ $component ]['object'], 'options' ) ) {
				// Built-in Admin Handler
				$this->admin( $this->components[ $component ]['object']->options( $this->settings['components'][ $component ] ), $this->settings['components'][ $component ], $component );
			}
		}
	}

	/**
	 * Render components admin.
	 *
	 * @param array  $options   Component options.
	 * @param array  $settings  Component setting values.
	 * @param string $component Component name.
	 */
	public function admin( $options, $settings, $component ) {

		if ( ! isset( $this->components[ $component ] ) ) {
			wp_die( 'Invalid Component', '', array( 'back_link' => true ) );
		}

		$component_label = $this->components[ $component ]['Name'];

		include PODS_DIR . 'ui/admin/components-admin.php';
	}

	/**
	 * Check if a component is active or not
	 *
	 * @param string $component The component name to check if active.
	 *
	 * @return bool
	 *
	 * @since 2.7
	 */
	public function is_component_active( $component ) {

		$active = false;

		if ( isset( $this->components[ $component ] ) && isset( $this->settings['components'][ $component ] ) && 0 !== $this->settings['components'][ $component ] ) {
			$active = true;
		}

		return $active;

	}

	/**
	 * Activate a component
	 *
	 * @param string $component The component name to activate.
	 *
	 * @return boolean Whether the component was activated.
	 *
	 * @since 2.7
	 */
	public function activate_component( $component ) {

		$activated = false;

		if ( ! $this->is_component_active( $component ) ) {
			if ( empty( $this->components ) ) {
				// Setup components
				PodsInit::$components->get_components();
			}

			if ( isset( $this->components[ $component ] ) ) {
				$this->settings['components'][ $component ] = array();

				$this->update_settings( $this->settings );

				$activated = true;
			}
		} else {
			$activated = true;
		}//end if

		return $activated;

	}

	/**
	 * Deactivate a component
	 *
	 * @param string $component The component name to deactivate.
	 *
	 * @since 2.7
	 */
	public function deactivate_component( $component ) {

		if ( $this->is_component_active( $component ) ) {
			if ( isset( $this->components[ $component ] ) ) {
				$this->settings['components'][ $component ] = 0;

				$this->update_settings( $this->settings );
			}
		}

	}

	/**
	 * Toggle a component on or off
	 *
	 * @param string  $component   The component name to toggle.
	 * @param boolean $toggle_mode Force toggle on or off.
	 *
	 * @return bool
	 *
	 * @since 2.0
	 */
	public function toggle( $component, $toggle_mode = false ) {

		$toggled = null;

		$toggle_mode = (boolean) pods_v( 'toggle', 'get', $toggle_mode );

		if ( $toggle_mode ) {
			$toggled = $this->activate_component( $component );
		} else {
			$this->deactivate_component( $component );

			$toggled = false;
		}

		return $toggled;

	}

	/**
	 * Add pods specific capabilities.
	 *
	 * @param array $capabilities List of extra capabilities to add.
	 *
	 * @return array
	 */
	public function admin_capabilities( $capabilities ) {

		foreach ( $this->components as $component => $component_data ) {
			if ( ! empty( $component_data['Hide'] ) ) {
				continue;
			}

			if ( ! pods_developer() ) {
				if ( true === (boolean) pods_v( 'DeveloperMode', $component_data, false ) ) {
					continue;
				}

				if ( true === (boolean) pods_v( 'TablelessMode', $component_data, false ) ) {
					continue;
				}
			}

			if ( empty( $component_data['MenuPage'] ) && ( ! isset( $component_data['object'] ) || ! method_exists( $component_data['object'], 'admin' ) ) ) {
				continue;
			}

			$capability = 'pods_component_' . str_replace( '-', '_', sanitize_title( str_replace( ' and ', ' ', strip_tags( $component_data['Name'] ) ) ) );

			if ( 0 < strlen( $component_data['Capability'] ) ) {
				$capability = $component_data['Capability'];
			}

			if ( ! in_array( $capability, $capabilities, true ) ) {
				$capabilities[] = $capability;
			}
		}//end foreach

		return $capabilities;
	}

	/**
	 * Handle admin ajax
	 *
	 * @since 2.0
	 */
	public function admin_ajax() {

		if ( false === headers_sent() ) {
			pods_session_start();

			header( 'Content-Type: text/html; charset=' . get_bloginfo( 'charset' ) );
		}

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

		foreach ( $params as $key => $value ) {
			if ( 'action' === $key ) {
				continue;
			}

			unset( $params[ $key ] );

			$params[ str_replace( '_podsfix_', '', $key ) ] = $value;
		}

		$params = (object) $params;

		$component = $params->component;
		$method    = $params->method;

		if ( ! isset( $component ) || ! isset( $this->components[ $component ] ) || ! isset( $this->settings['components'][ $component ] ) ) {
			pods_error( 'Invalid AJAX request', $this );
		}

		if ( ! isset( $params->_wpnonce ) || false === wp_verify_nonce( $params->_wpnonce, 'pods-component-' . $component . '-' . $method ) ) {
			pods_error( 'Unauthorized request', $this );
		}

		// Cleaning up $params
		unset( $params->action, $params->component, $params->method, $params->_wpnonce );

		$params = (object) apply_filters( 'pods_component_ajax_' . $component . '_' . $method, $params, $component, $method );

		$output = false;

		// Component init
		if ( isset( $this->components[ $component ]['object'] ) && method_exists( $this->components[ $component ]['object'], 'init' ) ) {
			$this->components[ $component ]['object']->init( $this->settings['components'][ $component ], $component );
		}

		if ( isset( $this->components[ $component ]['object'] ) && ! method_exists( $this->components[ $component ]['object'], 'ajax_' . $method ) && method_exists( $this, 'admin_ajax_' . $method ) ) {
			// Handle internal methods
			$output = call_user_func( array( $this, 'admin_ajax_' . $method ), $component, $params );
		} elseif ( ! isset( $this->components[ $component ]['object'] ) || ! method_exists( $this->components[ $component ]['object'], 'ajax_' . $method ) ) {
			// Make sure method exists
			pods_error( 'API method does not exist', $this );
		} else {
			// Dynamically call the component method
			$output = call_user_func( array( $this->components[ $component ]['object'], 'ajax_' . $method ), $params );
		}

		if ( ! is_bool( $output ) ) {
			// @codingStandardsIgnoreLine
			echo $output;
		}

		die();
		// KBAI!
	}

	/**
	 * Handle admin AJAX settings saving.
	 *
	 * @param string $component Component name.
	 * @param array  $params    AJAX parameters.
	 *
	 * @return string
	 */
	public function admin_ajax_settings( $component, $params ) {

		if ( ! isset( $this->components[ $component ] ) ) {
			wp_die( 'Invalid Component', '', array( 'back_link' => true ) );
		} elseif ( ! method_exists( $this->components[ $component ]['object'], 'options' ) ) {
			pods_error( 'Component options method does not exist', $this );
		}

		$options = $this->components[ $component ]['object']->options( $this->settings['components'][ $component ] );

		if ( empty( $this->settings['components'][ $component ] ) ) {
			$this->settings['components'][ $component ] = array();
		}

		foreach ( $options as $field_name => $field_option ) {
			$field_option = PodsForm::field_setup( $field_option, null, $field_option['type'] );

			if ( ! is_array( $field_option['group'] ) ) {
				$field_value = pods_v( 'pods_setting_' . $field_name, $params );

				$this->settings['components'][ $component ][ $field_name ] = $field_value;
			} else {
				foreach ( $field_option['group'] as $field_group_name => $field_group_option ) {
					$field_value = pods_v( 'pods_setting_' . $field_group_name, $params );

					$this->settings['components'][ $component ][ $field_group_name ] = $field_value;
				}
			}
		}

		$this->update_settings( $this->settings );

		return '1';
	}

	/**
	 * Update settings.
	 *
	 * @param array $settings Component settings.
	 */
	public function update_settings( $settings ) {

		if ( version_compare( PHP_VERSION, '5.4.0', '>=' ) ) {
			$settings = wp_json_encode( $settings, JSON_UNESCAPED_UNICODE );
		} else {
			$settings = wp_json_encode( $settings );
		}

		update_option( 'pods_component_settings', $settings );

	}
}