Commons 1.7.3

I’ve just released version 1.7.3 of the CUNY Academic Commons. Highlights of this maintenance release:

  • Improved cache validation for home page widgets
  • Improved handling of some Reply By Email errors
  • Fixed formatting of some plain-text emails
  • Fixed bug that prevented editing of the Positions profile widget in some cases
  • Fixed bug that caused new Docs in private groups to be invisible to some members
  • Force CAPTCHAs wherever Contact Form 7 is used
  • Added promotional video to home page

For complete details on the release, visit the 1.7.3 milestone.

Commons 1.7.2

I’ve just released version 1.7.3 of the CUNY Academic Commons. Highlights of this maintenance release include:

  • Improved redirect behavior for private blogs
  • Fixed some AJAX issues related to HTTPS
  • Fixed broken commenting issue on BuddyPress Docs
  • Reinstated “this is a minor edit” behavior for BuddyPress Docs
  • Fixed JavaScript filtering for front-page Members widget
  • Added Google Analytics plugin for individual Commons sites
  • New plugins: Meta Slider, Media Library Assistant
  • Improved styling for group forum topic listing

For complete details about the release, visit the 1.7.2 milestone.

Commons 1.7.1

I’ve just released version 1.7.1 of the CUNY Academic Commons. This is a maintenance release, which addresses a number of cleanup items related to last week’s 1.7 release. Some issues:

  • Fixed formatting bug in BuddyPress Docs
  • Replace missing Post New Topic button on group forum pages
  • Improve “uncouple” language on groupblog admin pages
  • Fixed some my-commons avatar bugs
  • New plugin: Better Search

For complete details, visit the 1.7.1 milestone.

Commons 1.7

I’ve just released version 1.7 of the CUNY Academic Commons. This is a major feature release for the Commons. Some highlights:

  • The new My Commons feature, which is a landing page that provides an at-a-glance view of activity related to your groups, friends, and sites on the Commons. My Commons is powered by the BuddyPress activity stream, and uses a custom page template for display.
  • A related feature is the ability to follow sites. Following a site will make activity from that site show up on your My Commons page, and your followed sites appear in a list on your Commons Profile. This feature is powered by the BuddyPress Followers plugin, written my team member Ray Hoh.
  • Group forums have been migrated from our ancient bbPress 1.x installation to the bbPress 2.x. I wrote a custom plugin that handled the migration between the old forum-attachments-for-buddypress plugin and our new forum attachment software.
  • BuddyPress Docs has also been brought up to date. The BuddyPress Docs In Group plugin was written as a shim to allow us to update without radically changing our interface.
  • Group members can download zip archives of group files, either en masse or by folder. This is a custom add-on for buddypress-group-documents, written by team member Daniel Jones.

For a complete list of changes in the release, visit the 1.7 milestone.

Commons In A Box – 1.0 beta 1

After nearly a year of development, the CUNY Academic Commons development team is proud to offer a first public beta of Commons In A Box.

Commons In A Box, funded by a generous grant from the Alfred P. Sloan Foundation, is a WordPress plugin that helps you to set up a powerful community site in no time flat. We’ve taken BuddyPress and packaged it with a number of the plugins that enhance the BuddyPress experience; bundled it with a brand-new theme based on the Infinity theme engine; and provided an installation experience that downloads, activates and configures these various pieces in just a few clicks. No more scouring Google and the wordpress.org plugin repository for BuddyPress plugins. No more wondering whether an upgrade to BuddyPress or one of your other plugins will break your site. Commons In A Box takes care of these aspects for you, so that you can spend your energy where it really counts: in fostering your community.


As you might gather from the name of the project, the impetus for Commons In A Box was the CUNY Academic Commons itself. Since launching in 2009, the Commons team has fielded countless inquiries about how we managed to pull together the site: what plugins are we using, what’s our theme called, where can I download the package. All sorts of organizations – and especially academic, educational, and non-profit institutions – have been realizing that a focused community space can enhance engagement both online and off, and the Commons has often served as a successful model. So, as we set out to put the Commons infrastructure into an easy-to-install-and-maintain package, we looked carefully at the technical aspects of the Commons that help to make the site a success. Commons In A Box represents what we think is an elegant set of tools that can help even those with modest technical skills go from zero to a functional site with as little hassle as possible, while also maintaining the flexibility and power of the free software platforms at the core of the package.

Our first task was to select a list of plugins that would replicate some of the best functionality of the CUNY Academic Commons. At the core of the package is BuddyPress, which provides extended profiles, groups, and the other social features that form the foundation of the Commons community. We also included a number of tools that have been custom-developed by the Commons development team over the last few years, ranging from collaborative document editing tools to widgets for featuring outstanding community content to the ability to respond to site content without leaving your email inbox. The package is rounded out with a number of third-party plugins that have proved crucial to the success of the Commons as a community platform, such as discussion boards and blogs linked to BuddyPress groups

