Metadata-Version: 2.4
Name: redturtle.bandi
Version: 1.6.1
Summary: A product for announcements management based on rer.bandi
Home-page: https://github.com/PloneGov-IT/redturtle.bandi
Author: RedTurtle Technology
Author-email: sviluppoplone@redturtle.it
License: GPL
Project-URL: PyPI, https://pypi.python.org/pypi/redturtle.bandi
Project-URL: Source, https://github.com/RedTurtle/redturtle.bandi
Project-URL: Tracker, https://github.com/RedTurtle/redturtle.bandi/issues
Keywords: redturtle bandi announcements
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone :: 5.2
Classifier: Framework :: Plone :: 6.0
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python
Requires-Python: >=3.8
Requires-Dist: setuptools
Requires-Dist: lxml
Requires-Dist: plone.restapi
Requires-Dist: collective.tiles.collection
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"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


===============
redturtle.bandi
===============

|python| |version| |ci| |downloads| |license|

.. |python| image:: https://img.shields.io/pypi/pyversions/redturtle.bandi.svg
  :target: https://pypi.python.org/pypi/redturtle.bandi/

.. |version| image:: http://img.shields.io/pypi/v/redturtle.bandi.svg
  :target: https://pypi.python.org/pypi/redturtle.bandi

.. |ci| image:: https://github.com/RedTurtle/redturtle.bandi/actions/workflows/test.yml/badge.svg
  :target: https://github.com/RedTurtle/redturtle.bandi/actions

.. |downloads| image:: https://img.shields.io/pypi/dm/redturtle.bandi.svg
   :target: https://pypi.org/project/redturtle.bandi/

.. |license| image:: https://img.shields.io/pypi/l/redturtle.bandi.svg
    :target: https://pypi.org/project/redturtle.bandi/
    :alt: License

Introduction
============

redturtle.bandi is a product for announcements based on 3.x branch of `rer.bandi`__.

__ http://pypi.python.org/pypi/rer.bandi


It allows to set some infos about the announcement like the deadline to participate or the closing date.


Migration from rer.bandi
========================

If you need to migrate rer.bandi -> redturtle.bandi, follow these instructions:

- Copy bandi settings somewhere
- Add both products in the buildout
- Uninstall rer.bandi
- Install redturtle.bandi
- Fill Bandi control panel with old settings
- Call "migration-from-rer" view on the Plone site root (this view will change the base classe of already created Bando and Folder Deepening items, and clean history)
- Remove rer.bandi from buildout


Composition
===========

Different layouts
-----------------
There are two allowed views for an announcement:

* default view, with basic infos on the right (like events) and extra infos (folder deepenings) in the middle.
* alternative view that moves extra infos slot below basic infos.

Folder deepening
----------------
Like in **rer.structured_content**, it has a special folder type called "*Folder Deepening*" that allows to manage some extra infos or attachment that should be shown in the announcement's view.

Topic criterias
---------------
There are some new topic criterias that allows to set topic queries for announcements.

