[IMP] general: merge all docs about unsplash into one doc

This commit is part of a larger work to improve the documentation's
structure. The toctree structure used to add levels to create categories
and make the structure visually more understandable.
With the new version of the documentation, plenty of these categories
are now redundant.

This commit merges all docs about unsplash into a single doc:
- "unsplash/unsplash_access_key" -> unsplash
- "unsplash/unsplash_application_id" -> unsplash

task-2535899
This commit is contained in:
Jonathan Castillo 2021-05-27 18:11:23 +02:00 committed by Antoine Vandevenne (anv)
parent 2b6f89f26e
commit 8c036a0321
12 changed files with 64 additions and 61 deletions

View File

@ -6,7 +6,6 @@ General
.. toctree::
general/odoo_basics
general/unsplash
general/base_import
general/multi_companies
general/auth
@ -15,4 +14,5 @@ General
general/voip
general/in_app_purchase
general/developer_mode
general/unsplash
general/mobile

View File

@ -2,8 +2,65 @@
Unsplash
========
.. toctree::
:titlesonly:
Generate an Unsplash access key
===============================
unsplash/unsplash_access_key
unsplash/unsplash_application_id
.. 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.

View File

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 28 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 47 KiB

View File

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

View File

Before

Width:  |  Height:  |  Size: 8.5 KiB

After

Width:  |  Height:  |  Size: 8.5 KiB

View File

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 25 KiB

View File

Before

Width:  |  Height:  |  Size: 39 KiB

After

Width:  |  Height:  |  Size: 39 KiB

View File

@ -1,37 +0,0 @@
=======================================================
How to generate an Unsplash access key
=======================================================
.. tip::
**As an 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:: media/create_app.png
:align: center
- Accept the conditions and click on **Accept terms**.
.. image:: media/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:: media/app_infos.png
:align: center
- You should be redirected to your application details page. Scroll down a bit to find your **access key**.
.. image:: media/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.
.. seealso::
* :doc:`unsplash_application_id`

View File

@ -1,19 +0,0 @@
=======================================================
How to generate an Unsplash application ID
=======================================================
.. tip::
You should first create and set up your Unsplash application with this tutorial: :doc:`unsplash_access_key`.
- Go to your `applications dashboard <https://unsplash.com/oauth/applications>`_ and click on your newly created Unsplash application under **Your applications**.
.. image:: media/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:: media/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.

View File

@ -200,5 +200,7 @@ applications/general/in_app_purchase/in_app_purchase.rst applications/general/in
applications/general/tags/take_tags.rst applications/general/tags.rst # tags/take_tags -> tags
applications/general/multi_companies/manage_multi_companies.rst applications/general/multi_companies.rst # multi_companies/manage_multi_companies -> multi_companies
applications/general/payment_acquirers/payment_acquirers.rst applications/general/payment_acquirers.rst # payment_acquirers/payment_acquirers -> payment_acquirers
applications/general/unsplash/unsplash_access_key.rst applications/general/unsplash.rst # unsplash/unsplash_access_key -> unsplash
applications/general/unsplash/unsplash_application_id.rst applications/general/unsplash.rst # unsplash/unsplash_application_id -> unsplash
applications/finance/sign/overview/signature_validity.rst applications/finance/sign.rst #sign/overview/signature_validity -> sign/*