Close
Next
Prev

 

    Loading...

Pluck Reviews capture a customer’s reaction to a given product, as well as a plethora of other valuable information. Rating attributes provide more insight into specific areas of your product, and Reviewer Characteristics capture additional information about your reviewer. This information is then used by your customers to filter for buying decisions, and by you to better understand your customers needs.

Pluck ReviewsReviews

“Would you recommend?” and “thumbs up” are built-in features that assist your customers in finding accurate reviews they can trust. Reviews have native Syndication to Social Media sites, so reviewers syndicate the Reviews and drive traffic in to your site. And by flagging the type of review submission, for example mobile, or desktop, you gain insight into where your customers are logging on.

Features

  • Multi-attribute ratings and Histograms
  • Filter Reviews by Friends or All
  • User Added Photos
  • Threaded Comments
  • Advanced Moderation
  • Discovery
  • Review Blocking

Using Categories to Organize Reviews

In Pluck, reviewable items need a canonical URL for use in links in the Persona wall, community feeds, etc. This URL is tied to an Article record with a unique ID which must identify the reviewed item for its lifetime in the system. However, reviews can also be grouped for listing and summarization purposes using an unlimited number of identifiers. This offers complete flexibility in representing your catalog of products—or other reviewable items.

To add a category, simply apply one or more Category records to the Article containing reviews. Lists and rollups accept either an Article Key or Category Key, both in widgets and through the SDKs. The data returned is based on that key.

Think of Categories as arbitrary tags. That is, you are not restricted to just product categories. Complex hierarchies can be represented with a flat taxonomy. For example, let’s say your catalog has an Electronics category that breaks down into Computers and Televisions. Computers then breaks down into Desktop and Laptop sub-categories. This portion of the catalog can then be represented in Pluck using the following Article Categories:

  • electronics
  • electronics_computers
  • electronics_computers_desktop
  • electronics_computers_laptop
  • electronics_televisions

Rollups and lists can be presented at any node in this taxonomy, as well as for the specific SKU being reviewed.

For an example of arbitrary tags, consider products that are currently discounted. You can simply tag the Article with a Discount category and use that as the basis for aggregation, or you can capture that state at a more granular level, such as electronics_computers_laptop_discount.

Article Categories can be added and removed at any time using simple SDK updates.

Microformat Support

Pluck Reviews supports the hReview .3 open standards microformat specification. This enables Reviews to be indexed by Google easily. For more information on this standard, see http://microformats.org/wiki/hreview.

Reviews Attributes Audit Log

The Review Audit log is a CSV style file you can download from the Community Management Workbench. Included data points in the log are:

  • Activity Date — The date the attribute or set was changed.

  • UserKey — The key of the user making the change.

  • UserName — The name of the user making the change.

  • Key — The key of the attribute or set being changed.

  • Action — Specifies the change.

  • Before — If applicable, shows the value before the change.

  • After — Shows the value after the change.

You can find the link to download the log in the Community Management Workbench→Reports→Downloads. The link is under Review Rating Attributes. Note that if there is no data—that is, if there are no attributes or attribute sets defined—this link does not appear in the Community Management Workbench.

Log of changes to review attributes

Log of changes to review attributes

2nd Party Rewards

Pluck Rewards can assign points to users for their activities in Reviews. Rewards can also assign points to users that do something (like write a good review) that other users like. For example, if Bob writes a review, then Alice Likes (scores) the review, Bob can earn a point as the author of the review. For more information, see Rewards Rules Grammar.

Featured Reviewer Badge

Granting selected users a Featured Reviewer Badge allows you to filter to those users’ reviews. Similar to the Featured User Badge for Comments, the Featured Reviewer Badge can be set with preferences, but you can also customize the feature on a per page basis. You can define a global badge key with a preference. The preference defines the Featured Reviewer badge for all Reviews lists in your implementation. To customize on a per page basis, you can also pass in a badge key in a PAS tag for the Reviews list application that specifies the key of the Featured Reviewer badge. When you do this, it overrides the default preference. This gives you the convenience of a globally set Badge for featured with the flexibility of specifying different ones when needed anywhere on your site. Note that reviews themselves can also be highlighted, which bubbles them to the top of the sort.

