New stable release: v0.20111021

We’re pleased to announce a new stable release of the Calagator platform, a well-tested version of the Calagator source code for those that want to run their own instance. Please note that this should be the final stable release of the Calagator platform based on Ruby on Rails 2.x, with future releases moving to Rails 3.x.

You can download this release from https://github.com/calagator/calagator/tree/v0.20111021 or checkout the “v0.20111021” tag from the git repository at https://github.com/calagator/calagator

CHANGES (from https://github.com/calagator/calagator/blob/v0.20111021/CHANGES.md)

• [DEPENDENCY] Upgraded to Rails 2.3.12.
• [MIGRATION] Added venue details so organizers can specify per-event information like room number, access code, etc.
• [THEME] Added mobile CSS stylesheet for friendlier experience on smaller screens.
• Updated Upcoming importer to work around invalid UTC dates emitted by current API.
• Updated Plancast importer to use the new, official JSONP API.
• Updated Meetup importer to use the new, official API if a key is available. See instructions in `INSTALL.md` file.
• Update robot exclusion rules to allow Google Calendar to subscribe to filtered searches.
• Updated iCalendar exporter to include venue address and source URL.
• Added “opensearch” to let browsers use Calagator as a search provider.
• Added Vagrant support, allowing easy setup of a development environment. See instructions in `VAGRANT.md` file.

KEY

• [THEME] – Changed theme structure, see the themes/README.txt file for details.
• [MIGRATION] – Change schema, run `bundle exec rake db:migrate` to apply.
• [DEPENDENCY] – Changed dependencies.

Thank you for your support!

-igal

Code sprint report: June 4, 2011 — mobile UI, venue address exports, venue details, better Plancast import and more!

We had a productive code sprint as part of the PDX11 Hackathon.

Participants

Roy Martin, Daniel Hedlund, Bart Massey, Selena Deckelmann, Leif Warner, William Van Hevelingen, Kirsten Comandich, Dunbar Aitkens, Mary Anne Thygesen, Reid Beels, Audrey Eschright and Igal Koshevoy.

Resolved

• Added mobile interface to improve user experience on devices with small screens. The new interface puts the most useful information at the top and makes better use of screen real estate, reflows text for graceful zooming, and hides infrequently-used features behind click-to-expand controls.
• Improved iCalendar exports and feed to include the venue’s address and Calagator source URL.
• Updated to Hpricot 0.8.4 library, which should eliminate or reduce segmentation faults, primarily encountered in tests.
• Fixed missing “bundle exec” references in documentation and webadmin service.
• Improved documentation to explain the search engine service ports used, which need to be firewalled.
• Fixed “Cinderella event” handling, so events ending at midnight aren’t shown as part of the next day’s listing.
• Added per-event venue details field, for describing the room used and other event-specific information.
• Improved Plancast importer to add machine tags to the event, so that their RSVPs and links are immediately available.
• Confirmed that all index and show actions can emit XML and JSON for those consuming our data.
• Fixed test suite to eliminate non-deterministic behavior caused by state leaking between tests.
• Fixed tests so they don’t access the network and fail.
• Refactored views that display subnav menus by extracting common logic into helpers.
• Removed custom geocoder keys in hopes of simplifying setup — only to have to revert these changes because the keys are still needed for displaying maps on anything other than “localhost”.
• Updated “Code” link in header to point to github.
• Removed unwanted files that were accidentally checked in.
• Added a custom iCalendar “prodid” value. Unfortunately, the patch to populate this with Unicode 6.0 glyphs of a crocodile, a calendar, and a happy-snowman-wearing-a-fez were rejected. This decision may need to be reconsidered in the future.

Closed completed issues

• Issue 434: Review and merge rical_remodel branch.
• Issue 443: Recent changes feed should link to both the change log entry and actual entry.
• Issue 357: Deleting sources should delete their associated events and children.
• Issue 424: Refresh version shouldn’t throw an exception.
• Issue 423: Calagator should be able to export events to Google Calendar.
• Issue 306: Submit patches to acts_as_versioned.
• Issue 316: Consider adding version number to iCalendar export.
• Issue 196: Fix acts_as_solr, make it log to a file.
• Issue 401: JSON should be supported by all controller actions.
• Issue 436: Solr’s admin port should not be publicly accessible.
• Issue 447: Import Plancast events.
• Issue 191: Submit patche to acts-as_solr that make it work.
• Issue 397: Timezone in settings should be used.
• Issue 24: Include venue information in iCalendar exports.
• Issue 339: User should be able to create a new event from an old one.

Added and updated issues

• Updated Issue 387: Add JavaScript widgets and usage instructions.
• Added Issue 450: Write guide with per-platform installation instructions.
• Added Issue 451: Add per-item duplicate squasher.
• Added Issue 452: Add fuzzy venue search.
• Added Issue 453: Improve the import system.
• Added Issue 454: Migrate to Ruby on Rails 3.

Thank you for your contributions and support!

-igal

New stable release: v0.20110603

We’re pleased to announce a new stable release of the Calagator platform, a well-tested version of the Calagator source code for those that want to run their own instance. This big release was made possible through the generous contributions of many volunteers at the PDX11 Civic Hackathon and various smaller sprints.

You can download this release from https://github.com/calagator/calagator/tree/v0.20110603 or checkout the “v0.20110603” tag from the git repository at https://github.com/calagator/calagator

KEY

• [!] – Important note regarding some change.
• [THEME] – Changed theme structure, see the `themes/README.txt` file for details.
• [SETTING] – Changed setting structure, see the `themes/README.txt`file for details.
• [SECRETS] – Changed secrets structure, see the `INSTALL.md` file for details.
• [MIGRATION] – Change schema, run `bundle exec rake db:migrate` to apply.
• [DEPENDENCY] – Changed dependencies.

CHANGES (from https://github.com/calagator/calagator/blob/v0.20110603/CHANGES.md)

• [DEPENDENCY] Added `bundler` for installing dependencies and isolating from unwanted versions of gems. See `INSTALL.md` for usage information.
• [MIGRATION] Added fields to Venues: access notes, “has public wifi” flag, and “is closed” flag.
• [THEME] Added file to describe appropriate content for a Calagator instance, e.g. “Portland-area tech events”. If not present, a reasonable default will be displayed.
• [SETTING] Removed `tz` field. You now only need to set `timezone`. If theme still has `tz`, it will be ignored.
• Fixed documentation to explain how to create a theme, setup a `development` environment, and install a `production` server.
• Fixed export to Google Calendar, which could fail if the event’s description was long or truncated at a bad place.
• Fixed exception notification to send emails with Rails 2.3.10 and newer, submitted fix as patch to `theme_support` plugin maintainer.
• Fixed exception notification to set `From:` in a helpful way so that these can be replied to by those subscribed to notifications.
• Fixed previewing of a new event with a new venue, it would throw an exception.
• Fixed duplicate squashing to not throw exceptions if called with blank arguments, like when hit by a bot.
• Fixed version refresh system, used on event/venue edit forms, to switch between versions of a record.
• Added parsers to import Plancast and Meetup events.
• Added Plancast machine tag to connect Calagator events with their external Plancast counterparts and display Plancast attendees on the event page.
• Added ePDX machine tag to connect events with their ePDX groups.
• Added JSON and KML exports to the venues listing.
• Improved iCalendar importing system to use the better `RiCal` library.
• Improved venues listing to show the latest and most popular venues, search venues, display map, etc.
• Improve display of URLs on various pages by truncating them if they’re long.
• Improved imported sources so they can be deleted and remove their associated event and venue records.
• Improved recent changes rollback system to display messages, be able to rollback the `create` events, and redirect to appropriate pages.
• Improved event form to accept URL parameters, so it can be pre-populated with desired values.
• Improved venue destroy to prevent someone from removing a venue that still has events, to avoid orphaning these.
• Improved new venue form to accept simplified address and not request longitude/latitude.

Thank you for your support, and we’ll hopefully see many of you at the Calagator code sprint tomorrow at the PDX11 Civic Hackathon: http://calagator.org/events/1250460557

-igal

Tags! Magic Tags! Tags for People and Places!

Over the last year, we’ve made some changes to how Calagator works with tags. Events have them, and venues have them, but they aren’t very useful if you can’t use them to link to other things. So we’ve been working on that.

Popular tags for events are displayed in the left sidebar of the main page:

If you go to an event page that has tags, you will see something like this:

Click on any tag’s link and it will take you to a search page with all events (or venues, if you’re on a venue page) that share that tag name.

Calagator also recognizes a special kind of tag, known as a machine tag. Machine tags are a way of providing short pieces of structured data. In our case, we’re using them to link to the Plancast or Upcoming pages for an event, letting you see who else you know might be attending.

Not only that, but thanks to a contribution by Max Ogden, Plancast tags do one more thing:

All attendees for that plan are displayed on the Calagator event page. Pretty neat.

The basic format for a machine tag is ‘source_name:reference_type=reference_id’. For Plancast, that looks like ‘plancast:plan=plan_id’ (you can get the plan id from the url on their site).

Our tag model includes a list of sources and types of links currently supported. In addition to the two sources mentioned above, useful for events, you can tag venues with the relevant Foursquare, Gowalla, and Shizzow links. We also have support for ePDX tags, which can be used to link to things like a sponsoring company, the person who’s organizing an event, or the user group the event is part of.

New Stable Release – v0.20110301

Igal reports:

I’ve published a new stable release of Calagator. You can download this release from https://github.com/calagator/calagator/tree/v0.20110301 or checkout the “v0.20110301” tag from the git repository at https://github.com/calagator/calagator

v0.20110301:

• [!] This version adds support for specifying the search engine to use for local data. The new default is `sql`, which requires no configuration or setup to work. If you have an existing Calagator instance and want to continue using ActsAsSolr, edit your `config/secrets.yml` file and specify `search_engine: acts_as_solr`. See the “Search engine” section of the `INSTALL.md` file for details.
• [SECRETS] Added `search_engine` field for specifying search engine.
• [DEPENDENCY] Upgraded to latest stable releases of Ruby on Rails and other libraries. Use `rake gems:install` to install them.
• [DEPENDENCY] Added optional `sunspot` search engine, which provides the best search results and is more reliable, efficient and speedy than `acts_as_solr`.
• Fixed importing to support Upcoming’s mobile site, the only one many users can now use.
• Fixed performance of duplicate checking and squashing interfaces.
• Fixed exceptions thrown when filtering events by invalid dates.
• Improved dependencies so production environment doesn’t need testing libraries.
• Added `sql` search engine, which is used by default and requires no configuration or setup.

Ask Calagator: RSVPs

Calagator is a collaborative, community project. If this discussion interests you, we encourage you to get involved by asking more questions, joining the mailing list, or coming to a code sprint if you’re in Portland.

Now: you ask, we attempt to answer. The response is behind a cut because it’s a bit long; different core team members often have different approaches to things, so we included two responses.

Aaron says:

I use Upcoming or Eventbrite so that I can manage RSVPs for a variety of free events… I know that you guys have been working on the feature for a while; it’s really the one reason why I don’t pay much attention to Calagator at this point. While I’d love to support the local guy, I need the features that the non-local guy has

Ask Calagator

'Calagator Loves You' session at BarCampPDX - photo by Selena Deckelmann

Maybe you already know everything you want to about Calagator. It is pretty easy to use, after all. But perhaps after over two years of it being out in Portland’s tech community (as well as communities around the world), there are a few things you’d like to find out. Post your questions in the comments and we’ll do our best to answer them here on the blog.

Calagator at Recent Changes Camp

We had a Calagator code sprint this weekend at Recent Changes Camp, an unconference about wikis and related topics. Wikis have strongly influenced our design decisions (all events and venues are freely editable by all users, and changes are tracked so you can see what’s been edited), so it’s very cool to hear Wikipedia editor Steven Walling describe how our support for the Universal Edit Button sold him on Calagator. Listen to him talk about this in a short video recorded during RCC09.

We made good progress at Saturday’s sprint. Perhaps the most exciting bit of news is that Igal’s “with_theming” branch has now been merged into the main code. This means that Calagator now has support for other groups using our software in their own communities, with custom text and styling.

Before this, people had to edit out the Portland-specific parts by hand. There are already users in Sweden and Vancouver, BC running their own Calagator instance, and this update makes the process much easier. We’re working on fleshing out the documentation, but take at look at the theming README to get started.

Other documentation on how to install, use, and contribute to Calagator is available on our Google Code wiki.

Our First Year

Last month, I asked Calagator contributors to reflect on where we’ve been and where we’re going. We started out trying to create a public, collaborative calendar, using agile development techniques—in particular “do the simplest thing that could possibly work.” Did we succeed? Here’s what they said.

Our code sprinters have enjoyed working on the project. “Lack of time” seems to be the most common reason for not being involved more. We recently created guidelines for submitting a patch, so people will be able to contribute even if they can’t get to code sprints. Our hope is that this will encourage contribution from outside Portland as well.

The most popular requests for where we go next involve expanding Calagator to other areas, and allowing users to mark what events they’ll be attending. The work on those features is just about ready for primetime. You can follow the progress on our mailing list, or check back for further announcements in a couple weeks.

One of the things I’ve been impressed by is how many more tech events Portland has now that there’s a central calendar to find them. In the last year we’ve gained a number of new groups and events that were enabled by people being able to see what else was going on, and what needs aren’t being met. These events are able to grow beyond the organizer’s personal network because there’s someplace the entire community is watching. That’s inspiring.

The usefulness of such a tool has not escaped notice outside the Portland area. Our code has always been available to fork and use elsewhere, but now that we’ve started to add support for re-theming, we’re seeing more people setting up their own copy for another community they’re involved in. We hope that Calagator will eventually be able to support many different areas from the same site, but there’s much work needed to get us there. In another year, maybe we’ll be able to show you a giant starfish of a Calagator, connecting people from around the world.

So yes, it seems we succeeded. Which is not to say that there’s nothing left to do. We have a pesky recurring events requirement that’s turned out to be very complicated to implement, as well as a number of other improvements in the tracker. And that’s before we get into the whole world domination thing. I hope you, the Portland tech community, and those in places beyond, will continue to follow along and join us in creating “the best calendar aggregator possible”.

Happy Birthday Calagator!

Today Calagator is one year old. From the mailing list report on our first code sprint:

Update for 1/19 (first meeting): Today several of us met during the Code Sprint gathering at CubeSpace to talk and work on the calendar. … The first draft of the application is available at http://calagator.org/

In just one meeting we had a working application with basic features. Since then we’ve fleshed it out substantially, but of course there’s so much more to do. Please join us for a first birthday code sprint and party afterward, on January 24th, to celebrate how far we’ve come from “wouldn’t it be nice to have a community calendar anyone could edit?”, and build toward future awesomeness.