documentation/content/applications/general/calendars/google/google_calendar_credentials.rst
Antoine Vandevenne (anv) 250bc3ab21 [MOV] content/*: move resource files into their related page's directory
Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2066
2022-05-20 14:48:37 +02:00

91 lines
3.1 KiB
ReStructuredText

=====================================
Synchronize Google Calendar with Odoo
=====================================
Odoo is perfectly integrated with Google Calendar so that you
can see & manage your meetings from both platforms
(updates go through both directions).
Setup in Google
===============
- Go to `Google APIs platform <https://console.developers.google.com>`__
to generate Google Calendar API credentials. Log in with your Google account.
- Go to the API & Services page.
.. image:: google_calendar_credentials/google_calendar_credentials00.png
:align: center
- Search for *Google Calendar API* and select it.
.. image:: google_calendar_credentials/google_calendar_credentials01.png
:align: center
.. image:: google_calendar_credentials/google_calendar_credentials02.png
:align: center
- Enable the API.
.. image:: google_calendar_credentials/google_calendar_credentials03.png
:align: center
- Select or create an API project to store the credentials if not yet done
before. Give it an explicit name (e.g. Odoo Sync).
- Create credentials.
.. image:: google_calendar_credentials/google_calendar_credentials04.png
:align: center
- Select *Web browser (Javascript)*
as calling source and *User data* as kind of data.
.. image:: google_calendar_credentials/google_calendar_credentials05.png
:align: center
- Then you can create a Client ID.
Enter the name of the application (e.g. Odoo Calendar) and the allowed pages on
which you will be redirected. The *Authorized JavaScript origin* is your
Odoo's instance URL. The *Authorized redirect URI* is your Odoo's instance
URL followed by '/google_account/authentication'.
.. image:: google_calendar_credentials/google_calendar_credentials06.png
:align: center
- Go through the Consent Screen step by entering a product name
(e.g. Odoo Calendar). Feel free to check the customizations options
but this is not mandatory. The Consent Screen will only show up when you
enter the Client ID in Odoo for the first time.
- Finally you are provided with your **Client ID**. Go to *Credentials* to
get the **Client Secret** as well. Both of them are required in Odoo.
.. image:: google_calendar_credentials/google_calendar_credentials07.png
:align: center
Setup in Odoo
=============
- Install the **Google Calendar** App from the *Apps* menu or by checking
the option in :menuselection:`Settings --> General Settings`.
.. image:: google_calendar_credentials/google_calendar_credentials08.png
:align: center
- Go to :menuselection:`Settings --> General Settings` and enter your
**Client ID** and **Client Secret** in Google Calendar option.
.. image:: google_calendar_credentials/google_calendar_credentials09.png
:align: center
- The setup is now ready. Open your Odoo Calendar and sync with Google.
The first time you do it you are redirected to Google to authorize
the connection. Once back in Odoo, click the sync button again.
You can click it whenever you want to synchronize your calendar.
.. image:: google_calendar_credentials/google_calendar_credentials10.png
:align: center
As of now you no longer have excuses to miss a meeting!