From 6e5a5d21e00283f2ee4275d1f158d6432947a636 Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov.ru@gmail.com>
Date: Sat, 7 Sep 2013 19:47:10 +0000
Subject: [PATCH] Document 'wp_link_query_args' and 'wp_link_query' filters.
 props DrewAPicture. fixes #18042. Built from
 https://develop.svn.wordpress.org/trunk@25299

git-svn-id: http://core.svn.wordpress.org/trunk@25262 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/class-wp-editor.php | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/wp-includes/class-wp-editor.php b/wp-includes/class-wp-editor.php
index 42283f5ec6..7581288472 100644
--- a/wp-includes/class-wp-editor.php
+++ b/wp-includes/class-wp-editor.php
@@ -798,6 +798,17 @@ final class _WP_Editors {
 
 		$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.
+		 *
+		 * @see WP_Query for a full list of arguments
+		 *
+		 * @since 3.7.0
+		 *
+		 * @param array $query An array of WP_Query arguments.
+		 */
 		$query = apply_filters( 'wp_link_query_args', $query );
 
 		// Do main query.
@@ -823,6 +834,25 @@ final class _WP_Editors {
 			);
 		}
 
+		/**
+		 * 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 WP_Query arguments. @see 'wp_link_query_args' filter
+		 */
 		return apply_filters( 'wp_link_query', $results, $query );
 	}