To be able to use this feature, Rewards must be enabled in your Pluck system.

Note:

Your Pluck Representative can help you with any settings or preferences you need to make.

  1. Go to the Community Management Workbench→Rewards, and create a Featured Reviewer Badge. Give the badge a unique name. If you are also adding customized badges on a per page basis, create as many badges as you need.

  2. There are two preferences at play for the Featured Reviewer Badge:

    • plckReviewFeaturedUserBadgeFamilyId — Specifies the badge family key of the badge that identifies the featured reviewer. This preference can be set in pluck/reviews/reviews.prefs or set from the PAS tag.

    • plckReviewFeaturedUserBadgeId — Specifies the badge key of the badge used to identify featured users. If an assigned badge, set the value to underscore (_).

      This preference can be set in pluck/reviews/reviews.prefs or set from the PAS tag.

    Note:

    These preferences can also be called from a PAS tag, so you can define multiple badges and call them as needed through the PAS tag on the page.

    Set the preferences to define your global reviewer badge settings.

  3. Optionally, call the custom badges in the PAS tag on the pages you want them to appear.

Note:

Featured Reviewers only appears if Reviews is enabled AND plckReviewFeaturedUserBadgeFamilyId and plckReviewFeaturedUserBadgeId are set.

Note:

A featured badge assignment does not immediately appear in the Reviews application or through the ReviewsPageRequest SDK call when filtering by Featured Reviewers.

HTML Insertion in Reviews

To allow users to use HTML formatting in their review, set the ReviewsHTMLEditorEnabled preference in LicensePrefs to true. If set to false, only plain text is allowed. This preference defaults to false.

Note:

A Pluck Representative can help you set this preference. You must select one or the other before implementation, and it is not recommended to change back to plain formatting after you enable HTML formatting.

Attribute Creation

Pluck Reviews enables to create your own attributes right from the CMW. You can add as many attributes as you like, and combine them in any number of attribute sets. With the Reviews applications, you can display up to five attributes at a time. If you use the SDK you can display as many attributes as you like. Attribute sets are collections of attributes. You attach an entire set to a review rather than assign individual attributes. For more information on attribute and attribute set management, see Attributes.

Enabling Pluck Dirty Word Filter For Reviews

In order to use Pluck’s Dirty Word Filter, you must set the DirectReviewActionApplyFilter preference in Internal Prefs to true. The default is false.

Example

<DirectReviewActionApplyFilter>true</DirectReviewActionApplyFilter>

Persona Reviews Tab

You can choose to add the Reviews tab to your user’s Persona. The Reviews tab displays the reviews that the user has made. Reviews still awaiting moderation do not display. The Reviews tab feature is off by default. When this feature is enabled, a link also appears in the Reviews list, See All My Reviews, that brings users to the Persona Reviews tab of the user that posted the review. The default setting displays ten of the user’s reviews, any more than that are paginated. Review comments are also displayed.

To Turn On The Reviews Tab

Displaying the Reviews Tab in Persona is a simple preference change. The tab displays for all users. In the PersonaVisibleTabs preference in PersonaPrefs, add PersonaReview. For example:


<item><key><string>PersonaReviews</string></key><value><boolean>true</boolean></value></item>

Blocking Reviews

If you choose not to delete Reviews but want to hide them from users, you can block them. There is a Block button available in the Community Management Workbench and in the Moderation Manager. This functionality works the same way as blocking Comments.

If a submitted review is blocked from the Moderation Manager, two things happen. First, the review is approved, then it is immediately blocked. Note that blocked reviews are not counted in Review counts or Review rollups. When a Review is blocked, its rating is removed from being calculated in a Product’s average rating. It is also removed from any Category rollup or attribute rollup that the Product is included in.

No configuration is necessary for this feature.

Reviews Notifications

Reviews has three email notifications. The email templates can be modified directly in the Community Management Workbench. These notifications are only relevant if you plan on premoderating your reviews.

