AJAX Reviews User Guide

Transcription

1 AJAX Reviews User Guide Version: 1.0 Website: Support:

2 Table of Contents AJAX Reviews Description... 3 Configure AJAX Reviews... 4 Mails after Purchase Management How to Insert Reviews into a Custom Place Uninstall AJAX Reviews AJAX REVIEWS USER GUIDE 2

3 AJAX Reviews Description The AJAX Reviews extension allows customers to leave reviews in a convenient AJAX popup window. The module starts working with default settings that can be customized if necessary. Flexibility of the backend options will help you to tailor the reviews block style to your store design. The content of the dialog windows and the color of rating stars are also customizable. The extension also allows sending notifications of pending reviews to admins and mails after purchase to customers. These mails contain a feedback form where a customer can leave a review and rate the purchased product. In this guide, you will find the detailed description of all extension options and the examples of admin and customer s. AJAX REVIEWS USER GUIDE 3

4 Configure AJAX Reviews AJAX Reviews flexibility helps to easily customize reviews options and content of the dialog windows in the frontend. To configure the extension, go to the Catalog Reviews and Ratings AJAX Reviews Configuration or System Configuration AJAX Reviews backend page. The page contains six sections: AJAX REVIEWS USER GUIDE 4

5 Display Settings 1) Display Mode: Select where the reviews will be displayed in the frontend: Disabled: Reviews will not be displayed in the frontend. Additional Product Info (default): Reviews will be displayed under the tabs with additional information. AJAX REVIEWS USER GUIDE 5

6 Custom Place: Reviews will be inserted into a custom place (see this section how to do that). Standard Place: Reviews will be shown in the Reviews tab. Note: this option works only with Magento versions starting from CE and EE ) Reviews per Page: Define the number of reviews displayed on a product page. 3) Enable Sorting (enabled by default): Select Yes if you want to allow customers to sort reviews. 4) Available Sorting Types: Select which types of sorting will be available in the frontend. AJAX REVIEWS USER GUIDE 6

7 5) Enable Sharing (enabled by default): If you select Yes, customers will have the possibility to share reviews in social networks. 6) Enable Voting (enabled by default): Select Yes to allow customers vote for reviews usefulness. Style Settings 1) Show Icon (Enabled by Default): Select Yes to display icons near reviews. 2) Icon Display Mode: Choose a type of the displayed icon: Gravatar Image: If a customer is registered in Gravatar, the icon will contain a customer s image from this service. If s/he doesn t have a gravatar, a default icon will be displayed instead. AJAX REVIEWS USER GUIDE 7

8 Note: Gravatar is a globally unique avatar which is uploaded on the Gravatar service. This image is displayed when a person leaves a comment in a blog post or a product review. First Name Letter: The icon will contain the first letter of the customer nickname. Gravatar and Letter (default): If a customer has a gravatar, it will be displayed in the icon. If a customer doesn t have an account in this service, the icon will contain the first nickname letter. 3) Default Customer Icon: Choose an image which will be default for customer gravatars. This image will be used if a customer doesn t have an avatar on Gravatar. 4) Rounded Design (Enabled by Default): Select Yes to display round icons. 5) Rating Stars Color: Choose the color of the rating stars. The color will change in both the store and mails after purchase which are sent to customers. AJAX REVIEWS USER GUIDE 8

9 6) Uppercase Text: If you select Yes, all the letters in the feedback form will be large. Compare: Uppercase letters Lowercase letters AJAX REVIEWS USER GUIDE 9

10 "How to write an awesome review?" Dialog In this dialog, you write recommendations how to write an informative review that will be of use to other customers. It s better to present the tips in the form of separate points for more convenience. 1) Enable (enabled by default): Select Yes to display a dialog link in the AJAX window: 2) Title: Specify the dialog title that will attract customer s attention to your recommendations. 3) Message Text: We have added a default text but you can alter it or add some other points. AJAX REVIEWS USER GUIDE 10

