Skip to content

Pacchetto per la gestione dei content-type per un sito Agid con Plone.

License

GPL-2.0, Unknown licenses found

Licenses found

GPL-2.0
LICENSE.GPL
Unknown
LICENSE.rst
Notifications You must be signed in to change notification settings

RedTurtle/design.plone.contenttypes

Repository files navigation

Latest Version Supported - Python Versions Number of PyPI downloads License Tests Coverage

Design Plone Content-types

Pacchetto per la gestione dei content-type per un sito Agid con Plone.

Features

Installando questo pacchetto, si rendono disponibili diversi content-type per la gestione di un sito Agid con Plone e Volto.

Compatibilità

  • Plone 6.0, design.plone.policy 5., design.plone.contenttypes 6.
  • Plone 5.2, design.plone.policy 4., design.plone.contenttypes 5.

Tipi di contenuto

Elenco tipi implementati

  • Cartella Modulistica

    • Definizione campi
    • Ordine campi
    • Vista su Volto completata
  • Collegamento

    • Definizione campi
    • Ordine campi
    • Indicizzazione testo
    • Vista su Volto completata
    • Selezione link interno
  • Dataset

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Documento

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Documento Personale

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Evento

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Messaggio

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Modulo

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Vista su Volto completata
  • Notizia

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Luogo

    • Definizione campi
    • Abilitare behavior collective.address.address
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
    • gestione di "è sede di"
  • Pagina Argomento

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Persona

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Pratica

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Ricevuta Pagamento

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Servizio

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata
  • Unità Organizzativa

    • Definizione campi
    • Ordine campi
    • Ordine fieldsets
    • Indicizzazione testo
    • Vista su Volto completata

Bando

Proveniente da redturtle.bandi_.

Sono state fatte alcune modifiche ai campi e in più:

  • La vista di default nel backend è la base_view, in modo da non dare problemi con i campi a blocchi
  • Rimosso l'ente di default
  • Le cartelle approfondimento possono contenere anche Moduli

.. _redturtle.bandi: https://github.com/RedTurtle/redturtle.bandi

Cartella Modulistica

Contenuto folderish (come la Pagina) che serve a raggruppare dei Documenti.

Questo content-type ha sia i blocchi attivati che una vista ad hoc che mostra i Documenti al suo interno con già i link ai file da scaricare.

Se i Documenti vengono raggruppati in Pagine, nella vista verrà mostrato il testo delle pagine contenitori come separatore tra i vari gruppi (solo nella parte Volto).

Nella proprietà @components dell'oggetto CartellaModulistica, viene sempre inviato nella prop modulistica-items l'url dell'endpoint per avere la struttura dati degli elementi da mostrare nella vista della cartella modulistica. Quell'url ritorna sempre una oggetto del tipo {items:[]} dove l'array contiene gli elementi.

Documento

Ha i campi definiti da Agid (senza quelli specifici per i Bandi, perché li gestiamo con un content-type ad hoc).

Al suo interno può contenere degli oggetti di tipo Modulo (che sono i file scaricabili veri e propri).

I Moduli che vengono inseriti dentro al Documento, verranno mostrati nel frontend come lista di documenti scaricabili. E' presente una customizzazione del serializer per poter mostrare di default più di 25 risultati (200), perché può essere necessario mostrare più moduli.

Se si prova a fare un caricamento massivo di file dalla vista "contents" di un Documento, c'è una personalizzazione di restapi che converte il tipo da File (il default che imposta Volto per la POST) a Modulo. In questo modo si può fare il caricamento massivo di Moduli dentro ad un Documento.

Campi indicizzati nel SearchableText

  • blocchi Volto

Evento di creazione

Alla creazione di un Documento, un evento genera in automatico una cartella "Multimedia" dove andare ad inserire delle eventuali immagini.

L'evento imposta anche come unico contenuto aggiungibile dentro al Documento, il Modulo.

Luogo

