current_theme_supports()
最后更新于:2021-11-25 22:37:29
current_theme_supports( string$feature, mixed$args)Checks a theme’s support for a given feature.
参数
- $feature
-
(string) (Required) The feature being checked. See add_theme_support() for the list of possible values.
- $args
-
(mixed) (Optional) extra arguments to be checked against certain features.
响应
(bool) True if the current theme supports the feature, false otherwise.
源文件
文件: gc-includes/theme.php
function current_theme_supports( $feature, ...$args ) {
global $_gc_theme_features;
if ( 'custom-header-uploads' === $feature ) {
return current_theme_supports( 'custom-header', 'uploads' );
}
if ( ! isset( $_gc_theme_features[ $feature ] ) ) {
return false;
}
// If no args passed then no extra checks need be performed.
if ( ! $args ) {
return true;
}
switch ( $feature ) {
case 'post-thumbnails':
/*
* post-thumbnails can be registered for only certain content/post types
* by passing an array of types to add_theme_support().
* If no array was passed, then any type is accepted.
*/
if ( true === $_gc_theme_features[ $feature ] ) { // Registered for all types.
return true;
}
$content_type = $args[0];
return in_array( $content_type, $_gc_theme_features[ $feature ][0], true );
case 'html5':
case 'post-formats':
/*
* Specific post formats can be registered by passing an array of types
* to add_theme_support().
*
* Specific areas of HTML5 support *must* be passed via an array to add_theme_support().
*/
$type = $args[0];
return in_array( $type, $_gc_theme_features[ $feature ][0], true );
case 'custom-logo':
case 'custom-header':
case 'custom-background':
// Specific capabilities can be registered by passing an array to add_theme_support().
return ( isset( $_gc_theme_features[ $feature ][0][ $args[0] ] ) && $_gc_theme_features[ $feature ][0][ $args[0] ] );
}
/**
* Filters whether the current theme supports a specific feature.
*
* The dynamic portion of the hook name, `$feature`, refers to the specific
* theme feature. See add_theme_support() for the list of possible values.
*
* @since 3.4.0
*
* @param bool $supports Whether the current theme supports the given feature. Default true.
* @param array $args Array of arguments for the feature.
* @param string $feature The theme feature.
*/
return apply_filters( "current_theme_supports-{$feature}", true, $args, $_gc_theme_features[ $feature ] ); // phpcs:ignore GeChiUI.NamingConventions.ValidHookName.UseUnderscores
}