Mass Schedule Manager

New n

Introduction

Mass Schedule Manager (commesse + modmesse)

Full description
Reviews (0)

A Joomla component to manage and publish Mass schedules for one or more churches, with configurable vigil (anticipated) Masses, holiday exceptions, special periods (e.g. summer schedules), and a companion module to display them anywhere on the site.
Mass Schedule Manager is designed for parishes, dioceses and religious community websites that need a simple, always up-to-date way to publish Mass schedules for one or more churches.

From the administrator panel you can:

manage an unlimited number of churches, each with name, description, address and rite (Roman or Ambrosian);
set up weekly schedules split into weekday, vigil (Saturday evening) and holiday, with the option to restrict a single time slot to specific days of the week;
flexibly configure, per church, how the anticipated ("vigil") Mass for a midweek feast is handled: none, same time as the Saturday vigil Mass, a specific dedicated schedule, or automatic calculation from the last evening weekday Mass (with an optional time range);
choose whether active seasonal periods (e.g. summer schedule) should also determine the vigil Mass time;
manage date-specific exceptions (e.g. a patronal feast);
manage periods (date ranges or whole months) during which a schedule type can be suppressed or replaced with an alternative one;
display the next upcoming Mass and the full schedule on the frontend, including the weekday when relevant;
use a built-in test mode with a simulated date.

The package also includes mod_messe, a frontend module that displays the next Mass time (or the full schedule) for a specific church in any module position of your template.

Key features

Multi-church management with Roman/Ambrosian rite support
Weekday, vigil and holiday schedules, with optional restriction to specific weekdays
Configurable vigil/anticipated Mass per church, with 4 modes
Choice of whether seasonal periods affect the vigil Mass calculation
Date-specific exceptions and periods with schedule suppression/replacement
Automatic "next Mass" display
Dedicated frontend widget module
Test mode with simulated date
Option to keep data in the database on uninstall
Full set of form save buttons (Save / Save & New / Save & Close / Close)
Administrator interface available in Italian and English
Built following Joomla coding standards (PSR-4 namespaces, MVC, ACL)

Requirements

Joomla! 5.x or 6.x
PHP 8.1 or higher
MySQL / MariaDB with InnoDB and utf8mb4 support

Installation

Download the latest package from this repository's Releases section (pkg_messe_vX.X.X.zip) and install it from System → Manage → Install in the Joomla backend. The package includes both the com_messe component and the mod_messe module.

To update, there's no need to uninstall the previous version first — simply install the new package over the existing installation.

Quick usage guide

Add a church

Components → Mass Schedule Manager → Churches → New. Enter name, description, address and rite.

Weekly schedules

For each schedule type (Weekday, Vigil, Holiday) you can add one or more time slots with hour, minutes, an optional label, and a "Days" field (0-6, 0=Sunday, comma-separated) to restrict the time slot to specific days.

Vigil (Anticipated) Mass Mode

For each church choose between: None / Same time as the Saturday Vigil / Specific dedicated schedule / Last evening weekday Mass (with an optional time range).

Periods and exceptions

Manage seasonal schedules (e.g. summer) and special dates from the respective sections of the church form.

mod_messe module

Content → Site Modules → New → Mass Schedule to display a church's schedule in any template position.

For the full options guide, see the docs/ folder in this repository.

Repository structure

. ├── com_messe/ Component source code ├── mod_messe/ Module source code ├── docs/ Extended documentation (IT/EN) ├── LICENSE GPL v2 license text └── README.md This file (Italian) / README.en.md (English)

Contributing / Reporting issues

Bug reports and feature requests are welcome in this repository's Issues section.

License

Released under the GNU General Public License v2 or later. See the LICENSE file for the full text.

Author

Gioacchino Cipriano — gioacchinocipriano.it

Extension developed with the support of Claude AI (Anthropic).

Gestione Orari Messe (commesse + modmesse)

Componente Joomla per gestire e pubblicare gli orari delle Sante Messe di una o più chiese, con messe prefestive configurabili, eccezioni per festività, periodi speciali (es. orari estivi) e un modulo widget per mostrarli ovunque nel sito.

Descrizione

Gestione Orari Messe è pensato per parrocchie, diocesi e siti di comunità religiose che devono pubblicare in modo semplice e sempre aggiornato gli orari delle Sante Messe di una o più chiese.

Dal pannello di amministrazione è possibile:

