Changeset 48185 for trunk/src/wp-includes/class-wp-oembed.php

Timestamp:

06/26/2020 06:47:28 PM (6 years ago)

Author:

SergeyBiryukov

Message:

Docs: Standardize on "Returning a value from the filter" vs. "Passing a value to the filter".

The filter is the callback function added with add_filter(), therefore the hook passes a value to the filter, and the filter returns a value to change its behaviour.

The documentation is referring to the latter.

Props johnbillion.
See #49572, #16557.

File:

• trunk/src/wp-includes/class-wp-oembed.php (modified) (1 diff)

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

@@ -382 +382 @@
          * replacing it with a routine that is more optimal for your setup.
          *
-         * Passing a non-null value to the filter will effectively short-circuit retrieval,
-         * returning the passed value instead.
+         * Returning a non-null value from the filter will effectively short-circuit retrieval
+         * and return the passed value instead.
          *
          * @since 4.5.3