loader.php

<?php

// =================================
// === Plugin Panel Loader Class ===
// =================================

// -------------
// Loader v1.3.8
// -------------
// Note: Changelog at end of file.

if ( !defined( 'ABSPATH' ) ) exit;

// === Loader Class ===
// - Initialize Loader
// - Setup Plugin
// - Get Plugin Data
// - Get Plugin Version
// - Set Pro Namespace
// === Plugin Settings ===
// - Get Default Settings
// - Add Settings
// - Maybe Transfer Settings
// - Get All Plugin Settings
// - Get Plugin Setting
// - Reset Plugin Settings
// - Update Plugin Settings
// - Validate Plugin Setting
// === Plugin Loading ===
// - Load Plugin Settings
// - Add Actions
// - Load Helper Libraries
// - Maybe Load Thickbox
// - Readme Viewer AJAX
// === Freemius Loading ===
// - Load Freemius
// - Filter Freemius Connect
// - Freemius Connect Message
// - Connect Update Message
// === Plugin Admin ===
// - Add Settings Menu
// - Plugin Page Links
// - Message Box
// - Notice Boxer
// - Plugin Page Header
// - Settings Page
// - Settings Table
// - Setting Row
// - Settings Scripts
// - Settings Styles
// === Namespaced Functions ===


// ============
// Loader Usage
// ============
// 1. replace all occurrences of stream_player_ in this file with the plugin namespace prefix eg. my_plugin_
// 2. replace all occurrences of 'stream-player' in this file with the plugin's translation text domain
// 2. define plugin options, default settings, and setup arguments your main plugin file
// 3. require this file in the main plugin file and instantiate the loader class (see example below)
//
// ---------------
// Updating Loader
// ---------------
// Repeat Step 1 above with the new version of loader.php and replace in your plugin.
//
// -----------------------------------
// Example Plugin Options and Defaults
// -----------------------------------
// array of plugin option keys, with input types and defaults
// $options = array(
// 	'optionkey1'	=>	array(
//							'type' 		=> 'checkbox',
//							'default'	=> '1',
//							'value'		=> '1',
//						),
//	'optionkey2'	=>	array(
//							'type' 		=> 'radio',
//							'default'	=> 'on',
//							'options'	=> 'on/off',
//						),
//	'optionkey3'	=> array(
//							'type'		=> 'special',
//						),
// );

// -----------------------
// Example Plugin Settings
// -----------------------
// $slug = 'plugin-name';				// plugin slug (usually same as filename)
// $args = array(
//	// --- Plugin Info ---
//	'slug'			=> $slug,			// (uses slug above)
//	'file'			=> __FILE__,		// path to main plugin file (required!)
//	'version'		=> '0.0.1', 		// * rechecked later (pulled from plugin header) *
//
//	// --- Menus and Links ---
//	'title'			=> 'Plugin Name',	// plugin title
//	'parentmenu'	=> 'wordquest',		// parent menu slug
//	'home'			=> 'http://mysite.com/plugins/plugin/',
//	'support'		=> 'http://mysite.com/plugins/plugin/support/',
//	'ratetext'		=> __( 'Rate on WordPress.org', 'stream-player' ),		// (overrides default rate text)
//	'share'			=> 'http://mysites.com/plugins/plugin/#share', // (set sharing URL)
//	'sharetext'		=> __( 'Share the Plugin Love', 'stream-player' ),		// (overrides default sharing text)
//	'donate'		=> 'https://patreon.com/pagename',	// (overrides plugin Donate URI)
//	'donatetext'	=> __( 'Support this Plugin', 'stream-player' ),		// (overrides default donate text)
//	'readme'		=> false,			// to not link to popup readme in settings page header
//	'settingsmenu'	=> false,			// to not automatically add a settings menu [non-WQ]
//
//	// --- Options ---
//	'namespace'		=> 'PLUGIN_PREFIX',	// plugin namespace (function prefix, minus trailing _)
//	'settings'		=> 'pn',			// input settings prefix
//	'option'		=> 'plugin_key',	// plugin option key
//	'options'		=> $options,		// plugin options array set above
//
//	// --- WordPress.Org ---
//	'wporgslug'		=> 'plugin-slug',	// WordPress.org plugin slug
//	'wporg'			=> false, 			// * rechecked later (via presence of updatechecker.php) *
//	'textdomain'	=> 'plugin-domain',	// translation text domain (usually same as plugin slug)
//
//	// --- Freemius ---
//	'freemius_id'	=> '',				// Freemius plugin ID
//	'freemius_key'	=> '',				// Freemius public key
//	'hasplans'		=> false,			// if plugin has paid plans
//	'hasaddons'		=> false,			// if plugin has add ons
//	'plan'			=> 'free',	 		// * rechecked later (if premium version found) *
// );

// ------------------------------------
// Example Start Plugin Loader Instance
// ------------------------------------
// (add this to your main plugin file to run this loader)
// require(dirname(__FILE__).'/loader.php');				// requires this file!
// $instance = new stream_player_loader($args);				// instantiates loader class
// (ie. search and replace all 'stream_player_' with 'my_plugin_' function namespace)
// and then search and replace 'text-domain' with your plugin's text domain.


// ---------------------------------------------
// 1.3.7: Translated String Settings Update Note
// ---------------------------------------------
// Since loader is typically initiated directly within a plugin, this means string translations are "too early".
// A little bit of an annoying WordPress quirk to have to get around but it is achieved with the following steps:

// 1. Fix is to remove the translated strings (ratetext, sharetext, donatetext) to a later filter added for this purpose:
/*
add_filter( 'stream_player_admin_args', 'stream_player_settings_texts' );
function stream_player_settings_texts( $args ) {
	$texts = array(
		'sharetext'    => __( 'Share the Plugin Love', 'stream-player' ),
		'ratetext'     => __( 'Rate on WordPress.org', 'stream-player' ),
		'donatetext'   => __( 'Support this Plugin', 'stream-player' ),
	);
	$args = array_merge( $args, $texts );
	return $args;
} */

// 2. Instead of passing options directly to the loader, create a function with an admin argument.
// eg. function stream_player_get_options( $admin ) {}
// and translate any labels or helpers values conditionally using an inline if statement, ie. ? and :
// 'label' => __( 'Label Test', 'stream-player' ),
// becomes
// 'label' => $admin ? __( 'Label Test', 'stream-player' ) : '',

// 3. Then add a filter that runs after the main plugin loader is instantiated:
/* 
add_filter( 'stream_player_plugin_options', 'stream_player_get_options' );
add_action( 'plugins_loaded', 'stream_player_admin_options_init' );
function stream_player_admin_options_init() {
	add_filter( 'radio-station_options', 'stream_player_admin_options' );
	function stream_player_admin_options( $options ) {
		$admin = is_admin();
		$options = stream_player_get_options( $admin );
		return $options;
	}
}
*/