Available email notifications for Reviews are:

  • Review Approved — This email notifies the submitter that the review has been approved and published on the site. The default template provides link enticements to share the review with friends via third party social media tools.

  • Review Pending — The Review Pending email notifies the submitter that the review has been received and is under editorial review before it can be published.

  • Review Rejected — The Review Rejected email notifies the submitter that the review is not acceptable for publishing. The default template encourages rewriting the review and provides a link to the editorial policy.

To edit the templates for these email notifications, go to the Community Management Workbench for your implementation, and navigate to PreferencesEmail Templates, and select the appropriate template from the pull-down menu (i.e. in this case, ReviewApproved.vm, ReviewPending.vm, or ReviewRejected.vm).

Reviews Character Limits

Reviews enforces the following character limitations:

  • Title — 100 characters
  • Body — the value on the pluck pref plckMaxReviewLength. The pluck default is 10000 (including all HTML formatting if using FCK editor)
  • Pros — 200 characters
  • Cons — 200 characters

Pluck Reviews For Mobile Browsers

Pluck Reviews For Mobile shares the same platform as Pluck Reviews. The same content that a user sees on your site from a standard browser is also available from a mobile browser, allowing your users to extend their conversations from their mobile web browsers using a fast, streamlined mobile interface.

PLReviewsMobile

Pluck Reviews For Mobile Most Helpful

Works With

Discovery
  — Assist your customers with decision making with Most Helpful and Recent Reviews
Sharing and Syndication
  — Spread the word to new potential users outside of your community
Comments
  — Add inline with Reviews to stimulate additional conversation and involvement within the community. Also allows your moderators to respond to any negative Reviews or misinformation within a Review.

Implementation Tips

Make sure that the characteristics are set in the CMW before you start coding the widget on the page.

Once you create a review characteristic key, you can't delete it. So choose carefully ahead of time.

Plan your attributes and how you filter your attributes.

Take advantage of Discovery to drive traffic.

Use Categories to improve Discovery.

Details

Reviews are lazy created, which means that the review properties such as OnPageTitle and OnPageUrl are auto-populated when left empty. So once a review is created, it cannot be changed.

Consumers provide invaluable feedback in Pluck Reviews, use the information provided to make purchasing decisions, and establish a unique identity on the brand site. Reviews provide consumers the option to rate attributes, vote on individual reviews, and indicate whether they would recommend the product to a friend. The rating attributes are even rolled up, so that a user sees the average scores for specific attributes, further assisting with their decision making process. Discovery can be used to both filter reviews by friends and sort and filter on a number of review attributes.

  • SpamTriggersAbuseReportThreshold

    Description: If true, any content flagged as spam will be treated as automatically exceeding the abuse report threshold.

    Default Value: false

    Applications: Blogs Comments Forums Reviews

    Preference Type: Global

    Import: NO

    Value Range: true false

  • DirectShortCircuitArticleReviews

    Description: Optimization flag for customers that do not use reviews, so that articles come back with 0 counts for the review summaries without searching storage.

    Default Value: false

    Applications: System

    Preference Type: Global

    Import: NO

    Value Range: true false

  • LargeActionSubmissionQuota

    Description: This configures pot-spoiling by placing an upper limit on the number of large actions performed by individual users, such as posting comments or reviews. A value of 0 indicates large action pot-spoiling is not enforced

    Default Value: 0

    Applications: System

    Preference Type: Global

    Import: NO

    Value Range: 0...9999999

  • AbuseReportThreshold

    Description: Sets the threshold number of AbuseReports that can be on an item before it is automatically removed from storage search results.

    Default Value: 2147483647

    Applications: Blogs Comments Forums Reviews

    Preference Type: Global

    Import: YES

    Value Range: 1...2147483647

  • MostHelpfulReviewsUsesPositiveScoreOnly

    Description:

    Default Value: false

    Applications: Reviews

    Preference Type: Global

    Import: YES

    Value Range:

  • ReviewsHTMLEditorEnabled

    Description:

    Default Value: false

    Applications: Reviews

    Preference Type: Global

    Import: YES

    Value Range:

  • MostHelpfulReviewsThreshold

    Description:

    Default Value: 5

    Applications: Reviews

    Preference Type: Global

    Import: YES

    Value Range:

  • MaxReviewRating

    Description:

    Default Value: 5

    Applications: Reviews

    Preference Type: Global

    Import: YES

    Value Range:

  • CanReviewItemMoreThanOnce

    Description: Determines if users are able to review an item more than once.

    Default Value: false

    Applications: Reviews

    Preference Type: Global

    Import: YES

    Value Range:

  • DefaultImageSizeP4Avatar

    Description: Default pluck4 avatar image size bounding box, used in mini persona/comments. This only affects newly uploaded files, not existing files already on the system.

    Default Value: 40

    Applications: Comments Persona Reviews

    Preference Type: Global

    Import: YES

    Value Range:

  • ReviewsInheritUrlAndTitleFromParentArticle

    Description: If this pref is set to true, changing the URL on an article will also change the URL on any reviews of that article

    Default Value: false

    Applications: Social

    Preference Type: Global

    Import: YES

    Value Range: true false

