Another example: Using the standard search, a user would search for something like [wetland + "dc.author=Mitsch, William J" + dc.subject="water quality" ]. With filtered search, they can start by searching for [wetland ], and then filter the results by the other attributes, author and subject.
What is a tag cloud facet
Tag cloud facet is another way to display facets of your repository in a “tag cloud” form in which the importance of each tag is show with font size or color. This format is useful for quickly perceiving the most prominent terms.
This is a classic “tag cloud” facet in a DSpace repository.
- Sidebar browse facets that can be configured to use contents from any metadata field
- Dynamically generated timespans for dates
- Customizable "recent submissions" view on the repository homepage, collection and community pages
- Hit highlighting & search snippets
However, the tag cloud facet feature is disabled by default. In order to enable it, you will need to set up the corresponding processor that the PluginManager will load to actually perform the tag cloud query on the relevant pages. This is configured in the dspace.cfg configuration file with the following options:
The tag cloud has been declared there for you but it is commented out.
Because Discovery was adopted as the default infrastructure for search and browse in DSpace 4, no manual steps are required to enable Discovery. If you want to enable Discovery on older versions of DSpace, please refer to the DSpace documentation for that particular version.
Defines the mapping between separate Discovery configurations and individual collections/communities
All communities, collections and the homepage (key=default) are mapped to defaultConfiguration
Groups configurations for sidebar facets, search filters, search sort options and recent submissions
There is one configuration by default called defaultConfiguration
Defines that specific metadata fields should be enabled as a search filter
dc.title, dc.contributor.author, dc.creator, dc.subject.* and dc.date.issued are defined as search filters
Defines which metadata fields should be offered as a contextual sidebar browse options, each of these facets has also got to be a search filter
dc.contributor.author, dc.creator, dc.subject.* and dc.date.issued
Defines which metadata fields contain hierarchical data and should be offered as a contextual sidebar option
Further specifies the sort options to which a DiscoveryConfiguration refers
dc.title and dc.date.issued are defined as alternatives for sorting, other than Relevance (hard-coded)
Defines which metadata fields can contain hit highlighting & search snippets
dc.title, dc.contributor.author, dc.subject, dc.description.abstract & full text from text files.
|Purpose:||Defines the tag cloud appearance configuration bean and the search filter facets to appear in the tag cloud form. You can have different “TagCloudFacetConfiguration” per community or collection or the home page|
In addition to the summarized descriptions of the default values, following details help you to better understand these defaults. If you haven't already done so, download the configuration file and review it together with the following parameters.
The file contains one default configuration that defines following sidebar facets, search filters, sort fields and recent submissions display:
- The list of applicable sidebarFacets
- The list of applicable searchFilters
- The list of applicable searchSortFields
- Any default filter queries (optional)
- The configuration for the Recent submissions display
- The configuration of the tag cloud facet
Configuring lists of sidebarFacets and searchFilters
Customizing the “Tag Cloud” facet
This paragraph only applies to JSPUI
<!-- Set TagCloud configuration per discovery configuration --> <property name="tagCloudFacetConfiguration" ref="defaultTagCloudFacetConfiguration"/>
Declare the bean (of class: TagCloudFacetConfiguration) that holds the configuration for the tag cloud facet.
<!--TagCloud configuration bean for homepage discovery configuration--> <bean id="homepageTagCloudFacetConfiguration" class="org.dspace.discovery.configuration.TagCloudFacetConfiguration"> <!-- Actual configuration of the tagcloud (colors, sorting, etc.) --> <property name="tagCloudConfiguration" ref="tagCloudConfiguration"/> <!-- List of tagclouds to appear, ove for evry search filter, one after the other --> <property name="tagCloudFacets"> <list> <ref bean="searchFilterSubject" /> </list> </property> </bean>
This bean has two properties:
- tagCloudConfiguration: is the bean that described the actual appearance parameters
- tagCloudFacets: the search filter facets that will be used for the tag cloud. If you leave the list empty, no tag cloud will appear. If yu declare more than one, equal number of tag cloud will appear for each search filter the one after the other.
The appearance configuration can have the following properties, as shown in the following bean:
<bean id="tagCloudConfiguration" class="org.dspace.discovery.configuration.TagCloudConfiguration"> <!-- Should display the score of each tag next to it? Default: false --> <property name="displayScore" value="true"/> <!-- Should display the tag as center aligned in the page or left aligned? Possible values: true | false. Default: true --> <property name="shouldCenter" value="true"/> <!-- How many tags will be shown. Value -1 means all of them. Default: -1 --> <property name="totalTags" value="-1"/> <!-- The letter case of the tags. Possible values: Case.LOWER | Case.UPPER | Case.CAPITALIZATION | Case.PRESERVE_CASE | Case.CASE_SENSITIVE Default: Case.PRESERVE_CASE --> <property name="cloudCase" value="Case.PRESERVE_CASE"/> <!-- If the 3 CSS classes of the tag cloud should be independent of score (random=yes) or based on the score. Possible values: true | false . Default: true--> <property name="randomColors" value="true"/> <!-- The font size (in em) for the tag with the lowest score. Possible values: any decimal. Default: 1.1 --> <property name="fontFrom" value="1.1"/> <!-- The font size (in em) for the tag with the lowest score. Possible values: any decimal. Default: 3.2 --> <property name="fontTo" value="3.2"/> <!-- The score that tags with lower than that will not appear in the rag cloud. Possible values: any integer from 1 to infinity. Default: 0 --> <property name="cuttingLevel" value="0"/> <!-- The distance (in px) between the tags. Default: 5 --> <property name="marginRight" value="5"/> <!-- The ordering of the tags (based either on the name or the score of the tag) Possible values: Tag.NameComparatorAsc | Tag.NameComparatorDesc | Tag.ScoreComparatorAsc | Tag.ScoreComparatorDesc Default: Tag.NameComparatorAsc --> <property name="ordering" value="Tag.NameComparatorAsc"/> </bean>
When tagCloud is rendered there are some CSS classes that you can change in order to change the tagcloud appearance.
|tagcloud||General class for the whole tagcloud|
|tagcloud_1||Specific tag class for tag of type 1 (baed on score)|
|tagcloud_2||Specific tag class for tag of type 2 (baed on score)|
|tagcloud_3||Specific tag class for tag of type 3 (baed on score)|
Discovery Solr Index Maintenance