// ===========================
// --- Plugin Loader Class ---
// ===========================
// usage: change class prefix to the plugin function prefix
if ( !class_exists( 'stream_player_loader' ) ) {
	// phpcs:ignore PEAR.NamingConventions.ValidClassName.Invalid,PEAR.NamingConventions.ValidClassName.StartWithCapital
	class stream_player_loader {

		public $args = null;
		public $namespace = null;
		public $data = null;
		public $version = null;

		public $options = null;
		public $defaults = null;
		public $tabs = array();
		public $sections = array();
		public $scripts = array();

		// 1.1.2: added menu added switch
		// 1.1.2: added debug switch
		public $menu_added = false;
		public $debug = false;

		// -----------------
		// Initialize Loader
		// -----------------
		public function __construct( $args ) {

			if ( !is_array( $args ) ) {
				return;
			}

			// --- set debug switch ---
			// 1.1.2: added debug switch check
			$prefix = '';
			if ( $args['settings'] ) {
				// 1.1.4: fix to debug prefix key
				$prefix = $args['settings'] . '-';
			}
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( isset( $_REQUEST[$prefix . 'debug'] ) ) {
				// 1.2.5: use sanitize_text_field on request variable
				// phpcs:ignore WordPress.Security.NonceVerification.Recommended
				if ( in_array( sanitize_text_field( $_REQUEST[$prefix . 'debug'] ), array( '1', 'yes' ) ) ) {
					$this->debug = true;
				}
			}

			// --- set plugin options ---
			// 1.0.6: added options filter
			// 1.3.8: fix to set class options on construct
			$args['options'] = apply_filters( $args['namespace'] . '_options', $args['options'] );
			$this->options = $args['options'];

			// --- set plugin args and namespace ---
			// 1.1.9: filter all arguments
			$args = apply_filters( $args['namespace'] . '_args', $args );
			$this->args = $args;
			$this->namespace = $args['namespace'];

			// --- setup plugin values ---
			$this->setup_plugin();

			// --- maybe transfer settings ---
			$this->maybe_transfer_settings();

			// --- load settings ---
			$this->load_settings();

			// --- load actions ---
			$this->add_actions();

			// --- load helper libraries ---
			$this->load_helpers();

			// --- autoset class instance global for accessibility ---
			$GLOBALS[$args['namespace'] . '_instance'] = $this;
		}

		// -------------
		// Admin Options
		// -------------
		// 1.3.7: added method for loading delayed translation strings
		function admin_options() {
			
			$namespace = $this->namespace;
			$args = $this->args;
			$args = apply_filters( $args['namespace'] . '_admin_args', $args );
			$this->args = $args;

			$options = $this->options;
			$options = apply_filters( $namespace . '_options', $options );

			// 1.0.9: maybe get tabs and sections from options array
			if ( isset( $options['tabs'] ) ) {
				$this->tabs = $options['tabs'];
				unset( $options['tabs'] );
			}
			if ( isset( $options['sections'] ) ) {
				$this->sections = $options['sections'];
				unset( $options['sections'] );
			}
			$this->options = $options;
		}

		// ------------
		// Setup Plugin
		// ------------
		public function setup_plugin() {

			$args = $this->args;
			$namespace = $this->namespace;

			// --- Read Plugin Header ---
			if ( !isset( $args['dir'] ) ) {
				$args['dir'] = dirname( $args['file'] );
			}
			// phpcs:ignore WordPress.WP.AlternativeFunctions
			$fh = fopen( $args['file'], 'r' );
			// phpcs:ignore WordPress.WP.AlternativeFunctions
			$data = fread( $fh, 2048 );
			$this->data = str_replace( "\r", "\n", $data );
			// phpcs:ignore WordPress.WP.AlternativeFunctions
			fclose( $fh );

			// --- Version ---
			$this->version = $args['version'] = $this->plugin_data( 'Version:' );

			// --- Title ---
			if ( !isset( $args['title'] ) ) {
				$args['title'] = $this->plugin_data( 'Plugin Name:' );
			}

			// --- Plugin Home ---
			if ( !isset( $args['home'] ) ) {
				$args['home'] = $this->plugin_data( 'Plugin URI:' );
			}

			// --- Author ---
			if ( !isset( $args['author'] ) ) {
				$args['author'] = $this->plugin_data( 'Author:' );
			}

			// --- Author URL ---
			if ( !isset( $args['author_url'] ) ) {
				$args['author_url'] = $this->plugin_data( 'Author URI:' );
			}

			// --- Pro Functions ---
			if ( !isset( $args['proslug'] ) ) {
				$proslug = $this->plugin_data( '@fs_premium_only' );
				// 1.3.0: check for pro slug string
				if ( is_string( $proslug ) ) {
					// 1.0.1: if more than one file, extract pro slug based on the first filename
					if ( !strstr( $proslug, ',' ) ) {
						$profiles = array( $proslug );
						$proslug = trim( $proslug );
					} else {
						$profiles = explode( ',', $proslug );
						$proslug = trim( $profiles[0] );
					}
					$args['proslug'] = substr( $proslug, 0, - 4 ); // strips .php extension
					$args['profiles'] = $profiles;
				}
			}

			// --- Update Loader Args ---
			$this->args = $args;
		}

		// ---------------
		// Get Plugin Data
		// ---------------
		public function plugin_data( $key ) {

			$data = $this->data;
			$value = null;
			$pos = strpos( $data, $key );
			if ( false !== $pos ) {
				$pos = $pos + strlen( $key ) + 1;
				$tmp = substr( $data, $pos );
				$pos = strpos( $tmp, "\n" );
				$value = trim( substr( $tmp, 0, $pos ) );
			}

			return $value;
		}

		// ------------------
		// Get Plugin Version
		// ------------------
		// 1.1.2: added get plugin version function
		public function plugin_version() {
			$args = $this->args;
			return $args['version'];
		}

		// -----------------
		// Set Pro Namespace
		// -----------------
		public function pro_namespace( $pronamespace ) {
			$this->args['pronamespace'] = $pronamespace;
		}


		// =======================
		// --- Plugin Settings ---
		// =======================

		// --------------------
		// Get Default Settings
		// --------------------
		public function default_settings( $dkey = false ) {

			// --- return defaults if already set ---
			$defaults = $this->defaults;
			if ( !is_null( $defaults ) ) {
				if ( $dkey && isset( $defaults[$dkey] ) ) {
					return $defaults[$dkey];
				}

				return $defaults;
			}

			// --- filter and store the plugin default settings ---
			// 1.1.2: fix to apply options filter
			$namespace = $this->namespace;
			$options = $this->options;
			$options = apply_filters( $namespace . '_plugin_options', $options );
			$defaults = array();
			foreach ( $options as $key => $values ) {
				// 1.0.9: set default to null if default value not set
				if ( isset( $values['default'] ) ) {
					$defaults[$key] = $values['default'];
				} else {
					$defaults[$key] = null;
				}
			}
			$defaults = apply_filters( $namespace . '_default_settings', $defaults );
			$this->defaults = $defaults;
			if ( $dkey && isset( $defaults[$dkey] ) ) {
				return $defaults[$dkey];
			}

			return $defaults;
		}

		// ------------
		// Add Settings
		// ------------
		public function add_settings() {

			// --- add the default plugin settings ---
			$args = $this->args;
			$defaults = $this->default_settings();
			$added = add_option( $args['option'], $defaults );

			// --- if newly added, make the defaults current settings ---
			if ( $added ) {
				$namespace = $this->namespace;
				foreach ( $defaults as $key => $value ) {
					$GLOBALS[$namespace][$key] = $value;
				}

				// --- record first installed version ---
				// 1.1.0: added record for tracking first install version
				add_option( $args['option'] . '_first_install', $args['version'] );
			}

			// 1.0.9: trigger add settings action
			// 1.2.1: fix to namespace typo (nsmespace)
			do_action( $args['namespace'] . '_add_settings', $args );
		}

		// -----------------------
		// Maybe Transfer Settings
		// -----------------------
		public function maybe_transfer_settings() {
			$namespace = $this->namespace;
			$funcname = $namespace . '_transfer_settings';

			// --- check for either function prefixed or class extended method ---
			if ( method_exists( $this, 'transfer_settings' ) ) {
				$this->transfer_settings();
			} elseif ( function_exists( $funcname ) ) {
				call_user_func( $funcname );
			}
		}

		// -----------------------
		// Get All Plugin Settings
		// -----------------------
		public function get_settings( $filter = true ) {
			$namespace = $this->namespace;
			$settings = $GLOBALS[$namespace];
			if ( $filter ) {
				// 1.0.8: only apply all settings filter if filter is true
				$settings = apply_filters( $namespace . '_settings', $settings );
				// 1.0.8: maybe apply all individual key value filters
				foreach ( $settings as $key => $value ) {
					$settings[$key] = apply_filters( $namespace . '_' . $key, $value );
				}
			}

			return $settings;
		}

		// ------------------
		// Get Plugin Setting
		// ------------------
		public function get_setting( $key, $filter = true ) {
			$args = $this->args;
			$namespace = $this->namespace;
			$settings = $GLOBALS[$namespace];
			$settings = apply_filters( $namespace . '_settings', $settings );

			// --- maybe strip settings prefix ---
			// 1.0.4: added for backwards compatibility
			if ( substr( $key, 0, strlen( $args['settings'] ) ) == $args['settings'] ) {
				$key = substr( $key, strlen( $args['settings'] ) + 1, strlen( $key ) );
			}

			// --- get plugin setting ---
			// 1.1.4: fix for weird isset failing glitch
			// if ( isset( $settings[$key] ) ) {
			if ( array_key_exists( $key, $settings ) ) {
				$value = $settings[$key];
			} else {
				$defaults = $this->default_settings();
				// 1.1.4: fix for weird isset failing glitch
				if ( array_key_exists( $key, $defaults ) ) {
					$value = $defaults[$key];
				} else {
					$value = null;
				}
			}
			if ( $filter ) {
				$value = apply_filters( $namespace . '_' . $key, $value );
			}

			return $value;
		}

		// ---------------------
		// Reset Plugin Settings
		// ---------------------
		public function reset_settings() {

			$args = $this->args;
			$namespace = $this->namespace;

			// --- check reset triggers ---
			// 1.0.2: fix to namespace key typo in isset check
			// 1.0.3: only use namespace not settings key
			// 1.0.9: check page is set and matches slug
			if ( !isset( $_REQUEST['page'] ) ) {
				return;
			}
			// 1.0.5: use sanitize_title on request variables
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) != $args['slug'] ) {
				return;
			}
			if ( !isset( $_POST[$args['namespace'] . '_update_settings'] ) ) {
				return;
			}
			// phpcs:ignore WordPress.Security.NonceVerification.Missing
			if ( 'reset' != sanitize_text_field( wp_unslash( $_POST[$args['namespace'] . '_update_settings'] ) ) ) {
				return;
			}

			// --- check reset permissions ---
			$capability = apply_filters( $args['namespace'] . '_manage_options_capability', 'manage_options' );
			if ( !current_user_can( $capability ) ) {
				return;
			}

			// --- verify nonce ---
			// $noncecheck = wp_verify_nonce( sanitize_text_field( $_POST['_wpnonce'] ), $args['slug'] . '_update_settings' );
			check_admin_referer( $args['slug'] . '_update_settings' );

			// --- reset plugin settings ---
			$defaults = $this->default_settings();
			$defaults['savetime'] = time();
			update_option( $args['option'], $defaults );

			// --- loop to remerge with settings global ---
			foreach ( $defaults as $key => $value ) {
				$GLOBALS[$namespace][$key] = $value;
			}

			// --- set settings reset message flag ---
			$_GET['updated'] = 'reset';
		}

		// ----------------------
		// Update Plugin Settings
		// ----------------------
		public function update_settings() {

			$args = $this->args;
			$namespace = $this->namespace;
			$settings = $GLOBALS[$namespace];

			// --- check update triggers ---
			// 1.0.2: fix to namespace key typo in isset check
			// 1.0.3: only use namespace not settings key
			// 1.0.9: check page is set and matches slug
			if ( !isset( $_REQUEST['page'] ) || ( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) != $args['slug'] ) ) ) {
				return;
			}
			$updatekey = $args['namespace'] . '_update_settings';
			// phpcs:ignore WordPress.Security.NonceVerification.Missing
			if ( !isset( $_POST[$updatekey] ) || ( 'yes' != sanitize_text_field( wp_unslash( $_POST[$updatekey] ) ) ) ) {
				return;
			}

			// --- check update permissions ---
			$capability = apply_filters( $namespace . '_manage_options_capability', 'manage_options' );
			if ( !current_user_can( $capability ) ) {
				return;
			}

			// --- verify nonce ---
			// $noncecheck = wp_verify_nonce( sanitize_text_field( $_POST['_wpnonce'] ), $args['slug'] . '_update_settings' );
			check_admin_referer( $args['slug'] . '_update_settings' );

			// --- debug posted values ---
			// 	1.3.?: move debug output to after check_admin_referer
			$this->debug_posted( $settings );

			// --- get plugin options and default settings ---
			// 1.0.9: allow filtering of plugin options (eg. for Pro/Add Ons)
			$options = $this->options;
			$options = apply_filters( $namespace . '_options', $options );
			$defaults = $this->default_settings();

			// --- maybe use custom method or function ---
			$funcname = $namespace . '_process_settings';
			if ( method_exists( $this, 'process_settings' ) ) {

				// --- use class extended method if found ---
				$settings = $this->process_settings();

			} elseif ( function_exists( $funcname ) && is_callable( $funcname ) ) {

				// --- use namespace prefixed function if found ---
				$settings = call_user_func( $funcname );

			} else {

				// --- loop plugin options to get new settings ---
				foreach ( $options as $key => $values ) {

					// --- get option type and options ---
					if ( isset( $values['type'] ) ) {
						$type = $values['type'];
						$valid = $validate_args = array();
						if ( isset( $values['options'] ) ) {
							$valid = $values['options'];
						}

						// --- get posted value ---
						// 1.0.6: set null value for unchecked checkbox fix
						// 1.2.5: moved get posted value to within each type with sanitization
						$postkey = $args['settings'] . '_' . $key;
						$newsettings = null;

						// --- maybe validate special options ---
						// 1.0.9: check for special options to prepare
						if ( is_string( $valid ) ) {

							// --- maybe get public post type slugs ---
							if ( in_array( $valid, array( 'PUBLICTYPE', 'PUBLICTYPES' ) ) ) {
								$valid = array();
								if ( !isset( $public ) ) {
									$cpts = array( 'page', 'post' );
									$cptargs = array( 'public' => true, '_builtin' => false );
									$cptlist = get_post_types( $cptargs, 'names', 'and' );
									$public = array_merge( $cpts, $cptlist );
								}
								foreach ( $public as $cpt ) {
									$valid[$cpt] = '';
								}
							}

							// --- maybe get post type slugs ---
							if ( in_array( $valid, array( 'POSTTYPE', 'POSTTYPES' ) ) ) {
								$valid = array();
								if ( !isset( $cpts ) ) {
									$cpts = array( 'page', 'post' );
									$cptargs = array( 'public' => true, '_builtin' => false );
									$cptlist = get_post_types( $cptargs, 'names', 'and' );
									$cpts = array_merge( $cpts, $cptlist );
								}
								foreach ( $cpts as $cpt ) {
									$valid[$cpt] = '';
								}
							}

							// --- maybe get all post type slugs ---
							if ( in_array( $valid, array( 'ALLTYPE', 'ALLTYPES' ) ) ) {
								$valid = array();
								if ( !isset( $allcpts ) ) {
									$cptargs = array( '_builtin' => false );
									$allcpts = get_post_types( $cptargs, 'names', 'and' );
								}
								foreach ( $allcpts as $cpt ) {
									$valid[$cpt] = '';
								}
							}
						}

						if ( $this->debug ) {
							// phpcs:ignore WordPress.PHP.DevelopmentFunctions
							echo 'Saving Setting Key ' . esc_html( $key ) . ' (' . esc_html( $postkey ) . ')<br>' . "\n";
							// phpcs:ignore WordPress.PHP.DevelopmentFunctions
							echo 'Type: ' . esc_html( $type ) . ' - Valid Options ' . esc_html( $key ) . ': ' . esc_html( print_r( $valid, true ) ) . '<br>' . "\n";
						}

						// --- sanitize value according to type ---
						if ( strstr( $type, '/' ) ) {

							// --- implicit radio / select ---
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							$valid = explode( '/', $type );
							if ( in_array( $posted, $valid ) ) {
								$settings[$key] = $posted;
							}

						} elseif ( ( 'checkbox' == $type ) || ( 'toggle' == $type ) ) {

							// --- checkbox / toggle ---
							// 1.0.6: fix to new unchecked checkbox value
							// 1.0.9: maybe validate to specified checkbox value
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( isset( $values['value'] ) ) {
								$valid = array( $values['value'] );
							} else {
								$valid = array( 'yes', '1', 'checked', 'on' );
							}
							if ( in_array( $posted, $valid ) ) {
								$settings[$key] = $posted;
							} elseif ( is_null( $posted ) ) {
								$settings[$key] = '';
							}

						} elseif ( 'textarea' == $type ) {

							// --- text area ---
							// 1.2.5: use sanitize_textarea_field with stripslashes
							$posted = isset( $_POST[$postkey] ) ? sanitize_textarea_field( wp_unslash( $_POST[$postkey] ) ) : null;
							// 1.3.0: move use of stripslashes to separate line
							if ( !is_null( $posted ) ) {
								$posted = stripslashes( $posted );
							}
							$settings[$key] = $posted;

						} elseif ( 'text' == $type ) {

							// --- text field (slug) ---
							// 1.0.9: move text field sanitization to validation
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( !is_string( $valid ) ) {
								$valid = 'TEXT';
							}
							$newsettings = $posted;

						} elseif ( 'email' == $type ) {

							// --- email field ---
							// 1.3.0: added explicitly for email field type
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( !is_string( $valid ) ) {
								$valid = 'EMAIL';
							}
							$newsettings = $posted;

						} elseif ( ( 'number' == $type ) || ( 'numeric' == $type ) ) {

							// --- number field value ---
							// 1.0.9: added support for number step, minimum and maximum
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							$newsettings = $posted;
							$valid = 'NUMERIC';
							if ( isset( $values['step'] ) ) {
								$validate_args['step'] = $values['step'];
							}
							if ( isset( $values['min'] ) ) {
								$validate_args['min'] = $values['min'];
							}
							if ( isset( $values['max'] ) ) {
								$validate_args['max'] = $values['max'];
							}

						} elseif ( 'multicheck' == $type ) {

							// --- process multicheck boxes ---
							// 1.0.9: added multicheck input type
							// note: needs defined options (but works with post types)
							$posted = array();
							foreach ( $valid as $option => $label ) {
								$optionkey = $args['settings'] . '_' . $key . '-' . $option;
								if ( isset( $_POST[$optionkey] ) ) {
									// 1.1.2: check for value if specified
									// 1.2.5: apply sanitize_text_field to posted value
									if ( ( isset( $values['value'] ) && ( sanitize_text_field( wp_unslash( $_POST[$optionkey] ) ) == $values['value'] ) )
										|| ( !isset( $values['value'] ) && ( 'yes' == sanitize_text_field( wp_unslash( $_POST[$optionkey] ) ) ) ) ) {
										// 1.1.0: fixed to save only array of key values
										$posted[] = $option;
									}
								}
							}
							$settings[$key] = $posted;

						} elseif ( 'csv' == $type ) {

							// -- comma separated values ---
							// 1.0.4: added comma separated values option
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( strstr( $posted, ',' ) ) {
								$posted = explode( ',', $posted );
							} else {
								// 1.2.8: fix to convert string to array
								$posted = array( $posted );
							}
							foreach ( $posted as $i => $value ) {
								$posted[$i] = trim( $value );
							}
							if ( is_string( $valid ) ) {
								$newsettings = $posted;
							} elseif ( is_array( $valid ) && ( count( $valid ) > 0 ) ) {
								// 1.2.0: fix to check for empty valid array
								foreach ( $posted as $i => $value ) {
									if ( !in_array( $value, $valid ) ) {
										unset( $posted[$i] );
									}
								}
								$settings[$key] = implode( ',', $posted );
							} else {
								$settings[$key] = implode( ',', $posted );
							}

						} elseif ( ( 'radio' == $type ) || ( 'select' == $type ) ) {

							// --- explicit radio or select value ---
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( is_string( $valid ) ) {
								$newsettings = $posted;
							} elseif ( is_array( $valid ) && array_key_exists( $posted, $valid ) ) {
								$settings[$key] = $posted;
							}

						} elseif ( 'multiselect' == $type ) {

							// --- multiselect values ---
							// 1.0.9: added multiselect value saving
							$posted = isset( $_POST[$postkey] ) ? array_map( 'sanitize_text_field', wp_unslash( $_POST[$postkey] ) ) : array();
							$newsettings = array_values( $posted );

						} elseif ( 'image' == $type ) {

							// --- check attachment ID value ---
							// 1.1.7: add image attachment ID saving
							$posted = isset( $_POST[$postkey] ) ? absint( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( $posted ) {
								$attachment = wp_get_attachment_image_src( $posted, 'full' );
								if ( is_array( $attachment ) ) {
									$settings[$key] = $posted;
								}
							}

						} elseif ( 'color' == $type ) {

							// --- hex color setting ---
							// 1.1.7: added color picker value saving
							// 1.2.5: use sanitize_hex_color on color field
							$posted = isset( $_POST[$postkey] ) ? sanitize_hex_color( wp_unslash( $_POST[$postkey] ) ) : null;
							$settings[$key] = $posted;

						} elseif ( 'coloralpha' == $type ) {

							// --- color alpha setting ---
							// 1.2.5: separated color alpha setting condition
							// 1.2.5: added rgba version of sanitization
							// ref: https://wordpress.stackexchange.com/a/262578/76440
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( !is_null( $posted ) ) {
								$posted = str_replace( ' ', '', $posted );
								$values = array();
								// 1.2.7: fix color variable to posted
								// 1.2.7: make alpha a value key not separate
								// 1.2.7: check number of commas to see if alpha is set
								$commas = substr_count( $posted, ',' );
								if ( 3 == $commas ) {
									sscanf( $posted, 'rgba(%d,%d,%d,%f)', $values['red'], $values['green'], $values['blue'], $values['alpha'] );
								} elseif ( 2 == $commas ) {
									// 1.2.8: remove a from rgba (failing for non-alpha selections)
									sscanf( $posted, 'rgb(%d,%d,%d)', $values['red'], $values['green'], $values['blue'] );
								}
								// echo 'rgba sscanf values: ' . print_r( $values, true ) . "\n";
								// 1.2.7: fix for use of duplicate key variable
								foreach ( $values as $k => $v ) {
									if ( 'alpha' != $k ) {
										// --- sanitize rgb values ---
										$v = absint( $v );
										if ( $v < 0 ) {
											$values[$k] = 0;
										} elseif ( $v > 255 ) {
											$values[$k] = 255;
										}
									} else {
										// --- sanitize alpha value ---
										if ( $v < 0 ) {
											$values['alpha'] = 0;
										} elseif ( $v > 1 ) {
											$values['alpha'] = 1;
										}
									}
								}
								if ( 3 == $commas ) {
									$posted = 'rgba(' . $values['red'] . ',' . $values['green'] . ',' . $values['blue'] . ',' . $values['alpha'] . ')';
								} elseif ( 2 == $commas ) {
									// 1.2.8: remove a from rgba (for non-alpha selections)
									$posted = 'rgb(' . $values['red'] . ',' . $values['green'] . ',' . $values['blue'] . ')';
								}
							}
							$settings[$key] = $posted;

						} else {
							
							// --- fallback to text type ---
							// 1.3.0: added for unspecified option field type
							$posted = isset( $_POST[$postkey] ) ? sanitize_text_field( wp_unslash( $_POST[$postkey] ) ) : null;
							if ( !is_string( $valid ) ) {
								$valid = 'TEXT';
							}
							$newsettings = $posted;						
							
						}

						if ( $this->debug ) {
							echo 'New Settings for Key ' . esc_html( $key ) . ': ';
							// 1.2.0: added isset check for newsetting
							if ( !is_null( $newsettings ) ) {
								// phpcs:ignore WordPress.PHP.DevelopmentFunctions
								echo '(To-validate) ' . esc_html( print_r( $newsettings, true ) ) . '<br>' . "\n";
							} else {
								// 1.1.7 handle if (new) key not set yet
								if ( isset( $settings[$key] ) ) {
									// phpcs:ignore WordPress.PHP.DevelopmentFunctions
									echo '(Validated) ' . esc_html( print_r( $settings[$key], true ) ) . '<br>' . "\n";
								} else {
									echo 'No setting yet for key ' . esc_html( $key ) . '<br>' . "\n";
								}
							}
						}

						// --- maybe validate new settings ---
						// 1.1.9: fix to allow saving of zero value
						// 1.2.1: fix to allow saving of empty value
						if ( !is_null( $newsettings ) ) {
							if ( is_array( $newsettings ) ) {

								// --- validate array of settings ---
								// 1.1.9: fix to allow saving of zero value
								// 1.2.1: fix to allow saving of empty value
								foreach ( $newsettings as $newkey => $newvalue ) {
									$newsetting = $this->validate_setting( $newvalue, $valid, $validate_args );
									if ( $this->debug ) {
										echo 'Validated Setting array value ' . esc_html( $newvalue ) . ' to ' . esc_html( $newsetting );
									}
									if ( $newsetting || ( '' == $newsetting ) ) {
										$newsettings[$newkey] = $newsetting;
									} elseif ( ( 0 == $newsetting ) || ( '0' == $newsetting ) ) {
										$newsettings[$newkey] = $newsetting;
									} else {
										unset( $newsettings[$newkey] );
									}
								}
								if ( 'csv' == $type ) {
									$settings[$key] = implode( ',', $newsettings );
								} else {
									$settings[$key] = $newsettings;
								}

							} elseif ( $newsettings || ( '' == $newsettings ) || ( 0 === $newsettings ) || ( '0' === $newsettings ) ) {

								// --- validate single setting ---
								if ( 'csv' == $type ) {
									// 1.1.5: fix to validate each of multiple CSV values
									$values = explode( ',', $newsettings );
									$newvalues = array();
									foreach ( $values as $value ) {
										$newvalue = $this->validate_setting( $value, $valid, $validate_args );
										$newvalues[] = $newvalue;
										if ( $this->debug ) {
											echo 'Validated Setting value ' . esc_html( $value ) . ' to ' . esc_html( $newvalue ) . '<br>' . "\n";
										}
									}
									$newsettings = implode( ',', $newvalues );
									$settings[$key] = $newsettings;
								} else {
									$newsetting = $this->validate_setting( $newsettings, $valid, $validate_args );
									// 1.1.9: fix to allow saving of zero value
									// 1.2.1: fix to allow saving of empty value
									if ( $this->debug ) {
										echo 'Validated Setting single value ' . esc_html( $newsettings ) . ' to ' . esc_html( $newsetting ) . '<br>' . "\n";
									}
									if ( $newsetting || ( '' == $newsetting ) || ( 0 == $newsetting ) || ( '0' == $newsetting ) ) {
										$settings[$key] = $newsetting;
									}
								}
							}

							if ( $this->debug ) {
								// phpcs:ignore WordPress.PHP.DevelopmentFunctions
								echo 'Valid Options for Key ' . esc_html( $key ) . ': ' . esc_html( print_r( $valid, true ) ) . '<br>' . "\n";
								// phpcs:ignore WordPress.PHP.DevelopmentFunctions
								echo 'Validated Settings for Key ' . esc_html( $key ) . ': ' . esc_html( print_r( $settings[$key], true ) ) . '<br>' . "\n";
							}
						}
					}
				}
			}

			// --- process special settings ---
			// 1.0.2: added for processing special settings separately
			$funcname = $namespace . '_process_special';
			if ( method_exists( $this, 'process_special' ) ) {

				// --- use class extended method if found ---
				$settings = $this->process_special( $settings );

			} elseif ( function_exists( $funcname ) && is_callable( $funcname ) ) {

				// --- use namespace prefixed function if found ---
				$settings = call_user_func( $funcname, $settings );
			}

			// --- output new settings ---
			if ( $this->debug ) {
				echo '<br><b>All New Settings:</b><br>';
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions
				echo esc_html( print_r( $settings, true ) );
				echo '<br><br>';
			}

			if ( $settings && is_array( $settings ) ) {

				// --- loop default keys to remove others ---
				$settings_keys = array_keys( $defaults );
				foreach ( $settings as $key => $value ) {
					if ( !in_array( $key, $settings_keys ) ) {
						unset( $settings[$key] );
					}
				}

				// --- save settings tab ---
				// 1.2.0: validate and save current settings tab
				if ( isset( $_POST['settingstab'] ) ) {
					$tabs = array();
					foreach ( $options as $key => $option ) {
						if ( isset( $option['tab'] ) && !in_array( $option['tab'], $tabs ) ) {
							$tabs[] = $option['tab'];
						}
					}
					if ( count( $tabs ) > 0 ) {
						// 1.2.5: sanitize current tab value before validating
						$currenttab = sanitize_text_field( wp_unslash( $_POST['settingstab'] ) );
						if ( in_array( $currenttab, $tabs ) ) {
							$settings['settingstab'] = $currenttab;
						} elseif ( in_array( 'general', $tabs ) ) {
							$settings['settingstab'] = 'general';
						} else {
							$settings['settingstab'] = $tabs[0];
						}
					}
				}

				// --- update the plugin settings ---
				$settings['savetime'] = time();
				update_option( $args['option'], $settings );

				// --- merge with existing settings for pageload ---
				foreach ( $settings as $key => $value ) {
					$GLOBALS[$namespace][$key] = $value;
				}

				// --- set settings update message flag ---
				$_GET['updated'] = 'yes';

			} else {
				$_GET['updated'] = 'no';
			}

			// --- maybe trigger update of Pro settings ---
			if ( method_exists( $this, 'pro_update_settings' ) ) {
				$this->pro_update_settings();
			} else {
				if ( isset( $args['pronamespace'] ) ) {
					$funcname = $args['pronamespace'] . '_update_settings';
				} else {
					$funcname = $args['namespace'] . '_pro_update_settings';
				}
				if ( function_exists( $funcname ) ) {
					call_user_func( $funcname );
				}
			}

		}

		// --------------------------
		// Debug Output Posted Values
		// --------------------------
		function debug_posted( $settings ) {
			if ( $this->debug ) {
				echo '<br><b>Current Settings:</b><br>';
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions
				echo esc_html( print_r( $settings, true ) );
				echo '<br><br>' . "\n";

				echo '<br><b>Plugin Options:</b><br>';
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions
				echo esc_html( print_r( $this->options, true ) );
				echo '<br><br>' . "\n";

				// phpcs:ignore WordPress.Security.NonceVerification.Missing
				if ( isset( $_POST ) ) {
					echo '<br><b>Posted Values:</b><br>';
					// phpcs:ignore WordPress.Security.NonceVerification.Missing
					$post_keys = array_keys( $_POST );
					foreach ( $post_keys as $post_key ) {
						$post_key = sanitize_text_field( $post_key );
						$value = sanitize_text_field( $_POST[$post_key] );
						// phpcs:ignore WordPress.PHP.DevelopmentFunctions
						echo esc_html( $post_key ) . ': ' . esc_html( print_r( $value, true ) ) . '<br>' . "\n";
					}
				}
			}
		}
			
		// -----------------------
		// Validate Plugin Setting
		// -----------------------
		// 1.1.5: plural options now use extra validation
		public function validate_setting( $posted, $valid, $args ) {

			// --- allow for clearing of a field ---
			// note: array values are cleared if empty, single values are set empty
			if ( trim( $posted ) == '' ) {
				return '';
			}

			// --- validate different data types ---
			if ( 'TEXT' == $valid ) {

				// --- sanitize text field ---
				$posted = sanitize_text_field( $posted );

				return $posted;

			} elseif ( 'ALPHABETIC' == $valid ) {

				// --- alphabetic ---
				// 1.0.9: added alphabetic-only for completeness
				$posted = trim( $posted );
				$checkposted = preg_match( '/^[a-zA-Z]+$/', $posted );
				if ( $checkposted ) {
					return $posted;
				}

			} elseif ( 'NUMERIC' == $valid ) {

				// --- number (numeric text) ---
				// note: step key is only used for controls, not for validation
				// 1.0.9: cast to integer - not absolute integer
				// TODO: validate step value match ?
				$posted = floatval( trim( $posted ) );
				if ( isset( $args['min'] ) && ( $posted < $args['min'] ) ) {
					return $args['min'];
				} elseif ( isset( $args['max'] ) && ( $posted > $args['max'] ) ) {
					return $args['max'];
				} elseif ( 0 === $posted ) {
					return 0;
				}

				return $posted;

			} elseif ( 'ALPHANUMERIC' == $valid ) {

				// --- alphanumeric text only ---
				$posted = trim( $posted );
				// TODO: maybe remove underscore from validation regex ?
				$checkposted = preg_match( '/^[a-zA-Z0-9_]+$/', $posted );
				if ( $checkposted ) {
					return $posted;
				}

			} elseif ( 'PHONE' == $valid ) {

				// --- phone number characters only ---
				$posted = trim( $posted );
				// $checkposted = preg_match( '/^[0-9+\(\)#\.\s\-]+$/', $posted );
				// if ( $checkposted ) {
				//	return $posted;
				// }
				if ( strlen( $posted ) > 0 ) {
					$posted = str_split( $posted, 1 );
					$posted = preg_filter( '/^[0-9+\(\)#\.\s\-]+$/', '$0', $posted );
					if ( count( $posted ) > 0 ) {
						$posted = implode( '', $posted );
						return $posted;
					} else {
						return '';
					}
				}

			} elseif ( in_array( $valid, array( 'URL', 'URLS' ) ) ) {

				// --- URL address ---
				// 1.0.6: fix to type variable typo (vtype)
				// 1.0.4: added validated URL option
				// 1.0.6: fix to posted variable type (vposted)
				// 1.0.9: remove check for http prefix to allow other protocols
				// 1.1.7: use FILTER_SANITIZE_URL not FILTER_SANITIZE_STRING
				// 1.2.1: allow for clearing URL by saving empty value
				$posted = trim( $posted );
				if ( '' != $posted ) {
					$posted = filter_var( $posted, FILTER_SANITIZE_URL );
				}

				// 1.1.7: remove FILTER_VALIDATE_URL check - not working!?
				if ( $this->debug ) {
					$check = filter_var( $posted, FILTER_VALIDATE_URL );
					// phpcs:ignore WordPress.PHP.DevelopmentFunctions
					echo 'Validated URL: ' . esc_html( print_r( $check, true ) ) . '<br>';
				}
				// if ( !filter_var( $url, FILTER_VALIDATE_URL ) ) {
				//	$posted = '';
				// }
				return $posted;

			} elseif ( in_array( $valid, array( 'EMAIL', 'EMAILS' ) ) ) {

				// --- email address ---
				// 1.0.3: added email option type checking
				$email = sanitize_email( trim( $posted ) );
				if ( $email ) {
					$posted = $email;
				} else {
					$posted = '';
				}
				return $posted;

			} elseif ( in_array( $valid, array( 'USEREMAIL', 'USEREMAILS' ) ) ) {

				// --- email address with user validation ---
				// 1.1.5: added option for validated user emails
				$email = sanitize_email( trim( $posted ) );
				if ( !$email ) {
					return '';
				}
				$user = get_user_by( 'email', $email );
				if ( $user ) {
					// 1.2.3: fix to set email value
					$posted = $email;
				} else {
					$posted = '';
				}
				return $posted;

			} elseif ( 'USERNAME' == $valid ) {

				// --- username ---
				$username = sanitize_user( trim( $posted ) );
				if ( !$username ) {
					return '';
				}
				return $username;

			} elseif ( 'USERNAMES' == $valid ) {

				// --- username with check for existing user ---
				// 1.1.5: separated check from singular
				$username = sanitize_user( trim( $posted ) );
				if ( !$username ) {
					return '';
				}
				$user = get_user_by( 'login', $username );
				if ( $user ) {
					$posted = $username;
				} else {
					$posted = '';
				}
				return $posted;

			} elseif ( 'USERID' == $valid ) {

				// --- user ID ---
				$userid = intval( trim( $posted ) );
				if ( 0 === $userid ) {
					return '';
				}

			} elseif ( 'USERIDS' == $valid ) {

				// --- user ID with check for existing user ---
				// 1.1.5: separated check from singular
				$userid = intval( trim( $posted ) );
				if ( 0 === $userid ) {
					return '';
				}
				$user = get_user_by( 'ID', $userid );
				if ( $user ) {
					$posted = $userid;
				} else {
					$posted = '';
				}

				return $posted;

			} elseif ( in_array( $valid, array( 'SLUG', 'SLUGS' ) ) ) {

				// -- post slugs ---
				$posted = sanitize_title( trim( $posted ) );

				return $posted;

			} elseif ( in_array( $valid, array( 'PAGEID', 'POSTID' ) ) ) {

				$posted = intval( trim( $posted ) );
				if ( 0 === $posted ) {
					return '';
				}
				return $posted;

			} elseif ( in_array( $valid, array( 'PAGEIDS', 'POSTIDS' ) ) ) {

				$posted = intval( trim( $posted ) );
				if ( 0 === $posted ) {
					return '';
				}
				$post = get_post( $posted );
				if ( $post ) {
					return $posted;
				}
			}

			// TODO: return validation error ?
			return false;
		}

		// ---------------
		// Delete Settings
		// ---------------
		public function delete_settings() {

			// TODO: check for plugin settings flag to delete settings ?
			// $delete_settings = $this->get_setting( 'delete_settings' );
			// if ( $delete_settings ) {
			//	$args = $this->args;
			//	delete_option( $args['option'] );
			// }

			// TODO: check for plugin settings flag to delete data?
			// $delete_data = $this->get_setting( 'delete_data' );
			// if ( $delete_data ) {
			//	do_action( $this->namespace . '_delete_data' );
			// }
		}


		// ======================
		// --- Plugin Loading ---
		// ======================

		// --------------------
		// Load Plugin Settings
		// --------------------
		public function load_settings() {
			$args = $this->args;
			$namespace = $this->namespace;
			$GLOBALS[$namespace] = $args;
			$settings = get_option( $args['option'], false );
			if ( $settings && is_array( $settings ) ) {
				foreach ( $settings as $key => $value ) {
					$GLOBALS[$namespace][$key] = $value;
				}
			} else {
				$defaults = $this->default_settings();
				foreach ( $defaults as $key => $value ) {
					$GLOBALS[$namespace][$key] = $value;
				}
			}
		}

		// -----------
		// Add Actions
		// -----------
		public function add_actions() {

			$args = $this->args;
			$namespace = $this->namespace;

			// --- add settings on activation ---
			register_activation_hook( $args['file'], array( $this, 'add_settings' ) );

			// 1.3.7: added for admin options filtering
			add_action( 'init', array( $this, 'admin_options' ) );

			// --- always check for update and reset of settings ---
			add_action( 'admin_init', array( $this, 'update_settings' ) );
			add_action( 'admin_init', array( $this, 'reset_settings' ) );

			// --- add plugin submenu ---
			add_action( 'admin_menu', array( $this, 'settings_menu' ), 1 );

			// --- add plugin settings page link ---
			add_filter( 'plugin_action_links', array( $this, 'plugin_links' ), 10, 2 );

			// --- maybe delete settings on deactivation ---
			register_deactivation_hook( $args['file'], array( $this, 'delete_settings' ) );

			// --- maybe enqueue scripts / thickbox ---
			add_action( 'admin_enqueue_scripts', array( $this, 'maybe_load_thickbox' ) );
			// 1.3.4: add earlier enqueue settings page resources check
			add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_resources' ) );

			// --- AJAX readme viewer ---
			add_action( 'wp_ajax_' . $namespace . '_readme_viewer', array( $this, 'readme_viewer' ) );

			// --- load Freemius (requires PHP 5.4+) ---
			// 1.2.1: move Freemius loading to plugins_loaded hook
			if ( version_compare( PHP_VERSION, '5.4.0' ) >= 0 ) {
				add_action( 'plugins_loaded', array( $this, 'load_freemius' ), 5 );
			}
		}

		// ---------------------
		// Load Helper Libraries
		// ---------------------
		public function load_helpers() {

			$args = $this->args;
			$file = $args['file'];
			$dir = $args['dir'];

			// --- Plugin Slug ---
			if ( !isset( $args['slug'] ) ) {
				$args['slug'] = substr( $file, 0, - 4 );
				$this->args = $args;
			}

			// --- Pro Functions ---
			// 1.0.2: added prototype auto-loading of Pro file(s)
			// 1.2.1: fix overriding of plan arg to free
			// (to work with @fs_premium_only file list)
			if ( isset( $args['profiles'] ) && count( $args['profiles'] ) > 0 ) {
				$included = get_included_files();
				foreach ( $args['profiles'] as $profile ) {
					// --- chech for php extension ---
					if ( substr( '.php' == $profile, - 4, 4 ) ) {
						$filepath = $dir . '/' . $profile;
						if ( file_exists( $filepath ) ) {
							$plan = 'premium';
							// 1.0.9: add check if file already included
							if ( !in_array( $filepath, $included ) ) {
								include $filepath;
							}
						}
					}
				}
			}
			// 1.2.0: only change plan setting if premium files found
			if ( isset( $plan ) ) {
				$args['plan'] = $plan;
				$this->args = $args;
			}

			// --- Plugin Update Checker ---
			// note: lack of updatechecker.php file indicates WordPress.Org SVN repo version
			// presence of updatechecker.php indicates direct site download or GitHub version
			$wporg = true;
			$updatechecker = $dir . '/updatechecker.php';
			if ( file_exists( $updatechecker ) ) {
				$wporg = false;
				$slug = $args['slug'];
				// note: requires $file and $slug to be defined
				include $updatechecker;
			}
			$args['wporg'] = $wporg;
			$this->args = $args;

			// --- Trigger Loader Helpers Action ---
			// 1.0.9: added action for extra loader helpers (eg. WordQuest)
			do_action( $args['namespace'] . '_loader_helpers', $args );

			// --- load Freemius (requires PHP 5.4+) ---
			// 1.2.1: moved to plugins_loaded action hook

		}

		// -------------------
		// Maybe Load Thickbox
		// -------------------
		public function maybe_load_thickbox() {
			$args = $this->args;
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( isset( $_REQUEST['page'] ) && ( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) == $args['slug'] ) ) {
				add_thickbox();
			}
		}

		// ------------------
		// Readme Viewer AJAX
		// ------------------
		public function readme_viewer() {

			$args = $this->args;
			$dir = $args['dir'];

			echo '<html><body style="font-family: Consolas, \'Lucida Console\', Monaco, FreeMono, monospace;">';

			// 1.0.7: changed readme.php to reader.php (for Github)
			$readme = $dir . '/readme.txt';
			// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
			$contents = file_get_contents( $readme );
			$parser = $dir . '/reader.php';

			if ( file_exists( $parser ) ) {

				// --- include Markdown Readme Parser ---
				include $parser;

				// --- remove license lines as causing breakage! ---
				// 1.3.1: find license lines to handle other possible licenses
				// $contents = str_replace( 'License: GPLv2 or later', '', $contents );
				// $contents = str_replace( 'License URI: http://www.gnu.org/licenses/gpl-2.0.html', '', $contents );
				$strip_lines = array( 'License', 'License URI' );
				foreach( $strip_lines as $strip_line ) {
					if ( strstr( $contents, $strip_line ) ) {
						$pos = strpos( $contents, $strip_line . ':' );
						$chunks = str_split( $contents, $pos );
						$before = $chunks[0];
						unset( $chunks[0] );
						$remainder = implode( '', $chunks );
						$posb = strpos( $remainder, "\n" );
						$chunks = str_split( $remainder, $posb );
						unset( $chunks[0] );
						$remainder = implode( '', $chunks );
						$contents = $before . $remainder;
					}
				}

				// --- instantiate Parser class ---
				// 1.3.1: prefix readme parser
				$readme = new stream_player_readme_parser();
				$parsed = $readme->parse_readme_contents( $contents );

				// --- output plugin info ---
				echo '<b>' . esc_html( __( 'Plugin Name', 'stream-player' ) ) . '</b>: ' . esc_html( $parsed['name'] ) . '<br>' . "\n";
				// echo '<b>' . esc_html( __( 'Tags', 'stream-player' ) ) . '</b>: ' . esc_html( implode( ', ', $parsed['tags'] ) ) . '<br>' . "\n";
				echo '<b>' . esc_html( __( 'Requires at least', 'stream-player' ) ) . '</b>: ' . esc_html( __( 'WordPress', 'stream-player' ) ) . ' v' . esc_html( $parsed['requires_at_least'] ) . '<br>' . "\n";
				echo '<b>' . esc_html( __( 'Tested up to', 'stream-player' ) ) . '</b>: ' . esc_html( __( 'WordPress', 'stream-player' ) ) . ' v' . esc_html( $parsed['tested_up_to'] ) . '<br>' . "\n";
				if ( isset( $parsed['stable_tag'] ) ) {
					echo '<b>' . esc_html( __( 'Stable Tag', 'stream-player' ) ) . '</b>: ' . esc_html( $parsed['stable_tag'] ) . '<br>' . "\n";
				}
				echo '<b>' . esc_html( __( 'Contributors', 'stream-player' ) ) . '</b>: ' . esc_html( implode( ', ', $parsed['contributors'] ) ) . '<br>' . "\n";
				// echo '<b>Donate Link</b>: <a href="' . esc_url( $parsed['donate_link'] ) . '" target="_blank">' . esc_html( $parsed['donate_link'] ) . '</a><br>';
				// 1.2.5: use wp_kses_post on plugin short description markup
				echo '<br>' . wp_kses_post( $parsed['short_description'] ) . '<br><br>' . "\n";

				// --- output sections ---
				// possible sections: 'description', 'installation', 'frequently_asked_questions',
				// 'screenshots', 'changelog', 'change_log', 'upgrade_notice'
				$strip = array( 'installation', 'screenshots' );
				foreach ( $parsed['sections'] as $key => $section ) {
					if ( !empty( $section ) && !in_array( $key, $strip ) ) {
						if ( strstr( $key, '_' ) ) {
							$parts = explode( '_', $key );
						} else {
							$parts = array( $key );
						}
						foreach ( $parts as $i => $part ) {
							$parts[$i] = strtoupper( substr( $part, 0, 1 ) ) . substr( $part, 1 );
						}
						$title = implode( ' ', $parts );
						echo '<h3>' . esc_html( $title ) . '</h3>' . "\n";
						// 1.2.5: use wp_kses_post on readme section output
						echo wp_kses_post( $section );
					}
				}
				if ( isset( $parsed['remaining_content'] ) && !empty( $remaining_content ) ) {
					echo '<h3>' . esc_html( __( 'Extra Notes', 'stream-player' ) ) . '</h3>' . "\n";
					// 1.2.5: use wp_kses_post on readme extra notes output
					echo wp_kses_post( $parsed['remaining_content'] );
				}

			} else {
				// --- fallback text-only display ---
				$contents = str_replace( "\n", '<br>', $contents );
				echo wp_kses_post( $contents );
			}

			echo '</body></html>';
			exit;
		}


		// =======================
		// --- Freemius Loader ---
		// =======================
		//
		// required settings keys:
		// -----------------------
		// freemius_id	- plugin ID from Freemius plugin dashboard
		// freemius_key	- public key from Freemius plugin dashboard
		//
		// optional settings keys:
		// -----------------------
		// plan 		- (string) curent plugin plan (value of 'free' or 'premium')
		// hasplans		- (boolean) switch for whether plugin has premium plans
		// hasaddons	- (boolean) switch for whether plugin has premium addons
		// wporg		- (boolean) switch for whether free plugin is WordPress.org compliant
		// contact		- (boolean) submenu switch for plugin Contact (defaults to on for premium only)
		// support		- (boolean) submenu switch for plugin Support (default on)
		// account		- (boolean) submenu switch for plugin Account (default on)
		// parentmenu	- (string) optional slug for plugin parent menu
		//
		// okay lets do this...
		// ====================
		public function load_freemius() {

			// 1.2.1: no need to load if not in admin area
			// if ( !is_admin() ) {
			//	return;
			// }
			// echo '<span style="display:none;">Freemius Loading...</span>';

			$args = $this->args;
			$namespace = $this->namespace;

			// --- check for required Freemius keys ---
			if ( !isset( $args['freemius_id'] ) || !isset( $args['freemius_key'] ) ) {
				return;
			}

			// --- check for free / premium plan ---
			// convert plan string value of 'free' or 'premium' to boolean premium switch
			// TODO: check for active addons also ?
			$premium = false;
			if ( isset( $args['plan'] ) && ( 'premium' == $args['plan'] ) ) {
				$premium = true;
			} else {
				// 1.2.1: added filter for premium init
				$premium = apply_filters( 'freemius_init_premium_' . $args['namespace'], $premium );
			}

			// --- maybe redirect link to plugin support forum ---
			// TODO: change to use new Freemius 2.3.0 support link filter ?
			// 1.0.5: use sanitize_text_field on request variable
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( isset( $_REQUEST['page'] ) && ( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) == $args['slug'] . '-wp-support-forum' ) && is_admin() ) {
				// 1.0.7: fix support URL undefined variable warning
				if ( isset( $args['support'] ) ) {
					// 1.3.6: add action and bug out on redirect
					add_action( 'admin_init', array( $this, 'support_redirect' ) );
					return;
				}
			}

			// --- do the Freemius Loading boogie ---
			if ( !isset( $args['freemius'] ) ) {

				// --- start the Freemius SDK ---
				if ( !class_exists( 'Freemius' ) ) {
					$freemiuspath = dirname( __FILE__ ) . '/freemius/start.php';
					$freemiuspath = apply_filters( 'freemius_load_path', $freemiuspath, $namespace, $args );
					if ( !file_exists( $freemiuspath ) ) {
						return;
					}
					require_once $freemiuspath;
				}

				// --- set defaults for optional key values ---
				if ( !isset( $args['type'] ) ) {
					$args['type'] = 'plugin';
				}
				if ( !isset( $args['wporg'] ) ) {
					$args['wporg'] = false;
				}
				if ( !isset( $args['hasplans'] ) ) {
					$args['hasplans'] = false;
				}
				if ( !isset( $args['hasaddons'] ) ) {
					$args['hasaddons'] = false;
				}
				// 1.2.1: add filter for addons init
				$args['hasaddons'] = apply_filters( 'freemius_init_addons_' . $args['namespace'], $args['hasaddons'] );

				// --- set defaults for options submenu key values ---
				// 1.0.2: fix to isset check keys
				// 1.0.5: fix to set args subkeys for support and account
				if ( !isset( $args['support'] ) ) {
					$args['support'] = true;
				}
				if ( !isset( $args['account'] ) ) {
					$args['account'] = true;
				}
				// by default, enable contact submenu item for premium plugins only
				if ( !isset( $args['contact'] ) ) {
					$args['contact'] = $premium;
				}
				if ( !isset( $args['affiliation'] ) ) {
					// 1.3.1: fix to key typo (affiliaation)
					$args['affiliation'] = false;
				}

				// --- set Freemius settings from plugin settings ---
				// ref: https://freemius.com/help/documentation/wordpress-sdk/integrating-freemius-sdk/
				// 1.1.1: remove admin_url wrapper on Freemius first-path value
				// 1.3.0: added has_affiliation argument key
				// TODO: further possible args for Freemius init (eg. bundle_id)
				$first_path = add_query_arg( 'page', $args['slug'], 'admin.php' );
				$first_path = add_query_arg( 'welcome', 'true', $first_path );
				$settings = array(
					'type'             => $args['type'],
					'slug'             => $args['slug'],
					'id'               => $args['freemius_id'],
					'public_key'       => $args['freemius_key'],
					'has_addons'       => $args['hasaddons'],
					'has_paid_plans'   => $args['hasplans'],
					'is_org_compliant' => $args['wporg'],
					'is_premium'       => $premium,
					'has_affiliation'  => $args['affiliation'],
					'menu'             => array(
						'slug'       => $args['slug'],
						'first-path' => $first_path,
						'contact'    => $args['contact'],
						'support'    => $args['support'],
						'account'    => $args['account'],
					),
				);

				// --- maybe add plugin submenu to parent menu ---
				if ( isset( $args['parentmenu'] ) ) {
					$settings['menu']['parent'] = array( 'slug' => $args['parentmenu'] );
				}

				// --- filter settings before initializing ---
				$settings = apply_filters( 'freemius_init_settings_' . $args['namespace'], $settings );
				if ( $this->debug ) {
					// phpcs:ignore WordPress.PHP.DevelopmentFunctions
					echo '<span style="display:none;">Freemius Settings: ' . esc_html( print_r( $settings, true ) ) . '</span>' . "\n";
				}
				if ( !$settings || !is_array( $settings ) ) {
					return;
				}

				// --- initialize Freemius now ---
				$freemius = $GLOBALS[$namespace . '_freemius'] = fs_dynamic_init( $settings );

				// --- set plugin basename ---
				// 1.0.1: set free / premium plugin basename
				if ( method_exists( $freemius, 'set_basename' ) ) {
					$freemius->set_basename( $premium, $args['file'] );
				}

				// --- add Freemius connect message filter ---
				$this->freemius_connect();

				// --- Freemius Object Debug ---
				if ( $this->debug && current_user_can( 'manage_options' ) ) {
					// phpcs:ignore WordPress.PHP.DevelopmentFunctions
					echo '<span style="display:none;">Freemius Object: ' . esc_html( print_r( $freemius, true ) ) . '</span>' . "\n";
				}
				
				// --- fire Freemius loaded action ---
				do_action( $args['namespace'] . '_loaded' );
			}
		}

		// -----------------------
		// Filter Freemius Connect
		// -----------------------
		public function freemius_connect() {
			$namespace = $this->args['namespace'];
			$freemius = $GLOBALS[$namespace . '_freemius'];
			if ( isset( $settings['freemius'] ) && is_object( $freemius ) && method_exists( $freemius, 'add_filter' ) ) {
				$freemius->add_filter( 'connect_message', array( $this, 'freemius_connect_message' ), WP_FS__DEFAULT_PRIORITY, 6 );
			}
		}

		// ----------------
		// Support Redirect
		// ----------------
		// 1.3.6: enqueued on admin_init for slightly later execution
		function support_redirect() {
		
			$args = $this->args;
			$support_url = $args['support'];

			// changes the support forum slug for premium based on the pro plugin file slug
			// 1.2.1: removed in favour of filtering via Pro
			// if ( $premium && isset( $args['proslug'] ) ) {
			// 	$support_url = str_replace( $args['slug'], $args['proslug'], $support_url );
			// }
			$support_url = apply_filters( 'freemius_plugin_support_url_redirect', $support_url, $args['slug'] );

			// 1.3.6: removed conditional include of pluggable (no longer necessary)
			// phpcs:ignore WordPress.Security.SafeRedirect
			wp_redirect( $support_url );
			exit;
		}

		// ------------------------
		// Freemius Connect Message
		// ------------------------
		public function freemius_connect_message( $message, $user_first_name, $plugin_title, $user_login, $site_link, $freemius_link ) {
			// default: 'Never miss an important update - opt-in to our security and feature updates notifications, and non-sensitive diagnostic tracking with %4$s.'
			// 1.0.9: fix to remove incorrect first argument in string replacement
			$message = __fs( 'hey-x' ) . '<br>';
			// 1.2.4: added ordering to replacement arguments
			$message .= sprintf(
				// Translators: plugin title, user name, site link, freemius link
				__( 'If you want to more easily access support and feedback for this plugins features and functionality, %1$s can connect your user, %2$s at %3$s, to %4$s', 'stream-player' ),
				'<b>' . $plugin_title . '</b>',
				'<b>' . $user_login . '</b>',
				$site_link,
				$freemius_link
			);

			return $message;
		}

		// ----------------------
		// Connect Update Message
		// ----------------------
		// TODO: message for connect updates
		public function freemius_update_message( $message, $user_first_name, $plugin_title, $user_login, $site_link, $freemius_link ) {
			// default: 'Please help us improve %1$s! If you opt-in, some data about your usage of %1$s will be sent to %4$s. If you skip this, that\'s okay! %1$s will still work just fine.'
			// $message = freemius_message( $message, $user_first_name, $plugin_title, $user_login, $site_link, $freemius_link );
			// TODO: check if message needs return here ?
			return $message;
		}


		// ====================
		// --- Plugin Admin ---
		// ====================

		// --------------------------------
		// Enequeue Settings Page Resources
		// --------------------------------
		// 1.3.4: added enqueue resources function
		public function enqueue_resources() {
			
			$args = $this->args;
			$namespace = $this->namespace;

			if ( isset( $_REQUEST['page'] ) && ( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) == $args['slug'] ) ) {

				// --- get plugin options and default settings ---
				// 1.1.2: fix for filtering of plugin options
				$options = $this->options;
				$options = apply_filters( $namespace . '_plugin_options', $options );

				// --- maybe enqueue media scripts ---
				// 1.1.7: added media gallery script enqueueing for image field
				// 1.1.7: added color picker and color picker alpha script enqueueing
				$enqueued_media = $enqueued_color_picker = $enqueue_color_picker = $enqueue_color_picker_alpha = false;
				foreach ( $options as $option ) {
					if ( isset( $option['type'] ) ) {
						if ( ( 'image' == $option['type'] ) && !$enqueued_media ) {
							wp_enqueue_media();
							$enqueued_media = true;
						} elseif ( 'color' == $option['type'] ) { 
							$enqueue_color_picker = true;
						} elseif ( 'coloralpha' == $option['type'] ) {
							$enqueue_color_picker_alpha = true;
						}
					}
				}

				// 1.2.5: moved out of 
				if ( $enqueue_color_picker_alpha ) {
					wp_enqueue_style( 'wp-color-picker' );
					$suffix = '.min';
					if ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) {
						$suffix = '';
					}
					$url = plugins_url( '/js/wp-color-picker-alpha' . $suffix . '.js', $args['file'] );
					wp_enqueue_script( 'wp-color-picker-a', $url, array( 'wp-color-picker' ), '3.0.0', true );
					$enqueued_color_picker = true;
				} elseif ( $enqueue_color_picker ) {
					wp_enqueue_style( 'wp-color-picker' );
					wp_enqueue_script( 'wp-color-picker' );
					$enqueued_color_picker = true;			
				}

				// --- enqueue print of settings scripts / styles ---
				$this->settings_resources( $enqueued_media, $enqueued_color_picker );
			}
		}

		// -----------------
		// Add Settings Menu
		// -----------------
		public function settings_menu() {

			$args = $this->args;
			$namespace = $this->namespace;
			$settings = $GLOBALS[$namespace];

			// --- filter capability ---
			$args['capability'] = apply_filters( $args['namespace'] . '_manage_options_capability', 'manage_options' );
			if ( !isset( $args['pagetitle'] ) ) {
				$args['pagetitle'] = $args['title'];
			}
			if ( !isset( $args['menutitle'] ) ) {
				$args['menutitle'] = $args['title'];
			}
			// 1.1.9: added filters for page and menu titles
			$pagetitle = apply_filters( $namespace . '_settings_page_title', $args['pagetitle'] );
			$menutitle = apply_filters( $namespace . '_settings_menu_title', $args['menutitle'] );

			// --- trigger filter plugin menu action ---
			// (can hook into this to add an admin menu manually using the provided loader args)
			// return true from filter function to not add a submenu item in admin Settings menu
			// 1.0.8: change from function exists check
			// 1.0.9: change to filter usage to check if menu is manually added
			$menu_added = apply_filters( $args['namespace'] . '_admin_menu_added', false, $args );

			// 1.1.1: record to admin menu added switch
			$this->menu_added = $menu_added;

			// --- maybe auto-add standalone options page ---
			if ( !$menu_added ) {
				// 1.0.8: check settingsmenu switch that disables automatic settings menu adding
				if ( !isset( $args['settingsmenu'] ) || ( false !== $args['settingsmenu'] ) ) {
					// 1.3.0: use filtered pagetitle and menutitle
					add_options_page( $pagetitle, $menutitle, $args['capability'], $args['slug'], $args['namespace'] . '_settings_page' );
				}
			}

			// 1.1.0: add admin notices boxer
			add_action( 'all_admin_notices', array( $this, 'notice_boxer' ), 999 );
		}

		// -----------------
		// Plugin Page Links
		// -----------------
		// 1.2.2: merge in plugin links instead of using array_unshift
		public function plugin_links( $links, $file ) {

			$args = $this->args;
			if ( plugin_basename( $args['file'] ) == $file ) {

				// --- add settings link ---
				// 1.1.1: fix to settings page link URL
				// (depending on whether top level menu or Settings submenu item)
				$page = $this->menu_added ? 'admin.php' : 'options-general.php';
				$settings_url = add_query_arg( 'page', $args['slug'], admin_url( $page ) );
				$settings_link = '<a href="' . esc_url( $settings_url ) . '">' . esc_html( __( 'Settings', 'stream-player' ) ) . '</a>';
				$link = array( 'settings' => $settings_link );
				$links = array_merge( $link, $links );

				// --- maybe add Pro upgrade link ---
				if ( isset( $args['hasplans'] ) && $args['hasplans'] ) {

					// 1.2.1: add check if premium is already installed
					if ( !isset( $args['plan'] ) || ( 'premium' != $args['plan'] ) ) {

						// -- internal upgrade link ---
						if ( isset( $args['upgrade_link'] ) ) {
							$upgrade_url = $args['upgrade_link'];
							$upgrade_target = '';
						} else {
							$upgrade_url = add_query_arg( 'page', $args['slug'] . '-pricing', admin_url( 'admin.php' ) );
							$upgrade_target = !strstr( $upgrade_url, '/wp-admin/' ) ? ' target="_blank"' : '';
						}
						$upgrade_link = '<b><a href="' . esc_url( $upgrade_url ) . '"' . $upgrade_target . ">" . esc_html( __( 'Upgrade', 'stream-player' ) ) . '</a></b>';
						$link = array( 'upgrade' => $upgrade_link );
						$links = array_merge( $link, $links );

						// --- external pro link ---
						// 1.2.0: added separate pro details link
						if ( isset( $args['pro_link'] ) ) {
							$pro_target = !strstr( $args['pro_link'], '/wp-admin/' ) ? ' target="_blank"' : '';
							$pro_link = '<b><a href="' . esc_url( $args['pro_link'] ) . '"' . $pro_target . '>' . esc_html( __( 'Pro Details', 'stream-player' ) ) . '</a></b>';
							$link = array( 'pro-details' => $pro_link );
							$links = array_merge( $link, $links );
						}
					}
				}

				// --- maybe add Addons link ---
				// 1.2.0: activated add-ons link
				// 1.2.2: remove duplication of addons link
				if ( !isset( $args['hasaddons'] ) || !$args['hasaddons'] ) {
					if ( isset( $args['addons_link'] ) ) {
						$addons_url = $args['addons_link'];
						$addons_target = !strstr( $addons_url, '/wp-admin/' ) ? ' target="_blank"' : '';
						$addons_link = '<a href="' . esc_url( $addons_url ) . '"' . $addons_target . '>' . esc_html( __( 'Add Ons', 'stream-player' ) ) . '</a>';
						$link = array( 'addons' => $addons_link );
						$links = array_merge( $link, $links );
					}
				}

				if ( $this->debug ) {
					// phpcs:ignore WordPress.PHP.DevelopmentFunctions
					echo '<span style="display:none;">Plugin Links for ' . esc_html( $file ) . ': ' . esc_html( print_r( $links, true ) ) . '</span>' . "\n";
				}
			}

			return $links;
		}

		// -----------
		// Message Box
		// -----------
		// 1.2.5: use output buffering for no-echo
		public function message_box( $message, $echo ) {

			if ( !$echo ) {
				ob_start();
			}

			echo '<table style="background-color: lightYellow; border-style:solid; border-width:1px; border-color: #E6DB55; text-align:center;">' . "\n";
				echo '<tr><td>' . "\n";
					echo '<div class="message" style="margin:0.25em; font-weight:bold;">' . "\n";
						// 1.2.5: added wp_kses_post to message output
						echo wp_kses_post( $message ) . "\n";
					echo '</div>' . "\n";
				echo '</td></tr>' . "\n";
			echo '</table>' . "\n";
			if ( !$echo ) {
				$box = ob_get_contents();
				ob_end_clean();
				return $box;
			}
		}

		// ------------
		// Notice Boxer
		// ------------
		// 1.1.0: added admin notices boxer to settings pages
		public function notice_boxer() {

			$args = $this->args;

			// --- bug out if not on radio station pages ---
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( !isset( $_REQUEST['page'] ) ) {
				return;
			}
			// 1.0.5: use sanitize_title on request variable
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( substr( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ), 0, strlen( $args['slug'] ) ) != $args['slug'] ) {
				return;
			}

			// 1.2.2: bug out if adminsanity notices are loaded
			if ( isset( $GLOBALS['stream_player_data']['load']['notices'] ) && $GLOBALS['stream_player_data']['load']['notices'] ) {
				return;
			}

			// --- output notice box ---
			echo '<div style="width: 98%;" id="admin-notices-box" class="postbox">' . "\n";
			echo '<h3 class="admin-notices-title" style="cursor:pointer; margin:7px 14px; font-size:16px;" onclick="settings_toggle_notices();">' . "\n";
			echo '<span id="admin-notices-arrow" style="font-size:24px;">&#9656;</span> &nbsp; ' . "\n";
			echo '<span id="admin-notices-title" style="vertical-align:top;">' . esc_html( __( 'Notices', 'stream-player' ) ) . '</span>  &nbsp; ' . "\n";
			echo '<span id="admin-notices-count" style="vertical-align:top;"></span></h3>' . "\n";

			echo '<div id="admin-notices-wrap" style="display:none";><h2 style="display:none;"></h2></div>' . "\n";
			echo '</div>' . "\n";

			// 1.3.6: move notice boxer scripts to setting_scripts
			// $this->scripts[] = 'notice_boxer';

		}

		// ------------------
		// Plugin Page Header
		// ------------------
		public function settings_header() {

			$args = $this->args;
			$namespace = $this->namespace;
			$settings = $GLOBALS[$namespace];

			// --- check for animated gif icon with fallback to normal icon ---
			// 1.0.9: fix to check if PNG file exists
			$icon_url = false;
			if ( file_exists( $this->args['dir'] . '/images/' . $args['slug'] . '.gif' ) ) {
				$icon_url = plugins_url( 'images/' . $args['slug'] . '.gif', $args['file'] );
			} elseif ( file_exists( $this->args['dir'] . '/images/' . $args['slug'] . '.png' ) ) {
				$icon_url = plugins_url( 'images/' . $args['slug'] . '.png', $args['file'] );
			}
			$icon_url = apply_filters( $namespace . '_plugin_icon_url', $icon_url );

			// --- check for author icon based on provided author name ---
			// 1.0.2: check if author icon file exists and fallback
			$author_icon_url = false;
			$author_slug = strtolower( str_replace( ' ', '', $args['author'] ) );
			if ( file_exists( $this->args['dir'] . '/images/' . $author_slug . '.png' ) ) {
				$author_icon_url = plugins_url( 'images/' . $author_slug . '.png', $args['file'] );
			} elseif ( file_exists( $this->args['dir'] . '/images/wordquest.png' ) ) {
				$author_icon_url = plugins_url( 'images/wordquest.png', $args['file'] );
			}
			$author_icon_url = apply_filters( $namespace . '_author_icon_url', $author_icon_url );

			// --- open header table ---
			echo '<table class="plugin-settings-page-header"><tr>' . "\n";

			// --- plugin icon ---
			// 1.1.9: add filter for plugin icon url
			$icon_url = apply_filters( $namespace . '_settings_page_icon_url', $icon_url );
			echo '<td>' . "\n";
			if ( $icon_url ) {
				echo '<img class="plugin-settings-page-icon" src="' . esc_url( $icon_url ) . '" width="128" height="128">' . "\n";
			}
			echo '</td>' . "\n";

			echo '<td width="20"></td><td>' . "\n";

			echo '<table><tr>' . "\n";

			// --- plugin title ---
			// 1.1.9: add filter for plugin pagetitle
			$title = apply_filters( $namespace . '_settings_page_title', $args['title'] );
			echo '<td><h3 style="font-size:20px;">' . "\n";
			echo '<a href="' . esc_url( $args['home'] ) . '" target="_blank" style="text-decoration:none;">' . esc_html( $title ) . '</a>' . "\n";
			echo '</h3></td>' . "\n";

			echo '<td width="20"></td>' . "\n";

			// --- plugin version ---
			// 1.1.9: add filter for plugin version
			$version = apply_filters( $namespace . '_settings_page_version', 'v' . $args['version'] );
			echo '<td><h3 class="plugin-setttings-page-version">' . esc_html( $version ) . '</h3></td></tr>' . "\n";

			// --- subtitle ---
			// 1.1.9: added optional subtitle filter display
			$subtitle = apply_filters( $namespace . '_settings_page_subtitle', '' );
			if ( '' != $subtitle ) {
				echo '<tr><td colspan="3" align="center">' . "\n";
				echo '<h4 class="plugins-settings-page-subtitle" style="font-size:14px; margin-top:0;">' . esc_html( $subtitle ) . '</h4>' . "\n";
				echo '</td></tr>' . "\n";
			}

			echo '<tr><td colspan="3" align="center">' . "\n";

			echo '<table><tr><td align="center">' . "\n";

			// ---- plugin author ---
			// 1.0.8: check if author URL is set
			if ( isset( $args['author_url'] ) ) {
				echo '<font style="font-size:16px;">' . esc_html( __( 'by', 'stream-player' ) ) . '</font> ';
				echo '<a href="' . esc_url( $args['author_url'] ) . '" target="_blank" style="text-decoration:none;font-size:16px;" target="_blank"><b>' . esc_html( $args['author'] ) . '</b></a><br><br>' . "\n";
			}

			// --- readme / docs / support links ---
			// 1.0.8: use filtered links array with automatic separator
			// 1.1.0: added explicit plugin home link
			// 1.1.0: added title attributes to links
			$links = array();
			if ( isset( $args['home'] ) ) {
				$links[] = '<a href="' . esc_url( $args['home'] ) . '" class="pluginlink smalllink" title="' . esc_attr( __( 'Plugin Homepage', 'stream-player' ) ) . '" target="_blank"><b>' . esc_html( __( 'Home', 'stream-player' ) ) . '</b></a>';
			}
			if ( !isset( $args['readme'] ) || ( false !== $args['readme'] ) ) {
				$readme_url = add_query_arg( 'action', $namespace . '_readme_viewer', admin_url( 'admin-ajax.php' ) );
				$links[] = '<a href="' . esc_url( $readme_url ) . '" class="pluginlink smalllink thickbox" title="' . esc_attr( __( 'View Plugin', 'stream-player' ) ) . ' readme.txt"><b>' . esc_html( __( 'Readme', 'stream-player' ) ) . '</b></a>';
			}
			if ( isset( $args['docs'] ) ) {
				$links[] = '<a href="' . esc_url( $args['docs'] ) . '" class="pluginlink smalllink" title="' . esc_attr( __( 'Plugin Documentation', 'stream-player' ) ) . '" target="_blank"><b>' . esc_html( __( 'Docs', 'stream-player' ) ) . '</b></a>';
			}
			if ( isset( $args['support'] ) ) {
				$links[] = '<a href="' . esc_url( $args['support'] ) . '" class="pluginlink smalllink" title="' . esc_attr( __( 'Plugin Support', 'stream-player' ) ) . '" target="_blank"><b>' . esc_html( __( 'Support', 'stream-player' ) ) . '</b></a>';
			}
			if ( isset( $args['development'] ) ) {
				$links[] = '<a href="' . esc_url( $args['development'] ) . '" class="pluginlink smalllink" title="' . esc_attr( __( 'Plugin Development', 'stream-player' ) ) . '" target="_blank"><b>' . esc_html( __( 'Dev', 'stream-player' ) ) . '</b></a>';
			}

			// 1.0.9: change filter from _plugin_links to disambiguate
			$links = apply_filters( $args['namespace'] . '_plugin_admin_links', $links );
			if ( count( $links ) > 0 ) {
				// 1.2.5: use wp_kses_post on output
				echo wp_kses_post( implode( ' | ', $links ) );
			}

			// --- author icon ---
			if ( $author_icon_url ) {
				echo '</td><td>' . "\n";

				// 1.0.8: check if author URL is set for link
				if ( isset( $args['author_url'] ) ) {
					echo '<a href="' . esc_url( $args['author_url'] ) . '" target="_blank">' . "\n";
				}
				echo '<img src="' . esc_url( $author_icon_url ) . '" width="64" height="64" border="0">' . "\n";
				if ( isset( $args['author_url'] ) ) {
					echo '</a>' . "\n";
				}
			}

			echo '</td></tr></table>' . "\n";

			echo '</td></tr></table>' . "\n";

			echo '</td><td width="50"></td><td style="vertical-align:top;">' . "\n";

			// --- plugin supporter links ---
			// 1.0.1: set rate/share/donate links and texts
			// 1.0.8: added filters for rate/share/donate links
			echo '<br><div class="plugin-settings-page-links">' . "\n";

			// --- Rate link ---
			if ( isset( $args['wporgslug'] ) ) {
				if ( isset( $args['rate'] ) ) {
					$rate_url = $args['rate'];
				} elseif ( isset( $args['type'] ) && ( 'theme' == $args['type'] ) ) {
					$rate_url = 'https://wordpress.org/support/theme/' . $args['wporgslug'] . '/reviews/#new-post';
				} else {
					// 1.2.2: update rating URL to match new repo scheme
					$rate_url = 'https://wordpress.org/support/plugins/' . $args['wporgslug'] . '/reviews/#new-post';
				}
				if ( isset( $args['ratetext'] ) ) {
					$rate_text = $args['ratetext'];
				} else {
					$rate_text = __( 'Rate on WordPress.Org', 'stream-player' );
				}
				$rate_link = '<a href="' . esc_url( $rate_url ) . '" class="pluginlink" target="_blank">';
				$rate_link .= '<span style="font-size:24px; color:#FC5; margin-right:10px;" class="dashicons dashicons-star-filled"></span>' . "\n";
				$rate_link .= ' ' . esc_html( $rate_text ) . '</a><br><br>' . "\n";
				$rate_link = apply_filters( $args['namespace'] . '_rate_link', $rate_link, $args );
				if ( $rate_link ) {
					// 1.2.5: use wp_kses_post on rate link output
					echo wp_kses_post( $rate_link );
				}
			}

			// --- Share link ---
			if ( isset( $args['share'] ) ) {
				if ( isset( $args['sharetext'] ) ) {
					$share_text = $args['sharetext'];
				} else {
					$share_text = __( 'Share the Plugin Love', 'stream-player' );
				}
				$share_link = '<a href="' . esc_url( $args['share'] ) . '" class="pluginlink" target="_blank">';
				$share_link .= '<span style="font-size:24px; color:#E0E; margin-right:10px;" class="dashicons dashicons-share"></span> ';
				$share_link .= esc_html( $share_text ) . '</a><br><br>';
				$share_link = apply_filters( $args['namespace'] . '_share_link', $share_link, $args );
				if ( $share_link ) {
					// 1.2.5: use wp_kses_post on share link output
					echo wp_kses_post( $share_link );
				}
			}

			// --- Donate link ---
			if ( isset( $args['donate'] ) ) {
				if ( isset( $args['donatetext'] ) ) {
					$donate_text = $args['donatetext'];
				} else {
					$donate_text = __( 'Support this Plugin', 'stream-player' );
				}
				$donate_link = '<a href="' . esc_url( $args['donate'] ) . '" class="pluginlink" target="_blank">';
				$donate_link .= '<span style="font-size:24px; color:#E00; margin-right:10px;" class="dashicons dashicons-heart"></span> ';
				$donate_link .= '<b>' . esc_html( $donate_text ) . '</b></a><br><br>';
				$donate_link = apply_filters( $args['namespace'] . '_donate_link', $donate_link, $args );
				if ( $donate_link ) {
					// 1.2.5: use wp_kses_post on donate link output
					echo wp_kses_post( $donate_link );
				}
			}

			echo '</div></td></tr>' . "\n";

			// --- output updated and reset messages ---
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( isset( $_GET['updated'] ) ) {
				// phpcs:ignore WordPress.Security.NonceVerification.Recommended
				$updated = sanitize_text_field( wp_unslash( $_GET['updated'] ) );
				if ( 'yes' == $updated ) {
					$message = $settings['title'] . ' ' . __( 'Settings Updated.', 'stream-player' );
				} elseif ( 'no' == $updated ) {
					$message = __( 'Error! Settings NOT Updated.', 'stream-player' );
				} elseif ( 'reset' == $updated ) {
					$message = $settings['title'] . ' ' . __( 'Settings Reset!', 'stream-player' );
				}
				if ( isset( $message ) ) {
					echo '<tr><td></td><td></td><td align="center">' . "\n";
					// 1.2.5: use direct echo option for message box
					$this->message_box( $message, true );
					echo '</td></tr>' . "\n";
				}
			} else {
				// --- maybe output welcome message ---
				// 1.0.5: use sanitize_title on request variable
				// phpcs:ignore WordPress.Security.NonceVerification.Recommended
				if ( isset( $_REQUEST['welcome'] ) && ( 'true' == sanitize_text_field( wp_unslash( $_REQUEST['welcome'] ) ) ) ) {
					// 1.2.3: skip output if welcome message argument is empty
					if ( isset( $args['welcome'] ) && ( '' != $args['welcome'] ) ) {
						echo '<tr><td colspan="3" align="center">';
							// 1.2.5: use direct echo option for message box
							$this->message_box( $args['welcome'], true );
						echo '</td></tr>' . "\n";
					}
				}
			}

			echo '</table><br>' . "\n";
		}

		// -------------
		// Settings Page
		// -------------
		public function settings_page() {

			$namespace = $this->namespace;

			// --- open page wrapper ---
			echo '<div id="pagewrap" class="wrap" style="width:100%;margin-right:0 !important;">' . "\n";

			do_action( $namespace . '_admin_page_top' );

			// --- output settings header ---
			$this->settings_header();

			do_action( $namespace . '_admin_page_middle' );

			// --- output settings table ---
			$this->settings_table();

			do_action( $namespace . '_admin_page_bottom' );

			// --- close page wrapper ---
			echo '</div>' . "\n";
		}

		// --------------
		// Settings Table
		// --------------
		// 1.0.9: created automatic Plugin Settings page
		// (based on passed plugin options and default settings)
		public function settings_table() {

			// --- get all options and settings (unfiltered) ---
			$args = $this->args;
			$namespace = $this->namespace;
			$options = $this->options;

			// --- get plugin options and default settings ---
			// 1.1.2: fix for filtering of plugin options
			$options = $this->options;
			$options = apply_filters( $namespace . '_options', $options );

			$defaults = $this->default_settings();
			$settings = $this->get_settings( false );

			// --- output saved settings ---
			if ( $this->debug ) {
				echo '<br><b>Saved Settings:</b><br>' . "\n";
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions
				echo esc_html( print_r( $settings, true ) );
				echo '<br><br>' . "\n";
			}

			// --- get option tabs and sections ---
			$tabs = $this->tabs;
			$sections = $this->sections;

			$currenttab = '';
			// 1.3.4: allow for switching setting tab via querystring
			if ( isset( $_REQUEST['tab'] ) ) {
				$currenttab = sanitize_text_field( wp_unslash( $_REQUEST['tab'] ) );
			} elseif ( isset( $settings['settingstab'] ) ) {
				$currenttab = $settings['settingstab'];
			}

			// --- loop options to maybe get tabbed groupings ---
			$taboptions = array();
			foreach ( $options as $key => $option ) {
				if ( isset( $option['tab'] ) && array_key_exists( $option['tab'], $tabs ) ) {
					if ( ( count( $sections ) > 0 ) && isset( $option['section'] ) ) {
						$taboptions[$option['tab']][$option['section']][$key] = $option;
					} else {
						$taboptions[$option['tab']]['general'][$key] = $option;
					}
				} else {
					if ( ( count( $sections ) > 0 ) && isset( $option['section'] ) ) {
						$taboptions['general'][$option['section']][$key] = $option;
					} else {
						$taboptions['general']['general'][$key] = $option;
					}
				}
			}

			// --- remove unused tabs automatically ---
			// 1.1.7: added for cleaner interface while developing
			foreach ( $tabs as $tab => $tablabel ) {
				if ( !isset( $taboptions[$tab] ) ) {
					unset( $tabs[$tab] );
				}
			}

			// --- maybe push general section to top of tab ---
			foreach ( $taboptions as $tab => $tabsections ) {
				if ( isset( $tabsections['general'] ) && ( count( $tabsections ) > 1 ) ) {
					$general = $tabsections['general'];
					unset( $tabsections['general'] );
					$taboptions[$tab] = array_merge( $general, $tabsections );
				}
			}

			// --- maybe output tab groupings ---
			if ( count( $tabs ) > 0 ) {

				// --- output tab switcher script ---
				// 1.0.9: add to settings scripts
				// 1.2.5: only store script reference
				// $this->scripts[] = 'tab_switcher';

				$i = 0;
				echo '<ul id="settings-tab-buttons">' . "\n";
				foreach ( $tabs as $tab => $tablabel ) {
					$class = 'inactive';
					if ( ( $tab == $currenttab ) || ( ( '' == $currenttab ) && ( 0 == $i ) ) ) {
						$class = 'active';
					}
					// 1.2.5: remove onclick attribute and use jQuery click function
					// onclick="plugin_panel_display_tab(\'' . esc_attr( $tab ) . '\');"
					echo '<li id="' . esc_attr( $tab ) . '-tab-button" class="settings-tab-button ' . esc_attr( $class ) . '">' . esc_html( $tablabel ) . '</li>' . "\n";
					$i++;
				}
				echo '</ul>' . "\n";
			} else {
				$tabs = array( 'general' => __( 'General', 'stream-player' ) );
			}

			// --- reset to default script ---
			// 1.0.9: add to settings scripts
			// $this->scripts[] = 'settings_reset';

			// --- start settings form ---
			// 1.2.0: remove unused prefix on settings tab name attribute
			echo '<form method="post" id="settings-form">' . "\n";
			echo '<input type="hidden" name="' . esc_attr( $namespace ) . '_update_settings" id="settings-action" value="yes">' . "\n";
			echo '<input type="hidden" name="settingstab" id="settings-tab" value="' . esc_attr( $currenttab ) . '">' . "\n";
			wp_nonce_field( $args['slug'] . '_update_settings' );

			// --- maybe set hidden debug input ---
			if ( $this->debug ) {
				echo '<input type="hidden" name="debug" value="yes">' . "\n";
			}

			// ---- open wrapbox ---
			echo '<div id="wrapbox" class="postbox" style="line-height:2em;">' . "\n";
			echo '<div class="inner" style="padding-left:20px;">' . "\n";

			// --- output tabbed sections ---
			$i = 0;
			foreach ( $tabs as $tab => $tablabel ) {

				// --- open tab table output ---
				$class = 'inactive';
				if ( ( $currenttab == $tab ) || ( ( '' == $currenttab ) && ( 0 == $i ) ) ) {
					$class = 'active';
				}
				echo '<div id="' . esc_attr( $tab ) . '-tab" class="settings-tab ' . esc_attr( $class ) . '">' . "\n";

				do_action( $namespace . '_admin_page_tab_' . $tab . '_top' );

				echo '<table cellpadding="0" cellspacing="0">' . "\n";

				if ( count( $sections ) > 0 ) {

					$sectionheadings = array();
					foreach ( $sections as $section => $sectionlabel ) {
						if ( array_key_exists( $section, $taboptions[$tab] ) ) {

							// --- section top ---
							// 1.2.5: fix to mismatched class setting-section-bottom
							echo '<tr class="setting-section-top"><td colspan="5">' . "\n";
							// 1.2.5: use do_action directly instead of using stored output
							do_action( $namespace . '_admin_page_section_' . $section . '_top' );
							echo '</td></tr>' . "\n";

							// --- section heading ---
							if ( !isset( $sectionheadings[$section] ) ) {
								echo '<tr class="setting-section">' . "\n";
								echo '<td colspan="5"><h3>' . esc_html( $sectionlabel ) . '</h3></td>' . "\n";
								echo '</tr>' . "\n";
								$sectionheadings[$section] = true;
							}

							// --- section setting rows ---
							foreach ( $taboptions[$tab][$section] as $key => $option ) {
								$option['key'] = $key;
								// 1.2.5: use wp_kses on setting row output with custom allowed HTML
								// echo $this->setting_row( $option );
								echo wp_kses( $this->setting_row( $option ), $this->allowed_html( $option ) );
								
							}
							echo '<tr height="25"><td> </td></tr>' . "\n";

							// --- section bottom hook ---
							echo '<tr class="setting-section-bottom"><td colspan="5">';
							// 1.2.5: use do_action directly instead of using stored output
							do_action( $namespace . '_admin_page_section_' . $section . '_bottom' );
							echo '</td></tr>' . "\n";

						}
					}
				} else {
					foreach ( $taboptions[$tab]['general'] as $key => $option ) {
						$option['key'] = $key;
						echo '<tr height="25"><td> </td></tr>' . "\n";
						// 1.2.5: use wp_kses_post on setting output with custom allowed HTML
						echo wp_kses( $this->setting_row( $option ), $this->allowed_html( $option ) );
						echo '<tr height="25"><td> </td></tr>' . "\n";
					}
				}

				// --- reset/save settings buttons ---
				// (filtered so removable from any specific tab)
				$buttons = '<tr height="25"><td> </td></tr>' . "\n";
				$buttons .= '<tr><td align="center">' . "\n";
				// 1.2.5: remove reset onclick attribute
				$buttons .= '<input type="button" id="settingsresetbutton" class="button-secondary settings-button reset-button" value="' . esc_attr( __( 'Reset Settings', 'stream-player' ) ) . '">' . "\n";
				$buttons .= '</td><td colspan="3"></td><td align="center">' . "\n";
				$buttons .= '<input type="submit" class="button-primary settings-button" value="' . esc_attr( __( 'Save Settings', 'stream-player' ) ) . '">' . "\n";
				$buttons .= '</td></tr>' . "\n";
				$buttons .= '<tr height="25"><td></td></tr>' . "\n";
				$buttons = apply_filters( $namespace . '_admin_save_buttons', $buttons, $tab );
				if ( $buttons ) {
					// 1.2.5: use wp_kses on filtered buttons output
					echo wp_kses( $buttons, $this->allowed_html() );
				}

				// --- close table ---
				echo '</table>' . "\n";

				// --- do below tab action ---
				do_action( $namespace . '_admin_page_tab_' . $tab . '_bottom' );

				// --- close tab output ---
				echo '</div>' . "\n";

				$i++;
			}

			// --- close wrapbox ---
			echo '</div></div>' . "\n";

			// --- close settings form ---
			echo '</form>' . "\n";

			// --- enqueue settings resources ---
			// 1.3.4: moved settings resources enqueue to admin_enqueue_scripts
		}

		// ---------------------
		// Allowed Inputs Filter
		// ---------------------
		// 1.2.5: added allowed inputs filter
		public function allowed_html( $option = false ) {

			$namespace = $this->namespace;

			// --- get default allowed post HTML ---
			$allowed = wp_kses_allowed_html( 'post' );

			// --- input ---
			// 1.2.6: add missing checked attribute
			// 1.3.8: added data attributes for previews
			// 1.3.8: add minimum and maximum attributes
			$allowed['input'] = array(
				'id'			=> array(),
				'class'			=> array(),
				'name'			=> array(),
				'value'			=> array(),
				'type'			=> array(),
				'data'			=> array(),
				'placeholder'	=> array(),
				'checked'       => array(),
				'min'           => array(),
				'max'           => array(),
				'data-alpha-enabled' => array(),
				'data-default-color' => array(),
				'data-key'      => array(),
				'data-preview'  => array(),
				'data-linked'   => array(),
				'data-css'      => array(),
				'data-settings' => array(),
			);

			// --- textarea ---
			$allowed['textarea'] = array(
				'id'			=> array(),
				'class'			=> array(),
				'name'			=> array(),
				'value'			=> array(),
				'type'			=> array(),
				'placeholder'	=> array(),
				// 1.3.6: add rows and cols
				'rows'			=> array(),
				'cols'			=> array(),
				'data-key'      => array(),
				'data-preview'  => array(),
				'data-linked'   => array(),
				'data-css'      => array(),
				'data-settings' => array(),
			);

			// --- select ---
			// 1.2.6: fix multiselect to multiple
			$allowed['select'] = array(
				'id'			=> array(),
				'class'			=> array(),
				'name'			=> array(),
				'value'			=> array(),
				'type'			=> array(),
				'multiple'		=> array(),
				'data-key'      => array(),
				'data-preview'  => array(),
				'data-linked'   => array(),
				'data-css'      => array(),
				'data-settings' => array(),
			);

			// --- select option ---
			// 1.2.6: added missing value attribute
			$allowed['option'] = array(
				'selected' => array(),
				'value'    => array(),
			);

			// --- option group ---
			$allowed['optgroup'] = array(
				'label' => array(),
			);
			
			// --- style tags ---
			$allowed['style'] = array(
				'id' => array(),
			);

			$allowed = apply_filters( $namespace . '_settings_allowed_html', $allowed, $option );
			return $allowed;
		}

		// ------------------
		// Settings Resources
		// ------------------
		// 1.2.3: added for standalone enqueueing of resources from table
		// 1.2.4: added missing public visibility declaration
		public function settings_resources( $media = true, $color_picker = true ) {

			// 1.3.5: set default scripts to enqueue
			// 1.3.8: add preview script
			$this->scripts = array( 'notice_boxer', 'tab_switcher', 'settings_reset', 'previews' );

			// --- number input step script ---
			// 1.0.9: added to script array
			// 1.1.8: fix to check for no mix or max value
			$this->scripts[] = 'number_step';

			// --- image selection script ---
			// 1.1.7: added for image field type
			if ( $media ) {
				$this->scripts[] = 'media_functions';
			}

			// --- color picker script ---
			if ( $color_picker ) {
				$this->scripts[] = 'colorpicker_init';
			}

			// --- enqueue settings scripts ---
			// 1.3.4: change from admin_footer hook
			// 1.3.5: change back to admin_footer hook (for jQuery!)
			// 1.3.6: enqueue and append to dummy admin script
			// add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_scripts' ) );
			// add_action( 'admin_footer', array( $this, 'setting_scripts' ) );
			$this->enqueue_scripts();

			// --- enqueue settings styles ---
			// 1.3.4: change from admin_footer hook
			// 1.3.6: enqueue and append to dummy admin style
			// add_action( 'admin_enqueue_styles', array( $this, 'enqueue_styles' ) );
			// add_action( 'admin_print_styles', array( $this, 'setting_styles' ) );
			$this->enqueue_styles();

		}

		// -----------
		// Setting Row
		// -----------
		// 1.0.9: added for automatic Settings table generation
		public function setting_row( $option ) {
			
			// --- prepare setting keys ---
			$args = $this->args;
			$namespace = $this->namespace;
			$postkey = $args['settings'];
			$name = $postkey . '_' . $option['key'];
			$type = $option['type'];
			$setting = $this->get_setting( $option['key'], false );

			$preview_data = '';
			if ( isset( $option['preview'] ) ) {
				$preview = $option['preview'];
				$preview_data = ' data-preview="1" ';
				$props = array( 'css', 'settings', 'linked', /* 'target', 'selector', 'alt-sel', 'property', 'alt-prop' */ );
				foreach ( $props as $prop ) {
					if ( isset( $preview[$prop] ) ) {
						$preview_data .= 'data-' . $prop . '="' . esc_attr( $preview[$prop] ) . '" ';
					}
				}
			}

			// --- convert old option type names ---
			if ( 'email' == $type ) {
				$type = 'text';
				$option['options'] = 'EMAIL';
			} elseif ( 'emails' == $type ) {
				$type = 'text';
				$option['options'] = 'EMAIL';
			} elseif ( 'url' == $type ) {
				$type = 'text';
				$option['options'] = 'URL';
			} elseif ( 'urls' == $type ) {
				$type = 'text';
				$option['options'] = 'URL';
			} elseif ( 'alpabetic' == $type ) {
				$type = 'text';
				$option['options'] = 'ALPHABETIC';
			} elseif ( 'alphanumeric' == $type ) {
				$type = 'text';
				$option['options'] = 'ALPHANUMERIC';
			} elseif ( 'numeric' == $type ) {
				$option['options'] = 'NUMERIC';
			} elseif ( 'numeric' == $type ) {
				$option['options'] = 'NUMERIC';
			} elseif ( 'usernames' == $type ) {
				$type = 'text';
				$option['options'] = 'USERNAME';
			} elseif ( 'csvslugs' == $type ) {
				$type = 'text';
				$option['options'] = 'SLUG';
			} elseif ( 'pageid' == $type ) {
				$type = 'select';
				$option['options'] = 'PAGEID';
			} elseif ( 'postid' == $type ) {
				$type = 'select';
				$option['options'] = 'POSTID';
			} elseif ( 'pageids' == $type ) {
				$type = 'multiselect';
				$option['options'] = 'PAGEIDS';
			} elseif ( 'postids' == $type ) {
				$type = 'multiselect';
				$option['options'] = 'POSTIDS';
			}
			// TODO: password and multitoggle ?

			// --- prepare row output ---
			$row = '<tr class="settings-row">' . "\n";

			$row .= '<td class="settings-label">' . $option['label'] . "\n";
			if ( 'multiselect' == $type ) {
				$row .= '<br><span>' . esc_html( __( 'Use Ctrl and Click to Select', 'stream-player' ) ) . '</span>' . "\n";
			}
			$row .= '</td><td width="25"></td>' . "\n";

			// 1.0.9: added multiple cell spanning note type
			if ( ( 'note' == $type ) || ( 'info' == $type ) || ( 'helper' == $type ) ) {

				$row .= '<td class="settings-helper" colspan="3">' . "\n";
				if ( isset( $option['helper'] ) ) {
					$row .= $option['helper'];
				}
				$row .= '</td>' . "\n";

			} else {

				// TODO: add check if already Pro version ?
				// (currently done by removing pro key/value pair in Pro code)
				if ( isset( $option['pro'] ) && $option['pro'] ) {

					// --- Pro version setting (teaser) ---
					// 1.2.0: improved handling of upgrade links
					$row .= '<td class="settings-input setting-pro">';
					$upgrade_link = false;
					$upgrade_target = '';
					if ( ( isset( $args['hasplans'] ) && $args['hasplans'] )
						|| ( isset( $args['hasaddons'] ) && $args['hasaddons'] ) ) {
						$upgrade_link = add_query_arg( 'page', $args['slug'] . '-pricing', admin_url( 'admin.php' ) );
					}
					if ( isset( $args['upgrade_link'] ) ) {
						$upgrade_link = $args['upgrade_link'];
						$upgrade_target = !strstr( $upgrade_link, '/wp-admin/' ) ? ' target="_blank"' : '';
					}
					// 1.2.1: fix to check pro_link not upgrade_link
					if ( isset( $args['pro_link'] ) ) {
						$pro_link = $args['pro_link'];
						$pro_target = !strstr( $pro_link, '/wp-admin/' ) ? ' target="_blank"' : '';
					}
					if ( $upgrade_link || isset( $pro_link ) ) {
						// 1.2.2: change text from Available in Pro
						$row .= __( 'Premium Feature.', 'stream-player' ) . '<br>';
						if ( $upgrade_link ) {
							$row .= '<a href="' . esc_url( $upgrade_link ) . '"' . $upgrade_target . '>' . esc_html( __( 'Upgrade Now', 'stream-player' ) ) . '</a>';
						}
						if ( $upgrade_link && isset( $pro_link ) ) {
							$row .= ' | ';
						}
						if ( isset( $pro_link ) ) {
							// 1.2.2: change text from Pro details
							// 1.3.0: add hash link anchor for Pro feature options
							$option_anchor = str_replace( '_', '-', $option['key'] );
							$row .= '<a href="' . esc_url( $pro_link ) . '#' . esc_attr( $option_anchor ) . '"' . $pro_target . '>' . esc_html( __( 'Details', 'stream-player' ) ) . '</a>' . "\n";
						}
					} else {
						$row .= esc_html( __( 'Coming soon in Pro version!', 'stream-player' ) );
					}
					$row .= '</td>' . "\n";

				} else {

					$row .= '<td class="settings-input"';
					if ( 'preview' == $type ) {
						$row .= ' colspan="3"';
					}
					$row .= '>' . "\n";

					// --- maybe prepare special options ---
					if ( isset( $option['options'] ) && is_string( $option['options'] ) ) {

						// --- maybe prepare post/page options (once) ---
						if ( in_array( $option['options'], array( 'POSTID', 'POSTIDS', 'PAGEID', 'PAGEIDS' ) ) ) {

							$posttype = strtolower( substr( $option['options'], 0, 4 ) );
							if ( ( ( 'page' == $posttype ) && !isset( $pageoptions ) ) || ( ( 'post' == $posttype ) && !isset( $postoptions ) ) ) {

								global $wpdb;
								$results = $wpdb->get_results( $wpdb->prepare( "SELECT ID,post_title,post_status FROM " . $wpdb->prefix . "posts WHERE post_type = %s AND post_status != 'auto-draft'", $posttype ), ARRAY_A );

								// 1.2.7: fix by moving page/post options variable here
								// 1.3.0: check separately to avoid overwriting existing options
								if ( !isset( $pageoptions ) ) {
									$pageoptions = array( '' => '' );
								}
								if ( !isset( $postoptions ) ) {
									$postoptions = array( '' => '' );
								}
								if ( $results && ( count( $results ) > 0 ) ) {
									foreach ( $results as $result ) {
										if ( strlen( $result['post_title'] ) > 35 ) {
											$result['post_title'] = substr( $result['post_title'], 0, 35 ) . '...';
										}
										$label = $result['ID'] . ': ' . $result['post_title'];
										if ( 'publish' != $result['post_status'] ) {
											$label .= ' (' . $result['post_status'] . ')';
										}
										if ( 'page' == $posttype ) {
											$pageoptions[$result['ID']] = $label;
										} elseif ( 'post' == $posttype ) {
											$postoptions[$result['ID']] = $label;
										}
									}
								}
							}
							if ( 'page' == $posttype ) {
								$option['options'] = $pageoptions;
							} elseif ( 'post' == $posttype ) {
								$option['options'] = $postoptions;
							}
						}

						// --- maybe prepare public post type options (once) ---
						if ( in_array( $option['options'], array( 'PUBLICTYPE', 'PUBLICTYPES' ) ) ) {
							$publicoptions = array();
							$cpts = array( 'page', 'post' );
							$args = array( 'public' => true, '_builtin' => false );
							$cptlist = get_post_types( $args, 'names', 'and' );
							$cpts = array_merge( $cpts, $cptlist );
							foreach ( $cpts as $cpt ) {
								$posttypeobject = get_post_type_object( $cpt );
								$label = $posttypeobject->labels->singular_name;
								$publicoptions[$cpt] = $label;
							}
							$option['options'] = $publicoptions;
						}

						// --- maybe prepare post type options (once) ---
						if ( in_array( $option['options'], array( 'POSTTYPE', 'POSTTYPES' ) ) ) {
							$cptoptions = array();
							$cpts = array( 'page', 'post' );
							$args = array( '_builtin' => false );
							$cptlist = get_post_types( $args, 'names', 'and' );
							$cpts = array_merge( $cpts, $cptlist );
							foreach ( $cpts as $cpt ) {
								$posttypeobject = get_post_type_object( $cpt );
								$label = $posttypeobject->labels->singular_name;
								$cptoptions[$cpt] = $label;
							}
							$option['options'] = $cptoptions;
						}

						// --- maybe prepare all post type options (once) ---
						if ( in_array( $option['options'], array( 'ALLTYPE', 'ALLTYPES' ) ) ) {
							$allcptoptions = array();
							$args = array( '_builtin' => true );
							$cpts = get_post_types( $args, 'names', 'and' );
							foreach ( $cpts as $cpt ) {
								$posttypeobject = get_post_type_object( $cpt );
								$label = $posttypeobject->labels->singular_name;
								$allcptoptions[$cpt] = $label;
							}
							$option['options'] = $allcptoptions;
						}

						// --- maybe prepare user options (once) ---
						if ( in_array( $option['options'], array( 'USERID', 'USERIDS', 'USERNAME', 'USERNAMES' ) ) ) {
							if ( in_array( $option['options'], array( 'USERID', 'USERIDS' ) ) ) {
								$userkey = 'userid';
							} else {
								$userkey = 'username';
							}
							$useroptions = array( '' => '' );

							global $wpdb;
							// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
							$results = $wpdb->get_results( "SELECT ID,user_login,display_name FROM " . $wpdb->prefix . "users", ARRAY_A );
							if ( $results && ( count( $results ) > 0 ) ) {
								foreach ( $results as $result ) {
									$label = $result['ID'] . ': ' . $result['display_name'];
									if ( $result['display_name'] != $result['user_login'] ) {
										$label .= ' (' . $result['user_login'] . ')';
									}
									if ( 'userid' == $userkey ) {
										$useroptions[$result['ID']] = $label;
									} elseif ( 'username' == $userkey ) {
										$useroptions[$result['user_login']] = $label;
									}
								}
							}
							$option['options'] = $useroptions;
						}

					}

					// --- output option input types ---
					if ( 'toggle' == $type ) {

						// --- toggle ---
						// 1.0.9: add toggle input (styled checkbox)
						// 1.1.7: set default option value if not set
						if ( !isset( $option['value'] ) ) {
							$option['value'] = '1';
						}
						$checked = ( $setting == $option['value'] ) ? ' checked="checked"' : '';
						$row .= '<label for="' . esc_attr( $name ) . '" class="setting setting-toggle">';
						$row .= '<input type="checkbox" name="' . esc_attr( $name ) . '" data-key="' . esc_attr( $option['key'] ) . '" class="setting-toggle" value="' . esc_attr( $option['value'] ) . '"' . $checked . $preview_data . '>' . "\n";
						$row .= '<span class="setting-slider round"></span>' . "\n";
						$row .= '</label>' . "\n";
						if ( isset( $option['suffix'] ) ) {
							$row .= ' ' . $option['suffix'];
						}

					} elseif ( 'checkbox' == $type ) {

						// --- checkbox ---
						// 1.1.7: set default option value if not set
						if ( !isset( $option['value'] ) ) {
							$option['value'] = '1';
						}
						$checked = ( $setting == $option['value'] ) ? ' checked="checked"' : '';
						$row .= '<input type="checkbox" name="' . esc_attr( $name ) . '" data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-checkbox" value="' . esc_attr( $option['value'] ) . '"' . $checked . $preview_data . '>' . "\n";
						if ( isset( $option['suffix'] ) ) {
							$row .= ' ' . $option['suffix'];
						}

					} elseif ( 'multicheck' == $type ) {

						// --- multicheck boxes ---
						$checkboxes = array();
						foreach ( $option['options'] as $key => $label ) {
							$checked = '';
							if ( is_array( $setting ) && in_array( $key, $setting ) ) {
								$checked = ' checked="checked"';
							}
							$checkboxes[] = '<input type="checkbox" name="' . esc_attr( $name ) . "-" . esc_attr( $key ) . '" data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-checkbox setting-multicheck" value="yes"' . $checked . $preview_data . '> ' . esc_html( $label ) . "\n";
						}
						$row .= implode( '<br>', $checkboxes );

					} elseif ( 'radio' == $type ) {

						// --- radio buttons ---
						$radios = array();
						foreach ( $option['options'] as $value => $label ) {
							$checked = ( $setting == $value ) ? ' checked="checked"' : '';
							$radios[] = '<input type="radio" data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-radio" name="' . esc_attr( $name ) . "' value='" . esc_attr( $value ) . '"' . $checked . $preview_data . '> ' . esc_html( $label ) . "\n";
						}
						$row .= implode( '<br>', $radios );

					} elseif ( 'select' == $type ) {

						// --- select dropdown ---
						$row .= '<select data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-select" name="' . esc_attr( $name ) . '"' . $preview_data . '>' . "\n";
						foreach ( $option['options'] as $value => $label ) {
							// 1.0.9: support option grouping (set unique key containing OPTGROUP-)
							if ( strstr( $value, '*OPTGROUP*' ) ) {
								$row .= '<optgroup label="' . esc_attr( $label ) . '">' . esc_html( $label ) . '</optgroup>' . "\n";
							} else {
								// 1.1.3: remove strict value checking
								$row .= '<option value="' . esc_attr( $value ) . '"';
								if ( $setting == $value ) {
									$row .= ' selected="selected"';
								}
								$row .= '>' . esc_html( $label ) . '</option>' . "\n";
							}
						}
						$row .= '</select>';
						if ( isset( $option['suffix'] ) ) {
							$row .= ' ' . $option['suffix'];
						}

					} elseif ( 'multiselect' == $type ) {

						// --- multiselect dropdown ---
						$row .= '<select multiple="multiple" data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-select setting-multiselect" name="' . esc_attr( $name ) . '[]"' . $preview_data . '>' . "\n";
						foreach ( $option['options'] as $value => $label ) {
							if ( '' != $value ) {
								// 1.1.3: check for OPTGROUP instead of *OPTGROUP*
								if ( strstr( $value, 'OPTGROUP' ) ) {
									$row .= '<optgroup label="' . esc_attr( $label ) . '">' . "\n";
								} else {
									$selected = ( is_array( $setting ) && in_array( $value, $setting ) ) ? ' selected="selected"' : '';
									$row .= '<option value="' . esc_attr( $value ) . '"' . $selected . ">" . esc_html( $label ) . '</option>' . "\n";
								}
							}
						}
						$row .= '</select>';
						if ( isset( $option['suffix'] ) ) {
							$row .= ' ' . $option['suffix'];
						}

					} elseif ( ( 'text' == $type ) || ( 'csv' == $type ) ) {

						// 1.2.0: re-added missing csv field type

						// --- text inputs ---
						$class = 'setting setting-text';
						if ( 'csv' == $type ) {
							$class .= ' setting-csv';
						}
						$placeholder = isset( $option['placeholder'] ) ? $option['placeholder'] : '';

						// 1.1.7: fix to attribute quoting output
						$row .= '<input type="text" name="' . esc_attr( $name ) . '" data-key="' . esc_attr( $option['key'] ) . '" class="' . esc_attr( $class ) . '" value="' . esc_attr( $setting ) . '" placeholder="' . esc_attr( $placeholder ) . '"' . $preview_data . '>' . "\n";
						if ( isset( $option['suffix'] ) ) {
							$row .= ' ' . $option['suffix'];
						}

					} elseif ( 'textarea' == $type ) {

						// --- textarea input ---
						$rows = isset( $option['rows'] ) ? $option['rows'] : '6';
						$cols = isset( $option['cols'] ) ? $option['cols'] : '80';
						$placeholder = isset( $option['placeholder'] ) ? $option['placeholder'] : '';

						// 1.2.4: added missing esc_textarea on value
						// 1.3.6: fixed rows attribute, added cols attribute
						$row .= '<textarea name="' . esc_attr( $name ) . '" data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-textarea" rows="' . esc_attr( $rows ) . '" cols="' . esc_attr( $cols ) . '" placeholder="' . esc_attr( $placeholder ) . '"' . $preview_data . '>' . esc_textarea( $setting ) . '</textarea>' . "\n";

					} elseif ( ( 'numeric' == $type ) || ( 'number' == $type ) ) {

						// --- numeric text input ---
						// note: step key is only used for controls, not for validation
						$placeholder = isset( $option['placeholder'] ) ? $option['placeholder'] : '';
						$min =  isset( $option['min'] ) ? $option['min'] : 'false';
						$max = isset( $option['max'] ) ? $option['max'] : 'false';
						$step = isset( $option['step'] ) ? $option['step'] : 1;

						// 1.1.7: remove esc_js from onclick attributes
						// $onclickdown = "plugin_panel_number_step('down', '" . esc_attr( $name ) . "', " . esc_attr( $min ) . ", " . esc_attr( $max ) . ", " . esc_attr( $step ) . ");" . "\n";
						// $row .= '<input class="setting-button button-secondary" type="button" value="-" onclick="' . $onclickdown . '">' . "\n";
						$row .= '<input class="number-button number-down-button setting-button button-secondary" type="button" value="-" data="' . esc_attr( $name ) . '">' . "\n";
						if ( isset( $option['prefix'] ) ) {
							$row .= ' ' . $option['prefix'];
						}
						$data = esc_attr( $min ) . "," . esc_attr( $max ) . "," . esc_attr( $step );
						$row .= '<input id="number-input-' . esc_attr( $name ) . '" data-key="' . esc_attr( $option['key'] ) . '" class="setting setting-numeric" type="text" name="' . esc_attr( $name ) . '" value="' . esc_attr( $setting ) . '" placeholder="' . esc_attr( $placeholder ) . '" data="' . esc_attr( $data ) . '"' . $preview_data . '>' . "\n";
						// $onclickup = "plugin_panel_number_step('up', '" . esc_attr( $name ) . "', " . esc_attr( $min ) . ", " . esc_attr( $max ) . ", " . esc_attr( $step ) . ");" . "\n";
						// $row .= '<input class="setting-button button-secondary" type="button" value="+" onclick="' . $onclickup . '">' . "\n";
						$row .= '<input class="number-button number-up-button setting-button button-secondary" type="button" value="+" data="' . esc_attr( $name ) . '">' . "\n";
						if ( isset( $option['suffix'] ) ) {
							$row .= ' ' . $option['suffix'];
						}

					} elseif ( 'image' == $type ) {

						// 1.1.7: added image attachment selection from media library
						// note: no preview data as the image IS the preview

						// --- get current image ---
						$image = wp_get_attachment_image_src( $setting, 'full' );
						$has_image = is_array( $image );

						// --- image container ---
						$row .= '<div class="custom-image-container">';
						if ( $has_image ) {
							$row .= '<img src="' . esc_url( $image[0] ) . '" alt="" style="max-width:100%;">' . "\n";
						}
						$row .= '</div>' . "\n";

						// --- add and remove links ---
						$upload_link = get_upload_iframe_src( 'image' );
						$row .= '<p class="hide-if-no-js">' . "\n";
							$hidden = '';
							if ( $has_image ) {
								$hidden = ' hidden';
							}
							$row .= '<a class="upload-custom-image' . esc_attr( $hidden ) . '" href="' . esc_url( $upload_link ) . '">' . "\n";
							$row .= esc_html( __( 'Add Image', 'stream-player' ) );
							$row .= '</a>' . "\n";

							$hidden = '';
							if ( !$has_image ) {
								$hidden = ' hidden';
							}
							$row .= '<a class="delete-custom-image' . esc_attr( $hidden ) . '" href="#">' . "\n";
							$row .= esc_html( __( 'Remove Image', 'stream-player' ) );
							$row .= '</a>' . "\n";
						$row .= '</p>' . "\n";

						// --- hidden input for image ID ---
						$row .= '<input class="custom-image-id" name="' . esc_attr( $name ) . '" type="hidden" value="' . esc_attr( $setting ) . '">' . "\n";

					} elseif ( 'color' == $type ) {

						// 1.1.7: added color picker field
						$row .= '<input type="text" class="setting color-picker" data-default-color="' . esc_attr( $option['default'] ) . '" name="' . esc_attr( $name ) . '" value="' . esc_attr( $setting ) . '">' . "\n";
						$row .= '<input type="hidden" data-key="' . esc_attr( $option['key'] ) . '" class="setting color-picker-input" value="' . esc_attr( $setting ) . '"' . $preview_data . '>' . "\n";

					} elseif ( 'coloralpha' == $type ) {

						// 1.1.7: added color picker alpha field
						$row .= '<input type="text" class="setting color-picker" data-alpha-enabled="true" data-default-color="' . esc_attr( $option['default'] ) . '" name="' . esc_attr( $name ) . '" value="' . esc_attr( $setting ) . '">' . "\n";
						$row .= '<input type="hidden" data-key="' . esc_attr( $option['key'] ) . '" class="setting color-picker-input"  value="' . esc_attr( $setting ) . '"' . $preview_data . '>' . "\n";

					} elseif ( 'preview' == $type ) {

						// 1.3.8: added dynamic preview container optional
						$settings = $this->get_settings( false );
						$row .= '<div id="preview-' . esc_attr( $option['key'] ) . '"';
						if ( isset( $option['width'] ) ) {
							$row .= ' width="' . esc_attr( $option['width'] ) . '"';
						}
						if ( isset( $option['height'] ) ) {
							$row .= ' height="' . esc_attr( $option['height'] ) . '"';
						}
						if ( isset( $option['classes'] ) ) {
							$all_classes = $classes = explode( ',', $option['classes'] );
							foreach ( $classes as $class ) {
								$class = trim( $class );
								foreach ( $settings as $key => $value ) {
									if ( '%%' . $key . '%%' == $class ) {
										if ( is_array( $value ) ) {
											$value = implode( ' ', $value );
										}
										$all_classes[] = str_replace( '%%' . $key . '%%', $value, $class );
									}
								}
							}
							foreach ( $all_classes as $i => $class ) {
								$all_classes[$i] = str_replace( '%%', '', $class );
							}
							$class_list = implode( ' ', $all_classes );
							$row .= ' class="' . esc_attr( $class_list ) .'"';
						}
						$row .= '>' ."\n";
							if ( isset( $option['html'] ) ) {
								$html = $option['html'];
								foreach ( $settings as $key => $value ) {
									$find = '%%' . $key . '%%';
									if ( strstr( $html, $find ) ) {
										$html = str_replace( $find, $value, $html );
									}
								}
								$row .= $html;
							}
						$row .= '</div>' . "\n";
						
						if ( isset( $option['css'] ) ) {
							$css = $option['css'];
							$target = $option['key'];
							$target_selector = '#preview-' . esc_attr( $target );
							$css = str_replace( '%%target%%', $target_selector, $css );
							$settings = $this->get_settings( false );
							foreach ( $settings as $key => $value ) {
								$find = '%%' . $key . '%%';
								if ( strstr( $css, $find ) ) {
									$css = str_replace( $find, $value, $css );
								}
							}
							$row .= '<style id="preview-' . esc_attr( $option['key'] ) . '-css">' . $css . '</style>' . "\n";
						}

					}

					$row .= '</td>';
				}

				// --- setting helper text ---
				if ( isset( $option['helper'] ) ) {
					if ( 'preview' != $type ) {
						$row .= '<td width="25"></td>' . "\n";
						$row .= '<td class="settings-helper">' . esc_html( $option['helper'] ) . '</td>' . "\n";
					} else {
						$row .= '</tr><tr><td></td><td colspan="3" class="settings-helper">' . esc_html( $option['helper'] ) . '</td></tr>' . "\n";
					}
				}

			}

			$row .= '</tr>' . "\n";

			// --- setting preview ---
			// 1.3.8: added image preview option
			if ( isset( $option['preview'] ) && isset( $option['preview']['type'] ) ) {
				$row .= '<tr>';
					$row .= '<td style="text-align:right;">' . esc_html( __( 'Preview', 'stream-player' ) ) . ':</td>' . "\n";
					$row .= '<td width="25"></td>' . "\n";
					$row .= '<td>';
					if ( 'image' == $option['preview']['type'] ) {
						$width = $option['preview']['width'];
						$height = $option['preview']['height'];
						$sources = $this->get_preview_images( $option );
						// echo 'Image Sources: ' . print_r( $sources, true );
						$row .= '<div class="preview-image" id="preview-' . esc_attr( $option['key'] ) . '"></div>' . "\n";
						$row .= '<style>#preview-' . esc_attr( $option['key'] ) . ' {background-image: url("' . esc_url( $sources['source'] ) . '"); background-size: 100% 100%;';
						$row .= 'width: ' . esc_attr( $width ) . 'px; height: ' . esc_attr( $height ) . 'px';
						$row .= '}' . "\n";
						if ( isset( $sources['alt'] ) && ( '' != $sources['alt'] ) ) {
							$row .= '#preview-' . esc_attr( $option['key'] ) . ' {cursor: pointer;}' . "\n";
							$row .= '#preview-' . esc_attr( $option['key'] ) . ':hover, #preview-' . esc_attr( $option['key'] ) . '.active {background-image: url("' . esc_url( $sources['alt'] ) . '"); background-size: 100% 100%;}' . "\n";
						}
						$row .= '</style>' . "\n";
					} elseif ( 'html' == $option['preview']['type'] ) {
						$row .= '<div class="preview-html" id="preview-' . esc_attr( $option['key'] ) . '">' . wp_kses( $option['preview']['html'], $this->allowed_html( $option ) ) . '</div>' . "\n";					
					}

					$row .= '</td>' . "\n";
				$row .= '</tr>' . "\n";
			}
				
			// --- settings row spacer ---
			$row .= '<tr class="settings-spacer"><td>';
			if ( isset( $option['preview']['css'] ) ) {
				/* $css = $option['preview']['css'];
				if ( isset( $option['preview']['target'] ) ) {
					$target = $option['preview']['target'];
					$target_selector = '#preview-' . esc_attr( $target );
					$css = str_replace( '%%target%%', $target_selector, $css );
				}
				$settings = $this->get_settings( false );
				$css = $option['preview']['css'];
				foreach ( $settings as $key => $value ) {
					$find = '%%' . $key . '%%';
					if ( strstr( $css, $find ) ) {
						$css = str_replace( $find, $value, $css );
					}
				} */
				$css = '';
				$row .= '<style id="preview-' . esc_attr( $option['key'] ) . '-css">' . $css . '</style>';
			}
			$row .= '</td></tr>' . "\n";

			// --- filter and return setting row ---
			$row = apply_filters( $namespace . '_setting_row', $row, $option );

			return $row;
		}

		// -----------------
		// Get Preview Image
		// -----------------
		public function get_preview_images( $option ) {
			$source = $alt = '';
			$settings = $this->get_settings( false );
			$setting = $this->get_setting( $option['key'], false );
			// echo $option['key'] . ' - ' . $setting;
			if ( isset( $option['preview']['sources'][$setting] ) ) {
				$source = $option['preview']['sources'][$setting];
				if ( isset( $option['preview']['sources-alt'][$setting] ) ) {
					$alt = $option['preview']['sources-alt'][$setting];
				}
				foreach( $settings as $key => $value ) {
					$find = '%%' . $key . '%%';
					if ( strstr( $source, $find ) ) {
						$source = str_replace( $find, $value, $source );
					}
					if ( strstr( $alt, $find ) ) {
						$alt = str_replace( $find, $value, $alt );
					}
				}
			}
			$sources = array(
				'source' => $source,
				'alt'    => $alt,
			);
			return $sources;
		}

		// ---------------
		// Enqueue Scripts
		// ---------------
		// 1.3.6: enqueue scripts inline via dummy script
		public function enqueue_scripts() {
			
			$version = $this->plugin_version();
			wp_register_script( 'plugin-admin-settings', null, array( 'jquery' ), $version, true );
			wp_enqueue_script( 'plugin-admin-settings' );
			$js = $this->setting_scripts();
			wp_add_inline_script( 'plugin-admin-settings', $js, 'after' );

		}

		// ---------------
		// Setting Scripts
		// ---------------
		// 1.0.9: added settings page scripts
		public function setting_scripts() {

			$args = $this->args;
			$scripts = $this->scripts;

			if ( count( $scripts ) > 0 ) {

				// 1.3.6: buffer script output
				ob_start();
				
				foreach ( $scripts as $script ) {

					// 1.2.5: output scripts based on stored script keys
					if ( 'tab_switcher' == $script ) {

						// --- output tab switcher function ---
						// 1.2.5: changed function prefix for consistency
						/* echo "function plugin_panel_display_tab(tab) {" . "\n";
						foreach ( $tabs as $tab => $label ) {
							echo "	document.getElementById('" . esc_js( $tab ) . "-tab-button').className = 'settings-tab-button inactive';" . "\n";
							echo "	document.getElementById('" . esc_js( $tab ) . "-tab').className = 'settings-tab inactive'; " . "\n";
						}
						echo "	document.getElementById(tab+'-tab-button').className = 'settings-tab-button active';" . "\n";
						echo "	document.getElementById(tab+'-tab').className = 'settings-tab active';" . "\n";
						echo "	document.getElementById('settings-tab').value = tab;" . "\n";
						echo "}" . "\n"; */

						// 1.2.5: use jQuery click function to remove onclick button attributes
						echo "jQuery('.settings-tab-button').on('click', function() {" . "\n";
						echo "	tab = jQuery(this).attr('id').replace('-tab-button','');" . "\n";
						echo "	jQuery('.settings-tab,.settings-tab-button').removeClass('active').addClass('inactive');" . "\n";
						echo "	jQuery('#'+tab+'-tab,#'+tab+'-tab-button').removeClass('inactive').addClass('active');" . "\n";
						echo "	jQuery('#settings-tab').val(tab);" . "\n";
						echo "});" . "\n";

					} elseif ( 'notice_boxer' == $script ) {
						
						// --- toggle notice box script ---
						echo "function settings_toggle_notices() {
							if (document.getElementById('admin-notices-wrap').style.display == '') {
								document.getElementById('admin-notices-wrap').style.display = 'none';
								document.getElementById('admin-notices-arrow').innerHTML = '&#9656;';
							} else {
								document.getElementById('admin-notices-wrap').style.display = '';
								document.getElementById('admin-notices-arrow').innerHTML= '&#9662;';
							}
						}" . "\n";

						// --- modified from /wp-admin/js/common.js to move notices ---
						echo "jQuery(document).ready(function() {
							setTimeout(function() {
								jQuery('div.update-nag, div.updated, div.error, div.notice').not('.inline, .below-h2').insertAfter(jQuery('#admin-notices-wrap h2'));
								count = parseInt(jQuery('#admin-notices-wrap').children().length - 1);
								if (count > 0) {jQuery('#admin-notices-count').html('('+count+')');}
								else {jQuery('#admin-notices-box').hide();}
							}, 500);
						});" . "\n";
						
					} elseif ( 'settings_reset' == $script ) {

						// --- reset settings function ---
						// 1.2.5: changed function prefix for consistency
						// 1.2.5: changed to jQuery click function to remove onclick button attribute
						$confirmreset = __( 'Are you sure you want to reset to default settings?', 'stream-player' );
						// echo "function plugin_panel_reset_defaults() {" . "\n";
						// 1.3.7: fix to use class not ID
						echo "jQuery('.reset-button').on('click', function() {" . "\n";
						echo "	agree = confirm('" . esc_js( $confirmreset ) . "');" . "\n";
						echo "	if (!agree) {return false;}" . "\n";
						echo "	document.getElementById('settings-action').value = 'reset';" . "\n";
						echo "	document.getElementById('settings-form').submit();" . "\n";
						echo "});" . "\n";
						// echo "}" . "\n";

					} elseif ( 'number_step' == $script ) {

						// --- number step function ---
						// 1.2.5: changed function prefix for consistency
						/*echo "function plugin_panel_number_step(updown, id, min, max, step) {
							if (updown == 'up') {multiplier = 1;} else if (updown == 'down') {multiplier = -1;}
							current = parseInt(document.getElementById(id).value);
							newvalue = current + (multiplier * parseInt(step));
							if ((min !== false) && (newvalue < parseInt(min))) {newvalue = min;}
							if ((max !== false) && (newvalue > parseInt(max))) {newvalue = max;}
							document.getElementById(id).value = newvalue;
						}" . "\n"; */
						// 1.2.5: replace with jQuery click function to remove onclick attributes
						// 1.2.9: fix for possible empty value converting to NaN
						echo "jQuery('.number-button').on('click', function() {
							if (jQuery(this).hasClass('number-up-button')) {multiplier = 1;}
							else if (jQuery(this).hasClass('number-down-button')) {multiplier = -1;}
							idref = 'number-input-'+jQuery(this).attr('data');
							data = jQuery('#'+idref).attr('data').split(',');
							min = data[0]; max = data[1]; step = data[2];
							value = jQuery('#'+idref).val();
							if (value == '') {value = 0;} else {value = parseInt(value);}				
							newvalue = value + (multiplier * parseInt(step));
							if ((min !== false) && (newvalue < parseInt(min))) {newvalue = min;}
							if ((max !== false) && (newvalue > parseInt(max))) {newvalue = max;}
							jQuery('#'+idref).val(newvalue);
						});" . "\n";

					} elseif ( 'media_functions' == $script ) {

						// --- media functions ---
						$confirm_remove = __( 'Are you sure you want to remove this image?', 'stream-player' );
						echo "jQuery(function(){

							var mediaframe, parentdiv;

							/* Add Image on Click */
							jQuery('.upload-custom-image').on( 'click', function( event ) {

								event.preventDefault();
								parentdiv = jQuery(this).parent().parent();

								if (mediaframe) {mediaframe.open(); return;}
								mediaframe = wp.media({
									title: 'Select or Upload Image',
									button: {text: 'Use this Image'},
									multiple: false
								});

								mediaframe.on( 'select', function() {
									var attachment = mediaframe.state().get('selection').first().toJSON();
									image = '<img src=\"'+attachment.url+'\" alt=\"\" style=\"max-width:100%;\"/>';
									parentdiv.find('.custom-image-container').append(image);
									parentdiv.find('.custom-image-id').val(attachment.id);
									parentdiv.find('.upload-custom-image').addClass('hidden');
									parentdiv.find('.delete-custom-image').removeClass('hidden');
								});

								mediaframe.open();
								jQuery('.media-modal-close').on( 'click', function() {
									console.log('close click detected');
									mediaframe.close();
								});
							});

							/* Delete Image on Click */
							jQuery('.delete-custom-image').on( 'click', function( event ) {
								event.preventDefault();
								agree = confirm('" . esc_js( $confirm_remove ) . "');
								if (!agree) {return;}
								parentdiv = jQuery(this).parent().parent();
								parentdiv.find('.custom-image-container').html('');
								parentdiv.find('.custom-image-id').val('');
								parentdiv.find('.upload-custom-image').removeClass('hidden');
								parentdiv.find('.delete-custom-image').addClass('hidden');
							});

						});" . "\n";

					} elseif ( 'colorpicker_init' == $script ) {

						// --- initialize color pickers ---
						echo "jQuery(document).ready(function() {" . "\n";
							echo "if (jQuery('.color-picker').length) {" . "\n";
								echo "jQuery('.color-picker').wpColorPicker({
									change: function(event, ui) {
										color = ui && ui.color ? ui.color.toString() : jQuery(this).val();
										console.log('Color changed:', color);
										console.log(jQuery(this));
										input = jQuery(this).closest('.settings-input').find('.color-picker-input');
										console.log(input);
										input.val(color).trigger('change');
									},
									clear: function() {console.log('Color cleared');}
								});" . "\n";
							echo "}" . "\n";
						echo "});" . "\n";

					} elseif ( 'previews' == $script ) {
					
						// --- preview classes active toggle ---
						// 1.3.8: toggle active class on preview clicks
						echo "jQuery('.preview-image, .preview-button').on('click', function(e) {
							/* if (jQuery(this).data('toggling')) {return;}
							jQuery(this).data('toggling', true); */
							if (!jQuery(this).hasClass('active')) {jQuery(this).addClass('active');}
							else {jQuery(this).removeClass('active');}
							/* setTimeout(() => jQuery(this).removeData('toggling'), 50); */
						});" . "\n";
						
						// --- add classes and preview css ---
						// 1.3.8: added for previews
						echo "jQuery(document).ready(function() {					
							jQuery('.setting').each(function() {
								if (jQuery(this).attr('data-preview') == '1') {
									jQuery(this).on('change', function() {
										console.log(jQuery(this));
										linked = jQuery(this).attr('data-linked');
										if (typeof linked != 'undefined') {
											jQuery('.setting').each(function() {
												if (jQuery(this).attr('data-key') == linked) {
													console.log('trigger change for linked setting: '+linked);
													jQuery(this).trigger('change');
												}
											});
										}
										/* target = jQuery(this).attr('data-target'); */
										key = jQuery(this).attr('data-key');
										css = jQuery(this).attr('data-css');
										if (typeof css == 'undefined') {css = '';}
										settings = jQuery(this).attr('data-settings');
										if (typeof settings == 'undefined') {settings = [key];}
										else if (settings.indexOf(',') > -1) {settings = settings.split(',');}
										else {settings = [settings];}
										console.log(settings);
										for (i = 0; i < settings.length; i++) {
											value = null; values = []; options = [];
											jQuery('.setting').each(function() {
												if (jQuery(this).attr('data-key') == settings[i]) {
													if (!jQuery(this).hasClass('setting-multicheck') && !jQuery(this).hasClass('setting-radio')) {
														value = jQuery(this).val();
														values = [value];
														console.log(settings[i]+' -> '+value);
													} else {
														/* TODO: multiselect */
														val = jQuery(this).val();
														options.push(val);
														if (jQuery(this).prop('checked')) {values.push(val);}
													}
												}
											});
											if (jQuery('.'+settings[i]).length) {
												jQuery('.'+settings[i]).each(function() {
													for (j = 0; j < options.length; j++) {jQuery(this).removeClass(options[j]);}
													for (j = 0; j < values.length; j++) {jQuery(this).addClass(values);}
												});
											}
											find = '%%'+settings[i]+'%%';
											if (value != null) {css = css.replaceAll(find,value);}
										}
										if (typeof custom_css_preview == 'function' ) {css = custom_css_preview(css);}
										jQuery('#preview-'+key+'-css').html(css);

										/* selector = jQuery(this).attr('data-selector');
										property = jQuery(this).attr('data-property');
										jQuery('#'+selector).css({property:value}); */
									});
								}
							});
						});" . "\n";
					}

				}

				// 1.2.5: added for possible extra settings scripts
				do_action( $args['namespace'] . '_settings_scripts', $args );
				
				$js = ob_get_contents();
				ob_end_clean();
				return $js;

			}
		}
		
		// --------------
		// Enqueue Styles
		// --------------
		// 1.3.6: enqueue styles inline via dummy stylesheet
		public function enqueue_styles() {
			
			$version = $this->plugin_version();
			wp_register_style( 'plugin-admin-settings', null, array(), $version, 'all' );
			wp_enqueue_style( 'plugin-admin-settings' );
			$css = $this->setting_styles();
			wp_add_inline_style( 'plugin-admin-settings', $css );
			
		}

		// --------------
		// Setting Styles
		// --------------
		public function setting_styles() {

			$styles = array();

			// --- page styles ---
			// 1.2.9: add padding to bottom of settings form
			$styles[] = '#wrapbox {margin-right: 20px; padding-bottom: 20px;}';

			// --- plugin header styles ---
			// 1.2.0: moved from plugin header section
			// 1.2.3: remove underline from plugin icon spans
			$styles[] = '.pluginlink, .pluginlink span {text-decoration:none;}';
			$styles[] = '.smalllink {font-size:11px;}';
			$styles[] = '.readme:hover {text-decoration:underline;}';

			// --- settings tab styles ---
			// 1.1.0: added max-width:100% to select input
			// 1.2.7: add pointer cursor to inactive tabs
			$styles[] = '.settings-tab-button {display:inline-block; font-size:15px; padding:7px 14px; margin-right:20px; border-radius:7px;}';
			$styles[] = '.settings-tab-button.active {font-weight:bold; background-color:#0073aa; color:#FFF; border:1px solid #FFF;}';
			$styles[] = '.settings-tab-button.inactive {font-weight:bold; background-color:#F5F5F5; color:#0073aa; border:1px solid #000; cursor:pointer;}';
			$styles[] = '.settings-tab-button.inactive:hover {background-color:#FFFFFF; color:#00a0d2;}';
			$styles[] = '.settings-tab.active {display:block;}';
			$styles[] = '.settings-tab.inactive {display:none;}';

			// --- setting row styles ---
			$styles[] = '.settings-label {vertical-align:top; font-weight:bold; min-width:100px; max-width:200px;}';
			$styles[] = '.settings-label span {font-weight: normal; font-size:10px;}';
			$styles[] = '.settings-helper {vertical-align:top; font-style:italic; min-width:200px; max-width:300px;}';
			$styles[] = '.settings-spacer {height: 7px;}';

			// --- setting input styles ---
			$styles[] = '.settings-input {vertical-align:top; min-width:100px; max-width:300px;}';
			// $styles[] = '.settings-input input.setting-radio {}';
			// $styles[] = '.settings-input input.setting-checkbox {}';
			$styles[] = '.settings-input input.setting-text {width:100%;}';
			$styles[] = '.settings-input input.setting-numeric {display:inline-block; width:50%; text-align:center; vertical-align:middle;}';
			$styles[] = '.settings-input input.setting-button {display:inline-block; padding:0px 5px;}';
			$styles[] = '.settings-input input.setting-button.number-down-button {padding:0px 7px; font-weight:bold;}';
			$styles[] = '.settings-input input.setting-textarea {width:100%;}';
			$styles[] = '.settings-input select.setting-select {min-width:100px; max-width:100%;}';
			
			// --- toggle input styles ---
			// Ref: https://www.w3schools.com/howto/howto_css_switch.asp
			$styles[] = '.setting-toggle {position:relative; display:inline-block; width:30px; height:17px;}
			.setting-toggle input {opacity:0; width:0; height:0;}
			.setting-slider {position:absolute; cursor:pointer;
			  top:0; left:0; right:0; bottom:0; background-color:#ccc;
			  -webkit-transition:.4s; transition:.4s;
			}
			.setting-slider:before {position:absolute; content:""; height:13px; width:13px;
			  left:2px; bottom:2px; background-color:white; -webkit-transition:.4s; transition:.4s;
			}
			input:checked + .setting-slider {background-color:#2196F3;}
			input:focus + .setting-slider {box-shadow:0 0 1px #2196F3;}
			input:checked + .setting-slider:before {
			  -webkit-transform:translateX(13px); -ms-transform:translateX(13px); transform:translateX(13px);
			}
			.setting-slider.round {border-radius: 17px;}
			.setting-slider.round:before {border-radius: 50%;}';

			// --- color picker styles ---
			// 1.2.7: added to overlay active color picker
			$styles[] = '.wp-picker-active {position:absolute; z-index:999; background-color:#FFF; border:1px solid #999; padding:5px;}';
			$styles[] = '.wp-picker-active .wp-picker-input-wrap {display:block;}';
			$styles[] = '.wp-color-picker {max-width:200px;}';

			// --- filter and output styles ---
			$namespace = $this->namespace;
			$styles = apply_filters( $namespace . '_admin_page_styles', $styles );
			$styles_string = implode( "\n", $styles );

			// 1.2.5: added wp_strip_all_tags to styles output
			// 1.3.0: use wp_kses_post on styles output
			// 1.3.6: return style string instead of echo
			// echo wp_strip_all_tags( istyles_string ) );
			return $styles_string;
		}

	}
} // end Plugin Loader Class


