⭐ Helpdesk Rating Five Stars

Odoo 18 Helpdesk Customer Satisfaction

Transform your customer feedback experience by replacing Odoo's standard 3-emoticon rating system with an intuitive 5-star rating system. Gain more granular insights into customer satisfaction and improve your helpdesk service quality.

✨ Key Features

5-star rating system (1-5 stars) replacing the standard 0-3 emoticon system
Interactive star rating widget with hover effects for web forms
Clickable star links in email rating requests for one-click feedback
Automatic migration of existing ratings from 0-3 to 0-5 scale
Enhanced rating reports and analytics with 0-5 scale calculations
Beautiful star display in backend ticket views (form, tree, kanban)
Responsive design optimized for mobile and desktop
Accessible UI with keyboard navigation and ARIA labels
Full compatibility with Odoo's rating API and other modules
Duplicate rating prevention with automatic update logic

📋 Requirements

🚀 Installation

⚠ī¸ Important: Before installing, it's recommended to backup your database, especially if you have existing rating data. The module will automatically migrate existing ratings from the 0-3 scale to the 0-5 scale.

Step 1: Copy Module to Addons Directory

Copy the helpdesk_rating_five_stars folder to your Odoo addons directory:

cp -r helpdesk_rating_five_stars /path/to/odoo/addons/

Or if using custom addons directory:

cp -r helpdesk_rating_five_stars /path/to/custom/addons/

Step 2: Update Addons Path (if needed)

Ensure your odoo.conf includes the addons directory:

addons_path = /path/to/odoo/addons,/path/to/custom/addons

Step 3: Restart Odoo Server

Restart your Odoo server to load the new module:

sudo systemctl restart odoo

Or if running manually:

./odoo-bin -c /path/to/odoo.conf

Step 4: Update Apps List

  1. Log in to Odoo as an administrator
  2. Go to Apps menu
  3. Click the Update Apps List button
  4. Click Update in the confirmation dialog

Step 5: Install the Module

  1. In the Apps menu, remove the "Apps" filter to show all modules
  2. Search for "Helpdesk Rating Five Stars"
  3. Click the Install button
  4. Wait for installation to complete (migration runs automatically)
✅ Installation Complete! The module is now active and all existing ratings have been migrated to the 0-5 scale.

⚙ī¸ Configuration

The module works out of the box with zero configuration required. However, you can customize certain aspects if needed:

Email Templates

To customize the rating request email template:

  1. Go to Settings → Technical → Email → Templates
  2. Search for "Helpdesk Rating Request"
  3. Edit the template to customize the email content and styling
  4. The star links are automatically generated and should not be removed

Star Icon Customization

The module uses Unicode star characters (⭐) by default. To use custom icons:

  1. Edit static/src/scss/rating_stars.scss
  2. Modify the star icon styles or replace with custom images
  3. Restart Odoo and clear browser cache

Rating Migration Mapping

The default migration mapping converts old ratings as follows:

Old Rating (0-3) New Rating (0-5) Description
0 0 No rating / Not rated
1 (😞 Unhappy) 3 (⭐⭐⭐) Neutral / Average
2 (😐 Okay) 4 (⭐⭐⭐⭐) Good / Satisfied
3 (😊 Happy) 5 (⭐⭐⭐⭐⭐) Excellent / Very Satisfied

📖 Usage Examples

Example 1: Customer Rating via Email

  1. Customer receives a rating request email after ticket is closed
  2. Email contains 5 clickable star links
  3. Customer clicks on the 4th star to give a 4-star rating
  4. System records the rating and redirects to a thank you page
  5. Helpdesk agent sees 4 filled stars in the ticket view

Example 2: Customer Rating via Web Form

  1. Customer clicks "Rate this ticket" link in email or portal
  2. Web form displays 5 interactive stars
  3. Customer hovers over stars to preview rating
  4. Customer clicks on desired star to select rating
  5. Customer submits the form
  6. Rating is saved and displayed in backend views

Example 3: Viewing Rating Statistics

  1. Helpdesk manager navigates to Helpdesk → Reporting → Ratings
  2. Dashboard shows average ratings calculated on 0-5 scale
  3. Manager can filter by rating value (1-5 stars)
  4. Manager can group ratings by team, agent, or time period
  5. Export includes rating values in 0-5 range

Example 4: Viewing Ratings in Ticket Views

Form View:

List View:

Kanban View:

Example 5: Handling Duplicate Ratings

  1. Customer rates a ticket with 3 stars
  2. Customer changes their mind and clicks the rating link again
  3. Customer selects 5 stars
  4. System updates the existing rating to 5 stars (no duplicate created)
  5. Confirmation message indicates rating was updated

🔧 Troubleshooting

Stars Not Displaying in Backend

Solution:

Email Rating Links Not Working

Solution:

Migration Issues

Solution:

Rating Values Outside 1-5 Range

Solution:

🔒 Security & Access Control

The module implements the following security measures:

🌐 Accessibility Features

The module is designed with accessibility in mind:

🔄 Compatibility

This module is compatible with:

ℹī¸ Note: The module maintains full API compatibility with Odoo's standard rating system, ensuring no breaking changes for other modules.

📊 Technical Details

Module Structure

Database Changes

🆘 Support

For support and assistance:

📝 License

This module is licensed under LGPL-3. See the LICENSE file for details.

đŸ‘Ĩ Credits

Developed for Odoo 18 Helpdesk application enhancement.

Helpdesk Rating Five Stars | Version 1.0 | Odoo 18