is_protected_meta( string $meta_key, string $meta_type = '' ): bool
Determines whether a meta key is considered protected.
Parameters
-
$meta_key
string Required -
Metadata key.
-
$meta_type
string Optional -
Type of object metadata is for. Accepts
'post'
,'comment'
,'term'
,'user'
, or any other object type with an associated meta table.Default:
''
Return
bool Whether the meta key is considered protected.
Source
File: wp-includes/meta.php
.
View all references
function is_protected_meta( $meta_key, $meta_type = '' ) {
$sanitized_key = preg_replace( "/[^\x20-\x7E\p{L}]/", '', $meta_key );
$protected = strlen( $sanitized_key ) > 0 && ( '_' === $sanitized_key[0] );
/**
* Filters whether a meta key is considered protected.
*
* @since 3.2.0
*
* @param bool $protected Whether the key is considered protected.
* @param string $meta_key Metadata key.
* @param string $meta_type Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user',
* or any other object type with an associated meta table.
*/
return apply_filters( 'is_protected_meta', $protected, $meta_key, $meta_type );
}
Hooks
-
apply_filters( 'is_protected_meta',
bool $protected ,string $meta_key ,string $meta_type ) -
Filters whether a meta key is considered protected.
Changelog
Version | Description |
---|---|
3.1.3 | Introduced. |