[19.0][MIG] announcement: Migration to 19.0

announcement/README.rst

@@ -0,0 +1,137 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+============
+Announcement
+============
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:e8e3b291ae957eb17175e8c37b94d1a44110a11cbc32f48d997c96702cbe167c
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/license-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%2Fserver--ux-lightgray.png?logo=github
+    :target: https://github.com/OCA/server-ux/tree/19.0/announcement
+    :alt: OCA/server-ux
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/server-ux-19-0/server-ux-19-0-announcement
+    :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/server-ux&target_branch=19.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module adds popup announcements in the backend for targeted
+internal users. Those announcements can contain rich format and a user
+read log is kept for everyone.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To create new announcements a user should be in the *Announcements
+Managers* group. When your user has such permissions, this is the way to
+create an announcement:
+
+1. Go to *Discuss > Announcements*
+2. Create a new one and define a title. This title will be shown in the
+   announcement header.
+3. Define the announcement scope:
+
+   - Specific users: manually select which users will see the
+     announcement.
+   - User groups: users from the selected groups will be the ones to see
+     the announcement.
+
+4. Define the announcement body. You can use rich formatting and event
+   paste your own html (editor in debug mode).
+5. By default, the announcement will be archived. This is to prevent the
+   announcement to show up before time.
+6. Once the announcement is ready, unarchive it going to the *Actions*
+   menu an choosing the *Unarchive* option.
+7. Optionally you can set an announcement date to schedule the
+   announcement. The announcement won't show up until that date.
+8. If the announcement doesn't make sense once a date is passed, you can
+   set a due date. From that date, the announcement won't be shown to
+   anyone.
+
+Usage
+=====
+
+When a user in the scope of active announcements logs in, those will
+popup. The user has to mark them as read to continue working. If the
+announcement is set during the user session, the announcement will be
+eventually prompted in the top bar on the right part. The user click on
+the unread announcements icon (a speaker) and the announcements will
+popup for the user to check them.
+
+Users can go *Discuss > Announcements* to check current and past
+announcements. Announcement managers can also track which users have
+read the announcement.
+
+Known issues / Roadmap
+======================
+
+- It could be integrated in Discuss app to review past announcements.
+- Log other information like geolocation, IP, browser agent, etc when
+  marking announcement as read.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-ux/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/server-ux/issues/new?body=module:%20announcement%0Aversion:%2019.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
+-------
+
+* Tecnativa
+
+Contributors
+------------
+
+- `Tecnativa <https://www.tecnativa.com>`__:
+
+  - Pedro M. Baeza
+  - David Vidal
+  - Carlos Roca
+  - David Bañón Gil
+
+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/server-ux <https://github.com/OCA/server-ux/tree/19.0/announcement>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

announcement/__init__.py

@@ -0,0 +1,2 @@
+from . import models
+from . import wizards

announcement/__manifest__.py

@@ -0,0 +1,30 @@
+# Copyright 2022 Tecnativa - David Vidal
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Announcement",
+    "version": "19.0.1.0.0",
+    "summary": "Notify internal users about relevant organization stuff",
+    "author": "Tecnativa, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "category": "Server UX",
+    "website": "https://github.com/OCA/server-ux",
+    "depends": ["mail"],
+    "data": [
+        "security/announcement_security.xml",
+        "security/ir.model.access.csv",
+        "views/announcement_views.xml",
+        "views/announcement_tag_views.xml",
+        "wizards/read_announcement_wizard.xml",
+    ],
+    "demo": [
+        "demo/announcement_tag_demo.xml",
+    ],
+    "assets": {
+        "web.assets_backend": [
+            "announcement/static/src/js/announcement_dialog/**/*",
+            "announcement/static/src/js/announcement_menu/**/*",
+            "announcement/static/src/js/announcement_service/**/*",
+        ],
+    },
+}

announcement/demo/announcement_tag_demo.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<odoo>
+    <record id="announcement_tag_1" model="announcement.tag">
+        <field name="name">Company information</field>
+        <field name="color" eval="1" />
+    </record>
+    <record id="announcement_tag_2" model="announcement.tag">
+        <field name="name">Employees</field>
+        <field name="color" eval="2" />
+    </record>
+    <record id="announcement_tag_3" model="announcement.tag">
+        <field name="name">Accounting</field>
+        <field name="color" eval="3" />
+    </record>
+    <record id="announcement_tag_4" model="announcement.tag">
+        <field name="name">Sales</field>
+        <field name="color" eval="4" />
+    </record>
+    <record id="announcement_tag_5" model="announcement.tag">
+        <field name="name">Manufacturing</field>
+        <field name="color" eval="5" />
+    </record>
+</odoo>