Commons In A Box

One of our original project aims was that the Bebop PuddyPress plugin would be part of the CUNY Commons In A Box project, a turnkey version of CUNY’s Academic Commons. Yesterday saw the launch of Commons In A Box and I’m pleased to say that Bebop is included as one of the ‘a la carte’ plugin options.

Commons In A Box (CBOX) is a free software project aimed at turning the infrastructure that successfully powers the CUNY Academic Commons into a free, distributable, easy-to-install package. Commons In A Box is a project of the City University of New York and the Graduate Center, CUNY and is made possible by a generous grant from the Alfred P. Sloan Foundation.

CBOX takes the complexity out of creating a Commons site, helping organizations create a space where their members can discuss issues, collaborate on projects, and share their work. CBOX also provides:

  • Out-of-the-box functionality with an intuitive set-up that guides site administrators through each step of installation.
  • A powerful, responsive, highly customizable theme developed for community engagement, based on PressCrew’s Infinity Theming Engine.
  • Responsive design for easy viewing on many devices, including tablets and smartphones.
  • Collaborative document creation and file sharing.
  • Reply-By-Email functionality for quick, on-the-go communication.
  • Compatibility with many other WordPress and BuddyPress themes and plug-ins.
  • Expansive wiki options.

CBOX will be useful to any organization that is looking for a shared space in which to build an engaged community of users and developers.

Congratulations to Matt Gold, Boone Gorges and everyone else involved in the Commons In A Box project!

The Bebop plugin and documentation

The main public outcome of the Bebop project is the BuddyPress plugin, which allows a BuddyPress user to import resources (slides, images, video, etc.) hosted on third-party websites (Slideshare, Flickr, YouTube, etc.). The plugin has two homes:

If you run a WordPress/BuddyPress site, you can install Bebop from the Plugins panel in your site Administration area. Bebop works on both standalone and network/multisite installs of WordPress. Of course, you must have BuddyPress installed on the site, too.

A screenshot from the Bebop documentation
A screenshot from the Bebop documentation

Documentation on how to use Bebop is provided on our Github site, alongside the code. Documentation is provided for the following people:

General users

Site Administrators


Developers may be interested in extending Bebop as a flexible, general purpose social media aggregator. Documentation is provided on how to create new Bebop extensions for additional resource providers.

If you find a problem with the Bebop plugin and documentation, please tell us via the Github issue tracker. If you wish to discuss Bebop more generally, please use the WordPress support forum for the plugin.

What benefits and impact has/will Bebop have?

  • Bebop is having institution-wide impact due to the work we have contributed to the development of our Staff Directory. We have documented this in more detail in a separate blog post and also published the code for our custom BuddyPress profile editor.
  • The Bebop plugin has been publicly released on and has so far been downloaded around 450 times. Furthermore, we are waiting for confirmation that the Bebop plugin will be recommended by the CUNY Commons In A Box project. The plugin is also being used by a new Swiss OER portal, where Dale, the Developer of the Bebop plugin has written a blog post discussing the Bebop project.
  • Bebop provided an opportunity for staff development, providing a focused project through which new staff could learn WordPress development and other associated skills. This is been discussed in a separate blog post. The mentoring opportunity afforded by the project has been especially valuable. Now at the end of the Bebop project, these staff have been seconded to work on our HEA-funded project to embed the practice of Open Education across the university. They will be developing a showcase and portal for OER at Lincoln, as well as implementing a dedicated ePrints OER repository for Lincoln.
  • By mandating the use of BuddyPress for updating and maintaining staff profiles at the University of Lincoln, we expect more staff to become aware of the WordPress platform in general and adopt it for a variety of web publishing requirements. Over 400 staff have already used BuddyPress to update their professional profile and we will be supporting this initiative through the provision of staff workshops starting in November. In effect, we expect Bebop to contribute towards promoting and supporting the digital literacy of our staff.



What lessons have we learned?

