[MERGE] Forward-port of branch 13.0 to 14.0

2021-07-07 15:39:35 +02:00
parent cc8c33c848 16418c020b
commit be1653cc51
220 changed files with 1841 additions and 2574 deletions
@@ -0,0 +1,66 @@
+======================
+Unsplash (free images)
+======================
+
+Generate an Unsplash access key
+===============================
+
+.. tip::
+   **As a SaaS user**, you are ready to use Unsplash. You won't need to follow this guide to set up
+   Unsplash information since you will use our own Odoo Unsplash key in a transparent way.
+
+Generate an Unsplash access key for non-Saas users
+--------------------------------------------------
+
+- Create an account on `Unsplash.com <https://unsplash.com/join>`_.
+
+- Go to your `applications dashboard <https://unsplash.com/oauth/applications>`_ and click on **New
+  Application**.
+
+.. image:: unsplash/create_app.png
+   :align: center
+
+- Accept the conditions and click on **Accept terms**.
+
+.. image:: unsplash/accept_terms.png
+   :align: center
+
+- You will be prompted to insert an **Application name** and a **Description**. Please prefix your
+  application name by "**Odoo:** " so that Unsplash can recognize it as an Odoo instance. Once done,
+  click on **Create application**.
+
+.. image:: unsplash/app_infos.png
+   :align: center
+
+- You should be redirected to your application details page. Scroll down a bit to find your **access
+  key**.
+
+.. image:: unsplash/access_key.png
+   :align: center
+
+.. warning::
+   **As a non-SaaS user**, you won't be able to register for a production Unsplash key and will be
+   limited to your test key that has a restriction of 50 Unsplash requests per hour.
+
+Generate an Unsplash application ID
+===================================
+
+.. tip::
+   You should first create and set up your Unsplash application.
+
+- Go to your `applications dashboard <https://unsplash.com/oauth/applications>`_ and click on your
+  newly created Unsplash application under **Your applications**.
+
+.. image:: unsplash/select_app.png
+    :align: center
+
+- You will be redirected to your application details page. The **application ID** will be visible in
+  your browser's URL. The URL should be something like
+  ``https://unsplash.com/oauth/applications/<application_id>``
+
+.. image:: unsplash/app_id_url.png
+   :align: center
+
+.. warning::
+   **As a non-SaaS user**, you won't be able to register for a production Unsplash key and will be
+   limited to your test key that has a 50 Unsplash requests per hour restriction.