Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Open Knowledge Foundation general-purpose Wordpress theme (v2). Based on Bootstrap and Buddypress.
PHP CSS JavaScript
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
css multiline authors openglam
fonts Fix Subsetting on .woff fonts for International School of Data instances
images remove robot from chalkboard banner
include shower.js
languages arabic translations
less multiline authors openglam
.gitignore [screenshot]: Included in the repo again.
README.rst readme spelling mistake
archive.php banner template
category-priority.txt Add category priority to theme options
class-tgm-plugin-activation.php TGM-Plugin-Activation
events.php Replace all uses of get_settings with get_option
fluid.php fluid template added
footer.php fix homepage twitter
full-banner.php add banner colour option to banner template
functions.php Change the options search to not throw errors
header.php Change the options search to not throw errors
home-page.php Replace all uses of get_settings with get_option
index.php banner template
magazine-front.php Change the options search to not throw errors
mailing-bar.php Change the options search to not throw errors
onecolumn-page.php banner template
petition.css Petition css added
presentation.php Replace all uses of get_settings with get_option
pull-theme Add pull-theme and push-theme helpers for theme-okfn subtree
push-theme Add pull-theme and push-theme helpers for theme-okfn subtree
screenshot-blue.png screenshots added
screenshot-default.png screenshots added
screenshot-grey.png screenshots added
screenshot-school.png School of Data theme added
screenshot-turquoise.png screenshots added
screenshot-white.png screenshots added
screenshot.png screenshots added
search.php banner template
shortcodes.php Only show 10 tweets
sidebar.php change post layout back to two columns
simple_html_dom.php [reboot]: Rebooted wp-okfn-v2 repository here with its issues.
single.php Replace all uses of get_settings with get_option
style.css revert ribbon fixes
yarpp-template-magazine.php [yarpp]: Basic template


OKFN Master Theme

This is a child theme of the BuddyPress bp-default theme.

We override:


And additionally provide function hooks in:


...and that's it! Wordpress' output is modified via callbacks in functions.php. We structure the page in header/footer but aim to use the parent theme's templates in all other cases. Wordpress always provides a more robust override mechanism.



To create a magazine frontpage for your blog, create a page and choose 'Magazine' as its Template (on the right hand side).

Magazine mode will display:

  • The latest blogpost with the category "Featured" at the top.
  • The latest four blogposts which aren't that one beneath it.

The magazine template will display the 'Featured Image' from each blog post.

There is a simple algorithm to choose which category is displayed on the ribbon. The priority order of categories can be viewed and overwritten in the 'Blog' section of the theme options.

To use YARPP to display Related Posts as magazine entries on the post view page, open up the YARPP widget settings.

  • Disable "Automatically display related posts"
  • Select "Display using a custom template file" (yarpp-template-magazine.php)


The Home template adds Magazine style blogposts to the bottom of the page. By default, only posts in a category named "Featured" will be displayed (this category can be changed in the 'Blog' section of the theme options). Images are handled in the same manner as described above.


Display content in a series of slides. Example here:

Theme Options

The theme can be customised in a variety of ways via the Theme Options. These settings can be found in WordPress admin under Appearance >OKF Theme Options.

Supported Shortcode


To add a carousel to your page can be as simple as:

[slide img="http://slide1.jpg" class="active"]
[slide img="http://slide2.jpg"]

Please note that one of the slides must have class="active" applied to it, this will be the first slide that is displayed.

Some predefined classes can be applied to the carousel to alter the styling:

text-right photo-stack

Other supported attributes are heading and caption. For example, to add a caption to a slide you would enter it as follows::

[slide img="http://slide1.jpg" class="active"]
[slide img="http://slide2.jpg" caption="My caption for slide two"]

Static Banner

If you only want a single banner image, use the below:

[banner bg=""]
Banner text here.

Pseudo Sidebar

If you are using the 'One column, no sidebar' template to hide the default sidebar, you can mimic the default layout like so::

[pseudocontent] My main content [/pseudocontent]
[pseudosidebar] My sidebar content [/pseudosidebar]

Image Caption

Wrap an image and its caption in a border

[caption width="450" caption="My caption"]
<img src="http://image.jpg" alt="" width="450" />

Hide Page Title

Use to hide the page title


Full Width

Force content div to be 100% wide


BS Columns

Divide single column. Span is a number of the 12 Bootstrap columns

[column span="6"]
Left Column Content
[column span="6"]
Right Column Content


Clear floats



Use class="in" to have the accordion open by default

[accordion heading="Heading One" class="in"] content [/accordion]
[accordion heading="Heading Two"] content [/accordion]

RSS Ticker

Show scrolling previews from an RSS feed:

[rss feed="" type="ticker"]

Image List

List of images with text beside

[ili image="" title="Title One" description="Description One"]
[ili image="" title="Title Two" description="Description Two"]
[ili image="" title="Title Three" description="Description Three"]
Something went wrong with that request. Please try again.