sanitize_hex_color( string $color ): string|void

Sanitizes a hex color.

Contents

Description
Parameters
Return
Source
Related
- Used By
Changelog
User Contributed Notes

Description

Returns either ”, a 3 or 6 digit hex color (with #), or nothing.
For sanitizing values without a #, see sanitize_hex_color_no_hash() .

Parameters

$color string Required

Return

string|void

Source

File: wp-includes/formatting.php. View all references

function sanitize_hex_color( $color ) {
	if ( '' === $color ) {
		return '';
	}

	// 3 or 6 hex digits, or the empty string.
	if ( preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) {
		return $color;
	}
}

View on Trac View on GitHub

Used By

Used By
Used By	Description
rest_sanitize_value_from_schema() wp-includes/rest-api.php	Sanitize a value based on a schema.
sanitize_hex_color_no_hash() wp-includes/formatting.php	Sanitizes a hex color without a hash. Use sanitize_hex_color() when possible.

Changelog

Changelog
Version	Description
3.4.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Contributed by Rinku Y — 8 years ago
It is usually most important to set the default value of the setting as well as its sanitization callback, which will ensure that no unsafe data is stored in the database.
```
$wp_customize-&gt;add_setting( 'accent_color', array(
  'default' =&gt; '#f72525',
  'sanitize_callback' =&gt; 'sanitize_hex_color',
) );
```
Log in to add feedback
Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Andreas Brain — 6 years ago

As of WordPress 4.6 this function is globally available, see https://core.trac.wordpress.org/ticket/27583

Log in to add feedback

You must log in before being able to contribute a note or feedback.