WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )apply_filters( "hook_name", "what_to_filter" ).Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.
| Line | Code |
|---|---|
| 2582 | // Apply post-paging filters on where and join. Only plugins that |
| 2583 | // manipulate paging queries should use these hooks. |
| 2584 | if ( !$q['suppress_filters'] ) { |
| 2585 | $where = apply_filters_ref_array( 'posts_where_paged', array( $where, &$this ) ); |
| 2586 | $groupby = apply_filters_ref_array( 'posts_groupby', array( $groupby, &$this ) ); |
| 2587 | $join = apply_filters_ref_array( 'posts_join_paged', array( $join, &$this ) ); |
| 2588 | $orderby = apply_filters_ref_array( 'posts_orderby', array( $orderby, &$this ) ); |
| 2589 | $distinct = apply_filters_ref_array( 'posts_distinct', array( $distinct, &$this ) ); |
| 2590 | $limits = apply_filters_ref_array( 'post_limits', array( $limits, &$this ) ); |
| 2591 | $fields = apply_filters_ref_array( 'posts_fields', array( $fields, &$this ) ); |
| 2592 | |
| 2593 | // Filter all clauses at once, for convenience |
| 2594 | $clauses = (array) apply_filters_ref_array( 'posts_clauses', array( compact( $pieces ), &$this ) ); |
| 2595 | foreach ( $pieces as $piece ) |
| 2596 | $$piece = isset( $clauses[ $piece ] ) ? $clauses[ $piece ] : ''; |
| 2597 | } |
| 2598 | |
| 2599 | // Announce current selection parameters. For use by caching plugins. |
| 2600 | do_action( 'posts_selection', $where . $groupby . $orderby . $limits . $join ); |