[IMP] website: redirects

taskid-3667291

closes #9129

X-original-commit: d2ba715
Signed-off-by: Audrey Vandromme (auva) <[email protected]>
Signed-off-by: Donatienne Pirlot (dopi) <[email protected]>

Author: Donapi

content/applications/websites/website/pages.rst

@@ -7,12 +7,13 @@ Pages
 Odoo allows you to create pages for your website and customize their content and appearance to your
 needs.
 
-.. note::
-   *Static* pages are pages that have stable content, such as the homepage. You can manually create
-   new ones, define their URL, adapt their :ref:`properties <website/page_properties>`, etc.
-   *Dynamic* pages, on the other hand, are generated dynamically. All pages generated automatically
-   by Odoo, for example when you install an app or module (e.g., `/shop` or `/blog`) or publish a
-   new product or blog post, are dynamic pages and are therefore managed differently.
+.. _website/page_type:
+
+**Static** pages have stable content, such as the homepage. You can manually create new ones, define
+their URLs, adapt their :ref:`properties <website/page_properties>`, etc. **Dynamic** pages, on the
+other hand, are generated dynamically. All pages generated automatically by Odoo, for example, when
+you install an app or module (e.g., `/shop` or `/blog`) or publish a new product or blog post, are
+dynamic pages and are therefore managed differently.
 
 Page creation
 =============
@@ -23,7 +24,7 @@ page, proceed as follows:
   #. - Either open the **Website** app, click :guilabel:`+ New` in the top-right corner, then select
        :guilabel:`Page`;
      - Or go to :menuselection:`Website --> Site --> Pages` and click :guilabel:`New`.
-  #. Enter a :guilabel:`Page Title`; this title is used in the menu, as well as in the page's URL.
+  #. Enter a :guilabel:`Page Title`; this title is used in the menu and the page's URL.
   #. Click :guilabel:`Create`.
   #. Customize the page's content and appearance using the website builder, then click
      :guilabel:`Save`.
@@ -41,7 +42,7 @@ Publishing/unpublishing pages
 -----------------------------
 
 Pages need to be published to make them accessible to website visitors. To publish or unpublish a
-page, access it, then toggle the switch in the upper-right corner from :guilabel:`Unpublished`
+page, access it and toggle the switch in the upper-right corner from :guilabel:`Unpublished`
 to :guilabel:`Published`, or vice versa.
 
 .. image:: pages/un-published_toggle.png
@@ -53,27 +54,28 @@ to :guilabel:`Published`, or vice versa.
     - publish/unpublish a page from the :ref:`page properties <website/page_properties>`, where you
       can define a publishing date and/or restrict the page's visibility if needed;
     - publish/unpublish several pages at once: go to :menuselection:`Website --> Site --> Pages`,
-      select the pages, then, click :guilabel:`Action` and select :guilabel:`Publish` or
+      select the pages, then click :guilabel:`Action` and select :guilabel:`Publish` or
       :guilabel:`Unpublish`.
 
 Homepage
 --------
 
-By default, when you create a website, Odoo creates a dedicated :guilabel:`Home` page, but you can
+When you create a website, Odoo creates a dedicated :guilabel:`Home` page by default, but you can
 define any website page as your homepage. To do so, go to :menuselection:`Website --> Configuration
 --> Settings`, then, in the :guilabel:`Website info` section, define the URL of the desired page in
 the field :guilabel:`Homepage URL` (e.g., `/shop`).
 
-Alternatively, you can define any static page as your homepage by going to :menuselection:`Website
---> Site --> Properties`. Select the :guilabel:`Publish` tab and enable :guilabel:`Use as Homepage`.
+Alternatively, you can define any :ref:`static page <website/page_type>` as your homepage by going
+to :menuselection:`Website --> Site --> Properties`. Select the :guilabel:`Publish` tab and enable
+:guilabel:`Use as Homepage`.
 
 .. _website/page_properties:
 
 Page properties
 ---------------
 
-To modify a static page's properties, access the page you wish to modify, then go to
-:menuselection:`Site --> Properties`.
+To modify a :ref:`static page's <website/page_type>` properties, access the page you wish to
+modify, then go to :menuselection:`Site --> Properties`.
 
 The :guilabel:`Name` tab allows you to:
 
@@ -134,54 +136,57 @@ To delete a page, proceed as follows:
 
 .. _website/URL-redirection:
 
-URL redirects
--------------
+URL redirect mapping
+--------------------
 
