School Calendar

School Calendar – Plugin WordPress

Plugin WordPress per la gestione del calendario scolastico con supporto multi-plesso, sub-calendari, permessi utente e importazione ICS.

? Funzionalità Calendario

• Visualizzazione mese, settimana, giorno e lista
• Sub-calendari con colori personalizzati (eventi multi-categoria mostrati a strisce)
• Eventi pubblici e riservati (visibili solo agli utenti loggati)
• Filtri per plesso, categoria e classe
• Click su evento per modifica rapida (se autorizzato)
• Click su data vuota per creare nuovo evento
• Duplicazione eventi con un click
• Responsive e mobile-friendly
• Opzione per nascondere weekend

? Gestione Utenti

• Pagina admin per assegnare permessi ai docenti
• Docenti possono creare e modificare solo i propri eventi
• Admin può gestire tutti gli eventi

? Importazione

• Importazione file ICS con scelta plesso e sub-calendario
• Opzione “Pulisci e reimporta” per evitare duplicati
• Sync con calendari esterni (Google Calendar, iCal)

? API REST

• API completa per integrazione con sistemi esterni
• Autenticazione tramite API Key
• Endpoint per eventi, plessi, classi, sub-calendari

---

Installazione

1. Scarica lo ZIP del plugin
2. Vai in WordPress → Plugin → Aggiungi nuovo → Carica plugin
3. Carica il file ZIP e attiva il plugin
4. Vai in “Calendario” nel menu admin per configurare

---

Shortcode

Calendario principale

[school_calendar]

Attributi disponibili:

Attributo	Default	Descrizione
view	dayGridMonth	Vista: dayGridMonth, timeGridWeek, timeGridDay, listMonth
plesso	all	ID plesso o “all” per tutti
show_filters	true	Mostra filtri plesso/categoria/classe
show_legend	true	Mostra legenda colori
hide_weekends	false	Nasconde sabato e domenica
height	auto	Altezza calendario
slot_min_time	07:00	Ora inizio vista settimanale
slot_max_time	20:00	Ora fine vista settimanale
require_login	false	Richiede login per visualizzare

Esempio:

[school_calendar view="timeGridWeek" hide_weekends="true" plesso="1"]

Form creazione eventi

[school_calendar_form]

Mostra un form per creare nuovi eventi (solo utenti autorizzati).

I miei eventi

[school_calendar_my_events]

Lista degli eventi dell’utente con possibilità di modifica/elimina. Usa show_past="true" per mostrare anche eventi passati.

Lista eventi

[school_calendar_list limit="10" days="30"]

Lista compatta dei prossimi eventi.

Widget

[school_calendar_widget title="Prossimi eventi" limit="5"]

Widget per sidebar con prossimi eventi.

---

Permessi

Ruolo	Visualizza	Crea	Modifica propri	Modifica tutti
Visitatore	✅ pubblici	❌	❌	❌
Utente loggato	✅ tutti	❌	❌	❌
Docente abilitato	✅ tutti	✅	✅	❌
Amministratore	✅ tutti	✅	✅	✅

Per abilitare un docente: Calendario → Permessi

---

Importazione ICS

1. Vai in Calendario → Importa ICS
2. Seleziona il file .ics
3. Scegli plesso e sub-calendario di destinazione
4. (Opzionale) Attiva “Pulisci e reimporta” per eliminare eventi esistenti
5. Clicca “Importa Eventi”

Campi importati:

• SUMMARY → Titolo
• DESCRIPTION → Descrizione
• LOCATION → Luogo
• ATTENDEE → Responsabile
• DTSTART/DTEND → Date e orari

---

API REST

Base URL: /wp-json/school-calendar/v1/

Endpoint principali

Metodo	Endpoint	Descrizione
GET	/eventi	Lista eventi
POST	/eventi	Crea evento
GET	/eventi/{id}	Dettaglio evento
PUT	/eventi/{id}	Modifica evento
DELETE	/eventi/{id}	Elimina evento
GET	/plessi	Lista plessi
GET	/classi	Lista classi
GET	/sub-calendari	Lista sub-calendari

Autenticazione

Cookie (frontend WordPress):

fetch('/wp-json/school-calendar/v1/eventi', {
    headers: { 'X-WP-Nonce': wpApiSettings.nonce }
})

API Key (sistemi esterni):

curl -H "X-SC-API-Key: your-api-key" \
     https://example.com/wp-json/school-calendar/v1/eventi

---

Requisiti

• WordPress 5.8+
• PHP 7.4+
• MySQL 5.7+

---

Licenza

GPL v2 or later