[IMP] website_sale: automatic rating request

Add a new rating email template and the _get_rating_request_template
method to fetch it. Implement a scheduled cron
_cron_send_order_rating_emails to automatically send
feedback requests for orders confirmed a configurable
number of days ago. Include settings to enable the feature,
set the delay, and select the email template, integrating
these with website configuration. The email sending logic
respects user settings and prevents duplicate emails.

task-5129654

Author: csan-odoo

addons/website_sale/data/ir_cron_data.xml

@@ -10,4 +10,12 @@
         <field name="state">code</field>
     </record>
 
+    <record id="ir_cron_send_order_rating_emails" model="ir.cron">
+        <field name="name">eCommerce: send order rating request emails</field>
+        <field name="interval_number">1</field>
+        <field name="interval_type">days</field>
+        <field name="model_id" ref="sale.model_sale_order"/>
+        <field name="code">model._cron_send_order_rating_emails()</field>
+        <field name="state">code</field>
+    </record>
 </odoo>

addons/website_sale/data/mail_template_data.xml

@@ -210,5 +210,60 @@
             </field>
             <field name="auto_delete" eval="False"/>
         </record>
+        <record id="mail_template_sale_order_rating" model="mail.template">
+            <field name="name">Ecommerce: Order Rating Request</field>
+            <field name="model_id" ref="sale.model_sale_order"/>
+            <field name="subject">Review your recent order!</field>
+            <field name="email_from">{{ (object.user_id.email_formatted or object.company_id.email_formatted or user.email_formatted) }}</field>
+            <field name="partner_to" eval="False"/>
+            <field name="use_default_to" eval="True"/>
+            <field name="description">Sent to customers to request feedback on their order</field>
+            <field name="email_layout_xmlid">mail.mail_notification_light</field>
+            <field name="body_html" type="html">
+                <div style="margin: 0px; padding: 0px;">
+                    <p style="margin: 0px; padding: 0px; font-size: 12px;">
+                        Hello <t t-out="object.partner_id.name"/>,
+                        <br/>
+                        Take a minute to rate your order!
+                        <br/>
+                        <t t-if="not is_html_empty(object.user_id.signature)">
+                            <div>--<br/><t t-out="object.user_id.signature"/></div>
+                        </t>
+                        <br/>
+                        <t t-foreach="object.order_line.filtered(lambda l: l._is_sellable())" t-as="line">
+                            <t t-set="product" t-value="line.product_id"/>
+                            <table width="35%" style="color: #454748; font-size: 12px; border-collapse: collapse; margin-bottom: 15px;">
+                                <tr>
+                                    <td style="width: 100px; vertical-align: top;">
+                                        <img
+                                            t-attf-src="/web/image/product.product/{{ product.id }}/image_128"
+                                            t-attf-style="width: 64px; height: {{object.website_id and object.website_id._get_product_image_ratio_height() or '64px'}}; object-fit: cover; object-position: center;"
+                                            alt="Product image"
+                                        />
+                                    </td>
+                                    <td style="padding-left: 10px; vertical-align: top; overflow: hidden; white-space: nowrap; text-overflow: ellipsis;">
+                                        <div style="font-weight: bold; margin-bottom: 5px;">
+                                            <t t-out="product.name"/>
+                                        </div>
+                                        <div style="font-size: 11px; color: #666;">
+                                            <t t-out="product.description_sale or ''"/>
+                                        </div>
+                                    </td>
+                                    <td style="width: 120px; padding-left: 10px; vertical-align: middle; text-align: center;">
+                                        <a t-att-href="product.website_absolute_url + '#o_product_page_reviews'"
+                                        style="background-color:#875A7B;color:white;padding:10px 15px;text-decoration:none;border-radius:4px;display:inline-block;font-weight:bold;"
+                                        target="_blank">
+                                            Review Now
+                                        </a>
+                                    </td>
+                                </tr>
+                            </table>
+                        </t>
+                    </p>
+                </div>
+            </field>
+            <field name="report_template_ids" eval="[]"/>
+            <field name="auto_delete" eval="True"/>
+        </record>
     </data>
 </odoo>

addons/website_sale/models/res_config_settings.py

@@ -67,6 +67,21 @@ class ResConfigSettings(models.TransientModel):
     confirmation_email_template_id = fields.Many2one(
         related='website_id.confirmation_email_template_id', readonly=False
     )
