reduxframework / redux-framework

redux-core/inc/extensions/custom_fonts/class-redux-extension-custom-fonts.php

Indentation +963 added lines, -963 removed lines

@@ -16,967 +16,967 @@
 
 if ( ! class_exists( 'Redux_Extension_Custom_Fonts' ) ) {
 
-	/**
-	 * Class Redux_Extension_Custom_Fonts
-	 */
-	class Redux_Extension_Custom_Fonts extends Redux_Extension_Abstract {
-
-		/**
-		 * Extension version.
-		 *
-		 * @var string
-		 */
-		public static $version = '4.5.6';
-
-		/**
-		 * Extension friendly name.
-		 *
-		 * @var string
-		 */
-		public string $extension_name = 'Custom Fonts';
-		/**
-		 * Class instance.
-		 *
-		 * @var object|null
-		 */
-		public static ?object $instance;
-
-		/**
-		 * Custom fonts array.
-		 *
-		 * @var array|null
-		 */
-		public ?array $custom_fonts = array();
-
-		/**
-		 * WordPress upload directory.
-		 *
-		 * @var string|null
-		 */
-		public ?string $upload_dir = '';
-
-		/**
-		 * WordPress upload URI.
-		 *
-		 * @var string|null
-		 */
-		public ?string $upload_url = '';
-
-		/**
-		 * Subfolder name.
-		 *
-		 * @var string
-		 */
-		public string $subfolder = 'custom/';
-
-		/**
-		 * Font folder.
-		 *
-		 * @var string|null
-		 */
-		public ?string $font_folder = '';
-
-		/**
-		 * Font Filename.
-		 *
-		 * @var string|null
-		 */
-		public ?string $font_filename = '';
-
-		/**
-		 * File selected in media upload.
-		 *
-		 * @var string|null
-		 */
-		public ?string $selected_file = '';
-
-		/**
-		 * Is font conversation service available?
-		 *
-		 * @var bool
-		 */
-		private bool $can_convert;
-
-		/**
-		 * Class Constructor. Defines the args for the extensions class
-		 *
-		 * @param ReduxFramework $redux ReduxFramework pointer.
-		 *
-		 * @return      void
-		 * @since       1.0.0
-		 * @access      public
-		 */
-		public function __construct( $redux ) {
-			if ( false === $redux->args['custom_fonts'] ) {
-				return;
-			}
-
-			parent::__construct( $redux, __FILE__ );
-
-			self::$instance = parent::get_instance();
-
-			$this->add_field( 'custom_fonts' );
-
-			$this->upload_dir = Redux_Core::$upload_dir . 'custom-fonts/';
-			$this->upload_url = Redux_Core::$upload_url . 'custom-fonts/';
-
-			if ( ! is_dir( $this->upload_dir ) ) {
-				Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir );
-			}
-
-			if ( ! is_dir( $this->upload_dir . '/custom' ) ) {
-				Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . '/custom' );
-			}
-
-			$this->get_fonts();
-
-			if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
-				if ( filemtime( $this->upload_dir . 'custom' ) > ( filemtime( $this->upload_dir . 'fonts.css' ) + 10 ) ) {
-					$this->generate_css();
-				}
-			} else {
-				$this->generate_css();
-			}
-
-			add_action( 'wp_ajax_redux_custom_fonts', array( $this, 'ajax' ) );
-			add_action( 'wp_ajax_redux_custom_font_timer', array( $this, 'timer' ) );
-
-			add_filter( "redux/{$this->parent->args['opt_name']}/field/typography/custom_fonts", array( $this, 'add_custom_fonts' ) );
-
-			// phpcs:disable
-			// $this->is_field = Redux_Helpers::is_field_in_use( $parent, 'custom_fonts' );
-
-			// if ( ! $this->is_field ) {
-			// 	$this->add_section();
-			// }
-
-			add_filter( "redux/options/{$this->parent->args['opt_name']}/section/redux_dynamic_font_control", array( $this, 'remove_dynamic_section' ) ); // phpcs:ignore WordPress.NamingConventions.ValidHookName
-			add_filter( 'upload_mimes', array( $this, 'custom_upload_mimes' ) );
-			add_action( 'wp_head', array( $this, 'enqueue_output' ), 150 );
-			add_filter( 'tiny_mce_before_init', array( $this, 'extend_tinymce_dropdown' ) );
-
-			$this->can_convert = true; // has_filter( 'redux/' . $this->parent->args['opt_name'] . '/extensions/custom_fonts/api_url' );
-			// phpcs:enable
-		}
-
-		/**
-		 * Timer.
-		 */
-		public function timer() {
-			$name = get_option( 'redux_custom_font_current' );
-
-			if ( ! empty( $name ) ) {
-				echo esc_html( $name );
-			}
-
-			die();
-		}
-
-		/**
-		 * Remove the dynamically added section if the field was used elsewhere
-		 *
-		 * @param array $section Section array.
-		 *
-		 * @return array
-		 * @since  Redux_Framework 3.1.1
-		 */
-		public function remove_dynamic_section( array $section ): array {
-			if ( isset( $this->parent->field_types['custom_fonts'] ) ) {
-				$section = array();
-			}
-
-			return $section;
-		}
-
-		/**
-		 * Adds FontMeister fonts to the TinyMCE drop-down.
-		 * Typekit's fonts don't render properly in the drop-down and in the editor,
-		 * because Typekit needs JS and TinyMCE doesn't support that.
-		 *
-		 * @param array $opt Option array.
-		 *
-		 * @return array
-		 */
-		public function extend_tinymce_dropdown( array $opt ): array {
-			if ( ! is_admin() ) {
-				return $opt;
-			}
-
-			if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
-				$theme_advanced_fonts = $opt['font_formats'] ?? 'Andale Mono=andale mono,times;Arial=arial,helvetica,sans-serif;Arial Black=arial black,avant garde;Book Antiqua=book antiqua,palatino;Comic Sans MS=comic sans ms,sans-serif;Courier New=courier new,courier;Georgia=georgia,palatino;Helvetica=helvetica;Impact=impact,chicago;Symbol=symbol;Tahoma=tahoma,arial,helvetica,sans-serif;Terminal=terminal,monaco;Times New Roman=times new roman,times;Trebuchet MS=trebuchet ms,geneva;Verdana=verdana,geneva;Webdings=webdings;Wingdings=wingdings,zapf dingbats';
-				$custom_fonts         = '';
-
-				$stylesheet = $this->upload_url . 'fonts.css';
-
-				if ( empty( $opt['content_css'] ) ) {
-					$opt['content_css'] = $stylesheet;
-				} else {
-					$opt['content_css'] = $opt['content_css'] . ',' . $stylesheet;
-				}
-
-				foreach ( $this->custom_fonts as $arr ) {
-					foreach ( $arr as $font => $pieces ) {
-						$custom_fonts .= ';' . $font . '=' . $font;
-					}
-				}
-
-				$opt['font_formats'] = $theme_advanced_fonts . $custom_fonts;
-			}
-
-			return $opt;
-		}
-
-
-		/**
-		 * Function to enqueue the custom fonts css
-		 */
-		public function enqueue_output() {
-			if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
-				wp_enqueue_style(
-					'redux-custom-fonts',
-					$this->upload_url . 'fonts.css',
-					array(),
-					filemtime( $this->upload_dir . 'fonts.css' )
-				);
-			}
-		}
-
-		/**
-		 * Adds the appropriate mime types to WordPress
-		 *
-		 * @param array $existing_mimes Mine array.
-		 *
-		 * @return array
-		 */
-		public function custom_upload_mimes( array $existing_mimes = array() ): array {
-			$existing_mimes['ttf']   = 'font/ttf';
-			$existing_mimes['otf']   = 'font/otf';
-			$existing_mimes['eot']   = 'application/vnd.ms-fontobject';
-			$existing_mimes['woff']  = 'application/font-woff';
-			$existing_mimes['woff2'] = 'application/font-woff2';
-			$existing_mimes['svg']   = 'image/svg+xml';
-			$existing_mimes['zip']   = 'application/zip';
-
-			return $existing_mimes;
-		}
-
-		/**
-		 * Gets all the fonts in the custom_fonts directory
-		 */
-		public function get_fonts() {
-			if ( empty( $this->custom_fonts ) ) {
-				$params = array(
-					'include_hidden' => false,
-					'recursive'      => true,
-				);
-
-				$fonts = Redux_Core::$filesystem->execute( 'dirlist', $this->upload_dir, $params );
-
-				if ( ! empty( $fonts ) ) {
-					foreach ( $fonts as $section ) {
-						if ( 'd' === $section['type'] && ! empty( $section['name'] ) ) {
-							if ( 'custom' === $section['name'] ) {
-								$section['name'] = esc_html__( 'Custom Fonts', 'redux-framework' );
-							}
-
-							if ( empty( $section['files'] ) ) {
-								continue;
-							}
-
-							$this->custom_fonts[ $section['name'] ] = $this->custom_fonts[ $section['name'] ] ?? array();
-
-							foreach ( $section['files'] as $font ) {
-								if ( ! empty( $font['name'] ) ) {
-									if ( empty( $font['files'] ) ) {
-										continue;
-									}
-
-									$kinds = array();
-
-									foreach ( $font['files'] as $f ) {
-										$valid = $this->check_font_name( $f );
-										if ( $valid ) {
-											$kinds[] = $valid;
-										}
-									}
-
-									$this->custom_fonts[ $section['name'] ][ $font['name'] ] = $kinds;
-								}
-							}
-						}
-					}
-				}
-			}
-		}
-
-		/**
-		 * Add custom fonts.
-		 *
-		 * @param mixed $custom_fonts Custom fonts.
-		 *
-		 * @return array
-		 */
-		public function add_custom_fonts( $custom_fonts ): array {
-			if ( empty( $custom_fonts ) ) {
-				$custom_fonts = array();
-			}
-
-			return wp_parse_args( $custom_fonts, $this->custom_fonts );
-		}
-
-		/**
-		 * Ajax used within the panel to add and process the fonts
-		 */
-		public function ajax() {
-			if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_key( wp_unslash( $_POST['nonce'] ) ), 'redux_custom_fonts' ) ) {
-				die( 0 );
-			}
-
-			if ( isset( $_POST['type'] ) && 'delete' === $_POST['type'] ) {
-				if ( isset( $_POST['section'] ) ) {
-					if ( esc_html__( 'Custom Fonts', 'redux-framework' ) === $_POST['section'] ) {
-						$_POST['section'] = 'custom';
-					}
-				}
-
-				try {
-					if ( isset( $_POST['section'] ) || isset( $_POST['name'] ) ) {
-						$ret = Redux_Core::$filesystem->execute( 'rmdir', $this->upload_dir . sanitize_file_name( wp_unslash( $_POST['section'] ) ) . '/' . sanitize_file_name( wp_unslash( $_POST['name'] ) ) . '/', array( 'recursive' => true ) );
-
-						if ( true === $ret ) {
-							$result = array( 'type' => 'success' );
-						} else {
-							$result = array(
-								'type' => 'error',
-								'msg'  => esc_html__( 'File system failure. Could not delete temp dir.', 'redux-framework' ),
-							);
-						}
-
-						echo wp_json_encode( $result );
-					}
-				} catch ( Exception $e ) {
-					echo wp_json_encode(
-						array(
-							'type' => 'error',
-							'msg'  => esc_html__( 'Unable to delete font file(s).', 'redux-framework' ),
-						)
-					);
-				}
-
-				die();
-			}
-
-			if ( ! isset( $_POST['title'] ) ) {
-				$_POST['title'] = '';
-			}
-
-			if ( ! isset( $_POST['filename'] ) ) {
-				$_POST['filename'] = '';
-			}
-
-			$this->font_folder   = sanitize_file_name( wp_unslash( $_POST['title'] ) );
-			$this->font_filename = sanitize_file_name( wp_unslash( $_POST['filename'] ) );
-
-			if ( ! empty( $_POST['attachment_id'] ) ) {
-				if ( isset( $_POST['title'] ) || isset( $_POST['mime'] ) ) {
-					$msg = $this->process_web_font( sanitize_key( wp_unslash( $_POST['attachment_id'] ) ), sanitize_text_field( wp_unslash( $_POST['mime'] ) ) );
-
-					if ( empty( $msg ) ) {
-						$msg = '';
-					}
-
-					$result = array(
-						'type' => 'success',
-						'msg'  => $msg,
-					);
-
-					echo wp_json_encode( $result );
-				}
-			}
-
-			die();
-		}
-
-		/**
-		 * Get only valid files. Ensure everything is proper for processing.
-		 *
-		 * @param string $path Path.
-		 *
-		 * @return array
-		 */
-		public function get_valid_files( string $path ): array {
-			$output = array();
-			$path   = trailingslashit( $path );
-
-			$params = array(
-				'include_hidden' => false,
-				'recursive'      => true,
-			);
-
-			$files = Redux_Core::$filesystem->execute( 'dirlist', $path, $params );
-
-			foreach ( $files as $file ) {
-				if ( 'd' === $file['type'] ) {
-					$output = array_merge( $output, $this->get_valid_files( $path . $file['name'] ) );
-				} elseif ( 'f' === $file['type'] ) {
-					$valid = $this->check_font_name( $file );
-					if ( $valid ) {
-						$output[ $valid ] = trailingslashit( $path ) . $file['name'];
-					}
-				}
-			}
-
-			return $output;
-		}
-
-		/**
-		 * Take a valid web font and process the missing pieces.
-		 *
-		 * @param string $attachment_id ID.
-		 * @param string $mime_type     Mine type.
-		 */
-		public function process_web_font( string $attachment_id, string $mime_type ) {
-			// phpcs:ignore WordPress.Security.NonceVerification
-			if ( ! isset( $_POST['conversion'] ) ) {
-				$_POST['conversion'] = 'false';
-			}
-
-			// phpcs:ignore WordPress.Security.NonceVerification
-			$conversion = sanitize_text_field( wp_unslash( $_POST['conversion'] ) );
-
-			$missing = array();
-
-			$complete = array(
-				'ttf',
-				'woff',
-				'woff2',
-				'eot',
-				'svg',
-				'otf',
-			);
-
-			$subtype = explode( '/', $mime_type );
-			$subtype = trim( max( $subtype ) );
-
-			if ( ! is_dir( $this->upload_dir ) ) {
-				Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir );
-			}
-
-			if ( ! is_dir( $this->upload_dir . $this->subfolder ) ) {
-				Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . $this->subfolder );
-			}
-
-			$temp                = $this->upload_dir . 'temp';
-			$this->selected_file = get_attached_file( $attachment_id );
-
-			if ( empty( $this->selected_file ) ) {
-				echo wp_json_encode(
-					array(
-						'type' => 'error',
-						'msg'  => esc_html__( 'Attachment does not exist.', 'redux-framework' ),
-					)
-				);
-
-				die();
-			}
-
-			$filename = explode( '/', $this->selected_file );
-
-			$filename = $filename[ ( count( $filename ) - 1 ) ];
-
-			$fontname = ucfirst(
-				str_replace(
-					array(
-						'.zip',
-						'.ttf',
-						'.woff',
-						'.woff2',
-						'.eot',
-						'.svg',
-						'.otf',
-					),
-					'',
-					strtolower( $filename )
-				)
-			);
-
-			if ( empty( $this->font_folder ) ) {
-				$this->font_folder = $fontname;
-			}
-
-			$ret = array();
-
-			if ( ! is_dir( $temp ) ) {
-				Redux_Core::$filesystem->execute( 'mkdir', $temp );
-			}
-
-			if ( 'zip' === $subtype ) {
-				$unzipfile = unzip_file( $this->selected_file, $temp );
-
-				if ( is_wp_error( $unzipfile ) ) {
-					echo wp_json_encode(
-						array(
-							'type' => 'error',
-							'msg'  => $unzipfile->get_error_message() . '<br><br>' . esc_html__( 'Unzipping failed.', 'redux-framework' ),
-						)
-					);
-
-					die();
-				}
-
-				$output = $this->get_valid_files( $temp );
-
-				if ( ! empty( $output ) ) {
-					foreach ( $complete as $test ) {
-						if ( ! isset( $output[ $test ] ) ) {
-							$missing[] = $test;
-						}
-					}
-
-					if ( ! is_dir( $this->upload_dir . $this->subfolder . $this->font_folder . '/' ) ) {
-						Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . $this->subfolder . $this->font_folder . '/' );
-					}
-
-					foreach ( $output as $key => $value ) {
-						$param_array = array(
-							'destination' => $this->upload_dir . $this->subfolder . $this->font_folder . '/' . $fontname . '.' . $key,
-							'overwrite'   => true,
-							'chmod'       => 755,
-						);
-
-						Redux_Core::$filesystem->execute( 'copy', $value, $param_array );
-					}
-
-					if ( true === $this->can_convert && 'true' === $conversion ) {
-						$ret = $this->get_missing_files( $fontname, $missing, $output );
-					}
-				}
-
-				Redux_Core::$filesystem->execute( 'rmdir', $temp, array( 'recursive' => true ) );
-
-				$this->generate_css();
-
-				wp_delete_attachment( $attachment_id, true );
-			} elseif ( 'svg+xml' === $subtype || 'vnd.ms-fontobject' === $subtype || 'x-font-ttf' === $subtype || 'ttf' === $subtype || 'otf' === $subtype || 'font-woff' === $subtype || 'font-woff2' === $subtype || 'application-octet-stream' === $subtype || 'octet-stream' === $subtype ) {
-				foreach ( $complete as $test ) {
-					if ( $subtype !== $test ) {
-						if ( ! isset( $output[ $test ] ) ) {
-							$missing[] = $test;
-						}
-					}
-				}
-
-				if ( ! is_dir( $this->upload_dir . $this->subfolder . $this->font_folder . '/' ) ) {
-					Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . $this->subfolder . $this->font_folder . '/' );
-				}
-
-				$output = array( $subtype => $this->selected_file );
-
-				if ( true === $this->can_convert && 'true' === $conversion ) {
-					$ret = $this->get_missing_files( $fontname, $missing, $output );
-
-					if ( false === $ret ) {
-						if ( false === $this->convert_local_font() ) {
-							echo wp_json_encode(
-								array(
-									'type' => 'error',
-									'msg'  => esc_html__( 'File permission error. Local file could not be installed.', 'redux-framework' ) . ' ' . $subtype,
-								)
-							);
-
-							die;
-						}
-					}
-				} elseif ( false === $this->convert_local_font() ) {
-						echo wp_json_encode(
-							array(
-								'type' => 'error',
-								'msg'  => esc_html__( 'File permission error. Local file could not be installed.', 'redux-framework' ) . ' ' . $subtype,
-							)
-						);
-
-						die;
-				}
-
-				Redux_Core::$filesystem->execute( 'rmdir', $temp, array( 'recursive' => true ) );
-
-				$this->generate_css();
-
-				wp_delete_attachment( $attachment_id, true );
-			} else {
-				echo wp_json_encode(
-					array(
-						'type' => 'error',
-						'msg'  => esc_html__( 'File type not recognized.', 'redux-framework' ) . ' ' . $subtype,
-					)
-				);
-
-				die();
-			}
-
-			if ( is_array( $ret ) && ! empty( $ret ) ) {
-				$msg = esc_html__( 'Unidentified error.', 'redux-framework' );
-
-				if ( isset( $ret['msg'] ) ) {
-					$msg = $ret['msg'];
-				}
-
-				return $msg;
-			}
-
-			return '';
-		}
-
-		/**
-		 * Install selected file into Custom Fonts.
-		 *
-		 * @return bool
-		 */
-		private function convert_local_font(): bool {
-			$param_array = array(
-				'destination' => $this->upload_dir . $this->subfolder . '/' . $this->font_folder . '/' . $this->font_filename,
-				'overwrite'   => true,
-				'chmod'       => 755,
-			);
-
-			return Redux_Core::$filesystem->execute( 'copy', $this->selected_file, $param_array );
-		}
-
-		/**
-		 * Ping the WebFontOMatic API to get the missing files.
-		 *
-		 * @param string $fontname  Font name.
-		 * @param array  $missing   Missing.
-		 * @param array  $output    Output.
-		 */
-		private function get_missing_files( string $fontname, array $missing, array $output ) {
-			if ( ! empty( $this->font_folder ) && ! empty( $missing ) ) {
-				$temp = $this->upload_dir . 'temp';
-
-				$font_ext = pathinfo( $this->font_filename, PATHINFO_EXTENSION );
-
-				$unsupported = array( 'eot', 'woff', 'woff2' );
-
-				// Find a file to convert from.
-				foreach ( $output as $key => $value ) {
-					if ( 'eot' === $key ) {
-						continue;
-					} else {
-						$main = $key;
-						break;
-					}
-				}
-
-				if ( ! isset( $main ) ) {
-					echo wp_json_encode(
-						array(
-							'type' => 'error',
-							'msg'  => esc_html__( 'No valid font file was found.', 'redux-framework' ),
-						)
-					);
-
-					Redux_Core::$filesystem->execute( 'rmdir', $temp, array( 'recursive' => true ) );
-					Redux_Core::$filesystem->execute( 'rmdir', $this->upload_dir . $this->subfolder . $this->font_folder . '/', array( 'recursive' => true ) );
-
-					die();
-				}
-
-				update_option( 'redux_custom_font_current', $this->font_folder . '.zip' );
-
-				$boundary = wp_generate_password( 24 );
-
-				$headers = array(
-					'content-type' => 'multipart/form-data; boundary=' . $boundary,
-					'user-agent'   => 'redux-custom-fonts-' . self::$version . ' using ' . wp_get_theme(),
-				);
-
-				$payload  = '--' . $boundary;
-				$payload .= "\r\n";
-				$payload .= 'Content-Disposition: form-data; name="md5"' . "\r\n\r\n";
-				$payload .= md5( 'redux_custom_font' );
-				$payload .= "\r\n";
-
-				if ( $output[ $main ] ) {
-					$payload .= '--' . $boundary;
-					$payload .= "\r\n";
-					$payload .= 'Content-Disposition: form-data; name="convert"; filename="' . basename( $output[ $main ] ) . '"' . "\r\n";
-					$payload .= "\r\n";
-					$payload .= Redux_Core::$filesystem->execute( 'get_contents', $output[ $main ] );
-					$payload .= "\r\n";
-				}
-
-				$payload .= '--' . $boundary . '--';
-
-				$args = array(
-					'headers'    => $headers,
-					'body'       => $payload,
-					'user-agent' => $headers['user-agent'],
-					'timeout'    => 300,
-					'sslverify'  => true,
-				);
-
-				// phpcs:disable WordPress.NamingConventions.ValidHookName
-				$api_url = apply_filters( 'redux/' . $this->parent->args['opt_name'] . '/extensions/custom_fonts/api_url', 'https://redux.io/fonts' );
-
-				$response = wp_remote_post( $api_url, $args );
-
-				if ( is_wp_error( $response ) ) {
-					return array(
-						'type' => 'error',
-						'msg'  => $response->get_error_message() . '<br><br>' . esc_html__( 'Your font could not be converted at this time. Please try again later.', 'redux-framework' ),
-					);
-				} elseif ( isset( $response['body'] ) ) {
-					if ( null !== json_decode( $response['body'] ) ) {
-						return json_decode( $response['body'], true );
-					}
-				}
-
-				$param_array = array(
-					'content'   => $response['body'],
-					'overwrite' => true,
-					'chmod'     => FS_CHMOD_FILE,
-				);
-
-				$zip_file = $temp . DIRECTORY_SEPARATOR . $fontname . '.zip';
-
-				Redux_Core::$filesystem->execute( 'put_contents', $zip_file, $param_array );
-
-				if ( 0 === filesize( $zip_file ) ) {
-					return false;
-				}
-
-				$zip = unzip_file( $zip_file, $temp );
-
-				if ( ! is_wp_error( $zip ) ) {
-					$params = array(
-						'include_hidden' => false,
-						'recursive'      => false,
-					);
-
-					$files = Redux_Core::$filesystem->execute( 'dirlist', $temp . DIRECTORY_SEPARATOR . 'fonts' . DIRECTORY_SEPARATOR, $params );
-
-					foreach ( $files as $file ) {
-						$param_array = array(
-							'destination' => $this->upload_dir . $this->subfolder . $this->font_folder . DIRECTORY_SEPARATOR . sanitize_file_name( $file['name'] ),
-							'overwrite'   => true,
-							'chmod'       => 755,
-						);
-
-						Redux_Core::$filesystem->execute( 'move', $temp . DIRECTORY_SEPARATOR . 'fonts' . DIRECTORY_SEPARATOR . ( $file['name'] ), $param_array );
-					}
-				} else {
-					$path_parts = pathinfo( $output[ $main ] );
-
-					$param_array = array(
-						'destination' => $this->upload_dir . $this->subfolder . $this->font_folder . DIRECTORY_SEPARATOR . sanitize_file_name( $path_parts['basename'] ),
-						'overwrite'   => true,
-						'chmod'       => 755,
-					);
-
-					Redux_Core::$filesystem->execute( 'move', $output[ $main ], $param_array );
-
-					if ( in_array( $font_ext, $unsupported, true ) ) {
-						return array(
-							'type' => 'error',
-							// translators: %s = font extension.
-							'msg'  => $zip->get_error_message() . '<br><br>' . sprintf( esc_html__( 'The font converter does not support %s fonts.', 'redux-framework' ), $font_ext ),
-						);
-					} else {
-						return array(
-							'type' => 'error',
-							'msg'  => $zip->get_error_message() . '<br><br>' . esc_html__( 'ZIP error. Your font could not be converted at this time. Please try again later.', 'redux-framework' ),
-						);
-					}
-				}
-
-				delete_option( 'redux_custom_font_current' );
-			}
-
-			return true;
-		}
-
-		/**
-		 * Check if the file name is a valid font file.
-		 *
-		 * @param array $file File.
-		 *
-		 * @return bool|string
-		 */
-		private function check_font_name( array $file ) {
-			if ( '.woff' === strtolower( substr( $file['name'], - 5 ) ) ) {
-				return 'woff';
-			}
-
-			if ( '.woff2' === strtolower( substr( $file['name'], - 6 ) ) ) {
-				return 'woff2';
-			}
-
-			$sub = strtolower( substr( $file['name'], - 4 ) );
-
-			if ( '.ttf' === $sub ) {
-				return 'ttf';
-			}
-
-			if ( '.eot' === $sub ) {
-				return 'eot';
-			}
-
-			if ( '.svg' === $sub ) {
-				return 'svg';
-			}
-
-			if ( '.otf' === $sub ) {
-				return 'otf';
-			}
-
-			return false;
-		}
-
-		/**
-		 * Generate a new custom CSS file for enqueuing on the frontend and backend.
-		 */
-		private function generate_css() {
-			$params = array(
-				'include_hidden' => false,
-				'recursive'      => true,
-			);
-
-			$fonts = Redux_Core::$filesystem->execute( 'dirlist', $this->upload_dir . 'custom' . DIRECTORY_SEPARATOR, $params );
-
-			if ( empty( $fonts ) || ! is_array( $fonts ) ) {
-				return;
-			}
-
-			foreach ( $fonts as $font ) {
-				if ( 'd' === $font['type'] ) {
-					break;
-				}
-
-				if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
-					Redux_Core::$filesystem->execute( 'delete', $this->upload_dir . 'fonts.css' );
-				}
-
-				return;
-			}
-
-			$css = '';
-
-			foreach ( $fonts as $font ) {
-				if ( 'd' === $font['type'] ) {
-					$css .= $this->generate_font_css( $font['name'], $this->upload_dir . 'custom' . DIRECTORY_SEPARATOR );
-				}
-			}
-
-			if ( '' !== $css ) {
-				$param_array = array(
-					'content' => $css,
-					'chmod'   => FS_CHMOD_FILE,
-				);
-
-				Redux_Core::$filesystem->execute( 'put_contents', $this->upload_dir . 'fonts.css', $param_array );
-			}
-		}
-
-		/**
-		 * Process to actually construct the custom font css file.
-		 *
-		 * @param string $name Name.
-		 * @param string $dir  Directory.
-		 *
-		 * @return string
-		 */
-		private function generate_font_css( string $name, string $dir ): ?string {
-			$path = $dir . $name;
-
-			$params = array(
-				'include_hidden' => false,
-				'recursive'      => true,
-			);
-
-			$files = Redux_Core::$filesystem->execute( 'dirlist', $path, $params );
-
-			if ( empty( $files ) ) {
-				return null;
-			}
-
-			$output = array();
-
-			foreach ( $files as $file ) {
-				$output[ $this->check_font_name( $file ) ] = $file['name'];
-			}
-
-			$css = '@font-face {';
-
-			$css .= 'font-family:"' . $name . '";';
-
-			$src = array();
-
-			if ( isset( $output['eot'] ) ) {
-				$src[] = "url('{$this->upload_url}custom/$name/{$output['eot']}?#iefix') format('embedded-opentype')";
-			}
-
-			if ( isset( $output['woff'] ) ) {
-				$src[] = "url('{$this->upload_url}custom/$name/{$output['woff']}') format('woff')";
-			}
-
-			if ( isset( $output['woff2'] ) ) {
-				$src[] = "url('{$this->upload_url}custom/$name/{$output['woff2']}') format('woff2')";
-			}
-
-			if ( isset( $output['ttf'] ) ) {
-				$src[] = "url('{$this->upload_url}custom/$name/{$output['ttf']}') format('truetype')";
-			}
-
-			if ( isset( $output['svg'] ) ) {
-				$src[] = "url('{$this->upload_url}custom/$name/{$output['svg']}#svg$name') format('svg')";
-			}
-
-			if ( ! empty( $src ) ) {
-				$css .= 'src:' . implode( ', ', $src ) . ';';
-			}
-
-			// Replace font weight and style with sub-sets.
-			$css .= 'font-weight: normal;';
-
-			$css .= 'font-style: normal;';
-
-			$css .= '}';
-
-			return $css;
-		}
-
-		/**
-		 * Custom function for filtering the section array.
-		 * Good for child themes to override or add to the sections.
-		 * Simply include this function in the child themes functions.php file.
-		 * NOTE: the defined constants for URLs and directories will NOT be available at this point in a child theme,
-		 * so you must use get_template_directory_uri() if you want to use any of the built-in icons
-		 */
-		public function add_section() {
-			if ( ! isset( $this->parent->fontControl ) ) {
-				$this->parent->sections[] = array(
-					'title'  => esc_html__( 'Font Control', 'redux-framework' ),
-					'desc'   => '<p class="description"></p>',
-					'icon'   => 'el-icon-font',
-					'id'     => 'redux_dynamic_font_control',
-					// Leave this as a blank section, no options just some intro text set above.
-					'fields' => array(),
-				);
-
-				for ( $i = count( $this->parent->sections ); $i >= 1; $i-- ) {
-					if ( isset( $this->parent->sections[ $i ] ) && isset( $this->parent->sections[ $i ]['title'] ) && esc_html__( 'Font Control', 'redux-framework' ) === $this->parent->sections[ $i ]['title'] ) {
-						$this->parent->fontControl                                        = $i;
-						$this->parent->sections[ $this->parent->fontControl ]['fields'][] = array(
-							'id'   => 'redux_font_control',
-							'type' => 'custom_fonts',
-						);
-
-						break;
-					}
-				}
-			}
-		}
-	}
-
-	class_alias( Redux_Extension_Custom_Fonts::class, 'ReduxFramework_Extension_custom_fonts' );
+    /**
+     * Class Redux_Extension_Custom_Fonts
+     */
+    class Redux_Extension_Custom_Fonts extends Redux_Extension_Abstract {
+
+        /**
+         * Extension version.
+         *
+         * @var string
+         */
+        public static $version = '4.5.6';
+
+        /**
+         * Extension friendly name.
+         *
+         * @var string
+         */
+        public string $extension_name = 'Custom Fonts';
+        /**
+         * Class instance.
+         *
+         * @var object|null
+         */
+        public static ?object $instance;
+
+        /**
+         * Custom fonts array.
+         *
+         * @var array|null
+         */
+        public ?array $custom_fonts = array();
+
+        /**
+         * WordPress upload directory.
+         *
+         * @var string|null
+         */
+        public ?string $upload_dir = '';
+
+        /**
+         * WordPress upload URI.
+         *
+         * @var string|null
+         */
+        public ?string $upload_url = '';
+
+        /**
+         * Subfolder name.
+         *
+         * @var string
+         */
+        public string $subfolder = 'custom/';
+
+        /**
+         * Font folder.
+         *
+         * @var string|null
+         */
+        public ?string $font_folder = '';
+
+        /**
+         * Font Filename.
+         *
+         * @var string|null
+         */
+        public ?string $font_filename = '';
+
+        /**
+         * File selected in media upload.
+         *
+         * @var string|null
+         */
+        public ?string $selected_file = '';
+
+        /**
+         * Is font conversation service available?
+         *
+         * @var bool
+         */
+        private bool $can_convert;
+
+        /**
+         * Class Constructor. Defines the args for the extensions class
+         *
+         * @param ReduxFramework $redux ReduxFramework pointer.
+         *
+         * @return      void
+         * @since       1.0.0
+         * @access      public
+         */
+        public function __construct( $redux ) {
+            if ( false === $redux->args['custom_fonts'] ) {
+                return;
+            }
+
+            parent::__construct( $redux, __FILE__ );
+
+            self::$instance = parent::get_instance();
+
+            $this->add_field( 'custom_fonts' );
+
+            $this->upload_dir = Redux_Core::$upload_dir . 'custom-fonts/';
+            $this->upload_url = Redux_Core::$upload_url . 'custom-fonts/';
+
+            if ( ! is_dir( $this->upload_dir ) ) {
+                Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir );
+            }
+
+            if ( ! is_dir( $this->upload_dir . '/custom' ) ) {
+                Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . '/custom' );
+            }
+
+            $this->get_fonts();
+
+            if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
+                if ( filemtime( $this->upload_dir . 'custom' ) > ( filemtime( $this->upload_dir . 'fonts.css' ) + 10 ) ) {
+                    $this->generate_css();
+                }
+            } else {
+                $this->generate_css();
+            }
+
+            add_action( 'wp_ajax_redux_custom_fonts', array( $this, 'ajax' ) );
+            add_action( 'wp_ajax_redux_custom_font_timer', array( $this, 'timer' ) );
+
+            add_filter( "redux/{$this->parent->args['opt_name']}/field/typography/custom_fonts", array( $this, 'add_custom_fonts' ) );
+
+            // phpcs:disable
+            // $this->is_field = Redux_Helpers::is_field_in_use( $parent, 'custom_fonts' );
+
+            // if ( ! $this->is_field ) {
+            // 	$this->add_section();
+            // }
+
+            add_filter( "redux/options/{$this->parent->args['opt_name']}/section/redux_dynamic_font_control", array( $this, 'remove_dynamic_section' ) ); // phpcs:ignore WordPress.NamingConventions.ValidHookName
+            add_filter( 'upload_mimes', array( $this, 'custom_upload_mimes' ) );
+            add_action( 'wp_head', array( $this, 'enqueue_output' ), 150 );
+            add_filter( 'tiny_mce_before_init', array( $this, 'extend_tinymce_dropdown' ) );
+
+            $this->can_convert = true; // has_filter( 'redux/' . $this->parent->args['opt_name'] . '/extensions/custom_fonts/api_url' );
+            // phpcs:enable
+        }
+
+        /**
+         * Timer.
+         */
+        public function timer() {
+            $name = get_option( 'redux_custom_font_current' );
+
+            if ( ! empty( $name ) ) {
+                echo esc_html( $name );
+            }
+
+            die();
+        }
+
+        /**
+         * Remove the dynamically added section if the field was used elsewhere
+         *
+         * @param array $section Section array.
+         *
+         * @return array
+         * @since  Redux_Framework 3.1.1
+         */
+        public function remove_dynamic_section( array $section ): array {
+            if ( isset( $this->parent->field_types['custom_fonts'] ) ) {
+                $section = array();
+            }
+
+            return $section;
+        }
+
+        /**
+         * Adds FontMeister fonts to the TinyMCE drop-down.
+         * Typekit's fonts don't render properly in the drop-down and in the editor,
+         * because Typekit needs JS and TinyMCE doesn't support that.
+         *
+         * @param array $opt Option array.
+         *
+         * @return array
+         */
+        public function extend_tinymce_dropdown( array $opt ): array {
+            if ( ! is_admin() ) {
+                return $opt;
+            }
+
+            if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
+                $theme_advanced_fonts = $opt['font_formats'] ?? 'Andale Mono=andale mono,times;Arial=arial,helvetica,sans-serif;Arial Black=arial black,avant garde;Book Antiqua=book antiqua,palatino;Comic Sans MS=comic sans ms,sans-serif;Courier New=courier new,courier;Georgia=georgia,palatino;Helvetica=helvetica;Impact=impact,chicago;Symbol=symbol;Tahoma=tahoma,arial,helvetica,sans-serif;Terminal=terminal,monaco;Times New Roman=times new roman,times;Trebuchet MS=trebuchet ms,geneva;Verdana=verdana,geneva;Webdings=webdings;Wingdings=wingdings,zapf dingbats';
+                $custom_fonts         = '';
+
+                $stylesheet = $this->upload_url . 'fonts.css';
+
+                if ( empty( $opt['content_css'] ) ) {
+                    $opt['content_css'] = $stylesheet;
+                } else {
+                    $opt['content_css'] = $opt['content_css'] . ',' . $stylesheet;
+                }
+
+                foreach ( $this->custom_fonts as $arr ) {
+                    foreach ( $arr as $font => $pieces ) {
+                        $custom_fonts .= ';' . $font . '=' . $font;
+                    }
+                }
+
+                $opt['font_formats'] = $theme_advanced_fonts . $custom_fonts;
+            }
+
+            return $opt;
+        }
+
+
+        /**
+         * Function to enqueue the custom fonts css
+         */
+        public function enqueue_output() {
+            if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
+                wp_enqueue_style(
+                    'redux-custom-fonts',
+                    $this->upload_url . 'fonts.css',
+                    array(),
+                    filemtime( $this->upload_dir . 'fonts.css' )
+                );
+            }
+        }
+
+        /**
+         * Adds the appropriate mime types to WordPress
+         *
+         * @param array $existing_mimes Mine array.
+         *
+         * @return array
+         */
+        public function custom_upload_mimes( array $existing_mimes = array() ): array {
+            $existing_mimes['ttf']   = 'font/ttf';
+            $existing_mimes['otf']   = 'font/otf';
+            $existing_mimes['eot']   = 'application/vnd.ms-fontobject';
+            $existing_mimes['woff']  = 'application/font-woff';
+            $existing_mimes['woff2'] = 'application/font-woff2';
+            $existing_mimes['svg']   = 'image/svg+xml';
+            $existing_mimes['zip']   = 'application/zip';
+
+            return $existing_mimes;
+        }
+
+        /**
+         * Gets all the fonts in the custom_fonts directory
+         */
+        public function get_fonts() {
+            if ( empty( $this->custom_fonts ) ) {
+                $params = array(
+                    'include_hidden' => false,
+                    'recursive'      => true,
+                );
+
+                $fonts = Redux_Core::$filesystem->execute( 'dirlist', $this->upload_dir, $params );
+
+                if ( ! empty( $fonts ) ) {
+                    foreach ( $fonts as $section ) {
+                        if ( 'd' === $section['type'] && ! empty( $section['name'] ) ) {
+                            if ( 'custom' === $section['name'] ) {
+                                $section['name'] = esc_html__( 'Custom Fonts', 'redux-framework' );
+                            }
+
+                            if ( empty( $section['files'] ) ) {
+                                continue;
+                            }
+
+                            $this->custom_fonts[ $section['name'] ] = $this->custom_fonts[ $section['name'] ] ?? array();
+
+                            foreach ( $section['files'] as $font ) {
+                                if ( ! empty( $font['name'] ) ) {
+                                    if ( empty( $font['files'] ) ) {
+                                        continue;
+                                    }
+
+                                    $kinds = array();
+
+                                    foreach ( $font['files'] as $f ) {
+                                        $valid = $this->check_font_name( $f );
+                                        if ( $valid ) {
+                                            $kinds[] = $valid;
+                                        }
+                                    }
+
+                                    $this->custom_fonts[ $section['name'] ][ $font['name'] ] = $kinds;
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        /**
+         * Add custom fonts.
+         *
+         * @param mixed $custom_fonts Custom fonts.
+         *
+         * @return array
+         */
+        public function add_custom_fonts( $custom_fonts ): array {
+            if ( empty( $custom_fonts ) ) {
+                $custom_fonts = array();
+            }
+
+            return wp_parse_args( $custom_fonts, $this->custom_fonts );
+        }
+
+        /**
+         * Ajax used within the panel to add and process the fonts
+         */
+        public function ajax() {
+            if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_key( wp_unslash( $_POST['nonce'] ) ), 'redux_custom_fonts' ) ) {
+                die( 0 );
+            }
+
+            if ( isset( $_POST['type'] ) && 'delete' === $_POST['type'] ) {
+                if ( isset( $_POST['section'] ) ) {
+                    if ( esc_html__( 'Custom Fonts', 'redux-framework' ) === $_POST['section'] ) {
+                        $_POST['section'] = 'custom';
+                    }
+                }
+
+                try {
+                    if ( isset( $_POST['section'] ) || isset( $_POST['name'] ) ) {
+                        $ret = Redux_Core::$filesystem->execute( 'rmdir', $this->upload_dir . sanitize_file_name( wp_unslash( $_POST['section'] ) ) . '/' . sanitize_file_name( wp_unslash( $_POST['name'] ) ) . '/', array( 'recursive' => true ) );
+
+                        if ( true === $ret ) {
+                            $result = array( 'type' => 'success' );
+                        } else {
+                            $result = array(
+                                'type' => 'error',
+                                'msg'  => esc_html__( 'File system failure. Could not delete temp dir.', 'redux-framework' ),
+                            );
+                        }
+
+                        echo wp_json_encode( $result );
+                    }
+                } catch ( Exception $e ) {
+                    echo wp_json_encode(
+                        array(
+                            'type' => 'error',
+                            'msg'  => esc_html__( 'Unable to delete font file(s).', 'redux-framework' ),
+                        )
+                    );
+                }
+
+                die();
+            }
+
+            if ( ! isset( $_POST['title'] ) ) {
+                $_POST['title'] = '';
+            }
+
+            if ( ! isset( $_POST['filename'] ) ) {
+                $_POST['filename'] = '';
+            }
+
+            $this->font_folder   = sanitize_file_name( wp_unslash( $_POST['title'] ) );
+            $this->font_filename = sanitize_file_name( wp_unslash( $_POST['filename'] ) );
+
+            if ( ! empty( $_POST['attachment_id'] ) ) {
+                if ( isset( $_POST['title'] ) || isset( $_POST['mime'] ) ) {
+                    $msg = $this->process_web_font( sanitize_key( wp_unslash( $_POST['attachment_id'] ) ), sanitize_text_field( wp_unslash( $_POST['mime'] ) ) );
+
+                    if ( empty( $msg ) ) {
+                        $msg = '';
+                    }
+
+                    $result = array(
+                        'type' => 'success',
+                        'msg'  => $msg,
+                    );
+
+                    echo wp_json_encode( $result );
+                }
+            }
+
+            die();
+        }
+
+        /**
+         * Get only valid files. Ensure everything is proper for processing.
+         *
+         * @param string $path Path.
+         *
+         * @return array
+         */
+        public function get_valid_files( string $path ): array {
+            $output = array();
+            $path   = trailingslashit( $path );
+
+            $params = array(
+                'include_hidden' => false,
+                'recursive'      => true,
+            );
+
+            $files = Redux_Core::$filesystem->execute( 'dirlist', $path, $params );
+
+            foreach ( $files as $file ) {
+                if ( 'd' === $file['type'] ) {
+                    $output = array_merge( $output, $this->get_valid_files( $path . $file['name'] ) );
+                } elseif ( 'f' === $file['type'] ) {
+                    $valid = $this->check_font_name( $file );
+                    if ( $valid ) {
+                        $output[ $valid ] = trailingslashit( $path ) . $file['name'];
+                    }
+                }
+            }
+
+            return $output;
+        }
+
+        /**
+         * Take a valid web font and process the missing pieces.
+         *
+         * @param string $attachment_id ID.
+         * @param string $mime_type     Mine type.
+         */
+        public function process_web_font( string $attachment_id, string $mime_type ) {
+            // phpcs:ignore WordPress.Security.NonceVerification
+            if ( ! isset( $_POST['conversion'] ) ) {
+                $_POST['conversion'] = 'false';
+            }
+
+            // phpcs:ignore WordPress.Security.NonceVerification
+            $conversion = sanitize_text_field( wp_unslash( $_POST['conversion'] ) );
+
+            $missing = array();
+
+            $complete = array(
+                'ttf',
+                'woff',
+                'woff2',
+                'eot',
+                'svg',
+                'otf',
+            );
+
+            $subtype = explode( '/', $mime_type );
+            $subtype = trim( max( $subtype ) );
+
+            if ( ! is_dir( $this->upload_dir ) ) {
+                Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir );
+            }
+
+            if ( ! is_dir( $this->upload_dir . $this->subfolder ) ) {
+                Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . $this->subfolder );
+            }
+
+            $temp                = $this->upload_dir . 'temp';
+            $this->selected_file = get_attached_file( $attachment_id );
+
+            if ( empty( $this->selected_file ) ) {
+                echo wp_json_encode(
+                    array(
+                        'type' => 'error',
+                        'msg'  => esc_html__( 'Attachment does not exist.', 'redux-framework' ),
+                    )
+                );
+
+                die();
+            }
+
+            $filename = explode( '/', $this->selected_file );
+
+            $filename = $filename[ ( count( $filename ) - 1 ) ];
+
+            $fontname = ucfirst(
+                str_replace(
+                    array(
+                        '.zip',
+                        '.ttf',
+                        '.woff',
+                        '.woff2',
+                        '.eot',
+                        '.svg',
+                        '.otf',
+                    ),
+                    '',
+                    strtolower( $filename )
+                )
+            );
+
+            if ( empty( $this->font_folder ) ) {
+                $this->font_folder = $fontname;
+            }
+
+            $ret = array();
+
+            if ( ! is_dir( $temp ) ) {
+                Redux_Core::$filesystem->execute( 'mkdir', $temp );
+            }
+
+            if ( 'zip' === $subtype ) {
+                $unzipfile = unzip_file( $this->selected_file, $temp );
+
+                if ( is_wp_error( $unzipfile ) ) {
+                    echo wp_json_encode(
+                        array(
+                            'type' => 'error',
+                            'msg'  => $unzipfile->get_error_message() . '<br><br>' . esc_html__( 'Unzipping failed.', 'redux-framework' ),
+                        )
+                    );
+
+                    die();
+                }
+
+                $output = $this->get_valid_files( $temp );
+
+                if ( ! empty( $output ) ) {
+                    foreach ( $complete as $test ) {
+                        if ( ! isset( $output[ $test ] ) ) {
+                            $missing[] = $test;
+                        }
+                    }
+
+                    if ( ! is_dir( $this->upload_dir . $this->subfolder . $this->font_folder . '/' ) ) {
+                        Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . $this->subfolder . $this->font_folder . '/' );
+                    }
+
+                    foreach ( $output as $key => $value ) {
+                        $param_array = array(
+                            'destination' => $this->upload_dir . $this->subfolder . $this->font_folder . '/' . $fontname . '.' . $key,
+                            'overwrite'   => true,
+                            'chmod'       => 755,
+                        );
+
+                        Redux_Core::$filesystem->execute( 'copy', $value, $param_array );
+                    }
+
+                    if ( true === $this->can_convert && 'true' === $conversion ) {
+                        $ret = $this->get_missing_files( $fontname, $missing, $output );
+                    }
+                }
+
+                Redux_Core::$filesystem->execute( 'rmdir', $temp, array( 'recursive' => true ) );
+
+                $this->generate_css();
+
+                wp_delete_attachment( $attachment_id, true );
+            } elseif ( 'svg+xml' === $subtype || 'vnd.ms-fontobject' === $subtype || 'x-font-ttf' === $subtype || 'ttf' === $subtype || 'otf' === $subtype || 'font-woff' === $subtype || 'font-woff2' === $subtype || 'application-octet-stream' === $subtype || 'octet-stream' === $subtype ) {
+                foreach ( $complete as $test ) {
+                    if ( $subtype !== $test ) {
+                        if ( ! isset( $output[ $test ] ) ) {
+                            $missing[] = $test;
+                        }
+                    }
+                }
+
+                if ( ! is_dir( $this->upload_dir . $this->subfolder . $this->font_folder . '/' ) ) {
+                    Redux_Core::$filesystem->execute( 'mkdir', $this->upload_dir . $this->subfolder . $this->font_folder . '/' );
+                }
+
+                $output = array( $subtype => $this->selected_file );
+
+                if ( true === $this->can_convert && 'true' === $conversion ) {
+                    $ret = $this->get_missing_files( $fontname, $missing, $output );
+
+                    if ( false === $ret ) {
+                        if ( false === $this->convert_local_font() ) {
+                            echo wp_json_encode(
+                                array(
+                                    'type' => 'error',
+                                    'msg'  => esc_html__( 'File permission error. Local file could not be installed.', 'redux-framework' ) . ' ' . $subtype,
+                                )
+                            );
+
+                            die;
+                        }
+                    }
+                } elseif ( false === $this->convert_local_font() ) {
+                        echo wp_json_encode(
+                            array(
+                                'type' => 'error',
+                                'msg'  => esc_html__( 'File permission error. Local file could not be installed.', 'redux-framework' ) . ' ' . $subtype,
+                            )
+                        );
+
+                        die;
+                }
+
+                Redux_Core::$filesystem->execute( 'rmdir', $temp, array( 'recursive' => true ) );
+
+                $this->generate_css();
+
+                wp_delete_attachment( $attachment_id, true );
+            } else {
+                echo wp_json_encode(
+                    array(
+                        'type' => 'error',
+                        'msg'  => esc_html__( 'File type not recognized.', 'redux-framework' ) . ' ' . $subtype,
+                    )
+                );
+
+                die();
+            }
+
+            if ( is_array( $ret ) && ! empty( $ret ) ) {
+                $msg = esc_html__( 'Unidentified error.', 'redux-framework' );
+
+                if ( isset( $ret['msg'] ) ) {
+                    $msg = $ret['msg'];
+                }
+
+                return $msg;
+            }
+
+            return '';
+        }
+
+        /**
+         * Install selected file into Custom Fonts.
+         *
+         * @return bool
+         */
+        private function convert_local_font(): bool {
+            $param_array = array(
+                'destination' => $this->upload_dir . $this->subfolder . '/' . $this->font_folder . '/' . $this->font_filename,
+                'overwrite'   => true,
+                'chmod'       => 755,
+            );
+
+            return Redux_Core::$filesystem->execute( 'copy', $this->selected_file, $param_array );
+        }
+
+        /**
+         * Ping the WebFontOMatic API to get the missing files.
+         *
+         * @param string $fontname  Font name.
+         * @param array  $missing   Missing.
+         * @param array  $output    Output.
+         */
+        private function get_missing_files( string $fontname, array $missing, array $output ) {
+            if ( ! empty( $this->font_folder ) && ! empty( $missing ) ) {
+                $temp = $this->upload_dir . 'temp';
+
+                $font_ext = pathinfo( $this->font_filename, PATHINFO_EXTENSION );
+
+                $unsupported = array( 'eot', 'woff', 'woff2' );
+
+                // Find a file to convert from.
+                foreach ( $output as $key => $value ) {
+                    if ( 'eot' === $key ) {
+                        continue;
+                    } else {
+                        $main = $key;
+                        break;
+                    }
+                }
+
+                if ( ! isset( $main ) ) {
+                    echo wp_json_encode(
+                        array(
+                            'type' => 'error',
+                            'msg'  => esc_html__( 'No valid font file was found.', 'redux-framework' ),
+                        )
+                    );
+
+                    Redux_Core::$filesystem->execute( 'rmdir', $temp, array( 'recursive' => true ) );
+                    Redux_Core::$filesystem->execute( 'rmdir', $this->upload_dir . $this->subfolder . $this->font_folder . '/', array( 'recursive' => true ) );
+
+                    die();
+                }
+
+                update_option( 'redux_custom_font_current', $this->font_folder . '.zip' );
+
+                $boundary = wp_generate_password( 24 );
+
+                $headers = array(
+                    'content-type' => 'multipart/form-data; boundary=' . $boundary,
+                    'user-agent'   => 'redux-custom-fonts-' . self::$version . ' using ' . wp_get_theme(),
+                );
+
+                $payload  = '--' . $boundary;
+                $payload .= "\r\n";
+                $payload .= 'Content-Disposition: form-data; name="md5"' . "\r\n\r\n";
+                $payload .= md5( 'redux_custom_font' );
+                $payload .= "\r\n";
+
+                if ( $output[ $main ] ) {
+                    $payload .= '--' . $boundary;
+                    $payload .= "\r\n";
+                    $payload .= 'Content-Disposition: form-data; name="convert"; filename="' . basename( $output[ $main ] ) . '"' . "\r\n";
+                    $payload .= "\r\n";
+                    $payload .= Redux_Core::$filesystem->execute( 'get_contents', $output[ $main ] );
+                    $payload .= "\r\n";
+                }
+
+                $payload .= '--' . $boundary . '--';
+
+                $args = array(
+                    'headers'    => $headers,
+                    'body'       => $payload,
+                    'user-agent' => $headers['user-agent'],
+                    'timeout'    => 300,
+                    'sslverify'  => true,
+                );
+
+                // phpcs:disable WordPress.NamingConventions.ValidHookName
+                $api_url = apply_filters( 'redux/' . $this->parent->args['opt_name'] . '/extensions/custom_fonts/api_url', 'https://redux.io/fonts' );
+
+                $response = wp_remote_post( $api_url, $args );
+
+                if ( is_wp_error( $response ) ) {
+                    return array(
+                        'type' => 'error',
+                        'msg'  => $response->get_error_message() . '<br><br>' . esc_html__( 'Your font could not be converted at this time. Please try again later.', 'redux-framework' ),
+                    );
+                } elseif ( isset( $response['body'] ) ) {
+                    if ( null !== json_decode( $response['body'] ) ) {
+                        return json_decode( $response['body'], true );
+                    }
+                }
+
+                $param_array = array(
+                    'content'   => $response['body'],
+                    'overwrite' => true,
+                    'chmod'     => FS_CHMOD_FILE,
+                );
+
+                $zip_file = $temp . DIRECTORY_SEPARATOR . $fontname . '.zip';
+
+                Redux_Core::$filesystem->execute( 'put_contents', $zip_file, $param_array );
+
+                if ( 0 === filesize( $zip_file ) ) {
+                    return false;
+                }
+
+                $zip = unzip_file( $zip_file, $temp );
+
+                if ( ! is_wp_error( $zip ) ) {
+                    $params = array(
+                        'include_hidden' => false,
+                        'recursive'      => false,
+                    );
+
+                    $files = Redux_Core::$filesystem->execute( 'dirlist', $temp . DIRECTORY_SEPARATOR . 'fonts' . DIRECTORY_SEPARATOR, $params );
+
+                    foreach ( $files as $file ) {
+                        $param_array = array(
+                            'destination' => $this->upload_dir . $this->subfolder . $this->font_folder . DIRECTORY_SEPARATOR . sanitize_file_name( $file['name'] ),
+                            'overwrite'   => true,
+                            'chmod'       => 755,
+                        );
+
+                        Redux_Core::$filesystem->execute( 'move', $temp . DIRECTORY_SEPARATOR . 'fonts' . DIRECTORY_SEPARATOR . ( $file['name'] ), $param_array );
+                    }
+                } else {
+                    $path_parts = pathinfo( $output[ $main ] );
+
+                    $param_array = array(
+                        'destination' => $this->upload_dir . $this->subfolder . $this->font_folder . DIRECTORY_SEPARATOR . sanitize_file_name( $path_parts['basename'] ),
+                        'overwrite'   => true,
+                        'chmod'       => 755,
+                    );
+
+                    Redux_Core::$filesystem->execute( 'move', $output[ $main ], $param_array );
+
+                    if ( in_array( $font_ext, $unsupported, true ) ) {
+                        return array(
+                            'type' => 'error',
+                            // translators: %s = font extension.
+                            'msg'  => $zip->get_error_message() . '<br><br>' . sprintf( esc_html__( 'The font converter does not support %s fonts.', 'redux-framework' ), $font_ext ),
+                        );
+                    } else {
+                        return array(
+                            'type' => 'error',
+                            'msg'  => $zip->get_error_message() . '<br><br>' . esc_html__( 'ZIP error. Your font could not be converted at this time. Please try again later.', 'redux-framework' ),
+                        );
+                    }
+                }
+
+                delete_option( 'redux_custom_font_current' );
+            }
+
+            return true;
+        }
+
+        /**
+         * Check if the file name is a valid font file.
+         *
+         * @param array $file File.
+         *
+         * @return bool|string
+         */
+        private function check_font_name( array $file ) {
+            if ( '.woff' === strtolower( substr( $file['name'], - 5 ) ) ) {
+                return 'woff';
+            }
+
+            if ( '.woff2' === strtolower( substr( $file['name'], - 6 ) ) ) {
+                return 'woff2';
+            }
+
+            $sub = strtolower( substr( $file['name'], - 4 ) );
+
+            if ( '.ttf' === $sub ) {
+                return 'ttf';
+            }
+
+            if ( '.eot' === $sub ) {
+                return 'eot';
+            }
+
+            if ( '.svg' === $sub ) {
+                return 'svg';
+            }
+
+            if ( '.otf' === $sub ) {
+                return 'otf';
+            }
+
+            return false;
+        }
+
+        /**
+         * Generate a new custom CSS file for enqueuing on the frontend and backend.
+         */
+        private function generate_css() {
+            $params = array(
+                'include_hidden' => false,
+                'recursive'      => true,
+            );
+
+            $fonts = Redux_Core::$filesystem->execute( 'dirlist', $this->upload_dir . 'custom' . DIRECTORY_SEPARATOR, $params );
+
+            if ( empty( $fonts ) || ! is_array( $fonts ) ) {
+                return;
+            }
+
+            foreach ( $fonts as $font ) {
+                if ( 'd' === $font['type'] ) {
+                    break;
+                }
+
+                if ( file_exists( $this->upload_dir . 'fonts.css' ) ) {
+                    Redux_Core::$filesystem->execute( 'delete', $this->upload_dir . 'fonts.css' );
+                }
+
+                return;
+            }
+
+            $css = '';
+
+            foreach ( $fonts as $font ) {
+                if ( 'd' === $font['type'] ) {
+                    $css .= $this->generate_font_css( $font['name'], $this->upload_dir . 'custom' . DIRECTORY_SEPARATOR );
+                }
+            }
+
+            if ( '' !== $css ) {
+                $param_array = array(
+                    'content' => $css,
+                    'chmod'   => FS_CHMOD_FILE,
+                );
+
+                Redux_Core::$filesystem->execute( 'put_contents', $this->upload_dir . 'fonts.css', $param_array );
+            }
+        }
+
+        /**
+         * Process to actually construct the custom font css file.
+         *
+         * @param string $name Name.
+         * @param string $dir  Directory.
+         *
+         * @return string
+         */
+        private function generate_font_css( string $name, string $dir ): ?string {
+            $path = $dir . $name;
+
+            $params = array(
+                'include_hidden' => false,
+                'recursive'      => true,
+            );
+
+            $files = Redux_Core::$filesystem->execute( 'dirlist', $path, $params );
+
+            if ( empty( $files ) ) {
+                return null;
+            }
+
+            $output = array();
+
+            foreach ( $files as $file ) {
+                $output[ $this->check_font_name( $file ) ] = $file['name'];
+            }
+
+            $css = '@font-face {';
+
+            $css .= 'font-family:"' . $name . '";';
+
+            $src = array();
+
+            if ( isset( $output['eot'] ) ) {
+                $src[] = "url('{$this->upload_url}custom/$name/{$output['eot']}?#iefix') format('embedded-opentype')";
+            }
+
+            if ( isset( $output['woff'] ) ) {
+                $src[] = "url('{$this->upload_url}custom/$name/{$output['woff']}') format('woff')";
+            }
+
+            if ( isset( $output['woff2'] ) ) {
+                $src[] = "url('{$this->upload_url}custom/$name/{$output['woff2']}') format('woff2')";
+            }
+
+            if ( isset( $output['ttf'] ) ) {
+                $src[] = "url('{$this->upload_url}custom/$name/{$output['ttf']}') format('truetype')";
+            }
+
+            if ( isset( $output['svg'] ) ) {
+                $src[] = "url('{$this->upload_url}custom/$name/{$output['svg']}#svg$name') format('svg')";
+            }
+
+            if ( ! empty( $src ) ) {
+                $css .= 'src:' . implode( ', ', $src ) . ';';
+            }
+
+            // Replace font weight and style with sub-sets.
+            $css .= 'font-weight: normal;';
+
+            $css .= 'font-style: normal;';
+
+            $css .= '}';
+
+            return $css;
+        }
+
+        /**
+         * Custom function for filtering the section array.
+         * Good for child themes to override or add to the sections.
+         * Simply include this function in the child themes functions.php file.
+         * NOTE: the defined constants for URLs and directories will NOT be available at this point in a child theme,
+         * so you must use get_template_directory_uri() if you want to use any of the built-in icons
+         */
+        public function add_section() {
+            if ( ! isset( $this->parent->fontControl ) ) {
+                $this->parent->sections[] = array(
+                    'title'  => esc_html__( 'Font Control', 'redux-framework' ),
+                    'desc'   => '<p class="description"></p>',
+                    'icon'   => 'el-icon-font',
+                    'id'     => 'redux_dynamic_font_control',
+                    // Leave this as a blank section, no options just some intro text set above.
+                    'fields' => array(),
+                );
+
+                for ( $i = count( $this->parent->sections ); $i >= 1; $i-- ) {
+                    if ( isset( $this->parent->sections[ $i ] ) && isset( $this->parent->sections[ $i ]['title'] ) && esc_html__( 'Font Control', 'redux-framework' ) === $this->parent->sections[ $i ]['title'] ) {
+                        $this->parent->fontControl                                        = $i;
+                        $this->parent->sections[ $this->parent->fontControl ]['fields'][] = array(
+                            'id'   => 'redux_font_control',
+                            'type' => 'custom_fonts',
+                        );
+
+                        break;
+                    }
+                }
+            }
+        }
+    }
+
+    class_alias( Redux_Extension_Custom_Fonts::class, 'ReduxFramework_Extension_custom_fonts' );
 }