To set up Pluck Reviews using REST

  1. Before you can install Pluck applications on your pages, your Pluck Application Server environment must be set up and you must have some articles, other Pluck applications, or other Pluck widgets that generate content up on the page, too—such as Blogs or Photos—that users can comment on.

  2. Determine on what page(s) you want to add Reviews to.

  3. Make sure any preferences are set, such as having a comment approval process. Your Pluck representative can help you determine if any preferences are relevant to your implementation and what settings should be made for Comments.

  4. Load the Pluck Libraries.Give your site access to the applications on the Pluck Application Server by including the following somewhere in the <head> tag:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  5. Include the Pluck Applications CSS.In the <head> tag, link to the Pluck Application CSS:

    <link rel="stylesheet" type="text/css" href="http://yourPluckServer.com/ver1.0/Content/ua/css/pluckAll.css" />

    where yourPluckServer is the domain of your Pluck server.

  6. Make The REST Call.Call the Reviews application you want with the appropriate URL. For example, if you were calling the Reviews list application you would use something like:

    http://yourdomain.com/ver1.0/pluck/reviews/list.app?plckReviewOnKeyType=article&plckReviewOnKey=sample.html&clientUrl=http%3A%2F%2Fwww.yourdomain.com%2Fpageyouareon%3Fquerystring

    where yourdomain is the domain of your website, and YourURL is the URL of the page making the REST call.

    Note:

    When installing REST applications, you must pass the SiteLifeHost and AT cookies in the REST call. The AT cookie is case sensitive and is lowercase by default. Depending on your environment setup you may be required to pass additional cookies. The clientUrl is also required and should be passed in as the current page being requested with the full querystring. URLencode the entire value when adding it to the above URL. Don't URLdecode the requesting URL prior to encoding it or you can end up with invalid URLs. For more information, ask your Pluck Representative.

    Available Reviews applications that can be called through REST include:

    • Category Rolluphttp://yourdomain.com/ver1.0/pluck/reviews/categoryRollup.app?

    • Full Review Listhttp://yourdomain.com/ver1.0/pluck/reviews/list.app?

    • Most Helpfulhttp://yourdomain.com/ver1.0/pluck/reviews/mostHelpful.app?

    • Product Rolluphttp://yourdomain.com/ver1.0/pluck/reviews/rollup.app?

    • Top Ratedhttp://yourdomain.com/ver1.0/pluck/reviews/topRated.app?

Pluck Reviews Applications, Parameters, and PAS Tags

Note:

The syntax below, including specifying the PAS tags, is for JavaScript implementations. If you are installing REST applications, the parameters are valid, but you must adjust the syntax as specified in the installation steps for REST.

Category Rollup

The Category Rollup widget retrieves rating averages and/or review counts by any category specified.

Example Syntax

<pas:pluck_reviews_categoryRollup plckDiscoveryCategory="test" plckCategoryRollupUrl="http://mytesturl.html"></pas:pluck_reviews_categoryRollup>

