2006-04-18 00:44:33 -04:00
< ? php
2008-08-12 16:18:05 -04:00
/**
2008-09-01 01:44:16 -04:00
* Theme , template , and stylesheet functions .
*
2008-08-12 16:18:05 -04:00
* @ package WordPress
2012-02-27 20:49:49 -05:00
* @ subpackage Theme
2008-09-01 01:44:16 -04:00
*/
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 16:24:44 -05:00
/**
* Returns an array of WP_Theme objects based on the arguments .
*
* Despite advances over get_themes (), this function is still quite expensive , and grows
* linearly with additional themes . Stick to wp_get_theme () if possible .
*
* @ since 3.4 . 0
*
* @ param array $args Arguments . Currently 'errors' ( defaults to false ), 'allowed'
* ( true , false ; null for either ; defaults to null ; only applies to multisite ), and 'blog_id'
* ( defaults to current blog ; used to find allowed themes ; only applies to multisite ) .
* @ return Array of WP_Theme objects .
*/
function wp_get_themes ( $args = array () ) {
global $wp_theme_directories ;
$defaults = array ( 'errors' => false , 'allowed' => null , 'blog_id' => 0 );
$args = wp_parse_args ( $args , $defaults );
2012-03-08 02:46:39 -05:00
static $_theme_directories , $_themes = array ();
if ( ! isset ( $_theme_directories ) ) {
$_theme_directories = search_theme_directories ();
if ( count ( $wp_theme_directories ) > 1 ) {
// Make sure the current theme wins out, in case search_theme_directories() picks the wrong
// one in the case of a conflict. (Normally, last registered theme root wins.)
$current_theme = get_stylesheet ();
$root_of_current_theme = get_raw_theme_root ( $current_theme );
if ( ! in_array ( $root_of_current_theme , $wp_theme_directories ) )
2012-03-08 13:00:11 -05:00
$root_of_current_theme = WP_CONTENT_DIR . $root_of_current_theme ;
2012-03-08 02:46:39 -05:00
$_theme_directories [ $current_theme ][ 'theme_root' ] = $root_of_current_theme ;
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 16:24:44 -05:00
}
}
2012-03-08 02:46:39 -05:00
if ( empty ( $_theme_directories ) )
return array ();
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 16:24:44 -05:00
2012-03-08 02:46:39 -05:00
$theme_directories = $_theme_directories ;
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 16:24:44 -05:00
if ( is_multisite () && null !== $args [ 'allowed' ] ) {
2012-03-08 02:46:39 -05:00
$allowed = $args [ 'allowed' ];
if ( 'network' === $allowed )
$theme_directories = array_intersect_key ( $theme_directories , WP_Theme :: get_allowed_on_network ( $args [ 'blog_id' ] ) );
elseif ( 'site' === $allowed )
$theme_directories = array_intersect_key ( $theme_directories , WP_Theme :: get_allowed_on_site ( $args [ 'blog_id' ] ) );
elseif ( $allowed )
$theme_directories = array_intersect_key ( $theme_directories , WP_Theme :: get_allowed ( $args [ 'blog_id' ] ) );
else
$theme_directories = array_diff_key ( $theme_directories , WP_Theme :: get_allowed ( $args [ 'blog_id' ] ) );
}
$themes = array ();
foreach ( $theme_directories as $theme => $theme_root ) {
if ( isset ( $_themes [ $theme ] ) )
$themes [ $theme ] = $_themes [ $theme ];
else
$themes [ $theme ] = $_themes [ $theme ] = new WP_Theme ( $theme , $theme_root [ 'theme_root' ] );
}
if ( null !== $args [ 'errors' ] ) {
foreach ( $themes as $theme => $wp_theme ) {
if ( $wp_theme -> errors () != $args [ 'errors' ] )
unset ( $themes [ $theme ] );
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 16:24:44 -05:00
}
}
return $themes ;
}
/**
* Gets a WP_Theme object for a theme .
*
* @ since 3.4 . 0
*
* @ param string $stylesheet Directory name for the theme . Optional . Defaults to current theme .
* @ param string $theme_root Absolute path of the theme root to look in . Optional . If not specified , get_raw_theme_root ()
* is used to calculate the theme root for the $stylesheet provided ( or current theme ) .
* @ return WP_Theme
*/
function wp_get_theme ( $stylesheet = null , $theme_root = null ) {
global $wp_theme_directories ;
if ( empty ( $stylesheet ) )
$stylesheet = get_stylesheet ();
if ( empty ( $theme_root ) ) {
$theme_root = get_raw_theme_root ( $stylesheet );
2012-03-05 12:30:09 -05:00
if ( ! in_array ( $theme_root , ( array ) $wp_theme_directories ) )
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 16:24:44 -05:00
$theme_root = WP_CONTENT_DIR . $theme_root ;
}
return new WP_Theme ( $stylesheet , $theme_root );
}
2010-05-03 16:56:57 -04:00
/**
* Whether a child theme is in use .
*
* @ since 3.0 . 0
*
* @ return bool true if a child theme is in use , false otherwise .
**/
function is_child_theme () {
return ( TEMPLATEPATH !== STYLESHEETPATH );
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve name of the current stylesheet .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* The theme name that the administrator has currently set the front end theme
2008-09-01 01:44:16 -04:00
* as .
*
2008-09-24 01:24:33 -04:00
* For all extensive purposes , the template name and the stylesheet name are
* going to be the same for most cases .
*
2008-09-01 01:44:16 -04:00
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'stylesheet' filter on stylesheet name .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string Stylesheet name .
2006-04-18 00:44:33 -04:00
*/
function get_stylesheet () {
2006-08-30 17:46:31 -04:00
return apply_filters ( 'stylesheet' , get_option ( 'stylesheet' ));
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve stylesheet directory path for current theme .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'stylesheet_directory' filter on stylesheet directory and theme name .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string Path to current theme directory .
2008-09-01 01:44:16 -04:00
*/
2006-04-18 00:44:33 -04:00
function get_stylesheet_directory () {
$stylesheet = get_stylesheet ();
2009-10-13 15:06:35 -04:00
$theme_root = get_theme_root ( $stylesheet );
$stylesheet_dir = " $theme_root / $stylesheet " ;
return apply_filters ( 'stylesheet_directory' , $stylesheet_dir , $stylesheet , $theme_root );
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve stylesheet directory URI .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
*
2008-09-24 01:24:33 -04:00
* @ return string
2008-09-01 01:44:16 -04:00
*/
2006-04-18 00:44:33 -04:00
function get_stylesheet_directory_uri () {
2006-10-16 01:57:33 -04:00
$stylesheet = get_stylesheet ();
2009-10-13 15:06:35 -04:00
$theme_root_uri = get_theme_root_uri ( $stylesheet );
$stylesheet_dir_uri = " $theme_root_uri / $stylesheet " ;
return apply_filters ( 'stylesheet_directory_uri' , $stylesheet_dir_uri , $stylesheet , $theme_root_uri );
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve URI of current theme stylesheet .
2008-09-01 01:44:16 -04:00
*
2008-12-09 13:03:31 -05:00
* The stylesheet file name is 'style.css' which is appended to { @ link
2008-09-24 01:24:33 -04:00
* get_stylesheet_directory_uri () stylesheet directory URI } path .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'stylesheet_uri' filter on stylesheet URI path and stylesheet directory URI .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string
2008-09-01 01:44:16 -04:00
*/
2006-04-18 00:44:33 -04:00
function get_stylesheet_uri () {
$stylesheet_dir_uri = get_stylesheet_directory_uri ();
2011-05-22 18:30:05 -04:00
$stylesheet_uri = $stylesheet_dir_uri . '/style.css' ;
2006-04-18 00:44:33 -04:00
return apply_filters ( 'stylesheet_uri' , $stylesheet_uri , $stylesheet_dir_uri );
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve localized stylesheet URI .
2008-09-01 01:44:16 -04:00
*
2008-09-25 10:12:58 -04:00
* The stylesheet directory for the localized stylesheet files are located , by
* default , in the base theme directory . The name of the locale file will be the
* locale followed by '.css' . If that does not exist , then the text direction
* stylesheet will be checked for existence , for example 'ltr.css' .
*
* The theme may change the location of the stylesheet directory by either using
* the 'stylesheet_directory_uri' filter or the 'locale_stylesheet_uri' filter .
* If you want to change the location of the stylesheet files for the entire
* WordPress workflow , then change the former . If you just have the locale in a
* separate folder , then change the latter .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'locale_stylesheet_uri' filter on stylesheet URI path and stylesheet directory URI .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string
2008-09-01 01:44:16 -04:00
*/
2006-09-18 19:40:19 -04:00
function get_locale_stylesheet_uri () {
global $wp_locale ;
$stylesheet_dir_uri = get_stylesheet_directory_uri ();
$dir = get_stylesheet_directory ();
$locale = get_locale ();
if ( file_exists ( " $dir / $locale .css " ) )
$stylesheet_uri = " $stylesheet_dir_uri / $locale .css " ;
2006-10-13 06:33:44 -04:00
elseif ( ! empty ( $wp_locale -> text_direction ) && file_exists ( " $dir / { $wp_locale -> text_direction } .css " ) )
2006-09-18 19:40:19 -04:00
$stylesheet_uri = " $stylesheet_dir_uri / { $wp_locale -> text_direction } .css " ;
else
$stylesheet_uri = '' ;
return apply_filters ( 'locale_stylesheet_uri' , $stylesheet_uri , $stylesheet_dir_uri );
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve name of the current theme .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'template' filter on template option .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string Template name .
2008-09-01 01:44:16 -04:00
*/
2006-04-18 00:44:33 -04:00
function get_template () {
2006-08-30 17:46:31 -04:00
return apply_filters ( 'template' , get_option ( 'template' ));
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve current theme directory .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'template_directory' filter on template directory path and template name .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string Template directory path .
2008-09-01 01:44:16 -04:00
*/
2006-04-18 00:44:33 -04:00
function get_template_directory () {
$template = get_template ();
2009-10-13 15:06:35 -04:00
$theme_root = get_theme_root ( $template );
$template_dir = " $theme_root / $template " ;
2009-10-15 16:26:21 -04:00
2009-10-13 15:06:35 -04:00
return apply_filters ( 'template_directory' , $template_dir , $template , $theme_root );
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve theme directory URI .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'template_directory_uri' filter on template directory URI path and template name .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string Template directory URI .
2008-09-01 01:44:16 -04:00
*/
2006-04-18 00:44:33 -04:00
function get_template_directory_uri () {
$template = get_template ();
2009-10-13 15:06:35 -04:00
$theme_root_uri = get_theme_root_uri ( $template );
$template_dir_uri = " $theme_root_uri / $template " ;
2009-10-15 16:26:21 -04:00
2009-10-13 15:06:35 -04:00
return apply_filters ( 'template_directory_uri' , $template_dir_uri , $template , $theme_root_uri );
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve theme data from parsed theme file .
2008-09-01 01:44:16 -04:00
*
2008-09-25 10:12:58 -04:00
* The description will have the tags filtered with the following HTML elements
* whitelisted . The < b > 'a' </ b > element with the < em > href </ em > and < em > title </ em >
* attributes . The < b > abbr </ b > element with the < em > title </ em > attribute . The
2010-12-02 17:56:55 -05:00
* < b > acronym </ b > element with the < em > title </ em > attribute allowed . The
2008-09-25 10:12:58 -04:00
* < b > code </ b > , < b > em </ b > , and < b > strong </ b > elements also allowed .
*
* The style . css file must contain theme name , theme URI , and description . The
* data can also contain author URI , author , template ( parent template ),
* version , status , and finally tags . Some of these are not used by WordPress
* administration panels , but are used by theme directory web sites which list
* the theme .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
*
2008-09-24 01:24:33 -04:00
* @ param string $theme_file Theme file path .
* @ return array Theme data .
2008-09-01 01:44:16 -04:00
*/
2006-11-29 18:18:35 -05:00
function get_theme_data ( $theme_file ) {
2010-01-15 17:11:12 -05:00
$default_headers = array (
'Name' => 'Theme Name' ,
'URI' => 'Theme URI' ,
'Description' => 'Description' ,
'Author' => 'Author' ,
2009-10-15 17:07:00 -04:00
'AuthorURI' => 'Author URI' ,
2010-01-15 17:11:12 -05:00
'Version' => 'Version' ,
'Template' => 'Template' ,
'Status' => 'Status' ,
2009-10-15 17:07:00 -04:00
'Tags' => 'Tags'
);
2007-05-10 23:44:03 -04:00
$themes_allowed_tags = array (
'a' => array (
'href' => array (), 'title' => array ()
),
'abbr' => array (
'title' => array ()
),
'acronym' => array (
'title' => array ()
),
'code' => array (),
'em' => array (),
'strong' => array ()
);
2007-06-13 22:25:30 -04:00
2009-10-15 17:07:00 -04:00
$theme_data = get_file_data ( $theme_file , $default_headers , 'theme' );
2009-03-19 20:52:42 -04:00
2009-10-15 17:07:00 -04:00
$theme_data [ 'Name' ] = $theme_data [ 'Title' ] = wp_kses ( $theme_data [ 'Name' ], $themes_allowed_tags );
2009-04-20 14:18:39 -04:00
2009-10-15 17:07:00 -04:00
$theme_data [ 'URI' ] = esc_url ( $theme_data [ 'URI' ] );
2008-01-10 15:51:07 -05:00
2009-10-15 17:07:00 -04:00
$theme_data [ 'Description' ] = wptexturize ( wp_kses ( $theme_data [ 'Description' ], $themes_allowed_tags ) );
2008-01-10 15:51:07 -05:00
2009-10-15 17:07:00 -04:00
$theme_data [ 'AuthorURI' ] = esc_url ( $theme_data [ 'AuthorURI' ] );
2007-06-13 22:25:30 -04:00
2009-10-15 17:07:00 -04:00
$theme_data [ 'Template' ] = wp_kses ( $theme_data [ 'Template' ], $themes_allowed_tags );
$theme_data [ 'Version' ] = wp_kses ( $theme_data [ 'Version' ], $themes_allowed_tags );
2007-06-13 22:25:30 -04:00
2009-10-15 17:07:00 -04:00
if ( $theme_data [ 'Status' ] == '' )
$theme_data [ 'Status' ] = 'publish' ;
2006-04-18 00:44:33 -04:00
else
2009-10-15 17:07:00 -04:00
$theme_data [ 'Status' ] = wp_kses ( $theme_data [ 'Status' ], $themes_allowed_tags );
2007-06-13 22:25:30 -04:00
2009-10-15 17:07:00 -04:00
if ( $theme_data [ 'Tags' ] == '' )
$theme_data [ 'Tags' ] = array ();
2007-12-31 13:39:43 -05:00
else
2009-10-15 17:07:00 -04:00
$theme_data [ 'Tags' ] = array_map ( 'trim' , explode ( ',' , wp_kses ( $theme_data [ 'Tags' ], array () ) ) );
2007-12-31 13:39:43 -05:00
2009-10-15 17:07:00 -04:00
if ( $theme_data [ 'Author' ] == '' ) {
2010-05-15 02:28:35 -04:00
$theme_data [ 'Author' ] = $theme_data [ 'AuthorName' ] = __ ( 'Anonymous' );
2009-10-15 17:07:00 -04:00
} else {
2010-05-15 02:28:35 -04:00
$theme_data [ 'AuthorName' ] = wp_kses ( $theme_data [ 'Author' ], $themes_allowed_tags );
2009-10-15 17:07:00 -04:00
if ( empty ( $theme_data [ 'AuthorURI' ] ) ) {
2010-05-15 02:28:35 -04:00
$theme_data [ 'Author' ] = $theme_data [ 'AuthorName' ];
2008-01-10 15:51:07 -05:00
} else {
2010-12-21 12:17:58 -05:00
$theme_data [ 'Author' ] = sprintf ( '<a href="%1$s" title="%2$s">%3$s</a>' , $theme_data [ 'AuthorURI' ], esc_attr__ ( 'Visit author homepage' ), $theme_data [ 'AuthorName' ] );
2008-01-10 15:51:07 -05:00
}
2006-04-18 00:44:33 -04:00
}
2009-10-15 17:07:00 -04:00
return $theme_data ;
2006-04-18 00:44:33 -04:00
}
2009-10-13 15:06:35 -04:00
/**
* Retrieve theme roots .
*
* @ since 2.9 . 0
*
2011-09-05 15:08:15 -04:00
* @ return array | string An array of theme roots keyed by template / stylesheet or a single theme root if all themes have the same root .
2009-10-13 15:06:35 -04:00
*/
function get_theme_roots () {
2010-09-21 15:41:35 -04:00
global $wp_theme_directories ;
2010-11-17 11:11:44 -05:00
if ( count ( $wp_theme_directories ) <= 1 )
2012-02-28 11:22:26 -05:00
return '/themes' ;
2010-09-21 15:41:35 -04:00
2009-10-29 17:53:57 -04:00
$theme_roots = get_site_transient ( 'theme_roots' );
2009-10-13 15:06:35 -04:00
if ( false === $theme_roots ) {
2012-02-28 15:08:08 -05:00
search_theme_directories (); // Regenerate the transient.
$theme_roots = get_site_transient ( 'theme_roots' );
2009-10-13 15:06:35 -04:00
}
return $theme_roots ;
}
/**
2009-10-15 16:45:32 -04:00
* Register a directory that contains themes .
2009-10-13 15:06:35 -04:00
*
* @ since 2.9 . 0
*
2009-10-15 16:45:32 -04:00
* @ param string $directory Either the full filesystem path to a theme folder or a folder within WP_CONTENT_DIR
2009-10-13 15:06:35 -04:00
* @ return bool
*/
2012-02-28 13:02:21 -05:00
function register_theme_directory ( $directory ) {
2009-10-13 15:06:35 -04:00
global $wp_theme_directories ;
2009-12-08 16:29:12 -05:00
2012-02-28 13:02:21 -05:00
if ( ! file_exists ( $directory ) ) {
// Try prepending as the theme directory could be relative to the content directory
$directory = WP_CONTENT_DIR . '/' . $directory ;
// If this directory does not exist, return and do not register
if ( ! file_exists ( $directory ) )
return false ;
}
2012-02-28 11:22:26 -05:00
2012-02-28 13:02:21 -05:00
$wp_theme_directories [] = $directory ;
2009-10-15 16:26:21 -04:00
2009-10-13 15:06:35 -04:00
return true ;
}
/**
* Search all registered theme directories for complete and valid themes .
*
* @ since 2.9 . 0
*
* @ return array Valid themes found
*/
function search_theme_directories () {
2012-02-28 15:05:00 -05:00
global $wp_theme_directories ;
2009-10-13 15:06:35 -04:00
if ( empty ( $wp_theme_directories ) )
return false ;
2012-02-28 15:05:00 -05:00
static $found_themes ;
if ( isset ( $found_themes ) )
return $found_themes ;
2009-10-13 15:06:35 -04:00
2012-02-28 15:05:00 -05:00
$found_themes = array ();
2009-10-15 16:26:21 -04:00
2012-03-05 20:50:54 -05:00
// Set up maybe-relative, maybe-absolute array of theme directories.
// We always want to return absolute, but we need to cache relative
// use in for get_theme_root().
foreach ( $wp_theme_directories as $theme_root ) {
if ( 0 === strpos ( $theme_root , WP_CONTENT_DIR ) )
$relative_theme_roots [ str_replace ( WP_CONTENT_DIR , '' , $theme_root ) ] = $theme_root ;
else
$relative_theme_roots [ $theme_root ] = $theme_root ;
}
2012-02-28 15:05:00 -05:00
if ( $cache_expiration = apply_filters ( 'wp_cache_themes_persistently' , false , 'search_theme_directories' ) ) {
$cached_roots = get_site_transient ( 'theme_roots' );
if ( is_array ( $cached_roots ) ) {
foreach ( $cached_roots as $theme_dir => $theme_root ) {
$found_themes [ $theme_dir ] = array (
'theme_file' => $theme_dir . '/style.css' ,
2012-03-05 20:50:54 -05:00
'theme_root' => $relative_theme_roots [ $theme_root ], // Convert relative to absolute.
2012-02-28 15:05:00 -05:00
);
}
return $found_themes ;
}
if ( ! is_int ( $cache_expiration ) )
$cache_expiration = 7200 ;
} else {
// Two hours is the default.
$cache_expiration = 7200 ;
}
2009-10-13 15:06:35 -04:00
2012-02-28 15:05:00 -05:00
/* Loop the registered theme directories and extract all themes */
foreach ( $wp_theme_directories as $theme_root ) {
2009-10-13 15:06:35 -04:00
2012-02-28 15:05:00 -05:00
// Start with directories in the root of the current theme directory.
$dirs = @ scandir ( $theme_root );
if ( ! $dirs )
2009-10-13 15:06:35 -04:00
return false ;
2012-02-28 15:05:00 -05:00
foreach ( $dirs as $dir ) {
if ( ! is_dir ( $theme_root . '/' . $dir ) || $dir [ 0 ] == '.' || $dir == 'CVS' )
continue ;
if ( file_exists ( $theme_root . '/' . $dir . '/style.css' ) ) {
// wp-content/themes/a-single-theme
// wp-content/themes is $theme_root, a-single-theme is $dir
$found_themes [ $dir ] = array (
'theme_file' => $dir . '/style.css' ,
'theme_root' => $theme_root ,
);
} else {
$found_theme = false ;
// wp-content/themes/a-folder-of-themes/*
// wp-content/themes is $theme_root, a-folder-of-themes is $dir, then themes are $sub_dirs
$sub_dirs = @ scandir ( $theme_root . '/' . $dir );
if ( ! $sub_dirs )
return false ;
foreach ( $sub_dirs as $sub_dir ) {
if ( ! is_dir ( $theme_root . '/' . $dir ) || $dir [ 0 ] == '.' || $dir == 'CVS' )
continue ;
if ( ! file_exists ( $theme_root . '/' . $dir . '/' . $sub_dir . '/style.css' ) )
continue ;
$found_themes [ $dir . '/' . $sub_dir ] = array (
'theme_file' => $dir . '/' . $sub_dir . '/style.css' ,
'theme_root' => $theme_root ,
);
$found_theme = true ;
2009-10-13 15:06:35 -04:00
}
2012-02-28 15:05:00 -05:00
// Never mind the above, it's just a theme missing a style.css.
// Return it; WP_Theme will catch the error.
if ( ! $found_theme )
$found_themes [ $dir ] = array (
'theme_file' => $dir . '/style.css' ,
'theme_root' => $theme_root ,
);
2009-10-13 15:06:35 -04:00
}
}
}
2012-02-28 15:05:00 -05:00
asort ( $found_themes );
$theme_roots = array ();
2012-03-05 20:50:54 -05:00
$relative_theme_roots = array_flip ( $relative_theme_roots );
2012-02-28 15:05:00 -05:00
foreach ( $found_themes as $theme_dir => $theme_data ) {
2012-03-05 20:50:54 -05:00
$theme_roots [ $theme_dir ] = $relative_theme_roots [ $theme_data [ 'theme_root' ] ]; // Convert absolute to relative.
2012-02-28 15:05:00 -05:00
}
if ( $theme_roots != get_site_transient ( 'theme_roots' ) )
set_site_transient ( 'theme_roots' , $theme_roots , $cache_expiration );
return $found_themes ;
2009-10-13 15:06:35 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve path to themes directory .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* Does not have trailing slash .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'theme_root' filter on path .
2008-09-01 01:44:16 -04:00
*
2010-09-07 07:21:11 -04:00
* @ param string $stylesheet_or_template The stylesheet or template name of the theme
2008-09-24 01:24:33 -04:00
* @ return string Theme path .
2008-09-01 01:44:16 -04:00
*/
2009-10-13 15:06:35 -04:00
function get_theme_root ( $stylesheet_or_template = false ) {
2012-02-28 13:02:21 -05:00
global $wp_theme_directories ;
if ( $stylesheet_or_template && $theme_root = get_raw_theme_root ( $stylesheet_or_template ) ) {
// Always prepend WP_CONTENT_DIR unless the root currently registered as a theme directory.
// This gives relative theme roots the benefit of the doubt when things go haywire.
2012-03-05 12:30:09 -05:00
if ( ! in_array ( $theme_root , ( array ) $wp_theme_directories ) )
2012-02-28 11:22:26 -05:00
$theme_root = WP_CONTENT_DIR . $theme_root ;
} else {
2009-10-13 15:06:35 -04:00
$theme_root = WP_CONTENT_DIR . '/themes' ;
2012-02-28 11:22:26 -05:00
}
2009-12-08 16:29:12 -05:00
2009-10-13 15:06:35 -04:00
return apply_filters ( 'theme_root' , $theme_root );
2006-04-18 00:44:33 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve URI for themes directory .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* Does not have trailing slash .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
*
2012-03-08 13:18:10 -05:00
* @ param string $stylesheet_or_template Optional . The stylesheet or template name of the theme .
* Default is to leverage the main theme root .
* @ param string $theme_root Optional . The theme root for which calculations will be based , preventing
* the need for a get_raw_theme_root () call .
2008-09-24 01:24:33 -04:00
* @ return string Themes URI .
2008-09-01 01:44:16 -04:00
*/
2012-03-08 13:18:10 -05:00
function get_theme_root_uri ( $stylesheet_or_template = false , $theme_root = false ) {
2012-02-28 13:02:21 -05:00
global $wp_theme_directories ;
2012-03-08 13:18:10 -05:00
if ( $stylesheet_or_template && ! $theme_root )
$theme_root = get_raw_theme_root ( $stylesheet_or_template );
if ( $stylesheet_or_template && $theme_root ) {
2012-03-05 12:30:09 -05:00
if ( in_array ( $theme_root , ( array ) $wp_theme_directories ) ) {
2012-02-28 13:02:21 -05:00
// Absolute path. Make an educated guess. YMMV -- but note the filter below.
if ( 0 === strpos ( $theme_root , WP_CONTENT_DIR ) )
$theme_root_uri = content_url ( str_replace ( WP_CONTENT_DIR , '' , $theme_root ) );
elseif ( 0 === strpos ( $theme_root , ABSPATH ) )
$theme_root_uri = site_url ( str_replace ( ABSPATH , '' , $theme_root ) );
elseif ( 0 === strpos ( $theme_root , WP_PLUGIN_DIR ) || 0 === strpos ( $theme_root , WPMU_PLUGIN_DIR ) )
$theme_root_uri = plugins_url ( basename ( $theme_root ), $theme_root );
else
$theme_root_uri = $theme_root ;
} else {
2012-02-28 11:22:26 -05:00
$theme_root_uri = content_url ( $theme_root );
2012-02-28 13:02:21 -05:00
}
2010-09-21 15:41:35 -04:00
} else {
2009-10-13 15:06:35 -04:00
$theme_root_uri = content_url ( 'themes' );
2010-09-21 15:41:35 -04:00
}
2009-10-13 15:06:35 -04:00
return apply_filters ( 'theme_root_uri' , $theme_root_uri , get_option ( 'siteurl' ), $stylesheet_or_template );
2006-04-18 00:44:33 -04:00
}
2010-09-21 15:41:35 -04:00
/**
2012-02-28 11:22:26 -05:00
* Get the raw theme root relative to the content directory with no filters applied .
2010-09-21 15:41:35 -04:00
*
* @ since 3.1 . 0
*
* @ param string $stylesheet_or_template The stylesheet or template name of the theme
2012-02-28 14:59:53 -05:00
* @ param bool $skip_cache Optional . Whether to skip the cache . Defaults to false , meaning the cache is used .
2010-09-21 15:41:35 -04:00
* @ return string Theme root
*/
2012-02-28 14:59:53 -05:00
function get_raw_theme_root ( $stylesheet_or_template , $skip_cache = false ) {
2010-09-21 15:41:35 -04:00
global $wp_theme_directories ;
2010-11-17 11:11:44 -05:00
if ( count ( $wp_theme_directories ) <= 1 )
2012-02-28 11:22:26 -05:00
return '/themes' ;
2010-09-21 15:41:35 -04:00
$theme_root = false ;
// If requesting the root for the current theme, consult options to avoid calling get_theme_roots()
2012-02-28 14:59:53 -05:00
if ( ! $skip_cache ) {
2010-11-17 11:11:44 -05:00
if ( get_option ( 'stylesheet' ) == $stylesheet_or_template )
$theme_root = get_option ( 'stylesheet_root' );
elseif ( get_option ( 'template' ) == $stylesheet_or_template )
$theme_root = get_option ( 'template_root' );
}
2010-09-21 15:41:35 -04:00
if ( empty ( $theme_root ) ) {
$theme_roots = get_theme_roots ();
if ( ! empty ( $theme_roots [ $stylesheet_or_template ]) )
$theme_root = $theme_roots [ $stylesheet_or_template ];
}
return $theme_root ;
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Display localized stylesheet link element .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
*/
2006-09-18 19:40:19 -04:00
function locale_stylesheet () {
$stylesheet = get_locale_stylesheet_uri ();
if ( empty ( $stylesheet ) )
return ;
echo '<link rel="stylesheet" href="' . $stylesheet . '" type="text/css" media="screen" />' ;
}
2008-09-01 01:44:16 -04:00
/**
2008-09-25 10:12:58 -04:00
* Start preview theme output buffer .
2008-09-01 01:44:16 -04:00
*
2008-09-25 10:12:58 -04:00
* Will only preform task if the user has permissions and template and preview
* query variables exist .
2008-09-01 01:44:16 -04:00
*
2009-09-22 03:16:19 -04:00
* @ since 2.6 . 0
2008-09-01 01:44:16 -04:00
*/
2008-05-20 13:19:33 -04:00
function preview_theme () {
if ( ! ( isset ( $_GET [ 'template' ]) && isset ( $_GET [ 'preview' ])) )
return ;
if ( ! current_user_can ( 'switch_themes' ) )
return ;
2010-12-17 03:32:53 -05:00
// Admin Thickbox requests
if ( isset ( $_GET [ 'preview_iframe' ] ) )
2010-12-17 03:42:37 -05:00
show_admin_bar ( false );
2009-03-19 20:30:32 -04:00
$_GET [ 'template' ] = preg_replace ( '|[^a-z0-9_./-]|i' , '' , $_GET [ 'template' ]);
2008-07-29 13:03:00 -04:00
2008-08-12 17:13:25 -04:00
if ( validate_file ( $_GET [ 'template' ]) )
2008-07-29 13:03:00 -04:00
return ;
2008-05-20 13:19:33 -04:00
2009-09-21 17:43:41 -04:00
add_filter ( 'template' , '_preview_theme_template_filter' );
2008-05-20 13:19:33 -04:00
if ( isset ( $_GET [ 'stylesheet' ]) ) {
2009-03-19 20:30:32 -04:00
$_GET [ 'stylesheet' ] = preg_replace ( '|[^a-z0-9_./-]|i' , '' , $_GET [ 'stylesheet' ]);
2008-08-12 17:13:25 -04:00
if ( validate_file ( $_GET [ 'stylesheet' ]) )
2008-07-29 13:03:00 -04:00
return ;
2009-09-21 17:43:41 -04:00
add_filter ( 'stylesheet' , '_preview_theme_stylesheet_filter' );
2008-05-20 13:19:33 -04:00
}
2010-12-17 03:42:37 -05:00
2009-05-24 19:47:49 -04:00
// Prevent theme mods to current theme being used on theme being previewed
2012-02-29 00:09:29 -05:00
add_filter ( 'pre_option_theme_mods_' . get_option ( 'stylesheet' ), '__return_empty_array' );
2009-04-22 18:32:35 -04:00
2008-05-20 13:19:33 -04:00
ob_start ( 'preview_theme_ob_filter' );
}
add_action ( 'setup_theme' , 'preview_theme' );
2009-09-21 17:43:41 -04:00
/**
* Private function to modify the current template when previewing a theme
2009-09-22 03:16:19 -04:00
*
* @ since 2.9 . 0
* @ access private
2009-09-24 13:19:13 -04:00
*
2009-09-21 17:43:41 -04:00
* @ return string
*/
function _preview_theme_template_filter () {
return isset ( $_GET [ 'template' ]) ? $_GET [ 'template' ] : '' ;
}
/**
* Private function to modify the current stylesheet when previewing a theme
2009-09-24 13:19:13 -04:00
*
2009-09-22 03:16:19 -04:00
* @ since 2.9 . 0
* @ access private
2009-09-24 13:19:13 -04:00
*
2009-09-21 17:43:41 -04:00
* @ return string
*/
function _preview_theme_stylesheet_filter () {
return isset ( $_GET [ 'stylesheet' ]) ? $_GET [ 'stylesheet' ] : '' ;
}
2008-09-25 10:12:58 -04:00
/**
* Callback function for ob_start () to capture all links in the theme .
*
2009-09-22 03:16:19 -04:00
* @ since 2.6 . 0
2008-09-25 10:12:58 -04:00
* @ access private
*
* @ param string $content
* @ return string
*/
2008-05-20 13:19:33 -04:00
function preview_theme_ob_filter ( $content ) {
return preg_replace_callback ( " |(<a.*?href=([ \" ']))(.*?)([ \" '].*?>)| " , 'preview_theme_ob_filter_callback' , $content );
}
2008-09-25 10:12:58 -04:00
/**
* Manipulates preview theme links in order to control and maintain location .
*
* Callback function for preg_replace_callback () to accept and filter matches .
*
2009-09-22 03:16:19 -04:00
* @ since 2.6 . 0
2008-09-25 10:12:58 -04:00
* @ access private
*
* @ param array $matches
* @ return string
*/
2008-05-20 13:19:33 -04:00
function preview_theme_ob_filter_callback ( $matches ) {
2008-11-14 21:20:26 -05:00
if ( strpos ( $matches [ 4 ], 'onclick' ) !== false )
$matches [ 4 ] = preg_replace ( '#onclick=([\'"]).*?(?<!\\\)\\1#i' , '' , $matches [ 4 ]); //Strip out any onclicks from rest of <a>. (?<!\\\) means to ignore the '" if its escaped by \ to prevent breaking mid-attribute.
2008-05-20 13:19:33 -04:00
if (
( false !== strpos ( $matches [ 3 ], '/wp-admin/' ) )
||
2010-01-04 12:23:29 -05:00
( false !== strpos ( $matches [ 3 ], '://' ) && 0 !== strpos ( $matches [ 3 ], home_url () ) )
2008-05-20 13:19:33 -04:00
||
( false !== strpos ( $matches [ 3 ], '/feed/' ) )
||
( false !== strpos ( $matches [ 3 ], '/trackback/' ) )
)
return $matches [ 1 ] . " # $matches[2] onclick= $matches[2] return false; " . $matches [ 4 ];
2011-12-20 17:10:47 -05:00
$link = add_query_arg ( array ( 'preview' => 1 , 'template' => $_GET [ 'template' ], 'stylesheet' => @ $_GET [ 'stylesheet' ], 'preview_iframe' => 1 ), $matches [ 3 ] );
2008-05-20 13:19:33 -04:00
if ( 0 === strpos ( $link , 'preview=1' ) )
$link = " ? $link " ;
2009-05-05 15:43:53 -04:00
return $matches [ 1 ] . esc_attr ( $link ) . $matches [ 4 ];
2008-05-20 13:19:33 -04:00
}
2008-09-25 10:12:58 -04:00
/**
* Switches current theme to new template and stylesheet names .
*
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 0
2012-02-29 00:09:29 -05:00
* @ uses do_action () Calls 'switch_theme' action , passing the new theme .
2008-09-25 10:12:58 -04:00
*
* @ param string $template Template name
* @ param string $stylesheet Stylesheet name .
*/
2012-02-29 00:09:29 -05:00
function switch_theme ( $template , $stylesheet ) {
2011-09-08 15:25:20 -04:00
global $wp_theme_directories , $sidebars_widgets ;
2011-09-29 17:41:22 -04:00
if ( is_array ( $sidebars_widgets ) )
set_theme_mod ( 'sidebars_widgets' , array ( 'time' => time (), 'data' => $sidebars_widgets ) );
2010-09-21 15:41:35 -04:00
2012-02-29 00:09:29 -05:00
$old_theme = wp_get_theme ();
$new_theme = wp_get_theme ( $stylesheet );
$new_name = $new_theme -> get ( 'Name' );
2011-09-02 18:13:55 -04:00
2012-02-29 00:09:29 -05:00
update_option ( 'template' , $template );
update_option ( 'stylesheet' , $stylesheet );
2011-09-02 18:13:55 -04:00
2012-02-29 00:09:29 -05:00
if ( count ( $wp_theme_directories ) > 1 ) {
update_option ( 'template_root' , get_raw_theme_root ( $template , true ) );
update_option ( 'stylesheet_root' , get_raw_theme_root ( $stylesheet , true ) );
2010-09-21 15:41:35 -04:00
}
2011-09-02 18:13:55 -04:00
2012-02-29 00:09:29 -05:00
update_option ( 'current_theme' , $new_name );
2011-09-02 18:13:55 -04:00
2012-02-29 00:09:29 -05:00
if ( is_admin () && false === get_option ( 'theme_mods_' . $stylesheet ) ) {
$default_theme_mods = ( array ) get_option ( 'mods_' . $new_name );
2010-12-15 12:39:00 -05:00
add_option ( " theme_mods_ $stylesheet " , $default_theme_mods );
}
2011-09-02 18:13:55 -04:00
2012-03-08 16:22:24 -05:00
update_option ( 'theme_switched' , $old_theme -> get_stylesheet () );
2012-02-29 00:09:29 -05:00
do_action ( 'switch_theme' , $new_name , $new_theme );
2007-11-13 00:07:44 -05:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Checks that current theme files 'index.php' and 'style.css' exists .
2008-09-01 01:44:16 -04:00
*
2010-05-06 15:53:40 -04:00
* Does not check the default theme , which is the fallback and should always exist .
2010-04-21 13:14:25 -04:00
* Will switch theme to the fallback theme if current theme does not validate .
2012-01-05 15:50:54 -05:00
* You can use the 'validate_current_theme' filter to return false to
2008-10-06 11:29:47 -04:00
* disable this functionality .
2008-09-01 01:44:16 -04:00
*
* @ since 1.5 . 0
2010-05-06 15:53:40 -04:00
* @ see WP_DEFAULT_THEME
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return bool
2008-09-01 01:44:16 -04:00
*/
2006-07-11 18:44:56 -04:00
function validate_current_theme () {
2006-07-21 15:00:04 -04:00
// Don't validate during an install/upgrade.
2008-10-06 11:29:47 -04:00
if ( defined ( 'WP_INSTALLING' ) || ! apply_filters ( 'validate_current_theme' , true ) )
2006-07-21 15:00:04 -04:00
return true ;
2010-05-06 15:53:40 -04:00
if ( get_template () != WP_DEFAULT_THEME && ! file_exists ( get_template_directory () . '/index.php' ) ) {
switch_theme ( WP_DEFAULT_THEME , WP_DEFAULT_THEME );
2006-07-11 18:44:56 -04:00
return false ;
}
2010-05-06 15:53:40 -04:00
if ( get_stylesheet () != WP_DEFAULT_THEME && ! file_exists ( get_template_directory () . '/style.css' ) ) {
switch_theme ( WP_DEFAULT_THEME , WP_DEFAULT_THEME );
2006-07-11 18:44:56 -04:00
return false ;
}
2010-12-14 14:19:47 -05:00
2010-12-14 14:17:49 -05:00
if ( is_child_theme () && ! file_exists ( get_stylesheet_directory () . '/style.css' ) ) {
switch_theme ( WP_DEFAULT_THEME , WP_DEFAULT_THEME );
return false ;
}
2006-07-11 18:44:56 -04:00
return true ;
}
2010-10-06 17:00:17 -04:00
/**
* Retrieve all theme modifications .
*
* @ since 3.1 . 0
*
2010-10-07 01:59:50 -04:00
* @ return array Theme modifications .
2010-10-06 17:00:17 -04:00
*/
function get_theme_mods () {
$theme_slug = get_option ( 'stylesheet' );
if ( false === ( $mods = get_option ( " theme_mods_ $theme_slug " ) ) ) {
2012-02-29 15:07:22 -05:00
$theme_name = get_option ( 'current_theme' );
if ( false === $theme_name )
$theme_name = wp_get_theme () -> get ( 'Name' );
2010-10-07 01:59:50 -04:00
$mods = get_option ( " mods_ $theme_name " ); // Deprecated location.
2010-10-06 17:00:17 -04:00
if ( is_admin () && false !== $mods ) {
update_option ( " theme_mods_ $theme_slug " , $mods );
delete_option ( " mods_ $theme_name " );
}
}
return $mods ;
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve theme modification value for the current theme .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* If the modification name does not exist , then the $default will be passed
* through { @ link http :// php . net / sprintf sprintf ()} PHP function with the first
* string the template directory URI and the second string the stylesheet
* directory URI .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
2008-09-24 01:24:33 -04:00
* @ uses apply_filters () Calls 'theme_mod_$name' filter on the value .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ param string $name Theme modification name .
* @ param bool | string $default
* @ return string
2008-09-01 01:44:16 -04:00
*/
2010-10-07 01:59:50 -04:00
function get_theme_mod ( $name , $default = false ) {
2010-10-06 17:00:17 -04:00
$mods = get_theme_mods ();
2006-10-16 02:06:18 -04:00
2010-10-07 01:59:50 -04:00
if ( isset ( $mods [ $name ] ) )
return apply_filters ( " theme_mod_ $name " , $mods [ $name ] );
2006-10-16 02:06:18 -04:00
2012-02-02 18:35:37 -05:00
if ( is_string ( $default ) )
$default = sprintf ( $default , get_template_directory_uri (), get_stylesheet_directory_uri () );
return apply_filters ( " theme_mod_ $name " , $default );
2006-10-16 02:06:18 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Update theme modification value for the current theme .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
*
2008-09-24 01:24:33 -04:00
* @ param string $name Theme modification name .
* @ param string $value theme modification value .
2008-09-01 01:44:16 -04:00
*/
2010-10-07 01:59:50 -04:00
function set_theme_mod ( $name , $value ) {
2010-10-06 17:00:17 -04:00
$mods = get_theme_mods ();
2006-10-16 02:06:18 -04:00
2010-10-07 01:59:50 -04:00
$mods [ $name ] = $value ;
2006-10-16 02:06:18 -04:00
2010-10-06 17:00:17 -04:00
$theme = get_option ( 'stylesheet' );
update_option ( " theme_mods_ $theme " , $mods );
2006-10-16 02:06:18 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Remove theme modification name from current theme list .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* If removing the name also removes all elements , then the entire option will
* be removed .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
*
2008-09-24 01:24:33 -04:00
* @ param string $name Theme modification name .
* @ return null
2008-09-01 01:44:16 -04:00
*/
2007-01-03 18:49:34 -05:00
function remove_theme_mod ( $name ) {
2010-10-06 17:00:17 -04:00
$mods = get_theme_mods ();
2007-01-03 18:49:34 -05:00
2010-10-07 01:59:50 -04:00
if ( ! isset ( $mods [ $name ] ) )
2007-01-03 18:49:34 -05:00
return ;
2010-10-07 01:59:50 -04:00
unset ( $mods [ $name ] );
2007-01-03 18:49:34 -05:00
2010-10-07 01:59:50 -04:00
if ( empty ( $mods ) )
2007-01-03 18:49:34 -05:00
return remove_theme_mods ();
2010-10-06 17:00:17 -04:00
$theme = get_option ( 'stylesheet' );
update_option ( " theme_mods_ $theme " , $mods );
2007-01-03 18:49:34 -05:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Remove theme modifications option for current theme .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
*/
2006-10-16 02:06:18 -04:00
function remove_theme_mods () {
2010-10-06 17:00:17 -04:00
delete_option ( 'theme_mods_' . get_option ( 'stylesheet' ) );
2012-02-29 15:07:22 -05:00
// Old style.
$theme_name = get_option ( 'current_theme' );
if ( false === $theme_name )
$theme_name = wp_get_theme () -> get ( 'Name' );
delete_option ( 'mods_' . $theme_name );
2006-10-16 02:06:18 -04:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve text color for custom header .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
2008-09-24 01:24:33 -04:00
* @ uses HEADER_TEXTCOLOR
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string
2008-09-01 01:44:16 -04:00
*/
2007-01-03 18:49:34 -05:00
function get_header_textcolor () {
2010-05-13 17:44:37 -04:00
$default = defined ( 'HEADER_TEXTCOLOR' ) ? HEADER_TEXTCOLOR : '' ;
return get_theme_mod ( 'header_textcolor' , $default );
2007-01-03 18:49:34 -05:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Display text color for custom header .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
*/
2007-01-03 18:49:34 -05:00
function header_textcolor () {
2007-02-27 10:24:54 -05:00
echo get_header_textcolor ();
2007-01-03 18:49:34 -05:00
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Retrieve header image for custom header .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
2008-09-24 01:24:33 -04:00
* @ uses HEADER_IMAGE
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ return string
2008-09-01 01:44:16 -04:00
*/
2007-01-03 18:49:34 -05:00
function get_header_image () {
2010-12-09 12:59:35 -05:00
$default = defined ( 'HEADER_IMAGE' ) ? HEADER_IMAGE : '' ;
$url = get_theme_mod ( 'header_image' , $default );
2011-04-29 15:45:30 -04:00
if ( 'remove-header' == $url )
return false ;
2011-04-28 19:02:16 -04:00
if ( is_random_header_image () )
$url = get_random_header_image ();
2010-12-09 12:59:35 -05:00
if ( is_ssl () )
$url = str_replace ( 'http://' , 'https://' , $url );
else
$url = str_replace ( 'https://' , 'http://' , $url );
2011-05-22 19:19:42 -04:00
return esc_url_raw ( $url );
2007-01-03 18:49:34 -05:00
}
2011-04-28 19:02:16 -04:00
/**
2012-02-02 18:35:37 -05:00
* Get random header image data from registered images in theme .
2011-04-28 19:02:16 -04:00
*
2012-02-02 18:35:37 -05:00
* @ since 3.4 . 0
*
* @ access private
2011-04-28 19:02:16 -04:00
*
* @ return string Path to header image
*/
2012-02-02 18:35:37 -05:00
function _get_random_header_data () {
static $_wp_random_header ;
2011-04-28 19:02:16 -04:00
2012-02-02 18:35:37 -05:00
if ( empty ( $_wp_random_header ) ) {
global $_wp_default_headers ;
$header_image_mod = get_theme_mod ( 'header_image' , '' );
$headers = array ();
if ( 'random-uploaded-image' == $header_image_mod )
$headers = get_uploaded_header_images ();
elseif ( ! empty ( $_wp_default_headers ) ) {
if ( 'random-default-image' == $header_image_mod ) {
2011-06-22 15:09:23 -04:00
$headers = $_wp_default_headers ;
2012-02-02 18:35:37 -05:00
} else {
$is_random = get_theme_support ( 'custom-header' );
if ( isset ( $is_random [ 0 ] ) && ! empty ( $is_random [ 0 ][ 'random-default' ] ) )
$headers = $_wp_default_headers ;
}
2011-06-22 15:09:23 -04:00
}
2011-04-28 19:02:16 -04:00
2012-02-02 18:35:37 -05:00
if ( empty ( $headers ) )
2012-02-03 08:38:03 -05:00
return new stdClass ;
2012-02-02 18:35:37 -05:00
$_wp_random_header = ( object ) $headers [ array_rand ( $headers ) ];
$_wp_random_header -> url = sprintf ( $_wp_random_header -> url , get_template_directory_uri (), get_stylesheet_directory_uri () );
$_wp_random_header -> thumbnail_url = sprintf ( $_wp_random_header -> thumbnail_url , get_template_directory_uri (), get_stylesheet_directory_uri () );
}
return $_wp_random_header ;
}
2011-04-28 19:02:16 -04:00
2012-02-02 18:35:37 -05:00
/**
* Get random header image url from registered images in theme .
*
* @ since 3.2 . 0
*
* @ return string Path to header image
*/
2011-04-28 19:02:16 -04:00
2012-02-02 18:35:37 -05:00
function get_random_header_image () {
$random_image = _get_random_header_data ();
if ( empty ( $random_image -> url ) )
return '' ;
return $random_image -> url ;
2011-04-28 19:02:16 -04:00
}
/**
* Check if random header image is in use .
*
* Always true if user expressly chooses the option in Appearance > Header .
2011-06-22 15:09:23 -04:00
* Also true if theme has multiple header images registered , no specific header image
* is chosen , and theme turns on random headers with add_theme_support () .
2011-04-28 19:02:16 -04:00
*
2011-06-11 00:40:18 -04:00
* @ since 3.2 . 0
2011-04-28 19:02:16 -04:00
* @ uses HEADER_IMAGE
*
* @ param string $type The random pool to use . any | default | uploaded
* @ return boolean
*/
function is_random_header_image ( $type = 'any' ) {
$default = defined ( 'HEADER_IMAGE' ) ? HEADER_IMAGE : '' ;
$header_image_mod = get_theme_mod ( 'header_image' , $default );
if ( 'any' == $type ) {
if ( 'random-default-image' == $header_image_mod || 'random-uploaded-image' == $header_image_mod || ( '' != get_random_header_image () && empty ( $header_image_mod ) ) )
return true ;
} else {
if ( " random- $type -image " == $header_image_mod )
return true ;
2011-06-22 15:09:23 -04:00
elseif ( 'default' == $type && empty ( $header_image_mod ) && '' != get_random_header_image () )
2011-04-29 15:45:30 -04:00
return true ;
2011-04-28 19:02:16 -04:00
}
return false ;
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Display header image path .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
*/
2007-01-03 18:49:34 -05:00
function header_image () {
2007-02-27 10:24:54 -05:00
echo get_header_image ();
2007-01-03 18:49:34 -05:00
}
2011-04-28 19:02:16 -04:00
/**
* Get the header images uploaded for the current theme .
*
* @ since 3.2 . 0
*
* @ return array
*/
function get_uploaded_header_images () {
$header_images = array ();
// @todo caching
$headers = get_posts ( array ( 'post_type' => 'attachment' , 'meta_key' => '_wp_attachment_is_custom_header' , 'meta_value' => get_option ( 'stylesheet' ), 'orderby' => 'none' , 'nopaging' => true ) );
if ( empty ( $headers ) )
return array ();
foreach ( ( array ) $headers as $header ) {
2011-05-22 19:19:42 -04:00
$url = esc_url_raw ( $header -> guid );
2012-02-02 18:35:37 -05:00
$header_data = wp_get_attachment_metadata ( $header -> ID );
$header_index = basename ( $url );
$header_images [ $header_index ] = array ();
$header_images [ $header_index ][ 'attachment_id' ] = $header -> ID ;
$header_images [ $header_index ][ 'url' ] = $url ;
$header_images [ $header_index ][ 'thumbnail_url' ] = $url ;
$header_images [ $header_index ][ 'width' ] = $header_data [ 'width' ];
$header_images [ $header_index ][ 'height' ] = $header_data [ 'height' ];
2011-04-28 19:02:16 -04:00
}
return $header_images ;
}
2012-02-02 18:35:37 -05:00
/**
* Get the header image data .
*
* @ since 3.4 . 0
*
* @ return object
*/
function get_current_header_data () {
$data = is_random_header_image () ? _get_random_header_data () : get_theme_mod ( 'header_image_data' );
$default = array (
'url' => '' ,
'thumbnail_url' => '' ,
'width' => '' ,
'height' => '' ,
);
return ( object ) wp_parse_args ( $data , $default );
}
/**
* Get the header image width .
*
* @ since 3.4 . 0
*
* @ return int
*/
function get_header_image_width () {
return empty ( get_current_header_data () -> width ) ? HEADER_IMAGE_WIDTH : get_current_header_data () -> width ;
}
/**
* Get the header image height .
*
* @ since 3.4 . 0
*
* @ return int
*/
function get_header_image_height () {
return empty ( get_current_header_data () -> height ) ? HEADER_IMAGE_HEIGHT : get_current_header_data () -> height ;
}
2008-09-01 01:44:16 -04:00
/**
2008-09-24 01:24:33 -04:00
* Add callbacks for image header display .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* The parameter $header_callback callback will be required to display the
* content for the 'wp_head' action . The parameter $admin_header_callback
* callback will be added to Custom_Image_Header class and that will be added
* to the 'admin_menu' action .
2008-09-01 01:44:16 -04:00
*
* @ since 2.1 . 0
2008-09-24 01:24:33 -04:00
* @ uses Custom_Image_Header Sets up for $admin_header_callback for administration panel display .
2008-09-01 01:44:16 -04:00
*
2008-09-24 01:24:33 -04:00
* @ param callback $header_callback Call on 'wp_head' action .
2010-01-28 14:00:16 -05:00
* @ param callback $admin_header_callback Call on custom header administration screen .
* @ param callback $admin_image_div_callback Output a custom header image div on the custom header administration screen . Optional .
2008-09-01 01:44:16 -04:00
*/
2010-12-01 19:16:35 -05:00
function add_custom_image_header ( $header_callback , $admin_header_callback , $admin_image_div_callback = '' ) {
if ( ! empty ( $header_callback ) )
2007-01-03 18:49:34 -05:00
add_action ( 'wp_head' , $header_callback );
2011-06-22 15:09:23 -04:00
$support = array ( 'callback' => $header_callback );
$theme_support = get_theme_support ( 'custom-header' );
if ( ! empty ( $theme_support ) && is_array ( $theme_support [ 0 ] ) )
$support = array_merge ( $theme_support [ 0 ], $support );
add_theme_support ( 'custom-header' , $support );
2010-10-17 03:12:34 -04:00
add_theme_support ( 'custom-header-uploads' );
2010-02-25 17:04:59 -05:00
2007-01-03 18:49:34 -05:00
if ( ! is_admin () )
return ;
2010-12-01 19:16:35 -05:00
global $custom_image_header ;
require_once ( ABSPATH . 'wp-admin/custom-header.php' );
$custom_image_header = new Custom_Image_Header ( $admin_header_callback , $admin_image_div_callback );
add_action ( 'admin_menu' , array ( & $custom_image_header , 'init' ) );
}
/**
* Remove image header support .
*
* @ since 3.1 . 0
* @ see add_custom_image_header ()
*
* @ return bool Whether support was removed .
*/
function remove_custom_image_header () {
if ( ! current_theme_supports ( 'custom-header' ) )
return false ;
2010-12-13 16:21:50 -05:00
2010-12-01 19:16:35 -05:00
$callback = get_theme_support ( 'custom-header' );
2010-12-04 04:59:35 -05:00
remove_action ( 'wp_head' , $callback [ 0 ][ 'callback' ] );
2010-12-01 19:16:35 -05:00
_remove_theme_support ( 'custom-header' );
remove_theme_support ( 'custom-header-uploads' );
2010-12-01 19:50:23 -05:00
if ( is_admin () ) {
remove_action ( 'admin_menu' , array ( & $GLOBALS [ 'custom_image_header' ], 'init' ) );
unset ( $GLOBALS [ 'custom_image_header' ] );
}
2010-12-01 19:16:35 -05:00
return true ;
2007-01-03 18:49:34 -05:00
}
2010-02-25 14:18:44 -05:00
/**
* Register a selection of default headers to be displayed by the custom header admin UI .
*
* @ since 3.0 . 0
*
2010-04-01 23:15:18 -04:00
* @ param array $headers Array of headers keyed by a string id . The ids point to arrays containing 'url' , 'thumbnail_url' , and 'description' keys .
2010-02-25 14:18:44 -05:00
*/
function register_default_headers ( $headers ) {
global $_wp_default_headers ;
2010-04-01 23:15:18 -04:00
$_wp_default_headers = array_merge ( ( array ) $_wp_default_headers , ( array ) $headers );
}
/**
* Unregister default headers .
*
* This function must be called after register_default_headers () has already added the
* header you want to remove .
*
* @ see register_default_headers ()
* @ since 3.0 . 0
*
2010-09-07 07:21:11 -04:00
* @ param string | array $header The header string id ( key of array ) to remove , or an array thereof .
2010-04-01 23:15:18 -04:00
* @ return True on success , false on failure .
*/
function unregister_default_headers ( $header ) {
global $_wp_default_headers ;
if ( is_array ( $header ) ) {
array_map ( 'unregister_default_headers' , $header );
} elseif ( isset ( $_wp_default_headers [ $header ] ) ) {
unset ( $_wp_default_headers [ $header ] );
return true ;
} else {
return false ;
}
2010-02-25 14:18:44 -05:00
}
2010-02-09 15:37:12 -05:00
/**
* Retrieve background image for custom background .
*
* @ since 3.0 . 0
*
* @ return string
*/
function get_background_image () {
2010-03-03 12:10:43 -05:00
$default = defined ( 'BACKGROUND_IMAGE' ) ? BACKGROUND_IMAGE : '' ;
2010-02-09 15:37:12 -05:00
return get_theme_mod ( 'background_image' , $default );
}
/**
* Display background image path .
*
* @ since 3.0 . 0
*/
function background_image () {
echo get_background_image ();
}
2010-03-03 12:10:43 -05:00
/**
* Retrieve value for custom background color .
*
* @ since 3.0 . 0
* @ uses BACKGROUND_COLOR
*
* @ return string
*/
function get_background_color () {
$default = defined ( 'BACKGROUND_COLOR' ) ? BACKGROUND_COLOR : '' ;
return get_theme_mod ( 'background_color' , $default );
}
/**
* Display background color value .
*
* @ since 3.0 . 0
*/
function background_color () {
echo get_background_color ();
}
2010-02-09 15:37:12 -05:00
/**
* Add callbacks for background image display .
*
* The parameter $header_callback callback will be required to display the
* content for the 'wp_head' action . The parameter $admin_header_callback
* callback will be added to Custom_Background class and that will be added
* to the 'admin_menu' action .
*
* @ since 3.0 . 0
* @ uses Custom_Background Sets up for $admin_header_callback for administration panel display .
*
* @ param callback $header_callback Call on 'wp_head' action .
* @ param callback $admin_header_callback Call on custom background administration screen .
* @ param callback $admin_image_div_callback Output a custom background image div on the custom background administration screen . Optional .
*/
2010-12-04 04:59:35 -05:00
function add_custom_background ( $header_callback = '' , $admin_header_callback = '' , $admin_image_div_callback = '' ) {
if ( isset ( $GLOBALS [ 'custom_background' ] ) )
2010-02-17 22:12:05 -05:00
return ;
2010-12-04 04:59:35 -05:00
if ( empty ( $header_callback ) )
2010-02-09 15:37:12 -05:00
$header_callback = '_custom_background_cb' ;
2010-12-04 04:59:35 -05:00
add_action ( 'wp_head' , $header_callback );
2010-02-09 15:37:12 -05:00
2010-12-04 04:59:35 -05:00
add_theme_support ( 'custom-background' , array ( 'callback' => $header_callback ) );
2010-02-25 17:04:59 -05:00
2010-02-09 15:37:12 -05:00
if ( ! is_admin () )
return ;
2010-12-04 04:59:35 -05:00
require_once ( ABSPATH . 'wp-admin/custom-background.php' );
2011-10-18 16:20:59 -04:00
$GLOBALS [ 'custom_background' ] = new Custom_Background ( $admin_header_callback , $admin_image_div_callback );
2010-12-04 04:59:35 -05:00
add_action ( 'admin_menu' , array ( & $GLOBALS [ 'custom_background' ], 'init' ) );
}
/**
* Remove custom background support .
*
* @ since 3.1 . 0
* @ see add_custom_background ()
*
* @ return bool Whether support was removed .
*/
function remove_custom_background () {
if ( ! current_theme_supports ( 'custom-background' ) )
return false ;
2010-12-13 16:21:50 -05:00
2010-12-04 04:59:35 -05:00
$callback = get_theme_support ( 'custom-background' );
remove_action ( 'wp_head' , $callback [ 0 ][ 'callback' ] );
_remove_theme_support ( 'custom-background' );
if ( is_admin () ) {
remove_action ( 'admin_menu' , array ( & $GLOBALS [ 'custom_background' ], 'init' ) );
unset ( $GLOBALS [ 'custom_background' ] );
}
return true ;
2010-02-09 15:37:12 -05:00
}
/**
* Default custom background callback .
*
* @ since 3.0 . 0
* @ see add_custom_background ()
* @ access protected
*/
function _custom_background_cb () {
$background = get_background_image ();
2010-03-11 15:21:58 -05:00
$color = get_background_color ();
2010-06-10 14:28:25 -04:00
if ( ! $background && ! $color )
2010-02-09 15:37:12 -05:00
return ;
2010-06-10 14:28:25 -04:00
$style = $color ? " background-color: # $color ; " : '' ;
if ( $background ) {
$image = " background-image: url(' $background '); " ;
$repeat = get_theme_mod ( 'background_repeat' , 'repeat' );
if ( ! in_array ( $repeat , array ( 'no-repeat' , 'repeat-x' , 'repeat-y' , 'repeat' ) ) )
$repeat = 'repeat' ;
$repeat = " background-repeat: $repeat ; " ;
2010-06-11 16:19:35 -04:00
2010-06-10 14:28:25 -04:00
$position = get_theme_mod ( 'background_position_x' , 'left' );
if ( ! in_array ( $position , array ( 'center' , 'right' , 'left' ) ) )
$position = 'left' ;
$position = " background-position: top $position ; " ;
2010-06-11 16:19:35 -04:00
2010-06-10 14:28:25 -04:00
$attachment = get_theme_mod ( 'background_attachment' , 'scroll' );
if ( ! in_array ( $attachment , array ( 'fixed' , 'scroll' ) ) )
$attachment = 'scroll' ;
$attachment = " background-attachment: $attachment ; " ;
$style .= $image . $repeat . $position . $attachment ;
2010-03-27 22:53:04 -04:00
}
2010-02-09 15:37:12 -05:00
?>
< style type = " text/css " >
2011-10-05 13:20:43 -04:00
body . custom - background { < ? php echo trim ( $style ); ?> }
2010-02-09 15:37:12 -05:00
</ style >
< ? php
}
2010-02-26 15:12:06 -05:00
/**
2010-02-26 16:07:41 -05:00
* Add callback for custom TinyMCE editor stylesheets .
2010-02-26 15:12:06 -05:00
*
* The parameter $stylesheet is the name of the stylesheet , relative to
2010-02-26 16:07:41 -05:00
* the theme root . It also accepts an array of stylesheets .
* It is optional and defaults to 'editor-style.css' .
2010-02-26 15:12:06 -05:00
*
2012-02-29 19:18:26 -05:00
* This function automatically adds another stylesheet with - rtl prefix , e . g . editor - style - rtl . css .
* If that file doesn ' t exist , it is removed before adding the stylesheet ( s ) to TinyMCE .
* If an array of stylesheets is passed to add_editor_style (),
2010-12-04 05:09:00 -05:00
* RTL is only added for the first stylesheet .
*
2012-02-29 19:18:26 -05:00
* Since version 3.4 the TinyMCE body has . rtl CSS class .
* It is a better option to use that class and add any RTL styles to the main stylesheet .
*
2010-02-26 15:12:06 -05:00
* @ since 3.0 . 0
*
2010-02-26 16:07:41 -05:00
* @ param mixed $stylesheet Optional . Stylesheet name or array thereof , relative to theme root .
* Defaults to 'editor-style.css'
2010-02-26 15:12:06 -05:00
*/
function add_editor_style ( $stylesheet = 'editor-style.css' ) {
add_theme_support ( 'editor-style' );
if ( ! is_admin () )
return ;
2010-02-27 02:36:35 -05:00
global $editor_styles ;
$editor_styles = ( array ) $editor_styles ;
$stylesheet = ( array ) $stylesheet ;
2010-05-03 01:49:19 -04:00
if ( is_rtl () ) {
2010-04-26 10:56:57 -04:00
$rtl_stylesheet = str_replace ( '.css' , '-rtl.css' , $stylesheet [ 0 ]);
$stylesheet [] = $rtl_stylesheet ;
}
2010-02-27 02:36:35 -05:00
$editor_styles = array_merge ( $editor_styles , $stylesheet );
2010-02-26 15:12:06 -05:00
}
2010-12-04 05:09:00 -05:00
/**
* Removes all visual editor stylesheets .
*
* @ since 3.1 . 0
*
* @ return bool True on success , false if there were no stylesheets to remove .
*/
function remove_editor_styles () {
if ( ! current_theme_supports ( 'editor-style' ) )
return false ;
_remove_theme_support ( 'editor-style' );
if ( is_admin () )
$GLOBALS [ 'editor_styles' ] = array ();
return true ;
}
2009-11-01 01:27:39 -04:00
/**
* Allows a theme to register its support of a certain feature
2010-01-15 17:11:12 -05:00
*
2010-03-31 05:06:11 -04:00
* Must be called in the theme ' s functions . php file to work .
* If attached to a hook , it must be after_setup_theme .
* The init hook may be too late for some features .
2009-11-01 01:27:39 -04:00
*
2010-03-26 15:23:39 -04:00
* @ since 2.9 . 0
2009-11-01 01:27:39 -04:00
* @ param string $feature the feature being added
*/
function add_theme_support ( $feature ) {
global $_wp_theme_features ;
2009-12-09 10:39:20 -05:00
if ( func_num_args () == 1 )
$_wp_theme_features [ $feature ] = true ;
else
$_wp_theme_features [ $feature ] = array_slice ( func_get_args (), 1 );
2011-01-05 23:11:14 -05:00
2011-01-03 18:56:42 -05:00
if ( $feature == 'post-formats' && is_array ( $_wp_theme_features [ $feature ][ 0 ] ) )
$_wp_theme_features [ $feature ][ 0 ] = array_intersect ( $_wp_theme_features [ $feature ][ 0 ], array_keys ( get_post_format_slugs () ) );
2009-11-01 01:27:39 -04:00
}
2010-11-04 03:41:07 -04:00
/**
* Gets the theme support arguments passed when registering that support
*
* @ since 3.1
* @ param string $feature the feature to check
* @ return array The array of extra arguments
*/
function get_theme_support ( $feature ) {
global $_wp_theme_features ;
if ( ! isset ( $_wp_theme_features [ $feature ] ) )
return false ;
else
return $_wp_theme_features [ $feature ];
}
2010-03-29 12:26:54 -04:00
/**
* Allows a theme to de - register its support of a certain feature
*
2010-03-31 05:06:11 -04:00
* Should be called in the theme ' s functions . php file . Generally would
* be used for child themes to override support from the parent theme .
2010-03-29 12:26:54 -04:00
*
* @ since 3.0 . 0
2010-03-31 05:06:11 -04:00
* @ see add_theme_support ()
2010-03-29 12:26:54 -04:00
* @ param string $feature the feature being added
2010-03-31 05:06:11 -04:00
* @ return bool Whether feature was removed .
2010-03-29 12:26:54 -04:00
*/
function remove_theme_support ( $feature ) {
2010-03-31 05:06:11 -04:00
// Blacklist: for internal registrations not used directly by themes.
2010-06-18 01:37:45 -04:00
if ( in_array ( $feature , array ( 'custom-background' , 'custom-header' , 'editor-style' , 'widgets' , 'menus' ) ) )
2010-03-31 05:06:11 -04:00
return false ;
2010-12-01 19:16:35 -05:00
return _remove_theme_support ( $feature );
}
2010-03-31 05:06:11 -04:00
2010-12-01 19:16:35 -05:00
/**
2010-12-04 04:59:35 -05:00
* Do not use . Removes theme support internally , ignorant of the blacklist .
2010-12-01 19:16:35 -05:00
*
* @ access private
* @ since 3.1 . 0
*/
function _remove_theme_support ( $feature ) {
2010-03-29 12:26:54 -04:00
global $_wp_theme_features ;
2010-03-31 05:06:11 -04:00
if ( ! isset ( $_wp_theme_features [ $feature ] ) )
return false ;
unset ( $_wp_theme_features [ $feature ] );
return true ;
2010-03-29 12:26:54 -04:00
}
2009-11-01 01:27:39 -04:00
/**
* Checks a theme ' s support for a given feature
*
2010-03-26 15:23:39 -04:00
* @ since 2.9 . 0
2009-11-01 01:27:39 -04:00
* @ param string $feature the feature being checked
* @ return boolean
*/
function current_theme_supports ( $feature ) {
global $_wp_theme_features ;
2009-12-09 10:39:20 -05:00
if ( ! isset ( $_wp_theme_features [ $feature ] ) )
return false ;
// If no args passed then no extra checks need be performed
if ( func_num_args () <= 1 )
return true ;
$args = array_slice ( func_get_args (), 1 );
switch ( $feature ) {
2009-12-10 01:14:36 -05:00
case 'post-thumbnails' :
2009-12-09 10:39:20 -05:00
// post-thumbnails can be registered for only certain content/post types by passing
2011-12-13 18:45:31 -05:00
// an array of types to add_theme_support(). If no array was passed, then
2009-12-09 10:39:20 -05:00
// any type is accepted
if ( true === $_wp_theme_features [ $feature ] ) // Registered for all types
return true ;
$content_type = $args [ 0 ];
2011-09-19 12:29:03 -04:00
return in_array ( $content_type , $_wp_theme_features [ $feature ][ 0 ] );
break ;
case 'post-formats' :
// specific post formats can be registered by passing an array of types to
// add_theme_support()
$post_format = $args [ 0 ];
return in_array ( $post_format , $_wp_theme_features [ $feature ][ 0 ] );
2009-12-09 10:39:20 -05:00
break ;
2012-02-02 18:35:37 -05:00
case 'custom-header' :
// specific custom header capabilities can be registered by passing
// an array to add_theme_support()
$header_support = $args [ 0 ];
return ( isset ( $_wp_theme_features [ $feature ][ 0 ][ $header_support ] ) && $_wp_theme_features [ $feature ][ 0 ][ $header_support ] );
break ;
2009-12-09 10:39:20 -05:00
}
2012-01-05 13:29:40 -05:00
return apply_filters ( 'current_theme_supports-' . $feature , true , $args , $_wp_theme_features [ $feature ]);
2009-11-01 01:27:39 -04:00
}
2009-11-01 05:10:06 -05:00
/**
* Checks a theme ' s support for a given feature before loading the functions which implement it .
*
2010-03-26 15:23:39 -04:00
* @ since 2.9 . 0
2009-11-01 05:10:06 -05:00
* @ param string $feature the feature being checked
* @ param string $include the file containing the functions that implement the feature
*/
function require_if_theme_supports ( $feature , $include ) {
if ( current_theme_supports ( $feature ) )
require ( $include );
}
2010-05-24 15:42:43 -04:00
/**
2010-05-24 17:26:49 -04:00
* Checks an attachment being deleted to see if it ' s a header or background image .
2010-05-25 22:42:15 -04:00
*
2010-05-24 17:26:49 -04:00
* If true it removes the theme modification which would be pointing at the deleted
* attachment
2010-05-24 15:42:43 -04:00
*
2010-05-24 17:26:49 -04:00
* @ access private
2010-05-24 15:42:43 -04:00
* @ since 3.0 . 0
* @ param int $id the attachment id
*/
function _delete_attachment_theme_mod ( $id ) {
$attachment_image = wp_get_attachment_url ( $id );
$header_image = get_header_image ();
$background_image = get_background_image ();
2010-05-25 22:42:15 -04:00
2010-05-24 15:42:43 -04:00
if ( $header_image && $header_image == $attachment_image )
remove_theme_mod ( 'header_image' );
if ( $background_image && $background_image == $attachment_image )
remove_theme_mod ( 'background_image' );
}
add_action ( 'delete_attachment' , '_delete_attachment_theme_mod' );
2011-09-08 16:07:15 -04:00
/**
2011-09-08 16:59:41 -04:00
* Checks if a theme has been changed and runs 'after_switch_theme' hook on the next WP load
2011-09-08 16:07:15 -04:00
*
2012-01-04 14:03:33 -05:00
* @ since 3.3 . 0
2011-09-08 16:59:41 -04:00
*/
2011-09-08 16:07:15 -04:00
function check_theme_switched () {
2012-03-08 16:22:24 -05:00
if ( $stylesheet = get_option ( 'theme_switched' ) ) {
$old_theme = wp_get_theme ( $stylesheet );
do_action ( 'after_switch_theme' , $old_theme -> get ( 'Name' ), $old_theme );
2011-09-08 16:07:15 -04:00
update_option ( 'theme_switched' , false );
}
}
2012-02-24 23:12:43 -05:00
function wp_customize_load () {
// Load on themes.php or ?customize=on
if ( ! ( isset ( $_REQUEST [ 'customize' ] ) && 'on' == $_REQUEST [ 'customize' ] ) && 'themes.php' != $GLOBALS [ 'pagenow' ] )
return ;
require ( ABSPATH . WPINC . '/class-wp-customize.php' );
// Init Customize class
// @todo Dependency injection instead
$GLOBALS [ 'customize' ] = new WP_Customize ;
}
add_action ( 'plugins_loaded' , 'wp_customize_load' );