Skip to main content
Skip table of contents

User Guide for Canned Search for Confluence 1.2.0


Installation


By Upload

  1. Download the latest version from Marketplace
  2. Go to Add-ons page
  3. Click on Upload add-on
  4. Select the .jar file
  5. Click Upload
  6. The Canned Search for Confluence should be installed
  7. Click on Free trial or Buy now to configure and start using

By Searching in Atlassian Marketplace

  1. Go to Find new add-ons
  2. Search for Canned Search for Confluence in the search field
  3. Click Free trial or Buy now to install, configure and start using

*Canned Search for Confluence offers a free trial for 30 days. Thereafter, a license key is required in order to use the plugin.

Configuration


Configuration Settings

Field NameRequiredDefault ValueExplanation
CQL
(tick)

Enter a CQL statement with $$query$$ as the search term.
Hide Filenames in Excerpts
Unchecked

The files names are removed from excerpt when checked.

Please view Excerpt when filenames are removed for more information.

Default Query Term

Enter a default query term to replace the $$query$$ in CQL.
Search results will be preloaded if it is provided.
No. of Results per Page
(tick)
10

Select the no. of results to be displayed:

  • 5 — Pagination will occur if there are >5 search results
  • 10 — Pagination will occur if there are >10 search results
  • 50 — Pagination will occur if there are >50 search results
  • 100 — Pagination will occur if there are >100 search results

If there are more results than the selected no. of results to display, pagination will occur.

Features


Search Results with Pagination

Without Pagination

With Pagination



Remove Image filenames from Returned Results 

This feature is available from version 1.2.0 onwards.

User now has a choice to remove filenames which have been attached to the page as images from their Except.


You may want to hide the filenames if:

  • The filenames shown in search result provides no useful information when shown to user
  • Filenames are just placeholders for images and readers complains that such placeholders affect their ability to read excerpts smoothly

Uncheck

Hide filenames in Excerpt

(Default)

Check

Hide filenames in Excerpt

Steps

  1. From Confluence Edit Page, edit the CQL Macro which you wish to hide images filenames in the Excerpt.
  2. Check Hide Filesnames in Excerpt
  3. Save Macro

Limitations

  • If the filename contains a space (e.g. Canned Search.png), at it happens to be cut due to excerpt character limit, half of the file name (e.g. Canned...) will be present in the result excerpt
  • If a text e.g."file name.png" is added in the contents of the page, but has no such image being attached to the page, the String "file name.png" will not be removed from the excerpt.



Search Results and Warnings

No Results Found

When Empty Query Parameters are Entered

Syntax Error in CQL
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.