I’m working on a WordPress plugin to import scrobbles from Last fm and display on your website.

It’ll work like the traktivity plugin that imports and displays trakt watches for TV shows and films.

It’s an itch I want to scratch but hopefully could be helpful to others out there.

Migrating my website to Statamic

I love Laravel.

I also really like WordPress, for what it is. So when it came to originally putting my personal site together I just wanted to get a simple WordPress site together.

I have attempted to build my own website and blog in Laravel from scratch multiple times over the years. I even stuck with a build for a while but ultimately went back to WordPress.

My issue was only down to the fact that I wanted to write more in my own time and found I spent most my time tinkering.

But I really love Laravel.

So imagine my joy when I came across Statamic. Statamic is a CMS package that can be installed into a Laravel site and just works seamlessly alongside you Laravel code.

I am in the process of rebuilding my personal site and will be getting it live as soon as I can.

I think I will migrate my current site to a new domain, something like “davidpeach.me”, and then use the 4042302 technique to ensure my old posts are still found as I migrate the posts over.

I’m really looking forward to getting creative with Statamic and then layering on all of the excellent Laravel features as a way to learn as much, and refresh my mind, about my favourite framework.

I finally did it

Update: I’m now using WordPress again.

Ever since I can remember having my own website, for the most part, I have used WordPress. I’ve loved using it and will always recommend it to clients as being the best way for them to publish online. Of course, with me being a web developer I’m always wanting to tinker. There isn’t a day that goes by without me messing about with something on my site.A concept that I learned about, about six months ago or so, was that of the indieweb. Now this isn’t some new platform or anything like that. Rather it’s a set of principles, a way to approach publish on the web. In fact it’s the oldest method of publishing on the web: publishing on your own website.WordPress is great for publishing. But as my needs became more complex, and needing to make more fine grained choices when publishling different sorts of posts, I found my self neglecting to post notes/thoughts because the process of ticking the correct meta values and category was a bit combersome. The process adding a quick note or thought, like that of jotting something in a notepad, should be quick and effortless.So what I wanted was a stripped back UI from which to post notes, as well as other kinds of posts. Because of this I decided to go with a framework as opposed to a CMS platform, choosing ultimately to go with Laravel.The process is still on going as I still need to configure 301 redirects from my old site. But at least I am now publishing from my new site, and new domain, and it’s never been easier to do.

Thoughts again about an indieweb CMS

Some time ago I wrote an article on planning to build my own CMS. I started to work on it using CodeIgniter as its framework. When I started to get overwhelmed by all of the moving parts I was trying to think about all at once I immediately went over to my current site – which is powered by WordPress – and thought “this’ll do me perfectly”.And to be honest it does.The thing is there’s still this nagging feeling in the back of my mind that says to me: “build your own CMS; it will be lightweight; you’ll know it inside-out; you’ll learn all about the IndieWeb’s moving parts”. But then the critic in me says: “Don’t be stupid – that’s why there is a community of talented people who have solved a lot of these things – so you don’t have to, Dave.”But that thought process of mine is negative and against the true spirit of the IndieWeb – building your own tools for yourself; Building something that is 100% to your own specification and something you will use everyday.Now don’t get me wrong I’m hugely grateful to the WordPress plugins that I rely on every day that have made my getting on to the IndieWeb so easy. But I feel it is time to step up my game which is why I am going to set myself a deadline – in the spirit of Tantek’s IndieWeb commitment for 2015-01-01 – of having my site in place with a home-built CMS by 2015-07-01.And apologies in advance to all the great people at IndieWebCamp, for no doubt I will have countless questions for them in the coming months as I hack away at my new CMS. Thank you.

My IndieWeb Setup

Please note: This is now out of date somewhat

