Changeset 61118 for trunk/src/wp-includes/class-wp-hook.php

Timestamp:

11/03/2025 11:45:40 PM (5 months ago)

Author:

westonruter

Message:

Plugins: Add missing $priority parameter to has_filter() and has_action().

This brings has_filter()/has_action() in parity with add_filter()/add_action() and remove_filter()/remove_action(), all of which support a $priority parameter.

Props westonruter, swissspidy.
Fixes #64186.
See #64178.

File:

• trunk/src/wp-includes/class-wp-hook.php (modified) (3 diffs)

trunk/src/wp-includes/class-wp-hook.php

@@ -224 +224 @@
      *
      * @since 4.7.0
+     * @since 6.9.0 Added the `$priority` parameter.
      *
      * @param string                      $hook_name Optional. The name of the filter hook. Default empty.
@@ -229 +230 @@
      *                                               This method can be called unconditionally to speculatively check
      *                                               a callback that may or may not exist. Default false.
+     * @param int|false                   $priority  Optional. The specific priority at which to check for the callback.
+     *                                               Default false.
      * @return bool|int If `$callback` is omitted, returns boolean for whether the hook has
      *                  anything registered. When checking a specific function, the priority
      *                  of that hook is returned, or false if the function is not attached.
-     */
-    public function has_filter( $hook_name = '', $callback = false ) {
+     *                  If `$callback` and `$priority` are both provided, a boolean is returned
+     *                  for whether the specific function is registered at that priority.
+     */
+    public function has_filter( $hook_name = '', $callback = false, $priority = false ) {
         if ( false === $callback ) {
             return $this->has_filters();
@@ -244 +249 @@
         }
 
-        foreach ( $this->callbacks as $priority => $callbacks ) {
+        if ( is_int( $priority ) ) {
+            return isset( $this->callbacks[ $priority ][ $function_key ] );
+        }
+
+        foreach ( $this->callbacks as $callback_priority => $callbacks ) {
             if ( isset( $callbacks[ $function_key ] ) ) {
-                return $priority;
+                return $callback_priority;
             }
         }