apply_filters( 'wp_link_query_args', array $query )
Filters the link query arguments.
Contents
Description
Allows modification of the link query arguments before querying.
See also
- WP_Query: for a full list of arguments
Parameters
-
$query
array -
An array of WP_Query arguments.
More Information
The “wp_link_query_args
” filter is used to filter the array of arguments passed to the wp_link_query
function which is responsible for building the list of linkable content in the modal window that displays when you insert a link. wp_link_query_args
allows you to alter the query before the list is rendered on the page.
Source
File: wp-includes/class-wp-editor.php
.
View all references
$query = apply_filters( 'wp_link_query_args', $query );
Changelog
Version | Description |
---|---|
3.7.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example Migrated from Codex:
Any allowable WP_Query parameters can be passed to
wp_link_query_args
. One example is filtering out post types:Show only posts and pages
If you wanted only allow posts and pages to show up in the linked results, you could do something like this. In this example, we’re going to check to make sure we aren’t in the admin, so results would only be filtered on the front end, but admins could still add links to all post types.
Remove specific post types from results
You’d use something like this if you only wanted to remove specific post types from the results.