To set up Pluck Reviews For Mobile

  1. Before you can install Pluck applications on your pages, your Pluck Application Server environment must be set up and you must have some articles, other Pluck applications, or other Pluck widgets that generate content up on the page, too—such as Blogs or Photos, or any other suitable content—that users can review.

  2. Determine which Reviews widgets you want and on which page(s) you want to add them to.

  3. Make sure any preferences are set. Your Pluck representative can help you determine if any preferences are relevant to your implementation and what settings should be made for Reviews.

  4. Load the Pluck Libraries. Give your site access to the applications on the Pluck Application Server by including the following somewhere in the <head> tag:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckMobileApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  5. Place the PAS JavaScript call for Reviews on the page:

    
    <script type="text/javascript">
    	pluckAppProxy.embedApp("mobile_reviews", {plckReviewOnKeyType: "article", plckReviewOnKey: "myTestReviewArticle.html"});
    
    </script>
    			

    With the PAS JavaScript call, you can also set options that control how the app displays and loads. For more information, see Loading Pluck Applications.

Alternative Call Method

Using the JavaScript call to put Pluck application on the page is preferred, but in some circumstances you may need to use PAS tags. For more information, see PAS Tags.

Valid parameters for Reviews for Mobile Application Call Tag

Valid parameters for Reviews for Mobile are:

  • plckArticleTitle — The title of the parent article. If the parent article does not exist, this value is used when lazy creating the article object.
  • plckArticleUrl — The url of the parent article. If the parent article does not exist, this value is used when lazy creating the article object.
  • plckDiscoveryCategories — A comma-separated list of discovery categories to apply to the article. If the parent article does not exist, this value is used when lazy creating the article object.
  • plckDiscoverySection — The discovery section to apply to the article. If the parent article does not exist, this value is used when lazy creating the article object.
  • plckMaxReviewLength — The maximum length of any review.
  • plckReviewAuthorAttributeSetKey — The author attribute set key to apply to the article. If the parent article does not exist, this value is used when lazy creating the article object.
  • plckReviewItemsPerPage — Specifies the number of eviews per page.
  • plckReviewMaxPhotos — Determines the maximum number of photos that a user can add to a review.
  • plckReviewOnKey* — The key of the object on which to find the rollup.
  • plckReviewOnKeyType* — The type of object on which to find the rollup.
  • plckReviewRatingAttributeSetKey — The rating attribute set key to apply to the article. If the parent article does not exist, this value is used when lazy creating the article object.
  • plckReviewCreate — Determines if the create review screen is displayed rather than the list. The create screen is only displayed if the user is allowed to add a review to the item.
  • plckReviewFilter — Determines the filter applied to reviews to be displayed. Can be one of the following: FriendsOnly (reviews by friends only) - valid only if the user is logged in, FeaturedUserOnly (reviews by featured review users sorted by newest) - valid only if plckReviewFeaturedUserBadgeFamilyId is not "", rating<1-max> (reviews with the specified rating) max = LicensePrefs.MaxReviewRating, or AuthorAttributes (reviews matching specified author attributes and options) - valid only if the parent object defines a ReviewAuthorAttributeSetKey or if plckReviewAuthorAttributeSetKey != "".
  • plckReviewKey — The key of a specific review to display. If specified, only the review matching the key is displayed.
  • plckReviewOnPage — The current page of reviews to be displayed.
  • plckReviewSort — The current sort applied to reviews to be displayed. Can be one of the following: TimeStampDescending (most recent), TimeStampAscending (oldest), RatingDescending (highest ratings first), RatingAscending (lowest ratings first), ScoreDescending (most popular), FriendDescending (reviews by friends sorted by newest) - valid only if the user is logged in, or FeaturedUserDescending (reviews by featured review users sorted by newest) - valid only if plckReviewFeaturedUserBadgeFamilyId is not "".
  • plckReviews — Determines if the page is scrolled to the reviews widget on widget load.
  • plckReviewsCommentsItemsPerPage — The number of comments to display per page.
  • plckReviewsCommentsSort — The current sort applied to the reviews.
  • plckRefreshPage — Indicates that AJAXy links should be followed rather than dynamically loaded into the existing page.

