[IMP] Sales: Optional product page rewrite

closes odoo/documentation#15588

Signed-off-by: Thomas Jude Cavazos (thjud) <thjud@odoo.com>
Co-authored-by: Erin Jerison <erjer@odoo.com>
Co-authored-by: Felicia Kuan <feku@odoo.com>
Co-authored-by: Niki Brown <nikbr@odoo.com

content/applications/sales/sales/sales_quotations/optional_products.rst

@@ -2,98 +2,68 @@
 Optional products
 =================
 
-The use of optional products is a marketing strategy that involves the cross-selling of products
+The use of optional products is a marketing strategy that involves the cross-selling of useful and
-along with a core product. The aim is to offer useful and related products to customers, which may
+related products alongside a desired core product. For instance, when a business configures optional
-result in an increased sale.
+products in their Odoo database, an eCommerce or Website customer could be suggested a mouse and
+keyboard or an extended warranty when they add a laptop to their shopping cart.
 
-For instance, if a customer wants to buy a car, they have the choice to order massaging seats, as
+Optional products are automatically suggested during the quotation process whenever an associated
-well, or ignore the offer and simply buy the car. Presenting the choice to purchase optional
+core product is added to a quote. They are also suggested in eCommerce interactions when a customer
-products enhances the customer experience.
+adds an associated core product to their shopping cart.
-
-Optional products on quotations
-===============================
-
-With the Odoo *Sales* application, it is possible to add or modify optional products directly on
-quotations by navigating to the :guilabel:`Optional Products` tab on a quotation form.
-
-.. image:: optional_products/optional-products-tab.png
-   :align: center
-   :alt: How to add optional products to your quotations on Odoo Sales.
-
-To add an optional product(s) to a quotation, click :guilabel:`Add a product` in the
-:guilabel:`Optional Products` tab of a quotation. Doing so reveals a blank field in the
-:guilabel:`Product` column.
-
-When clicked, a drop-down menu with products from the database appear. Select the desired product
-from the drop-down menu to add it as an optional product to the quotation template.
-
-.. tip::
-   If the desired product isn't readily visible, type the name of the desired product in the field,
-   and the option appears in the drop-down menu. Then, select that desired product to add it to the
-   quotation.
 
 .. note::
-   When a product is added, the default :guilabel:`Quantity` is `1`, but that can be edited at any
+   Optional products are differentiated from accessory products and alternative products by where
-   time.
+   they appear in the customer's shopping experience.
 
-To delete any line item from the :guilabel:`Optional Products` tab, click the :guilabel:`🗑️ (trash
+   - Optional products are suggested when a core product has been added to a cart or a quotation.
-can)` icon.
+   - Accessory products appear as suggestions when viewing an eCommerce cart.
+   - Alternative products are suggested at the bottom of an eCommerce product page whenever the
+     product page is viewed.
 
-Click the :guilabel:`Preview` button, located in the upper-left corner of the quotation, to reveal a
+.. figure:: optional_products/optional-products-quotation.png
-preview of the quotation customers would receive, via email, along with the optional products they
+   :alt: A screen from the quotation process shows how optional products appear as a pop-up window.
-can potentially add to their order, located in the :guilabel:`Options` section.
 
-.. image:: optional_products/optional-products-checkout.png
+   Optional products as they appear during the quotation process.
-   :align: center
-   :alt: Preview your quotations on Odoo Sales.
 
-Customers are able to add different optional products to an order by clicking the :guilabel:`🛒
+.. figure:: optional_products/optional-products-ecommerce.png
-(shopping cart)` icon, located to the right of the optional product line.
+   :alt: An eCommerce shopping cart screen shows how optional products appear in eCommerce websites.
 
-If a customer selects optional products, these are automatically added to the quotation managed by
+   Optional products as they appear when viewing the shopping cart on an eCommerce website.
-the salesperson.
 
-When the customer adds an optional product(s) to an order, the salesperson is instantly notified
+Configuring optional products
-about the change, along with any other change the customer makes to an order. This allows
+=============================
-salespeople to stay up-to-date with everything related to an order in the backend of the *Sales*
-application.
 
-Optional products on quotation templates
+With the Odoo **Sales** app, it is possible to add optional products directly to product forms. To
-========================================
+add an optional product to a product form, navigate to :menuselection:`Sales --> Products -->
+Products` and choose a product.
 
-.. note::
+Ensure that the product's :guilabel:`Sales` checkbox is checked and click the :guilabel:`Sales` tab.
-   Be sure to review the :doc:`quote_template` documentation to better understand how quotation
+Under :guilabel:`Upsell & Cross-sell` heading, the :guilabel:`Optional Products` drop-down menu
-   templates work before reading the following information.
+allows for optional products to be set. Products will be displayed in alphabetical order. If the
+desired product isn't readily visible, type its name in the field to bring it up, then select it to
+add it as an optional product.
 
-For quotation templates, just like a typical quotation form, there is also an :guilabel:`Optional
+To delete an optional product from the product form, simply click the :icon:`fa-times`
-Products` tab, wherein related products or services can be added to a quotation template.
+:guilabel:`(Delete)` icon.
 
-To add optional products to a quotation template, navigate to :menuselection:`Sales app -->
+.. image:: optional_products/optional-products-product-form.png
-Configuration --> Quotation Templates`. Then, either select an existing quotation template to edit,
+   :alt: Where the optional products section appears in product forms in Odoo Sales.
-or create a new one by clicking :guilabel:`New`.
 
-On the quotation template form, click the :guilabel:`Optional Products` tab. Under the
+Additional products can also be added to a core product by clicking :guilabel:`Search more...`. This
-:guilabel:`Optional Products` tab, click :guilabel:`Add a line`, and select the desired product to
+opens the :guilabel:`Search: Optional Products` form, which displays all products in the catalog and
-add as an optional product to the quotation template.
+includes the :guilabel:`New` button to create a new product. Multiple products may be selected as
+optional products at once when using this form by clicking their checkboxes and then clicking
+:guilabel:`Select`.
 
-.. image:: optional_products/optional-products-tab-quotation-template.png
+.. image:: optional_products/search-optional-products-form.png
-   :align: center
+   :alt: The Search: Optional Products form accessed by clicking Search more...
-   :alt: Preview your quotations on Odoo Sales.
 
-The products added in the :guilabel:`Optional Products` tab are present in the quotation, by
+.. important::
-default, whenever that particular quotation template is used. These products can be removed, and
+   Prior to Odoo 19.0, optional products were added to quotations on a separate tab in the quotation
-additional products can be added, before the quotation is sent to a customer.
+   and quotation template forms. Beginning in 19.0, that tab has been removed from both quotations
-
+   and quotation templates. If a core product with associated optional products is added to a
-.. tip::
+   quotation template, those optional products **will not** be automatically suggested during the
-   It's best to offer optional products that would encourage a customer to add additional items to
+   quotation process and must instead be manually suggested to customers.
-   their order, or entice them to purchase a more expensive version of their initially selected
-   product.
-
-   For example, if a customer purchases a wooden chair, some optional products could be: a warranty
-   on that chair and/or a wooden chair with leather seats.
-
-.. note::
-   There is no limit to how many optional products can be added to a quotation template.
 
 .. seealso::
    :doc:`quote_template`