_wp_filter_build_unique_id
- %1$s is private and should not be used in themes or plugins directly.
_wp_filter_build_unique_id ( $tag, $function, $priority )
Access:Parameters:- (string) $tag Used in counting how many hooks were applied
- (callable) $function Used for creating unique id
- (int|bool) $priority Used in counting how many hooks were applied. If === false and $function is an object reference, we return the unique id only if it already has one, false otherwise.
Links:Returns:- (string|false) Unique ID for usage as array key or false if $priority === false and $function is an object reference, and it does not already have a unique id.
Defined at: - Introduced in WordPress: 2.2.3
- Deprecated in WordPress: —
Description
Build Unique ID for storage and retrieval.
The old way to serialize the callback caused issues and this function is the
solution. It works by checking for objects and creating a new property in
the class to keep track of the object and new objects of the same class that
need to be added.
It also allows for the removal of actions and filters for objects after they
change class properties. It is possible to include the property $wp_filter_id
in your class and set it to "null" or a number to bypass the workaround.
However this will prevent you from adding new classes and any new classes
will overwrite the previous hook by the same class.
Functions and static method callbacks are just returned as strings and
shouldn't have any speed penalty.