redux-core/inc/classes/class-redux-args.php

Indentation +386 added lines, -386 removed lines

@@ -11,390 +11,390 @@
 
 if ( ! class_exists( 'Redux_Args', false ) ) {
 
-	/**
-	 * Class Redux_Args
-	 */
-	class Redux_Args {
-
-		/**
-		 * Returns entire arguments array.
-		 *
-		 * @var array|mixed
-		 */
-		public $get = array();
-
-		/**
-		 * ReduxFramework object.
-		 *
-		 * @var ReduxFramework|null
-		 */
-		private ?ReduxFramework $parent;
-
-		/**
-		 * Switch to omit social icons if dev_mode is set to true and Redux defaults are used.
-		 *
-		 * @var bool
-		 */
-		public bool $omit_icons = false;
-
-		/**
-		 * Switch to omit support menu items if dev_mode is set to true and redux defaults are used.
-		 *
-		 * @var bool
-		 */
-		public bool $omit_items = false;
-
-		/**
-		 * Flag to force dev_mod to true if in localhost or WP_DEBUG is set to true.
-		 *
-		 * @var bool
-		 */
-		public bool $dev_mode_forced = false;
-
-		/**
-		 * Redux_Args constructor.
-		 *
-		 * @param ReduxFramework $redux ReduxFramework object.
-		 * @param array          $args  Global arguments array.
-		 */
-		public function __construct( ReduxFramework $redux, array $args ) {
-			$this->parent = $redux;
-
-			$default = array(
-				'opt_name'                         => '',
-				'last_tab'                         => '',
-				'menu_icon'                        => '',
-				'menu_title'                       => '',
-				'page_title'                       => '',
-				'page_slug'                        => '',
-				'page_permissions'                 => 'manage_options',
-				'menu_type'                        => 'menu',
-				'page_parent'                      => 'themes.php',
-				'page_priority'                    => null,
-				'allow_sub_menu'                   => true,
-				'save_defaults'                    => true,
-				'footer_credit'                    => '',
-				'async_typography'                 => false,
-				'disable_google_fonts_link'        => false,
-				'class'                            => '',
-				'admin_bar'                        => true,
-				'admin_bar_priority'               => 999,
-				'admin_bar_icon'                   => '',
-				'help_tabs'                        => array(),
-				'help_sidebar'                     => '',
-				'database'                         => '',
-				'customizer'                       => false,
-				'global_variable'                  => '',
-				'output'                           => true,
-				'output_variables_prefix'          => '--',
-				'compiler_output_variables_prefix' => '$',
-				'compiler'                         => true,
-				'output_tag'                       => true,
-				'output_location'                  => array( 'frontend' ),
-				'transient_time'                   => '',
-				'default_show'                     => false,
-				'default_mark'                     => '',
-				'disable_save_warn'                => false,
-				'open_expanded'                    => false,
-				'hide_expand'                      => false,
-				'network_admin'                    => false,
-				'network_sites'                    => true,
-				'hide_reset'                       => false,
-				'hide_save'                        => false,
-				'hints'                            => array(
-					'icon'          => 'el el-question-sign',
-					'icon_position' => 'right',
-					'icon_color'    => 'lightgray',
-					'icon_size'     => 'normal',
-					'tip_style'     => array(
-						'color'   => 'light',
-						'shadow'  => true,
-						'rounded' => false,
-						'style'   => '',
-					),
-					'tip_position'  => array(
-						'my' => 'top_left',
-						'at' => 'bottom_right',
-					),
-					'tip_effect'    => array(
-						'show' => array(
-							'effect'   => 'slide',
-							'duration' => '500',
-							'event'    => 'mouseover',
-						),
-						'hide' => array(
-							'effect'   => 'fade',
-							'duration' => '500',
-							'event'    => 'click mouseleave',
-						),
-					),
-				),
-				'font_weights'                     => array(
-					array(
-						'id'   => '400',
-						'name' => __( 'Regular 400', 'redux-framework' ),
-					),
-					array(
-						'id'   => '400italic',
-						'name' => __( 'Regular 400 Italic', 'redux-framework' ),
-					),
-					array(
-						'id'   => '700',
-						'name' => __( 'Bold 700', 'redux-framework' ),
-					),
-					array(
-						'id'   => '700italic',
-						'name' => __( 'Bold 700 Italic', 'redux-framework' ),
-					),
-				),
-				'show_import_export'               => true,
-				'show_options_object'              => true,
-				'dev_mode'                         => true,
-				'templates_path'                   => '',
-				'ajax_save'                        => true,
-				'use_cdn'                          => true,
-				'cdn_check_time'                   => 1440,
-				'options_api'                      => true,
-				'allow_tracking'                   => true,
-				'admin_theme'                      => 'wp',
-				'elusive_frontend'                 => false,
-				'fontawesome_frontend'             => false,
-				'flyout_submenus'                  => true,
-				'font_display'                     => 'swap', // block|swap|fallback|optional.
-				'load_on_cron'                     => false,
-				'search'                           => false,
-				'widget_area'                      => false,
-				'custom_fonts'                     => true,
-			);
-
-			$args = Redux_Functions::parse_args( $args, $default );
-
-			$args = $this->args( $args );
-
-			$args = $this->default_cleanup( $args );
-
-			if ( ! in_array( $args['font_display'], array( 'block', 'swap', 'fallback', 'optional' ), true ) ) {
-				$args['font_display'] = 'swap';
-			}
-
-			if ( isset( $args['async_typography'] ) && $args['async_typography'] ) {
-				$args['async_typography'] = false;
-			}
-
-			$this->get = $args;
-
-			$this->parent->args = $args;
-
-			if ( 'redux_extensions_demo' !== $args['opt_name'] && 'redux_demo' !== $args['opt_name'] ) {
-				$this->change_demo_defaults( $args );
-			}
-		}
-
-		/**
-		 * Builds and sanitizes a global args array.
-		 *
-		 * @param     array $args Global args.
-		 *
-		 * @return array
-		 */
-		private function args( array $args ): array {
-			$args = $this->no_errors_please( $args );
-
-			$this->parent->old_opt_name = $args['opt_name'];
-
-			$args = $this->filters( $args );
-
-			if ( ! function_exists( 'wp_rand' ) ) {
-				require_once ABSPATH . '/wp-includes/pluggable.php';
-			}
-
-			if ( $args['opt_name'] === $this->parent->old_opt_name ) {
-				$this->parent->old_opt_name = null;
-				unset( $this->parent->old_opt_name );
-			}
-
-			// Do not save the defaults if we're on a live preview!
-			if ( 'customize' === $GLOBALS['pagenow'] && isset( $_GET['customize_theme'] ) && ! empty( $_GET['customize_theme'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
-				$args['save_defaults'] = false;
-			}
-
-			return $this->shim( $args );
-		}
-
-		/**
-		 * Apply filters to arg data.
-		 *
-		 * @param     array $args Global args.
-		 *
-		 * @return mixed|void
-		 */
-		private function filters( array $args ) {
-			/**
-			 * Filter 'redux/args/{opt_name}'
-			 *
-			 * @param     array     $args ReduxFramework configuration
-			 */
-
-			// phpcs:ignore WordPress.NamingConventions.ValidHookName
-			$args = apply_filters( "redux/args/{$args['opt_name']}", $args );
-
-			/**
-			 * Filter 'redux/options/{opt_name}/args'
-			 *
-			 * @param     array     $args ReduxFramework configuration
-			 */
-
-			// phpcs:ignore WordPress.NamingConventions.ValidHookName
-			return apply_filters( "redux/options/{$args['opt_name']}/args", $args );
-		}
-
-		/**
-		 * Sanitize args that should not be empty.
-		 *
-		 * @param     array $args Global args.
-		 *
-		 * @return array
-		 */
-		private function no_errors_please( array $args ): array {
-			if ( empty( $args['transient_time'] ) ) {
-				$args['transient_time'] = 60 * MINUTE_IN_SECONDS;
-			}
-
-			if ( empty( $args['footer_credit'] ) ) {
-
-				$footer_text = sprintf(
-				/* translators: 1: Redux, 2: Link to plugin review */
-					__( 'Enjoyed %1$s? Please leave us a %2$s rating. We really appreciate your support!', 'redux-framework' ),
-					'<strong>' . __( 'Redux', 'redux-framework' ) . '</strong>',
-					'<a href="https://wordpress.org/support/plugin/redux-framework/reviews/?filter=5/#new-post" target="_blank">&#9733;&#9733;&#9733;&#9733;&#9733;</a>'
-				);
-				$args['footer_credit'] = '<span id="footer-thankyou">' . $footer_text . '</span>';
-			}
-
-			if ( empty( $args['menu_title'] ) ) {
-				$args['menu_title'] = esc_html__( 'Options', 'redux-framework' );
-			}
-
-			if ( empty( $args['page_title'] ) ) {
-				$args['page_title'] = esc_html__( 'Options', 'redux-framework' );
-			}
-
-			// Auto creates the page_slug appropriately.
-			if ( empty( $args['page_slug'] ) ) {
-				if ( ! empty( $args['display_name'] ) ) {
-					$args['page_slug'] = sanitize_html_class( $args['display_name'] );
-				} elseif ( ! empty( $args['page_title'] ) ) {
-					$args['page_slug'] = sanitize_html_class( $args['page_title'] );
-				} elseif ( ! empty( $args['menu_title'] ) ) {
-					$args['page_slug'] = sanitize_html_class( $args['menu_title'] );
-				} else {
-					$args['page_slug'] = str_replace( '-', '_', $args['opt_name'] );
-				}
-			}
-
-			return $args;
-		}
-
-		/**
-		 * Shims for much older v3 configs.
-		 *
-		 * @param     array $args Global args.
-		 *
-		 * @return array
-		 */
-		private function shim( array $args ): array {
-			/**
-			 * SHIM SECTION
-			 * Old variables and ways of doing things that need correcting.  ;)
-			 * */
-			// Variable name change.
-			if ( ! empty( $args['page_cap'] ) ) {
-				$args['page_permissions'] = $args['page_cap'];
-				unset( $args['page_cap'] );
-			}
-
-			if ( ! empty( $args['page_position'] ) ) {
-				$args['page_priority'] = $args['page_position'];
-				unset( $args['page_position'] );
-			}
-
-			if ( ! empty( $args['page_type'] ) ) {
-				$args['menu_type'] = $args['page_type'];
-				unset( $args['page_type'] );
-			}
-
-			return $args;
-		}
-
-		/**
-		 * Verify to see if dev has bothered to change admin bar links and share icons from demo data to their own.
-		 *
-		 * @param array $args Global args.
-		 */
-		private function change_demo_defaults( array $args ) {
-			if ( $args['dev_mode'] || true === Redux_Helpers::is_local_host() ) {
-				if ( ! empty( $args['admin_bar_links'] ) ) {
-					foreach ( $args['admin_bar_links'] as $arr ) {
-						if ( is_array( $arr ) && ! empty( $arr ) ) {
-							foreach ( $arr as $y ) {
-								if ( strpos( Redux_Core::strtolower( $y ), 'redux' ) !== false ) {
-									$this->omit_items = true;
-									break;
-								}
-							}
-						}
-					}
-				}
-
-				if ( ! empty( $args['share_icons'] ) ) {
-					foreach ( $args['share_icons'] as $arr ) {
-						if ( is_array( $arr ) && ! empty( $arr ) ) {
-							foreach ( $arr as $y ) {
-								if ( strpos( Redux_Core::strtolower( $y ), 'redux' ) !== false ) {
-									$this->omit_icons = true;
-								}
-							}
-						}
-					}
-				}
-			}
-		}
-
-		/**
-		 * Fix other arg criteria that sometimes gets hosed up.
-		 *
-		 * @param array $args Global args.
-		 *
-		 * @return array
-		 * @noinspection PhpStrictComparisonWithOperandsOfDifferentTypesInspection
-		 */
-		private function default_cleanup( array $args ): array {
-
-			// Fix the global variable name.
-			if ( '' === $args['global_variable'] && false !== $args['global_variable'] ) {
-				$args['global_variable'] = str_replace( '-', '_', $args['opt_name'] );
-			}
-
-			if ( isset( $args['customizer_only'] ) && $args['customizer_only'] ) {
-				$args['menu_type']      = 'hidden';
-				$args['customizer']     = true;
-				$args['admin_bar']      = false;
-				$args['allow_sub_menu'] = false;
-			}
-
-			// Check if the Airplane Mode plugin is installed.
-			if ( class_exists( 'Airplane_Mode_Core' ) ) {
-				$airplane = Airplane_Mode_Core::getInstance();
-				if ( method_exists( $airplane, 'enabled' ) ) {
-					if ( $airplane->enabled() ) {
-						$args['use_cdn'] = false;
-					}
-				} elseif ( 'on' === $airplane->check_status() ) {
-					$args['use_cdn'] = false;
-				}
-			}
-
-			return $args;
-		}
-	}
+    /**
+     * Class Redux_Args
+     */
+    class Redux_Args {
+
+        /**
+         * Returns entire arguments array.
+         *
+         * @var array|mixed
+         */
+        public $get = array();
+
+        /**
+         * ReduxFramework object.
+         *
+         * @var ReduxFramework|null
+         */
+        private ?ReduxFramework $parent;
+
+        /**
+         * Switch to omit social icons if dev_mode is set to true and Redux defaults are used.
+         *
+         * @var bool
+         */
+        public bool $omit_icons = false;
+
+        /**
+         * Switch to omit support menu items if dev_mode is set to true and redux defaults are used.
+         *
+         * @var bool
+         */
+        public bool $omit_items = false;
+
+        /**
+         * Flag to force dev_mod to true if in localhost or WP_DEBUG is set to true.
+         *
+         * @var bool
+         */
+        public bool $dev_mode_forced = false;
+
+        /**
+         * Redux_Args constructor.
+         *
+         * @param ReduxFramework $redux ReduxFramework object.
+         * @param array          $args  Global arguments array.
+         */
+        public function __construct( ReduxFramework $redux, array $args ) {
+            $this->parent = $redux;
+
+            $default = array(
+                'opt_name'                         => '',
+                'last_tab'                         => '',
+                'menu_icon'                        => '',
+                'menu_title'                       => '',
+                'page_title'                       => '',
+                'page_slug'                        => '',
+                'page_permissions'                 => 'manage_options',
+                'menu_type'                        => 'menu',
+                'page_parent'                      => 'themes.php',
+                'page_priority'                    => null,
+                'allow_sub_menu'                   => true,
+                'save_defaults'                    => true,
+                'footer_credit'                    => '',
+                'async_typography'                 => false,
+                'disable_google_fonts_link'        => false,
+                'class'                            => '',
+                'admin_bar'                        => true,
+                'admin_bar_priority'               => 999,
+                'admin_bar_icon'                   => '',
+                'help_tabs'                        => array(),
+                'help_sidebar'                     => '',
+                'database'                         => '',
+                'customizer'                       => false,
+                'global_variable'                  => '',
+                'output'                           => true,
+                'output_variables_prefix'          => '--',
+                'compiler_output_variables_prefix' => '$',
+                'compiler'                         => true,
+                'output_tag'                       => true,
+                'output_location'                  => array( 'frontend' ),
+                'transient_time'                   => '',
+                'default_show'                     => false,
+                'default_mark'                     => '',
+                'disable_save_warn'                => false,
+                'open_expanded'                    => false,
+                'hide_expand'                      => false,
+                'network_admin'                    => false,
+                'network_sites'                    => true,
+                'hide_reset'                       => false,
+                'hide_save'                        => false,
+                'hints'                            => array(
+                    'icon'          => 'el el-question-sign',
+                    'icon_position' => 'right',
+                    'icon_color'    => 'lightgray',
+                    'icon_size'     => 'normal',
+                    'tip_style'     => array(
+                        'color'   => 'light',
+                        'shadow'  => true,
+                        'rounded' => false,
+                        'style'   => '',
+                    ),
+                    'tip_position'  => array(
+                        'my' => 'top_left',
+                        'at' => 'bottom_right',
+                    ),
+                    'tip_effect'    => array(
+                        'show' => array(
+                            'effect'   => 'slide',
+                            'duration' => '500',
+                            'event'    => 'mouseover',
+                        ),
+                        'hide' => array(
+                            'effect'   => 'fade',
+                            'duration' => '500',
+                            'event'    => 'click mouseleave',
+                        ),
+                    ),
+                ),
+                'font_weights'                     => array(
+                    array(
+                        'id'   => '400',
+                        'name' => __( 'Regular 400', 'redux-framework' ),
+                    ),
+                    array(
+                        'id'   => '400italic',
+                        'name' => __( 'Regular 400 Italic', 'redux-framework' ),
+                    ),
+                    array(
+                        'id'   => '700',
+                        'name' => __( 'Bold 700', 'redux-framework' ),
+                    ),
+                    array(
+                        'id'   => '700italic',
+                        'name' => __( 'Bold 700 Italic', 'redux-framework' ),
+                    ),
+                ),
+                'show_import_export'               => true,
+                'show_options_object'              => true,
+                'dev_mode'                         => true,
+                'templates_path'                   => '',
+                'ajax_save'                        => true,
+                'use_cdn'                          => true,
+                'cdn_check_time'                   => 1440,
+                'options_api'                      => true,
+                'allow_tracking'                   => true,
+                'admin_theme'                      => 'wp',
+                'elusive_frontend'                 => false,
+                'fontawesome_frontend'             => false,
+                'flyout_submenus'                  => true,
+                'font_display'                     => 'swap', // block|swap|fallback|optional.
+                'load_on_cron'                     => false,
+                'search'                           => false,
+                'widget_area'                      => false,
+                'custom_fonts'                     => true,
+            );
+
+            $args = Redux_Functions::parse_args( $args, $default );
+
+            $args = $this->args( $args );
+
+            $args = $this->default_cleanup( $args );
+
+            if ( ! in_array( $args['font_display'], array( 'block', 'swap', 'fallback', 'optional' ), true ) ) {
+                $args['font_display'] = 'swap';
+            }
+
+            if ( isset( $args['async_typography'] ) && $args['async_typography'] ) {
+                $args['async_typography'] = false;
+            }
+
+            $this->get = $args;
+
+            $this->parent->args = $args;
+
+            if ( 'redux_extensions_demo' !== $args['opt_name'] && 'redux_demo' !== $args['opt_name'] ) {
+                $this->change_demo_defaults( $args );
+            }
+        }
+
+        /**
+         * Builds and sanitizes a global args array.
+         *
+         * @param     array $args Global args.
+         *
+         * @return array
+         */
+        private function args( array $args ): array {
+            $args = $this->no_errors_please( $args );
+
+            $this->parent->old_opt_name = $args['opt_name'];
+
+            $args = $this->filters( $args );
+
+            if ( ! function_exists( 'wp_rand' ) ) {
+                require_once ABSPATH . '/wp-includes/pluggable.php';
+            }
+
+            if ( $args['opt_name'] === $this->parent->old_opt_name ) {
+                $this->parent->old_opt_name = null;
+                unset( $this->parent->old_opt_name );
+            }
+
+            // Do not save the defaults if we're on a live preview!
+            if ( 'customize' === $GLOBALS['pagenow'] && isset( $_GET['customize_theme'] ) && ! empty( $_GET['customize_theme'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
+                $args['save_defaults'] = false;
+            }
+
+            return $this->shim( $args );
+        }
+
+        /**
+         * Apply filters to arg data.
+         *
+         * @param     array $args Global args.
+         *
+         * @return mixed|void
+         */
+        private function filters( array $args ) {
+            /**
+             * Filter 'redux/args/{opt_name}'
+             *
+             * @param     array     $args ReduxFramework configuration
+             */
+
+            // phpcs:ignore WordPress.NamingConventions.ValidHookName
+            $args = apply_filters( "redux/args/{$args['opt_name']}", $args );
+
+            /**
+             * Filter 'redux/options/{opt_name}/args'
+             *
+             * @param     array     $args ReduxFramework configuration
+             */
+
+            // phpcs:ignore WordPress.NamingConventions.ValidHookName
+            return apply_filters( "redux/options/{$args['opt_name']}/args", $args );
+        }
+
+        /**
+         * Sanitize args that should not be empty.
+         *
+         * @param     array $args Global args.
+         *
+         * @return array
+         */
+        private function no_errors_please( array $args ): array {
+            if ( empty( $args['transient_time'] ) ) {
+                $args['transient_time'] = 60 * MINUTE_IN_SECONDS;
+            }
+
+            if ( empty( $args['footer_credit'] ) ) {
+
+                $footer_text = sprintf(
+                /* translators: 1: Redux, 2: Link to plugin review */
+                    __( 'Enjoyed %1$s? Please leave us a %2$s rating. We really appreciate your support!', 'redux-framework' ),
+                    '<strong>' . __( 'Redux', 'redux-framework' ) . '</strong>',
+                    '<a href="https://wordpress.org/support/plugin/redux-framework/reviews/?filter=5/#new-post" target="_blank">&#9733;&#9733;&#9733;&#9733;&#9733;</a>'
+                );
+                $args['footer_credit'] = '<span id="footer-thankyou">' . $footer_text . '</span>';
+            }
+
+            if ( empty( $args['menu_title'] ) ) {
+                $args['menu_title'] = esc_html__( 'Options', 'redux-framework' );
+            }
+
+            if ( empty( $args['page_title'] ) ) {
+                $args['page_title'] = esc_html__( 'Options', 'redux-framework' );
+            }
+
+            // Auto creates the page_slug appropriately.
+            if ( empty( $args['page_slug'] ) ) {
+                if ( ! empty( $args['display_name'] ) ) {
+                    $args['page_slug'] = sanitize_html_class( $args['display_name'] );
+                } elseif ( ! empty( $args['page_title'] ) ) {
+                    $args['page_slug'] = sanitize_html_class( $args['page_title'] );
+                } elseif ( ! empty( $args['menu_title'] ) ) {
+                    $args['page_slug'] = sanitize_html_class( $args['menu_title'] );
+                } else {
+                    $args['page_slug'] = str_replace( '-', '_', $args['opt_name'] );
+                }
+            }
+
+            return $args;
+        }
+
+        /**
+         * Shims for much older v3 configs.
+         *
+         * @param     array $args Global args.
+         *
+         * @return array
+         */
+        private function shim( array $args ): array {
+            /**
+             * SHIM SECTION
+             * Old variables and ways of doing things that need correcting.  ;)
+             * */
+            // Variable name change.
+            if ( ! empty( $args['page_cap'] ) ) {
+                $args['page_permissions'] = $args['page_cap'];
+                unset( $args['page_cap'] );
+            }
+
+            if ( ! empty( $args['page_position'] ) ) {
+                $args['page_priority'] = $args['page_position'];
+                unset( $args['page_position'] );
+            }
+
+            if ( ! empty( $args['page_type'] ) ) {
+                $args['menu_type'] = $args['page_type'];
+                unset( $args['page_type'] );
+            }
+
+            return $args;
+        }
+
+        /**
+         * Verify to see if dev has bothered to change admin bar links and share icons from demo data to their own.
+         *
+         * @param array $args Global args.
+         */
+        private function change_demo_defaults( array $args ) {
+            if ( $args['dev_mode'] || true === Redux_Helpers::is_local_host() ) {
+                if ( ! empty( $args['admin_bar_links'] ) ) {
+                    foreach ( $args['admin_bar_links'] as $arr ) {
+                        if ( is_array( $arr ) && ! empty( $arr ) ) {
+                            foreach ( $arr as $y ) {
+                                if ( strpos( Redux_Core::strtolower( $y ), 'redux' ) !== false ) {
+                                    $this->omit_items = true;
+                                    break;
+                                }
+                            }
+                        }
+                    }
+                }
+
+                if ( ! empty( $args['share_icons'] ) ) {
+                    foreach ( $args['share_icons'] as $arr ) {
+                        if ( is_array( $arr ) && ! empty( $arr ) ) {
+                            foreach ( $arr as $y ) {
+                                if ( strpos( Redux_Core::strtolower( $y ), 'redux' ) !== false ) {
+                                    $this->omit_icons = true;
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        /**
+         * Fix other arg criteria that sometimes gets hosed up.
+         *
+         * @param array $args Global args.
+         *
+         * @return array
+         * @noinspection PhpStrictComparisonWithOperandsOfDifferentTypesInspection
+         */
+        private function default_cleanup( array $args ): array {
+
+            // Fix the global variable name.
+            if ( '' === $args['global_variable'] && false !== $args['global_variable'] ) {
+                $args['global_variable'] = str_replace( '-', '_', $args['opt_name'] );
+            }
+
+            if ( isset( $args['customizer_only'] ) && $args['customizer_only'] ) {
+                $args['menu_type']      = 'hidden';
+                $args['customizer']     = true;
+                $args['admin_bar']      = false;
+                $args['allow_sub_menu'] = false;
+            }
+
+            // Check if the Airplane Mode plugin is installed.
+            if ( class_exists( 'Airplane_Mode_Core' ) ) {
+                $airplane = Airplane_Mode_Core::getInstance();
+                if ( method_exists( $airplane, 'enabled' ) ) {
+                    if ( $airplane->enabled() ) {
+                        $args['use_cdn'] = false;
+                    }
+                } elseif ( 'on' === $airplane->check_status() ) {
+                    $args['use_cdn'] = false;
+                }
+            }
+
+            return $args;
+        }
+    }
 }

sample/sample-config.php

Indentation +425 added lines, -425 removed lines

@@ -10,7 +10,7 @@ 
 defined( 'ABSPATH' ) || exit;
 
 if ( ! class_exists( 'Redux' ) ) {
-	return;
+    return;
 }
 
 // This is your option name where all the Redux data is stored.
@@ -31,32 +31,32 @@ 
 $sample_patterns      = array();
 
 if ( is_dir( $sample_patterns_path ) ) {
-	$sample_patterns_dir = opendir( $sample_patterns_path );
-
-	if ( $sample_patterns_dir ) {
-
-		// phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition
-		while ( false !== ( $sample_patterns_file = readdir( $sample_patterns_dir ) ) ) {
-			if ( stristr( $sample_patterns_file, '.png' ) !== false || stristr( $sample_patterns_file, '.jpg' ) !== false ) {
-				$name              = explode( '.', $sample_patterns_file );
-				$name              = str_replace( '.' . end( $name ), '', $sample_patterns_file );
-				$sample_patterns[] = array(
-					'alt' => $name,
-					'img' => $sample_patterns_url . $sample_patterns_file,
-				);
-			}
-		}
-	}
+    $sample_patterns_dir = opendir( $sample_patterns_path );
+
+    if ( $sample_patterns_dir ) {
+
+        // phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition
+        while ( false !== ( $sample_patterns_file = readdir( $sample_patterns_dir ) ) ) {
+            if ( stristr( $sample_patterns_file, '.png' ) !== false || stristr( $sample_patterns_file, '.jpg' ) !== false ) {
+                $name              = explode( '.', $sample_patterns_file );
+                $name              = str_replace( '.' . end( $name ), '', $sample_patterns_file );
+                $sample_patterns[] = array(
+                    'alt' => $name,
+                    'img' => $sample_patterns_url . $sample_patterns_file,
+                );
+            }
+        }
+    }
 }
 
 // Used to except HTML tags in description arguments where esc_html would remove.
 $kses_exceptions = array(
-	'a'      => array(
-		'href' => array(),
-	),
-	'strong' => array(),
-	'br'     => array(),
-	'code'   => array(),
+    'a'      => array(
+        'href' => array(),
+    ),
+    'strong' => array(),
+    'br'     => array(),
+    'code'   => array(),
 );
 
 /*
@@ -71,155 +71,155 @@ 
 
 // TYPICAL → Change these values as you need/desire.
 $args = array(
-	// This is where your data is stored in the database and also becomes your global variable name.
-	'opt_name'                  => $opt_name,
+    // This is where your data is stored in the database and also becomes your global variable name.
+    'opt_name'                  => $opt_name,
 
-	// Name that appears at the top of your panel.
-	'display_name'              => $theme->get( 'Name' ),
+    // Name that appears at the top of your panel.
+    'display_name'              => $theme->get( 'Name' ),
 
-	// Version that appears at the top of your panel.
-	'display_version'           => $theme->get( 'Version' ),
+    // Version that appears at the top of your panel.
+    'display_version'           => $theme->get( 'Version' ),
 
-	// Specify if the admin menu should appear or not. Options: menu or submenu (Under appearance only).
-	'menu_type'                 => 'menu',
+    // Specify if the admin menu should appear or not. Options: menu or submenu (Under appearance only).
+    'menu_type'                 => 'menu',
 
-	// Show the sections below the admin menu item or not.
-	'allow_sub_menu'            => true,
+    // Show the sections below the admin menu item or not.
+    'allow_sub_menu'            => true,
 
-	// The text to appear in the admin menu.
-	'menu_title'                => esc_html__( 'Sample Options', 'your-textdomain-here' ),
+    // The text to appear in the admin menu.
+    'menu_title'                => esc_html__( 'Sample Options', 'your-textdomain-here' ),
 
-	// The text to appear on the page title.
-	'page_title'                => esc_html__( 'Sample Options', 'your-textdomain-here' ),
+    // The text to appear on the page title.
+    'page_title'                => esc_html__( 'Sample Options', 'your-textdomain-here' ),
 
-	// Disable to create your own Google fonts loader.
-	'disable_google_fonts_link' => false,
+    // Disable to create your own Google fonts loader.
+    'disable_google_fonts_link' => false,
 
-	// Show the panel pages on the admin bar.
-	'admin_bar'                 => true,
+    // Show the panel pages on the admin bar.
+    'admin_bar'                 => true,
 
-	// Icon for the admin bar menu.
-	'admin_bar_icon'            => 'dashicons-portfolio',
+    // Icon for the admin bar menu.
+    'admin_bar_icon'            => 'dashicons-portfolio',
 
-	// Priority for the admin bar menu.
-	'admin_bar_priority'        => 50,
+    // Priority for the admin bar menu.
+    'admin_bar_priority'        => 50,
 
-	// Sets a different name for your global variable other than the opt_name.
-	'global_variable'           => $opt_name,
+    // Sets a different name for your global variable other than the opt_name.
+    'global_variable'           => $opt_name,
 
-	// Show the time the page took to load, etc. (forced on while on localhost or when WP_DEBUG is enabled).
-	'dev_mode'                  => true,
+    // Show the time the page took to load, etc. (forced on while on localhost or when WP_DEBUG is enabled).
+    'dev_mode'                  => true,
 
-	// Enable basic customizer support.
-	'customizer'                => true,
+    // Enable basic customizer support.
+    'customizer'                => true,
 
-	// Allow the panel to open expanded.
-	'open_expanded'             => false,
+    // Allow the panel to open expanded.
+    'open_expanded'             => false,
 
-	// Disable the save warning when a user changes a field.
-	'disable_save_warn'         => false,
+    // Disable the save warning when a user changes a field.
+    'disable_save_warn'         => false,
 
-	// Order where the menu appears in the admin area. If there is any conflict, something will not show. Warning.
-	'page_priority'             => 90,
+    // Order where the menu appears in the admin area. If there is any conflict, something will not show. Warning.
+    'page_priority'             => 90,
 
-	// For a full list of options, visit: https://codex.wordpress.org/Function_Reference/add_submenu_page#Parameters.
-	'page_parent'               => 'themes.php',
+    // For a full list of options, visit: https://codex.wordpress.org/Function_Reference/add_submenu_page#Parameters.
+    'page_parent'               => 'themes.php',
 
-	// Permissions needed to access the options panel.
-	'page_permissions'          => 'manage_options',
+    // Permissions needed to access the options panel.
+    'page_permissions'          => 'manage_options',
 
-	// Specify a custom URL to an icon.
-	'menu_icon'                 => '',
+    // Specify a custom URL to an icon.
+    'menu_icon'                 => '',
 
-	// Force your panel to always open to a specific tab (by id).
-	'last_tab'                  => '',
+    // Force your panel to always open to a specific tab (by id).
+    'last_tab'                  => '',
 
-	// Icon displayed in the admin panel next to your menu_title.
-	'page_icon'                 => 'icon-themes',
+    // Icon displayed in the admin panel next to your menu_title.
+    'page_icon'                 => 'icon-themes',
 
-	// Page slug used to denote the panel, will be based off page title, then menu title, then opt_name if not provided.
-	'page_slug'                 => $opt_name,
+    // Page slug used to denote the panel, will be based off page title, then menu title, then opt_name if not provided.
+    'page_slug'                 => $opt_name,
 
-	// On load save the defaults to DB before user clicks save.
-	'save_defaults'             => true,
+    // On load save the defaults to DB before user clicks save.
+    'save_defaults'             => true,
 
-	// Display the default value next to each field when not set to the default value.
-	'default_show'              => false,
+    // Display the default value next to each field when not set to the default value.
+    'default_show'              => false,
 
-	// What to print by the field's title if the value shown is default.
-	'default_mark'              => '*',
+    // What to print by the field's title if the value shown is default.
+    'default_mark'              => '*',
 
-	// Shows the Import/Export panel when not used as a field.
-	'show_import_export'        => true,
+    // Shows the Import/Export panel when not used as a field.
+    'show_import_export'        => true,
 
-	// Shows the Options Object for debugging purposes. Show be set to false before deploying.
-	'show_options_object'       => true,
+    // Shows the Options Object for debugging purposes. Show be set to false before deploying.
+    'show_options_object'       => true,
 
-	// The time transients will expire when the 'database' arg is set.
-	'transient_time'            => 60 * MINUTE_IN_SECONDS,
+    // The time transients will expire when the 'database' arg is set.
+    'transient_time'            => 60 * MINUTE_IN_SECONDS,
 
-	// Global shut-off for dynamic CSS output by the framework. Will also disable google fonts output.
-	'output'                    => true,
+    // Global shut-off for dynamic CSS output by the framework. Will also disable google fonts output.
+    'output'                    => true,
 
-	// Allows dynamic CSS to be generated for customizer and google fonts,
-	// but stops the dynamic CSS from going to the page head.
-	'output_tag'                => true,
+    // Allows dynamic CSS to be generated for customizer and google fonts,
+    // but stops the dynamic CSS from going to the page head.
+    'output_tag'                => true,
 
-	// Disable the footer credit of Redux. Please leave if you can help it.
-	'footer_credit'             => '',
+    // Disable the footer credit of Redux. Please leave if you can help it.
+    'footer_credit'             => '',
 
-	// If you prefer not to use the CDN for ACE Editor.
-	// You may download the Redux Vendor Support plugin to run locally or embed it in your code.
-	'use_cdn'                   => true,
+    // If you prefer not to use the CDN for ACE Editor.
+    // You may download the Redux Vendor Support plugin to run locally or embed it in your code.
+    'use_cdn'                   => true,
 
-	// Set the theme of the option panel.  Use 'wp' to use a more modern style, default is classic.
-	'admin_theme'               => 'wp',
+    // Set the theme of the option panel.  Use 'wp' to use a more modern style, default is classic.
+    'admin_theme'               => 'wp',
 
-	// Enable or disable flyout menus when hovering over a menu with submenus.
-	'flyout_submenus'           => true,
+    // Enable or disable flyout menus when hovering over a menu with submenus.
+    'flyout_submenus'           => true,
 
-	// Mode to display fonts (auto|block|swap|fallback|optional)
-	// See: https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display.
-	'font_display'              => 'swap',
+    // Mode to display fonts (auto|block|swap|fallback|optional)
+    // See: https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display.
+    'font_display'              => 'swap',
 
-	// HINTS.
-	'hints'                     => array(
-		'icon'          => 'el el-question-sign',
-		'icon_position' => 'right',
-		'icon_color'    => 'lightgray',
-		'icon_size'     => 'normal',
-		'tip_style'     => array(
-			'color'   => 'red',
-			'shadow'  => true,
-			'rounded' => false,
-			'style'   => '',
-		),
-		'tip_position'  => array(
-			'my' => 'top left',
-			'at' => 'bottom right',
-		),
-		'tip_effect'    => array(
-			'show' => array(
-				'effect'   => 'slide',
-				'duration' => '500',
-				'event'    => 'mouseover',
-			),
-			'hide' => array(
-				'effect'   => 'slide',
-				'duration' => '500',
-				'event'    => 'click mouseleave',
-			),
-		),
-	),
-
-	// FUTURE → Not in use yet, but reserved or partially implemented.
-	// Use at your own risk.
-	// Possible: options, theme_mods, theme_mods_expanded, transient. Not fully functional, warning!
-	'database'                  => '',
-	'network_admin'             => true,
-	'search'                    => true,
-	'widget_area'               => true,
-	'custom_fonts'              => true,
+    // HINTS.
+    'hints'                     => array(
+        'icon'          => 'el el-question-sign',
+        'icon_position' => 'right',
+        'icon_color'    => 'lightgray',
+        'icon_size'     => 'normal',
+        'tip_style'     => array(
+            'color'   => 'red',
+            'shadow'  => true,
+            'rounded' => false,
+            'style'   => '',
+        ),
+        'tip_position'  => array(
+            'my' => 'top left',
+            'at' => 'bottom right',
+        ),
+        'tip_effect'    => array(
+            'show' => array(
+                'effect'   => 'slide',
+                'duration' => '500',
+                'event'    => 'mouseover',
+            ),
+            'hide' => array(
+                'effect'   => 'slide',
+                'duration' => '500',
+                'event'    => 'click mouseleave',
+            ),
+        ),
+    ),
+
+    // FUTURE → Not in use yet, but reserved or partially implemented.
+    // Use at your own risk.
+    // Possible: options, theme_mods, theme_mods_expanded, transient. Not fully functional, warning!
+    'database'                  => '',
+    'network_admin'             => true,
+    'search'                    => true,
+    'widget_area'               => true,
+    'custom_fonts'              => true,
 );
 
 
@@ -227,53 +227,53 @@ 
 // PLEASE CHANGE THESE SETTINGS IN YOUR THEME BEFORE RELEASING YOUR PRODUCT!!
 // If these are left unchanged, they will not display in your panel!
 $args['admin_bar_links'][] = array(
-	'id'    => 'redux-docs',
-	'href'  => '//devs.redux.io/',
-	'title' => __( 'Documentation', 'your-textdomain-here' ),
+    'id'    => 'redux-docs',
+    'href'  => '//devs.redux.io/',
+    'title' => __( 'Documentation', 'your-textdomain-here' ),
 );
 
 $args['admin_bar_links'][] = array(
-	'id'    => 'redux-support',
-	'href'  => '//github.com/ReduxFramework/redux-framework/issues',
-	'title' => __( 'Support', 'your-textdomain-here' ),
+    'id'    => 'redux-support',
+    'href'  => '//github.com/ReduxFramework/redux-framework/issues',
+    'title' => __( 'Support', 'your-textdomain-here' ),
 );
 
 // SOCIAL ICONS → Set up custom links in the footer for quick links in your panel footer icons.
 // PLEASE CHANGE THESE SETTINGS IN YOUR THEME BEFORE RELEASING YOUR PRODUCT!!
 // If these are left unchanged, they will not display in your panel!
 $args['share_icons'][] = array(
-	'url'   => '//github.com/ReduxFramework/ReduxFramework',
-	'title' => 'Visit us on GitHub',
-	'icon'  => 'el el-github',
+    'url'   => '//github.com/ReduxFramework/ReduxFramework',
+    'title' => 'Visit us on GitHub',
+    'icon'  => 'el el-github',
 );
 $args['share_icons'][] = array(
-	'url'   => '//www.facebook.com/pages/Redux-Framework/243141545850368',
-	'title' => 'Like us on Facebook',
-	'icon'  => 'el el-facebook',
+    'url'   => '//www.facebook.com/pages/Redux-Framework/243141545850368',
+    'title' => 'Like us on Facebook',
+    'icon'  => 'el el-facebook',
 );
 $args['share_icons'][] = array(
-	'url'   => '//twitter.com/reduxframework',
-	'title' => 'Follow us on Twitter',
-	'icon'  => 'el el-twitter',
+    'url'   => '//twitter.com/reduxframework',
+    'title' => 'Follow us on Twitter',
+    'icon'  => 'el el-twitter',
 );
 $args['share_icons'][] = array(
-	'url'   => '//www.linkedin.com/company/redux-framework',
-	'title' => 'Find us on LinkedIn',
-	'icon'  => 'el el-linkedin',
+    'url'   => '//www.linkedin.com/company/redux-framework',
+    'title' => 'Find us on LinkedIn',
+    'icon'  => 'el el-linkedin',
 );
 
 // Panel Intro text → before the form.
 if ( ! isset( $args['global_variable'] ) || false !== $args['global_variable'] ) {
-	if ( ! empty( $args['global_variable'] ) ) {
-		$v = $args['global_variable'];
-	} else {
-		$v = str_replace( '-', '_', $args['opt_name'] );
-	}
-
-	// translators:  Panel opt_name.
-	$args['intro_text'] = '<p>' . sprintf( esc_html__( 'Did you know that Redux sets a global variable for you? To access any of your saved options from within your code you can use your global variable: $%1$s', 'your-textdomain-here' ), '<strong>' . $v . '</strong>' ) . '<p>';
+    if ( ! empty( $args['global_variable'] ) ) {
+        $v = $args['global_variable'];
+    } else {
+        $v = str_replace( '-', '_', $args['opt_name'] );
+    }
+
+    // translators:  Panel opt_name.
+    $args['intro_text'] = '<p>' . sprintf( esc_html__( 'Did you know that Redux sets a global variable for you? To access any of your saved options from within your code you can use your global variable: $%1$s', 'your-textdomain-here' ), '<strong>' . $v . '</strong>' ) . '<p>';
 } else {
-	$args['intro_text'] = '<p>' . esc_html__( 'This text is displayed above the options panel. It isn\'t required, but more info is always better! The intro_text field accepts all HTML.', 'your-textdomain-here' ) . '</p>';
+    $args['intro_text'] = '<p>' . esc_html__( 'This text is displayed above the options panel. It isn\'t required, but more info is always better! The intro_text field accepts all HTML.', 'your-textdomain-here' ) . '</p>';
 }
 
 // Add content after the form.
@@ -289,16 +289,16 @@ 
  * ---> START HELP TABS
  */
 $help_tabs = array(
-	array(
-		'id'      => 'redux-help-tab-1',
-		'title'   => esc_html__( 'Theme Information 1', 'your-textdomain-here' ),
-		'content' => '<p>' . esc_html__( 'This is the tab content, HTML is allowed.', 'your-textdomain-here' ) . '</p>',
-	),
-	array(
-		'id'      => 'redux-help-tab-2',
-		'title'   => esc_html__( 'Theme Information 2', 'your-textdomain-here' ),
-		'content' => '<p>' . esc_html__( 'This is the tab content, HTML is allowed.', 'your-textdomain-here' ) . '</p>',
-	),
+    array(
+        'id'      => 'redux-help-tab-1',
+        'title'   => esc_html__( 'Theme Information 1', 'your-textdomain-here' ),
+        'content' => '<p>' . esc_html__( 'This is the tab content, HTML is allowed.', 'your-textdomain-here' ) . '</p>',
+    ),
+    array(
+        'id'      => 'redux-help-tab-2',
+        'title'   => esc_html__( 'Theme Information 2', 'your-textdomain-here' ),
+        'content' => '<p>' . esc_html__( 'This is the tab content, HTML is allowed.', 'your-textdomain-here' ) . '</p>',
+    ),
 );
 Redux::set_help_tab( $opt_name, $help_tabs );
 
@@ -317,14 +317,14 @@ 
 
 // -> START Basic Fields
 Redux::set_section(
-	$opt_name,
-	array(
-		'title'            => esc_html__( 'Basic Fields', 'your-textdomain-here' ),
-		'id'               => 'basic',
-		'desc'             => esc_html__( 'These are really basic fields!', 'your-textdomain-here' ),
-		'customizer_width' => '400px',
-		'icon'             => 'el el-home',
-	)
+    $opt_name,
+    array(
+        'title'            => esc_html__( 'Basic Fields', 'your-textdomain-here' ),
+        'id'               => 'basic',
+        'desc'             => esc_html__( 'These are really basic fields!', 'your-textdomain-here' ),
+        'customizer_width' => '400px',
+        'icon'             => 'el el-home',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/basic-fields/checkbox.php';
@@ -337,13 +337,13 @@ 
 
 // -> START Editors.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title'            => esc_html__( 'Editors', 'your-textdomain-here' ),
-		'id'               => 'editor',
-		'customizer_width' => '500px',
-		'icon'             => 'el el-edit',
-	)
+    $opt_name,
+    array(
+        'title'            => esc_html__( 'Editors', 'your-textdomain-here' ),
+        'id'               => 'editor',
+        'customizer_width' => '500px',
+        'icon'             => 'el el-edit',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/editors/wordpress-editor.php';
@@ -351,12 +351,12 @@ 
 
 // -> START Color Selection.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Color Selection', 'your-textdomain-here' ),
-		'id'    => 'color',
-		'icon'  => 'el el-brush',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Color Selection', 'your-textdomain-here' ),
+        'id'    => 'color',
+        'icon'  => 'el el-brush',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/color-selection/color.php';
@@ -368,12 +368,12 @@ 
 
 // -> START Design Fields.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Design Fields', 'your-textdomain-here' ),
-		'id'    => 'design',
-		'icon'  => 'el el-wrench',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Design Fields', 'your-textdomain-here' ),
+        'id'    => 'design',
+        'icon'  => 'el el-wrench',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/design-fields/background.php';
@@ -384,12 +384,12 @@ 
 
 // -> START Media Uploads.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Media Uploads', 'your-textdomain-here' ),
-		'id'    => 'media',
-		'icon'  => 'el el-picture',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Media Uploads', 'your-textdomain-here' ),
+        'id'    => 'media',
+        'icon'  => 'el el-picture',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/media-uploads/gallery.php';
@@ -399,12 +399,12 @@ 
 
 // -> START Presentation Fields.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Presentation Fields', 'your-textdomain-here' ),
-		'id'    => 'presentation',
-		'icon'  => 'el el-screen',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Presentation Fields', 'your-textdomain-here' ),
+        'id'    => 'presentation',
+        'icon'  => 'el el-screen',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/presentation-fields/divide.php';
@@ -413,21 +413,21 @@ 
 require_once Redux_Core::$dir . '../sample/sections/presentation-fields/section.php';
 
 Redux::set_section(
-	$opt_name,
-	array(
-		'id'   => 'presentation-divide-sample',
-		'type' => 'divide',
-	)
+    $opt_name,
+    array(
+        'id'   => 'presentation-divide-sample',
+        'type' => 'divide',
+    )
 );
 
 // → START Switch & Button Set.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Switch / Button Set', 'your-textdomain-here' ),
-		'id'    => 'switch_buttonset',
-		'icon'  => 'el el-cogs',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Switch / Button Set', 'your-textdomain-here' ),
+        'id'    => 'switch_buttonset',
+        'icon'  => 'el el-cogs',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/switch-button/button-set.php';
@@ -435,12 +435,12 @@ 
 
 // -> START Select Fields.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Select Fields', 'your-textdomain-here' ),
-		'id'    => 'select',
-		'icon'  => 'el el-list-alt',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Select Fields', 'your-textdomain-here' ),
+        'id'    => 'select',
+        'icon'  => 'el el-list-alt',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/select-fields/select.php';
@@ -449,12 +449,12 @@ 
 
 // -> START Slider / Spinner.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Slider / Spinner', 'your-textdomain-here' ),
-		'id'    => 'slider_spinner',
-		'icon'  => 'el el-adjust-alt',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Slider / Spinner', 'your-textdomain-here' ),
+        'id'    => 'slider_spinner',
+        'icon'  => 'el el-adjust-alt',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/slider-spinner/slider.php';
@@ -465,12 +465,12 @@ 
 
 // -> START Additional Types.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Additional Types', 'your-textdomain-here' ),
-		'id'    => 'additional',
-		'icon'  => 'el el-magic',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Additional Types', 'your-textdomain-here' ),
+        'id'    => 'additional',
+        'icon'  => 'el el-magic',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/additional-types/date.php';
@@ -479,11 +479,11 @@ 
 require_once Redux_Core::$dir . '../sample/sections/additional-types/raw.php';
 
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Advanced Features', 'your-textdomain-here' ),
-		'icon'  => 'el el-thumbs-up',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Advanced Features', 'your-textdomain-here' ),
+        'icon'  => 'el el-thumbs-up',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/advanced-features/callback.php';
@@ -501,11 +501,11 @@ 
 
 // -> START Disabling.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Disabling', 'your-textdomain-here' ),
-		'icon'  => 'el el-lock',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Disabling', 'your-textdomain-here' ),
+        'icon'  => 'el el-lock',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/disabling/disable-field.php';
@@ -513,14 +513,14 @@ 
 
 // -> START Extensions.
 Redux::set_section(
-	$opt_name,
-	array(
-		'title' => esc_html__( 'Redux Extensions', 'your-textdomain-here' ),
-		'id'    => 'redux-extensions',
-		'icon'  => 'el el-redux',
-		'class' => 'pro_highlight',
-		'desc'  => esc_html__( 'For full documentation on this field, visit: ', 'your-textdomain-here' ) . '<a href="https://devs.redux.io/core-extensions/" target="_blank">https://devs.redux.io/core-extensions/</a>',
-	)
+    $opt_name,
+    array(
+        'title' => esc_html__( 'Redux Extensions', 'your-textdomain-here' ),
+        'id'    => 'redux-extensions',
+        'icon'  => 'el el-redux',
+        'class' => 'pro_highlight',
+        'desc'  => esc_html__( 'For full documentation on this field, visit: ', 'your-textdomain-here' ) . '<a href="https://devs.redux.io/core-extensions/" target="_blank">https://devs.redux.io/core-extensions/</a>',
+    )
 );
 
 require_once Redux_Core::$dir . '../sample/sections/extensions/accordion.php';
@@ -546,46 +546,46 @@ 
  * Raw README
  */
 if ( file_exists( $dir . '/../README.md' ) ) {
-	$section = array(
-		'icon'   => 'el el-list-alt',
-		'title'  => esc_html__( 'Documentation', 'your-textdomain-here' ),
-		'fields' => array(
-			array(
-				'id'           => 'opt-raw-documentation',
-				'type'         => 'raw',
-				'markdown'     => true,
-				'content_path' => __DIR__ . '/../README.md', // FULL PATH, not relative, please.
-			),
-		),
-	);
-
-	Redux::set_section( $opt_name, $section );
+    $section = array(
+        'icon'   => 'el el-list-alt',
+        'title'  => esc_html__( 'Documentation', 'your-textdomain-here' ),
+        'fields' => array(
+            array(
+                'id'           => 'opt-raw-documentation',
+                'type'         => 'raw',
+                'markdown'     => true,
+                'content_path' => __DIR__ . '/../README.md', // FULL PATH, not relative, please.
+            ),
+        ),
+    );
+
+    Redux::set_section( $opt_name, $section );
 }
 
 Redux::set_section(
-	$opt_name,
-	array(
-		'icon'            => 'el el-list-alt',
-		'title'           => esc_html__( 'Customizer Only', 'your-textdomain-here' ),
-		'desc'            => '<p class="description">' . esc_html__( 'This Section should be visible only in Customizer', 'your-textdomain-here' ) . '</p>',
-		'customizer_only' => true,
-		'fields'          => array(
-			array(
-				'id'              => 'opt-customizer-only',
-				'type'            => 'select',
-				'title'           => esc_html__( 'Customizer Only Option', 'your-textdomain-here' ),
-				'subtitle'        => esc_html__( 'The subtitle is NOT visible in customizer', 'your-textdomain-here' ),
-				'desc'            => esc_html__( 'The field desc is NOT visible in customizer.', 'your-textdomain-here' ),
-				'customizer_only' => true,
-				'options'         => array(
-					'1' => esc_html__( 'Opt 1', 'your-textdomain-here' ),
-					'2' => esc_html__( 'Opt 2', 'your-textdomain-here' ),
-					'3' => esc_html__( 'Opt 3', 'your-textdomain-here' ),
-				),
-				'default'         => '2',
-			),
-		),
-	)
+    $opt_name,
+    array(
+        'icon'            => 'el el-list-alt',
+        'title'           => esc_html__( 'Customizer Only', 'your-textdomain-here' ),
+        'desc'            => '<p class="description">' . esc_html__( 'This Section should be visible only in Customizer', 'your-textdomain-here' ) . '</p>',
+        'customizer_only' => true,
+        'fields'          => array(
+            array(
+                'id'              => 'opt-customizer-only',
+                'type'            => 'select',
+                'title'           => esc_html__( 'Customizer Only Option', 'your-textdomain-here' ),
+                'subtitle'        => esc_html__( 'The subtitle is NOT visible in customizer', 'your-textdomain-here' ),
+                'desc'            => esc_html__( 'The field desc is NOT visible in customizer.', 'your-textdomain-here' ),
+                'customizer_only' => true,
+                'options'         => array(
+                    '1' => esc_html__( 'Opt 1', 'your-textdomain-here' ),
+                    '2' => esc_html__( 'Opt 2', 'your-textdomain-here' ),
+                    '3' => esc_html__( 'Opt 3', 'your-textdomain-here' ),
+                ),
+                'default'         => '2',
+            ),
+        ),
+    )
 );
 
 /*
@@ -615,150 +615,150 @@ 
 // add_filter('redux/options/' . $opt_name . '/sections', 'dynamic_section');
 // .
 if ( ! function_exists( 'compiler_action' ) ) {
-	/**
-	 * This is a test function that will let you see when the compiler hook occurs.
-	 * It only runs if a field's value has changed and compiler => true is set.
-	 *
-	 * @param array  $options        Options values.
-	 * @param string $css            Compiler selector CSS values  compiler => array( CSS SELECTORS ).
-	 * @param array  $changed_values Any values that have changed since last save.
-	 */
-	function compiler_action( array $options, string $css, array $changed_values ) {
-		echo '<h1>The compiler hook has run!</h1>';
-		echo '<pre>';
-		// phpcs:ignore WordPress.PHP.DevelopmentFunctions
-		print_r( $changed_values ); // Values that have changed since the last save.
-		// echo '<br/>';
-		// print_r($options); //Option values.
-		// echo '<br/>';
-		// print_r($css); // Compiler selector CSS values compiler => array( CSS SELECTORS ).
-		echo '</pre>';
-	}
+    /**
+     * This is a test function that will let you see when the compiler hook occurs.
+     * It only runs if a field's value has changed and compiler => true is set.
+     *
+     * @param array  $options        Options values.
+     * @param string $css            Compiler selector CSS values  compiler => array( CSS SELECTORS ).
+     * @param array  $changed_values Any values that have changed since last save.
+     */
+    function compiler_action( array $options, string $css, array $changed_values ) {
+        echo '<h1>The compiler hook has run!</h1>';
+        echo '<pre>';
+        // phpcs:ignore WordPress.PHP.DevelopmentFunctions
+        print_r( $changed_values ); // Values that have changed since the last save.
+        // echo '<br/>';
+        // print_r($options); //Option values.
+        // echo '<br/>';
+        // print_r($css); // Compiler selector CSS values compiler => array( CSS SELECTORS ).
+        echo '</pre>';
+    }
 }
 
 if ( ! function_exists( 'redux_validate_callback_function' ) ) {
-	/**
-	 * Custom function for the callback validation referenced above
-	 *
-	 * @param array $field          Field array.
-	 * @param mixed $value          New value.
-	 * @param mixed $existing_value Existing value.
-	 *
-	 * @return array
-	 */
-	function redux_validate_callback_function( array $field, $value, $existing_value ): array {
-		$error   = false;
-		$warning = false;
-
-		// Do your validation.
-		if ( 1 === (int) $value ) {
-			$error = true;
-			$value = $existing_value;
-		} elseif ( 2 === (int) $value ) {
-			$warning = true;
-			$value   = $existing_value;
-		}
-
-		$return['value'] = $value;
-
-		if ( true === $error ) {
-			$field['msg']    = 'your custom error message';
-			$return['error'] = $field;
-		}
-
-		if ( true === $warning ) {
-			$field['msg']      = 'your custom warning message';
-			$return['warning'] = $field;
-		}
-
-		return $return;
-	}
+    /**
+     * Custom function for the callback validation referenced above
+     *
+     * @param array $field          Field array.
+     * @param mixed $value          New value.
+     * @param mixed $existing_value Existing value.
+     *
+     * @return array
+     */
+    function redux_validate_callback_function( array $field, $value, $existing_value ): array {
+        $error   = false;
+        $warning = false;
+
+        // Do your validation.
+        if ( 1 === (int) $value ) {
+            $error = true;
+            $value = $existing_value;
+        } elseif ( 2 === (int) $value ) {
+            $warning = true;
+            $value   = $existing_value;
+        }
+
+        $return['value'] = $value;
+
+        if ( true === $error ) {
+            $field['msg']    = 'your custom error message';
+            $return['error'] = $field;
+        }
+
+        if ( true === $warning ) {
+            $field['msg']      = 'your custom warning message';
+            $return['warning'] = $field;
+        }
+
+        return $return;
+    }
 }
 
 
 if ( ! function_exists( 'dynamic_section' ) ) {
-	/**
-	 * Custom function for filtering the section array.
-	 * Good for child themes to override or add to the sections.
-	 * Simply include this function in the child themes functions.php file.
-	 * NOTE: the defined constants for URLs and directories will NOT be available at this point in a child theme,
-	 * so you must use get_template_directory_uri() if you want to use any of the built-in icons.
-	 *
-	 * @param array $sections Section array.
-	 *
-	 * @return array
-	 */
-	function dynamic_section( array $sections ): array {
-		$sections[] = array(
-			'title'  => esc_html__( 'Section via hook', 'your-textdomain-here' ),
-			'desc'   => '<p class="description">' . esc_html__( 'This is a section created by adding a filter to the sections array. Can be used by child themes to add/remove sections from the options.', 'your-textdomain-here' ) . '</p>',
-			'icon'   => 'el el-paper-clip',
-
-			// Leave this as a blank section, no options just some intro text set above.
-			'fields' => array(),
-		);
-
-		return $sections;
-	}
+    /**
+     * Custom function for filtering the section array.
+     * Good for child themes to override or add to the sections.
+     * Simply include this function in the child themes functions.php file.
+     * NOTE: the defined constants for URLs and directories will NOT be available at this point in a child theme,
+     * so you must use get_template_directory_uri() if you want to use any of the built-in icons.
+     *
+     * @param array $sections Section array.
+     *
+     * @return array
+     */
+    function dynamic_section( array $sections ): array {
+        $sections[] = array(
+            'title'  => esc_html__( 'Section via hook', 'your-textdomain-here' ),
+            'desc'   => '<p class="description">' . esc_html__( 'This is a section created by adding a filter to the sections array. Can be used by child themes to add/remove sections from the options.', 'your-textdomain-here' ) . '</p>',
+            'icon'   => 'el el-paper-clip',
+
+            // Leave this as a blank section, no options just some intro text set above.
+            'fields' => array(),
+        );
+
+        return $sections;
+    }
 }
 
 if ( ! function_exists( 'change_arguments' ) ) {
-	/**
-	 * Filter hook for filtering the args.
-	 * Good for child themes to override or add to the args array.
-	 * It can also be used in other functions.
-	 *
-	 * @param array $args Global arguments array.
-	 *
-	 * @return array
-	 */
-	function change_arguments( array $args ): array {
-		$args['dev_mode'] = true;
-
-		return $args;
-	}
+    /**
+     * Filter hook for filtering the args.
+     * Good for child themes to override or add to the args array.
+     * It can also be used in other functions.
+     *
+     * @param array $args Global arguments array.
+     *
+     * @return array
+     */
+    function change_arguments( array $args ): array {
+        $args['dev_mode'] = true;
+
+        return $args;
+    }
 }
 
 if ( ! function_exists( 'change_defaults' ) ) {
-	/**
-	 * Filter hook for filtering the default value of any given field. Very useful in development mode.
-	 *
-	 * @param array $defaults Default value array.
-	 *
-	 * @return array
-	 */
-	function change_defaults( array $defaults ): array {
-		$defaults['str_replace'] = esc_html__( 'Testing filter hook!', 'your-textdomain-here' );
-
-		return $defaults;
-	}
+    /**
+     * Filter hook for filtering the default value of any given field. Very useful in development mode.
+     *
+     * @param array $defaults Default value array.
+     *
+     * @return array
+     */
+    function change_defaults( array $defaults ): array {
+        $defaults['str_replace'] = esc_html__( 'Testing filter hook!', 'your-textdomain-here' );
+
+        return $defaults;
+    }
 }
 
 if ( ! function_exists( 'redux_custom_sanitize' ) ) {
-	/**
-	 * Function to be used if the field sanitizes argument.
-	 * Return value MUST be formatted or cleaned text to display.
-	 *
-	 * @param string $value Value to evaluate or clean.  Required.
-	 *
-	 * @return string
-	 */
-	function redux_custom_sanitize( string $value ): string {
-		$return = '';
-
-		foreach ( explode( ' ', $value ) as $w ) {
-			foreach ( str_split( $w ) as $k => $v ) {
-				if ( ( $k + 1 ) % 2 !== 0 && ctype_alpha( $v ) ) {
-					$return .= mb_strtoupper( $v );
-				} else {
-					$return .= $v;
-				}
-			}
-
-			$return .= ' ';
-		}
-
-		return $return;
-	}
+    /**
+     * Function to be used if the field sanitizes argument.
+     * Return value MUST be formatted or cleaned text to display.
+     *
+     * @param string $value Value to evaluate or clean.  Required.
+     *
+     * @return string
+     */
+    function redux_custom_sanitize( string $value ): string {
+        $return = '';
+
+        foreach ( explode( ' ', $value ) as $w ) {
+            foreach ( str_split( $w ) as $k => $v ) {
+                if ( ( $k + 1 ) % 2 !== 0 && ctype_alpha( $v ) ) {
+                    $return .= mb_strtoupper( $v );
+                } else {
+                    $return .= $v;
+                }
+            }
+
+            $return .= ' ';
+        }
+
+        return $return;
+    }
 }
 // phpcs:enable