eduinaf/readme.txt

248 lines
15 KiB
Plaintext

=== Edu INAF Tools ===
Contributors: ulaulaman
Tags: eduinaf, inaf
Requires at least: 4.8.5
Tested up to: 6.0.6
Requires PHP: 7.0.18
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Il *plugin*, in italiano, aggiunge varie funzionalità al sito EduINAF senza modificare direttamente il codice php del tema.
== Description ==
Il *plugin* aggiunge un'icona per il *login*, personalizza il messaggio nell'*admin footer*, manipola il *feed rss* per accreditare l'articolo all'autore/i, inclusi *guest author*, aggiunge una serie di *shortcode* e di *widget*.
In particolare definisce una serie di *shortcode* per la costruzione delle *sidebar* di alcuni *custom post type*:
* **Didattica**: [sbdidattica] (con *widget*)
* **Astrofoto**: [sbastrofoto] (con *widget*)
* **Costellazioni**: [sbcostellazioni] (con *widget*)
* **Menu costellazioni**: [menucostellazioni]
* **Corso base di astronomia**: [sbcorsobase] (con *widget*)
Per la didattica è consigliato utilizzare anche il *widget* apposito.
Definisce anche gli *shortcode* per inserire le attività didattiche da astroedu o gli articoli da spacesoop a partire dal codice del contenuto e dalla lingua:
[astroedu code="..." lang="..."]
[spacescoop code="..." lang="..."]
Entrambi i parametri sono obbligatori per il corretto funzionamento degli *shortcode*.
Il *plugin* aggiunge degli *shortcode* per generare delle griglia di *post*. Si può utilizzare uno *shortcode* generico:
[grigliata categoria="..." etichetta="..." tassonomia="..." valore="..."]
in cui almeno uno dei due parametri deve essere specificato. Nel caso di *tassonomia*, a questo sarebbe buona norma abbinare anche il *valore* che può assumere la tassonomia personalizzata.
Per realizzare dei *loop* personalizzati si può utilizzare lo *shortcode*
[postlooptab intro="Ultimi articoli" pag="5" categoria="..." tag="..." stile="1"]
Nell'esempio sono inseriti, laddove presenti, i valori di *default*.
Per gli stili, è possibile indicare 1 per un elenco in linea con quello del tema, 2 per un elenco con nome dell'autore e data di pubblicazione, 3 per una griglia di quadrati.
Aggiunti una tassonomia e due *shortcode* per la gestione degli speciali. In particolare i due *shortcode* hanno la seguente sintassi:
* Griglia da inserire nella pagina dello Speciale: [grigliaspeciali speciale="slug speciale" tipo="slug tipologia post"]
Il *plugin* è stato originariamente sviluppato per integrarsi con [Co-Authors Plus](https://wordpress.org/plugins/co-authors-plus/). I codici di integrazione con questo *plugin* sono stati cancellati dalla versione attuale e spostati in [Co-Authors Widget](https://wordpress.org/plugins/widget-for-co-authors/) (vedi anche la [pagina del *plugin*](https://ulaulaman.github.io/#CoAuthorsWidget)).
== Changelog ==
* 2023.1026 Aggiornati link documenti concorso Rodari
* 2023.1023
* Cambio file scheda di partecipazione concorso Rodari 2023
* Eliminati link alle locandine
* Aggiornata compatibilità versione Wordpress
* 2023.1019 Modificati link e aggiunti documenti per Rodari 2023 e archiviato il menu di Rodari 2022
* 2023.0113 Aggiuntinuovi loghi in collaborazioni
* 2022-1020 Correzione errori versione precedente e nuovo bando concorso Rodari 2022
* 2022.1012 Nuovi allegati per il concorso Rodari 2022
* 2022.0610
* Modifica *link* della barra laterale del concorso Rodari
* Eliminazione delle griglie eduinaf e libri e semplificazione della grigliata
* Accorpamento di speciali e grid in quest'ultimo
* 2021.1129
* Tolta riga che generava ripetizione del menu in *costellazioni* e rinominate variabili interne
* Sostituito il logo Europlanet per le schede didattiche
* 2021.1116
* Modificato il colore della striscia dell'ultimo aggiornamento
* Inserito il menu *costellazioni* alla fine della *sidebar* corrispondente
* Elimintati i *widget* delle singole *sidebar*
* 2021.1026
* Modifche minori in rodari.php
* Aggiornamento *file css*
* Aggiunto *widget* per l'inserimento degli *shortcode* nelle *sidebar*
* 2021.1022
* Corretti errori di sintassi nello *shortcode* per astroedu
* Cambiato colore dei link ad astroedu introducendo una nuova classe apposita e usando il *file css* generale
* Aggiunto il supporto per le diverse versioni al *file css*
* Aggiunto il codice per la striscietta sull'ultimo aggiornamento
* Modificata parte che aggiunge l'autore nel *feed rss* nel caso in cui *Co-Authors Plus* non sia installato
* 2021.1019
* Accorpati pezzi di codice in per ridurre il numeri dei *file* .php richiamati in quello principale
* Modifiche minori agli *shortcode* del concorso Rodari 2021
* Eliminata la pagina di descrizione nella bacheca
* 2021.1018 Aggiornati gli *shortcode* del concorso Rodari per l'anno 2021
* 2021.1007
* Aggiornato lo *shortcode* dei *loop* personalizzati con la distinzione tra 3 stili differenti
* Aggiunti gli *shortcode* e i documenti relativi al concorso Via Lattea Quaraquarinci dedicato a Gianni Rodari
* 2021.0629
* Modifiche al codice di brera.php per risolvere le [*issue* segnalate](https://github.com/ulaulaman/eduinaf/issues/5) e ottimizzazione generale del codice
* 2021.0628
* Modifiche al codice di costellazioni.php per risolvere le [*issue* segnalate](https://github.com/ulaulaman/eduinaf/issues/5)
* Sistemazioni varie nella pagina di descrizione del *plugin*
* Modifiche minori in link.php
* 2021.0626
* Conclusione delle modifiche ad astrodidattica.php per risolvere le [*issue* segnalate](https://github.com/ulaulaman/eduinaf/issues/5)
* 2021.0624
* Nuove modifiche al codice di astrodidattica.php per risolvere le [*issue* segnalate](https://github.com/ulaulaman/eduinaf/issues/5)
* 2021.0513
* Nuove modifiche al codice di astrodidattica.php per risolvere le [*issue* segnalate](https://github.com/ulaulaman/eduinaf/issues/5)
* Aggiunto nuovo logo per le collaborazioni
* 2021.0508
* Disabilitata tabella.php in attesa di risolvere il problema nell'[*issue* segnalato](https://github.com/ulaulaman/eduinaf/issues/4)
* Modifiche al codice di astrodidattica.php per risolvere le [*issue* segnalate](https://github.com/ulaulaman/eduinaf/issues/5)
* 2021.0416
* Spacchettato il *file* speciali.php in tre *file* separati
* Estesi gli speciali anche ai video della settimana
* Rivisto parte del codice della griglia degli speciali
* 2021.0410
* Corretto errore in [grigliaspeciali] dovuto a *query* senza risultato
* Aggiunte tipologie di post differenti in [grigliaspeciali]
* 2021.0409
* Aggiunto il logo di Roma3
* Sistemata la parte degli argomenti del *curriculum* scolastico nella *sidebar* di astrodidattica
* 2020.1124
* Inserita la lingua italiana di *default* nei *permalink* di astroedu e spacescoop
* Aggiunto il curatore della scheda nella *sidebar* costellazioni
* Aggiunto il *widget* per la *sidebar* delle astrofoto
* 2020.1119
* Piccola modifica di codice nella mappa delle sedi INAF
* Reso automatico il menu delle costellazioni
* Aggiunto lo *shortcode* e il *widget* per la *sidebar* del corso base di astronomia
* Modifiche alla pagina di descrizione del *plugin* nella *dashboard* di wordpress
* 2020.1111
* Aggiunta opzione per intro nello *shortcode* postlooptab
* Incorporato menucostellazioni nella *sidebar* delle costellazioni
* Aggiornata documentazione interna
* 2020.1025
* Sistemazione cartella immagini
* Cambio percorso bottoni
* Aggiunto *shortcode* mappa IRNET
* 2020.1023
* Aggiunto codice che corregge errore generato dallo *shortcode* tabspeciali quando usato in un *widget* di testo, se questo risulta ultimo della *sidebar*
* Aggiunto *shortcode* (in grid.php) per la creazione di *loop* di articoli con categoria e *tag* come variabili
* Aggiunto *widget* per la *sidebar* delle costellazioni
* Pulizia css
* 2020.1022
* Corretto errore in codice html menu costellazioni
* Corretti errori nella *sidebar* didattica e sistemazioni varie del codice
* Aggiunto supporto per l'ordine personalizzato degli autori usando i *custom fields*
* Aggiunto nella tabspeciali codice che previene un errore che occorre con i *custom post type* e nasconde la tabella
* 2020.1021
* Modificato css dei menu (correzione malfunzionamento con *tag* ul)
* Corretto errore nella *sidebar* didattica che produce doppio logo *Europlanet*
* Aggiunto css per bottoni per menu orizzontale
* 2020.1020
* Eliminato css per twitter e facebook
* Aggiunto css per menu a bottoni
* Aggiunto css per menu con lista
* Aggiunto *shortcode* per la *sidebar* delle costellazioni
* Aggiunto *widget* per la *sidebar* didattica
* 2020.1001
* Aggiunto *shortcode* per la *sidebar* didattica
* Aggiunto *shortcode* per la *sidebar* astrofoto
* Aggiunti in css personalizzazioni per *headline* e per incorporazioni da twitter e facebook
* 2020.0922
* Corretto errore nella personalizzazione del *feed* che genera errore in caso di mancata installazione di Co-Authors Plus
* Nuova modifica nello *shortcode tabspeciali* che ora funziona usando lo *slug* dello speciale. Aspetto integrato con il nuovo tema e corretto errore che impedisce di pescare tutti gli articoli di uno speciale con nome costituito da più parole
* 2020.0919
* Pulizia codice speciali
* Eliminato il campo sull'url della copertina nel metabox dei dati aggiuntivi per i libri
* Pulizia codice griglia dei libri in funzione della cancellazione del campo del'url della copertina
* Accorpato tutto il css in un unico *file*, incluso il css delle mappe INAF
* Disabilitata la griglia di evidenza
* Aggiunta griglia generica per categoria, etichetta, tassonomia e suo valore
* Aggiunto shortcode per la mappa delle sedi INAF
* 2020.0908
* Aggiunto bollino livello trasversale nella cartella delle immagini per sezione astrodidattica
* Aggiunto lo *shortcode tabspeciali* che sostituirà lo *shortcode specialishort* che continua a produrre errore nella barra laterale in caso di inserimento di più speciali
* 2020.0907
* Correzione errore nel codice della tabella degli speciali (*shortcode specialishort*) che va nella spalla degli articoli
* Nella griglia degli speciali (*shortcode grigliaspeciali*), specificato di raccogliere solo gli articoli
* Cancellate righe di codice che si riferivano alla vecchia griglia
* 2020.0824
* Modifca alla griglia degli speciali: adottata la tabella personalizzata
* 2020.0728
* Aggiunte immagini per i livelli didattici nella cartella "images"
* Aggiunte costellazioni e astrofoto al *feed*, tolte attività didattiche
* Tolte le videolezioni dagli speciali
* 2020.0709
* Estesi gli speciali anche a videolezioni e alla nuova tipologia astrodidattica
* 2020.0707
* Aggiunta compatibilità con Wordpress 4.9.5
* 2020.0706
* Disabilitato contacaratteri (in conflitto con plugin che incorpora il google calendar)
* Disabilitati *shortcode* della didattica
* Nuovo *avatar* di *login*
* 2018.0625
* Aggiunto il *permalink* sull'immagine in evidenza
* Tolta la classe del titolo
* Aggiunta la data con la classe del tema
* Modifiche minori di ordine grafico
* 2018.0622
* Creazione di una griglia per la home per mostrare gli articoli in evidenza con una tassonomia personalizzata creata con plugin esterno
* Creazione del css della griglia della home
* 2018.0503
* Modifica minore per sistemare la tabella degli articoli di uno Speciale nella spalla
* 2018.0328 varie modifiche agli *shortcode* per la gestione degli Speciali
* Sostituito lo *shortcode* per la creazione della talebba degli articoli di uno speciale con uno con un controllo interno, utilizzabile direttamente in un *widget* di testo
* Modifiche minori alla griglia
* 2018.0327
* Corretto errore nel *path* di speciali.css
* 2018.0323 aggiunte funzionalità per gli Speciali
* Aggiunta una tassonomia specifica per includere gli articoli in un dato speciale
* Aggiunti due *shortcode* per la pubblicazione di un box all'interno degli articoli e di una griglia nella pagina di un dato speciale
* Aggiunto un css per la personalizzazione del box da utilizzare in futuro anche per le tabelle degli eventi
* 2018.0228
* Incluso il file shortcode.php
* Aggiunge una serie di *shortcode* compatibili con i campi creati con [Custom Field Suite](https://wordpress.org/plugins/custom-field-suite/) e associati con le attività didattiche, tipologia di post creata con [Custom Post Type UI](https://wordpress.org/plugins/custom-post-type-ui/)
* 2018.0219
* Modifiche nei *loop* e nelle griglie e aggiunta di campi personalizzati:
* Cancellazione della griglia precedente
* Creazione di una griglia per un *loop* generico
* Creazione della griglia per i libri
* Creazione degli *shortcode* corrispondenti
* Creazione di un *metabox* per l'aggiunta del titolo di un libro e dell'url della sua copertina
* Aggiunta in grid.php del codice per sostituire, se presente, il titolo del libro con il titolo del post nel caso della griglia di libri
* 2018.0217
* Aggiunto un *loop* personalizzato:
* Aggiunto uno *shortcode* che mostra tutti i post dati una categoria e un'etichetta: di *default* sono rispettivamente 'libri' e 'libri-per-bambini-e-ragazzi'
* Incluso il css per la griglia
* 2018.0214
* Aggiunti colori ai *link*
* 2018.0212
* Aggiunto *shortcode* per articoli tratti da *Sapere*
* 2018.0211
* Aemplificazioni del codice e nuova numerazione di versione
* Crezione di *file php* indipendenti con i codici relativi alla pagina di descrizione, al contacaratteri, alla manipolazione del *feed rss*, per gli *shortcode* dei *link*
* 0.9.6 test per wp 4.9.4
* 0.9.5 test per wp 4.9.3
* 0.9.4 aggiunto il Plugin URI
* 0.9.3 aggiunto il GitHub Plugin URI per l'installazione e l'aggiornamento tramite il GitHub Updater
* 0.9.2 modifiche alla pagina di documentazione; pulizia nella cartella principale
* 0.9.1 aggiunta *shortcode* per i *link* a spacescoop usando codice e lingua della news
* 0.9 aggiunta *shortcode* per i *link* ad astroEdu usando codice e lingua dell'attività
* 0.8.1 cancellazione di *shortcode* e *widget* integrati con Co-Authors Plus a seguito della creazione di plugin apposito
* 0.8 aggiunte le attività didattiche al feed rss
* 0.7.2 aggiunto contacaratteri per gli articoli
* 0.7.1 aggiunto contacaratteri per il riassunto con limite a 500
* 0.6.2 correzione codice che mostrava articoli completi sostituendolo con il sommario
* 0.6.1 correzione baco che impediva di mostrare i profili tranne il primo
* 0.6 aggiunto metodo per mostrare/nascondere profilo nel *widget* con css
* 0.5 manipolazione del footer admin della dashboard; manipolazione del feed rss: aggiunta immagine in evidenza e autori articolo; aggiunto il logo e modificati descrizione e *link*
* 0.4 aggiunta della voce del menu e della pagina di presentazione del plugin
* 0.3 aggiunta dei *link* ai profili nel *widget*
* 0.2 *widget* per gli *avatar* degli autori compatibile con Coauthors Plus
* 0.1 *shortcode* per aggiunta autori compatibile con Coauthors Plus