The Vinyl Subdomain

Let me just start by saying we live in a really cool time in history. šŸ™‚ I published a blog post on Saturday evening about how I noticed that had an API and how COOL it would be to have a site that pulled in all the data. I keep an online record of my vinyl collection there so it seemed like a half-decent idea to see if my data could be pulled into a site that I control. Well, I’m proud to say that not even 48 hours later and it exists (head over to if you would like to see it) thanks MOSTLY to Tom Woodward who shall be given any vinyl he’s ever wanted.

For the majority of the technical specs, I recommend that you read Tom’s blog where he brilliantly details how he parsed the API into a Google Spreadsheet and then turned it into a WordPress Custom Post Type. He’s shared both the script and the plugin.

What this means for poor little me who knows nothing about anything APIs is that I do what Tom tells me to do and then magically this happens in my WordPress instance:

Screen Shot 2016-03-28 at 3.07.41 PM.png

It also looks like Tom has added all the details that are attached to the record as Custom Fields within the Custom Post Type:

Screen Shot 2016-03-28 at 3.08.20 PM

So there you have it. I’ve officially reclaimed my vinyl data. Raise your glasses to Tom, everyone. Let’s have a party.


I had to do a couple of different quick edits to my template to get the posts to show up on the home page. By default, WordPress doesn’t have custom post types in “the loop” so I added them in by adding this bit of code to functions.php:

 add_filter( 'pre_get_posts', 'my_get_posts' );
function my_get_posts( $query ) {
if ( is_home() && false == $query->query_vars['suppress_filters'] )
$query->set( 'post_type', array(
    return $query;

I also wanted to pull the Custom Fields into the post itself so that information was publicly exposed. Right under the_content();?Ā  portion of my single.php file I dropped in this:

<?php the_meta(); ?>

Simple enough.

Next, I wanted to build out a way to explore the collection based on the custom fields so you could not only look by purchase date but also by artist, release year, or record label. I came across a WordPress plugin called Filter Custom Fields & Taxonomies Light. I have to say I was quite impressed with how simple the UI was. I was able to quickly whip up a query page:


After adding some CSS style customizations to it, I went ahead and made a secondĀ version of the tool that could function as a widget on a single post so folks could surf around the site a bit quicker.

Screen Shot 2016-03-28 at 3.22.21 PM

Last, I went in and manually grabbed images of the records to put in place to get a nice store front look to the site:

Screen Shot 2016-03-28 at 3.34.01 PM

On another note, my colleague John Stewart and I were having some conversations this morning about what otherĀ APIs could be beneficial to the project. One idea was to see how we could link the collection to information from other sources. For instance, what if weĀ pulled in the Spotify playlist for each record and embedded it directly within the post? Or what if we could pull the album images from the Amazon API? It’s a fun world once you started realizing how you can start to hook up the plumbing that’s been put out there for us on the web.

I can’t thank Tom enough for the help or Kin for the inspiration. Speaking of that API Evangelist, he gave a rather inspiring answer to his own question of how to move the needle on APIs. He notes that it won’t beĀ e-commerce,Ā the big companies of today, legacies of yesteryear, governments, or even (sadly) the evangelists. According to Kin:

It will be the API literate individual, who understands that they can get access to their own data, and information from any website, system, application, connected device, company, and institution, using APIs. It will be people who understand that they can make their education, career, and the web into what they want, using APIs. That the web is programmable. A digitally aware individual who assumes full control over their online self, taken it back from the tech giants, understanding that they own all the exhaust from their online (and increasingly offline) personal, and professional life.

And I think that sums up a lot of my currently feelings (in a much more articulate manner). And this is an area where I see a lot of opportunity for education. The value of our institutionsĀ is our ability to shape a literate and aware citizenry. But, first, music. šŸ™‚