In order to receive reviews, you must first subscribe to our Crowdsourcing & Reviews add-ons. This is also available to Enterprise users.
The first step in obtaining reviews from end users is providing a link where reviews can be submitted.
This form link can be added in any of the MetaLocator templates as {reviewlink rel='modal'}.
Handlebars template users can inspect and use the HTML output created by this tag such as:
<a rel="{size: {x: '100%', y: 500},scrolling:'yes',title:'Add Review'}" data-conversion="reviewlink" class="button modal" href="index.php?option=com_locator&view=reviews&layout=form&tmpl=component&Itemid={{mlconfig Itemid}}&modal_chooser=1&framed=1&frontReview=1&locId={{id}}">Add Review</a>
That will appear as shown below:
Clicking the link will display a simple form that allows the user to submit a review:
Reviews are *unpublished* by default. However, the submit process will deliver an email to the email address for the location which contains a link to approve the review.
This email template is managed under your Interface settings > Contact Form Settings > Review Notification Email Subject and Review Notification Email Body Template.
The Review Notification Email Body Template supports a few important placeholders that can be used for crafting the dynamic email.
%%PUBLISHLINK%% - Replaced with the URL to publish the review
%%UNPUBLISHLINK%% - Replaced with the URL to UN-publish the review
%%review_comments%% - The comments in the review
%%review_rating%% - The numerical rating of the review (1-5)
%%NAME%% - The reviewer's name
%%EMAIL%% - The reviewer's email address.
The email supports language constants such as LOCATOR_SUBMIT. It also supports traditional template placeholders for the target location record such as {address}, {city} and so forth.
Related language constants are as follows:
LOCATOR_REVIEW_FORM = "Add Review"
LOCATOR_REVIEW_FORM_NAME_REQUIRED="A name is required"
LOCATOR_REVIEW_FORM_EMAIL_REQUIRED="Email address is required"
LOCATOR_REVIEW_FORM_DATE_REQUIRED="Review date is required"
LOCATOR_REVIEW_FORM_COMMENTS_REQUIRED="Comments are required"
LOCATOR_REVIEW_FORM_RATING_REQUIRED="A rating is required"
LOCATOR_REVIEW_FORM_NAME="Name"
LOCATOR_REVIEW_FORM_EMAIL="Email"
LOCATOR_REVIEW_FORM_RATING="Rating"
LOCATOR_REVIEW_FORM_COMMENTS="Comments"
LOCATOR_SUBMIT_REVIEW="Save"
LOCATOR_REVIEW_SAVED="Review Saved"