[REF] ecommerce: restructure doc

task-4645039

Content updates will be done in subsequent PRs

closes odoo/documentation#12483

Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>

content/applications/finance/fiscal_localizations/argentina.rst

@@ -1048,7 +1048,7 @@ Client account registration
 ***************************
 
 To configure your website for client accounts, follow the instructions in the :doc:`checkout
-<../../websites/ecommerce/checkout_payment_shipping/checkout>` documentation.
+<../../websites/ecommerce/checkout>` documentation.
 
 Automatic invoice
 *****************
@@ -1093,7 +1093,7 @@ the corresponding layout and fiscal stamps stated in the :ref:`Invoice printed r
 <argentina/invoice-printed-report>`.
 
 .. seealso::
-   :doc:`Client account creation <../../websites/ecommerce/checkout_payment_shipping/checkout>`
+   :doc:`Client account creation <../../websites/ecommerce/checkout>`
 
 Liquidity product direct sales
 ------------------------------

content/applications/finance/fiscal_localizations/peru.rst

@@ -928,7 +928,7 @@ the following configurations for the **eCommerce** flow:
 - :doc:`../../websites/ecommerce/products`: Set the :guilabel:`Invoicing Policy` to
   :guilabel:`Ordered quantities` and define the desired :guilabel:`Customer taxes`.
 - :doc:`../payment_providers`;
-- :doc:`../../websites/ecommerce/checkout_payment_shipping/shipping`: For each shipping method, set
+- :doc:`../../websites/ecommerce/shipping`: For each shipping method, set
   the :guilabel:`Provider` field to :guilabel:`Fixed Price`. Then, set a :guilabel:`Fixed Price`
   amount greater than `0.00` (not zero), as the shipping method price is added to the invoice line.
 

content/applications/finance/payment_providers.rst

@@ -420,7 +420,7 @@ the field to `0.00` to make the payment provider available regardless of the pay
 .. important::
    This feature is not intended to work on pages that allow the customer to update the payment
    amount, e.g., the **Donation** snippet and the **Checkout** page when paid :doc:`shipping methods
-   <../websites/ecommerce/checkout_payment_shipping/shipping>` are enabled.
+   <../websites/ecommerce/shipping>` are enabled.
 
 .. _payment_providers/journal:
 
@@ -471,5 +471,4 @@ payments from other payments.
    - :doc:`payment_providers/stripe`
    - :doc:`payment_providers/worldline`
    - :doc:`payment_providers/xendit`
-   - :doc:`../websites/ecommerce/checkout_payment_shipping/payments`
    - :doc:`accounting/bank`

content/applications/sales/subscriptions/plans.rst

@@ -56,7 +56,7 @@ the following additional options:
 
 - :guilabel:`Self Closable`: Check this box to enable the customer to terminate their subscription
   from the :doc:`customer portal
-  </applications/websites/ecommerce/ecommerce_management/customer_accounts>`.
+  </applications/websites/ecommerce/customer_accounts>`.
 - :guilabel:`Automatic Closing`: Enter the number of days after which *unpaid* subscriptions *past*
   the due date are automatically closed.
 - :guilabel:`Invoicing Journal`: Select the accounting journal in which invoices for this

content/applications/websites/ecommerce.rst

@@ -24,5 +24,10 @@ products and increase your average cart sizes.
    :titlesonly:
 
    ecommerce/products
-   ecommerce/checkout_payment_shipping
-   ecommerce/ecommerce_management
+   ecommerce/cart
+   ecommerce/checkout
+   ecommerce/payments
+   ecommerce/shipping
+   ecommerce/order_handling
+   ecommerce/customer_accounts
+   ecommerce/performance

content/applications/websites/ecommerce/cart.rst

@@ -27,11 +27,11 @@ the :guilabel:`Shop - Checkout Process` section, look for :guilabel:`Add to Cart
 the options.
 
 .. note::
-   If a product has :doc:`optional products <../products/cross_upselling>`, the **dialog
+   If a product has :doc:`optional products <products/cross_upselling>`, the **dialog
    box** will always appear.
 
 .. seealso::
-   :doc:`../products/catalog`
+   :doc:`products/catalog`
 
 .. _cart/prevent-sale:
 
