[ADD]document_url_google_drive: attach document from Google Drive

2025-12-25 22:47:44 -06:00 · 2023-11-09 22:11:33 +02:00
parent 82b8383a8d
commit ea29d68258
29 changed files with 962 additions and 0 deletions
--- a/document_url_google_drive/README.rst
+++ b/document_url_google_drive/README.rst
@@ -0,0 +1,141 @@
+===========================
+Google Drive URL Attachment
+===========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:e7df1efead13f8fba62e6369e05f7f52b812a1d44741ab2832e9597f6ac748d9
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fknowledge-lightgray.png?logo=github
+    :target: https://github.com/OCA/knowledge/tree/16.0/document_url_google_drive
+    :alt: OCA/knowledge
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/knowledge-16-0/knowledge-16-0-document_url_google_drive
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/knowledge&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module extends the functionality of the document_url module and
+allows you to attach a link to a file from your Google Drive
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To configure this module, you need to:
+
+-  Go to Settings -> General Settings and scroll down to the
+   Integrations section.
+
+-  Enable "Google API", save. Setup instructions
+   https://developers.google.com/drive/picker/guides/overview
+
+   -  "Google Client ID" - enter the client ID from the Google API
+      console:
+      https://developers.google.com/identity/oauth2/web/guides/get-google-api-clientid
+   -  "Google API key" - enter the API key from the Google API console.
+   -  "Google App ID" - enter the ID of the Google application. The
+      default value is ``odoo``.
+
+You will be asked to authenticate when you add a link for the first
+time.
+
+|Configuration|
+
+**To modify your personal login credentials later**
+
+-  Open your user profile and set up personal access credentials on the
+   "Google API" tab.
+
+   -  field "Google Scope" - enter the scope for the Google API. The
+      default value is
+      ``https://www.googleapis.com/auth/drive.readonly``.
+   -  field "Google Access Token" - your token will be displayed here.
+      It is necessary to edit it.
+   -  field "Google Mime Types" - enter the file formats to be filtered
+      when selecting. Example:
+      ``application/pdf, image/jpeg, image/png``. By default, all files
+      are selected
+
+   You can always log off from the current Google Account by clicking
+   the "logout" icon right to the "Add GDrive link".
+
+.. |Configuration| image:: https://raw.githubusercontent.com/OCA/knowledge/16.0/document_url_google_drive/static/img/google_api_settings.png
+
+Usage
+=====
+
+To use this module, you need to:
+
+1. Open the form view of an object (Example: Customer Invoice
+   INV/2019/0007).
+2. Go to the chatter and click on the attached icon.
+3. Click **Add GDrive link**.
+4. Fill the wizard fields and click on Add button.
+5. In the open window, select the files you need and press the select
+   button.
+6. You will see a new **URL attachment** in the set of attachments
+   related to the object.
+7. In order to log in under another google user, click on the logout
+   icon located after **Add GDrive link**
+
+|Google Drive Link|
+
+.. |Google Drive Link| image:: https://raw.githubusercontent.com/OCA/knowledge/16.0/document_url_google_drive/static/img/gdrive_link.png
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/knowledge/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/knowledge/issues/new?body=module:%20document_url_google_drive%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* Cetmix
+
+Contributors
+------------
+
+Cetmix <cetmix.com> Ivan Sokolov Mykola Demchuk
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+This module is part of the `OCA/knowledge <https://github.com/OCA/knowledge/tree/16.0/document_url_google_drive>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.