aboutsummaryrefslogtreecommitdiff
path: root/srcs/wordpress/wp-includes/class-wp-theme.php
diff options
context:
space:
mode:
authorCharles Cabergs <me@cacharle.xyz>2020-07-27 10:05:23 +0200
committerCharles Cabergs <me@cacharle.xyz>2020-07-27 10:05:23 +0200
commit5bf66662a9bdd62c5bccab15e607cd95cfb8fcab (patch)
tree39a1a4629749056191c05dfd899f931701b7acf3 /srcs/wordpress/wp-includes/class-wp-theme.php
parent5afd237bbd22028b85532b8c0b3fcead49a00764 (diff)
downloadft_server-5bf66662a9bdd62c5bccab15e607cd95cfb8fcab.tar.gz
ft_server-5bf66662a9bdd62c5bccab15e607cd95cfb8fcab.tar.bz2
ft_server-5bf66662a9bdd62c5bccab15e607cd95cfb8fcab.zip
Removed wordpress and phpmyadmin, my server doesn't handle it well and it brings shame on my famillyHEADmaster
Diffstat (limited to 'srcs/wordpress/wp-includes/class-wp-theme.php')
-rw-r--r--srcs/wordpress/wp-includes/class-wp-theme.php1659
1 files changed, 0 insertions, 1659 deletions
diff --git a/srcs/wordpress/wp-includes/class-wp-theme.php b/srcs/wordpress/wp-includes/class-wp-theme.php
deleted file mode 100644
index fe8dbb1..0000000
--- a/srcs/wordpress/wp-includes/class-wp-theme.php
+++ /dev/null
@@ -1,1659 +0,0 @@
-<?php
-/**
- * WP_Theme Class
- *
- * @package WordPress
- * @subpackage Theme
- * @since 3.4.0
- */
-final class WP_Theme implements ArrayAccess {
-
- /**
- * Whether the theme has been marked as updateable.
- *
- * @since 4.4.0
- * @var bool
- *
- * @see WP_MS_Themes_List_Table
- */
- public $update = false;
-
- /**
- * Headers for style.css files.
- *
- * @var array
- */
- private static $file_headers = array(
- 'Name' => 'Theme Name',
- 'ThemeURI' => 'Theme URI',
- 'Description' => 'Description',
- 'Author' => 'Author',
- 'AuthorURI' => 'Author URI',
- 'Version' => 'Version',
- 'Template' => 'Template',
- 'Status' => 'Status',
- 'Tags' => 'Tags',
- 'TextDomain' => 'Text Domain',
- 'DomainPath' => 'Domain Path',
- );
-
- /**
- * Default themes.
- *
- * @var array
- */
- private static $default_themes = array(
- 'classic' => 'WordPress Classic',
- 'default' => 'WordPress Default',
- 'twentyten' => 'Twenty Ten',
- 'twentyeleven' => 'Twenty Eleven',
- 'twentytwelve' => 'Twenty Twelve',
- 'twentythirteen' => 'Twenty Thirteen',
- 'twentyfourteen' => 'Twenty Fourteen',
- 'twentyfifteen' => 'Twenty Fifteen',
- 'twentysixteen' => 'Twenty Sixteen',
- 'twentyseventeen' => 'Twenty Seventeen',
- 'twentynineteen' => 'Twenty Nineteen',
- 'twentytwenty' => 'Twenty Twenty',
- );
-
- /**
- * Renamed theme tags.
- *
- * @var array
- */
- private static $tag_map = array(
- 'fixed-width' => 'fixed-layout',
- 'flexible-width' => 'fluid-layout',
- );
-
- /**
- * Absolute path to the theme root, usually wp-content/themes
- *
- * @var string
- */
- private $theme_root;
-
- /**
- * Header data from the theme's style.css file.
- *
- * @var array
- */
- private $headers = array();
-
- /**
- * Header data from the theme's style.css file after being sanitized.
- *
- * @var array
- */
- private $headers_sanitized;
-
- /**
- * Header name from the theme's style.css after being translated.
- *
- * Cached due to sorting functions running over the translated name.
- *
- * @var string
- */
- private $name_translated;
-
- /**
- * Errors encountered when initializing the theme.
- *
- * @var WP_Error
- */
- private $errors;
-
- /**
- * The directory name of the theme's files, inside the theme root.
- *
- * In the case of a child theme, this is directory name of the child theme.
- * Otherwise, 'stylesheet' is the same as 'template'.
- *
- * @var string
- */
- private $stylesheet;
-
- /**
- * The directory name of the theme's files, inside the theme root.
- *
- * In the case of a child theme, this is the directory name of the parent theme.
- * Otherwise, 'template' is the same as 'stylesheet'.
- *
- * @var string
- */
- private $template;
-
- /**
- * A reference to the parent theme, in the case of a child theme.
- *
- * @var WP_Theme
- */
- private $parent;
-
- /**
- * URL to the theme root, usually an absolute URL to wp-content/themes
- *
- * @var string
- */
- private $theme_root_uri;
-
- /**
- * Flag for whether the theme's textdomain is loaded.
- *
- * @var bool
- */
- private $textdomain_loaded;
-
- /**
- * Stores an md5 hash of the theme root, to function as the cache key.
- *
- * @var string
- */
- private $cache_hash;
-
- /**
- * Flag for whether the themes cache bucket should be persistently cached.
- *
- * Default is false. Can be set with the {@see 'wp_cache_themes_persistently'} filter.
- *
- * @var bool
- */
- private static $persistently_cache;
-
- /**
- * Expiration time for the themes cache bucket.
- *
- * By default the bucket is not cached, so this value is useless.
- *
- * @var bool
- */
- private static $cache_expiration = 1800;
-
- /**
- * Constructor for WP_Theme.
- *
- * @since 3.4.0
- *
- * @global array $wp_theme_directories
- *
- * @param string $theme_dir Directory of the theme within the theme_root.
- * @param string $theme_root Theme root.
- * @param WP_Error|void $_child If this theme is a parent theme, the child may be passed for validation purposes.
- */
- public function __construct( $theme_dir, $theme_root, $_child = null ) {
- global $wp_theme_directories;
-
- // Initialize caching on first run.
- if ( ! isset( self::$persistently_cache ) ) {
- /** This action is documented in wp-includes/theme.php */
- self::$persistently_cache = apply_filters( 'wp_cache_themes_persistently', false, 'WP_Theme' );
- if ( self::$persistently_cache ) {
- wp_cache_add_global_groups( 'themes' );
- if ( is_int( self::$persistently_cache ) ) {
- self::$cache_expiration = self::$persistently_cache;
- }
- } else {
- wp_cache_add_non_persistent_groups( 'themes' );
- }
- }
-
- $this->theme_root = $theme_root;
- $this->stylesheet = $theme_dir;
-
- // Correct a situation where the theme is 'some-directory/some-theme' but 'some-directory' was passed in as part of the theme root instead.
- if ( ! in_array( $theme_root, (array) $wp_theme_directories ) && in_array( dirname( $theme_root ), (array) $wp_theme_directories ) ) {
- $this->stylesheet = basename( $this->theme_root ) . '/' . $this->stylesheet;
- $this->theme_root = dirname( $theme_root );
- }
-
- $this->cache_hash = md5( $this->theme_root . '/' . $this->stylesheet );
- $theme_file = $this->stylesheet . '/style.css';
-
- $cache = $this->cache_get( 'theme' );
-
- if ( is_array( $cache ) ) {
- foreach ( array( 'errors', 'headers', 'template' ) as $key ) {
- if ( isset( $cache[ $key ] ) ) {
- $this->$key = $cache[ $key ];
- }
- }
- if ( $this->errors ) {
- return;
- }
- if ( isset( $cache['theme_root_template'] ) ) {
- $theme_root_template = $cache['theme_root_template'];
- }
- } elseif ( ! file_exists( $this->theme_root . '/' . $theme_file ) ) {
- $this->headers['Name'] = $this->stylesheet;
- if ( ! file_exists( $this->theme_root . '/' . $this->stylesheet ) ) {
- $this->errors = new WP_Error(
- 'theme_not_found',
- sprintf(
- /* translators: %s: Theme directory name. */
- __( 'The theme directory "%s" does not exist.' ),
- esc_html( $this->stylesheet )
- )
- );
- } else {
- $this->errors = new WP_Error( 'theme_no_stylesheet', __( 'Stylesheet is missing.' ) );
- }
- $this->template = $this->stylesheet;
- $this->cache_add(
- 'theme',
- array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- 'template' => $this->template,
- )
- );
- if ( ! file_exists( $this->theme_root ) ) { // Don't cache this one.
- $this->errors->add( 'theme_root_missing', __( 'ERROR: The themes directory is either empty or doesn&#8217;t exist. Please check your installation.' ) );
- }
- return;
- } elseif ( ! is_readable( $this->theme_root . '/' . $theme_file ) ) {
- $this->headers['Name'] = $this->stylesheet;
- $this->errors = new WP_Error( 'theme_stylesheet_not_readable', __( 'Stylesheet is not readable.' ) );
- $this->template = $this->stylesheet;
- $this->cache_add(
- 'theme',
- array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- 'template' => $this->template,
- )
- );
- return;
- } else {
- $this->headers = get_file_data( $this->theme_root . '/' . $theme_file, self::$file_headers, 'theme' );
- // Default themes always trump their pretenders.
- // Properly identify default themes that are inside a directory within wp-content/themes.
- $default_theme_slug = array_search( $this->headers['Name'], self::$default_themes );
- if ( $default_theme_slug ) {
- if ( basename( $this->stylesheet ) != $default_theme_slug ) {
- $this->headers['Name'] .= '/' . $this->stylesheet;
- }
- }
- }
-
- if ( ! $this->template && $this->stylesheet === $this->headers['Template'] ) {
- $this->errors = new WP_Error(
- 'theme_child_invalid',
- sprintf(
- /* translators: %s: Template. */
- __( 'The theme defines itself as its parent theme. Please check the %s header.' ),
- '<code>Template</code>'
- )
- );
- $this->cache_add(
- 'theme',
- array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- )
- );
-
- return;
- }
-
- // (If template is set from cache [and there are no errors], we know it's good.)
- if ( ! $this->template ) {
- $this->template = $this->headers['Template'];
- }
-
- if ( ! $this->template ) {
- $this->template = $this->stylesheet;
- if ( ! file_exists( $this->theme_root . '/' . $this->stylesheet . '/index.php' ) ) {
- $error_message = sprintf(
- /* translators: 1: index.php, 2: Documentation URL, 3: style.css */
- __( 'Template is missing. Standalone themes need to have a %1$s template file. <a href="%2$s">Child themes</a> need to have a Template header in the %3$s stylesheet.' ),
- '<code>index.php</code>',
- __( 'https://developer.wordpress.org/themes/advanced-topics/child-themes/' ),
- '<code>style.css</code>'
- );
- $this->errors = new WP_Error( 'theme_no_index', $error_message );
- $this->cache_add(
- 'theme',
- array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- 'template' => $this->template,
- )
- );
- return;
- }
- }
-
- // If we got our data from cache, we can assume that 'template' is pointing to the right place.
- if ( ! is_array( $cache ) && $this->template != $this->stylesheet && ! file_exists( $this->theme_root . '/' . $this->template . '/index.php' ) ) {
- // If we're in a directory of themes inside /themes, look for the parent nearby.
- // wp-content/themes/directory-of-themes/*
- $parent_dir = dirname( $this->stylesheet );
- $directories = search_theme_directories();
- if ( '.' != $parent_dir && file_exists( $this->theme_root . '/' . $parent_dir . '/' . $this->template . '/index.php' ) ) {
- $this->template = $parent_dir . '/' . $this->template;
- } elseif ( $directories && isset( $directories[ $this->template ] ) ) {
- // Look for the template in the search_theme_directories() results, in case it is in another theme root.
- // We don't look into directories of themes, just the theme root.
- $theme_root_template = $directories[ $this->template ]['theme_root'];
- } else {
- // Parent theme is missing.
- $this->errors = new WP_Error(
- 'theme_no_parent',
- sprintf(
- /* translators: %s: Theme directory name. */
- __( 'The parent theme is missing. Please install the "%s" parent theme.' ),
- esc_html( $this->template )
- )
- );
- $this->cache_add(
- 'theme',
- array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- 'template' => $this->template,
- )
- );
- $this->parent = new WP_Theme( $this->template, $this->theme_root, $this );
- return;
- }
- }
-
- // Set the parent, if we're a child theme.
- if ( $this->template != $this->stylesheet ) {
- // If we are a parent, then there is a problem. Only two generations allowed! Cancel things out.
- if ( $_child instanceof WP_Theme && $_child->template == $this->stylesheet ) {
- $_child->parent = null;
- $_child->errors = new WP_Error(
- 'theme_parent_invalid',
- sprintf(
- /* translators: %s: Theme directory name. */
- __( 'The "%s" theme is not a valid parent theme.' ),
- esc_html( $_child->template )
- )
- );
- $_child->cache_add(
- 'theme',
- array(
- 'headers' => $_child->headers,
- 'errors' => $_child->errors,
- 'stylesheet' => $_child->stylesheet,
- 'template' => $_child->template,
- )
- );
- // The two themes actually reference each other with the Template header.
- if ( $_child->stylesheet == $this->template ) {
- $this->errors = new WP_Error(
- 'theme_parent_invalid',
- sprintf(
- /* translators: %s: Theme directory name. */
- __( 'The "%s" theme is not a valid parent theme.' ),
- esc_html( $this->template )
- )
- );
- $this->cache_add(
- 'theme',
- array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- 'template' => $this->template,
- )
- );
- }
- return;
- }
- // Set the parent. Pass the current instance so we can do the crazy checks above and assess errors.
- $this->parent = new WP_Theme( $this->template, isset( $theme_root_template ) ? $theme_root_template : $this->theme_root, $this );
- }
-
- if ( wp_paused_themes()->get( $this->stylesheet ) && ( ! is_wp_error( $this->errors ) || ! isset( $this->errors->errors['theme_paused'] ) ) ) {
- $this->errors = new WP_Error( 'theme_paused', __( 'This theme failed to load properly and was paused within the admin backend.' ) );
- }
-
- // We're good. If we didn't retrieve from cache, set it.
- if ( ! is_array( $cache ) ) {
- $cache = array(
- 'headers' => $this->headers,
- 'errors' => $this->errors,
- 'stylesheet' => $this->stylesheet,
- 'template' => $this->template,
- );
- // If the parent theme is in another root, we'll want to cache this. Avoids an entire branch of filesystem calls above.
- if ( isset( $theme_root_template ) ) {
- $cache['theme_root_template'] = $theme_root_template;
- }
- $this->cache_add( 'theme', $cache );
- }
- }
-
- /**
- * When converting the object to a string, the theme name is returned.
- *
- * @since 3.4.0
- *
- * @return string Theme name, ready for display (translated)
- */
- public function __toString() {
- return (string) $this->display( 'Name' );
- }
-
- /**
- * __isset() magic method for properties formerly returned by current_theme_info()
- *
- * @staticvar array $properties
- *
- * @since 3.4.0
- *
- * @param string $offset Property to check if set.
- * @return bool Whether the given property is set.
- */
- public function __isset( $offset ) {
- static $properties = array(
- 'name',
- 'title',
- 'version',
- 'parent_theme',
- 'template_dir',
- 'stylesheet_dir',
- 'template',
- 'stylesheet',
- 'screenshot',
- 'description',
- 'author',
- 'tags',
- 'theme_root',
- 'theme_root_uri',
- );
-
- return in_array( $offset, $properties );
- }
-
- /**
- * __get() magic method for properties formerly returned by current_theme_info()
- *
- * @since 3.4.0
- *
- * @param string $offset Property to get.
- * @return mixed Property value.
- */
- public function __get( $offset ) {
- switch ( $offset ) {
- case 'name':
- case 'title':
- return $this->get( 'Name' );
- case 'version':
- return $this->get( 'Version' );
- case 'parent_theme':
- return $this->parent() ? $this->parent()->get( 'Name' ) : '';
- case 'template_dir':
- return $this->get_template_directory();
- case 'stylesheet_dir':
- return $this->get_stylesheet_directory();
- case 'template':
- return $this->get_template();
- case 'stylesheet':
- return $this->get_stylesheet();
- case 'screenshot':
- return $this->get_screenshot( 'relative' );
- // 'author' and 'description' did not previously return translated data.
- case 'description':
- return $this->display( 'Description' );
- case 'author':
- return $this->display( 'Author' );
- case 'tags':
- return $this->get( 'Tags' );
- case 'theme_root':
- return $this->get_theme_root();
- case 'theme_root_uri':
- return $this->get_theme_root_uri();
- // For cases where the array was converted to an object.
- default:
- return $this->offsetGet( $offset );
- }
- }
-
- /**
- * Method to implement ArrayAccess for keys formerly returned by get_themes()
- *
- * @since 3.4.0
- *
- * @param mixed $offset
- * @param mixed $value
- */
- public function offsetSet( $offset, $value ) {}
-
- /**
- * Method to implement ArrayAccess for keys formerly returned by get_themes()
- *
- * @since 3.4.0
- *
- * @param mixed $offset
- */
- public function offsetUnset( $offset ) {}
-
- /**
- * Method to implement ArrayAccess for keys formerly returned by get_themes()
- *
- * @staticvar array $keys
- *
- * @since 3.4.0
- *
- * @param mixed $offset
- * @return bool
- */
- public function offsetExists( $offset ) {
- static $keys = array(
- 'Name',
- 'Version',
- 'Status',
- 'Title',
- 'Author',
- 'Author Name',
- 'Author URI',
- 'Description',
- 'Template',
- 'Stylesheet',
- 'Template Files',
- 'Stylesheet Files',
- 'Template Dir',
- 'Stylesheet Dir',
- 'Screenshot',
- 'Tags',
- 'Theme Root',
- 'Theme Root URI',
- 'Parent Theme',
- );
-
- return in_array( $offset, $keys );
- }
-
- /**
- * Method to implement ArrayAccess for keys formerly returned by get_themes().
- *
- * Author, Author Name, Author URI, and Description did not previously return
- * translated data. We are doing so now as it is safe to do. However, as
- * Name and Title could have been used as the key for get_themes(), both remain
- * untranslated for back compatibility. This means that ['Name'] is not ideal,
- * and care should be taken to use `$theme::display( 'Name' )` to get a properly
- * translated header.
- *
- * @since 3.4.0
- *
- * @param mixed $offset
- * @return mixed
- */
- public function offsetGet( $offset ) {
- switch ( $offset ) {
- case 'Name':
- case 'Title':
- /*
- * See note above about using translated data. get() is not ideal.
- * It is only for backward compatibility. Use display().
- */
- return $this->get( 'Name' );
- case 'Author':
- return $this->display( 'Author' );
- case 'Author Name':
- return $this->display( 'Author', false );
- case 'Author URI':
- return $this->display( 'AuthorURI' );
- case 'Description':
- return $this->display( 'Description' );
- case 'Version':
- case 'Status':
- return $this->get( $offset );
- case 'Template':
- return $this->get_template();
- case 'Stylesheet':
- return $this->get_stylesheet();
- case 'Template Files':
- return $this->get_files( 'php', 1, true );
- case 'Stylesheet Files':
- return $this->get_files( 'css', 0, false );
- case 'Template Dir':
- return $this->get_template_directory();
- case 'Stylesheet Dir':
- return $this->get_stylesheet_directory();
- case 'Screenshot':
- return $this->get_screenshot( 'relative' );
- case 'Tags':
- return $this->get( 'Tags' );
- case 'Theme Root':
- return $this->get_theme_root();
- case 'Theme Root URI':
- return $this->get_theme_root_uri();
- case 'Parent Theme':
- return $this->parent() ? $this->parent()->get( 'Name' ) : '';
- default:
- return null;
- }
- }
-
- /**
- * Returns errors property.
- *
- * @since 3.4.0
- *
- * @return WP_Error|false WP_Error if there are errors, or false.
- */
- public function errors() {
- return is_wp_error( $this->errors ) ? $this->errors : false;
- }
-
- /**
- * Whether the theme exists.
- *
- * A theme with errors exists. A theme with the error of 'theme_not_found',
- * meaning that the theme's directory was not found, does not exist.
- *
- * @since 3.4.0
- *
- * @return bool Whether the theme exists.
- */
- public function exists() {
- return ! ( $this->errors() && in_array( 'theme_not_found', $this->errors()->get_error_codes() ) );
- }
-
- /**
- * Returns reference to the parent theme.
- *
- * @since 3.4.0
- *
- * @return WP_Theme|false Parent theme, or false if the current theme is not a child theme.
- */
- public function parent() {
- return isset( $this->parent ) ? $this->parent : false;
- }
-
- /**
- * Adds theme data to cache.
- *
- * Cache entries keyed by the theme and the type of data.
- *
- * @since 3.4.0
- *
- * @param string $key Type of data to store (theme, screenshot, headers, post_templates)
- * @param array|string $data Data to store
- * @return bool Return value from wp_cache_add()
- */
- private function cache_add( $key, $data ) {
- return wp_cache_add( $key . '-' . $this->cache_hash, $data, 'themes', self::$cache_expiration );
- }
-
- /**
- * Gets theme data from cache.
- *
- * Cache entries are keyed by the theme and the type of data.
- *
- * @since 3.4.0
- *
- * @param string $key Type of data to retrieve (theme, screenshot, headers, post_templates)
- * @return mixed Retrieved data
- */
- private function cache_get( $key ) {
- return wp_cache_get( $key . '-' . $this->cache_hash, 'themes' );
- }
-
- /**
- * Clears the cache for the theme.
- *
- * @since 3.4.0
- */
- public function cache_delete() {
- foreach ( array( 'theme', 'screenshot', 'headers', 'post_templates' ) as $key ) {
- wp_cache_delete( $key . '-' . $this->cache_hash, 'themes' );
- }
- $this->template = null;
- $this->textdomain_loaded = null;
- $this->theme_root_uri = null;
- $this->parent = null;
- $this->errors = null;
- $this->headers_sanitized = null;
- $this->name_translated = null;
- $this->headers = array();
- $this->__construct( $this->stylesheet, $this->theme_root );
- }
-
- /**
- * Get a raw, unformatted theme header.
- *
- * The header is sanitized, but is not translated, and is not marked up for display.
- * To get a theme header for display, use the display() method.
- *
- * Use the get_template() method, not the 'Template' header, for finding the template.
- * The 'Template' header is only good for what was written in the style.css, while
- * get_template() takes into account where WordPress actually located the theme and
- * whether it is actually valid.
- *
- * @since 3.4.0
- *
- * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
- * @return string|false String on success, false on failure.
- */
- public function get( $header ) {
- if ( ! isset( $this->headers[ $header ] ) ) {
- return false;
- }
-
- if ( ! isset( $this->headers_sanitized ) ) {
- $this->headers_sanitized = $this->cache_get( 'headers' );
- if ( ! is_array( $this->headers_sanitized ) ) {
- $this->headers_sanitized = array();
- }
- }
-
- if ( isset( $this->headers_sanitized[ $header ] ) ) {
- return $this->headers_sanitized[ $header ];
- }
-
- // If themes are a persistent group, sanitize everything and cache it. One cache add is better than many cache sets.
- if ( self::$persistently_cache ) {
- foreach ( array_keys( $this->headers ) as $_header ) {
- $this->headers_sanitized[ $_header ] = $this->sanitize_header( $_header, $this->headers[ $_header ] );
- }
- $this->cache_add( 'headers', $this->headers_sanitized );
- } else {
- $this->headers_sanitized[ $header ] = $this->sanitize_header( $header, $this->headers[ $header ] );
- }
-
- return $this->headers_sanitized[ $header ];
- }
-
- /**
- * Gets a theme header, formatted and translated for display.
- *
- * @since 3.4.0
- *
- * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
- * @param bool $markup Optional. Whether to mark up the header. Defaults to true.
- * @param bool $translate Optional. Whether to translate the header. Defaults to true.
- * @return string|false Processed header, false on failure.
- */
- public function display( $header, $markup = true, $translate = true ) {
- $value = $this->get( $header );
- if ( false === $value ) {
- return false;
- }
-
- if ( $translate && ( empty( $value ) || ! $this->load_textdomain() ) ) {
- $translate = false;
- }
-
- if ( $translate ) {
- $value = $this->translate_header( $header, $value );
- }
-
- if ( $markup ) {
- $value = $this->markup_header( $header, $value, $translate );
- }
-
- return $value;
- }
-
- /**
- * Sanitize a theme header.
- *
- * @since 3.4.0
- *
- * @staticvar array $header_tags
- * @staticvar array $header_tags_with_a
- *
- * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
- * @param string $value Value to sanitize.
- * @return mixed
- */
- private function sanitize_header( $header, $value ) {
- switch ( $header ) {
- case 'Status':
- if ( ! $value ) {
- $value = 'publish';
- break;
- }
- // Fall through otherwise.
- case 'Name':
- static $header_tags = array(
- 'abbr' => array( 'title' => true ),
- 'acronym' => array( 'title' => true ),
- 'code' => true,
- 'em' => true,
- 'strong' => true,
- );
- $value = wp_kses( $value, $header_tags );
- break;
- case 'Author':
- // There shouldn't be anchor tags in Author, but some themes like to be challenging.
- case 'Description':
- static $header_tags_with_a = array(
- 'a' => array(
- 'href' => true,
- 'title' => true,
- ),
- 'abbr' => array( 'title' => true ),
- 'acronym' => array( 'title' => true ),
- 'code' => true,
- 'em' => true,
- 'strong' => true,
- );
- $value = wp_kses( $value, $header_tags_with_a );
- break;
- case 'ThemeURI':
- case 'AuthorURI':
- $value = esc_url_raw( $value );
- break;
- case 'Tags':
- $value = array_filter( array_map( 'trim', explode( ',', strip_tags( $value ) ) ) );
- break;
- case 'Version':
- $value = strip_tags( $value );
- break;
- }
-
- return $value;
- }
-
- /**
- * Mark up a theme header.
- *
- * @since 3.4.0
- *
- * @staticvar string $comma
- *
- * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
- * @param string $value Value to mark up.
- * @param string $translate Whether the header has been translated.
- * @return string Value, marked up.
- */
- private function markup_header( $header, $value, $translate ) {
- switch ( $header ) {
- case 'Name':
- if ( empty( $value ) ) {
- $value = esc_html( $this->get_stylesheet() );
- }
- break;
- case 'Description':
- $value = wptexturize( $value );
- break;
- case 'Author':
- if ( $this->get( 'AuthorURI' ) ) {
- $value = sprintf( '<a href="%1$s">%2$s</a>', $this->display( 'AuthorURI', true, $translate ), $value );
- } elseif ( ! $value ) {
- $value = __( 'Anonymous' );
- }
- break;
- case 'Tags':
- static $comma = null;
- if ( ! isset( $comma ) ) {
- /* translators: Used between list items, there is a space after the comma. */
- $comma = __( ', ' );
- }
- $value = implode( $comma, $value );
- break;
- case 'ThemeURI':
- case 'AuthorURI':
- $value = esc_url( $value );
- break;
- }
-
- return $value;
- }
-
- /**
- * Translate a theme header.
- *
- * @since 3.4.0
- *
- * @staticvar array $tags_list
- *
- * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
- * @param string $value Value to translate.
- * @return string Translated value.
- */
- private function translate_header( $header, $value ) {
- switch ( $header ) {
- case 'Name':
- // Cached for sorting reasons.
- if ( isset( $this->name_translated ) ) {
- return $this->name_translated;
- }
- // phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
- $this->name_translated = translate( $value, $this->get( 'TextDomain' ) );
- return $this->name_translated;
- case 'Tags':
- if ( empty( $value ) || ! function_exists( 'get_theme_feature_list' ) ) {
- return $value;
- }
-
- static $tags_list;
- if ( ! isset( $tags_list ) ) {
- $tags_list = array(
- // As of 4.6, deprecated tags which are only used to provide translation for older themes.
- 'black' => __( 'Black' ),
- 'blue' => __( 'Blue' ),
- 'brown' => __( 'Brown' ),
- 'gray' => __( 'Gray' ),
- 'green' => __( 'Green' ),
- 'orange' => __( 'Orange' ),
- 'pink' => __( 'Pink' ),
- 'purple' => __( 'Purple' ),
- 'red' => __( 'Red' ),
- 'silver' => __( 'Silver' ),
- 'tan' => __( 'Tan' ),
- 'white' => __( 'White' ),
- 'yellow' => __( 'Yellow' ),
- 'dark' => __( 'Dark' ),
- 'light' => __( 'Light' ),
- 'fixed-layout' => __( 'Fixed Layout' ),
- 'fluid-layout' => __( 'Fluid Layout' ),
- 'responsive-layout' => __( 'Responsive Layout' ),
- 'blavatar' => __( 'Blavatar' ),
- 'photoblogging' => __( 'Photoblogging' ),
- 'seasonal' => __( 'Seasonal' ),
- );
-
- $feature_list = get_theme_feature_list( false ); // No API
- foreach ( $feature_list as $tags ) {
- $tags_list += $tags;
- }
- }
-
- foreach ( $value as &$tag ) {
- if ( isset( $tags_list[ $tag ] ) ) {
- $tag = $tags_list[ $tag ];
- } elseif ( isset( self::$tag_map[ $tag ] ) ) {
- $tag = $tags_list[ self::$tag_map[ $tag ] ];
- }
- }
-
- return $value;
-
- default:
- // phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
- $value = translate( $value, $this->get( 'TextDomain' ) );
- }
- return $value;
- }
-
- /**
- * The directory name of the theme's "stylesheet" files, inside the theme root.
- *
- * In the case of a child theme, this is directory name of the child theme.
- * Otherwise, get_stylesheet() is the same as get_template().
- *
- * @since 3.4.0
- *
- * @return string Stylesheet
- */
- public function get_stylesheet() {
- return $this->stylesheet;
- }
-
- /**
- * The directory name of the theme's "template" files, inside the theme root.
- *
- * In the case of a child theme, this is the directory name of the parent theme.
- * Otherwise, the get_template() is the same as get_stylesheet().
- *
- * @since 3.4.0
- *
- * @return string Template
- */
- public function get_template() {
- return $this->template;
- }
-
- /**
- * Returns the absolute path to the directory of a theme's "stylesheet" files.
- *
- * In the case of a child theme, this is the absolute path to the directory
- * of the child theme's files.
- *
- * @since 3.4.0
- *
- * @return string Absolute path of the stylesheet directory.
- */
- public function get_stylesheet_directory() {
- if ( $this->errors() && in_array( 'theme_root_missing', $this->errors()->get_error_codes() ) ) {
- return '';
- }
-
- return $this->theme_root . '/' . $this->stylesheet;
- }
-
- /**
- * Returns the absolute path to the directory of a theme's "template" files.
- *
- * In the case of a child theme, this is the absolute path to the directory
- * of the parent theme's files.
- *
- * @since 3.4.0
- *
- * @return string Absolute path of the template directory.
- */
- public function get_template_directory() {
- if ( $this->parent() ) {
- $theme_root = $this->parent()->theme_root;
- } else {
- $theme_root = $this->theme_root;
- }
-
- return $theme_root . '/' . $this->template;
- }
-
- /**
- * Returns the URL to the directory of a theme's "stylesheet" files.
- *
- * In the case of a child theme, this is the URL to the directory of the
- * child theme's files.
- *
- * @since 3.4.0
- *
- * @return string URL to the stylesheet directory.
- */
- public function get_stylesheet_directory_uri() {
- return $this->get_theme_root_uri() . '/' . str_replace( '%2F', '/', rawurlencode( $this->stylesheet ) );
- }
-
- /**
- * Returns the URL to the directory of a theme's "template" files.
- *
- * In the case of a child theme, this is the URL to the directory of the
- * parent theme's files.
- *
- * @since 3.4.0
- *
- * @return string URL to the template directory.
- */
- public function get_template_directory_uri() {
- if ( $this->parent() ) {
- $theme_root_uri = $this->parent()->get_theme_root_uri();
- } else {
- $theme_root_uri = $this->get_theme_root_uri();
- }
-
- r