// ----------------------------------
// Load Namespaced Prefixed Functions
// ----------------------------------
// [Optional] rename functions prefix to your plugin namespace
// these functions will then be available within your plugin
// to more easily call the matching plugin loader class methods

// 1.0.3: added priority of 0 to prefixed function loading action
add_action( 'plugins_loaded', 'stream_player_load_prefixed_functions', 0 );

if ( !function_exists( 'stream_player_load_prefixed_functions' ) ) {
	function stream_player_load_prefixed_functions() {

		// ------------------
		// Get Namespace Slug
		// ------------------
		// --- Auto-magic Mamespacing Slug Note ---
		// the below functions use the function name to grab and load the corresponding class method
		// all function name suffixes here must be two words for the magic namespace grabber to work
		// ie. _add_settings, because the namespace is taken from *before the second-last underscore*
		if ( !function_exists( 'stream_player_get_namespace_from_function' ) ) {
			function stream_player_get_namespace_from_function( $f ) {
				return substr( $f, 0, strrpos( $f, '_', ( strrpos( $f, '_' ) - strlen( $f ) - 1 ) ) );
			}
		}

		// -------------------
		// Get Loader Instance
		// -------------------
		// 2.3.0: added function for getting loader class instance
		if ( !function_exists( 'stream_player_loader_instance' ) ) {
			function stream_player_loader_instance() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );

				return $GLOBALS[$namespace . '_instance'];
			}
		}

		// ---------------------
		// Get Freemius Instance
		// ---------------------
		// 2.3.0: added function for getting Freemius class instance
		if ( !function_exists( 'stream_player_freemius_instance' ) ) {
			function stream_player_freemius_instance() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );

				return $GLOBALS[$namespace . '_freemius'];
			}
		}

		// ---------------
		// Get Plugin Data
		// ---------------
		// 1.1.1: added function for getting plugin data
		if ( !function_exists( 'stream_player_plugin_data' ) ) {
			function stream_player_plugin_data() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->plugin_data();
			}
		}

		// ------------------
		// Get Plugin Version
		// ------------------
		// 1.1.2: added function for getting plugin version
		if ( !function_exists( 'stream_player_plugin_version' ) ) {
			function stream_player_plugin_version() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->plugin_version();
			}
		}

		// -----------------
		// Set Pro Namespace
		// -----------------
		if ( !function_exists( 'stream_player_pro_namespace' ) ) {
			function stream_player_pro_namespace( $pronamespace ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->pro_namespace( $pronamespace );
			}
		}

		// ===============
		// Plugin Settings
		// ===============

		// ------------
		// Add Settings
		// ------------
		if ( !function_exists( 'stream_player_add_settings' ) ) {
			function stream_player_add_settings() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->add_settings();
			}
		}

		// ------------
		// Get Defaults
		// ------------
		if ( !function_exists( 'stream_player_default_settings' ) ) {
			function stream_player_default_settings( $key = false ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->default_settings( $key );
			}
		}

		// -----------
		// Get Options
		// -----------
		if ( !function_exists( 'stream_player_get_options' ) ) {
			function stream_player_get_options() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->options;
			}
		}

		// -----------
		// Get Setting
		// -----------
		if ( !function_exists( 'stream_player_get_setting' ) ) {
			function stream_player_get_setting( $key, $filter = true ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->get_setting( $key, $filter );
			}
		}

		// ----------------
		// Get All Settings
		// ----------------
		// 1.0.9: added missing get_settings prefixed function
		if ( !function_exists( 'stream_player_get_settings' ) ) {
			function stream_player_get_settings( $filter = true ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->get_settings( $filter );
			}
		}

		// --------------
		// Reset Settings
		// --------------
		if ( !function_exists( 'stream_player_reset_settings' ) ) {
			function stream_player_reset_settings() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->reset_settings();
			}
		}

		// ---------------
		// Update Settings
		// ---------------
		if ( !function_exists( 'stream_player_update_settings' ) ) {
			function stream_player_update_settings() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->update_settings();
			}
		}

		// ---------------
		// Delete Settings
		// ---------------
		if ( !function_exists( 'stream_player_delete_settings' ) ) {
			function stream_player_delete_settings() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->delete_settings();
			}
		}



		// -----------
		// Message Box
		// -----------
		if ( !function_exists( 'stream_player_message_box' ) ) {
			function stream_player_message_box( $message, $echo = false ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];

				return $instance->message_box( $message, $echo );
			}
		}

		// ---------------
		// Settings Header
		// ---------------
		if ( !function_exists( 'stream_player_settings_header' ) ) {
			function stream_player_settings_header() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->settings_header();
			}
		}

		// -------------
		// Settings Page
		// -------------
		if ( !function_exists( 'stream_player_settings_page' ) ) {
			function stream_player_settings_page() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->settings_page();
			}
		}

		// --------------
		// Settings Table
		// --------------
		// 1.0.9: added for standalone setting table output
		if ( !function_exists( 'stream_player_settings_table' ) ) {
			function stream_player_settings_table() {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->settings_table();
			}
		}

		// ------------
		// Settings Row
		// ------------
		// 1.0.9: added for standalone setting row output
		// 1.3.6: fix to incorrect plural function name _settings_row
		if ( !function_exists( 'stream_player_setting_row' ) ) {
			function stream_player_setting_row( $option, $setting ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				// 1.3.6: fix to incorrect plural function name settings_row
				$instance->setting_row( $option, $setting );
			}
		}

		// ------------------
		// Settings Resources
		// ------------------
		// 1.2.3: added for separate enqueueing of resources from table
		if ( !function_exists( 'stream_player_settings_resources' ) ) {
			function stream_player_settings_resources( $media, $color_picker ) {
				$namespace = stream_player_get_namespace_from_function( __FUNCTION__ );
				$instance = $GLOBALS[$namespace . '_instance'];
				$instance->settings_resources( $media, $color_picker );
			}
		}

	}
}

