Blog

Wordpresser extension released

  • Seb Bacon
  • 20 Apr 2021
People who run CKAN-powered websites often want to extend the powerful publishing, auditing and harvesting features of CKAN with Content Management features.  For example, it's common to want to create and edit help pages, background info, and news sections. Rather than reinvent the wheel and build a CMS within CKAN, we've decided to explore how we can seamlessly integrate with existing CMSes, with the minimum of fuss. Enter the Wordpresser extension.  Installation is simple; from the documentation:
  1. Install the extension like any other extension, i.e. $ pip install -e hg+https://bitbucket.org/sebbacon/ckanext-wordpresser#package=/ckanext-wordpresser
  2. Set up a Wordpress site (e.g. at wordpress.com) and add a Page or two to the primary navigation (I suggest using Wordpress 3's new menus feature)
  3. Edit your development.ini config file (or production ini file, of course) with something like: wordpresser.proxy_host = http://<yoursite>.wordpress.com/
  4. The pages that you added to Wordpress will appear in your CKAN instance, appended to the main navigation
The screenshots below show how it works in practice.  The smaller shot at the bottom left is a page as it appears in the Wordpress blog; the main shot is of a CKAN instance, with the same page embedded and themed according to the main CKAN theme.  Note how the Wordpress navigation has been appended to the CKAN navigation: Illustration of how wordpress content is included inside CKAN This solution works really well, because:
  • the site's theming, whether of a CKAN package or a Wordpress blog post, is done entirely in one place (namely the CKAN css)
  • you get all Wordpress's features, like comments, blogs, and rich media plugins
  • you keep all the rich functionality provided by CKAN, such as package editing, faceted searching, or statistics about your datasets
  • you continue to benefit from upgrades to both systems
The latter point is important: the alternative, using the CKAN API to create your own custom frontend, gives you lots of power over its presentation, but means it's hard integrate new CKAN features as they are released. The software is still in alpha version, and there are several improvements we'd like to make -- especially providing user account integration between CKAN and Wordpress (so that blog comments and package edits are linked to the same user accounts).  We'd also like to make some simple Wordpress widgets for displaying comment panel like "latest data" and "common tags", so people can easily construct custom home pages for their sites. If you'd like to try the software out, drop us a line on the ckan-discuss mailing list, and we'll answer any questions you might have about installation.