Bebop has gone remarkably smoothly – not all projects do – and I’m pleased to say that we’ve achieved everything we set out to do. We did learn things along the way and things we already knew were reconfirmed:

  • WordPress/BuddyPress is a viable and versatile platform for managing staff profiles at a university and brings the benefits of mandating staff to engage with a popular social media platform if they are to update and maintain their professional profile.
  • WordPress has a very active and open community of users and developers and consequently values contributions from HEIs. It is a versatile technology that can bootstrap different types of projects where content management is key. We knew this before the project started, but through releasing a plugin and responding to its use by different people, the benefits of contributing to such a community have been reaffirmed. For developers new to writing open source software, WordPress offers a mature community with a very low barrier-to-entry.
  • When working with third-party services, each API is different and takes time to learn. Maintaining compatibility with changes to third-party APIs is a problem for the sustainability of the software. It’s important that there is institutional value to integrating such services with your software so that there is the justification for maintaining compatibility.
  • Identify an expert partner and cost them into your project for evaluation purposes. It doesn’t matter where in the world they live. Expert code review improves staff skills and the quality of code, benefitting all involved.
  • OERs are teaching and learning materials that are  licensed for re-use. Often, the licensing information is not provided as part of the API or syndication feed. Bebop overcomes this by providing a curatorial tool that allow the user to select specific resources for re-publication. There is less ambiguity about whether a resource is avaialable for re-use if the user has selected to include it in their profile.
  • There are a limited number of platforms that are widely used for publishing OERs in the UK. We were surprised that Jorum, the main national repository for OERs, does not yet have a method for extracting information about the resources deposited by a specific individual. The benefits of publishing OERs have often been discussed in terms of institutional benefits, but in order to provide individual benefits and therefore incentives, work on user profiles and OER use seems key.

What has the Bebop project delivered?

At the beginning of the project, we set out to deliver the following:

  • Documented Use Case of BuddyPress in an educational environment, including Lessons Learned and a technical implementation plan.
  • Documented development of the BuddyPress plugin(s) to integrate third-party APIs into a BuddyPress profile.
  • A BuddyPress theme which is compatible with the above plugin(s).
  • Documentation on the implementation of OAuth at the University of Lincoln. cf. our open source OAuth Server ( and
  • Technical design documentation for the aggregation of staff profile data at Lincoln, which demonstrates our use of MongoDB for data warehousing of people data from disparate systems.

Let’s take these one by one…

  • The BuddyPress use case is written up here and in the early days of introducing BuddyPress at Lincoln, Joss blogged about our use of BuddyPress over on his personal blog.
  • Throughout the project, Dale has been blogging the development of the BuddyPress plugin. The plugin was publicly released at the end of August and has been downloaded around 450 times by the end of the project. Documentation has been provided for both users and developers. We have also released the code to our BuddyPress profile editor, which provides other institutions with a starting point to develop their own bespoke BuddyPress profile editor.
  • Bebop was developed so that it will work with any BuddyPress theme that is based on the default BP theme. At Lincoln, we have our own custom theme for BuddyPress, which is a ‘child theme’ of the default theme and it works well. So, we have not delivered a compatible theme for BuddyPress, but rather we have ensured widespread compatibility of our plugin with existing themes.
  • Since the Bebop project began, we have also been funded by JISC to do work around the use of OAuth for SSO. You can expect to find much more information on OAuth on the Linkey project website over the next few months. The use of OAuth in the Bebop project is confined to the Twitter and Slideshare extensions, negotiating directly with their authenticated APIs. In this way, the Bebop plugin has no dependency on Lincoln’s Single Sign-On service.
  • Perhaps not a deliverable, but certainly an outcome: One of the reasons why funded projects are important to us is they they also provide us with the time and capacity for specific areas of staff development and the Bebop project is a good example of this. Both Dale and Dave were new Developers to ICT when the Bebop project began, and through working on the project they have had to learn WordPress/BuddyPress development (which means our WP platform is better supported), developing with our Common Web Design presentation framework (which means they are able to contribute to a number of services, such as the Gateway and Directory), and consequently have been seconded to our HEA-funded OER project to implement a (WordPress) portal for OER at Lincoln and a dedicated (ePrints) repository for OERs.
  • We have documented our building of the university’s staff directory in another blog post. Bebop has furthered this development by enhancing it with teaching resources that are aggregated via the Bebop plugin and then re-published via RSS to the Staff Directory.