============
Announcement
============
.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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%2Fserver--ux-lightgray.png?logo=github
:target: https://github.com/OCA/server-ux/tree/13.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-13-0/server-ux-13-0-announcement
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
:target: https://runbot.odoo-community.org/runbot/250/13.0
:alt: Try me on Runbot
|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:
#. Go to *Discuss > Announcements*
#. Create a new one and define a title. This title will be shown in the announcement
header.
#. 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.
#. Define the announcement body. You can use rich formatting and event paste your
own html (editor in debug mode).
#. By default, the announcement will be archived. This is to prevent the announcement
to show up before time.
#. Once the announcement is ready, unarchive it going to the *Actions* menu an choosing
the *Unarchive* option.
#. Optionally you can set an announcement date to schedule the announcement. The
announcement won't show up until that date.
#. 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.
There's a soft compatibility with OCA's `web_dialog_size` module. If the instance has
the module installed, you'll have the dialog resize controls by default in the
announcements. Additionally, you can show the announcement dialogs expanded to the
screen full width by default setting the system parameter key `announcement.full_size`
with to any value. Remove the parameter record to disable this behavior.
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 smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/server-ux/issues/new?body=module:%20announcement%0Aversion:%2013.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
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/13.0/announcement>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/server-ux",
"name": "odoo13-addon-announcement",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "",
"author": "Tecnativa, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": "",
"platform": null,
"description": "============\nAnnouncement\n============\n\n.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fserver--ux-lightgray.png?logo=github\n :target: https://github.com/OCA/server-ux/tree/13.0/announcement\n :alt: OCA/server-ux\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/server-ux-13-0/server-ux-13-0-announcement\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png\n :target: https://runbot.odoo-community.org/runbot/250/13.0\n :alt: Try me on Runbot\n\n|badge1| |badge2| |badge3| |badge4| |badge5| \n\nThis module adds popup announcements in the backend for targeted internal users. Those\nannouncements can contain rich format and a user read log is kept for everyone.\n\n**Table of contents**\n\n.. contents::\n :local:\n\nConfiguration\n=============\n\nTo create new announcements a user should be in the *Announcements Managers* group.\nWhen your user has such permissions, this is the way to create an announcement:\n\n#. Go to *Discuss > Announcements*\n#. Create a new one and define a title. This title will be shown in the announcement\n header.\n#. Define the announcement scope:\n\n - Specific users: manually select which users will see the announcement.\n - User groups: users from the selected groups will be the ones to see the\n announcement.\n#. Define the announcement body. You can use rich formatting and event paste your\n own html (editor in debug mode).\n#. By default, the announcement will be archived. This is to prevent the announcement\n to show up before time.\n#. Once the announcement is ready, unarchive it going to the *Actions* menu an choosing\n the *Unarchive* option.\n#. Optionally you can set an announcement date to schedule the announcement. The\n announcement won't show up until that date.\n#. If the announcement doesn't make sense once a date is passed, you can set a due date.\n From that date, the announcement won't be shown to anyone.\n\nThere's a soft compatibility with OCA's `web_dialog_size` module. If the instance has\nthe module installed, you'll have the dialog resize controls by default in the\nannouncements. Additionally, you can show the announcement dialogs expanded to the\nscreen full width by default setting the system parameter key `announcement.full_size`\nwith to any value. Remove the parameter record to disable this behavior.\n\nUsage\n=====\n\nWhen a user in the scope of active announcements logs in, those will popup. The user\nhas to mark them as read to continue working. If the announcement is set during the\nuser session, the announcement will be eventually prompted in the top bar on the right\npart. The user click on the unread announcements icon (a speaker) and the announcements\nwill popup for the user to check them.\n\nUsers can go *Discuss > Announcements* to check current and past announcements.\nAnnouncement managers can also track which users have read the announcement.\n\nKnown issues / Roadmap\n======================\n\n* It could be integrated in Discuss app to review past announcements.\n* Log other information like geolocation, IP, browser agent, etc when marking\n announcement as read.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/server-ux/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us smashing it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/server-ux/issues/new?body=module:%20announcement%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n~~~~~~~\n\n* Tecnativa\n\nContributors\n~~~~~~~~~~~~\n\n* `Tecnativa <https://www.tecnativa.com>`__:\n\n * Pedro M. Baeza\n * David Vidal\n\nMaintainers\n~~~~~~~~~~~\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nThis module is part of the `OCA/server-ux <https://github.com/OCA/server-ux/tree/13.0/announcement>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n\n\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Notify internal users about relevant organization stuff",
"version": "13.0.2.1.0",
"project_urls": {
"Homepage": "https://github.com/OCA/server-ux"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "281e28291bf5394902984f5db8b579ebf1bd9e16c1fa6833d0ae0c10ec49f88e",
"md5": "71995a1f9aa81420418a987ee4a93d07",
"sha256": "2691f9efbba5df55ef94cc9ff441d57175903e0340d37f65c883e40ffab864bd"
},
"downloads": -1,
"filename": "odoo13_addon_announcement-13.0.2.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "71995a1f9aa81420418a987ee4a93d07",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 36887,
"upload_time": "2022-09-26T14:06:46",
"upload_time_iso_8601": "2022-09-26T14:06:46.618552Z",
"url": "https://files.pythonhosted.org/packages/28/1e/28291bf5394902984f5db8b579ebf1bd9e16c1fa6833d0ae0c10ec49f88e/odoo13_addon_announcement-13.0.2.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-09-26 14:06:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "server-ux",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pdf2image",
"specs": []
},
{
"name": "pyzbar",
"specs": []
}
],
"lcname": "odoo13-addon-announcement"
}
JSON
