SermonAudio.com is a powerful media browser with tons of great content. It allows ministries to easily put their sermons online for the world to listen. SermonAudio handles everything from audio to video streaming across a huge range of platforms.
Adding sermons to WordPress is a fairly simple task given WordPress’ oEmbed API. Churches, bloggers, and ministries could easily take advantage of it and should. Sermons can be embedded as citations, as recommendations, or even just to keep the content in circulation.
For the sake of this how-to I’ll be showing you the easiest way to embed SermonAudio sermons. I won’t go into the advanced process of creating widgets and shortcodes. I’ll only show you how to make sermonaudio.com links embed audio sermons automatically.
WordPress’ oEmbed API
WordPress has had the oEmbed API since version 2.9. It has consistently been updated, and has added support for new default providers over time. Unfortunately SermonAudio is not on their list of default providers, but there’s hope! The API itself is extendable so you are free to add your own providers if they’re not natively supported.
Using The API
oEmbed is a simple way to allow URLs to display embeddable content automatically. If you were to paste a link to a YouTube video in your post, WordPress would automatically get everything needed to display the video on your site.
YouTube is only one example of a default provider, for a full list you can visit the WordPress codex.
Extend The API to Embed SermonAudio Sermons
Now lets try to achieve the same effect for SermonAudio content. In order for us to embed SermonAudio sermons we’re going to need to register SermonAudio as a provider, and then provide WordPress with link to SermonAudio’s sermon page.
We can register the provider by hooking into the init action in WordPress and adding the provider below.
add_action( 'init', function(){
wp_embed_register_handler();
});
Now that we have the provider registered we need to provide it with a url. This should be the url that we would like to be embeddable. On a side note, we will be working with some regex to parse the url. As an example we’ll use this sermon’s url.
You may have already noticed the query variable “SID” in the URL. The value it holds is the ID of the sermon, and is what we need to parse so that we can render our sermon.
$regex_url = '#http://(www\.)?sermonaudio\.com/sermoninfo.asp\?SID=([\d]+)#';
The first match in the regex is (www\.) which means that the www is optional. The second match in the regex is ([\d]+), this match requires that the value for SID is only an integer. Note, this will not work with a string.
Now let’s register SermonAudio as a valid provider, supply it with our regex string, and lastly give it a callback function to execute when regex finds a match.
add_action( 'init', function(){
$regex_url = '#http://(www\.)?sermonaudio\.com/sermoninfo.asp\?SID=([\d]+)#';
wp_embed_register_handler(
'sermonaudio',
$regex_url,
'wp_register_sermonaudio_embed',
true
);
});
Write The Callback Function
Now we need to add the proper callback wp_register_sermonaudio_embed to create the html needed for the embed.
function wp_register_sermonaudio_embed( $matches, $attr, $url, $rawattr ) {
}
Let’s try to understand what we’re working with. Our callback by default has 4 variables passed into it. The first variable is an array of regex matches, and for the sake of this tutorial we’ll only deal with that variable. Now let’s use the matches.
$embed = sprintf( '<iframe style="min-width:250px;" width="100%%" height="150" frameborder="0" src="http://www.sermonaudio.com/saplayer/player_embed.asp?SID=%1$s"></iframe>', esc_attr( $matches[2] ) );
We use a sprintf function to pass the data into our iframe. The iframe makes a call to SermonAudio’s web player with the provided sermon ID which is stored in the second key of the $matches array.
Lastly we’ll return the $embed variable as a filter.
function wp_register_sermonaudio_embed( $matches, $attr, $url, $rawattr )
{
$embed = sprintf(
'<iframe style="min-width:250px;" width="100%%" height="150" frameborder="0" src="http://www.sermonaudio.com/saplayer/player_embed.asp?SID=%1$s"></iframe>',
esc_attr( $matches[2] )
);
return apply_filters( 'wp_embed_sermonaudio', $embed, $matches, $attr, $url, $rawattr );
}
And that’s it! Now you can easily embed SermonAudio sermons by pasting SermonAudio links into your post, which would result in the following.
The Plugin
In case you were looking for a plugin to do this job, I went ahead and packaged all of this plus a little bit more into a plugin which will be on the WordPress Plugin Repo soon. You can grab it now on Github. The plugin allows for multiple urls to be embeddable and currently only supports audio embeds. You can download them below.
Conclusion
SermonAudio is a really great platform that you can utilize for your ministry. In fact, I’ve built a few tools that integrate with their services already. If you’re already using them to power your online ministry I would highly recommend working with their APIs to customize your user’s experience.
In order to create a new filter we have to first understand what WordPress filters are and when to use them.
Pippin Williamson is one of the most widely known WordPress developers out there. He’s produced many premium and free plugins such as Easy Digital Downloads, Affiliate WP, and Restrict Content Pro. Pippinsplugins.com is a great resource for WordPress developers who are looking to learn about advanced WP techniques. Pippin frequently blogs and releases tutorials that will help you sharpen your skills tremendously. Check out his blog and help him out by purchasing a subscription.
Monday By Noon is one of those sites that really amazes you once you start to dig into the old posts that are archived on it. Jonathan not only teaches you about certain aspects of code and things that he’s done, but he also teaches a lot about business and how he runs his business as a web developer. Jonathan is also the creator of a really awesome search indexing plugin called Search WP, I suggest you check it out and purchase it to better power your site’s searchability.
CSS Tricks is one of the longest running sites that I still go to on a regular basis. Its got countless articles on how to sharpen up your skills on everything from CSS to Javascript, and PHP. CSS Tricks is headed up by Chris Coyier who is also a pretty well known name in the industry.
Codrops is a really neat source for learning how to sharpen your frontend development skills. They have tons of articles that deal specifically with CSS and JS development as it’s related to the user’s experience.
WooCommerce is probably the most used e-commerce platform in the world. It’s a powerful plugin that allows you to sell all kinds of goods and services. Woocommerce has one of the best file architectures that I’ve come across, and is actually the basis for a plugin that I’ll be releasing later this year. Things you can learn a lot about include.
EDD does as the name suggests, its handles the selling of digital goods online. EDD is another one of those plugins that you can learn a lot from. Two things that stuck out to me was the way they handle database transactions, and the way they handle generating html fields. I’d strongly recommend diving into the following files to soak it all in.
CMB2 creates custom metabox fields for post types, taxonomies, user meta, options, and more. CMB2 is also a plugin that is very easily and widely extended, and I’ve personally done so for many sites myself. CMB2 uses a really neat singleton class that basically handles all of the data that is passed into it via hooks. It also has many actions and filters that make CMB2 a pleasure to work with. Some files I’d suggest you check out include the following.
Apply Filters is a great resource for WordPress plugin and theme developers. It is hosted by Brad Touesnard and Pippin Williamson, and they frequently have guests who talk about their products, business, and how they developed their products. Apply Filters’ best selling point is Pippin’s and Brad’s experience in web development.
Post Status is another great podcast for developers and WordPress entrepreneurs in general. Hosted by Brian Krogsgard, Post Status is much like Apply Filters in that there is a ton of talk about code, and web development practices. Post Status also has many guests who share their WordPress development experience.
Matt Report is run by Matt Medeiros where he interviews guests who speak about their experience as a WordPress entrepreneur. Many of his guest talk about the problems they’ve faced as business people, the solutions they came up with, and the products or services they’ve built since being in business.