10000 [FW][IMP] Website: pages doc to be updated by fw-bot · Pull Request #9118 · odoo/documentation · GitHub
[go: up one dir, main page]
Skip to content

[FW][IMP] Website: pages doc to be updated #9118

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

[FW][IMP] Website: pages doc to be updated #9118

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
[IMP] Website: pages doc to be updated 
taskid-3667291

X-original-commit: a261ffd
  • Loading branch information
@Donapi
Donapi committed May 2, 2024
commit d15f0ec60a01db907abe62078a93058336cfc38b
81 changes: 43 additions & 38 deletions content/applications/websites/website/pages.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
=============
Expand All @@ -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`.
Expand All @@ -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
Expand All @@ -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:

Expand Down Expand Up @@ -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 5B24 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>`_
Expand Down
0