From 79878321d6902a3ae52b0c00d12d257ea20cff37 Mon Sep 17 00:00:00 2001 From: "Donatienne (dopi)" Date: Fri, 12 Apr 2024 15:55:28 +0200 Subject: [PATCH] [IMP] website: redirects taskid-3667291 closes odoo/documentation#9129 X-original-commit: d2ba715df8ab267ef25e8db8feb0878211493c73 Signed-off-by: Audrey Vandromme (auva) Signed-off-by: Donatienne Pirlot (dopi) --- .../applications/websites/website/pages.rst | 81 ++++++++++--------- 1 file changed, 43 insertions(+), 38 deletions(-) diff --git a/content/applications/websites/website/pages.rst b/content/applications/websites/website/pages.rst index da08cd1a7..87348f548 100644 --- a/content/applications/websites/website/pages.rst +++ b/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 `, 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 `, 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 `, 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 ` 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 ` properties, access the page you wish to +modify, then go to :menuselection:`Site --> Properties`. The :guilabel:`Name` tab allows you to: @@ -134,23 +136,23 @@ 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 `, :ref:`modify its URL `, or move -your site to a new :doc:`domain `. 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 `, :ref:`modify its URL `, or +migrate your site from another platform to an Odoo :doc:`domain `. It +can also be used to improve :doc:`pages/seo`. To access existing URL redirections and create new ones, :doc:`activate the 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 ` 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 `. To create a new redirection, click the :guilabel:`New` button, then fill in the fields: @@ -158,30 +160,33 @@ To create a new redirection, click the :guilabel:`New` button, then fill in the - :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 `. 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 + `. 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 ` 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 - ` or :ref:`deleted `. +.. important:: + 404, 301, and 302 redirections are meant to migrate traffic from + :ref:`unpublished ` or :ref:`deleted ` pages + to *new* pages, while the 308 redirect is used for *permanent* redirections of *existing* pages. .. seealso:: - `Google documentation on redirects and search `_