Text Search and Rating

Text Search for Community-generated Content


Text search is a custom feature that can be made available on EFS Panel installations with EFS 9.1 or higher. It requires special programming. Furthermore, the Panel installation must meet special system requirements.

If you are interested in using custom text search, please get in touch with the support.

Text search enables panelists to search the panel news and community-generated content. The functional scope in brief:

  • Text search covers the content of news, blogs, forums, discussions and download lists. Optionally, you can restrict the scope to any of these content types.
  • The search syntax is familiar from web search tools. I.e. panelists can use the commands intuitively.
  • Optionally, you can allow the panelists to select the content types to be searched.
  • If only one content type is searched, all results will be displayed in a paginated list. If several content types are searched, the most relevant results will be displayed in a summary. Via dedicated links, the panel members can access paginated lists of all results.
  • The results lists are automatically restricted to content which the searching panelist is authorized to see.
  • The search function is integrated into the website editor.

Work steps

Setting up content search involves the following steps:

  • Defining the scope of the search feature and the length of the results lists for the entire panel installation.
  • Setting up a search page with search form and results list.
  • Creating a search form and inserting it into the panelists’ side-bar navigation on the desired page(s).


Please make sure that both the search page and the pages with the content to-besearched are shown in the navigation for anybody who’s allowed to access them.

Search stringResult
peaceResult which contains: peace OR Peace OR PEACE
peace*Result which contains: peace OR peacemaker
+peace +warResult which contains: peace AND war
+peace -warResult which contains: peace AND doesn‘t contain: war
peace agreementResult which contains: peace agreement OR agreement of peace
„peace agreement“Result which contains exactly: peace agreement

Words with three or less letters are ignored.

A list of common words is ignored. For details, please check out:

http://dev.mysql.com/doc/refman/5.1/en/fulltext--? stopwords.html

Integrating Text Search into the Website

To set up a search page, please proceed as follows:

  1. On the desired page, create a page module of the “Search for text in modules” type.
  2. Configure the setting options as required.
    – Select the “func_search” module template. You may have to adapt the templates to the layout of your panel.
    – Keep the “Template for media display” field empty.
    – The other options are the same as the options in the menu Global configuration, but specific to this module and restricted to the maximum scope you defined in Global configuration.

To create a search form for the side-bar navigation, please proceed as follows:

  1. On the „GLOBAL“ page dedicated to referenced content, create a page module of the “Form for text search in modules” type.
  2. Configure the setting options as required.
    – Select the “func_searchform” module template. You may have to adapt the templates to the layout of your panel.
    – Keep the “Template for media presentation” field empty.
    – In the “Display results using” drop-down list, select the search page created in the previous chapter.
  3. Reference the GLOBAL module from all pages on which the side-bar navigation is used, as e.g. “My home”.

Rating of Community Contents

You can allow your panelists to rate not only other panelists, but contents as well.

  • You can enable your panelists to rate forum and discussion posts, blog posts and entire individual blogs.
  • There is a uniform rating system, i.e. a scale, for each installation. Various predefined scales are available.
  • EFS 10.3 includes new scales for “Like” and “Like and dislike”, symbolized by thumbs showing up- or downwards.
  • The panelists can usually see their own ratings and the resulting average ratings. When using scales with positive values, the values can optionally be represented by stars.
  • In the admin area and in the export you will find the number of performed ratings and the resulting average rating.
  • From EFS 10.3, rating data are integrated into the panel tracking. Furthermore, the rating data have been made available for grouping filters. Thus, it is now possible e.g. to create a group of very active or influential community members.

Work steps

In order to use the rating function, please proceed as follows:

  • Configure the rating function.
  • Integrate the rating function into the website.

The necessary operations will be explained in detail in the following chapters.

Configuring the Rating Function

The rating function is configured in the “Rating settings” section of the Website → Global configuration menu:

  • In the field “Rating scale”, one of the available scales can be selected.
    – It is not possible to create additional scales or change the predefined scales.
    – The display of the scale on the website is controlled via the template “tpl_rating”. By default, values on purely positive scales are represented by stars. Scales with negative values show numbers. “Like” and “Like and dislike”, newly introduced in EFS 10.3, are symbolized with thumbs showing up- or downwards.
  • Panelists are allowed to change their ratings: With this option you define whether the panelists are allowed to change ratings subsequently.
  • From EFS 10.3: Panelists are allowed to revoke their ratings: You can specify whether the panelists are allowed to revoke their ratings.


It is possible to subsequently switch to another scale in an active panel: The system will then recalculate all existing ratings. Please note, however:

  • A subsequent change may lead to questions and misunderstandings among the panelists.
  • If you have exported rating data, the export data will be different from the recalculated values.

Integrating the Rating Function into the Website

