Make WordPress Core

Ticket #52243: 52243.diff

File 52243.diff, 37.6 KB (added by johnbillion, 4 years ago)
  • src/wp-admin/includes/class-wp-screen.php

     
    794794                 *                   {@see get_current_screen()->remove_help_tab()} instead.
    795795                 *
    796796                 * @param array     $old_compat_help Old contextual help.
    797                  * @param WP_Screen $this            Current WP_Screen instance.
     797                 * @param WP_Screen $screen          Current WP_Screen instance.
    798798                 */
    799799                self::$_old_compat_help = apply_filters_deprecated(
    800800                        'contextual_help_list',
     
    814814                 *
    815815                 * @param string    $old_help  Help text that appears on the screen.
    816816                 * @param string    $screen_id Screen ID.
    817                  * @param WP_Screen $this      Current WP_Screen instance.
     817                 * @param WP_Screen $screen    Current WP_Screen instance.
    818818                 */
    819819                $old_help = apply_filters_deprecated(
    820820                        'contextual_help',
     
    935935                 *
    936936                 * @param array     $empty_columns Empty array.
    937937                 * @param string    $screen_id     Screen ID.
    938                  * @param WP_Screen $this          Current WP_Screen instance.
     938                 * @param WP_Screen $screen        Current WP_Screen instance.
    939939                 */
    940940                $columns = apply_filters( 'screen_layout_columns', array(), $this->id, $this );
    941941
     
    10871087                 *
    10881088                 * @param bool      $show_button Whether to show Screen Options submit button.
    10891089                 *                               Default false.
    1090                  * @param WP_Screen $this        Current WP_Screen instance.
     1090                 * @param WP_Screen $screen      Current WP_Screen instance.
    10911091                 */
    10921092                $show_button = apply_filters( 'screen_options_show_submit', false, $this );
    10931093
  • src/wp-admin/includes/class-wp-upgrader.php

     
    262262                 * @param bool        $reply      Whether to bail without returning the package.
    263263                 *                                Default false.
    264264                 * @param string      $package    The package file name.
    265                  * @param WP_Upgrader $this       The WP_Upgrader instance.
     265                 * @param WP_Upgrader $upgrader   The WP_Upgrader instance.
    266266                 * @param array       $hook_extra Extra arguments passed to hooked filters.
    267267                 */
    268268                $reply = apply_filters( 'upgrader_pre_download', false, $package, $this, $hook_extra );
     
    521521                 *
    522522                 * @param string      $source        File source location.
    523523                 * @param string      $remote_source Remote file source location.
    524                  * @param WP_Upgrader $this          WP_Upgrader instance.
     524                 * @param WP_Upgrader $upgrader      WP_Upgrader instance.
    525525                 * @param array       $hook_extra    Extra arguments passed to hooked filters.
    526526                 */
    527527                $source = apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] );
  • src/wp-includes/class-wp-comment-query.php

     
    410410                 * @param array|int|null   $comment_data Return an array of comment data to short-circuit WP's comment query,
    411411                 *                                       the comment count as an integer if `$this->query_vars['count']` is set,
    412412                 *                                       or null to allow WP to run its normal queries.
    413                  * @param WP_Comment_Query $this         The WP_Comment_Query instance, passed by reference.
     413                 * @param WP_Comment_Query $query        The WP_Comment_Query instance, passed by reference.
    414414                 */
    415415                $comment_data = apply_filters_ref_array( 'comments_pre_query', array( $comment_data, &$this ) );
    416416
     
    494494                 * @since 3.1.0
    495495                 *
    496496                 * @param WP_Comment[]     $_comments An array of comments.
    497                  * @param WP_Comment_Query $this      Current instance of WP_Comment_Query (passed by reference).
     497                 * @param WP_Comment_Query $query     Current instance of WP_Comment_Query (passed by reference).
    498498                 */
    499499                $_comments = apply_filters_ref_array( 'the_comments', array( $_comments, &$this ) );
    500500
     
    904904                 * @since 3.1.0
    905905                 *
    906906                 * @param string[]         $pieces An associative array of comment query clauses.
    907                  * @param WP_Comment_Query $this   Current instance of WP_Comment_Query (passed by reference).
     907                 * @param WP_Comment_Query $query  Current instance of WP_Comment_Query (passed by reference).
    908908                 */
    909909                $clauses = apply_filters_ref_array( 'comments_clauses', array( compact( $pieces ), &$this ) );
    910910
  • src/wp-includes/class-wp-customize-setting.php

     
    606606                 *
    607607                 * @param WP_Error             $validity Filtered from `true` to `WP_Error` when invalid.
    608608                 * @param mixed                $value    Value of the setting.
    609                  * @param WP_Customize_Setting $this     WP_Customize_Setting instance.
     609                 * @param WP_Customize_Setting $setting  WP_Customize_Setting instance.
    610610                 */
    611611                $validity = apply_filters( "customize_validate_{$this->id}", $validity, $value, $this );
    612612
     
    762762                         * @since 4.6.0 Added the `$this` setting instance as the second parameter.
    763763                         *
    764764                         * @param mixed                $default The setting default value. Default empty.
    765                          * @param WP_Customize_Setting $this    The setting instance.
     765                         * @param WP_Customize_Setting $setting The setting instance.
    766766                         */
    767767                        $value = apply_filters( "customize_value_{$id_base}", $value, $this );
    768768                } elseif ( $this->is_multidimensional_aggregated ) {
     
    795795                 *
    796796                 * @since 3.4.0
    797797                 *
    798                  * @param mixed                $value The setting value.
    799                  * @param WP_Customize_Setting $this WP_Customize_Setting instance.
     798                 * @param mixed                $value   The setting value.
     799                 * @param WP_Customize_Setting $setting WP_Customize_Setting instance.
    800800                 */
    801801                $value = apply_filters( "customize_sanitize_js_{$this->id}", $this->value(), $this );
    802802
  • src/wp-includes/class-wp-network-query.php

     
    227227                 * @param array|int|null   $network_data Return an array of network data to short-circuit WP's network query,
    228228                 *                                       the network count as an integer if `$this->query_vars['count']` is set,
    229229                 *                                       or null to allow WP to run its normal queries.
    230                  * @param WP_Network_Query $this         The WP_Network_Query instance, passed by reference.
     230                 * @param WP_Network_Query $query        The WP_Network_Query instance, passed by reference.
    231231                 */
    232232                $network_data = apply_filters_ref_array( 'networks_pre_query', array( $network_data, &$this ) );
    233233
     
    303303                 * @since 4.6.0
    304304                 *
    305305                 * @param WP_Network[]     $_networks An array of WP_Network objects.
    306                  * @param WP_Network_Query $this      Current instance of WP_Network_Query (passed by reference).
     306                 * @param WP_Network_Query $query     Current instance of WP_Network_Query (passed by reference).
    307307                 */
    308308                $_networks = apply_filters_ref_array( 'the_networks', array( $_networks, &$this ) );
    309309
     
    446446                 * @since 4.6.0
    447447                 *
    448448                 * @param string[]         $pieces An associative array of network query clauses.
    449                  * @param WP_Network_Query $this   Current instance of WP_Network_Query (passed by reference).
     449                 * @param WP_Network_Query $query  Current instance of WP_Network_Query (passed by reference).
    450450                 */
    451451                $clauses = apply_filters_ref_array( 'networks_clauses', array( compact( $pieces ), &$this ) );
    452452
  • src/wp-includes/class-wp-query.php

     
    10781078                 *
    10791079                 * @since 1.5.0
    10801080                 *
    1081                  * @param WP_Query $this The WP_Query instance (passed by reference).
     1081                 * @param WP_Query $query The WP_Query instance (passed by reference).
    10821082                 */
    10831083                do_action_ref_array( 'parse_query', array( &$this ) );
    10841084        }
     
    13191319                 *
    13201320                 * @since 3.7.0
    13211321                 *
    1322                  * @param WP_Query $this The WP_Query instance.
     1322                 * @param WP_Query $query The WP_Query instance.
    13231323                 */
    13241324                do_action( 'parse_tax_query', $this );
    13251325        }
     
    17181718                 *
    17191719                 * @since 5.5.0
    17201720                 *
    1721                  * @param WP_Query $this The WP_Query instance (passed by reference).
     1721                 * @param WP_Query $query The WP_Query instance (passed by reference).
    17221722                 */
    17231723                do_action_ref_array( 'set_404', array( $this ) );
    17241724        }
     
    17791779                 *
    17801780                 * @since 2.0.0
    17811781                 *
    1782                  * @param WP_Query $this The WP_Query instance (passed by reference).
     1782                 * @param WP_Query $query The WP_Query instance (passed by reference).
    17831783                 */
    17841784                do_action_ref_array( 'pre_get_posts', array( &$this ) );
    17851785
     
    21262126                         * @since 3.0.0
    21272127                         *
    21282128                         * @param string   $search Search SQL for WHERE clause.
    2129                          * @param WP_Query $this   The current WP_Query object.
     2129                         * @param WP_Query $query  The current WP_Query object.
    21302130                         */
    21312131                        $search = apply_filters_ref_array( 'posts_search', array( $search, &$this ) );
    21322132                }
     
    23812381                                 * @since 3.7.0
    23822382                                 *
    23832383                                 * @param string   $search_orderby The ORDER BY clause.
    2384                                  * @param WP_Query $this           The current WP_Query instance.
     2384                                 * @param WP_Query $query          The current WP_Query instance.
    23852385                                 */
    23862386                                $search_orderby = apply_filters( 'posts_search_orderby', $search_orderby, $this );
    23872387                        }
     
    25632563                         * @since 1.5.0
    25642564                         *
    25652565                         * @param string   $where The WHERE clause of the query.
    2566                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2566                         * @param WP_Query $query The WP_Query instance (passed by reference).
    25672567                         */
    25682568                        $where = apply_filters_ref_array( 'posts_where', array( $where, &$this ) );
    25692569
     
    25722572                         *
    25732573                         * @since 1.5.0
    25742574                         *
    2575                          * @param string   $join The JOIN clause of the query.
    2576                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2575                         * @param string   $join  The JOIN clause of the query.
     2576                         * @param WP_Query $query The WP_Query instance (passed by reference).
    25772577                         */
    25782578                        $join = apply_filters_ref_array( 'posts_join', array( $join, &$this ) );
    25792579                }
     
    26142614                                 * @since 2.2.0
    26152615                                 *
    26162616                                 * @param string   $cjoin The JOIN clause of the query.
    2617                                  * @param WP_Query $this The WP_Query instance (passed by reference).
     2617                                 * @param WP_Query $query The WP_Query instance (passed by reference).
    26182618                                 */
    26192619                                $cjoin = apply_filters_ref_array( 'comment_feed_join', array( $cjoin, &$this ) );
    26202620
     
    26242624                                 * @since 2.2.0
    26252625                                 *
    26262626                                 * @param string   $cwhere The WHERE clause of the query.
    2627                                  * @param WP_Query $this   The WP_Query instance (passed by reference).
     2627                                 * @param WP_Query $query  The WP_Query instance (passed by reference).
    26282628                                 */
    26292629                                $cwhere = apply_filters_ref_array( 'comment_feed_where', array( $cwhere, &$this ) );
    26302630
     
    26342634                                 * @since 2.2.0
    26352635                                 *
    26362636                                 * @param string   $cgroupby The GROUP BY clause of the query.
    2637                                  * @param WP_Query $this     The WP_Query instance (passed by reference).
     2637                                 * @param WP_Query $query    The WP_Query instance (passed by reference).
    26382638                                 */
    26392639                                $cgroupby = apply_filters_ref_array( 'comment_feed_groupby', array( $cgroupby, &$this ) );
    26402640
     
    26442644                                 * @since 2.8.0
    26452645                                 *
    26462646                                 * @param string   $corderby The ORDER BY clause of the query.
    2647                                  * @param WP_Query $this     The WP_Query instance (passed by reference).
     2647                                 * @param WP_Query $query    The WP_Query instance (passed by reference).
    26482648                                 */
    26492649                                $corderby = apply_filters_ref_array( 'comment_feed_orderby', array( 'comment_date_gmt DESC', &$this ) );
    26502650
     
    26542654                                 * @since 2.8.0
    26552655                                 *
    26562656                                 * @param string   $climits The JOIN clause of the query.
    2657                                  * @param WP_Query $this    The WP_Query instance (passed by reference).
     2657                                 * @param WP_Query $query   The WP_Query instance (passed by reference).
    26582658                                 */
    26592659                                $climits = apply_filters_ref_array( 'comment_feed_limits', array( 'LIMIT ' . get_option( 'posts_per_rss' ), &$this ) );
    26602660                        }
     
    26992699                         * @since 1.5.0
    27002700                         *
    27012701                         * @param string   $where The WHERE clause of the query.
    2702                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2702                         * @param WP_Query $query The WP_Query instance (passed by reference).
    27032703                         */
    27042704                        $where = apply_filters_ref_array( 'posts_where_paged', array( $where, &$this ) );
    27052705
     
    27092709                         * @since 2.0.0
    27102710                         *
    27112711                         * @param string   $groupby The GROUP BY clause of the query.
    2712                          * @param WP_Query $this    The WP_Query instance (passed by reference).
     2712                         * @param WP_Query $query   The WP_Query instance (passed by reference).
    27132713                         */
    27142714                        $groupby = apply_filters_ref_array( 'posts_groupby', array( $groupby, &$this ) );
    27152715
     
    27202720                         *
    27212721                         * @since 1.5.0
    27222722                         *
    2723                          * @param string   $join The JOIN clause of the query.
    2724                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2723                         * @param string   $join  The JOIN clause of the query.
     2724                         * @param WP_Query $query The WP_Query instance (passed by reference).
    27252725                         */
    27262726                        $join = apply_filters_ref_array( 'posts_join_paged', array( $join, &$this ) );
    27272727
     
    27312731                         * @since 1.5.1
    27322732                         *
    27332733                         * @param string   $orderby The ORDER BY clause of the query.
    2734                          * @param WP_Query $this    The WP_Query instance (passed by reference).
     2734                         * @param WP_Query $query   The WP_Query instance (passed by reference).
    27352735                         */
    27362736                        $orderby = apply_filters_ref_array( 'posts_orderby', array( $orderby, &$this ) );
    27372737
     
    27412741                         * @since 2.1.0
    27422742                         *
    27432743                         * @param string   $distinct The DISTINCT clause of the query.
    2744                          * @param WP_Query $this     The WP_Query instance (passed by reference).
     2744                         * @param WP_Query $query    The WP_Query instance (passed by reference).
    27452745                         */
    27462746                        $distinct = apply_filters_ref_array( 'posts_distinct', array( $distinct, &$this ) );
    27472747
     
    27512751                         * @since 2.1.0
    27522752                         *
    27532753                         * @param string   $limits The LIMIT clause of the query.
    2754                          * @param WP_Query $this   The WP_Query instance (passed by reference).
     2754                         * @param WP_Query $query  The WP_Query instance (passed by reference).
    27552755                         */
    27562756                        $limits = apply_filters_ref_array( 'post_limits', array( $limits, &$this ) );
    27572757
     
    27612761                         * @since 2.1.0
    27622762                         *
    27632763                         * @param string   $fields The SELECT clause of the query.
    2764                          * @param WP_Query $this   The WP_Query instance (passed by reference).
     2764                         * @param WP_Query $query  The WP_Query instance (passed by reference).
    27652765                         */
    27662766                        $fields = apply_filters_ref_array( 'posts_fields', array( $fields, &$this ) );
    27672767
     
    27742774                         * @since 3.1.0
    27752775                         *
    27762776                         * @param string[] $clauses Associative array of the clauses for the query.
    2777                          * @param WP_Query $this    The WP_Query instance (passed by reference).
     2777                         * @param WP_Query $query   The WP_Query instance (passed by reference).
    27782778                         */
    27792779                        $clauses = (array) apply_filters_ref_array( 'posts_clauses', array( compact( $pieces ), &$this ) );
    27802780
     
    28112811                         * @since 2.5.0
    28122812                         *
    28132813                         * @param string   $where The WHERE clause of the query.
    2814                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2814                         * @param WP_Query $query The WP_Query instance (passed by reference).
    28152815                         */
    28162816                        $where = apply_filters_ref_array( 'posts_where_request', array( $where, &$this ) );
    28172817
     
    28232823                         * @since 2.5.0
    28242824                         *
    28252825                         * @param string   $groupby The GROUP BY clause of the query.
    2826                          * @param WP_Query $this    The WP_Query instance (passed by reference).
     2826                         * @param WP_Query $query   The WP_Query instance (passed by reference).
    28272827                         */
    28282828                        $groupby = apply_filters_ref_array( 'posts_groupby_request', array( $groupby, &$this ) );
    28292829
     
    28342834                         *
    28352835                         * @since 2.5.0
    28362836                         *
    2837                          * @param string   $join The JOIN clause of the query.
    2838                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2837                         * @param string   $join  The JOIN clause of the query.
     2838                         * @param WP_Query $query The WP_Query instance (passed by reference).
    28392839                         */
    28402840                        $join = apply_filters_ref_array( 'posts_join_request', array( $join, &$this ) );
    28412841
     
    28472847                         * @since 2.5.0
    28482848                         *
    28492849                         * @param string   $orderby The ORDER BY clause of the query.
    2850                          * @param WP_Query $this    The WP_Query instance (passed by reference).
     2850                         * @param WP_Query $query   The WP_Query instance (passed by reference).
    28512851                         */
    28522852                        $orderby = apply_filters_ref_array( 'posts_orderby_request', array( $orderby, &$this ) );
    28532853
     
    28592859                         * @since 2.5.0
    28602860                         *
    28612861                         * @param string   $distinct The DISTINCT clause of the query.
    2862                          * @param WP_Query $this     The WP_Query instance (passed by reference).
     2862                         * @param WP_Query $query    The WP_Query instance (passed by reference).
    28632863                         */
    28642864                        $distinct = apply_filters_ref_array( 'posts_distinct_request', array( $distinct, &$this ) );
    28652865
     
    28712871                         * @since 2.5.0
    28722872                         *
    28732873                         * @param string   $fields The SELECT clause of the query.
    2874                          * @param WP_Query $this   The WP_Query instance (passed by reference).
     2874                         * @param WP_Query $query  The WP_Query instance (passed by reference).
    28752875                         */
    28762876                        $fields = apply_filters_ref_array( 'posts_fields_request', array( $fields, &$this ) );
    28772877
     
    28832883                         * @since 2.5.0
    28842884                         *
    28852885                         * @param string   $limits The LIMIT clause of the query.
    2886                          * @param WP_Query $this   The WP_Query instance (passed by reference).
     2886                         * @param WP_Query $query  The WP_Query instance (passed by reference).
    28872887                         */
    28882888                        $limits = apply_filters_ref_array( 'post_limits_request', array( $limits, &$this ) );
    28892889
     
    28982898                         * @since 3.1.0
    28992899                         *
    29002900                         * @param string[] $pieces Associative array of the pieces of the query.
    2901                          * @param WP_Query $this   The WP_Query instance (passed by reference).
     2901                         * @param WP_Query $query  The WP_Query instance (passed by reference).
    29022902                         */
    29032903                        $clauses = (array) apply_filters_ref_array( 'posts_clauses_request', array( compact( $pieces ), &$this ) );
    29042904
     
    29332933                         * @since 2.0.0
    29342934                         *
    29352935                         * @param string   $request The complete SQL query.
    2936                          * @param WP_Query $this    The WP_Query instance (passed by reference).
     2936                         * @param WP_Query $query   The WP_Query instance (passed by reference).
    29372937                         */
    29382938                        $this->request = apply_filters_ref_array( 'posts_request', array( $this->request, &$this ) );
    29392939                }
     
    29522952                 *
    29532953                 * @param WP_Post[]|int[]|null $posts Return an array of post data to short-circuit WP's query,
    29542954                 *                                    or null to allow WP to run its normal queries.
    2955                  * @param WP_Query             $this The WP_Query instance (passed by reference).
     2955                 * @param WP_Query             $query The WP_Query instance (passed by reference).
    29562956                 */
    29572957                $this->posts = apply_filters_ref_array( 'posts_pre_query', array( null, &$this ) );
    29582958
     
    30023002                         * @since 3.4.0
    30033003                         *
    30043004                         * @param bool     $split_the_query Whether or not to split the query.
    3005                          * @param WP_Query $this            The WP_Query instance.
     3005                         * @param WP_Query $query           The WP_Query instance.
    30063006                         */
    30073007                        $split_the_query = apply_filters( 'split_the_query', $split_the_query, $this );
    30083008
     
    30173017                                 * @since 3.4.0
    30183018                                 *
    30193019                                 * @param string   $request The post ID request.
    3020                                  * @param WP_Query $this    The WP_Query instance.
     3020                                 * @param WP_Query $query   The WP_Query instance.
    30213021                                 */
    30223022                                $this->request = apply_filters( 'posts_request_ids', $this->request, $this );
    30233023
     
    30493049                         * @since 2.3.0
    30503050                         *
    30513051                         * @param WP_Post[] $posts Array of post objects.
    3052                          * @param WP_Query  $this The WP_Query instance (passed by reference).
     3052                         * @param WP_Query  $query The WP_Query instance (passed by reference).
    30533053                         */
    30543054                        $this->posts = apply_filters_ref_array( 'posts_results', array( $this->posts, &$this ) );
    30553055                }
     
    31323132                                 * @since 2.7.0
    31333133                                 *
    31343134                                 * @param WP_Post  $post_preview  The Post object.
    3135                                  * @param WP_Query $this          The WP_Query instance (passed by reference).
     3135                                 * @param WP_Query $query         The WP_Query instance (passed by reference).
    31363136                                 */
    31373137                                $this->posts[0] = get_post( apply_filters_ref_array( 'the_preview', array( $this->posts[0], &$this ) ) );
    31383138                        }
     
    31953195                         * @since 1.5.0
    31963196                         *
    31973197                         * @param WP_Post[] $posts Array of post objects.
    3198                          * @param WP_Query  $this The WP_Query instance (passed by reference).
     3198                         * @param WP_Query  $query The WP_Query instance (passed by reference).
    31993199                         */
    32003200                        $this->posts = apply_filters_ref_array( 'the_posts', array( $this->posts, &$this ) );
    32013201                }
     
    32533253                         * @since 2.1.0
    32543254                         *
    32553255                         * @param string   $found_posts_query The query to run to find the found posts.
    3256                          * @param WP_Query $this              The WP_Query instance (passed by reference).
     3256                         * @param WP_Query $query             The WP_Query instance (passed by reference).
    32573257                         */
    32583258                        $found_posts_query = apply_filters_ref_array( 'found_posts_query', array( 'SELECT FOUND_ROWS()', &$this ) );
    32593259
     
    32763276                 * @since 2.1.0
    32773277                 *
    32783278                 * @param int      $found_posts The number of posts found.
    3279                  * @param WP_Query $this        The WP_Query instance (passed by reference).
     3279                 * @param WP_Query $query       The WP_Query instance (passed by reference).
    32803280                 */
    32813281                $this->found_posts = (int) apply_filters_ref_array( 'found_posts', array( $this->found_posts, &$this ) );
    32823282
     
    33213321                         *
    33223322                         * @since 2.0.0
    33233323                         *
    3324                          * @param WP_Query $this The WP_Query instance (passed by reference).
     3324                         * @param WP_Query $query The WP_Query instance (passed by reference).
    33253325                         */
    33263326                        do_action_ref_array( 'loop_start', array( &$this ) );
    33273327                }
     
    33483348                         *
    33493349                         * @since 2.0.0
    33503350                         *
    3351                          * @param WP_Query $this The WP_Query instance (passed by reference).
     3351                         * @param WP_Query $query The WP_Query instance (passed by reference).
    33523352                         */
    33533353                        do_action_ref_array( 'loop_end', array( &$this ) );
    33543354                        // Do some cleaning up after the loop.
     
    33593359                         *
    33603360                         * @since 4.9.0
    33613361                         *
    3362                          * @param WP_Query $this The WP_Query instance.
     3362                         * @param WP_Query $query The WP_Query instance.
    33633363                         */
    33643364                        do_action( 'loop_no_results', $this );
    33653365                }
     
    43144314                 * Fires once the post data has been set up.
    43154315                 *
    43164316                 * @since 2.8.0
    4317                  * @since 4.1.0 Introduced `$this` parameter.
     4317                 * @since 4.1.0 Introduced `$query` parameter.
    43184318                 *
    4319                  * @param WP_Post  $post The Post object (passed by reference).
    4320                  * @param WP_Query $this The current Query object (passed by reference).
     4319                 * @param WP_Post  $post  The Post object (passed by reference).
     4320                 * @param WP_Query $query The current Query object (passed by reference).
    43214321                 */
    43224322                do_action_ref_array( 'the_post', array( &$post, &$this ) );
    43234323
  • src/wp-includes/class-wp-site-query.php

     
    318318                 * @param array|int|null $site_data Return an array of site data to short-circuit WP's site query,
    319319                 *                                  the site count as an integer if `$this->query_vars['count']` is set,
    320320                 *                                  or null to run the normal queries.
    321                  * @param WP_Site_Query  $this      The WP_Site_Query instance, passed by reference.
     321                 * @param WP_Site_Query  $query     The WP_Site_Query instance, passed by reference.
    322322                 */
    323323                $site_data = apply_filters_ref_array( 'sites_pre_query', array( $site_data, &$this ) );
    324324
     
    396396                 * @since 4.6.0
    397397                 *
    398398                 * @param WP_Site[]     $_sites An array of WP_Site objects.
    399                  * @param WP_Site_Query $this   Current instance of WP_Site_Query (passed by reference).
     399                 * @param WP_Site_Query $query  Current instance of WP_Site_Query (passed by reference).
    400400                 */
    401401                $_sites = apply_filters_ref_array( 'the_sites', array( $_sites, &$this ) );
    402402
     
    600600                         *
    601601                         * @param string[]      $search_columns Array of column names to be searched.
    602602                         * @param string        $search         Text being searched.
    603                          * @param WP_Site_Query $this           The current WP_Site_Query instance.
     603                         * @param WP_Site_Query $query          The current WP_Site_Query instance.
    604604                         */
    605605                        $search_columns = apply_filters( 'site_search_columns', $search_columns, $this->query_vars['search'], $this );
    606606
     
    637637                 * @since 4.6.0
    638638                 *
    639639                 * @param string[]      $pieces An associative array of site query clauses.
    640                  * @param WP_Site_Query $this   Current instance of WP_Site_Query (passed by reference).
     640                 * @param WP_Site_Query $query  Current instance of WP_Site_Query (passed by reference).
    641641                 */
    642642                $clauses = apply_filters_ref_array( 'sites_clauses', array( compact( $pieces ), &$this ) );
    643643
  • src/wp-includes/class-wp-term-query.php

     
    696696                 *
    697697                 * @param array|null    $terms Return an array of term data to short-circuit WP's term query,
    698698                 *                             or null to allow WP queries to run normally.
    699                  * @param WP_Term_Query $this The WP_Term_Query instance, passed by reference.
     699                 * @param WP_Term_Query $query The WP_Term_Query instance, passed by reference.
    700700                 */
    701701                $this->terms = apply_filters_ref_array( 'terms_pre_query', array( $this->terms, &$this ) );
    702702
  • src/wp-includes/class-wp-theme.php

     
    12581258                 * @since 4.9.6
    12591259                 *
    12601260                 * @param string[]     $post_templates Array of template header names keyed by the template file name.
    1261                  * @param WP_Theme     $this           The theme object.
     1261                 * @param WP_Theme     $theme          The theme object.
    12621262                 * @param WP_Post|null $post           The post being edited, provided for context, or null.
    12631263                 * @param string       $post_type      Post type to get the templates for.
    12641264                 */
     
    12741274                 * @since 4.7.0 Added the `$post_type` parameter.
    12751275                 *
    12761276                 * @param string[]     $post_templates Array of template header names keyed by the template file name.
    1277                  * @param WP_Theme     $this           The theme object.
     1277                 * @param WP_Theme     $theme          The theme object.
    12781278                 * @param WP_Post|null $post           The post being edited, provided for context, or null.
    12791279                 * @param string       $post_type      Post type to get the templates for.
    12801280                 */
  • src/wp-includes/class-wp-user-query.php

     
    224224                 *
    225225                 * @since 4.0.0
    226226                 *
    227                  * @param WP_User_Query $this Current instance of WP_User_Query (passed by reference).
     227                 * @param WP_User_Query $query Current instance of WP_User_Query (passed by reference).
    228228                 */
    229229                do_action_ref_array( 'pre_get_users', array( &$this ) );
    230230
     
    544544                         *
    545545                         * @param string[]      $search_columns Array of column names to be searched.
    546546                         * @param string        $search         Text being searched.
    547                          * @param WP_User_Query $this           The current WP_User_Query instance.
     547                         * @param WP_User_Query $query          The current WP_User_Query instance.
    548548                         */
    549549                        $search_columns = apply_filters( 'user_search_columns', $search_columns, $search, $this );
    550550
     
    575575                 *
    576576                 * @since 3.1.0
    577577                 *
    578                  * @param WP_User_Query $this Current instance of WP_User_Query (passed by reference).
     578                 * @param WP_User_Query $query Current instance of WP_User_Query (passed by reference).
    579579                 */
    580580                do_action_ref_array( 'pre_user_query', array( &$this ) );
    581581        }
     
    604604                 *
    605605                 * @since 5.1.0
    606606                 *
    607                  * @param array|null $results Return an array of user data to short-circuit WP's user query
    608                  *                            or null to allow WP to run its normal queries.
    609                  * @param WP_User_Query $this The WP_User_Query instance (passed by reference).
     607                 * @param array|null    $results Return an array of user data to short-circuit WP's user query
     608                 *                               or null to allow WP to run its normal queries.
     609                 * @param WP_User_Query $query  The WP_User_Query instance (passed by reference).
    610610                 */
    611611                $this->results = apply_filters_ref_array( 'users_pre_query', array( null, &$this ) );
    612612
     
    628628                                 *
    629629                                 * @global wpdb $wpdb WordPress database abstraction object.
    630630                                 *
    631                                  * @param string $sql         The SELECT FOUND_ROWS() query for the current WP_User_Query.
    632                                  * @param WP_User_Query $this The current WP_User_Query instance.
     631                                 * @param string        $sql   The SELECT FOUND_ROWS() query for the current WP_User_Query.
     632                                 * @param WP_User_Query $query The current WP_User_Query instance.
    633633                                 */
    634634                                $found_users_query = apply_filters( 'found_users_query', 'SELECT FOUND_ROWS()', $this );
    635635
  • src/wp-includes/class-wp-widget.php

     
    363363                         * @since 2.8.0
    364364                         *
    365365                         * @param array     $instance The current widget instance's settings.
    366                          * @param WP_Widget $this     The current widget instance.
     366                         * @param WP_Widget $widget   The current widget instance.
    367367                         * @param array     $args     An array of default widget arguments.
    368368                         */
    369369                        $instance = apply_filters( 'widget_display_callback', $instance, $this, $args );
     
    457457                                 * @param array     $instance     The current widget instance's settings.
    458458                                 * @param array     $new_instance Array of new widget settings.
    459459                                 * @param array     $old_instance Array of old widget settings.
    460                                  * @param WP_Widget $this         The current widget instance.
     460                                 * @param WP_Widget $widget       The current widget instance.
    461461                                 */
    462462                                $instance = apply_filters( 'widget_update_callback', $instance, $new_instance, $old_instance, $this );
    463463                                if ( false !== $instance ) {
     
    510510                 * @since 2.8.0
    511511                 *
    512512                 * @param array     $instance The current widget instance's settings.
    513                  * @param WP_Widget $this     The current widget instance.
     513                 * @param WP_Widget $widget   The current widget instance.
    514514                 */
    515515                $instance = apply_filters( 'widget_form_callback', $instance, $this );
    516516
     
    530530                         *
    531531                         * @since 2.8.0
    532532                         *
    533                          * @param WP_Widget $this     The widget instance (passed by reference).
     533                         * @param WP_Widget $widget   The widget instance (passed by reference).
    534534                         * @param null      $return   Return null if new fields are added.
    535535                         * @param array     $instance An array of the widget's settings.
    536536                         */
  • src/wp-includes/class-wp.php

     
    485485                 * @since 2.8.0
    486486                 *
    487487                 * @param string[] $headers Associative array of headers to be sent.
    488                  * @param WP       $this    Current WordPress environment instance.
     488                 * @param WP       $wp      Current WordPress environment instance.
    489489                 */
    490490                $headers = apply_filters( 'wp_headers', $headers, $this );
    491491
  • src/wp-includes/customize/class-wp-customize-selective-refresh.php

     
    428428                 *     @type array $errors   List of errors triggered during rendering of partials, if `WP_DEBUG_DISPLAY`
    429429                 *                           is enabled.
    430430                 * }
    431                  * @param WP_Customize_Selective_Refresh $this     Selective refresh component.
     431                 * @param WP_Customize_Selective_Refresh $refresh  Selective refresh component.
    432432                 * @param array                          $partials Placements' context data for the partials rendered in the request.
    433433                 *                                                 The array is keyed by partial ID, with each item being an array of
    434434                 *                                                 the placements' context data.
  • src/wp-includes/rest-api/class-wp-rest-server.php

     
    457457                 * @since 4.5.0 Applied to embedded responses.
    458458                 *
    459459                 * @param WP_HTTP_Response $result  Result to send to the client. Usually a `WP_REST_Response`.
    460                  * @param WP_REST_Server   $this    Server instance.
     460                 * @param WP_REST_Server   $server  Server instance.
    461461                 * @param WP_REST_Request  $request Request used to generate the response.
    462462                 */
    463463                $result = apply_filters( 'rest_post_dispatch', rest_ensure_response( $result ), $this, $request );
     
    486486                 *                                           Default false.
    487487                 * @param WP_HTTP_Response $result  Result to send to the client. Usually a `WP_REST_Response`.
    488488                 * @param WP_REST_Request  $request Request used to generate the response.
    489                  * @param WP_REST_Server   $this    Server instance.
     489                 * @param WP_REST_Server   $server  Server instance.
    490490                 */
    491491                $served = apply_filters( 'rest_pre_serve_request', false, $result, $request, $this );
    492492
     
    508508                         * @since 4.8.1
    509509                         *
    510510                         * @param array            $result  Response data to send to the client.
    511                          * @param WP_REST_Server   $this    Server instance.
     511                         * @param WP_REST_Server   $server  Server instance.
    512512                         * @param WP_REST_Request  $request Request used to generate the response.
    513513                         */
    514514                        $result = apply_filters( 'rest_pre_echo_response', $result, $this, $request );
     
    966966                 *
    967967                 * @param mixed           $result  Response to replace the requested version with. Can be anything
    968968                 *                                 a normal endpoint can return, or null to not hijack the request.
    969                  * @param WP_REST_Server  $this    Server instance.
     969                 * @param WP_REST_Server  $server  Server instance.
    970970                 * @param WP_REST_Request $request Request used to generate the response.
    971971                 */
    972972                $result = apply_filters( 'rest_pre_dispatch', null, $this, $request );
  • src/wp-includes/widgets/class-wp-widget-custom-html.php

     
    156156                 *
    157157                 * @param string                $content  The widget content.
    158158                 * @param array                 $instance Array of settings for the current widget.
    159                  * @param WP_Widget_Custom_HTML $this     Current Custom HTML widget instance.
     159                 * @param WP_Widget_Custom_HTML $widget   Current Custom HTML widget instance.
    160160                 */
    161161                $content = apply_filters( 'widget_custom_html_content', $content, $instance, $this );
    162162
  • src/wp-includes/widgets/class-wp-widget-media.php

     
    162162                 * @since 4.9.0
    163163                 *
    164164                 * @param array           $schema Instance schema.
    165                  * @param WP_Widget_Media $this  Widget object.
     165                 * @param WP_Widget_Media $widget Widget object.
    166166                 */
    167167                $schema = apply_filters( "widget_{$this->id_base}_instance_schema", $schema, $this );
    168168
     
    245245                 *
    246246                 * @param array           $instance Instance data.
    247247                 * @param array           $args     Widget args.
    248                  * @param WP_Widget_Media $this     Widget object.
     248                 * @param WP_Widget_Media $widget   Widget object.
    249249                 */
    250250                $instance = apply_filters( "widget_{$this->id_base}_instance", $instance, $args, $this );
    251251
  • src/wp-includes/widgets/class-wp-widget-text.php

     
    270270                 * Filters the content of the Text widget.
    271271                 *
    272272                 * @since 2.3.0
    273                  * @since 4.4.0 Added the `$this` parameter.
    274                  * @since 4.8.1 The `$this` param may now be a `WP_Widget_Custom_HTML` object in addition to a `WP_Widget_Text` object.
     273                 * @since 4.4.0 Added the `$widget` parameter.
     274                 * @since 4.8.1 The `$widget` param may now be a `WP_Widget_Custom_HTML` object in addition to a `WP_Widget_Text` object.
    275275                 *
    276276                 * @param string                               $text     The widget content.
    277277                 * @param array                                $instance Array of settings for the current widget.
    278                  * @param WP_Widget_Text|WP_Widget_Custom_HTML $this     Current Text widget instance.
     278                 * @param WP_Widget_Text|WP_Widget_Custom_HTML $widget   Current text or HTML widget instance.
    279279                 */
    280280                $text = apply_filters( 'widget_text', $text, $instance, $this );
    281281
     
    290290                         *
    291291                         * @param string         $text     The widget content.
    292292                         * @param array          $instance Array of settings for the current widget.
    293                          * @param WP_Widget_Text $this     Current Text widget instance.
     293                         * @param WP_Widget_Text $widget   Current Text widget instance.
    294294                         */
    295295                        $text = apply_filters( 'widget_text_content', $text, $instance, $this );
    296296                } else {