This post is an outline of my IndieWeb setup. I describe some of the key plugins I have installed as well as third party services I use. All of which play nicely together for the IndieWeb.Built with WordPressMy personal site is built using WordPress and is a completely custom-built theme. WordPress?—?with its plethora of plugins and diverse, active community?—?provides one of the best platforms from which to build an IndieWeb site today – outside of rolling your own. When I first heard about the IndieWeb and found myself wanting to implement its principles on my own site, I went ahead and installed a plugin I was recommended?—?the IndieWeb Plugin?—?which links to a collection of other plugins that implement certain functionality to tie into those IndieWeb principles.Plugins I have installedYou don’t have to limit yourself to only the plugins I list here?—?I have just listed the ones that I myself have in use in regards to IndieWeb.IndieWeb PluginThis plugin, once installed, provides links to the recommended IndieWeb plugins?—?some of which I have listed below?—?that will help bring you into the IndieWeb. I have also provided direct links to the plugins themselves, or you can search in your admin area’s new plugin interface. I haven’t described them all yet as I am not 100% on what some of them do. As I gain an understanding of others I use, I will include them below. The ones that I have described below are the ones I actively use and understand what they do for me. Download the IndieWeb PluginNextScripts : Social Networks Auto-PosterThis is a great plugin for easily syndicating content out to many third-party silos. I use a custom fork of it with editsThe plugin creators have very kindly added in my code edits to allow twitter replies that create those tweets as replies within the Twitter timeline. Social Networks Auto-Poster?—?or SNAP for short?—?has a flexible way in which to template how and what to share to each silo when posting your content. For example in a small note you may send the full text content only, however for an article you have written you may want to send the post title and permalink. Download the SNAP PluginRel-Syndication for WordPressThis plugin works beautifully with the Social Networks Auto-Poster plugin. It will grab the SNAP plugin’s syndication data for a post, and append a list of links to that post’s content. It will also include the necessary microformats2 meta data in the links of those syndicated copies. Download Rel-Syndication for WordPressWordPress Webmention PluginThis sets up webmention support on the site. It allows me to receive webmentions and automagically creates them as comments to those posts. It will also parse the post content for posts I write for any links contained within, and send webmentions to those links. Download WordPress Webmention pluginIndieWeb Custom TaxonomyThis plugin adds an extra semantic layer to posts. It allows you to categorize your posts as being one of the following: “Bookmark”, “Favorite”, “Like”, “Reply”, “Repost” and “RSVP”. All of which are actions that are found on social networks. It also allows you to save a URL to which you may be replying to. The plugin will then pull in that URL to give a preview of the link with the post content. This shows the context to which your post content may be replying to. Download the IndieWeb Custom Taxonomy PluginWordPress Semantic LinkbacksWhen you receive webmentions* from a site?—?or from Bridgy if you use that (see below)?—?then those comments are added to the site. What the semantic linkbacks plugin does is generate semantic comments using microformats2. *Please Note: you will need to have the WordPress Webmention plugin installed for this plugin to recognize Webmentions. See above. Download the Semantic Linkbacks pluginOther Tools I useBridgyBridgy is absolutely bloody fantastic. It is a web app built by Ryan Barrett and automatically polls a number of third-party silos?—?whichever ones you choose to connect?—?and pulls in any links to your website and any new responses to posts you have sent. Once it pulls in links and responses, it will send them over to your website as webmentions. The WordPress Webmention Plugin?—?mentioned above?—?knows exactly what to do with them. There are a couple of configurations that you may need to do also?—?at least these are what I needed to do. Firstly when bridgy finds replies to a tweet that originated from your site it will need to know where that original link is on your website. For example if you just sent twitter a note with no links back, bridgy will need to look on your site for that original message. But how does it know where the post is? It looks for the post that has, within it’s h-entry markup, the syndication link to that twitter copy. If you are using the Rel-Syndication Plugin for WordPress, then your content should already have the syndication links appended to them. One thing I had to also do was to add a “feed” meta link into my site’s header, in order to tell bridgy where those links could be found on my site (as they were not on my homepage at the time). And that’s my IndieWeb setup. Like I said before, there are some other plugins that were recommended from the IndieWeb plugin. However I have not included these here as I am not yet confident in describing those just yet. Any questions about this setup or any other IndieWeb queries please ask. I’ll do my best to help.

WordPress as my IndieWeb Foundation

From the very beginning of its creation, WordPress has been all about empowering people to publish online.

It now has a huge user base and a community that is always working to update, improve and extend it.

That’s not to say that you need WordPress to become Indie, in fact many people use a whole range of CMSs — some even custom-built, but WordPress is a great solid foundation to start from.

When deciding to move towards the IndieWeb, I was already using WordPress and began in the simplest way I could think of — publishing status updates on my site and then simply pasting them into a Tweet or Facebook update.

Although the idea was there, I was missing the link between the original and syndicated copies. I had the desire. All I needed now was guidance.

Indie Web Camp

The Indie web camp site has been — and continues to be — an invaluable resource for me and many others. All the people I have spoken to in the IRC channel have been super friendly and guided me through certain areas that I found tricky.

If you need any help whatsoever, just ask in the IRC channel, or ask me and I’ll do my best to help. The first thing I did when I discovered the IndieWebCamp site, was follow the getting started guide.

