Difference between revisions of "Reference:BlueSpiceRating"
m (1 revision: Migration) |
(Tag: 2017 source edit) |
Extension: BlueSpiceRating
Overview | |||
---|---|---|---|
Description: | Provides a rating system | ||
State: | stable | Dependency: | BlueSpice |
Developer: | HalloWelt | License: |
GPL-3.0-onlyProperty "BSExtensionInfoLicense" (as page type) with input value "</br>GPL-3.0-only" contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process. |
Type: | BlueSpice | Category: | Communication |
Edition: | BlueSpice pro, BlueSpice Farm, BlueSpice Cloud | ||
Features
BlueSpiceRating enables users to rate a wikii page with up to five stars
or to recommend the page. In the Namespace manager, wiki administrators can configure in which namespaces ratings or recommendations should be activated.
Rating
Users select a number of stars to provide their rating. Users can change their assessment at any time, by choosing less or more stars. The average evaluation
as well as the number of assessments
are displayed.
If a user rates the page multiple times, only the first assessment is counted. Subsequent ratings only change the average evaluation, but not the number of assessments.
The feature is placed right at the article. There are two possibilities where it can be placed: next to the article title or in the StateBar.


Features of Rating[edit | edit source]
Rating is a star rating system with up to five stars. You can award an article by hovering over the stars with your pointer. The stars will fill with colour, depending on which star you are pointing. Depending on how much stars you want to give, just click on the appropriate star to confirm your rating. This means that the assessment will be counted in the number of assessments and also contributes to the average evaluation.
This proceeding can be repeated at will. After the first rating, the following assessments will not be counted as a new evaluation.
If the rating tool is positioned in the StateBar, you can also view your assessment for the article in addition to the average evaluation and the number of all assessments for the article. Open the details of the StateBar and your rating is displayed there.

Summary of Evaluations[edit | edit source]
There is a special page Special:Ratings
where you can find an overview of all evaluations, which have been made in your wiki. Every column of this listing can be sorted ascending or descending.