*Required parameters

Category Rollup

The Category Rollup widget retrieves rating averages and/or review counts by any category specified.

Example Syntax

pluckAppProxy.embedApp("mobile_categoryRollup", {plckDiscoveryCategory: "cameras"});

Valid Paramaters
  • plckDiscoveryCategory* — The Discovery category to be rolled up. Only one category at a time is supported. This parameter is required.
  • plckCategoryRollupUrl — If the category has its own page in the your system, the URL can be supplied. If the URL is specified, the reviews count appears as a link. Otherwise, it is simply text. This parameter is optional.

*Required parameters

Recent Reviews

Recent Reviews display the specified number of most recently submitted reviews as determined from either the external article ID or the single category sent through the PAS tag. They are sorted by most recent first, and link to the full review.

Example Syntax

pluckAppProxy.embedApp("mobile_recent", {plckDiscoveryCategory: "cameras"});

Or, if you are calling reviews related to a specific article:

pluckAppProxy.embedApp("mobile_recent", {plckDiscoveryCategory: "cameras", plckReviewOnKeyType: "article"});

Valid Parameters
  • plckDiscoveryCategory — Specifies the discovery category the recent reviews are retrieved from. Only one category is supported at a time. This parameter is required.
  • plckDiscoveryTitle — The title to use at the top of the list. If no title is specified, default is "". This parameter is optional.
  • plckRecentReviewItemsPerPage — The number of recent reviews to display.
  • plckRecentReviewDateFormat — Date Format used to display create dates for reviews. Standard .NET formatting rules apply.

Product Rollup

The Reviews Rollup widget provides a summary of all reviews ratings by attribute for a particular product.

Example Syntax

pluckAppProxy.embedApp("mobile_rollup", {plckReviewOnKeyType: "article", plckReviewOnKey: "myTestReviewArticle.html"});

Valid Parameters
  • plckReviewOnKeyType* — The type of object being reviewed. At this time, only article (ExternalResource) is supported. This parameter is required.
  • plckReviewOnKey* — The key of the object being reviewed. This parameter is required.
  • plckReviewShowCreate — If true, and the user is able to create a review, a Create Review button is displayed. This parameter is usually set on the PAS tag; the default is true. This parameter is optional.
  • plckReviewShowAttributes — Determines if the Rating Attribute rollups also be displayed.
  • plckReviewMaxAttributes — The maximum number of review attribute rollups to show. Not valid if plckReviewShowAttributes is not true. The maximum allowed value is 1000.

*Required parameters

Top Rated

The Top Rated Products widget displays the top 10 rated items in the single category passed to the widget. It is not applicable at the product level. Products are listed from highest rated to lowest. If items have the same rating, they are listed according to the most recently updated products in descending order. Only Active items are displayed.

Example Syntax

pluckAppProxy.embedApp("mobile_topRated", {plckDiscoveryCategory: "cameras"});

Valid Parameters
  • plckDiscoveryCategory* — The discovery category that the topRated articles are retrieved from. This parameter is required. Only one category is supported.

  • plckDiscoveryTitle — The title to use at the top of the list. If no title is specified, default is Top Rated Products. This parameter is optional.

*Required parameters

Preferences Used to Configure Your CMW (Community Management Workbench)

The following preferences control how the Pluck CMW displays Reviews attributes and attribute sets. These are not parameters that are set in a PAS tag; you set them using the Pluck Application Workbench, or your Pluck Representative can set them for you.

Attribute List

Location: cmw/reviews/attributes/list

  • plckReviewAttributeItemsPerPage — Number of attributes displayed in the list per page. The default is 10. This parameter is optional.

Attribute Sets

Location: cmw/reviews/attributeSets/list

  • managementMaxAttributesPerSet — Specifies the maximum number of attributes which can be added to an attribute set. Default is 5. Note that the Pluck application user interface supports up to 5. The SDK supports any number. This parameter is optional.

