Skip to content

Conversation

@theRealThagomizer
Copy link
Contributor

Hello, Felicia! This PR was created to resolve this task: https://www.odoo.com/odoo/action-4043/5226235. The original lift was simply to update the document from 18.0 -> 19.0, but after review, I decided the functionality had changed enough that the document needed to be wholly rewritten. I also replaced all of the photos with the modern UI and some screenshots of the quotations and eCommerce experiences so that readers can see what Optional Products actually look like on the customer's end.

This 19.0 PR can be FWP up to master.

@robodoo
Copy link
Collaborator

robodoo commented Dec 6, 2025

Pull request status dashboard

@C3POdoo C3POdoo requested a review from a team December 6, 2025 01:08
@theRealThagomizer
Copy link
Contributor Author

jk, @erjer-odoo can you actually review this ahead of @Felicious? I've heard that we're starting the round-robin peer review process at this time. Thank you!

Copy link
Contributor

@erjer-odoo erjer-odoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @theRealThagomizer ! This looks great! I did notice one typo, but this is otherwise good to go, I think! Approving, and after you fix the typo and checks pass, you should be able to pass this along to merge.

Additional products can also be added to a core product by clicking :guilabel:`Search more...`. This
opens the :guilabel:`Search: Optional Products` form, which displays all products in the catalog and
includes the :guilabel:`New` button to create a new product. Multiple products may be selected as
optional prodcuts at once when using this form by clicking their checkboxes and then clicking
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
optional prodcuts at once when using this form by clicking their checkboxes and then clicking
optional products at once when using this form by clicking their checkboxes and then clicking

@theRealThagomizer theRealThagomizer force-pushed the 19.0-sales-optional-products-update-thjud branch from 9398189 to 814c96e Compare December 8, 2025 18:33
@theRealThagomizer
Copy link
Contributor Author

Thanks, @erjer-odoo!

@Felicious, this is ready for your review to see if it's ready to be merged. Thanks!

Copy link
Contributor

@Felicious Felicious left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gj @theRealThagomizer !

Your updates address the feature change and I like that you've reduced the writing so that it's clearer and concise! I had a comment to address the quotation template workflow that used to work in 18.0 is clarified to not work anymore in 19.0, as well as a potential essentials content trim that could potentially make this doc even shorter and sweeter! Though that seems to be a little bit out of scope for this change 🤔

My other comments are optional, so good work getting more familiar with the team's style (:

Although I'm delegating, I noticed an issue that seems to be within Niki's technical scope. In my local build, I'm not able to get the "On this page" column on the side of this page to show up! Could you ask @nikibrown to look into this?

Image

expected ):

Image

@robodoo delegate+

Comment on lines 40 to 59
To delete an optional product from the product form, simply click the :icon:`fa-times`
:guilabel:`(Delete)` icon.

.. image:: optional_products/optional-products-product-form.png
:alt: The optional products section of product forms in Odoo Sales

Additional products can also be added to a core product by clicking :guilabel:`Search more...`. This
opens the :guilabel:`Search: Optional Products` form, which displays all products in the catalog and
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/search-optional-products-form.png
:alt: The Search: Optional Products form accessed by clicking Search more...
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

deleting a product and searching products seem a little like essentials content to me, where it's not too hard to do, or is the same across most apps and workflows. However, the "Search more.." feature isn't documented anywhere, to my knowledge.

Can we revisit this in a follow-up PR, where we try to place where this content would live and then come back to this section to reduce?

However! If you tell me that you have supporting data from a BSA or youtube comment or something that implies that customers struggle to delete and search for additional products, we can leave this as is :D

@Felicious Felicious requested a review from nikibrown December 10, 2025 03:06
@Felicious
Copy link
Contributor

Hi @nikibrown! Just tagging you to get help looking into the sidebar not showing up (: There's no need for you to do a full-fledged tech review. Thanks! :D

@theRealThagomizer
Copy link
Contributor Author

Hi @nikibrown! Just tagging you to get help looking into the sidebar not showing up (: There's no need for you to do a full-fledged tech review. Thanks! :D

@Felicious, after poking around some other documentation pages and viewing them in GitHub, I believe there's no "On this page" sidebar because there's only a single section. It seems like a page needs to have a minimum of two sections/subsections before the sidebar appears.

@nikibrown
Copy link
Contributor

@theRealThagomizer beat me to it! Great detective work! 🕵️

The code that builds the TOC section checks for less than 2 headings in addition to the title and hides things accordingly.

https://github.com/odoo/documentation/blob/19.0/extensions/odoo_theme/static/js/page_toc.js#L10

image

tmyk

@theRealThagomizer theRealThagomizer force-pushed the 19.0-sales-optional-products-update-thjud branch from 814c96e to 8ea2c22 Compare December 10, 2025 21:54
@theRealThagomizer
Copy link
Contributor Author

@nikibrown Got @Felicious's updates implemented. If you want to take a peek, this is ready for you. Otherwise, I'll tag in robodoo and we can check this off!

Co-authored-by: Erin Jerison <erjer@odoo.com>
Co-authored-by: Felicia Kuan <feku@odoo.com>
Co-authored-by: Niki Brown <nikbr@odoo.com
@theRealThagomizer theRealThagomizer force-pushed the 19.0-sales-optional-products-update-thjud branch from 8ea2c22 to 2eb01b8 Compare December 10, 2025 22:16
Copy link
Contributor

@nikibrown nikibrown left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@theRealThagomizer make review issues resolved. LGTM 🚀 cc @StraubCreative with merging powers.

@StraubCreative
Copy link
Contributor

@robodoo delegate+

@theRealThagomizer
Copy link
Contributor Author

@robodoo r+

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants