documentation/content/applications/general/unsplash.rst
Jonathan Castillo 8c036a0321 [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
2021-06-04 13:51:18 +02:00

67 lines
2.2 KiB
ReStructuredText

========
Unsplash
========
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.