// fully loaded
// ------------


// =========
// CHANGELOG
// =========

// == 1.3.8 ==
// - fix: explicitly set class options variable on construct
// - added setting preview containers and preview images
// - added allowed HTML data and min/max attributes for previews

// == 1.3.7 ==
// - updates for loading delayed string translations

// == 1.3.6 ==
// - delayed support forum redirect to admin_init
// - added rows and cols attributes to textarea input
// - enqueue scripts via dummy admin script
// - change to return style string instead of echo
// - fix to plural function for settings row

// == 1.3.5 ==
// - fix to default script enqueueing

// == 1.3.4 ==
// - switch to settings tab via querystring
// - enqueue settings page resources earlier

// == 1.3.3 ==
// - move post debug output to after check_admin_referer

// == 1.3.2 ==
// - added isset and wp_unslash to $_REQUEST inputs

// == 1.3.1 ==
// - use prefixed markdown reader function
// - when reading strip any license lines causing breakage
// - update to color picker alpha library (3.0.4)
// - added text domain to translation wrappers (for replacing)

// == 1.3.0 ==
// - fix for possible page/post options conflict
// - added explicit email option field type
// - added fallback to text option firld type
// - added check if pro slug data is a string
// - added Freemius has_affiliation key
// - added hash link anchor for Pro feature options