Further Information[edit | edit source]
You can also exclude pages from the rating system. The tool won´t be shown on this pages. You can do this with a so called "Behaviour Switch". The switch must be inserted in the article, to avoid the display of the rating tool. Just insert in the code of the wiki article. Informationen für Administratoren[edit | edit source]To define at which position the star rating should be shown, go to the admin preferences. You can find them in the main navigation tab "Admin" at the menue item "Preferences". Fold out the menues "BlueSpice" and BlueSpice - MediaWiki settings" there. You can find the menue for ratings there.
You can choose between Article title and Status bar, to define whether to display the star symbols next to the title or in the StatusBar. In addition to this, you can configure in which namespaces the rating system should be activated. Just choose the namespaces in the drop down menue. For choosing more than one, hold the ctrl button and click on the namespaces you need.
Recommendation
Users click on a recommendation link to make the recommendation. Users can change their assessment at any time by recommending the page or by retracting their recommendation.
If a user recommends the page multiple times, only one recommendation is counted.
Technical Information[edit source]
This information applies to BlueSpice 3 . Technical details for BlueSpice cloud can differ in some cases.
Requirements[edit source]
- MediaWiki: 1.31
- BlueSpiceFoundation: 3.2
Integrates into[edit source]
- BlueSpicePrivacy
- BlueSpiceRating
Special pages[edit source]
- Rating
- Recommendations
Permissions[edit source]
Name | Description | Role |
---|---|---|
rating-archive | Remove votes from pages | admin, editor, maintenanceadmin |
rating-read | Read ratings on pages | admin, commenter, editor, maintenanceadmin, reader |
rating-viewspecialpage | View pages which are protected with the "Rating-Viewspecialpage" right | admin, editor, maintenanceadmin, reader |
rating-write | Vote on pages | author, commenter, editor, maintenanceadmin |
Configuration[edit source]
Name | Value |
---|---|
RatingArticleEnabledNamespaces | array ( ) |
RatingArticleLikeEnabledNamespaces | array ( ) |
API Modules[edit source]
- bs-rating-tasks
- bs-ratingarticle-store
- bs-ratingarticlelike-store
Hooks[edit source]
- BSApiNamespaceStoreMakeData
- BSMigrateSettingsFromDeviatingNames
- BSMigrateSettingsSetNewSettings
- BeforePageDisplay
- GetDoubleUnderscoreIDs
- LoadExtensionSchemaUpdates
- NamespaceManager::editNamespace
- NamespaceManager::getMetaFields
- NamespaceManager::writeNamespaceConfiguration
- SkinTemplateOutputPageBeforeExec
__NOTOC__ The extension Rating enables you to rate articles {{BSExtensionInfo |desc=enables users to rate an article with up to five stars. The user can change his assessment at any time, by choosing less or more stars. The average evaluation, as well as the number of assessments, are displayed. The user can change his assessments at any time, because you can rate as often as you want. Only the first assessment counts. The others only change the average evaluation, but not the number of assessments. ==Where do I find Rating?== The feature is placed right at the article. There are two possibilities where it can be placed: next to the article title or in the [[StateBar|StateBar]]. [[Image:BlueSpice-rating.png|thumb|none|Screenshot: Display of the average evaluation and the number of assessments next to the article title|400px]] [[Image:BlueSpice-rating-Statusbar.png|thumb|none|Screenshot: Display of the average evaluation and the number of assessments in the StateBar|400px]] ==Features of Rating== Rating is a star rating system with up to five stars. You can award an article by hovering over the stars with your pointer. The stars will fill with colour, depending on which star you are pointing. Depending on how much stars you want to give, just click on the appropriate star to confirm your rating. This means that the assessment will be counted in or to recommend the article. |status=stable |developer=HalloWelt |type=BlueSpice |edition=BlueSpice pro, BlueSpice Farm, BlueSpice Cloud |compatible=BlueSpice |category=Communication |license=GPL v3 only |features='''BlueSpiceRating''' enables users to rate a wikii page with up to five stars or to recommend the page. In the [[Reference:BlueSpiceNamespaceManager{{!}}Namespace manager]], wiki administrators can configure in which namespaces ratings or recommendations should be activated. ===Rating=== Users select a number of stars to provide their rating. Users can change their assessment at any time, by choosing less or more stars. The average evaluation as well as the number of assessments and also contributes to the average evaluation.<br /> This proceeding can be repeated at will. After the first rating, the following assessments will not be counted as a new evaluation. If the rating tool is positioned in the StateBar, you can also view your assessment for the article in addition to the average evaluation and the number of all assessments for the article. Open the details of the StateBar and your rating is displayed there. [[File:BlueSpice-rating-StatusBar_en.png|thumb|none|Screenshot: View your own assessment in the StateBar details|700px]] ==Summary of Evaluations== There is a special page <code>Special:Ratings</code> where you can find an overview of all evaluations, which have been made in your wiki. Every column of this listing can be sorted ascending or descending. [[File:BlueSpice-rating-Specialpage.png|thumb|none|Screenshot: Overview of all evaluations on the special page|700px]] ==Further Information== You can also exclude pages from the rating system. The tool won´t be shown on this pages. You can do this with a so called "Behaviour Switch". The switch must be inserted in the article, to avoid the display of the rating tool. Just insert <code>__NORATING__</code> in the code of the wiki article. ==Informationen für Administratoren== To define at which position the star rating should be shown, go to the admin preferences. You can find them in the main navigation tab "Admin" at the menue item "Preferences". Fold out the menues "BlueSpice" and BlueSpice - MediaWiki settings" there. You can find the menue for ratings there. You can choose between Article title and Status bar, to define whether to display the star symbols next to the title or in the StatusBar. In addition to this, you can configure in which namespaces the rating system should be activated. Just choose the namespaces in the drop down menue. For choosing more than one, hold the ctrl button and click on the namespaces you need.are displayed. If a user rates the page multiple times, only the first assessment is counted. Subsequent ratings only change the average evaluation, but not the number of assessments. ===Recommendation=== Users click on a recommendation link to make the recommendation. Users can change their assessment at any time by recommending the page or by retracting their recommendation. If a user recommends the page multiple times, only one recommendation is counted. }}
(36 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{BSExtensionInfo | ||
+ | |desc=enables users to rate an article with up to five stars or to recommend the article. | ||
+ | |status=stable | ||
+ | |developer=HalloWelt | ||
+ | |type=BlueSpice | ||
+ | |edition=BlueSpice pro, BlueSpice Farm, BlueSpice Cloud | ||
+ | |compatible=BlueSpice | ||
+ | |category=Communication | ||
+ | |license=GPL v3 only | ||
+ | |features='''BlueSpiceRating''' enables users to rate a wikii page with up to five stars or to recommend the page. | ||
+ | In the [[Reference:BlueSpiceNamespaceManager{{!}}Namespace manager]], wiki administrators can configure in which namespaces ratings or recommendations should be activated. | ||
+ | ===Rating=== | ||
+ | Users select a number of stars to provide their rating. Users can change their assessment at any time, by choosing less or more stars. The average evaluation as well as the number of assessments are displayed. | ||
− | + | If a user rates the page multiple times, only the first assessment is counted. Subsequent ratings only change the average evaluation, but not the number of assessments. | |
− | + | ===Recommendation=== | |
+ | Users click on a recommendation link to make the recommendation. Users can change their assessment at any time by recommending the page or by retracting their recommendation. | ||
− | + | If a user recommends the page multiple times, only one recommendation is counted. | |
− | |||
− | |||
− | + | }} | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |