How events get on this calendar

Nobody has to maintain this site. It checks itself every hour, reads whatever public calendars it can find around Aroostook County, and puts what it finds on the calendar. Anyone can also send us a single event, no calendar feed or website needed. Every listing links back to whoever published it, so you can always check the organizer's own version. When the same event turns up in two calendars, we show it once and list both sources under it.

Here is everything we are reading right now, and when we last had a successful look.

Send us a single event

No calendar to manage, just one thing coming up? Fill this in and it lands in our review queue.

Where the events come from

Live means we are checking it every hour and it has events on the calendar right now. On, nothing yet means we are still checking but it has nothing coming up, which happens a lot in an off-season or between announcements. Needs attention means the last check failed, usually a site that moved, went down or started blocking us. We keep trying and back off so we are not hammering a host that is down. Off sources are deliberately switched off because they do not carry real Aroostook County listings, such as campus academic dates or a statewide feed with no county filter.

Running events for an organization?

There is nothing to install. If any of these sounds like you, you are probably already in:

• WordPress with the Events Calendar plugin, which is very common around here. Your events already have a public iCal export at https://your-site/events/?ical=1. Send us that link and we can add it the same day.
• Google Calendar. Publish the calendar and share its private iCal address.
• Any other kind of feed, iCal, RSS, or just a page that lists events in the same layout every time. Send the URL and we will write something small to read it.
• One event and nothing else? Use the form at the top of this page. It is the quickest way.

Want to be added now? Email alexander@aroostook.me with the calendar link (RSS, iCal, or just the page where you post events) and a sentence about your organization.

For builders and sysadmins

Every source is defined in src/Sources.php. Edit the list, then run php bin/migrate.php to seed the changes and php bin/scrape.php to pull events in. It is plain PHP and MySQL, so here is the whole thing on one line: php bin/migrate.php sets up the database and sources, php bin/scrape.php refreshes events, php bin/pending.php list shows the submissions waiting for review.

Would rather have JSON? api/events.php?upcoming=1 returns it.