📋 Overview

The E-Commerce Product Ratings & Reviews module provides a comprehensive rating and review system for your Odoo e-commerce store. Allow customers to share their experiences and build trust through authentic product feedback.

✨ Key Features

🚀 Installation

1. Download the module package to your Odoo addons directory
2. Go to Apps → Update Apps List
3. Search for "E-Commerce Product Ratings"
4. Click Install
5. Verify the rating widget appears on product pages

👥 Usage

For Customers

Submitting a Review:

1. Navigate to a product page
2. Log in to your account (required)
3. Scroll to the "Customer Reviews" section
4. Click on stars to select your rating (1-5)
5. Optionally add text feedback
6. Click "Submit Review"

Managing Your Reviews:

• Click "Edit" to modify your review
• Click "Delete" to remove your review
• Only your own reviews show edit/delete buttons

For Administrators

Viewing All Ratings:

1. Go to Website → Catalog → Product Ratings
2. View all customer reviews
3. Filter and sort as needed

🔌 API Reference

Rating Submission

Endpoint	/shop/product/rate
Method	POST
Authentication	Required (logged-in users only)

Parameters:

• product_id (int, required): Product template ID
• rating (int, required): Rating value (1-5)
• feedback (string, optional): Review text (max 500 chars)
• variant_id (int, optional): Specific variant ID

Response Example:

{
  "status": "success",
  "message": "Thank you for your feedback!",
  "data": {
    "rating_avg": 4.5,
    "rating_count": 10,
    "rating_id": 123
  }
}

Review Loading (AJAX)

Endpoint	/shop/reviews/load
Method	JSON-RPC
Authentication	Public

Parameters:

• product_id (int, required): Product ID
• page (int, optional): Page number (default: 1)
• per_page (int, optional): Reviews per page (default: 5)
• sort_by (string, optional): Sort method
• filter_by (string, optional): Filter method

🗄️ Database Models

ecommerce_product_ratings.product_rating

Field	Type	Description
product_template_id	Many2one	Product being rated
product_variant_id	Many2one	Specific variant (optional)
user_id	Many2one	User who submitted the rating
rating	Integer	Rating value (1-5)
feedback	Text	Review text
verified_purchase	Boolean	Whether user purchased the product

🔧 Troubleshooting

📞 Support

For technical support and inquiries:

• Website: https://www.hexalian.com
• Email: support@hexalian.com

📄 License

This module is licensed under OPL-1 (Odoo Proprietary License v1.0).

Copyright © 2024 Hexalian LLC. All rights reserved.

📝 Changelog

Version 1.0.0

• Initial release
• 5-star rating system
• Text reviews with 500 character limit
• Verified purchase badges
• Variant-specific ratings
• Edit and delete functionality
• Advanced filtering and sorting
• AJAX pagination
• Anti-spam protection
• Multi-language support (EN/ES)
• Responsive design
• Complete API documentation