@@ -50,7 +50,7 @@ To do so, go to :menuselection:`Website --> Configuration --> Settings --> Shop
 :guilabel:`Prevent Sale of Zero Priced Product`. This creates a new :guilabel:`Button url` field
 where you can enter the **redirect URL** to be used. Then, set the price of the product to `0.00`
 either from the **product's template**, or from a
-:doc:`pricelist <../../../sales/sales/products_prices/prices/pricing>`.
+:doc:`pricelist </applications/sales/sales/products_prices/prices/pricing>`.
 
 .. image:: cart/cart-contactus.png
    :align: center

content/applications/websites/ecommerce/checkout.rst

@@ -36,7 +36,7 @@ To restrict checkout to selected B2B customers, follow these steps:
    :guilabel:`On invitation`.
 #. Go to :menuselection:`Website --> eCommerce --> Customers`, switch to the :guilabel:`List` view,
    and select the customers you wish to grant access to your
-   :doc:`portal <../../../general/users/portal>`.
+   :doc:`portal </applications/general/users/portal>`.
 #. Click the :icon:`fa-cog` :guilabel:`Actions` button, then :guilabel:`Grant portal access`.
 #. Review the selected customers in the :guilabel:`Portal Access Management` pop-up and click
    :guilabel:`Grant Access`.
@@ -47,13 +47,13 @@ instructions on setting a password and activating their account.
 .. note::
    - You can revoke access or re-invite a customer using the related buttons in the
      :guilabel:`Portal Access Management` pop-up.
-   - Users can only have one :doc:`portal access <../../../general/users/portal>` per email.
+   - Users can only have one :doc:`portal access </applications/general/users/portal>` per email.
    - Settings are website-specific, so you could set up a B2C website that allows guest checkout and
      B2B website with mandatory sign-in.
 
 .. seealso::
-   - :doc:`Customer accounts <../ecommerce_management/customer_accounts>`
-   - :doc:`Portal access <../../../general/users/portal>`
+   - :doc:`Customer accounts <customer_accounts>`
+   - :doc:`Portal access </applications/general/users/portal>`
 
 .. _ecommerce/checkout/steps:
 
@@ -71,7 +71,7 @@ During the checkout process, customers are taken through the following steps:
 .. _ecommerce/checkout/customize_steps:
 
 Each step can be customized using the website editor: Click :guilabel:`Edit` to add
-:doc:`building blocks <../../website/web_design/building_blocks>` from the :guilabel:`Blocks` tab or
+:doc:`building blocks <../website/web_design/building_blocks>` from the :guilabel:`Blocks` tab or
 open to the :guilabel:`Customize` tab to enable various checkout options.
 
 .. note::
@@ -93,7 +93,7 @@ as:
 - :guilabel:`Suggested Accessories`: to showcase :ref:`accessory products
   <ecommerce/cross_upselling/accessory>`;
 - :guilabel:`Promo Code`: to allow customers to redeem :ref:`gift cards <ewallet_gift/gift-cards>`
-  or apply :doc:`discount codes <../../../sales/sales/products_prices/loyalty_discount>`;
+  or apply :doc:`discount codes </applications/sales/sales/products_prices/loyalty_discount>`;
 - :guilabel:`Add to Wishlist`: To allow signed-in users to remove a product from their cart and add
   it to their wishlist, go to :menuselection:`Website --> Configuration --> Settings`, scroll to
   the :guilabel:`Shop - Products` section, and enable :guilabel:`Wishlists`. The :guilabel:`Add to
@@ -172,4 +172,4 @@ The final step of the checkout process is the :guilabel:`Order confirmation`, wh
 summary of the customer's purchase details.
 
 .. seealso::
-   :doc:`Order handling <../../ecommerce/ecommerce_management/order_handling>`
+   :doc:`Order handling <order_handling>`

content/applications/websites/ecommerce/checkout_payment_shipping.rst

@@ -1,13 +0,0 @@
-:nosearch:
-
-===============================
-Checkout, payment, and delivery
-===============================
-
-.. toctree::
-   :titlesonly:
-
-   checkout_payment_shipping/cart
-   checkout_payment_shipping/checkout
-   checkout_payment_shipping/shipping
-   checkout_payment_shipping/payments