+    send_order_rating_emails = fields.Boolean(
+        string="Request ratings",
+        config_parameter='website_sale.send_order_rating_emails',
+    )
+    rating_email_days = fields.Integer(
+        string="Days After Order to Send Rating Email",
+        default=5,
+        config_parameter='website_sale.rating_email_days',
+    )
+    rating_email_template_id = fields.Many2one(
+        string="Email",
+        comodel_name='mail.template',
+        default=lambda self: self.env.ref('website_sale.mail_template_sale_order_rating', raise_if_not_found=False),
+        config_parameter='website_sale.rating_email_template_id',
+    )
 
     # Additional settings
     account_on_checkout = fields.Selection(
@@ -120,6 +135,9 @@ def set_values(self):
                 )
             ):
                 website._populate_product_feeds()
+        view = self.env['ir.ui.view'].search([('key', '=', 'website_sale.product_comment')], limit=1)
+        if view and self.send_order_rating_emails:
+            view.active = True
 
     # === ACTION METHODS === #
 

addons/website_sale/models/sale_order.py

@@ -1,7 +1,7 @@
 # Part of Odoo. See LICENSE file for full copyright and licensing details.
 
 import random
-from datetime import datetime
+from datetime import datetime, timedelta
 
 from dateutil.relativedelta import relativedelta
 
@@ -46,6 +46,7 @@ class SaleOrder(models.Model):
     is_abandoned_cart = fields.Boolean(
         string="Abandoned Cart", compute='_compute_abandoned_cart', search='_search_abandoned_cart',
     )
+    rating_email_sent = fields.Boolean(string="Rating email already sent")
 
     #=== COMPUTE METHODS ===#
 
@@ -846,6 +847,41 @@ def _get_delivery_methods(self):
             *self.env['delivery.carrier']._check_company_domain(self.company_id),
         ]).filtered(lambda carrier: carrier._is_available_for_order(self))
 
+    @api.model
+    def _cron_send_order_rating_emails(self):
+        """Send rating request emails to customers a few days after order."""
+        send_order_rating_emails = self.env['ir.config_parameter'].sudo().get_bool('website_sale.send_order_rating_emails')
+        if not send_order_rating_emails:
+            return
+
+        days = max(0, self.env['ir.config_parameter'].sudo().get_int('website_sale.rating_email_days'))
+        date_limit = fields.Datetime.now() - timedelta(days=days)
+        rating_orders = self.search([
+            ('state', '=', 'sale'),
+            ('date_order', '>=', date_limit.replace(hour=0, minute=0, second=0)),
+            ('date_order', '<=', date_limit.replace(hour=23, minute=59, second=59)),
+            ('website_id', '!=', False),
+            ('rating_email_sent', '=', False),
+        ])
+
+        for order in rating_orders:
+            mail_template = order._get_rating_request_template()
+            if mail_template:
+                mail_template.send_mail(order.id)
+                order.rating_email_sent = True
+
+    def _get_rating_request_template(self):
+        self.ensure_one()
+
+        rating_email_template_id = self.env['ir.config_parameter'].sudo().get_int(
+            'website_sale.rating_email_template_id'
+        )
+        rating_email_template = self.env['mail.template'].browse(rating_email_template_id).exists()
+        if rating_email_template:
+            return rating_email_template
+
+        return self.env.ref('website_sale.mail_template_sale_order_rating', raise_if_not_found=False)
+
     #=== TOOLING ===#
 
     def _is_anonymous_cart(self):

addons/website_sale/views/res_config_settings_views.xml

@@ -216,6 +216,19 @@
                         <button type="object" name="action_open_abandoned_cart_mail_template" string="Customize Abandoned Email Template" class="btn-link" icon="oi-arrow-right"/>
                     </div>
                 </setting>
+                <setting
+                    id="send_order_rating_emails_setting"
+                    help="Send a rating request for each order"
+                >
+                    <field name="send_order_rating_emails"/>
+                    <div invisible="not send_order_rating_emails" class="mt-1">
+                        Send <field name="rating_email_days" class="oe_inline" /> days after order confirmation
+                    </div>
+                    <div invisible="not send_order_rating_emails" class="mt-2">
+                        <label for="rating_email_template_id" class="o_light_label me-2"/>
+                        <field name="rating_email_template_id" class="oe_inline"/>
+                    </div>
+                </setting>
                 <setting string="Orders Assignment" help="Assignment of online orders">
                     <div class="content-group">
                         <div class="row mt16">