Description
Piazza in Festa collects the events of Italian towns from the notices that town halls and other public bodies are required to publish (the albo pretorio), and turns them into a readable calendar. This plugin puts that calendar on your site.
You pick the towns you care about, or a whole region with a service key. The list updates by itself every day: nobody on your side has to type events in, and nothing is copied into your database.
What you get
- A block called Piazza in Festa, with a live preview while you edit.
- A shortcode,
[piazza-in-festa comuni="alba,barolo,la-morra" limite="5"], for classic editor, widgets and page builders. - Filters by town and category (or a whole region, with a service key), from village feasts to concerts, markets, exhibitions and sport.
- Light and dark theme, your own accent colour, your own heading.
- Nothing to maintain: no cron job, no cache to purge, no import.
Where the events come from
Every event is reconstructed from a public document: an ordinance closing a street for the procession, a resolution granting patronage to the fair, an authorisation for the concert. Small towns included, the ones no manual calendar ever reaches. Titles and descriptions are written by AI systems reading those documents, so they can contain mistakes; each event links back to the town page where the original source is shown.
Free, and what is not
The plugin is free and every option works without an account, except one: showing a whole region instead of a list of towns needs a service key. Without a key the widget covers up to twelve towns and shows a small credit line at the bottom pointing back to Piazza in Festa. A service key from Piazza in Festa (19 € a month), pasted in Settings > Piazza in Festa, removes that line, raises the limit to fifty towns and enables the whole-region option. The key is checked by the service; the plugin only passes it on.
External services
This plugin displays events served by Piazza in Festa, an external service run by the plugin author.
When a visitor opens a page that contains the block or the shortcode, their browser loads a page from https://piazzainfesta.it/embed with the parameters you configured: the towns or the region, the categories, the optional period and word in the title, how many events to show, the language, and the appearance options (theme, colour, font, heading). If you saved a service key in the settings, the key is part of that address as well.
As with any embedded content, that request reaches the service with the visitor’s IP address and browser user agent. The plugin sends nothing from your server, stores nothing about your visitors, and sets no cookies of its own.
- Service: Piazza in Festa
- Terms and conditions: piazzainfesta.it/termini-e-condizioni
- Privacy policy: piazzainfesta.it/privacy-policy
Installation
- Install and activate the plugin.
- Edit a page and add the block named Piazza in Festa, or write the shortcode
[piazza-in-festa comuni="alba,barolo"]. - In the block settings, type the identifiers of the towns you follow, separated by commas.
The identifier of a town is the one you see in the address of its page on piazzainfesta.it: for La Morra it is la-morra. If you are not sure, build the widget at piazzainfesta.it/widget and copy the values.
FAQ
Do I need an account?
No. The plugin works right away, without registering anything.
Which towns are covered?
All Italian towns, in every region. How many events a town has depends on how much it publishes: some publish a lot, some very little.
How many towns can one widget show?
Up to twelve without a key, fifty with one. For a wider area place more than one widget, or use regione with a service key.
The events are not the ones I expected
Each event comes from a public document of a town, so the widget shows what has been published, not everything that happens. If you find a wrong or missing event, the page of the event on piazzainfesta.it has a link to report it.
Does it slow my site down?
No. The widget is an iframe loaded lazily by the browser: your pages are built and cached exactly as before, and your server never talks to ours.
Can I remove the credit line?
Yes, with a service key from Piazza in Festa, pasted in Settings > Piazza in Festa. The same key raises the limit to fifty towns and enables the whole-region option. Everything else in the plugin behaves the same either way.
Can I style it like my site?
You can set the theme (light or dark), the accent colour and the heading. The rest lives inside the frame, on purpose: that way your CSS cannot break the widget and the widget cannot break your layout.
Screenshots
Changelog
1.2.1
- The readme and the block settings now say which option needs a service key: only the whole region. Colours, dark theme, font, categories and the word in the title work without one.
1.2.0
- The widget speaks Italian, English, German and French: event texts are translated when a translation is available, and labels and links follow. By default it follows the language of the site, including multilingual sites with WPML or Polylang.
1.1.0
- Several categories at once, comma separated in the shortcode.
- Period filter (
dal,al): only events that start between two dates, for a page about Christmas or the summer. - Word in the title (
cerca), for instance “natale” inside the Christmas markets. - Font choice for the widget: the visitor’s device font, Helvetica or Georgia.
- The service now picks events by quality: posters and verified details first, no council notices, no months-long containers.
1.0.1
- Directory tags in Italian (eventi, sagre, comuni, pro loco, turismo), so that towns and Pro Loco can find the plugin. No code changes.
1.0.0
- First release: block, shortcode, filters by town, region and category, light and dark theme, accent colour, automatic height.