// == 1.2.9 ==
// - fix empty number field converting to NaN value
// - add bottom padding to settings form wrap box

// == 1.2.8 ==
// - fix saving non-alpha colours in coloralpha fields
// - fix saving of single value in CSV field

// == 1.2.7 ==
// - fix color picker alpha sanitization / saving
// - allow color picker alpha to not include alpha
// - added color picker dropdown overlay styling
// - added pointer cursor style to inactive tab

// == 1.2.6 ==
// - expanded wp_kses allowed input attributes

// == 1.2.5 ==
// - improved posted value input sanitization
// - corrected textarea field sanitization
// - added color and color alpha sanitization
// - use wp_kses and allowed HTML on outputs

// == 1.2.4 ==
// - fix to missing declaration on new settings_resources function

// == 1.2.3 ==
// - added separate enqueueing of settings resources
// - remove underline from plugin link icon spans
// - skip welcome message output if empty

// == 1.2.2 ==
// - merge in plugin links instead of using array_unshift
// - update plugin repository rating URL
// - remove duplication of addons link
// - no notice boxer if adminsanity notices loaded
// - change upgrade texts

// == 1.2.1 ==
// - added filters for premium and addons init
// - fix overriding of plan arg to free
// - add check if premium already installed
// - fix namespace typo in add settings action

