Metadata-Version: 2.1
Name: rer.newsletterplugin.flask
Version: 0.2.0
Summary: Add-on per Plone collegato a rer.newsletter per inviare le mail usando un servizio Flask
Home-page: https://github.com/collective/rer.newsletterplugin.flask
Author: RedTurtle
Author-email: sviluppo@redturtle.it
License: GPL version 2
Project-URL: PyPI, https://pypi.python.org/pypi/rer.newsletterplugin.flask
Project-URL: Source, https://github.com/collective/rer.newsletterplugin.flask
Project-URL: Tracker, https://github.com/collective/rer.newsletterplugin.flask/issues
Keywords: Python Plone
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 5.2
Classifier: Framework :: Plone :: 6.0
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: >=3.7
License-File: LICENSE.GPL
License-File: LICENSE.rst
Requires-Dist: setuptools
Requires-Dist: z3c.jbot
Requires-Dist: plone.api >=1.8.4
Requires-Dist: plone.restapi
Requires-Dist: plone.app.dexterity
Requires-Dist: rer.newsletter
Provides-Extra: test
Requires-Dist: plone.app.testing ; extra == 'test'
Requires-Dist: plone.testing >=5.0.0 ; extra == 'test'
Requires-Dist: plone.app.contenttypes ; extra == 'test'
Requires-Dist: plone.app.robotframework[debug] ; extra == 'test'
Requires-Dist: collective.MockMailHost ; extra == 'test'
Requires-Dist: requests-mock ; extra == 'test'

===========================
RER Newsletter plugin Flask
===========================

This is a plugin for `rer.newsletter <https://github.com/RegioneER/rer.newsletter>`_ that moves outside from Plone the task for sending emails.

It is made to work with `rer.newsletterdispatcher.flask <https://github.com/RegioneER/rer.newsletterdispatch.flask>`_ natively, but can work
with every endpoint that exposes the same route and replies in the same way.

The main problem having mail dispatcher into Plone, is that this task can take a lot of time (we have some cases with 70000 subscriptions)
and block the instance for a large amount of time slowing down the site and cause also some conflict errors.


Features
--------

This product register a new adapter for IChannelSender that overrides some basic rer.newsletter methods and send to an external
endpoint all informations to send the newsletter.

This process is asyncronous, so the channel history will be updated only when the endpoint calls the site with the status of the task.


External endpoint address
-------------------------

You can set the endpoint address into Plone's registry searching for "flask" entry or going directly here:
``http://your_plone_site/portal_registry/edit/rer.newsletterplugin.flask.interfaces.INewsletterPluginFlaskSettings.queue_endpoint``

If the addesss is not set, the newsletter will not be send.

Completed task notification
---------------------------

When the external process finish its job (succesfully or with an error), calls a plone.restapi endpoint ('@send-done') registered
for newsletter Channels to update the channel about the status of that job.

Translations
------------

This product has been translated into

- Italian


Installation
------------

Install rer.newsletterplugin.flask by adding it to your buildout::

    [buildout]

    ...

    eggs =
        rer.newsletterplugin.flask


and then running ``bin/buildout``


Contribute
----------

- Issue Tracker: https://github.com/RegioneER/rer.newsletterdispatcher.flask/issues
- Source Code: https://github.com/RegioneER/rer.newsletterdispatcher.flask


License
-------

The project is licensed under the GPLv2.

Credits
-------

Developed with the support of `Regione Emilia Romagna <http://www.regione.emilia-romagna.it/>`_;

Regione Emilia Romagna supports the `PloneGov initiative <http://www.plonegov.it/>`_.

Authors
-------

This product was developed by **RedTurtle Technology** team.

.. image:: https://avatars1.githubusercontent.com/u/1087171?s=100&v=4
   :alt: RedTurtle Technology Site
   :target: http://www.redturtle.it/


Contributors
============

- RedTurtle, sviluppo@redturtle.it


Changelog
=========

0.2.0 (2024-05-24)
------------------

- Fix volto support.
  [cekk]

0.1.1 (2024-05-04)
------------------

- Fix python version for Plone6.
  [cekk]

0.1.0 (2020-07-21)
------------------

- Initial release.
  [cekk]
