云策 WordPress 开发者社区

函数文档

get_stylesheet()

查看官方原文 ↗
💡 云策文档标注

概述

get_stylesheet() 函数用于获取当前前端主题的名称，通常与模板名称相同。它返回一个字符串，表示当前样式表的名称。

关键要点

  • 函数返回当前激活主题的样式表名称，通常与模板名称一致。
  • 内部通过 get_option('stylesheet') 获取值，并应用 'stylesheet' 过滤器进行修改。
  • 在 WordPress 1.5.0 版本中引入，常用于主题和模板相关操作。

代码示例

function get_stylesheet() {
	return apply_filters( 'stylesheet', get_option( 'stylesheet' ) );
}

注意事项

  • 此函数主要用于前端主题，不适用于管理界面主题。
  • 返回值是字符串，可直接用于路径或标识符构建。
📄 原文内容

Retrieves name of the current stylesheet.

Description

The theme name that is currently set as the front end theme.

For all intents and purposes, the template name and the stylesheet name are going to be the same for most cases.

Return

string Stylesheet name.

Source

function get_stylesheet() {
	/**
	 * Filters the name of current stylesheet.
	 *
	 * @since 1.5.0
	 *
	 * @param string $stylesheet Name of the current stylesheet.
	 */
	return apply_filters( 'stylesheet', get_option( 'stylesheet' ) );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘stylesheet’, string $stylesheet )

Filters the name of current stylesheet.

Uses Description
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.
get_option()wp-includes/option.php

Retrieves an option value based on an option name.
Used by Description
WP_Block_Templates_Registry::register()wp-includes/class-wp-block-templates-registry.php

Registers a template.
_build_block_template_object_from_post_object()wp-includes/block-template-utils.php

Builds a block template object from a post object.
_inject_theme_attribute_in_template_part_block()wp-includes/block-template-utils.php

Injects the active theme’s stylesheet as a theme attribute into a given template part block.
get_block_asset_url()wp-includes/blocks.php

Gets the URL to a block asset.
wp_theme_has_theme_json()wp-includes/global-styles-and-settings.php

Checks whether a theme or its parent has a theme.json file.
WP_REST_Global_Styles_Controller::get_theme_items()wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php

Returns the given theme global styles variations.
WP_Theme_JSON_Resolver::get_user_data_from_wp_global_styles()wp-includes/class-wp-theme-json-resolver.php

Returns the custom post type that contains the user’s origin config for the active theme or an empty array if none are found.
WP_REST_Global_Styles_Controller::get_theme_item()wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php

Returns the given theme global styles config.
WP_REST_Edit_Site_Export_Controller::export()wp-includes/rest-api/endpoints/class-wp-rest-edit-site-export-controller.php

Output a ZIP file with an export of the current templates and template parts from the site editor, and close the connection.
wp_set_unique_slug_on_create_template_part()wp-includes/theme-templates.php

Sets a custom slug when creating auto-draft template parts.
wp_generate_block_templates_export_file()wp-includes/block-template-utils.php

Creates an export of the current templates and template parts from the site editor at the specified path in a ZIP file.
get_block_file_template()wp-includes/block-template-utils.php

Retrieves a unified template object based on a theme file or plugin registration.
block_template_part()wp-includes/block-template-utils.php

Prints a block template part.
_build_block_template_result_from_file()wp-includes/block-template-utils.php

Builds a unified template object based on a theme file.
_inject_theme_attribute_in_block_template_content()wp-includes/deprecated.php

Parses wp_template content and injects the active theme’s stylesheet as a theme attribute into each wp_template_part
_get_block_template_file()wp-includes/block-template-utils.php

Retrieves the template file from the theme for a given slug.
_get_block_templates_files()wp-includes/block-template-utils.php

Retrieves the template files from the theme.
WP_REST_Templates_Controller::prepare_item_for_database()wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php

Prepares a single template for create or update.
wp_filter_wp_template_unique_post_slug()wp-includes/theme-templates.php

Generates a unique slug for templates.
get_the_block_template_html()wp-includes/block-template.php

Returns the markup for the current template.
get_block_templates()wp-includes/block-template-utils.php

Retrieves a list of unified template objects based on a query.
is_theme_paused()wp-admin/includes/theme.php

Determines whether a theme is technically active but was paused while loading.
wp_edit_theme_plugin_file()wp-admin/includes/file.php

Attempts to edit a file for a theme or plugin.
wp_update_custom_css_post()wp-includes/theme.php

Updates the custom_css post for a given theme.
wp_get_custom_css_post()wp-includes/theme.php

Fetches the custom_css post for a given theme.
wp_get_custom_css()wp-includes/theme.php

Fetches the saved Custom CSS content for rendering.
Custom_Background::ajax_background_add()wp-admin/includes/class-custom-background.php

Handles Ajax request for adding custom background context to an attachment.
Theme_Upgrader::current_before()wp-admin/includes/class-theme-upgrader.php

Turns on maintenance mode before attempting to upgrade the active theme.
Theme_Upgrader::current_after()wp-admin/includes/class-theme-upgrader.php

Turns off maintenance mode after upgrading the active theme.
Theme_Upgrader::bulk_upgrade()wp-admin/includes/class-theme-upgrader.php

Upgrades several themes at once.
wp_prepare_themes_for_js()wp-admin/includes/theme.php

Prepares themes for JavaScript.
Theme_Upgrader_Skin::after()wp-admin/includes/class-theme-upgrader-skin.php

Performs an action following a single theme update.
Custom_Image_Header::ajax_header_add()wp-admin/includes/class-custom-image-header.php

Given an attachment ID for a header image, updates its “last used” timestamp to now.
Custom_Image_Header::ajax_header_remove()wp-admin/includes/class-custom-image-header.php

Given an attachment ID for a header image, unsets it as a user-uploaded header image for the active theme.
Custom_Image_Header::customize_set_last_used()wp-admin/includes/class-custom-image-header.php

Updates the last-used postmeta on a header image attachment after saving a new header image via the Customizer.
Custom_Image_Header::get_uploaded_header_images()wp-admin/includes/class-custom-image-header.php

Gets the previously uploaded header images.
Custom_Image_Header::set_header_image()wp-admin/includes/class-custom-image-header.php

Chooses a header image, selected from existing uploaded and default headers, or provides an array of uploaded header data (either new, or from media library).
WP_Customize_Manager::register_controls()wp-includes/class-wp-customize-manager.php

Registers some default controls.
WP_Customize_Manager::__construct()wp-includes/class-wp-customize-manager.php

Constructor.
validate_current_theme()wp-includes/theme.php

Checks that the active theme has the required files.
get_stylesheet_directory()wp-includes/theme.php

Retrieves stylesheet directory path for the active theme.
get_stylesheet_directory_uri()wp-includes/theme.php

Retrieves stylesheet directory URI for the active theme.
wp_get_themes()wp-includes/theme.php

Returns an array of WP_Theme objects based on the arguments.
wp_get_theme()wp-includes/theme.php

Gets a WP_Theme object for a theme.
get_edit_post_link()wp-includes/link-template.php

Retrieves the edit post link for post.
get_body_class()wp-includes/post-template.php

Retrieves an array of the class names for the body element.

Show 41 moreShow less

Changelog

Version Description
1.5.0 Introduced.