Pages and duplicate the default page, calling the new one “search.” Then go to Presentation > Sections, create a new section called “search,” and make sure to assign the page you just created as the template, and set all options to “no.”
Somewhere in your templates, you will have a tag. To assign the section you just created, add the attribute section="search". (This only works when Textpattern is in clean URL mode. In messy mode, check out this older but still functional tutorial from Justin French.)
This allows for full customizion of the search page without mucking about the default page.
Show the Result Count
Textpattern provides the tag that will display the number of returned hits. However, in order to function, it must be accompanied by a tag, which actually counts the results. This is best illustrated through a code example:
The tag with the attribute pgonly="1" performs the actual count; the following tag is used to display the count. The must come second.
Restate the Search Term
One great way to improve the usability of search results is to restate the search string at the top of the results page. This not only reminds them of their query, but will help explain if no results appeared because the search term was misspelled.
Textpattern does not supply this functionality natively; instead, we have to rely on the plugin tru_tags. Besides being an amazing tagging plugin by itself (this site uses it), it provides a sweet little bonus tag that returns whatever the user typed into the search box. For example, using the result count above, you could run both of these techniques in tandem:
There were for the search "."
This would return something like There were 8 results for the search “your mom.” It really is as simple as that.
Restrict Search Results to a Section or Category
I recently had a project that required the capability to search within only a few categories and a particular section, in addition to a primary site-wide search. The ability to search just one section is fairly well documented. However, the ability to search within particular categories requires a bit more legwork.
The plugin chh_article_custom serves as a replacement to the and tags. In addition to some general bells and whistles, it has a few unique bits that include an expansion on the searchall attribute. When the variable is set to searchall="none", search results are restricted to the attributes of the tag. For instance:
This will restrict search results to the section “bigcats” as well as the categories “Tigers,” “Lions” and “Panthers.” This is very useful for complex sites where sections and categories are used to isolate specific types of content.
What I Cannot Figure Out
All of this aside, the one major deficiency I find in Textpattern’s search is that the engine only goes through the titles and bodies of articles — I have yet to find a way to get TXP to also search excerpts, categories, custom fileds, posted dates and other pieces of data. There have been some very hackish solutions posted, but even after tromping around publish.php, the only thing I found was a reliable way to break all search functionality completely. If anyone has any non-programmer-friendly clues, let me know.
]]>