Metadata-Version: 2.1
Name: design.plone.policy
Version: 5.0.0a5
Summary: Pacchetto per creare un sito Agid su Plone
Home-page: https://github.com/collective/design.plone.policy
Author: RedTurtle Technology
Author-email: sviluppo@redturtle.it
License: GPL version 2
Project-URL: PyPI, https://pypi.python.org/pypi/design.plone.policy
Project-URL: Source, https://github.com/RedTurtle/design.plone.policy
Project-URL: Tracker, https://github.com/RedTurtle/design.plone.policy/issues
Description: ===================
        Design Plone Policy
        ===================
        
        Pacchetto di policy per un sito Plone AGID.
        
        |python| |version| |ci|
        
        .. |python| image:: https://img.shields.io/pypi/pyversions/design.plone.policy.svg
          :target: https://pypi.python.org/pypi/design.plone.policy/
        
        .. |version| image:: http://img.shields.io/pypi/v/design.plone.policy.svg
          :target: https://pypi.python.org/pypi/design.plone.policy
        
        .. |ci| image:: https://github.com/RedTurtle/design.plone.policy/actions/workflows/test.yml/badge.svg
          :target: https://github.com/RedTurtle/design.plone.policy/actions
        
        
        Features
        ========
        
        Installando questo pacchetto, si inizializza un sito Plone Agid.
        
        Creazione struttura del sito
        ============================
        
        All'installazione di questo prodotto, oltre che l'installazione di tutte le dipendenze,
        viene anche eseguita la creazione in automatico di una serie di cartelle utili per la
        gestione dei contenuti richiesta da Agid.
        
        Tipi ricercabili
        ================
        
        Installando questo prodotto, si disabilitano alcuni tipi ricercabili (così non vengon mostrati in @search-filters).
        
        
        Customer satisfaction
        =====================
        
        Viene installato un plugin aggiuntivo (rer.customersatisfaction) per poter esprimere voti sulle pagine del portale Agid.
        
        Per poter usare questo prodotto, va salvata la chiave privata per recaptcha v3 in una variabile d'ambiente (RECAPTCHA_PRIVATE_KEY).
        La chiave pubblica viene usata dal client Volto.
        
        
        Endpoint per plone.restapi
        ==========================
        
        @search-filters
        ---------------
        
        Questo endpoint serve al frontend di Volto, per popolare il menu e i filtri per la ricerca::
        
            > curl -i http://localhost:8080/Plone/@search-filters -H 'Accept: application/json'
        
        Ritorna un json con le sezioni principali, la lista degli argomenti e i tipi di contenuto ricercabili (tradotti)::
        
            {
                "sections":{
                    "amministrazione":{
                        "@id": "",
                        "path": "",
                        "title": "",
                        "items": [
                            {
                                "@id": "",
                                "path": "",
                                "title": "",
                            },
                            ...
                        ]
                    }
                    "documenti-e-dati": {...}
                    "novita": {...}
                    "servizi": {...}
                },
                "topics": [
                    {
                        "@id": "",
                        "path": "",
                        "title": "",
                    },
                    ...
                ],
                "portal_types": [
                    ...
                    {
                      "label": "Document",
                      "id": "Page"
                    }
                    ...
                ]
            }
        
        @search-bandi-filters
        ---------------------
        
        Questo endpoint serve al frontend di Volto, per popolare il menu e i filtri per la ricerca dei bandi::
        
            > curl -i http://localhost:8080/Plone/@search-bandi-filters -H 'Accept: application/json'
        
        Ritorna un json con la lista degli uffici (UO) referenziati da almeno un Bando e la lista delle parole chiave utilizzate dai Bandi::
        
            {
              "offices": [
                {
                  "key": "87bb96d90b6e42ee9db01ab2ab7543d5",
                  "label": "uo 1"
                }
              ],
              "subjects": [
                "bar",
                "foo"
              ]
            }
        
        @send-action-form
        -----------------
        
        Questo endpoint va chiamato su un contesto con i blocchi abilitati e
        serve al frontend di Volto, per inviare via mail il form compilato::
        
            > curl -i -X POST http://localhost:8080/Plone/document/@send-action-form -H 'Accept: application/json' -H 'Content-Type: application/json' --data-raw '{"from": "john@doe.com", "message": "Just want to say hi.", "block_id": "123456"}'
        
        All'endpoint vanno passati i seguenti parametri:
        
        - **block_id** [*obbligatorio*]: l'id del blocco di tipo "*form*" che è stato compilato
        - **message** [*obbligatorio*]: il messaggio da inviare
        - **from**: l'indirizzo email del mittente. Se non presente, viene utilizzato il campo *default_from* del blocco
        - **subject**: l'oggetto della mail. Se non presente, viene utilizzato il campo *default_subject* del blocco
        - **attachments**: eventuali allegati riferiti a campi "file upload" inseriti nel form.
        
        La struttura degli attachments è la seguente::
        
            {
                "block_id": "foo",
                ...
                "attachments": {
                    "field_id": {
                        "data": "the content of the file",
                        "content-type": "application/pdf",
                        "filename": "example.pdf"
                    }
                }
            }
        
        Se l'invio va a buon fine, viene tornata una risposta con `204`.
        
        @twitter-feed
        -------------
        
        Endpoint per poter visualizzare una serie di tweet.
        
        Per poterla utilizzare, bisogna creare un'app su Twitter e impostare il token Bearer dentro al registry Plone nella entry *design.plone.policy.twitter_token*.
        
        Per fare la ricerca, utilizza l'endpoint `recent`_ che permette di visualizzare solo i tweet dell'ultima settimana.
        
        .. _recent: https://developer.twitter.com/en/docs/twitter-api/tweets/search/introduction
        
        Come parametri accetta i seguenti:
        
        - **authors**: una lista di username tra cui ricercare gli ultimi Tweet.
        - **max_results**: un numero tra 10 e 100.
        
        Esempio di chiamata::
        
            > curl -i -X GET http://localhost:8080/Plone/@twitter-feed?authors=foo&authors=bar -H 'Accept: application/json' -H 'Content-Type: application/json'
        
        La risposta è una lista di tweet con le informazioni necessarie per essere renderizzati::
        
            [
                {
                    "author": {
                    "id": "12345678",
                    "name": "John Doe",
                    "profile_image_url": "https://pbs.twimg.com/profile_images/xxx/xxx_normal.jpg",
                    "username": "jdoe"
                    },
                    "id": "xxxxx",
                    "like_count": 1,
                    "reply_count": 0,
                    "retweet_count": 0,
                    "text": "stringa html"
                },
                ...
            ]
        
        Il campo `text` contiene già eventuali link ad hashtag, menzioni e link esterni dentro ad un tag <a/>.
        
        **Per evitare troppe chiamate al servizio (c'è un limite di 500000 tweet al mese), c'è della cache: per ogni query
        i risultati rimangono in cache per mezz'ora.**
        
        
        Amministrazione trasparente
        ===========================
        
        La vista "crea_area_trasparenza" crea la struttura per l'area "Amministrazione Trasparente".
        Si può lanciare dalla root del sito.
        
        
        Vocabolari per gli anonimi
        ==========================
        
        **redturtle.volto** permette di esporre dei vocabolari anche agli utenti anonimi.
        
        In questo prodotto aggiungiamo quelli che servono per io-comune.
        
        Installazione
        =============
        
        Per installare design.plone.policy bisogna per prima cosa aggiungerlo al buildout::
        
            [buildout]
        
            ...
        
            eggs =
                design.plone.policy
        
        
        e poi lanciare il buildout con ``bin/buildout``.
        
        Successivamente va installato dal pannello di controllo di Plone.
        
        Test con Volto standalone
        -------------------------
        
        Si può usare questo prodotto anche da solo, per fare delle demo veloci di Volto, senza
        dover per forza creare un nuovo progetto/buildout.
        
        E' presente un file `buildout.cfg` anche in questo prodotto, quindi basta lanciare il buildout ed avviare l'istanza.
        
        Il sito Plone sarà esposto sulla porta standard (**8080**) ed è già configurato per accettare chiamate dalla porta **3000**
        (quindi Volto dovrà girare su quella porta, che poi è il suo default).
        
        
        Contribuisci
        ============
        
        - Issue Tracker: https://github.com/redturtle/design.plone.policy/issues
        - Codice sorgente: https://github.com/redturtle/design.plone.policy
        
        
        Licenza
        =======
        
        Questo progetto è rilasciato con licenza GPLv2.
        
        Autori
        ======
        
        Questo progetto è stato sviluppato da **RedTurtle Technology**.
        
        .. image:: https://avatars1.githubusercontent.com/u/1087171?s=100&v=4
           :alt: RedTurtle Technology Site
           :target: http://www.redturtle.it/
        
        
        Contributors
        ============
        
        - RedTurtle Technology, sviluppo@redturtle.it
        
        
        Changelog
        =========
        
        5.0.0a5 (2023-03-01)
        --------------------
        
        - Update upgrade scripts to call design.plone.contenttypes
          upgrade steps to version 7008
          Install collective.feedback when install design.plone.policy
          [lucabel]
        
        
        5.0.0a4 (2023-02-20)
        --------------------
        
        - Upgrade script to generate first and second level menu
          due to a couple of typo
          [lucabel]
        
        
        5.0.0a3 (2023-02-16)
        --------------------
        
        - Upgrade footer initialization
          [lucabel]
        - Add collective.feedback to setup.py
          [eikichi18]
        
        
        5.0.0a2 (2023-01-13)
        --------------------
        
        - Upgrades for new AGID AI
          [lucabel]
        
        
        5.0.0a1 (2023-01-12)
        --------------------
        
        - remove collective.dexteritytextindexer dependency.
          [cekk]
        - adjustments to the pnrr.
          [deodorhunter, lucabek, eikichi18]
        
        
        4.0.2 (2023-01-30)
        ------------------
        
        - Aggiunto ordinamento per il filtro "Argomenti" nella pagina
          di ricerca.
          [lucabel]
        
        
        4.0.1 (2022-12-07)
        ------------------
        
        - Add "data-element" to custom attributes in html filters.
          [cekk]
        
        
        4.0.0 (2022-11-07)
        ------------------
        
        - Fix formsupport dependency to use honeypot and upgrade-step to set it in forms.
          [cekk]
        
        3.0.0 (2022-08-16)
        ------------------
        
        - Remove unused dependency in tests.
          [cekk]
        
        2.12.0 (2022-07-05)
        -------------------
        
        - scrub sensitive information for sentry
          [mamico]
        - Improve @bandi-search-filters speed.
          [cekk]
        
        2.11.3 (2022-01-27)
        -------------------
        
        - Fix upgrade-step.
          [cekk]
        
        
        2.11.2 (2022-01-27)
        -------------------
        
        - Fix image miniature with 65536.
          [cekk]
        
        2.11.1 (2022-01-27)
        -------------------
        
        - Add new image miniature (midi).
          [cekk]
        
        2.11.0 (2021-12-27)
        -------------------
        
        - Add default blocks to automatically created pages.
          [cekk]
        
        
        2.10.0 (2021-12-01)
        -------------------
        
        - Remove enabled_vocabularies implementation because in recent plone.restapi (>8.15.2) there is a standard way.
          [cekk]
        
        
        2.9.1 (2021-11-04)
        ------------------
        
        - Install redturtle.faq by default.
          [cekk]
        
        
        2.9.0 (2021-11-03)
        ------------------
        
        - Add redturtle.faq dependency (it will not be installed by default).
          [cekk]
        
        2.8.0 (2021-10-22)
        ------------------
        
        - Add rer.customersatisfaction dependency.
          [cekk]
        
        
        2.7.0 (2021-10-11)
        ------------------
        
        - p.a.caching rules for rest api services.
          [cekk]
        
        
        2.6.1 (2021-10-01)
        ------------------
        
        - Updated blocks generation for "crea_area_trasparenza" view.
          [daniele]
        
        2.6.0 (2021-09-29)
        ------------------
        
        - Remove limited content-types in initial structure creation.
          [cekk]
        
        
        2.5.0 (2021-09-20)
        ------------------
        
        - Refactored search filters endpoints to be more efficient.
          [cekk]
        - Can also add "Persona" in Politici folder.
          [cekk]
        - Add collective.volto.subfooter as dependency.
          [cekk]
        
        2.4.0 (2021-08-24)
        ------------------
        
        - Add list of available vocabularies for Anonymous.
          [cekk]
        
        
        2.3.0 (2021-07-07)
        ------------------
        
        - Install collective.volto.subsites by default and add a set of colors.
          [cekk]
        
        
        2.2.0 (2021-06-08)
        ------------------
        
        - [new] @search-bandi-filters endpoint.
          [cekk]
        
        
        2.1.2 (2021-05-14)
        ------------------
        
        - [new] Content type 'Bando' is admitted by default in 'Documenti e dati' folder.
          [arsenico13]
        
        
        2.1.1 (2021-05-04)
        ------------------
        
        - Fix upgrade-step.
          [cekk]
        
        
        2.1.0 (2021-05-04)
        ------------------
        
        - Handle multiple twitter accounts in twitter endpoint.
          [cekk]
        - Change twitter token field in registry (now is managed with interface).
          [cekk]
        
        
        2.0.0 (2021-04-30)
        ------------------
        
        - Update with new settings values from design.plone.contenttypes (version 3.0.0).
          [cekk]
        - [dev] Fix CI
          [arsenico13]
        - Add custom image scales
          [nzambello]
        - **search-filters** endpoint now return also a list of searchable portal_types.
          [cekk]
        - Disable some types from *types_not_searched*.
          [cekk]
        
        1.1.0 (2021-03-24)
        ------------------
        
        - Remove form route and add **collective.volto.formsupport** dependency.
          [cekk]
        
        
        1.0.8 (2021-02-25)
        ------------------
        
        - On install, set default search sections.
          [cekk]
        
        
        1.0.7 (2021-02-19)
        ------------------
        
        - Fix typo.
          [cekk]
        
        
        1.0.6 (2021-02-19)
        ------------------
        
        - Do not run dependencies when upgrading plone.app.registry.
          [cekk]
        
        1.0.5 (2021-02-11)
        ------------------
        
        - Install collective.volto.socialsettings by default.
          [cekk]
        
        
        1.0.4 (2021-02-05)
        ------------------
        
        - Add collective.volto.secondarymenu dependency.
          [cekk]
        - Enable sitemap by default.
          [cekk]
        
        
        1.0.3 (2021-01-28)
        ------------------
        
        - Handle Unauthorized in search-filters endpoint.
          [cekk]
        
        
        1.0.2 (2021-01-11)
        ------------------
        
        - Manage also attachments in @send-action-form endpoint.
          [cekk]
        
        
        1.0.1 (2020-12-18)
        ------------------
        
        - Added view to create trasparenza structure.
          [daniele]
        
        - Fixed folders creation when installing.
          [daniele]
        
        - Add twitter-feed endpoint.
          [cekk]
        
        1.0.0 (2020-12-07)
        ------------------
        
        - Initial release.
          [cekk]
        
Keywords: Python Plone
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 5.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: >=3.7
Provides-Extra: test
