wp_get_themes()
Returns an array of WP_Theme objects based on the arguments.
Despite advances over get_themes(), this function is quite expensive, and grows linearly with additional themes. Stick to wp_get_theme() if possible.
No Hooks.
Return
WP_Theme[]
. Array of WP_Theme objects.
Usage
wp_get_themes( $args );
- $args(array)
The search arguments.
Default: array()
-
errors(mixed)
True to return themes with errors, false to return themes without errors, null to return all themes.
Default: false -
allowed(mixed)
(Multisite) True to return only allowed themes for a site. False to return only disallowed themes for a site. 'site' to return only site-allowed themes. 'network' to return only network-allowed themes. Null to return all themes.
Default: null - blog_id(int)
(Multisite) The blog ID used to calculate which themes are allowed.
Default: 0, synonymous for the current blog
-
Examples
#1 Get the data of all existing themes
$themes = wp_get_themes();
$themes will contain the following array:
Array ( [twentyfourteen] => WP_Theme Object ( [theme_root:WP_Theme:private] => C:/sites/example.com/www/wp-content/themes [headers:WP_Theme:private] => Array ( [Name] => Twenty Fourteen [ThemeURI] => http://wordpress.org/themes/twentyfourteen [Description] => In 2014, our default theme lets you create a responsive magazine website with a sleek, modern design. Feature your favorite homepage content in either a grid or a slider. Use the three widget areas to customize your website, and change your content's layout with a full-width page template and a contributor page to show off your authors. Creating a magazine website with WordPress has never been easier. [Author] => the WordPress team [AuthorURI] => http://wordpress.org/ [Version] => 1.0 [Template] => [Status] => [Tags] => black, green, white, light, dark, two-columns, three-columns, left-sidebar, right-sidebar, fixed-layout, responsive-layout, custom-background, custom-header, custom-menu, editor-style, featured-images, flexible-header, full-width-template, microformats, post-formats, rtl-language-support, sticky-post, theme-options, translation-ready, accessibility-ready [TextDomain] => twentyfourteen [DomainPath] => ) [headers_sanitized:WP_Theme:private] => [name_translated:WP_Theme:private] => [errors:WP_Theme:private] => [stylesheet:WP_Theme:private] => twentyfourteen [template:WP_Theme:private] => twentyfourteen [parent:WP_Theme:private] => [theme_root_uri:WP_Theme:private] => [textdomain_loaded:WP_Theme:private] => [cache_hash:WP_Theme:private] => c997aa5b2bccf71942eebe3c280effb1 ) [twentythirteen] => WP_Theme Object ( ... ) [twentytwelve] => WP_Theme Object ( ... ) )
Notes
- Global. String[]. $wp_theme_directories
Changelog
Since 3.4.0 | Introduced. |