From IndieWeb
Jump to: navigation, search

WordPress Themes are a simple way to quickly change the look and feel of a WordPress website primarily by use of CSS.


Why use a particular WordPress theme?

WordPress themes primarily change the look and feel of a site through the use of CSS and often the underlying HTML that displays your content.

Different themes may do this in different ways, with differing levels of markup quality.

Selecting a theme that provides higher markup quality (valid, semantic, proper use of microformats) improves the computer-readability of your pages, for peer-to-peer interactions, clients, and search engines. In particular high quality support of microformats will improve the way your content appears on your own site and when linked via webmentions at sites you reply, respond, react, or even just link to.

For the best indieweb support, use one of the WordPress themes that supports microformats2, as that will make it easier for plugins, clients, etc. to interact with your site:

Another option is to use or add a microformats-compatible child theme to an existing theme.

Theme Sources

In general, the best and safest place to download themes is directly from the official Wordpress Theme Directory. Themes can also be found on Github and other repositories, but one should take appropriate care to check that they don't include malicious code.

Keep in mind that WordPress maintains two different theme repositories: one on their .com domain which is meant for their own hosted service and a second one on their .org domain. Often popular themes from the .org platform will often be forked and offered on the .com domain, but then aren't always maintained in parallel. Thus there are examples (like Independent Publisher - see below) which have Indieweb related updates which are usable on self-hosted locations, but aren't available to .com customers.

Child Themes

When working with WordPress themes, it's common practice (for security and update reasons) to create a child theme of the original. This allows the user to make any necessary modifications to the functions.php and CSS Style files in the child theme. Doing this will allow the main theme to be updated in the future with bug patches and security updates without overriding the changes made in the child theme.

If you do the additional work to make sure that another specific theme properly supports microformats, either with a child theme or by modifying the parent theme, submit your changes/patches upstream to the theme so others benefit as well. This can be a great way to improve that specific theme and indieweb support in the broader community.

For details on how to create a child theme, see some of the following resources:

IndieWeb Examples


Once you have a site running WordPress, you'll want to add microformats 2 (sometimes referred to as mf2) support to your theme if possible. Some themes support microformats or other semantic markup like schema.org. Microformats 2 is not (yet) supported by WordPress or the majority of WordPress themes out of the box, though we hope this situation will change over time. Many services will also fall back to the original microformats standard, which many WordPress themes support.

There are three ways to add microformats2 support (listed in increasing levels of ease-of-use):

  • Modify your theme by hand to add support directly
  • Use the uf2 plugin to add support programatically
  • Use one of the themes mentioned below that support mf2 out of the box

Further reading: Converting WordPress Themes for Microformats 2 by David Shanske

Themes Supporting Microformats

  • The SemPress theme by  Matthias Pfefferle is currently the only theme to support microformats, microformats2 and schema.org. The official version of the theme can be found in the WordPress.org repository. There are also several child themes available on Github listed in the project's instructions as well.
  • IndieWeb Twenty Sixteen from David Shanske is a fork of the Wordpress Twenty Sixteen theme. It's pretty aggressive in terms of taking out support for the core Post Formats in preference to the Post Kinds Plugin, but has solid support for a number of IndieWeb specific plugins. It's highly recommended you use the Post Kinds Plugin in conjunction with this theme.
    • For theme developers, in addition to the examples here, it may be beneficial to look at the commit history in this Twenty Sixteen fork to see how some of the pieces were changed from the original and how the proper microformats were added.
  • Independent Publisher as of v1.7 now supports microformats2 (though could possibly be further improved?) and additionally does some custom display in comments.php to better differentiate between comments, webmentions, pingbacks, and trackbacks. (Nota bene: the WordPress.com version of this theme is a separate fork and doesn't have the mf2/webmentions support.) The theme is actively being developed on GitHub for additional detail, contributions, and support.
  • IndieWeb Publisher is a forked version of Independent Publisher (above) that continues to add additional IndieWeb friendly elements to the original theme.
  • ZenPress by  Matthias Pfefferle is a clean WordPress theme inspired by Medium.com. It is SEO optimized, accessibility ready and highly semantic. The theme is made with HTML5 (POSH) and flavoured with Microformats(2) and Microdata/Schema.org. It is based on the SemPress theme code.
  • MF2_s is a starter theme from David Shanske which supports microformats. It is a fork of the popular Underscores starter theme which many developers use as a base for building custom themes. It is under active development with the hopes it will form the basis of future themes. Because it is a "starter theme" which is meant as something to build upon, it generally wouldn't be used out of the box in an as-is theme since it has very little structure and most would consider it not very user friendly.

Solutions for Themes not Natively Supporting Microformats

Rather than a theme supporting it natively, uf2 is a plugin that attempts to add microformats2 data to an existing theme. The author admits it is very limited and recommends using a theme that supports microformats natively. In practice it works well enough with most out-of-the box themes as to be very useful for lots of basic functionality. Be aware that some themes unfortunately use microformat classes for CSS styling rather than just semantics, and this can cause issues (typically only with the way the pages display) when using the uf2 plugin.

Examples of themes that don't work well with the uf2 plugin:

  • Twenty Fourteen - styles the hentry class and causes display issues when uf2 is activated.

One can also create a new theme from scratch to support microformats.

See also details at WordPress hentry problem

Other Interesting Themes


Main article: WordPress/Security

The safest place to download free themes is the official Wordpress Theme Directory. A 2011 study found that almost every other source in the top 10 Google results contained malicious code (a 2014 update says the situation has improved but still recommends caution).

Child themes (see above) allow for better future security updates without overriding additional modifications.

Topics Getting Started on WordPressAdvanced WordPress Set UpPluginsThemesExamplesWordPress with BridgyDevelopmentDataSecurity
Primary Plugins Indieweb PluginWebmentionSemantic LinkbacksMicropubIndieAuthPost KindsSyndication LinksWebSub plugins
POSSE Plugins Social Network Auto PosterJetPack PublicizeBridgy Publish pluginWP CrosspostTumblr CrosspostrMediumDiasposter
PESOS Plugins Keyring Social ImportersDsgnWrks Twitter ImporterDsgnWrks Instagram Importer
Other Plugins ActivityPub PluginAperture Refback pluginIndieWeb Press ThisWordPress uf2OpenIDSimple LocationIndieweb ActionsPressForwardYarns Indie ReaderWhisperFollowblogroll2emailWebmention for (Threaded) Comments (deprecated)
Themes SemPress • (SemPress Child Themes: SemPress Lite, SenPress, and Index) • ZenPressIndependent PublisherIndieWeb Publishermf2_sTwenty Sixteen IndieWeb-friendly fork
Assistance Join the #indieweb chatIRC and other chat optionsWordPress FAQWordPress Outreach ClubTroubleshooting TipsWordPress toolsWordPress channel
See Also WordPress related wiki pagesWordPress.comAWS Tutorial