SearchWP Documentation

View the installation guide, browse the Knowledge Base, find out about SearchWP’s many hooks

Link to file (e.g. PDF) instead of Attachment page

WordPress by default will link to an Attachment page for any Media returned as a search result. Many themes do not have useful templates for Media and very often it makes sense to link directly to the file itself instead.

This snippet will customize your search results template to link directly to Media files instead of an Attachment page.

All hooks should be added to your custom SearchWP Customizations Plugin.

<?php
// Link directly to Media files instead of Attachment pages in search results
// @link https://searchwp.com/documentation/knowledge-base/link-file-pdf/
function my_search_media_direct_link( $permalink, $post = null ) {
if (
(
is_search()
|| doing_action( 'wp_ajax_searchwp_live_search' )
|| doing_action( 'wp_ajax_nopriv_searchwp_live_search' )
|| isset( $_REQUEST['swps'] )
)
&& 'attachment' === get_post_type( $post )
) {
$permalink = wp_get_attachment_url( $post );
}
return esc_url( $permalink );
}
add_filter( 'the_permalink', 'my_search_media_direct_link', 99, 2 );
add_filter( 'attachment_link', 'my_search_media_direct_link', 99, 2 );
view raw functions.php hosted with ❤ by GitHub

Create a Better WordPress Search Experience Today

Never lose visitors to unhelpful search results again. SearchWP makes creating your own smart WordPress search fast and easy.

Get SearchWP Now
Multiple Search Engines Icon