I couldn’t do a better job of guiding someone through the process of getting their website indiewebified, so I will simply link to it. Because of the fact that the IndieWebCamp site is the best resource out there, my own posts on the subject will be specific to my own implementations and any gotchas that I found.

As you level up, you can track your progress on the IndieMark page.

An IndieMark is a set of metrics that show how ‘IndieWeb’ your site is. At the time of writing this post, I am half-way into level 2. One thing to always keep in mind is that it is okay — and encouraged — to implement each thing one step at a time. Just have fun with it!

WordPress Indie Web Plugin 2.0

The WordPress indie web plugin calls itself the IndieWeb version of WordPress’ Jetpack plugin and it really is. Once installed, it provides you with direct links to download and install recommended plugins for getting your website on the IndieWeb path.

I installed all of them at once without reading what each one did and so got myself into a bit of a muddle. However as I work through each one I shall be writing it up under the tag IndieWeb and share what I learn from them.

Sharing to Social Networks with SNAP plugin

SNAP is a WordPress plugin that enables the automatic posting to your chosen social networks when you create new content. I have forked SNAP in order to add extra features that I find I need.

For example, I have added the ability to post to twitter as a reply to another tweet and have it link the newly created tweet as a direct reply to the targeted tweet.

I have also made it easier for myself to write quick status updates and post them out to silos as duplications of the content.

And that concludes my first steps in transitioning to the IndieWeb. As I accomplish more, I will write it up and post it under the tag IndieWeb.

WordPress “Must Use” Plugins Directory

The Issue

I wanted to build a site with some custom post types, taxonomies and the like. But what if somebody who has used my theme decided to try another theme later on? What guarantee do they have that those custom post types will be recognized by a future theme?

None — that’s what.

WordPress obviously has its plugin directory, which is designed for adding in pieces of functionality that should span across themes. But what if these are essential to the working of the site due to custom post types, taxonomies or shortcodes?

Either it can be a plugin — which could be accidentally deactivated, or added to the theme’s functions.php — which would need copying over to any future theme.

A Hidden Gem of a Solution

Well it turns out that there is a third option — a way for WordPress to auto load essential plugins irregardless of the theme being used. Simply by creating a directory in the ‘wp-content’ folder called ‘mu-plugins’ — which stands for “must use plugins” — and adding plugins as you would into the regular plugins folder, they will be auto loaded with any theme and just work.

These ‘must use’ plugins will then be viewable in the plugin admin page, in a new option called ‘must use’ — grouped with the other plugin page navigation items, ‘All’, ‘Active’ and ‘Inactive’.

‘Must use’ plugins can’t be deactivated in the admin — creating a nice separation of essential plugins for a particular user.

Thanks to Justin Tadlock for this piece of info.

WYSIWYGs will kill us all

So okay, maybe they wont literally kill us all, but you’ve got to admit — they can be pretty damn annoying. At least with ones I have used.

I’m not dissing wysiwygs — just what they get used for.

Firstly let me just say that I use a wysiwyg editor on my own blog and it does exactly what I need it to. I type text and it saves that text. I click to add a link and it adds a link. Brill!

For a blog, where writing long posts with the odd link and / or bolding of text, a wysiwyg really is great. But what I don’t believe in is using a wysiwyg for anything more than that.

Let me explain.

With a standard WordPress install, when you write a post or page, the content from the wysiwyg is spat out by the function the_content(). This displays all that content in one block within the page. Of course WordPress is — at its roots, a blogging platform (and a damn good one) so the ease of writing and publishing has always been at the forefront.

But what if our content is more than just a blog post? What if it’s an album or film review? Or specifications for a car? If we bundle all of the content into one block then we are a stepping away from what we need most nowadays, which is structured content.

The need for Structured Data

The need for structured data these days is more important then ever. With the whole multi device landscape, a site’s content needs to be able to display beautifully whereever it is viewed. We need to be able to control as much of the content in as much of a modular way as possible. Also, as a result of making content more modular, it means it can be a lot easier to group and sort that content.

For example, if we have a database of 500 albums with all of the content for each album in its own single block of content, it makes it extremely difficult to categorize those into various artists or genres. Whereas if it was set it up in a way that has separate fields for each content chunk — an artist field; a genre field; etc — then those albums could be easily sorted and categorized.

Karen McGrane gave a fantastic talk at An Event Apart, Boston in 2012, where she talked about the TV Guide who made a wise decision about their content structure back in the 1980s. She talked about how the TV Guide wrote out three different descriptions of the same programmes — One small, one medium and one long. This was before TV on demand or Tivo, where now that sort of structured content is invaluable for use across different devices and contexts.