The rating function is implemented by default. Therefore, only the following minor modifications are usually necessary:

  • If you want to use any symbols other than stars, you can simply replace the file.
  • You may have to adapt the rating template to the layout of your panel.

Adapting the rating symbol

The star symbol for the rating scale is defined by the image star_rate.png located in the “\images” file of the Asset library → tab Panel assets: It contains the star in three different hues.

If you wish to use a different symbol, create an image in PNG format of the same name, size and structure. Upload this image to your “\images” file so that the default image is overwritten, or simply rename the default image.

If you have to use a symbol of different size, this requires further adjustments:

  • The image is inserted as a background image via the CSS class “.star-rating” in the include “css_default”.
  • You may have to adjust the size in the templates “tpl_rating_...”.

Adapting the rating template to the panel layout

The display of the rating functions is largely controlled via the templates “tpl_rating_...”. These template may have to be adapted to the overall layout of your panel.

Viewing, Using and Exporting Rating Data

Two values are recorded as the result of the rating: the number of ratings and the average rating.

These values are usually displayed on the website right next to the rated contents. In the admin area, you can also view the results in the following places:

  • Forum, discussion or blog posts: in the respective post overview.
  • Ratings of blogs: in the blog overview

The corresponding exports also contain the rating results.

  • Number of ratings: Export variable “rating_count”
  • Average rating: Export variable “rating_average”

From EFS 10.3, rating data are integrated into the panel tracking. Furthermore, they have been made available for grouping filters. Thus, it is now possible e.g. to create a group of very active or influential community members.

Tagging and Categorization of Community Content

From EFS 10.5, it is possible to tag or categorize community content.

  • Categories allow to group posts and threads. Thus, panelists can select meaningful topical clusters for their content, and for administrators, it is easier to keep track of the community content.
  • Tagging is available, too. Tags simplify search for the created content, they are not hierarchical.

Both categories and tags can be assigned to blog posts, forum threads and discussion posts.


If your panel is upgraded from an earlier version to EFS 10.5, manual modifications of the templates may be necessary to integrate the new tagging functonality completely into the website.

  • Several new templates are added automatically.
  • If blog, discussion and forum templates are used without customization in your panel, the enhancements for tagging will be inserted automatically. Otherwise, a manual modification is necessary.

Using Categorization

Categories are specified by the administrator in the tagging browser: menu Website → Classifications → tab Categories.

  • Categories can be grouped.
  • You can assign a color and meta data to each category.

  • Categories are specified by the administrator, therefore, this feature is always active.

The panelists select the appropriate categories for their content.

Activating and Configuring Tagging

For tags, the panel administrator can decide whether to allow the usage or not, and which conditions should apply. The respective options can be found in the menu Website → Global configuration.

Using Tagging

The panelists themselves create the tags themselves, when writing blog posts, forum threads and discussion posts.

Administrators can access all tags created by the panelists via the tagging browser in the menu Website → Classifications → tab Tags.

  • They can delete or block (i.e. blocklist) tags.
  • Two tags with the same meaning can be merged. E.g. all posts with the tag “product” and “products” can be merged into “products”.

Denying Use of Tagging for Specific Panelists

The panel administrator can block specific panelists from using the tagging feature.

For this purpose, in the panelist’s detail view in Panelist administration, go to the section “Permissions” and flag “Not allowed to tag content”.

Leaderboard

A leaderboard can be used to present the best, most active panelists. Thus, you can increase motivation and engagement in your community.

  • A specific panel group can be specified as basic set.
  • The number of listed panelists can be defined.
  • The selection criterion can be chosen from a variety of data, as e.g. date of entry, number of bonus points, average rating the panelist received for community content etc.

The new leaderboard is made available in addition to the existing leaderboard, with its own dedicated function module and its own template. Existing templates are not modified.


Usually, first name and last name of the panelists are displayed, assuming that profile visibility  is configured accordingly. If visibility for both first and last name is deactivated or “Show profile to others” switched of in principle, the default text “withheld” will be displayed.

Integrating the Leaderboard into the Website

In order to set up the leaderboard, please proceed as follows:

  1. On the desired page, create a page module of the “Leaderboard2” type.
  2. Select the “func_leaderboard2” module template or „func_leaderboard2_light“ for a sidebar integration.
  3. Configure the setting options as required.

Table-Based Leaderboard

Since EFS 10.0, a first, table-based version of the leaderboard has been available. It includes three rankings. The length of the lists can be configured as desired.

  • All Time: Overall number of bonus points the panelists collected.
  • Accumulated: Current number of bonus points.
  • Stars: Virtual points awarded by other panelists in the chosen social currency of the panel.

Integrating the Leaderboard into the Website

In order to set up the leaderboard, please proceed as follows:

  1. On the desired page, create a page module of the “Leaderboard” type.
  2. Select the “func_leaderboard” module template.
  3. Configure the setting options as required.


Topics

© 2024 Tivian XI GmbH