-Redirecting URLs consists in sending visitors and search engines to a URL that is different from the
-one they originally requested. This technique is used, for example, to prevent broken links when you
-:ref:`delete a page <website/delete-page>`, :ref:`modify its URL <website/page_properties>`, or move
-your site to a new :doc:`domain <configuration/domain_names>`. It can also be used to
-improve :doc:`pages/seo`.
+URL redirect mapping consists in sending visitors and search engines to a URL different from
+the one they initially requested. This technique is used, for example, to prevent broken links when
+you :ref:`delete a page <website/delete-page>`, :ref:`modify its URL <website/page_properties>`, or
+migrate your site from another platform to an Odoo :doc:`domain <configuration/domain_names>`. It
+can also be used to improve :doc:`pages/seo`.
 
 To access existing URL redirections and create new ones, :doc:`activate the developer mode
 </applications/general/developer_mode>` and go to :menuselection:`Website --> Configuration -->
 Redirects`.
 
 .. note::
-   - A record is added automatically every time you :ref:`modify a page's URL
+   - A redirect record is added automatically every time you :ref:`modify a page's URL
      <website/page_properties>` and enable :guilabel:`Redirect Old URL`.
-   - You can set up redirections for static and dynamic pages.
+   - You can set up redirections for :ref:`static and dynamic pages <website/page_type>`.
 
 To create a new redirection, click the :guilabel:`New` button, then fill in the fields:
 
 - :guilabel:`Name`: Enter a name to identify the redirect.
 - :guilabel:`Action`: Select the type of redirection:
 
    - :guilabel:`404 Not found`: visitors are redirected to a 404 error page when they try to access
-     the page.
-   - :guilabel:`301 Moved Permanently`: for permanent redirections of static pages; the new URL is
-     shown in search engine results and the redirect is cached by browsers.
+     an unpublished or deleted page.
+   - :guilabel:`301 Moved Permanently`: for permanent redirections of unpublished or deleted
+     :ref:`static pages <website/page_type>`. The new URL is shown in search engine results, and the
+     redirect is cached by browsers.
    - :guilabel:`302 Moved Temporarily`: for short-term redirections, for example, if you are
-     redesigning or updating the page. The new URL is neither cached by browsers, nor shown in
-     search engine results.
-   - :guilabel:`308 Redirect / Rewrite`: for permanent redirections of dynamic pages; the new URL is
-     shown in search engine results and the redirect is cached by browsers. Use this redirect type
-     to rename a dynamic page, for example, if you wish to rename `/shop` into `/market`.
+     redesigning or updating a page. The new URL is neither cached by browsers nor shown in search
+     engine results.
+   - :guilabel:`308 Redirect/Rewrite`: for permanent redirections of existing :ref:`dynamic pages
+     <website/page_type>`. The URL is renamed; the new name is shown in search engine results and is
+     cached by browsers. Use this redirect type to rename a dynamic page, for example, if you wish
+     to rename `/shop` into `/market`.
 
 - :guilabel:`URL from`: Enter the URL to be redirected (e.g., `/about-the-company`) or search for
-  the desired dynamic page and select it from the list.
-- :guilabel:`URL to`: For 301, 302 and 308 redirects, enter the URL to be redirected to. If you want
-  to redirect to an external URL, make sure to include the protocol (e.g., `https://`).
+  the desired :ref:`dynamic page <website/page_type>` and select it from the list.
+- :guilabel:`URL to`: For 301, 302, and 308 redirects, enter the URL to be redirected to. If you want
+  to redirect to an external URL, include the protocol (e.g., `https://`).
 - :guilabel:`Website`: Select a specific website.
-- :guilabel:`Sequence`: to define the order in which redirections are performed, e.g., in the case
+- :guilabel:`Sequence`: To define the order in which redirections are performed, e.g., in the case
   of redirect chains (i.e., a series of redirects where one URL is redirected to another one, which
   is itself further redirected to another URL).
 
 Toggle the :guilabel:`Activate` switch to deactivate the redirection.
 
-.. note::
-   404, 301 and 302 redirections only work if the original page has been :ref:`unpublished
-   <website/un-publish-page>` or :ref:`deleted <website/delete-page>`.
+.. important::
+   404, 301, and 302 redirections are meant to migrate traffic from
+   :ref:`unpublished <website/un-publish-page>` or :ref:`deleted <website/delete-page>` pages
+   to *new* pages, while the 308 redirect is used for *permanent* redirections of *existing* pages.
 
 .. seealso::
    - `Google documentation on redirects and search <https://developers.google.com/search/docs/crawling-indexing/301-redirects>`_