TYPO3 Logo
Faceted Search
Options
Give feedback View source How to edit Edit on GitHub Full documentation (single file)

Faceted Search

  • Introduction
  • Examples
  • Quick start
  • Indexing
    • Pages
    • Content Elements
    • News (EXT:news)
    • News (EXT:tt_news)
    • Addresses (EXT:tt_address)
    • Files
    • Custom Indexer
    • Indexing custom content fields
  • Backend
  • Filters / Faceted Search
    • Setup filters
    • Tag based filters
    • Date range filter
    • Using system categories for filtering
    • Custom Filter
  • Templating
    • Use your own CSS
    • Use your own templates
    • Searchbox on every page
    • Images
    • Template Selector
    • Custom values in the search result list
    • Link view helper
    • Render filters in result list
  • Configuration
    • Additional word characters
    • Allow only ke_search records on a page
    • Avoid 404 error from cacheHash validation
    • Highlighted Word
    • TypoScript and FlexForm settings
    • Override record storage page (Startingpoint)
    • Reduce filters shown in the backend
    • Routing (Speaking URLs)
    • Search word length
    • Change the search word parameter
    • Sorting
    • Storage Engine
  • Multilangual support
  • Search behaviour
    • Search options
    • Ranking / Sorting
    • Stopwords
  • Statistics
    • Statistics using Google Analytics
    • Statistics using Matomo
  • Hooks and Events
  • Logging
  • Command line tools
  • Changelog
  • Premium version
  • Sitemap
  1. Faceted Search
  2. Templating
  3. Link view helper
Give feedback Edit on GitHub

Link view helper

A link view helper is provided to generate links to search result pages including a search word and filters.

Parameters

  • page (integer): Target page
  • piVars (array): pivars (sword, filter[...], page, sortByField, sortByDir, resetFilters)
  • resetFilters (array): Filters to reset
  • keepPiVars (boolean): Should the piVars be kept?
  • uriOnly (boolean): Returns only the uri.
  • section (string): Anchor for links

Additionally the standard HTML universal attributes can be used (like class, dir, id, lang, style, title, accesskey, tabindex, onclick).

Setting filters

In order to use filters with the link view helper you will need to know the filter UID, the tag of the filter option and (if you use a checkbox filter) the UID of the filter option. Please see the example below.

Example

<html xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers"
      xmlns:kesearch="http://typo3.org/ns/Tpwd/KeSearch/ViewHelpers"
      data-namespace-typo3-fluid="true">

<ul>
   <li><kesearch:link page="85" piVars="{sword: 'elephants'}" class="my-link-class">Search for elephants</kesearch:link></li>
   <li><kesearch:link page="85" piVars="{filter_13: 'page'}" class="my-link-class">Show all pages</kesearch:link></li>
   <li><kesearch:link page="85" piVars="{sword: 'elephants', filter_13: 'page'}" class="my-link-class">Search for elephants in pages</kesearch:link></li>
   <li><kesearch:link page="85" piVars="{sword: 'elephants', filter_13: 'page', filter_3_278: 'syscat92'}" class="my-link-class">Search for elephants in pages and use a checkbox filter</kesearch:link></li>
</ul>

</html>
Copied!
  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Issues
  • Repository

Last rendered: May 02, 2025 09:07

© since 2011 by ke_search Dev Team
  • Legal Notice
  • Privacy Policy