Location: cmw/reviews/attributeSets/submit

  • managementMaxAttributesPerSet — Specifies the maximum number of attributes which can be added to an attribute set. Default is 5. Note that the Pluck application user interface supports up to 5. The SDK supports any number. This parameter is optional.

Review Lists (CMW)

Location: cmw/reviews/list

  • plckReviewItemsPerPage — The number of attributes displayed in the list per page. The default is 5. This parameter is optional.

  • plckReviewOnPage — Specifies the page number to be displayed. Usually set by Javascript for AJAX. The default is 1. This parameter is optional.

The following SDK objects are commonly used in Reviews:

Drop Reviews List On a Page

  1. Load the Pluck libraries. In the <head> tag, add:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  2. Build the parameter string:

    The parameter string is a comma-delimited list of required and optional parameters meant to format the widget. For example:

    plckReviewOnKey: "reviewKey" //required
    plckReviewOnKeyType: "article" //required
    plckDiscoveryCategories: "discoveryCategories" //required
    plckArticleUrl: "myReviews.html" //optional
    plckArticleTitle: "My Reviews" //optional
    plckdiscoverySection: "discoverySection" //optional

    where reviewKey is the key that identifies the parent object containing the reviews and discoveryCategories is a comma-separated list of discovery categories that apply to the article.

  3. Place the Reviews JavaScript call on the page where you want the app to appear:

  4. Save and reload. The Pluck Reviews application appears on the page where you put the PAS call.

Drop Top Rated On a Page

  1. Load the Pluck libraries. In the <head> tag, add:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  2. Build the parameter string:

    The parameter string is a comma-delimited list of required and optional parameters meant to format the widget.

    plckReviewOnCategory: "discoveryCategory" //required
    plckReviewOnKey: "reviewKey" //optional
    plckReviewOnKeyType: "article" //optional

    where reviewKey is the key of the parent object containing the reviews.

  3. Place the Reviews JavaScript call on the page where you want the app to appear:

    <script type="text/javascript">
    var opts = {}
    pluckAppProxy.embedApp("pluck_reviews_topRated", {add parameter string from step 2 here}, opts);
    </script>
  4. Save and reload. The Pluck Reviews application appears on the page where you put the PAS call.

Drop Recent Reviews On a Page

  1. Load the Pluck libraries. In the <head> tag, add:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  2. Build the parameter string:

    The parameter string is a comma-delimited list of required and optional parameters meant to format the widget.

    plckReviewOnCategory: "discoveryCategory" //required  - If not set, the plckDiscoveryCategory OR plckReviewOnKey and plckReviewOnKeyType must be set.
    plckDiscoveryCategory: "discoveryCategory" //optional
    plckReviewOnKey: "reviewKey" //optional
    plckReviewOnKeyType: "article" //optional

    where reviewKey is the key of the parent object containing the reviews.

  3. Place the Reviews JavaScript call on the page where you want the app to appear:

    <script type="text/javascript">
    var opts = {}
    pluckAppProxy.embedApp("pluck_reviews_recent", {add parameter string from step 2 here}, opts);
    </script>
  4. Save and reload. The Pluck Reviews application appears on the page where you put the PAS call.

Drop Most Helpful a Page

  1. Load the Pluck libraries. In the <head> tag, add:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  2. Build the parameter string:

    The parameter string is a comma-delimited list of required and optional parameters meant to format the widget.

    plckReviewOnCategory: "discoveryCategory" //optional
    plckReviewOnKey: "reviewKey" //optional
    plckReviewOnKeyType: "article" //optional
  3. Place the Reviews JavaScript call on the page where you want the app to appear:

    <script type="text/javascript">
    var opts = {}
    pluckAppProxy.embedApp("pluck_reviews_mostHelpful", {add parameter string from step 2 here}, opts);
    </script>
  4. Save and reload. The Pluck Reviews application appears on the page where you put the PAS call.