content/applications/websites/ecommerce/ecommerce_management.rst

@@ -1,13 +0,0 @@
-:nosearch:
-
-====================
-eCommerce management
-====================
-
-.. toctree::
-   :titlesonly:
-
-   ecommerce_management/order_handling
-   ecommerce_management/customer_accounts
-   ecommerce_management/customer_interaction
-   ecommerce_management/performance

content/applications/websites/ecommerce/ecommerce_management/customer_interaction.rst

@@ -1,116 +0,0 @@
-====================
-Customer interaction
-====================
-
-Odoo offers many ways to interact with customers and for customers to interact with your website.
-
-.. _product-reviews:
-
-Product reviews
-===============
-
-Customers can give a rating to your products. This is a great way to promote your products or
-services since reviews can influence purchase processes. To activate the **rating** feature, from
-your **shop page**, select a product, go to :menuselection:`Edit --> Customize` and enable
-:guilabel:`Rating`.
-
-.. image:: customer_interaction/interaction-rating.png
-   :align: center
-   :alt: Rating of a product on the product page
-
-.. note::
-   Only portal users which purchased the product or service can leave ratings.
-
-.. tip::
-   Customer reviews can be hidden by clicking the :guilabel:`Visible` button next to a published
-   review.
-
-Live chat
-=========
-
-A chatbot is available and can simulate a human-like conversation with website visitors via text
-messages in a chat box.
-
-.. seealso::
-   - :doc:`../../livechat`
-   - :doc:`../../livechat/ratings`
-   - :doc:`../../livechat/responses`
-
-.. _contact-form:
-
-Contact forms
-=============
-
-Helpdesk
---------
-
-Customers may need support after purchasing a product or subscribing to a service. It is possible to
-create a **contact form**, which, when fulfilled, automatically creates a new ticket for your
-**support team**.
-
-.. image:: customer_interaction/interaction-form.png
-   :align: center
-   :alt: Contact form to submit a ticket to the support team
-
-To add a contact form, **create** a new page (:menuselection:`+ New --> Page`) if necessary, and
-drag and drop a :guilabel:`Form` block from the :guilabel:`Dynamic Content` section onto the page.
-Once placed, click on the form (while in :guilabel:`Edit` mode), and in the :guilabel:`Action`
-field, select :guilabel:`Create a Ticket`. You can then select to which :guilabel:`Helpdesk team`
-the ticket should be assigned.
-
-.. image:: customer_interaction/interaction-ticket.png
-   :align: center
-   :alt: Action field to create a task upon submitting a form
-
-Contact us
-----------
-
-A 'Contact Us' page makes it easier for customers and prospects to contact your company and get in
-touch.
-
-To have a 'Contact Us' page, create a new page (:menuselection:`+ New --> Page`) if necessary, and
-click on :menuselection:`Edit --> Customize`. Then, drag and drop a :guilabel:`Form` block onto the
-page. Select the form and define the action to be performed when submitted in the :guilabel:`Action`
-field.
-
-When clicking on a field, or when adding a new field (:guilabel:`+ Field`), you can select its
-:guilabel:`Type`. This enables different options, such as :guilabel:`Multiple Checkboxes`, which
-customers can use to indicate the services they are interested in, for example.
-
-.. image:: customer_interaction/interaction-tags.png
-   :align: center
-   :alt: Tags to be selected on the 'Contact Us' form
-
-.. image:: customer_interaction/interaction-checkboxes.png
-   :align: center
-   :alt: 'Checkboxes' configuration settings
-
-Newsletter
-==========
-
-Customers can get updates on your eCommerce activities by subscribing to a newsletter. Visitors
-subscribing to the newsletter are automatically added to the mailing list of the **Email Marketing**
-application. You can either choose a newsletter **block**, a newsletter **popup**, or both.
-
-- **Popup**: prompts up a newsletter box when visitors scroll down the page;
-- **Block**: displays a field on the page where customers can sign up by entering their email.
-
-The newsletter **block** can be configured according to different :guilabel:`Templates`. To do so,
-click the **block** while in :menuselection:`Edit --> Customize`, and select a :guilabel:`Template`
-in the :guilabel:`Newsletter Block` section. There are **three** templates available:
-
-- :guilabel:`Email Subscription`: visitors can sign up by email to the newsletter, without any
-  choice to the content. The content is defined in :menuselection:`Edit --> Customize` in the
-  :guilabel:`Newsletter` field;
-- :guilabel:`SMS Subscription`: is the same as :guilabel:`Email Subscription`, but by SMS;
-- :guilabel:`Form Subscription`: allows adding several fields, as well as a checkbox for the visitor
-  to agree to the **GDPR policy** of your website.
-
-.. image:: customer_interaction/interaction-news.png
-   :align: center
-   :alt: Form subscription configuration and settings
-
-.. tip::
-   Alternatively, you can select :guilabel:`Subscribe to Newsletter` as :guilabel:`Action` when
-   creating a :ref:`contact form <contact-form>`, allowing for the same level of customization. Make
-   sure to add a checkbox stating visitors agree to be added to the mailing list.