Announcements search
--------------------
There is a search form (http://yoursite/search_bandi_form) for quick searches.

Announcement state information
------------------------------
In the search results and in the two new topic views, there are also some infos about the announcement, like his state (open, closed or in progress).

Announcements portlet
---------------------
There is also a portlet that show announcement infos from a topic (this portlet extends base collection portlet)


Configurations
==============
An announcement has some fields for set the announcement type and recipients.

Available values are set in "Bandi Settings" control panel.


Authority Default value
-----------------------

A default authority value can be set for announcements. This information is taken from control panel "Bandi Settings" (default_ente).

If the property is empty, the default value isn't set.

Tile
====

In order to use layout bandi for tile is necessary have installed collective.tiles.collection product.


plone.restapi integrations
==========================

Controlpanel
------------

Bandi controlpanel is also exposed via restapi to allow Volto integration.


DateTime fields deserializer
----------------------------

There is a custom deserializer for DateTime fields to set the right timezone when saving these fields (like start and end in Events).


Dependencies
============

This product has been tested on Plone 5.2


Credits
=======

Developed with the support of `Regione Emilia Romagna`__;

Regione Emilia Romagna supports the `PloneGov initiative`__.

__ http://www.regione.emilia-romagna.it/
__ http://www.plonegov.it/

Authors
=======

This product was developed by RedTurtle Technology team.

.. image:: http://www.redturtle.net/redturtle_banner.png
   :alt: RedTurtle Technology Site
   :target: http://www.redturtle.net/

Changelog
=========

1.6.1 (2025-10-10)
------------------

- gestione deserizlizer per datetime, nel caso il campo abbia avvutto
  un cambianeto di ttipo (datte->datetime)
  [mamico]
- lint/isort
  [mamico]


1.6.0 (2025-03-13)
------------------

- Add new criteria for bando_state.
  [folix-01]


1.5.1 (2025-03-12)
------------------

- Fix upgrade-step to not broke on missing value.
  [cekk]


1.5.0 (2025-02-20)
------------------

- Do not use key/value pairs in tipologia_bando and destinatari.
  [cekk]
- Refactor retrieveContentsOfFolderDeepening to be more pluggable and use hooks for content-types based additional data.
  [cell]

1.4.7 (2024-12-12)
------------------

- Update it translations
  [lucabel]


1.4.6 (2024-09-09)
------------------

- Add effective and modified date to retrieveContentsOfFolderDeepening data.
  [cekk]


1.4.5 (2024-04-15)
------------------

- Added "tipologia_bando_label" metadata.
  [daniele]


1.4.4 (2024-02-20)
------------------

- Changed translation for states "Open" and "Closed".
  [daniele]


1.4.3 (2023-06-27)
------------------

- Fix workaround for Link bug (?) (remoteUrl in catalog)
  [mamico]

- Feat url dei file compleata con filename
  [mamico]

- Fix invalid tipologie_bando 
  [mamico]


1.4.2 (2022-10-07)
------------------

- Fix problem with scadenza_bando indexing: due to a
  datetime 2 DateTime conversion tz information was 
  badly transformed
  [lucabel]


1.4.1 (2022-07-28)
------------------

- Added metadata "apertura_bando".
  [daniele]


1.4.0 (2022-05-31)
------------------

- Add new bando state "scheduled" and new field to manage open date.
  [cekk]

1.3.4 (2022-05-10)
------------------

- Re-introduced change from 1.2.0.
  [cekk]


1.3.3 (2022-04-19)
------------------

- Fix problem with default values and missing
  IContextAwareDefaultFactory

1.3.2 (2022-01-14)
------------------

- Fix attachments dimension calculation.
  [cekk]
- Add content-type info in attachments.
  [cekk]

1.3.1 (2022-01-14)
------------------

- Fix labels in controlpanel.
  [cekk]


1.3.0 (2021-11-17)
------------------

- fixed profile name in mgrate_to_1100 upgrade step-
  [eikichi18]
- Remove DateField deserializer customization (already used in redturtle.volto).
  [cekk]

1.2.0 (2021-06-07)
------------------

- Save `scadenza_bando` with proper timezone (like start and end fields in Event).
  [cekk]

1.1.2 (2021-04-12)
------------------

- Fix typo in upgrade-step for 1.1.0 version.
  [cekk]


1.1.1 (2021-02-19)
------------------

- Controlpanel also available for plone.restapi.
  [cekk]


1.1.0 (2021-02-19)
------------------

- Rename indexes.
  [cekk]


1.0.2 (2020-12-30)
------------------

- Release on pypi.
  [cekk]

1.0.1 (2020-10-30)
------------------

- Make some micro fix in bando view when search for attachments in
  deepening folder
  [lucabel]


1.0.0 (2020-03-06)
------------------

- Start new project from old rer.bandi implementation (3.x)
  [cekk]
