screenshot of the IndieWeb Twenty Fifteen theme

IndieWeb Twenty Fifteen WordPress Theme

Github repository for this theme.

This is an IndieWeb friendly forked version of the annual WordPress Twenty Fifteen theme that has improved support for microformats version 2. It is a relatively clean, simple, and responsive design which is well suited for use as a personal website.

Child Theme

It is recommended that one use this theme in conjunction with a child theme so you can make your own changes and customizations if necessary.


Microformats 2

Rough outline of the changes from the original:

  • Modified the header.php file to remove the erroneous hfeed microformat that was being put on all pages.
  • Changed the archive.php page to add h-feed and hfeed to create the appropriate feed pages (I need to doublecheck this in an actual reader, but it looks good on the page and seems to parse properly.)
  • In the functions.php file, I’ve wrapped the_content in e-content, wrapped the_excerpt in p-summary
  • In the functions.php file, I’ve added a filter that will add h-entry to the correct place.
  • The meta data section of posts created by inc/template-tags.php has been modified to provide an h-card on posts. While not shown visually on the page, if users have a gravatar associated with their user account, it should be found by parsers and is able to be displayed when leaving responses on others’ sites.

Thanks to improved microformats support, this theme should be more compatible than most for use with and particular publish functionality. The Syndication Links plugin is a simple way to enable Bridgy publish functionality, if desired.


The function.php file has a snippet for automatically approving Webmentions. This can be commented out for those who may have spam issues in the future.


The footer includes badges to show support for IndieWeb and Microformats. If one adds the Webmention plugin, a line at the bottom of the footer.php file can be uncommented to reveal the Webmention badge as well.


This theme is still compatible with the WordPress customizer and has a few built-in options for changing the theme’s colors as well as adding header and background images to personalize it to one’s taste.

To do list

  • For better Syndication Links plugin compatibility, move the syndication links meta into /inc/template-tags.php
  • For better Simple Location compatibility, move the Simple Location meta output into /inc/template-tags.php
  • If/then statement in footer.php to check for Webmention support to automatically show that badge which is currently commented out.
  • Code for declaring microformats support to other plugins?

11 thoughts on “IndieWeb Twenty Fifteen WordPress Theme”

  1. Hi Chris, you may be able to shed some light on this when you can. I’ve installed and am playing around with your iwtwentyfifteen theme on my site. It’s excellent, I really really like it, thank you. I’ve noticed though that my Pages (see About page) and all of my posts when clicked on (see example) display quite differently to the way they do on your site.

    There’s a lot of white space visible at the top of Pages and posts and the main menu looks misaligned. I’d also prefer if the content of all of my Pages and single posts appeared identically to the way they do on my homepage – inside a sticky note like box that stands out from the background. The posts look white on a white background at the moment. Is there code I can add/edit in the theme’s source files to make these changes?

    1. Davey, there’s definitely something quirky going on, though I can’t tell immediately what it is. Off hand it looks like there’s an HTML tag that may not be closed somewhere. The plain vanilla version on my server isn’t having some of the same issues I’m seeing on yours, most of which appear to stem from the formatting of the left hand sidebar.

      Are you running a child theme? I know you’ve made some customizations in at least a few places. Perhaps try starting from scratch and then re-adding your modifications one at a time to see which may be causing the conflict?

      Whatever is wrong is not affecting your archive pages (eg: or which appear as expected. This means it’s unlikely an issues with changes you made to your header, footer, sidebar, or archive files. Did you make any direct changes to content, single, or index.php files?

      You might also try removing some of your widgets temporarily to see if there’s a conflict with one of those, though I’d guess that’s less likely unless you have one or more that appear on some pages and not others.

      Whatever is causing the issue should fix almost all of the wonky display issues you’re seeing to give you the “sticky note” effect you’re looking for. If you want to make other simple changes, you can browse through what’s available in the Customizer, some of which is described here:

    2. Davey, there’s also a highly reasonable chance that if you’ve installed the theme directly from Github by uploading through the admin interface that is what is messing things up. When you do that, Github prefixes the top level folder structure with -master, which means that the files that live below it won’t always find the right pathways and other files. As result you’ll probably be missing things like the footer images, the screenshot in your Themes admin at /wp-admin/themes.php and likely some additional CSS files which are causing your display issues.

      I haven’t used it myself though I know the developer well and have heard it works around this issue, but you might try out the Github Updater plugin as a means of installing/updating themes and plugins from Github.

      Another solution is either to manually remove the ‘-master’ from the folder name on your server or install the theme manually via FTP to your server. Hopefully this will get your display issues sorted.

  2. Wolf says:

    just installed it. Looks fantastic, thank you!

    1. Glad you like it. @daveymoloney noticed an issue with it the other day, that I see you’re having as well. I’ve documented a potential fix here. Let me know if that doesn’t clear it up.

      Syndicated copies:

  3. Appreciate your help with this Chris. I agree, I see similar things happening on Wolf’s site. I took your advice and installed the Github Updater plugin and then started from scratch removing your theme from my site initially. I then re-installed the master iwtwentyfifteen theme from Github via the plugin interface and also created a … Continue reading

  4. I will fork this into a Drupal theme in the near future. I will probably be able to remove some specific markup or templates re: microformats as the IndieWeb module handles most of it, but I just like the overall style, it looks really great!

Leave a Reply

Your email address will not be published. Required fields are marked *