Knowing which plugins to install is one barrier to entry that Commons In A Box aims to lower. The next is knowing which plugins are compatible with each other, and keeping them up to date. That’s why Commons In A Box features an installation and upgrade manager. For all plugins that are shipped with Commons In A Box, we remove the corresponding entries from the WordPress plugin screens, and centralize them on a single Commons In A Box admin panel. When you install Commons In A Box, we install recommended plugins on your behalf, making it that much quicker to get up and running. When upgrades are available for your CBOX-related plugins, we send you a single upgrade notice, and you can be totally up-to-date with a single click. We take care of making sure that the latest versions of each plugin work with each other. And we provide documentation that serves as a centralized resource for learning about BuddyPress components and add-ons.

Beyond the raw functionality of the Commons, we’ve worked tirelessly to make sure that our site’s design is professional and inviting, functional and fun. This work is reflected in Commons In A Box through the CBOX default theme, which echoes some of the more successful design considerations from the Commons. The theme includes a flexible, widgetized homepage template like you see on the Commons. We’ve packaged a large number of widget areas, making configuration a breeze. The Commons In A Box theme is powered by the Infinity Theming Engine, which strikes a perfect balance for the Commons In A Box project: it makes it easy for admins of any skill level to configure their site’s appearance, while also providing tools for designers and developers to create a truly unique community hub. Any BuddyPress-enabled WordPress theme will work well with Commons In A Box, but we think that our default theme will be a great starter for a large number of use cases.

The Commons In A Box team is hopeful that the Commons In A Box package will put BuddyPress-powered community sites within the reach of a far greater number of people than is currently the case. We’ve set up a community site where you can seek out help, talk with others who are using Commons In A Box, and share your own experiences setting up your own CBOX-powered community. And if you’re a developer and want to contribute to Commons In A Box itself, the project’s development home is github.com/cuny-academic-commons/commons-in-a-box.

Download Commons In A Box today, in the Plugins > Add New interface of your WordPress Dashboard, or by downloading directly from the wordpress.org plugin repository.

BuddyPress Docs 1.2

Today I’m releasing version 1.2 of BuddyPress Docs, the popular collaborative writing plugin for BuddyPress. Version 1.2 is a near-complete rewrite of BuddyPress Docs, with a number of notable new features.

The biggest change is that Docs functionality is no longer limited to Groups. Previously, Docs could be created only within the context of groups, with the interface for browsing, reading, and creating Docs located within the group interface. In BuddyPress Docs 1.2, Doc creation and viewing is moved into top-level templates, which gives you more breathing room when viewing and editing. This makes your URLs more attractive, too (though old, group-based URLs continue to work, through redirection). Most of all, this change makes it possible to create Docs that are not linked to a group at all.

Hand in hand with group-independence is the new Docs tab in user profiles. Here you can see the Docs that a user has created, and those that he has edited. This is a great way to get a sense of what a member is up to around the site, and also is very handy for users to keep track of changes that they themselves have made. You’ll also have access to a fully functional directory of sitewide Docs – just add a link to /docs/ to your nav menu.

There are some nifty changes under the hood, as well. The data schema for associating Docs with groups has been overhauled and simplified. And a new function, bp_docs_has_docs(), lets you initiate a new Docs loop wherever you’d like, querying according to a number of handy parameters.

If you’re upgrading from a previous version of BuddyPress Docs, you’ll see an admin notice, right after upgrading, asking you to run a short migration process. Make sure you do so right away.

This rewrite has been a long time coming, and far more complex than I’d first imagined it would be. Still, it’s likely that there are some bugs. If you find problems, please post an issue at Github.

Commons 1.3.11

I’ve just released version 1.3.11 of the CUNY Academic Commons. Version 1.3.11 is a bugfix release. Highlights include:

  • Fixed a bug that caused our non-CUNY signup code plugin to lose its metadata on autosave
  • Modified activity reply links so that they point toward the Doc in question in the case of BuddyPress Docs content
  • Adds a proper meebome widget
  • Makes some page titles more consistent in BuddyPress directories

For full details on the release, visit the 1.3.11 milestone.

Commons 1.3.5

I’ve just released version 1.3.5 of the CUNY Academic Commons. Commons 1.3.5 is a bugfix release, with the following highlights:

  • Fixed the Edit Comment link on BuddyPress Docs
  • Fixed a problem that caused some spam registrations to seep through
  • Fixed the tabindex order on the login page
  • Added WP plugins: SOPA Blackout, jQuery Vertical Accordian Menu

For more details, see the 1.3.5 milestone.