// == 1.2.0 ==
// - fix missing CSV field type row output condition
// - fix to saving of current settings tab (if any)
// - improved handling of Pro Upgrade and Details links

// == 1.1.9 ==
// - fix to allow saving of zero value
// - added filters for plugin page settings header sections

// == 1.1.8 ==
// - fix to number step if no min or max value

// == 1.1.7 ==
// - added media library upload image field type
// - added color picker and color picker alpha field types
// - automatically remove unused settings tabs
// - fix to text field attribute quoting
// - fix to not escape number step button function
// - remove FILTER_VALIDATE_URL from URL saving (not working)

// == 1.1.6 ==
// - added phone number character validation

// == 1.1.5 ==
// - fix to validate multiple CSV values

// == 1.1.4 ==
// - fix for debug prefix key dash
// - fix for weird get_settings glitch bug (isset failing?!)

// == 1.1.3 ==
// - remove strict value checking on select input
// - change OPTGROUP string check in select options

// == 1.1.2 ==
// - fix for filtering of plugin options
// - fix for plugin page link URL
// - added menu added and debug switches
// - added get plugin version function

// == 1.1.1 ==
// - remove admin_url wrapper on Freemius first-path value

// == 1.1.0 ==
// - fix to saving multicheck as single array of values
// - added admin notices boxer to settings pages
// - added record for tracking first install version
// - added explicit home link to plugin page links