I recommend you watch the video, but I wanted to include a great quote from that talk here:

…a clean base of presentation–independent, well–structured content that you have designed, from the start, with the intent that you may want it to go out and live on a wide variety of different platforms. In fact you know from the beginning this content is going to have to live in a variety of different places…

Karen McGrane An Event Apart, Boston, 2012

Example – content for a music album

All the content for an album in one chunk:

<-- Output Html of the_content() in a wordpress site --> 
<p>This Train features 12 songs from the angelic, sometimes haunting, voice of Chrysta Bell. It was produced by David Lynch and features songs written by them both, including the track 'Polish Poem' from the film 'Inland Empire'.</p> 
<p>Artist: Chrysta Bell</p> 
<p>Produced by : David Lynch</p> 
<p>Release Date: September 29, 2011</p> 
<p>Tracklisting:</p>
<ol>
<li>This Train</li>
<li>Right Down To You</li>
<li>I Die</li>
<li>Swing With Me</li>
<li>Angel Star</li>
<li>Friday Night Fly</li>
<li>Down By Babylon</li>
<li>Real Love</li>
<li>Bird of Flames</li>
<li>Polish Poem</li>
<li>The Truth Is</li>
<li>All the Things</li>
</ol>

So while the above html code is okay, it doesn’t allow for much flexibility.

What happens if — in a few years — the website gets a complete redesign? Imagine there are 500 albums in the site’s database. Well then we’ve got a problem. We can have a lovely new shiny design but the bulk of the content is already set in stone somewhat.

In the example above we have the track listing below the review. What if we wanted to flip that? Or better yet, what if the new design wanted the track listing removed? What do we do then? Use regular expressions on the html to remove the track listing from the content?

No.

Also, as mentioned in Karen McGrane’s talk, the content should be able to live in a variety of different places. What happens if the content is viewed through a smart watch, or internet fridge? Will we want all of that content handed to us in one chunk?

Probably not.

Maybe we want to display just the Album title and artist with the option of loading in the track listing if needed.

In the music album example above, we can see sensible chunks of content that could be easily separated into sensible content chunks:

  • Track Listing
  • Review / Description (perhaps differing versions for use in different contexts?)
  • Producer
  • Artist
  • Title
  • Release Date

Using separate input fields for each of these chunks, means that each part of the content is individually available and much more flexible in how and where this content can be displayed.

WordPress has custom fields that can be entered on a per page/post basis, as well as the ability to add custom post types. No doubt other CMSs have similar options available — I’m just not very clued up on those ones.

The use of these custom fields is definitely a step in the right direction, but what we need is for CMSs to be more content-modular at their core. Like I said before, I’m not clued up on CMSs — other than WordPress and OpenCart — so please don’t hunt me down and shoot me in the face if there are indeed CMSs out there already like this.

And if there are please let me know of some good ones.

Tar!

Inspiring this post

This post was originally going to be me snivel–bitching about wysiwygs. But I heard this podcast on the web ahead, which talks about content structure in great depth and it got me thinking about it in more detail than my initial post. The podcast also mentioned that talk by Karen McGrane.

On the evening of me writing this post, before publishing the following day, I travelled down to Milton Keynes Geek Night and saw five fantastic talks.

One of those talks was by Relly Annett-Baker called ‘Future Perfect Tense: creating good content for an imperfect web’. A lot of what Relly was talking about was stuff I had been thinking about that day — so that was nice.

I will link the recording of the talk when it goes online as it is well worth a listen.

Hello Seagal WordPress Plugin

Every WordPress user knows that a fresh install of WordPress comes with a plugin called ‘Hello Dolly’.

Hello Dolly places a random lyric from the song of the same name at the top right of the admin area, changing with each new admin page load.

I like the idea but am not really a fan of the song. So I thought it would be cool to do my own variation. I have called it ‘Hello Seagal’.

Hello Seagal does exactly what Hello Dolly does — in fact it uses the original code from Hello Dolly — but altered for my needs. Hello Seagal will place a random line from various Steven Seagal Films in the top right of your admin area, changing with each page load.

With such classic lines as:

  • “I’m gonna take you to the bank, Senator Trent” from Hard to Kill
  • “Anybody know why Richie did Bobby Lupo?” from Above the Law AKA Out for Justice
  • “I’m just a cook” from Under Siege

Download Hello Seagal Zip or View the source code on Github.