content/applications/websites/ecommerce/order_handling.rst

@@ -80,9 +80,9 @@ enable the feature in the settings of the
    manually to reserve products in stock.
 
 .. seealso::
-   - :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/invoicing`
-   - :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels`
-   - :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/multipack`
+   - :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/invoicing`
+   - :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels`
+   - :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/multipack`
 
 Returns and refunds
 -------------------

content/applications/websites/ecommerce/payments.rst

@@ -8,7 +8,7 @@ customers to pay with their preferred payment methods.
 
 .. seealso::
    - :doc:`/applications/sales/sales/products_prices/ewallets_giftcards`
-   - :doc:`../checkout_payment_shipping/checkout`
+   - :doc:`checkout`
 
 Configuration
 =============

content/applications/websites/ecommerce/products/catalog.rst

@@ -169,7 +169,7 @@ or a **wishlist**. To do so, go to your **main shop page**, and at the end of th
 appear when hovering the mouse over a product's image.
 
 - :guilabel:`Add to Cart`: adds a button to
-  :doc:`add the product to the cart <../checkout_payment_shipping/cart>`;
+  :doc:`add the product to the cart <../cart>`;
 - :guilabel:`Comparison List`: adds a button to **compare** products based on their price, variant,
   etc.;
 - :guilabel:`Wishlist Button`: adds a button to **wishlist** the product.

content/applications/websites/ecommerce/shipping.rst

@@ -6,9 +6,12 @@ Odoo eCommerce allows you to configure various delivery methods, enabling custom
 their preferred option at :doc:`checkout <checkout>`. These methods include :ref:`external providers
 <ecommerce/shipping/external-provider>`, :ref:`custom options <ecommerce/shipping/custom-method>`
 such as flat-rate or free shipping, local carriers via
-:doc:`Sendcloud <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`
-or ::ref:`Based on Rules <inventory/shipping/rules>`, and
+:doc:`Sendcloud </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`
+or :ref:`Based on Rules <inventory/shipping/rules>`, and
 :ref:`in-store pickup <ecommerce/shipping/instore-pickup>`.
+:doc:`Sendcloud </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`
+or :ref:`Based on Rules <inventory/shipping/rules>`, and :ref:`in-store pickup
+<ecommerce/shipping/instore-pickup>`.
 
 .. _ecommerce/shipping/external-provider:
 
@@ -16,12 +19,12 @@ External provider integration
 =============================
 
 To handle product delivery, you can connect your database to :doc:`third-party shipping carriers
-<../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
-like :doc:`FedEx <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex>`,
-:doc:`UPS <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/ups_credentials>`,
-or :doc:`DHL <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials>`.
+</applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
+like :doc:`FedEx </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex>`,
+:doc:`UPS </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/ups_credentials>`,
+or :doc:`DHL </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials>`.
 A shipping connector links to these providers, automating :doc:`tracking labels
-<../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels>` and shipping
+</applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels>` and shipping
 processes.
 
 To enable a third-party delivery provider, go to :menuselection:`Website --> Configuration -->
@@ -33,7 +36,7 @@ in the list to :ref:`configure it <inventory/shipping_receiving/configure-delive
 
 .. seealso::
    :doc:`Third-party shipping carriers
-   <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
+   </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
 
 .. important::
    The field used to define additional fees **must** be filled **in your third-party delivery
@@ -67,7 +70,7 @@ Custom delivery method
 Custom delivery methods must be created, for example:
 
 - to integrate delivery carriers through :doc:`Sendcloud