// == 1.0.9 ==
// - added automated Settings table and Admin Page output
// - added tab and section support to options array
// - added tab and section bottom and top action hooks
// - added multicheck, multiselect and toggle input types
// - added post type and post ID input validation
// - added _loader_instance and _get_settings prefixed functions
// - added helper function to get loader and Freemius instances
// - added development link to plugin page header links
// - added missing output sanitization wrappers
// - removed WordQuest specific functionality from loader
// - refactor separate setting update inputs and validation
// - fix to check if plugin icon PNG exists

// == 1.0.8 ==
// - added WordQuest plugin flag (for use by non-WQ plugins)
// - apply settings key filters when getting all settings
// - added filters for rate/share/donate links
// - added page ID to settings input types

// == 1.0.7 ==
// - fix support URL undefined variable warning
// - change readme.php to reader.php (for GitHub)

// == 1.0.6 ==
// - added global options filter
// - added 'emails' option type for multiple email saving
// - fix for new unchecked checkbox value
// - fix for typos in URL option type saving

// == 1.0.5 ==
// - fix for undefined account and support variables

// == 1.0.4 ==
// - added 'url' option type checking and saving
// - added 'csv' option type checking and saving
// - added 'csvslugs' option type checking and saving

// == 1.0.3 ==
// - added priority of 0 to prefixed function loading action
// - only use namespace not settings key for updates
// - added 'email' option type checking and save
// - added 'usernames' option type checking and save

// == 1.0.2 ==
// - fix some Freemius loading argument checks
// - fix namespace typo in update/reset triggers
// - add check for author icon file and fileback
// - add allowance for special settings processing
// - add allowance for auto-load of multiple Pro files

// == 1.0.1 ==
// - set_basename for Freemius free / premium plugins
// - set rate / share / donate links and text anchors
// - check for multiple Pro filenames and use first one

// == 1.0.0 ==
// - Working Release version

// == 0.9.0 ==
// - Development Version