Drop Category Rollup On a Page

  1. Load the Pluck libraries. In the <head> tag, add:

    <script type="text/javascript" src="http://yourPluckServer.com/ver1.0/Content/ua/scripts/pluckApps.js"></script>

    where yourPluckServer is the domain of your Pluck server.

  2. Build the parameter string:

    The parameter string is a comma-delimited list of required and optional parameters meant to format the widget.

    plckReviewOnCategory: "discoveryCategory" //required - If not set, the plckReviewOnKey and plckReviewOnKeyType must be set.
    plckReviewOnKey: "reviewKey" //optional
    plckReviewOnKeyType: "article" //optional

    where reviewKey is the key of the parent object containing the reviews.

  3. Place the Reviews JavaScript call on the page where you want the app to appear:

    <script type="text/javascript">
    var opts = {}
    pluckAppProxy.embedApp("pluck_reviews_rollup", {add parameter string from step 2 here}, opts);
    </script>
  4. Save and reload. The Pluck Reviews application appears on the page where you put the PAS call.

Reviews uses attributes to give a review a number of criteria that you can set up for a reviewer to grade the item being reviewed. For example, if you have a camera, you might want the reviewer to grade the camera on its image quality, shutter response, auto focus, and so on. Grading is typically on a one to five scale, but this can be adjusted for your needs through a preference (LicensePrefs.MaxReviewRating). You can set up multiple attributes. Attributes let you set up a an item that can be graded according to the criteria you specify. Those Attributes, then, can be collected into Attribute Sets, and the Attribute Set is then specified for a review. You can also use attributes to identify review authors. For information on setting up Attributes and Attribute Sets, see Working With Reviews.

Full Review List

The Full Review List displays all Reviews for the specified item in a paginated, sortable, and filterable list. The attribute ratings are also displayed.

Reviews

Reviews

Top Rated Products

The Top Rated Products application displays the top ten rated items in the single category passed to the widget. It is not applicable at the product level. Products are listed using the following criteria in order:

  1. Review Rating (Highest to Lowest)

  2. Then by Number of Reviews (Highest to Lowest)

  3. And finally by Recently Updated Product (Newest to Oldest)

Only Active items are displayed.

Pluck Reviews Top Rated

Pluck Reviews Top Rated

Recent Reviews

The Recent Reviews application shows the most recently submitted reviews. This can be configured either from the external article ID or from the single category defined in the PAS tag. They are sorted by most recent first. Links from the title of the review take the user to the full Review.

Pluck Reviews Recent

Pluck Reviews Recent

Most Helpful

The Most Helpful application is a versus style display of the most helpful favorable review (5 star, etc.) shown side by side with the most helpful critical review (1 star, etc.). An algorithm determines the helpful score that chooses the reviews to display here. You can adjust the algorithm to use only positive feedback for rankings by setting the MostHelpfulReviewsUsesPositiveScoreOnly preference to true.

Note:

A favorable review is a review that is greater than the median rating. For example, if you are using a 5 star rating system, only 4- and 5-star ratings are considered. A critical review is a review that is less than the median rating. Again, if you are using a 5 star rating system, only 1- and 2-star ratings are considered.

Scoring Algorithm

There is a preference, LicensePrefs.MostHelpfulReviewsUsesPositiveScoreOnly, which determines if thumbs down are considered in the calculation of a Review’s helpful score. When this preference is set to false, the Helpful Score is defined as the total number of Thumbs Up minus the total number of Thumbs Down. When this preference is set to true, the Helpful Score is defined as the total number of Thumbs Up. This algorithm is run at the time of the item score (thumb) action. The system does not re-calculate existing scored items when this preference is changed, so changes are only reflected in scores done after the configuration change. If a change to this preference is done after there are already some scores in storage, some unexpected sorting results may occur in the Most Helpful Reviews widget and the Reviews List widget will sort the Most Helpful incorrectly.

Note:

Most Helpful is not available in the Mobile version of Pluck Reviews.

Reviews Most Helpful

Reviews Most Helpful

Product Rollup

The Product Rollup provides a summary view of all of the review ratings for a product.

Reviews Product Rollup

Reviews Product Rollup

Category Rollup

The Category Rollup application retrieves rating averages and/or review counts for the single specified category.

Reviews Category Rollup

Reviews Category Rollup

    6.0.11 Release        © 2014 DemandMedia                                   Teacher’s Edition