-  <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`;
+  </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`;
 - to configure specific rules (e.g., to offer free shipping for orders above a specific amount) for
   a specific provider;
 - to configure :ref:`Fixed Price <inventory/shipping/fixed>` shipping, or shipping :ref:`Based on
@@ -84,11 +87,11 @@ In the :guilabel:`Provider` field, select :ref:`Based on Rules <inventory/shippi
    Upon :ref:`configuring <inventory/shipping_receiving/configure-delivery-method>` a delivery
    method, you can:
 
-   - Restrict it :doc:`to a specific website <../../website/configuration/multi_website>` by
-     selecting it in the :guilabel:`Website` field;
+   - Restrict it :doc:`to a specific website <../website/configuration/multi_website>` by
+     selecting it in the :guilabel:`Website` field.
    - Click the :guilabel:`Test Environment` smart button to switch to the
      :guilabel:`Production Environment`. Then, click :guilabel:`Unpublished` to :guilabel:`Publish`
-     the delivery method and make it available to website visitors;
+     the delivery method and make it available to website visitors.
    - Use the :guilabel:`Availability` tab to define :ref:`conditions
      <inventory/shipping_receiving/availability>` for the delivery method based on the order's
      content or destination.
@@ -113,7 +116,7 @@ To allow customers to reserve products online and pay for/collect them in-store,
 
 .. note::
    - When the product is in stock, a location selector is displayed on the :doc:`product
-     <../products>` and :doc:`checkout <checkout>` pages. Customers cannot select a pickup location
+     <products>` and :doc:`checkout <checkout>` pages. Customers cannot select a pickup location
      if the product is out of stock at that location. The :ref:`Continue selling
      <ecommerce/products/stock-management>` option for out-of-stock products is not supported.
    - If the :ref:`Show Available Qty <ecommerce/products/stock-management>` option is enabled for a

content/applications/websites/website/configuration/multi_website.rst

@@ -124,8 +124,8 @@ Customer accounts
 -----------------
 
 You can :doc:`allow your customers to use the same account
-<../../ecommerce/ecommerce_management/customer_accounts>` on all of your websites by enabling the
-:guilabel:`Shared Customer Accounts` check box in the website settings.
+<../../ecommerce/customer_accounts>` on all of your websites by enabling the :guilabel:`Shared
+Customer Accounts` check box in the website settings.
 
 Pricing
 -------

redirects/17.0.txt

@@ -128,6 +128,15 @@ applications/websites/ecommerce/managing_products/catalog.rst applications/websi
 applications/websites/ecommerce/managing_products/variants.rst applications/websites/ecommerce/products/variants.rst
 applications/websites/ecommerce/managing_products/price_management.rst applications/websites/ecommerce/products/price_management.rst
 applications/websites/ecommerce/managing_products/cross_upselling.rst applications/websites/ecommerce/products/cross_upselling.rst
+applications/websites/ecommerce/ecommerce_management/order_handling.rst applications/websites/ecommerce/order_handling.rst
+applications/websites/ecommerce/ecommerce_management/customer_accounts.rst applications/websites/ecommerce/customer_accounts.rst
+applications/websites/ecommerce/ecommerce_management/customer_interaction.rst applications/websites/website/web_design/building_blocks.rst
+applications/websites/ecommerce/ecommerce_management/performance.rst applications/websites/ecommerce/performance.rst
+applications/websites/ecommerce/checkout_payment_shipping/cart.rst applications/websites/ecommerce/cart.rst
+applications/websites/ecommerce/checkout_payment_shipping/checkout.rst applications/websites/ecommerce/checkout.rst
+applications/websites/ecommerce/checkout_payment_shipping/payments.rst applications/websites/ecommerce/payments.rst
+applications/websites/ecommerce/checkout_payment_shipping.rst applications/websites/ecommerce.rst
+applications/websites/ecommerce/ecommerce_management.rst applications/websites/ecommerce.rst
 
 # applications/finance