odoo-addon-dms 16.0.1.8.0.3__py3-none-any.whl → 17.0.1.0.0.2__py3-none-any.whl

odoo/addons/dms/views/menu.xml

@@ -2,33 +2,64 @@
 <!--
 
     Copyright 2017-2019 MuK IT GmbH
+    Copyright 2024 Subteno - Timothée Vannier (https://www.subteno.com).
     License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
 
-  -->
+-->
 <odoo>
-    <menuitem
+<menuitem
         id="main_menu_dms"
         name="Documents"
         web_icon="dms,static/description/icon.png"
         groups="group_dms_user"
-    />
-    <menuitem
-        id="cat_menu_dms_config"
-        name="Configuration"
-        parent="main_menu_dms"
-        sequence="50"
-    />
-    <menuitem
-        id="cat_menu_dms_config_organizing"
-        name="Organizing"
-        parent="cat_menu_dms_config"
-        sequence="5"
-    />
+    >
+    <menuitem id="menu_dms_file" name="Files" sequence="20" action="action_dms_file" />
     <menuitem
-        id="cat_menu_dms_config_system"
-        name="System"
-        groups="dms.group_dms_manager"
-        parent="cat_menu_dms_config"
-        sequence="25"
-    />
+            id="menu_dms_directory"
+            name="Directories"
+            sequence="30"
+            action="action_dms_directory"
+        />
+    <menuitem id="cat_menu_dms_config" name="Configuration" sequence="50">
+        <menuitem
+                id="menu_dms_settings_general"
+                name="General Settings"
+                sequence="0"
+                action="action_dms_settings_general"
+                groups="base.group_system"
+            />
+        <menuitem id="cat_menu_dms_config_organizing" name="Organizing" sequence="5">
+            <menuitem id="menu_dms_tag" name="Tags" action="action_dms_tag" />
+            <menuitem
+                    id="menu_dms_category"
+                    name="Categories"
+                    action="action_dms_category"
+                />
+        </menuitem>
+        <menuitem
+                id="cat_menu_dms_config_system"
+                name="System"
+                groups="dms.group_dms_manager"
+                sequence="25"
+            >
+            <menuitem
+                    id="menu_dms_storage"
+                    name="Storages"
+                    action="action_dms_storage"
+                    sequence="5"
+                />
+            <menuitem
+                    id="menu_dms_file_migration"
+                    name="Migration"
+                    action="action_dms_file_migration"
+                    sequence="8"
+                />
+            <menuitem
+                    id="menu_dms_access_groups"
+                    name="Access Groups"
+                    action="action_dms_access_groups"
+                />
+        </menuitem>
+    </menuitem>
+</menuitem>
 </odoo>

odoo/addons/dms/views/res_config_settings.xml

@@ -2,6 +2,7 @@
 <!--
 
     Copyright 2017-2019 MuK IT GmbH
+    Copyright 2024 Subteno - Timothée Vannier (https://www.subteno.com).
     License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
 
   -->
@@ -12,79 +13,35 @@
         <field name="priority" eval="20" />
         <field name="inherit_id" ref="base.res_config_settings_view_form" />
         <field name="arch" type="xml">
-            <xpath expr="//div[hasclass('settings')]" position="inside">
-                <div
-                    class="app_settings_block"
-                    data-string="Documents"
-                    data-key="dms"
-                    groups="base.group_system"
-                    string="Documents"
-                >
-                    <div name="dms_settings">
-                        <h2>File Upload</h2>
-                        <div class="row mt16 o_settings_container" name="file">
-                            <div class="col-12 col-md-6 o_setting_box">
-                                <div class="o_setting_right_pane">
-                                    <span class="o_form_label">File Size</span>
-                                    <div class="text-muted">
-                                        Define the maximum upload size of a
-                                        file in MB
-                                    </div>
-                                    <div class="content-group">
-                                        <div class="row mt16">
-                                            <label
-                                                class="col-md-3 o_light_label"
-                                                for="documents_binary_max_size"
-                                            />
-                                            <field name="documents_binary_max_size" />
-                                        </div>
-                                    </div>
-                                </div>
-                            </div>
-                            <div class="col-12 col-md-6 o_setting_box">
-                                <div class="o_setting_right_pane">
-                                    <span class="o_form_label">File
-                                        Extensions
-                                    </span>
-                                    <div class="text-muted">
-                                        Define forbidden file extensions
-                                    </div>
-                                    <div class="content-group">
-                                        <div class="row mt16">
-                                            <label
-                                                class="col-md-3 o_light_label"
-                                                for="documents_forbidden_extensions"
-                                            />
-                                            <field
-                                                name="documents_forbidden_extensions"
-                                                placeholder="exe,msi"
-                                            />
-                                        </div>
-                                    </div>
-                                </div>
-                            </div>
-                            <div class="col-12 col-md-6 o_setting_box">
-                                <div class="o_setting_right_pane">
-                                    <span class="o_form_label">
-                                        Storages
-                                    </span>
-                                    <div class="text-muted">
-                                        Show storages
-                                    </div>
-                                    <div class="content-group">
-                                        <button
-                                            name="%(dms.action_dms_storage)d"
-                                            string="Storages"
-                                            type="action"
-                                            class="oe_link"
-                                            icon="fa-arrow-right"
-                                        />
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </div>
+            <xpath expr="//form" position="inside">
+                <app string="Documents" groups="base.group_system" name="dms">
+                    <block title="File Upload">
+                        <setting
+                            string="File Size"
+                            help="Define the maximum upload size of a file in MB"
+                        >
+                            <field name="documents_binary_max_size" />
+                        </setting>
+                        <setting
+                            string="File Extensions"
+                            help="Define forbidden file extensions"
+                        >
+                            <field
+                                name="documents_forbidden_extensions"
+                                placeholder="exe,msi"
+                            />
+                        </setting>
+                        <setting string="Storages" help="Show storages">
+                            <button
+                                name="%(dms.action_dms_storage)d"
+                                string="Storages"
+                                type="action"
+                                class="oe_link"
+                                icon="fa-arrow-right"
+                            />
+                        </setting>
+                    </block>
+                </app>
             </xpath>
         </field>
     </record>
@@ -94,14 +51,6 @@
         <field name="res_model">res.config.settings</field>
         <field name="view_mode">form</field>
         <field name="target">inline</field>
-        <field name="context">{'module' : 'dms'}</field>
+        <field name="context">{'module': 'dms'}</field>
     </record>
-    <menuitem
-        id="menu_dms_settings_general"
-        name="General Settings"
-        parent="cat_menu_dms_config"
-        sequence="0"
-        action="action_dms_settings_general"
-        groups="base.group_system"
-    />
 </odoo>

odoo/addons/dms/views/storage.xml

@@ -2,6 +2,7 @@
 <!--
 
     Copyright 2017-2019 MuK IT GmbH
+    Copyright 2024 Subteno - Timothée Vannier (https://www.subteno.com).
     License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
 
   -->
@@ -115,7 +116,7 @@
                         name="action_storage_migrate"
                         type="object"
                         string="Migrate Files"
-                        attrs="{'invisible': [('save_type', '=', 'attachment')]}"
+                        invisible="save_type == 'attachment'"
                     />
                     <button
                         type="action"
@@ -169,18 +170,18 @@
                             <field name="is_hidden" />
                             <field
                                 name="inherit_access_from_parent_record"
-                                attrs="{'invisible': [('save_type', '!=', 'attachment')]}"
+                                invisible="save_type != 'attachment'"
                             />
                             <field
                                 name="include_message_attachments"
-                                attrs="{'invisible': [('save_type', '!=', 'attachment')]}"
+                                invisible="save_type != 'attachment'"
                             />
                         </group>
                         <group>
                             <field name="company_id" />
                             <field
                                 name="model_ids"
-                                attrs="{'invisible': [('save_type', '!=', 'attachment')]}"
+                                invisible="save_type != 'attachment'"
                             />
                         </group>
                     </group>
@@ -188,12 +189,12 @@
                         <page
                             name="page_roots"
                             string="Root Directories"
-                            attrs="{'invisible': [('id', '=', False)]}"
+                            invisible="not id"
                         >
                             <field
                                 name="root_directory_ids"
                                 groups="dms.group_dms_manager"
-                                context="{'hide_root_storage': True,'default_storage_id': active_id, 'default_is_root_directory': True}"
+                                context="{'hide_root_storage': True,'default_storage_id': id, 'default_is_root_directory': True}"
                             >
                                 <tree>
                                     <field name="name" />
@@ -221,13 +222,6 @@
             </p>
         </field>
     </record>
-    <menuitem
-        id="menu_dms_storage"
-        name="Storages"
-        parent="cat_menu_dms_config_system"
-        action="action_dms_storage"
-        sequence="5"
-    />
     <record id="view_dms_storage_new_form" model="ir.ui.view">
         <field name="name">dms_storage.form</field>
         <field name="model">dms.storage</field>

odoo_addon_dms-17.0.1.0.0.2.dist-info/METADATA

@@ -0,0 +1,257 @@
+Metadata-Version: 2.1
+Name: odoo-addon-dms
+Version: 17.0.1.0.0.2
+Requires-Python: >=3.10
+Requires-Dist: odoo>=17.0a,<17.1dev
+Summary: Document Management System for Odoo
+Home-page: https://github.com/OCA/dms
+License: LGPL-3
+Author: MuK IT, Tecnativa, Odoo Community Association (OCA)
+Author-email: support@odoo-community.org
+Classifier: Programming Language :: Python
+Classifier: Framework :: Odoo
+Classifier: Framework :: Odoo :: 17.0
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
+
+==========================
+Document Management System
+==========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:531f01b97db7166c170f62f0f28861e7635913bc1f5dbdb04e20d7f9d15f855c
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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-LGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
+    :alt: License: LGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fdms-lightgray.png?logo=github
+    :target: https://github.com/OCA/dms/tree/17.0/dms
+    :alt: OCA/dms
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/dms-17-0/dms-17-0-dms
+    :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/dms&target_branch=17.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+DMS is a module for creating, managing and viewing document files
+directly within Odoo. This module is only the basis for an entire
+ecosystem of apps that extend and seamlessly integrate with the document
+management system.
+
+This module adds portal functionality for directories and files for
+allowed users, both portal or internal users. You can get as well a
+tokenized link from a directory or a file for sharing it with any
+anonymous user.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Installation
+============
+
+Preview
+-------
+
+``python-magic`` library is recommended to be installed for having whole
+support to get proper file types and file preview.
+
+Configuration
+=============
+
+Configuration
+=============
+
+To configure this module, you need to:
+
+1. Create a storage
+-------------------
+
+1. Go to *Documents -> Configuration -> Storages*.
+
+2. Create a new document storage. You can choose between three options
+   on ``Save Type``:
+
+   -  ``Database``: Store the files on the database as a field
+   -  ``Attachment``: Store the files as attachments
+   -  ``File``: Store the files on the file system
+
+2. Create an access group
+-------------------------
+
+1. Next, create an administrative access group. Go to *Configuration ->
+   Access Groups*.
+
+   -  Create a new group, name it appropriately, and turn on all three
+      permissions (Create, Write and Unlink. Read is implied and always
+      enabled).
+   -  Add any other top-level administrative users to the group if
+      needed (your user should already be there).
+   -  You can create other groups in here later for fine-grained access
+      control.
+
+3. Create a directory
+---------------------
+
+1. Afterward, go to *Documents -> Directories*.
+
+2. Create a new directory, mark it as root and select the previously
+   created setting.
+
+   -  Select the *Groups* tab and add your administrative group created
+      above. If your directory was already created before the group, you
+      can also add it in the access groups (*Configuration -> Access
+      Groups*).
+
+3. In the directory settings, you can also add other access groups
+   (created above) that will be able to:
+
+   -  read
+   -  create
+   -  write
+   -  delete
+
+Migration
+=========
+
+If you need to modify the storage ``Save Type`` you might want to
+migrate the file data. To achieve it, you need to:
+
+1. Go to *Documents -> Configuration -> Storage* and select the storage
+   you want to modify
+2. Modify the save type
+3. Press the button Migrate files if you want to migrate all the files
+   at once
+4. Press the button Manual File Migration to specify files one by one
+
+You can check all the files that still need to be migrated from all
+storages and migrate them manually on *Documents -> Configuration ->
+Migration*
+
+File Wizard Selection
+=====================
+
+There is an action called ``action_dms_file_wizard_selector`` to open a
+wizard to list files in kanban view. This can be used (example
+dms_attachment_link module) to add a button in kanban view with the
+action we need.
+
+Usage
+=====
+
+The best way to manage the documents is to switch to the Documents view.
+Existing documents can be managed there and new documents can be
+created.
+
+Portal functionality
+--------------------
+
+You can add any portal user to DMS access groups, and then allow that
+group in directories, so they will see in the portal such directories
+and their files. Another possibility is to click on "Share" button
+inside a directory or a file for obtaining a tokenized link for single
+access to that resource, no matter if logged or not.
+
+Known issues / Roadmap
+======================
+
+-  Files preview in portal
+-  Allow to download folder in portal and create zip file with all
+   content
+-  Save in cache own_root directories and update in every
+   create/write/unlink function
+-  Add a migration procedure for converting an storage to attachment one
+   for populating existing records with attachments as folders
+-  Add a link from attachment view in chatter to linked documents
+-  If Inherit permissions from related record (the
+   inherit_access_from_parent_record field from storage) is changed when
+   directories already exist, inconsistencies may occur because groups
+   defined in the directories and subdirectories will still exist, all
+   groups in these directories should be removed before changing.
+-  Since portal users can read ``dms.storage`` records, if your module
+   extends this model to another storage backend that needs using
+   secrets, remember to forbid access to the secrets fields by other
+   means. It would be nice to be able to remove that rule at some point.
+-  Searchpanel in files: Highlight items (shading) without records when
+   filtering something (by name for example).
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/dms/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/dms/issues/new?body=module:%20dms%0Aversion:%2017.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
+-------
+
+* MuK IT
+* Tecnativa
+
+Contributors
+------------
+
+-  Mathias Markl <mathias.markl@mukit.at>
+-  Enric Tobella <etobella@creublanca.es>
+-  Antoni Romera
+-  Gelu Boros <gelu.boros@rgbconsulting.com>
+-  `Tecnativa <https://www.tecnativa.com>`__:
+
+   -  Víctor Martínez
+   -  Pedro M. Baeza
+   -  Jairo Llopis
+
+-  `Elego <https://www.elegosoft.com>`__:
+
+   -  Yu Weng <yweng@elegosoft.com>
+   -  Philip Witte <phillip.witte@elegosoft.com>
+   -  Khanh Bui <khanh.bui@mail.elegosoft.com>
+
+-  `Subteno <https://www.subteno.com>`__:
+
+   -  Timothée Vannier <tva@subteno.com>
+
+Other credits
+-------------
+
+Some pictures are based on or inspired by:
+
+-  `Roundicons <https://www.flaticon.com/authors/roundicons>`__
+-  `Smashicons <https://www.flaticon.com/authors/smashicons>`__
+-  `EmojiOne <https://github.com/EmojiTwo/emojitwo>`__ : Portal DMS icon
+-  `GitHub Octicons <https://github.com/primer/octicons/>`__ : The main
+   DMS icon
+
+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/dms <https://github.com/OCA/dms/tree/17.0/dms>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.