CRP - Review/Rating Widgets

Owned by Liladhar Patil
Last updated: Oct 21, 2021 by Hammudie Arnous
4 min read

What is the Review/rating widget?

When you select rating from drop-down list it show stars on the page. If you select review from drop-down list you can see numbers with review text.

Please refer screenshot:

There is some critical configuration to be done in the Questionnaire module before any rating/review is calculated via the script. The script has default settings on which ratings/reviews should be considered, the script can be adjusted based on the client requirements. If the configuration is not done properly or if the script conditions aren't met then the review/rating widget won't fetch any data and therefore won't show any rate on the website as well. 


Requirements that should be cleared by the client to optimize the script:

  1. What should the interval of the script be? The script can run daily, 3 times a week, once a week, etc. This is adjustable as wished for any time interval, but the client should confirm what the interval is. For example, if the interval is once a week on a Tuesday, it means that the script will run once a week calculating the average ratings.
  2. The completed date is considered in the script. This is also considered in the script. For example 7 days before the current date. This way the ratings/reviews of the last 7 days won't be considered every time the script runs. This can be needed if the client wants to have time to review the ratings themselves and mark completed surveys as invalid if they don't want this o to be shown on the website.


Critical configuration to be done in the Questionnaire module

  • Tab Question Category; Create Question categories and the setting ""for internal usage only" should be off, for example 
  1. Category 1; Impression of the accommodation
  2. Category 2: Impression of the location

  • Tab Question; Question setup critical settings:
  1. turn on Question type: Rating
  2. turn on setting: is part of accommodation average so the script also consider this question

  • Create Questions per category, for example
  1. Category 1; Impression of the accommodation
    1. Question; How do you rate the accommodation 0-10?
  2. Category 2: Impression of the location
    1. Question; How do you rate the location 0-10?
  • Tab Questionnaire; setup the survey
  1. Here you can set up the survey and link the question groups to it. The groups are sections of the survey, so for example:



  • Tab Questionnnaire generation
  1. On this tab, you can start generating the survey. This means you will set up a rule with conditions of which bookings should receive this survey. The guests will then (depending on configuration) receive a survey right away or a report that has a link in it to the MyEnv where the guests can fill in the survey based on the above configuration.

config on resort level to configure the validity of the questionnaires: This setting is about the validity of the questionnaire. In this example, it means that 900 days after sending the questionnaire, the questionnaire becomes invalid and the guests can't fill it in anymore. 

Exclude units; you can exclude units from being considered in the rating calculation on unit level this checkbox:

The minimum amount of answered questions before the avg. rating calculation is considered in the script, these are concern settings but can be changed if needed:

Mark answers as invalid; if there are answers that you don't to be picked up by the script you can mark them as invalid

Setup the script conditions; Nilesh Wanican help setting up the script conditions if above requirements are cleared by the client. As you have noticed the script is very flexible in which ratings should be considered based on the questionnaire configuration, the interval of the script and other conditions. If the requirements are clear this can be adjusted in the script. The script then will run based on the new conditions and starting calculation avg. ratings. These avg. ratings can be defined as:

  • location ratings
  • accotype ratings
  • accokind rating
  • unit ratings

So on each level, there can be ratings and calculated averages that can be used for the upper level.

  • So if 8 units have an avg. rating of 8 then the type avg. rating will be 8.
  • If 4 Acco types have the avg. rating of 8.5 then the location avg. rating will be 8.5. 


Conclusion: as you can see a lot of config needs to be confirmed/checked by the client is as well before usage of the questionnaire module. If the requirements are clear these can be configured in the module. When the above conditions are met with the script conditions then the web manager review/rating widget will start picking up avg. ratings to show on the website as well.