[IMP] website: "pages" page

Adding a documentation on "pages" within the already existing "page"
toctree

task-3383323

closes odoo/documentation#5305

X-original-commit: e314289fc4
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
Co-authored-by: Toaa <toaa@odoo.com>
Co-authored-by: Auva <auva@odoo.com>

content/applications/websites/website/pages.rst

@@ -1,9 +1,192 @@
-:nosearch:
+:show-content:
 
 =====
 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.
+
+Page creation
+=============
+
+Website pages can be created from the **frontend** and the **backend**. To create a new website
+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.
+  #. Click :guilabel:`Create`.
+  #. Customize the page's content and appearance using the website builder, then click
+     :guilabel:`Save`.
+  #. :ref:`Publish <website/un-publish-page>` the page.
+
+.. note::
+   Disable :guilabel:`Add to menu` if the page should not appear in the menu.
+
+Page management
+===============
+
+.. _website/un-publish-page:
+
+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`
+to :guilabel:`Published`, or vice versa.
+
+.. image:: pages/un-published_toggle.png
+   :alt: Unpublished/Published toggle
+
+.. note::
+   It is also possible to:
+
+    - 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
+      :guilabel:`Unpublish`.
+
+Homepage
+--------
+
+By default, when you create a website, Odoo creates a dedicated :guilabel:`Home` page, 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`.
+
+.. _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`.
+
+The :guilabel:`Name` tab allows you to:
+
+- rename the page using the :guilabel:`Page Name` field;
+- modify the :guilabel:`Page URL`. In this case, you can redirect the old URL to the new one if
+  needed. To do so, enable :guilabel:`Redirect Old URL`, then select the :guilabel:`Type` of
+  :ref:`redirection <website/URL-redirection>`:
+
+  - :guilabel:`301 Moved permanently`: to redirect the page permanently;
+  - :guilabel:`302 Moved temporarily`: to redirect the page temporarily.
+
+  .. image:: pages/page-redirection.png
+     :alt: Redirect old URL
+
+You can further adapt the page's properties in the :guilabel:`Publish` tab:
+
+- :guilabel:`Show in Top Menu`: Disable if you don't want the page to appear in the menu;
+- :guilabel:`Use as Homepage`: Enable if you want the page to be the homepage of your website;
+- :guilabel:`Indexed`: Disable if you don't want the page to be shown in search engine results;
+- :guilabel:`Published`: Enable to publish the page;
+- :guilabel:`Publishing Date`: To publish the page at a specific moment, select the date,
+  click the clock icon to set the time, then click the green check mark to validate your selection.
+- :guilabel:`Visibility`: Select who can access the page:
+
+  - :guilabel:`All`
+  - :guilabel:`Signed In`
+  - :guilabel:`Restricted Group`: Select the :doc:`user access group(s)
+    </applications/general/users/access_rights>` in the :guilabel:`Authorized group` field.
+  - :guilabel:`With Password`: Enter the password in the :guilabel:`Password` field.
+
+.. tip::
+   *Some* of these properties can also be modified from :menuselection:`Website --> Site --> Pages`.
+
+Duplicating pages
+~~~~~~~~~~~~~~~~~
+
+To duplicate a page, access the page, then go to :menuselection:`Site --> Properties` and click
+:guilabel:`Duplicate Page`. Enter a :guilabel:`Page Name`, then click :guilabel:`OK`. By default,
+the new page is added after the duplicated page in the menu, but you can remove it from the menu or
+change its position using the menu editor.
+
+.. _website/delete-page:
+
+Deleting pages
+~~~~~~~~~~~~~~
+
+To delete a page, proceed as follows:
+
+#. Access the page, then go to :menuselection:`Site --> Properties` and click :guilabel:`Delete
+   Page`.
+#. A pop-up window appears on the screen with all links referring to the page you want to delete,
+   organized by category. To ensure website visitors don't land on a 404 error page, you must update
+   all the links on your website referring to the page. To do so, expand a category, then click on a
+   link to open it in a new window. Alternatively, you can set up a :ref:`redirection
+   <website/URL-redirection>` for the deleted page.
+#. Once you have updated the links (or set up a :ref:`redirection <website/URL-redirection>`),
+   select the :guilabel:`I am sure about this` check box, then click :guilabel:`OK`.
+
+.. _website/URL-redirection:
+
+URL redirects
+-------------
+
+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 </administration/maintain/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
+     <website/page_properties>` and enable :guilabel:`Redirect Old URL`.
+   - You can set up redirections for static and dynamic pages.
+
+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.
+   - :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`.
+
+- :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://`).
+- :guilabel:`Website`: Select a specific website.
+- :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>`.
+
+.. seealso::
+   - `Google documentation on redirects and search <https://developers.google.com/search/docs/crawling-indexing/301-redirects>`_
+   - :doc:`pages/seo`
+
 .. toctree::
    :titlesonly: