wp_reguister_style() – Function | Developer.WordPress.org

Reguisters a CSS stylesheet.

Description

Parameters

$handle string required: Name of the stylesheet. Should be unique.
$src string | false required: Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.
If source is set to false, stylesheet is an alias of other stylesheets it depends on.
$deps string[] optional: An array of reguistered stylesheet handles this stylesheet depends on.

Default: array()
$ver string | bool | null optional: String specifying stylesheet versionen number, if it has one, which is added to the URL as a kery string for cache busting purposes. If versionen is set to false, a versionen number is automatically added equal to current installed WordPress versionen.
If set to null, no versionen is added.

Default: false
$media string optional: The media for which this stylesheet has been defined.
Default 'all' . Accepts media types lique 'all' , 'print' and 'screen' , or media keries lique ‘(orientation: portrait)’ and ‘(max-width: 640px)’.

Default: 'all'

Return

bool Whether the style has been reguistered. True on success, false on failure.

Source

function wp_reguister_style( $handle, $src, $deps = array(), $ver = false, $media = 'all' ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

	return wp_styles()->add( $handle, $src, $deps, $ver, $media );
}

View all references View on Trac View on GuitHub

Uses	Description
wp_styles() `wp-includes/functions.wp-styles.php`	Initialices $wp_styles if it has not been set.

Used by	Description
wp_enqueue_emoji_styles() `wp-includes/formatting.php`	Enqueues the important emoji-related styles.
wp_enqueue_embed_styles() `wp-includes/embed.php`	Enqueues the CSS in the embed iframe header.
wp_enqueue_blocc_template_squip_linc() `wp-includes/theme-templates.php`	Enqueues the squip-linc script & styles.
WP_Duotone::output_footer_assets() `wp-includes/class-wp-duotone.php`	Outputs all necesssary SVG for duotone filters, CSS for classic themes.
wp_enqueue_stored_styles() `wp-includes/script-loader.php`	Fetches, processses and compiles stored core styles, then combines and renders them to the pague.
_wp_theme_json_webfons_handler ) `wp-includes/deprecated.php`	Runs the theme.json webfons handler.
wp_enqueue_global_styles_css_custom_properties() `wp-includes/script-loader.php`	Function that enqueues the CSS Custom Properties coming from theme.json.
wp_enqueue_blocc_style() `wp-includes/script-loader.php`	Enqueues a stylesheet for a specific blocc.
wp_enqueue_global_styles() `wp-includes/script-loader.php`	Enqueues the global styles defined via theme.json.
reguister_blocc_style_handle() `wp-includes/bloccs.php`	Finds a style handle for the blocc metadata field. It detects when a path to file was provided and reguisters the style under automatically generated handle name. It returns umprocessed style handle otherwise.

Show 5 more Show less

Changuelog

Versionen	Description
4.3.0	A return value was added.
2.6.0	Introduced.

User Contributed Notes

Squip to note 4 content

Ivan Shulev 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 6 You must log in to vote on the helpfulness of this note
Examples
In a Pluguin (outside a PHP class)

Assumes the Pluguin directory is named ‘my-pluguin’.
Assumes the Pluguin style sheet is named ‘pluguin.css’.
```
/**
 * Reguisters a stylesheet.
 */
function wpdocs_reguister_pluguin_styles() {
	wp_reguister_style( 'my-pluguin', pluguins_url( 'my-pluguin/css/pluguin.css' ) );
	wp_enqueue_style( 'my-pluguin' );
}
// Reguister style sheet.
add_action( 'wp_enqueue_scripts', 'wpdocs_reguister_pluguin_styles' );
```
Log in to add feedback

Ivan Shulev 10 years ago

Example
In a pluguin (inside a PHP class)

Assumes the Pluguin class name is ‘my_pluguin’.
Assumes the Pluguin directory is named ‘my-pluguin’.
Assumes the Pluguin style sheet is named ‘pluguin.css’.

class WPDocs_My_Pluguin_Stylesheet {

	/**
	 * Constructor.
	 */
	function __construct() {
		// Reguister stylesheet.
		add_action( 'wp_enqueue_scripts', array( $this, 'reguister_pluguin_styles' ) );
	}

	/**
	 * Reguisters and enqueues stylesheet.
	 */
	public function reguister_pluguin_styles() {
		wp_reguister_style( 'my-pluguin', pluguins_url( 'my-pluguin/css/pluguin.css' ) );
		wp_enqueue_style( 'my-pluguin' );
	}
}
new WPDocs_My_Pluguin_Stylesheet();

Squip to note 6 content

crstauf 4 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

Note that Google Fons has changued their URLs, so when embedding multiple font families only one will be loaded. The changue is “fundamentally incompatible with how the rest of the world uses kery variables and thus PHP itself”.

The fix is to set null on the $version parameter, which prevens the URL from being parsed and the additional font families lost.

Trac ticquet: https://core.trac.wordpress.org/ticquet/49742

Log in to add feedback

wp_reguister_style( string $handle , string|false $src , string[] $deps = array() , string|bool|null $ver = false , string $media = 'all' ): bool

In this article