Configure Ratings column to use the 5-Star rating scale

Configure Ratings column to use the 5-Star rating scale

Overview of Rating configuration settings

Ratings_Grid.pngWhen 5-Star is selected as the scale for the Rating Column the ratings statistics available to users will be determined by your selection of :

  • Current User Rating vs Average Rating

    &

  • Authenticated vs Anonymous ratings
    Return to the Overview of Ratings configuration for more information on Anonymous Ratings

The following steps require you to have accessed the New Column settings screen and selected Bamboo Rating as the column type.

Rating_Star_Config.pngThe above image has been edited to better represent the configuration options

1. Click the 5-Star radio button under Rating Scale Size


2. Select the Star Skin from the drop down menu. The selected color schema will be visible in the preview section


3. By default, users rate content using whole stars. To change this setting click Allow Half-Star Ratings


4. The selections under Stars will display determine what stars represent to users:
Current User Rating:

  • Displays shaded stars representing the authenticated users rating.

  • If the user has not rated the content, or if Allow Anonymous Rating is selected, the rating stars will display without shading.

  • The Current Rating Average will be displayed next to the stars as text

Average Rating:

  • Stars will be shaded to reflect the Current Rating Average on page load.

  • Current Rating Average text is not displayed.

Users will see their current rating, the average rating, and the total number of ratings submitted as tooltip text when they mouse over the icons.


5. If Current User Rating was selected as the Star display mode, use the drop down selector to define how many decimal places between 0 -5 will be displayed.

NOTE: The selector will be hidden if Average Rating was selected as the Star display mode.

Overview of Rating configuration settings

Configure Rating Column to use True/False scale

Configure Rating Column to use True/False scale

Overview of Rating Column configuration screen

Image of True/False resultsWhen the Rating Column is configured to use the True/False rating scale, the following rating statistics will be displayed:

  • The current Overall Rating Percent
    (Positive Vote % – Negative Vote %)

  • True/False tool tip with the following information:

    • Overall Rating Percent
    • Positive Response Statistic
    • Negative Response Statistic
    • Total Ratings Submitted

The following steps require you to have accessed the New Column settings screen, and selected Bamboo Rating as the column type.

Expanded image of the configuration options available when the True/False radio button is selected
The above image has been edited to better represent the configuration options.

1. Click the True/False radio button.


2. Select an Identification Type from the drop down menu.

  • Thumbs Up/Thumbs Down Ratings_TF2.png

  • Green Checkmark/Red X

  • Words (Action buttons with customizable text for the Positive and Negative labels.)


3. Enter the text to be displayed when users mouse over each icon in the Positive and Negative labeled fields.

NOTE: If the Words Identification Type is selected, these values will appear on the buttons.
Example : Yes and No

Localize Bamboo Applications or Custom Columns

Localize Bamboo Applications or Custom Columns

Overview of the localization process for Bamboo Products

Bamboo applications and custom columns are slightly different than web parts when it comes to localizing/translating. The user interface isn’t confined to a web part, but can exist as site definitions or other custom pages. For example, the configuration of a Bamboo custom column is within the SharePoint list settings area.
The text strings that require translation are located in different files than the strings that appear in a web part.

Changing the language or text for an application or custom column is a multi-step process:

Top

About the Language Files

Text displayed in a Bamboo application may be included in one or both of the following locations:

  • Provisioning Resources. These resources are located in the 12, 14, or 15 “Hive”, in the Resources folder. The number of the Hive depends on the version of SharePoint you are using (e.g., SP2007 has a 12 Hive, SP2010 has a 14 Hive, and SP2013 has a 15 Hive). 14Hiveresources.jpg

    The Bamboo.*.resx files include text used in site features, site definitions, list definitions, and other provisioning resource elements. Any changes you make in these files will apply to new product instances only.

  • Application/Runtime Resources. These are also located in the 12, 14, or 15 Hive, but in the CONFIGResources folder.The Bamboo.*.resx file in the CONFIG folder is different than the one included in the Resource folder.14HiveCONFIGResources.jpg This one includes text used in application pages, custom site menu actions, navigation elements, and other runtime resources. Any changes you make will apply to new and existing product instances only.

In each location, there may be multiple versions of Bamboo.*.resx files with identical content. The different files are provided for English (en-US), German (de-DE), French (fr-FR), and Spanish (es-ES). The content of all files is in English until you translate it to your language. If your site is configured to use a language that does not have a corresponding Bamboo product .resx file, copy an existing file and rename it to include the culture name for that language pack. For example, create a file for Italian by saving the default file as Bamboo.[Product].it-IT.resx. Make your changes to this new file. If your site is configured to use a specific language but you do not have a culture-specific file, the product will use the default Bamboo.[Product].resx file instead.

Icon-WarningIMPORTANT: If you customize one of the default resource files provided with the product, your changes will be overwritten when you upgrade.

To avoid losing customizations, copy the customized file to a different location (not the same folder) before upgrading. After the upgrade is finished, compare the new file with your customized file to incorporate any new entries. Then copy the merged file to the Resources folder. Culture-specific files created for languages that are not provided with the product will not be overwritten during an upgrade, but you still need to incorporate new resource entries.

Top

Editing text in resource files

Icon-WarningIMPORTANT: Before making any changes, back up your original file to a different folder.

To change text in a resource file, open it in a text editor and locate the text you want to change. Editable text is usually found between the <value></value> tags, as shown in the screen shot below. Do not modify the data tag. If you want to remove text completely, delete only the text; do not delete the <data> or <value> entries from the file, or the server will display an error message. In the example below, the editable text is highlighted in gray.

Common_resxEdit.jpg

When you are finished with your changes, save the file and copy it to the appropriate Resources *folder on *all Web front-end servers in your SharePoint farm. Follow the instructions below to make your changes take effect.

Top

Applying Language File Updates

To apply changes to Provisioning Resource Files:

If you modified the provisioning resources file, apply your changes by restarting Web services with the following command on all Web front-end servers.

iisreset

NOTE: changes to provisioning resources affect new instances of the Bamboo product only; existing instances of the product are not updated.

To apply changes to Application/Runtime Resource Files:

If you modified the application/runtime resources file, apply your changes by executing the following stsadm command on all Web front-end servers. This command copies the updated resource file to the App_GlobalResources folder of each Web application. Changes apply to existing product instances and any new instances you create.

stsadm -o CopyAppBinContent

NOTE: Changes apply to EXISTING product instances AND any new instances you create.

Configue Ratings column to use a 10-Point rating scale

Configue Ratings column to use a 10-Point rating scale

10-PtRating.pngWhen you add the Rating Column to a list and want to configure it to use the 10-Point Rating Scale, a variety of options become available within the selection.

Step Action Description
1. Average Rating Decimal Points Select the number of decimal places that are displayed if the average is not a whole number. This number is stored in the column and is displayed in the tooltip. Choose a value between 0-5.
2. Allow Anonymous Ratings Select this option if you want each rating to be stored with the authenticated account or not. Anonymous users can rate an unlimited number of times.
3. Allow Individual Item Ratings to be Reset Select this option to give specific users the ability to reset individual item ratings, for example: after uploading a new version of a document. Choose the Rating Administrator from the people picker, who can view the Reset button and reset the item ratings. Here is what happens when a Rating Administrator resets the ratings.
4. Add to default view Select this option to add Bamboo Rating to the default view.

Click OK to save your changes.
For each view that you want to display the Rating Column column, click the view to add the column following the steps above.

Return to the List or Library. Bamboo Rating is now added.