[IMP] install/maintain: new improved doc about domain names

task-id 2680490 closes odoo/documentation#1647 X-original-commit: d22f95362a Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com> Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-03-02 10:19:33 +00:00
parent b0abac76ec
commit fc308f3479
21 changed files with 333 additions and 131 deletions
@@ -10,6 +10,11 @@ eCommerce
 Run a modern open-source online store with Odoo eCommerce. Learn how to sell online, promote
 products and increase your average cart sizes.

+.. important::
+   Odoo offers a :ref:`free custom domain name <domain-name/odoo-register>` to all Odoo Online 
+   databases for one year. Visitors can then access your website with an address such as
+   ``www.example.com`` rather than the default ``example.odoo.com``.
+
 .. seealso::
   - `Odoo Tutorials: Website <https://www.odoo.com/slides/website-25>`_
   - `Odoo Tutorials: eCommerce <https://www.odoo.com/slides/ecommerce-26>`_
@@ -7,7 +7,6 @@ Launch my website
 .. toctree::
   :titlesonly:

-   ../website/publish/domain_name
   ../website/publish/on-premise_geo-ip-installation
   ../website/publish/translate

@@ -10,6 +10,12 @@ Website
 Discover the best **Open-Source Website Builder** and learn how to build beautiful websites that
 convert visitors into leads or revenues.

+.. important::
+   Odoo offers a :ref:`free custom domain name <domain-name/odoo-register>` to all Odoo Online 
+   databases for one year. Visitors can then access your website with an address such as
+   ``www.example.com`` rather than the default ``example.odoo.com``.
+
+
 .. seealso::
   - `Odoo Tutorials: Website <https://www.odoo.com/slides/website-25>`_
   - `Odoo Tutorials: eCommerce <https://www.odoo.com/slides/ecommerce-26>`_
@@ -7,9 +7,5 @@ Publish
 .. toctree::
   :titlesonly:

-   publish/domain_name
   publish/translate
   publish/multi_website
-
-
-
@@ -1,121 +0,0 @@
-=============================
-How to use my own domain name
-=============================
-
-By default, your Odoo Online instance and website have a *.odoo.com* domain name,
-for both the URL and the emails.
-But you can change to a custom one (e.g. www.yourcompany.com).
-
-What is a good domain name
-==========================
-Your website address is as important to your branding as the name of your
-business or organization, so put some thought into changing it for a proper
-domain. Here are some tips:
-
- Simple and obvious
- Easy to remember and spell
- The shorter the better
- Avoid special characters
- Aim for a .com and/or your country extension
-
-Read more: `How to Choose a Domain Name for Maximum SEO <https://www.searchenginejournal.com/choose-a-domain-name-maximum-seo/158951/>`__
-
-How to buy a domain name
-========================
-Buy your domain name at a popular registrar:
-
- `GoDaddy <https://www.godaddy.com>`__
- `Namecheap <https://www.namecheap.com>`__
- `OVH <https://www.ovh.com>`__
-
-.. note:: Steps to buy a domain name are pretty much straight forward.
-   In case of issue, check out those easy tutorials:
-
-   - `GoDaddy <https://roadtoblogging.com/buy-domain-name-from-godaddy>`__
-   - `Namecheap <https://www.loudtips.com/buy-domain-name-hosting-namecheap//>`__
-
-   Feel free to buy an email server to have email addresses using your domain name.
-   However don't buy any extra service to create or host your website.
-   This is Odoo's job!
-
-.. _custom_domain:
-
-
-How to apply my domain name to my Odoo instance
-===============================================
-First let's authorize the redirection (yourcompany.com -> yourcompany.odoo.com):
-
-* Open your Odoo.com account from your homepage.
-
-.. image:: media/domain_name01.png
-    :align: center
-
-* Go to the *Manage Databases* page.
-
-.. image:: media/domain_name02.png
-    :align: center
-
-* Click on *Domains* to the right of the database you would like to redirect.
-
-.. image:: media/domain_name03.png
-    :align: center
-
-* A database domain prompt will appear. Enter your custom domain
-  (e.g. www.yourcompany.com).
-
-
-.. image:: media/domain_name04.png
-    :align: center
-
-We can now apply the redirection from your domain name's manager account:
-
-* Log in to your account and search for the DNS Zones management page.
-
-* Create a CNAME record *www.yourdomain.com* pointing to *mywebsite.odoo.com*.
-  If you want to use the naked domain (e.g. yourdomain.com), you need to redirect
-  *yourdomain.com* to *www.yourdomain.com*.
-
-.. note:: Here are some specific guidelines to create a CNAME record:
-
-   - `GoDaddy <https://www.godaddy.com/help/add-a-cname-record-19236>`__
-   - `Namecheap <https://www.namecheap.com/support/knowledgebase/article.aspx/9646/10/how-can-i-set-up-a-cname-record-for-my-domain>`__
-   - `OVH <https://www.ovh.co.uk/g1519.exchange_20132016_how_to_add_a_cname_record>`__
-
-How to enable SSL (HTTPS) for my Odoo instance
-==============================================
-
-Until recently, Odoo users needed to use a third-party CDN service provider such as CloudFlare to enable SSL.
-
-It is not required anymore: Odoo generates the certificate for you automatically, using integration with `Let's Encrypt Certificate Authority and ACME protocol <https://letsencrypt.org/how-it-works/>`__.
-In order to get this, simply add your domain name in your customer portal (a separate certificate is generated for each domain name specified).
-
-.. warning::
-  **Please note that the certificate generation may take up to 24h.**
-
-If you already use CloudFlare or a similar service, you can keep using it or simply change for Odoo. The choice is yours.
-
-.. _app-website/web_base_url:
-
-How to make sure that all my URLs use my custom domain?
-=======================================================
-
-To set up the root URL of your website and of all the links sent in emails, you can ask an administrator of your database (any user in the *Settings* group) to perform a login from the login screen. It's as simple as that!
-
-If you want to do it manually, go to :menuselection:`Settings --> Technical --> System Parameters`.
-Find the entry called ``web.base.url`` (you can create it if it does not exist) and enter the full URL of your website, like ``https://www.myodoowebsite.com``.
-
-.. warning::
-  The URL must include the protocol (``https://`` or ``http://``) and must not end by a slash (``/``).
-
-If you want to block the root URL update when an administrator logs in, you can add a System Parameter called  ``web.base.url.freeze`` with its value set to  ``True``.
-
-
-My website is indexed twice by Google
-=====================================
-
-If you set up a custom domain *mydomain.com* name for *mydatabase.odoo.com*,
-Google indexes your website under both names. This is a limitation of the Odoo cloud platforms/
-
-.. seealso::
-
-  * :doc:`/applications/general/email_communication/email_servers`
@@ -46,7 +46,7 @@ website. Follow the purple drops; they will help you in the first steps.

 .. note::
   If you run Odoo Online, don’t forget to redirect any new domain name to your Odoo database
-   (``CNAME``) and to authorize it Odoo-side. See :doc:`domain_name`.
+   (``CNAME``) and to authorize it Odoo-side. See :ref:`domain-name/existing`.

 Create the menu
 ===============
@@ -124,7 +124,7 @@ be redirected to the right website using GeoIP.
  See :doc:`on-premise_geo-ip-installation`

 .. seealso::
-   - :doc:`domain_name`
+   - :doc:`/administration/maintain/domain_names`

 Customize the visitor experience
 ================================