Skip to content

Commit

Permalink
módulo fetchmail_attach_from_folder para la 15 (#10)
Browse files Browse the repository at this point in the history
* módulo fetchmail_attach_from_folder para la 15

* adaptado traducciones a v15
  • Loading branch information
almumu authored and docker-odoo committed Jun 27, 2024
1 parent 4b4df1f commit 363d6b1
Show file tree
Hide file tree
Showing 23 changed files with 2,110 additions and 0 deletions.
95 changes: 95 additions & 0 deletions fetchmail_attach_from_folder/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
Email gateway - folders
=======================

Adds the possibility to attach emails from a certain IMAP folder to objects,
ie partners. Matching is done via several algorithms, ie email address, email
address's domain or the original Odoo algorithm.

This gives a simple possibility to archive emails in Odoo without a mail
client integration.

Configuration
=============

In your fetchmail configuration, you'll find a new list field `Folders to
monitor`. Add your folders here in IMAP notation (usually something like
`INBOX.your_folder_name.your_subfolder_name`), choose a model to attach mails
to and a matching algorithm to use.

Exact mailaddress
-----------------

Fill in a field to search for the email address in `Field (model)`. For
partners, this would be `email`. Also fill in the header field from the email
to look at in `Field (email)`. If you want to match incoming mails from your
customers, this would be `from`. You can also list header fields, so to match
partners receiving this email, you might fill in `to,cc,bcc`.

Domain of email addresses
-------------------------

Match the domain of the email address(es) found in `Field (email)`. This would
attach a mail to `[email protected]` to a record with `Field (model)` set to
`[email protected]`. Given that this is a fuzzy match, you probably want to
check `Use 1st match`, because otherwise nothing happens if multiple possible
matches are found.

Odoo standard
-------------

This is stricly speaking no matching algorithm, but calls the model's standard
action on new incoming mail, which is usually creating a new record.

Usage
=====

A widespread configuration is to have a shared mailbox with several folders,
i.e. one where users drop mails they want to attach to partners. Let this
folder be called `From partners`. Then create a folder configuration for your
server with path `"INBOX.From partners"` (note the quotes because of the space,
this is server dependent). Choose model `Partners`, set `Field (model)` to
`email` and `Field (email)` to `from`. In `Domain`, you could fill in
`[('customer', '=', True)]` to be sure to only match customer records.

Now when your users drop mails into this folder, they will be fetched by Odoo
and attached to the partner in question. After some testing, you might want to
check `Delete matches` in your folder configuration so that this folder doesn't
grow indefinitely.


Bug Tracker
===========

Bugs are tracked on `GitHub Issues
<https://github.com/OCA/server-tools/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.

Credits
=======

Contributors
------------

* Holger Brunn <[email protected]>
* Ronald Portier <[email protected]>

Icon
----

http://commons.wikimedia.org/wiki/File:Crystal_Clear_filesystem_folder_favorites.png

Maintainer
----------

.. image:: http://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: http://odoo-community.org

This module is maintained by the OCA.

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.

To contribute to this module, please visit http://odoo-community.org.
7 changes: 7 additions & 0 deletions fetchmail_attach_from_folder/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Copyright - 2013-2018 Therp BV <https://therp.nl>.
# Copyright - 2020 Aures Tic Consultors S.L <https://www.aurestic.es>.
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).

from . import match_algorithm
from . import models
from . import wizard
20 changes: 20 additions & 0 deletions fetchmail_attach_from_folder/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Copyright - 2013-2018 Therp BV <https://therp.nl>.
# Copyright - 2022 Aures Tic Consultors S.L <https://www.aurestic.es>.
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
{
"name": "Email gateway - folders",
"summary": "Attach mails in an IMAP folder to existing objects",
"version": "15.0.1.0.0",
"author": "Aures Tic, Therp BV,Odoo Community Association (OCA)",
"website": "https://github.com/OCA/server-tools",
"license": "AGPL-3",
"category": "Tools",
"depends": ["fetchmail"],
"data": [
"views/fetchmail_server.xml",
"wizard/attach_mail_manually.xml",
"security/ir.model.access.csv",
],
"installable": True,
"auto_install": False,
}
Loading

0 comments on commit 363d6b1

Please sign in to comment.