11 4) Button Label: Specify the label which will be on the button. When a customer clicks the link, he or she will see the following dialog window: "Thank You" Dialog This dialog appears when a customer clicks the Submit button in the review form. Depending on whether the review is positive or negative, a raised thumb is displayed in the dialog window. The options in this option field are the same as in the "How to write an awesome review?" dialog. AJAX REVIEWS USER GUIDE 11

12 The dialog frontend view: If a review is positive, an image with a raised thumb is added to it: If a review is negative, there is no image in the dialog window: AJAX REVIEWS USER GUIDE 12

13 Notification of Pending Review You can manage notifications that will be sent to admin, in this section. 1) Sender: Choose an address from which notifications about new reviews will be sent to admins. 2) Receiver: Specify one or several admin s, separated by commas, to which notifications of pending reviews will be sent. You can approve or reject reviews right in the . This is an example of the notification 3) Template: Choose a template of the notification . You may use our default template as well. It s awesome. AJAX REVIEWS USER GUIDE 13

14 Mail After Purchase This section allows you to customize the options of customer notification s. A notification, which suggests leaving a review, will be sent in a few days after the order is completed. 1) Send Select Yes if you want to send customers notifications. 2) Sender: Choose an address from which notifications to leave a review will be sent to customers. 3) Template: Choose a template of the notification . 4) Order Statuses: Here you should select one or several order statuses that will trigger the s to be sent. 5) Days after Purchase: Define the number of days after which the notification will be sent to a customer. 6) Days Interval between s: Specify the interval between sent notifications if a customer ordered more than one product. AJAX REVIEWS USER GUIDE 14

15 Mails after Purchase Management To manage customer mails, go to the Catalog Reviews and Ratings AJAX Reviews Mails after Purchase backend page. On this page, you can manage customer notification asking to leave a review of the ordered item. The extension allows admins to control notifications sending and cancel s if it s necessary. A notification to leave a review appears when the order gets the status selected in the Order Statuses option on the extension configuration page. To manage a notification, select an action from the Actions drop down list. After sending, a customer will receive a notification where he/she can leave feedback. Note: not every service supports sending forms. Nevertheless, a customer will be able to leave a review on the product page by clicking the product name or a special link below. AJAX REVIEWS USER GUIDE 15

16 This is an example of an after purchase that will be sent to customers: AJAX REVIEWS USER GUIDE 16

17 How to Insert Reviews into a Custom Place We ve integrated the reviews block in a place where they don t distract customers from the product and, at the same time, are easy to be found. If required, you can insert customer reviews into any area on the product page. It is convenient from a design standpoint and will allow you to show reviews into the place you need. To display reviews in a custom place, you may use the File System extension. It is one of the simplest ways to manage files. You can download this extension from Magento Connect or our site for free. To manage system files, go to the System File System IDE backend page. For example, the switcher will be integrated into the place before the tabs with additional information. Open the file: app/design/frontend/<your_package>/<your_theme>/template/catalog/product/vi ew.phtml AJAX REVIEWS USER GUIDE 17

18 1) Choose the necessary place for the reviews block. 2) Paste the following code into the place where you want to display them: <?php echo $this->getchildhtml('mp_ajaxreviews');?> 3) Click Save. Note: do not forget to clear the cache to enable the changes on the Frontend page. Reviews are inserted into the custom place before the info tabs: AJAX REVIEWS USER GUIDE 18

19 Uninstall AJAX Reviews To delete AJAX Reviews, remove all extension files. `mp_ajaxreviews_ _leave_review` `mp_ajaxreviews_ _pending` `mp_ajaxreviews_votes_aggregated` `mp_ajaxreviews_votes` Then you need to clear the cache. After deleting the tables, product reviews will remain in their place but the information about voting for reviews will disappear. Note: don t forget to make a backup of your store and disable compilation before any deletion or installation. AJAX REVIEWS USER GUIDE 19