Esiste un deserializer per plone.restapi per il campo di tipo "GeolocationField" che si occupa di trasformare le coordinate in input, in un oggetto corretto per quel campo.

Accetta un valore del tipo::

{
  "latitude": 10.0000,
  "longitude": 20.0000,
}

Alcuni campi della geolocalizzazione hanno dei valori predefiniti quando viene richiesto lo schema mediante plone.restapi:

  • city
  • street
  • geolocation
  • country

Sono pre-popolati con la sede di AGID a Roma.

Il campo "sede_di" ritornato da restapi è calcolato in base alle Unità Operative che lo referenziano come sede principale o secondaria.

Modulo

Content-type creabile solo all'interno del Documento. Questo è un File "evoluto". Ha 3 campi file: uno per il modulo principale, e gli altri due per eventuali formati alternativi.

Notizie e comunicati stampa

  • Tipo base "Notizia" di Plone con alcuni campi aggiuntivi.
  • Folderish (grazie a redturtle.volto)
  • Può contenere Immagini, Collegamenti, File, Documenti (utile per strutturare i contenuti al suo interno)
  • Alla creazione di una Notizia, vengono create automaticamente al suo interno due cartelle "Multimedia" e "Documenti allegati" per poter organizzare meglio i contenuti

Pagina

  • Può essere usata anche come pagina di disambiguazione. C'è una behavior attivata (design.plone.contenttypes.behavior.info_testata) per impostare informazioni aggiuntive per la testata delle pagine di disambiguazione.

Pagina Argomento

Le pagine argomento hanno i blocchi. plone.restapi ha un indexer per SearchableText per poter indicizzare i blocchi.

Questo va in conflitto con le personalizzazioni fatte con plone.app.dexterity.textindexer perché Plone prende come buono il primo adapter di SearchableText che trova. Per ovviare a questo problema, abbiamo messo la behavior "volto.blocks" come ultima, in modo che venisse ignorato il suo indexer, e poi abbiamo registrato un adapter per IDynamicTextIndexExtender per replicare l'indicizzazione dei blocchi anche per le pagine argomento.

Evento di modifica

Se si modifica il titolo dell'argomento, viene scatenato un event handler che cerca tutti i contenuti del sito che referenziano questa pagina, e reindicizza il loro indice tassonomia_argomenti per aggiornare il valore (perché ci si salva il titolo).

Campi indicizzati nel SearchableText

  • blocchi Volto
  • unita_amministrative_responsabili
  • ulteriori_informazioni

Persona

Il serializer della persona, ritorna anche i seguenti valori calcolati:

  • strutture_correlate: elenco di Unità Organizzative in cui la persona è stata aggiunta nel campo "Persone che compongono la struttura"
  • responsabile_di: elenco di Unità Organizzative in cui la persona è stata aggiunta nel campo "Responsabile"
  • assessore_di: elenco di Unità Organizzative in cui la persona è stata aggiunta nel campo "Assessore di riferimento"

Evento di creazione

Alla creazione di una Persona, viene creata anche una struttura predefinita per contenere diversi documenti:

  • Foto e attività politica
  • Compensi
  • Importi di viaggio e/o servizi
  • Situazione patrimoniale
  • Dichiarazione dei redditi
  • Spese elettorali
  • Variazione situazione patrimoniale
  • Altre cariche

Campi indicizzati nel SearchableText

  • competenze
  • deleghe
  • telefono
  • email
  • informazioni_di_contatto

Servizio

Campi indicizzati nel SearchableText

  • descrizione_estesa
  • sottotitolo
  • descrizione_destinatari
  • chi_puo_presentare
  • come_si_fa
  • cosa_si_ottiene
  • cosa_serve
  • ulteriori_informazioni
  • tassonomia_argomenti
  • copertura_geografica
  • costi
  • life_event
  • servizi_collegati

Unità Organizzativa

