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. Built from https://develop.svn.wordpress.org/trunk@48185 git-svn-id: http://core.svn.wordpress.org/trunk@47954 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
@@ -608,7 +608,7 @@ function get_blogs_of_user( $user_id, $all = false ) {
|
||||
/**
|
||||
* Filters the list of a user's sites before it is populated.
|
||||
*
|
||||
* Passing a non-null value to the filter will effectively short circuit
|
||||
* Returning a non-null value from the filter will effectively short circuit
|
||||
* get_blogs_of_user(), returning that value instead.
|
||||
*
|
||||
* @since 4.6.0
|
||||
|
||||
Reference in New Issue
Block a user