How to implement FullTextSearch on a page?

[sanfordandson]

@epsilonadmin Yes, I saw your email, and I am following the instructions right now on a new staging site that has all 1700+ documents stored externally on the server. I sent you an email asking another question, but I will repeat here for others:

Can you please point me to instructions on how to add the WPFTS::Live Search widget to a page?

I want to implement something just like this:

[https://searchannavonreitz.americanstatenationals.org/](link url)

If you enter the word "consent" in the search field (without the quotes), then click the Find button, you will be redirected to a search results page showing all the PDF files that contain the search term.

So, if you could please direct me to some documentation on how to implement the widget on a page, I would be grateful!

Regards,

Larry

[EpsilonAdmin]

Hi, Larry

About the WPFTS :: Live Search widget. This widget should be in your widget library (where all other widgets are listed). You can put it on the sidebar or another widget area and fill up some Settings inside the widget form as displayed below:

Alternatively you can use shortcode to insert the widget into any text content. It can be done with:

[wpfts_widget preset="<preset_id>" title="" placeholder="Search..." button_text="Search" hidebutton="0" class=""]

You need to put preset_id value to "preset_media" if you want to search for Files Only with this widget or "preset_dlp" for Document Library Pro documents only.

title can be set in case you want to have a widget title above the input, placeholder and button_text are the texts inside the input and button. Also you can hide the button ("enter key" to start search) by hidebutton=1 and you can set up CSS class via class attribute in case you want to customize widget style.

Hope this is clear. Feel free to ask if you have some questions!

[sanfordandson]

Well, when I navigate to Appearance > Widgets, I don't see the WPFTS Live Search widget (see attached image).

However, I was able to successfully use the shortcode information you provided to add a search widget to a page. You can see it here:

https://staging4.hamlinny.org/document-center/

Ignore the Search field on the right ... that belongs to the Document Library Pro plugin, and will be going away soon.

So, enter "Program Notice" in the WPFTS search field and click the Search button. You will see 25 pages of results, however, the results only show the PDF filenames. Is there any way to get search results like you see here:

[https://searchannavonreitz.americanstatenationals.org/?s=consent&numberposts=30&results_hide_fields=](link url)

Those search results include:

Filename
Date/Author
Excerpt showing highlighted occurrences of the search term
Score
Download link

How do I get my search results to include all that information?

Also, am I forced to use the archive search results page to display the results? While the archive sidebar is required on the archive page, I would really rather NOT see it on my WPFTS search results page.

Thank you so much ... I am getting very close!

Larry

[EpsilonAdmin]

This new Widget editor is crazy, I think there are sidebars on the left and you need to press [+] to see the list of available widgets.

Okay, for search results style: it looks like your theme is allowed to show the post title only. I don't see here if you are using Elementor to create search results page or you are using theme's default search results page. In the first case you need to add those items (author/date/excerpt) in Elementor. In the second case you need to tell me which theme you are using so I can see if it possible to switch on those fields on the theme settings or make a fix.

BTW you can search for the theme name over this forum to find any fixes that we already done before.

[sanfordandson]

@EpsilonAdmin Ok, I see all the widgets when I click the [+], including your WPFTS::Live Search widget!

I will not be using the WPFTS widget in the sidebar for now, but I will definitely remember it in the future.

As for the theme, I am using the Astra (free) theme. The Quick Links Sidebar that you see in the image attachment to my last post is the sidebar that appears on all the pages, including the post archive page. You can see the archive page here:

[https://staging4.hamlinny.org/news/](link url)

I am pretty sure I am using the Astra theme's default search results page, because I don't remember specifying otherwise.

I will search the forum for the Astra Theme to see if I can find any more info. In the meantime, if you can take a look at the Astra theme and see if there is any way to make it display the additional information on the search results page, that would be great!

FYI, I edited one of the existing DLP documents, and the Author field at the bottom was already specified. I also added an author (the same author) on the right hand side in the DLP edit screen, and also added an Excerpt. However, after saving everything and clearing cache, and re-searching, still only the document title shows up on the search results page.

I am attaching the edit screen for the DLP document, so you can see what I am talking about.

I am also attaching a closeup of the Astra Settings section of the DLP edit screen, where you can select the type of sidebar, but I don't know if that is relevant to my problem or not.

I can provide login credentials to the staging site via email, if you think it would help your investigation. Just let me know.

I appreciate all your help!

Larry

[sanfordandson]

@EpsilonAdmin Ok, so after my last reply, I found this post about the Astra theme not showing Smart excerpts:

[https://docs.fulltextsearch.org/forum/topic/92/solved-the-astra-theme-does-not-show-smart-excerpt-for-files?_=1664945965846](link url)

So I implemented the solution mentioned in that post, and it helped a lot (but still missing SOME information). To see the current status, go to my Document Search page here:

https://staging4.hamlinny.org/document-center/

and enter "Program Notice" in the search field (without the quotes), and click the Search button. You will now see this search results page:

[https://staging4.hamlinny.org/?wpfts_wdgt=preset_dlp&s=Program+Notice](link url)

You can see that now there is an excerpt shown, along with highlighted references to the search term, and also a Score.

However, is there any way to also get the Article Author/Date and a Download link, like that shown on the previously mentioned site? Shown here:

https://searchannavonreitz.americanstatenationals.org/?s=consent&numberposts=30&results_hide_fields=

I know that the document names that show up on the search results page are hyperlinked to the document, but it would still be nice to get the Download link to appear, like on the previously mentioned site, and also the document date. If that is not possible, is it at least possible to get the hyperlinked document title to open in a new tab?

One last thing: If you enter nothing in the search field, then click the Search button, nothing should happen. Instead, it takes you to the search results page and shows many pages of document titles. Can this be fixed?

Thank you so much!

[EpsilonAdmin]

Hi, Larry

The Date and Author is not related to WPFTS, it's the theme author preferences - whether include Date and Author info to the post list. However, thanks to WP's hook system we can add this functionality with a simple code.

I would recommend to place it into the child theme's functions.php, however you can put it into the main theme functions.php if you are not using child theme.

add_action('astra_entry_content_before', function()
{
	if (is_search()) {
		// Modify search result posts
		// Add date and author
		$author = get_the_author();
		$author_url = get_the_author_link();
		
		echo '<span class="post-meta-infos"><time class="date-container minor-meta updated" itemprop="datePublished">'.the_date().'</time><span class="text-sep"> / </span><span class="blog-author minor-meta">by <span class="entry-author-link" itemprop="author"><span class="author"><span class="fn"><a href="'.htmlspecialchars($author_url).'" title="Posts by '.htmlspecialchars($author).'" rel="author">'.htmlspecialchars($author).'</a></span></span></span></span></span>';
	}
});

This code will add Date and Author info to search results.

[sanfordandson]

@EpsilonAdmin Thank you!

On the search results page, when clicking on the titles to open a document, is there a way to make that open in a new browser tab, rather than in the same tab?

Thanks again.

[EpsilonAdmin]

Hi, Larry

Yes, we can use Astra-specific hook to add target="_blank" attribute to the title's link.

Also I made a hook that adds "Download" link below near to "score" value. Unfortunately it's hard to detect filesize at this point (since the file can be located on another server).

Place this code right below the code that I posted above, in the functions.php:

// Hook to force search result files to open in new tab
add_filter('astra_the_post_title_before', function($before)
{
	if (is_search()) {
		// Modify the search result title
		$before = preg_replace('/<a\s+href=/', '<a target="_blank" href=', $before);
	}
	
	return $before;
});

// Hook to add "Download" link below the excerpt (near the "Score" value)
add_filter('wpfts_se_output', function($a, $post)
{
	if ($a && $post) {
		if (isset($post['post_type']) && ($post['post_type'] == 'dlp_document')) {
			// Add Download button
			$shift = (strlen($a['score']) > 0) ? ' wpfts-shift' : '';

			$link = '';

			$post_id = $post['ID'];
			
			$link_type = get_post_meta($post_id, '_dlp_document_link_type', true);
			$file_size = get_post_meta($post_id, '_dlp_document_file_size', true);
			$file_id = get_post_meta($post_id, '_dlp_attached_file_id', true);
			$link_url = get_post_meta($post_id, '_dlp_direct_link_url', true);

			$local_url = false;
			if ($link_type === 'file') {
				// The attachment post
				if ($file_id > 0) {
				
					$link = wp_get_attachment_url($file_id);
				}
			
			} elseif ($link_type === 'url') {
				// The link
				$link = $link_url;
			} else {
				// Unknown link_type
			
			}
			
			if (strlen($link) > 0) {
				$a['link'] = '<a target="_blank" class="wpfts-download-link'.$shift.'" href="'.esc_url($link).'"><span>'.__('Download', 'fulltext-search').'</span></a>';
			}
		}
	}
	
	return $a;
}, 10, 2);

Hope this helps. Thanks you!

[sanfordandson]

@EpsilonAdmin This works great except for one small error in the constructed download link. For example, here is the constructed link for one of the search results:

https://https//staging4.hamlinny.org/documents/assessors-office/assessment-rolls/2019/2019-Final-Roll.pdf

The second occurrence of the "https//" is unnecessary.

I tried to fix this, but php is not my strong point.

Larry

[EpsilonAdmin]

Okay, Larry,

could you please show me how the links looks like when added to the Document Library Pro document edit window in WP Admin?
I just checked on my side and I don't see this problem, so I think the difference is how we put links to documents.

Thanks!

[sanfordandson]

@EpsilonAdmin Attached is a screen cap of one of the documents. The full link for this document is:

https://staging4.hamlinny.org/documents/assessors-office/assessment-rolls/2019/2019-Final-Roll.pdf

If you go to my documents page here:

[https://staging4.hamlinny.org/document-center/](link url)

and search for the word "Sewer" (without the quotes), this document will be the first one in the search results. Note that the link for the title is correct, while the URL for the Download link is incorrect.

[EpsilonAdmin]

Okay, Larry,

please could you go to the code we added last time and replace 6th line from the end:

$a['link'] = '<a target="_blank" class="wpfts-download-link'.$shift.'" href="'.esc_url($link).'"><span>'.__('Download', 'fulltext-search').'</span></a>';

by this one:

$a['link'] = '<a target="_blank" class="wpfts-download-link'.$shift.'" href="'.htmlspecialchars($link).'"><span>'.__('Download', 'fulltext-search').'</span></a>';

(actually only esc_url has been replaced by htmlspecialchars).

I think this function breaks the URL somehow on your server (and it's VERY strange).

Please let me know. Thanks!

[sanfordandson]

@EpsilonAdmin I replaced esc_url with htmlspecialchars, but that didn't fix the issue. Very strange, indeed.

You can see when you mouseover the Download link that the url is incorrect, right? But the link on the title is correct!

[sanfordandson]

@sanfordandson Could there be something in the .htaccess file that is causing this?

[EpsilonAdmin]

I don't think so, it looks like a PHP problem.

Which version of the Document Library Pro you are using?

[sanfordandson]

@EpsilonAdmin 1.7.2 (current version)

[sanfordandson]

@sanfordandson I know it's a cludge, but could you strip out all occurrences of "https//"? That would make the url correct.

[EpsilonAdmin]

Okay, Larry

I am sure they made some tricks in the plugin to modify URL, but I can't say which tricks, since I only have version 1.1.2 at the moment.

So let's go with the "patch" solution. Please replace the line

$a['link'] = '<a target="_blank" class="wpfts-download-link'.$shift.'" href="'.htmlspecialchars($link).'"><span>'.__('Download', 'fulltext-search').'</span></a>';

with this one

$a['link'] = '<a target="_blank" class="wpfts-download-link'.$shift.'" href="'.htmlspecialchars(preg_replace('~^\/\/http~', 'http', $link)).'"><span>'.__('Download', 'fulltext-search').'</span></a>';

It should work.

[sanfordandson]

@EpsilonAdmin Wow, still didn't work. I even deleted the astra theme's functions.php file from the server, refreshed the browser (it blew up, as expected), then uploaded the modified functions.php file. I did all this to make sure there was no cache issue. Still doesn't work. Real bizarre.

Would it help if I sent you login credentials and ftp credentials via email?