La get di questo content-type, ritorna (nell'attributo "servizi_offerti") anche la lista di Servizi che la referenziano nei campi "ufficio_responsabile" e "area".

Campi indicizzati nel SearchableText

  • street
  • city
  • zip_code
  • country
  • quartiere
  • circoscrizione
  • descrizione_breve
  • orario_pubblico
  • identificativo_mibac

Pannello di controllo

Nel pannello di controllo "Impostazioni Design Plone" sono presenti diversi campi dove configurare valori di default per i vari contenuti:

  • Tipologie notizia
  • Tipologie persona
  • Tipologie unità organizzativa
  • Tipologie documento
  • Dimensioni leadimage
  • Sezioni ricerca
  • Mostra la data di modifica

A parte gli ultimi tre, gli altri campi sono tutti multilingua. I vocabolari che usano quei valori, ritornano solo i possibili valori a seconda della lingua selezionata dall'utente.

Gestione modulistica

Agid prevede un tipo di contenuto Documento per gestire i moduli scaricabili.

Abbiamo però sviluppato anche un contenuto chiamato Cartella Modulistica che ha il compito di raggruppare in modo logico più Documenti e mostrarli all'utente come faceva il vecchio prodotto cciaa.modulistica.

Viste verifica contentuti

Viste di supporto per la verifica sulla compilazione dei contenuti secondo le regole Designers Italia.

I link alle viste sono elencati alla pagina https://nomesito.it/Plone/@@design-utils.

Data di modifica

Esiste una behavior (design.plone.contenttypes.behavior.show_modified) abilitata di default solo per i Document (Pagina) che indica al frontend se va mostrata o meno la data di modifica.

Nel pannello di controllo viene definito il default, mentre nel singolo contenuto è possibile cambiare il valore nel tab "Impostazioni".

Endpoint restapi

Customizzazione dati relation field

C'è una customizzazione dei dati ritornati dal serializer per i relation field (correlati) per ritornare oltre alle informazioni standard, anche la data di pubblicazione e l'inizio e fine evento.

Vengono ritornati solo i correlati che l'utente che li ha richiesti può vedere (a differenza dello standard, che li torna tutti).

Serializer summary

E' il serializer utilizzato dalla get di un contenuto per mostrare il dettaglio dei suoi figli quando non viene richiesta la fullobjects (ci sono sono le informazioni base quindi).

E' stato customizzato per ritornare sempre due informazioni utili visto che Volto ora non richiede più sempre la fullobjects:

  • has_children: ritorna True o False a seconda che il contenuto abbia o meno dei figli
  • id: l'id dell'oggetto

## @modulistica_items

Endpoint ed expansion per la modulistica.

Nei content-type CartellaModulistica, tra i vari expansion c'è anche @modulistica_items. Questo è utile per la vista di frontend, in quanto se richiamato, ritorna la struttura di dati da mostrare in visualizzazione.

## @navigation

Endpoint customizzato da plone.restapi per esporre anche il valore show_in_footer per decidere se disegnare o meno le colonne dinamiche nel footer.

Installazione

Questo prodotto non è stato pensato per funzionare da solo, ma fa parte della suite "design.plone".

Per utilizzare questo prodotto, fare riferimento a design.plone.policy_.

.. _design.plone.policy: https://github.com/RedTurtle/design.plone.policy

Traduzioni

Per aggiornare le traduzioni, basta usare lo script update_locales dentro alla cartella bin::

bin/update_locales

N.B.: lo script va chiamato due volte perché al primo giro non aggiorna i file.

Contribuisci

Questo pacchetto usa pre-commit per cui prima di iniziare a sviluppare:

Licenza

Questo progetto è rilasciato con licenza GPLv2.

Autori

Questo progetto è stato sviluppato da RedTurtle Technology.

RedTurtle Technology Site

About

Pacchetto per la gestione dei content-type per un sito Agid con Plone.

Topics

Resources

License

GPL-2.0, Unknown licenses found

Licenses found

GPL-2.0
LICENSE.GPL
Unknown
LICENSE.rst

Stars

Watchers

Forks

Packages

No packages published

Languages