Metadata-Version: 2.1
Name: odoo-addon-sy_mass_mailing_partner_import
Version: 18.0.1.0.0.1
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Imports partners from mass mailing lists
Home-page: https://github.com/sygel-technology/sy-mass-mailing
License: AGPL-3
Author: Sygel
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

===========================
Mass Mailing Partner Import
===========================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:d61cef36911ff612e681614c9b52addc46a62a1850f461f1981c29ae24a02ad1
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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-sygel--technology%2Fsy--mass--mailing-lightgray.png?logo=github
    :target: https://github.com/sygel-technology/sy-mass-mailing/tree/18.0/sy_mass_mailing_partner_import
    :alt: sygel-technology/sy-mass-mailing

|badge1| |badge2| |badge3|

This module extends Odoo's Email Marketing functionality to facilitate
the integration of partners (``res.partner``) with mailing contacts and
mailing lists.

It is based on the OCA modules ``mass_mailing_partner`` and
``mass_mailing_list_dynamic``, adapting and combining their
functionality to support partner imports, mailing list management, and
partner merging.

**Table of contents**

.. contents::
   :local:

Usage
=====

Add partners to mailing lists
-----------------------------

1. Go to **Contacts**.
2. Select one or more partners from the list view.
3. Use the **Action** menu to open the wizard for adding partners to
   mailing lists.
4. Select one or more mailing lists.
5. Confirm the operation.

Mailing contacts are created automatically if they do not already exist.
Existing mailing contacts are reused, and only missing mailing list
subscriptions are added.

Partners must have an email address to be added to mailing lists.

Import partners using a domain
------------------------------

1. Go to **Email Marketing > Mailing Lists**.
2. Open a mailing list and access the contact import wizard.
3. Select **Partners** as the import type.
4. Configure the domain to filter the partners to import.
5. Confirm the import.

The module creates or reuses mailing contacts for the matching partners
and adds them to the selected mailing lists.

The standard email import functionality remains available by selecting
the email import type.

Merge partners
--------------

When merging partners that have linked mailing contacts, the module
automatically consolidates their mailing list subscriptions into a
single mailing contact associated with the destination partner.

Existing mailing list associations and opt-out preferences are
preserved.

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

Bugs are tracked on `GitHub Issues <https://github.com/sygel-technology/sy-mass-mailing/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/sygel-technology/sy-mass-mailing/issues/new?body=module:%20sy_mass_mailing_partner_import%0Aversion:%2018.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
-------

* Sygel

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

- `Sygel <https://www.sygel.es>`__:

  - Ángel Rivas
  - Valentín Vinagre
  - Harald Panten

Maintainers
-----------

This module is part of the `sygel-technology/sy-mass-mailing <https://github.com/sygel-technology/sy-mass-mailing/tree/18.0/sy_mass_mailing_partner_import>`_ project on GitHub.

You are welcome to contribute.
