Difference between revisions of "Reference:BlueSpiceRating"

{{BSExtensionInfoboxBSExtensionInfo
        
        |desc=Enables enables users to rate articles an article with up to five stars or to recommend the article.
            
            
        |status=stable
        
        |developer=HalloWelt
        
        |type=BlueSpice
        
        |edition=BlueSpice pro
            
            |active=Yes
            
            |compatible=BlueSpice
            
            |package=RatedComments
            
            |category=Communication
            
            }}
            
            __TOC__
            
            
            
            ==Description==
            
            
            
            '''Rating''' enables to rate articles , 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. 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 can rate as often as wants. 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]].
            
            
            
            [[Image:BlueSpice-rating.png|thumb|none|400px|Screenshot: Display of the average evaluation and the number of assessments next to the article title]]
            
            
            
            [[Image:BlueSpice-rating-Statusbar.png|thumb|none|400px|Screenshot: Display of the average evaluation and the number of assessments in the StateBar]]
            
            
            
            ==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 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|700px|Screenshot: View your own assessment in the StateBar details]]
            
            
            
            ==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|700px|Screenshot: Overview of all evaluations on the special page]]
            
            
            
            ==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.
            
            
            
            ==Admin information==
            
            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.
            
            
            
            [[de:{{FULLPAGENAME}}]][[en:{{FULLPAGENAME}}]]
            
            [[Category:Extension]]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. 
            
            
            
            
            
            }}