Ticket #18042: 18042-docs.2.diff

src/wp-includes/class-wp-editor.php

@@ -798 +798 @@
 
                 $query['offset'] = $args['pagenum'] > 1 ? $query['posts_per_page'] * ( $args['pagenum'] - 1 ) : 0;
 
+                /**
+                 * Filter the link query arguments.
+                 *
+                 * Allows modification of the link query arguments before querying.
+                 *
+                 * @since 3.7.0
+                 *
+                 * @param array $query {
+                 *     An array of query arguments.
+                 *
+                 *     @type string 'post_type'              The post type.
+                 *     @type bool   'suppress_filters'       Whether to suppress filters.
+                 *     @type bool   'update_post_term_cache' Whether to update the post term cache.
+                 *     @type bool   'update_post_meta_cache' Whether to update the post meta cache.
+                 *     @type string 'post_status'            The post status.
+                 *     @type string 'order'                  How to order the query, ascending or descending.
+                 *     @type string 'orderby'                What field to order the query by.
+                 *     @type int    'posts_per_page'         The number of posts to query for.
+                 * }
+                 */
                 $query = apply_filters( 'wp_link_query_args', $query );
 
                 // Do main query.
@@ -823 +843 @@
                         );
                 }
 
+                /**
+                 * Filter the link query results.
+                 *
+                 * Allows modification of the returned link query results.
+                 *
+                 * @since 3.7.0
+                 *
+                 * @param array $results {
+                 *     An associative array of query results.
+                 *
+                 *     @type array {
+                 *         @type int    'ID'        The post id.
+                 *         @type string 'title'     The trimmed, escaped post title.
+                 *         @type string 'permalink' The post permalink.
+                 *         @type string 'info'      A 'Y/m/d'-formatted date for 'post' post type, the 'singular_name' post type label otherwise.
+                 *     }
+                 * }
+                 * @param array $query   An array of query arguments. @see 'wp_link_query_args' filter
+                 * }
+                 */
                 return apply_filters( 'wp_link_query', $results, $query );
         }