Category: Plugins and Extensions

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.