searchfn
searchfn templating functions allow you to search pages - or more
generally content - returning collections of
ContentMap
objects.
The results are sorted by jcr:score(), descending. A text excerpt may
be available in the returned ContentMap depending on how Jackrabbit
search is configured. Magnolia checks the current user’s permissions
before adding a result to the collection.
Searching pages
The searchPages function searches pages for a given query string and
start path. This function searches only nodes of type mgnl:page in the
website JCR workspace, not all types of content. The returned items of
the collection are of type ContentMap. Use this function with the
mandatory arguments if you want to render the results with pagination.
Method signature
Collection<``ContentMap> searchPages(String queryString, String startPath)
Collection<``ContentMap> searchPages(String queryString, String startPath, long limit, long offset)
Arguments
| Argument | Description |
|---|---|
|
required The search term such as |
|
required Absolute path in the website workspace such as |
|
optional The maximal number of items to be returned. Use together with |
|
optional The offset ( |
Usage
searchfn.searchPages('foo', '/somepath') or
searchfn.searchPages('foo', '/somepath', 10, 21)
[#assign searchResults = searchfn.searchPages('hello', '/home') /] [#if searchResults?has_content] [#list searchResults as item] <a href="${cmsfn.link(item)}"> <h4>${item.title!}</h4> <p>${item.excerpt!}</p> </a> [/#list] [/#if]
Searching all content
The searchContent function searches all content for a given query
string, start path and node type in any workspace. If you don’t specify
a node type the function searches for the most basic type nt:base. The
returned items of the collection are of type ContentMap. Use this
function with the optional arguments (limit, offset) if you want to
render the results with pagination.
Method signature
Collection<``ContentMap> searchContent(String workspace, String queryString, String startPath, String returnItemType)
Collection<``ContentMap> searchContent(String workspace, String queryString, String startPath, String returnItemType, long limit, long offset)
Arguments
| Argument | Description |
|---|---|
|
required The name of the workspace to search in. |
|
required The search term such as |
|
required Absolute path in the specified workspace such as |
|
required The node type. |
|
optional The maximal number of items to be returned. Use together with |
|
optional The offset ( |
Usage
searchfn.searchContent("website", "Ansel Adams", "/home", "mgnl:component")
searchfn.searchContent("dam", "jpg", "/photos", "mgnl:asset", 10, 0)
[#assign searchResults = searchfn.searchContent("website", "Ansel Adams", "/home", "mgnl:component") /] [#if searchResults?has_content] [#list searchResults as item] [#if item.quotation??] <div class="found-component"> ${item.quotation} </div> [/#if] [/#list] [/#if] [source] ---- ---- [#assign searchResults = searchfn.searchContent("dam", "Christoph Meier", "/photos", "") /] [#if searchResults?has_content] [#list searchResults as item] [#if item.publisher??] ${item.publisher} - [#assign myAsset = damfn.getAsset("jcr", cmsfn.asJCRNode(item).getPath())!] [#assign url=damfn.getRendition(myAsset, "small-square").getLink()] <img src="${url}"/> [/#if] [/#list] [/#if]