gestire un numero illimitato di chiese, ciascuna con nome, descrizione, indirizzo e rito (romano o ambrosiano);
impostare gli orari settimanali suddivisi per feriale, vigilia (sabato) e festivo, con possibilità di limitare un singolo orario solo ad alcuni giorni della settimana;
configurare in modo flessibile, per ciascuna chiesa, come gestire la messa prefestiva (l'anticipo di una festa infrasettimanale): nessuna, stesso orario della vigiliare del sabato, un orario dedicato specifico, oppure calcolo automatico dall'ultima messa feriale serale (con fascia oraria facoltativa);
scegliere se i periodi stagionali attivi (es. orario estivo) debbano determinare anche l'orario della messa prefestiva;
gestire eccezioni puntuali per una data specifica (es. festività patronale);
gestire periodi (intervalli di date o interi mesi) durante i quali un orario può essere soppresso o sostituito con un orario alternativo;
mostrare sul frontend la prossima Santa Messa e l'elenco completo degli orari, con visualizzazione del giorno della settimana quando rilevante;
includere una modalità di test con data simulata.

Il pacchetto include anche mod_messe, un modulo per il frontend che mostra il prossimo orario di Messa (o l'elenco completo) di una chiesa specifica in qualunque posizione del template.

Caratteristiche principali

Gestione multi-chiesa con rito romano/ambrosiano
Orari feriali, vigilia e festivi, con limitazione opzionale a specifici giorni della settimana
Messa prefestiva configurabile per chiesa in 4 modalità
Scelta se i periodi stagionali influenzano il calcolo della messa prefestiva
Eccezioni per singole date e periodi con soppressione/sostituzione degli orari
Visualizzazione automatica della prossima Santa Messa
Modulo widget dedicato per il frontend
Modalità di test con data simulata
Opzione per mantenere i dati nel database in caso di disinstallazione
Pulsanti di salvataggio del form completi (Salva / Salva e Nuovo / Salva e Chiudi / Chiudi)
Interfaccia amministrativa in italiano e inglese
Sviluppato secondo gli standard Joomla (namespace PSR-4, MVC, ACL)

Requisiti

Joomla! 5.x o 6.x
PHP 8.1 o superiore
MySQL / MariaDB con supporto InnoDB e utf8mb4

Installazione

Scarica l'ultimo pacchetto dalla sezione Releases di questo repository (pkg_messe_vX.X.X.zip) e installalo da Sistema → Gestisci → Installa nel backend di Joomla. Il pacchetto contiene sia il componente com_messe sia il modulo mod_messe.

Per aggiornare, non è necessario disinstallare la versione precedente: installa semplicemente il nuovo pacchetto sopra quello esistente.

Guida rapida all'uso

Aggiungere una chiesa

Componenti → Gestione Orari Messe → Chiese → Nuovo. Inserisci nome, descrizione, indirizzo e rito.

Orari settimanali

Per ciascuna fascia (Feriale, Vigilia, Festivo) puoi aggiungere uno o più orari con ora, minuti, etichetta opzionale, e un campo "Giorni" (0-6, 0=domenica, separati da virgola) per limitare l'orario a giorni specifici.

Modalità Messa Prefestiva

Per ogni chiesa scegli tra: Nessuna / Stesso orario della Vigiliare / Orario dedicato specifico / Ultima messa feriale serale (con fascia oraria facoltativa).

Periodi ed eccezioni

Gestisci orari stagionali (es. estivi) e date speciali dalle rispettive sezioni del form chiesa.

Modulo mod_messe

Contenuti → Moduli di sito → Nuovo → Orari Messe per mostrare gli orari di una chiesa in qualsiasi posizione del template.

Per la guida completa alle opzioni disponibili, vedi la cartella docs/ di questo repository.

Struttura del repository

. ├── com_messe/ Sorgenti del componente ├── mod_messe/ Sorgenti del modulo ├── docs/ Documentazione estesa (IT/EN) ├── LICENSE Testo della licenza GPL v2 └── README.md Questo file

Contribuire / Segnalare un problema

Le segnalazioni di bug e le richieste di funzionalità sono benvenute nella sezione Issues di questo repository.

Licenza

Distribuito sotto licenza GNU General Public License v2 o successiva. Vedi il file LICENSE per il testo completo.

Autore

Gioacchino Cipriano — gioacchinocipriano.it

Estensione realizzata con il supporto di Claude AI (Anthropic).