I’ve recommended the WPAudio plugin for placing easily playable and downloadable audio files on your WordPress site. But with the release of WordPress 3.2 in 2011, the plugin stopped working on many sites (including mine).
In this post, I’ll show you how to get this plugin working again.
Fair warning: This fix involves directly editing the plugin’s source code. I’ve provided all the necessary code so you can just copy and paste. This has worked on all the sites I’ve tried it on, but it’s possible that it won’t work for you — you might have a different hosting setup or a plugin conflict that I haven’t run across.
But even if this fix doesn’t take, really, the worst that can happen is that your copy of the WPAudio plugin still won’t work. What I mean is, a copy-paste mistake isn’t going to break your entire site or erase your database or anything disastrous like that.
Why you might not want to fix this plugin at all
I chose to research the fix because I like to know how things work, I’ve got a hardcore DIY streak, and I’m stubborn — I like the way WPAudio looks and works and I just don’t want to switch, doggone it.
However, I fully realize that I might be in a tiny minority here and that you might decide that it’s just easier and simpler to switch to a different audio player on your WordPress site. And that is totally OK (I’m actually researching some WPAudio alternatives and will post about those later this week).
One big reason to switch to a different plugin is that WPAudio’s author is no longer supporting it or releasing new versions. WordPress will continue to change and improve, and it’s very possible that future versions of WordPress will break this plugin again. So this code fix is a bit like wrapping a frayed wire with electrical tape — a temporary measure that’s fine for now but not built to last.
Still here? On with the tinkering!
Step 1: Download these two text files. You’ll need to copy and paste their contents later in these instructions. Right-click (on a PC) or CTRL-click (on a Mac) the filename, and choose “Save Link As” or the closest equivalent.
Step 2. Open the files in a text editor (Notepad, TextEdit, or the like). Because they have the .txt suffix, they may automatically open with the right application if you simply double-click them.
Step 3. In your WordPress dashboard, go to Plugins –> Editor.
Step 4. Choose “WPaudio” in the drop-down list at the top right corner of your Plugin Editor screen. When you first arrive at this screen, it will show the first plugin in alphabetical order (often Akismet). After you select WPaudio, click the “Select” button next to the drop-down menu and you will then see a list of that plugin’s source files.
Step 5. In this list, click the link labeled “wpaudio-mp3-player/wpaudio.js” to display the contents of that file in the editing pane. It should begin with these lines:
/* * WPaudio v3.1 (http://wpaudio.com) * by Todd Iceton (todd@wpaudio.com) * * Converts an mp3 link to a simple player styled by HTML & CSS, powered by HTML5 with SoundManager2 Flash fallback
Step 6. Copy the entire contents of the first text file you downloaded — the one called wpaudio.js.txt — and replace the entire contents of the wpaudio.js file onscreen with your copied text. You want to completely overwrite the file contents, so in the WordPress Editor screen you can either Select All and Paste, or Select All and Delete before Pasting.
Step 7. Click the blue “Update File” button at the bottom of your screen. You should see a success message appear at the top of your screen that reads “File updated successfully.”
Step 8. Repeat steps 5, 6, and 7 with the file named wpaudio.min.js. You’ve just replaced the entire contents of two of the plugin’s source files, and saved your changes. Your site is still there, right? No smoke coming out of your hard drive? Good! On to the final step:
Step 9. Go to Settings –> WPaudio, and click the blue “Save Changes” button at the bottom of the screen. It’s a good idea to check the settings to make sure they’re correct, but go ahead and click the blue button even if you don’t make any changes. This is similar to refreshing a web page to get the latest version — you want your copy of the plugin to read the new code you added.
Now go test one of your audio files on your site. Fingers crossed that it plays the way it is supposed to! And if not, stay tuned for my upcoming post on audio player alternatives (you can subscribe to get updates in your inbox or grab the RSS feed to get it in your reader). And feel free to leave a comment if you have a favorite WordPress audio plugin, too!
It’s important to note that I didn’t do this coding work on my own. All the code fixes came from helpful users on the WordPress.org support forum; I’m merely trying to let more people know about these fixes, and maybe make them a bit less scary to implement. Here are the original posts describing the code changes:
- WordPress.org support forum post with code fixes from forum user rahul286
- WordPress.org support forum post with code fixes from forum user waffl
- WordPress.org support forum post with code fixes from forum user Ursula (aka WP Gal)
Frayed cord image by blmurch on Flickr, used under a Creative Commons ShareAlike License
I’ve had three clients in as many weeks who came to me with problems with the navigation menus on their websites.
AWeber introduces Subscribe by Commenting to the Web Form plugin
Specifically, this feature adds a simple checkbox to your blog comment form. If a commenter checks the box, the commenter is treated the same as someone who fills out your AWeber subscription form: They will receive a confirmation email message asking them to click a link to complete their subscription.
Want to see it in action? It’s on this very post! If you’re reading this in a feed reader or in your email, swing by the original blog post to see my shiny new checkbox.
It’s super-simple to activate on your own blog, and I’ll show you how in a minute.
First, let me be perfectly clear that the AWeber WordPress plugin does not automatically subscribe commenters to anything; they have to check the checkbox and complete AWeber’s double-opt-in confirmation process. You cannot set the checkbox to be checked by default (that would be a pretty clear violation of AWeber’s stated privacy policy, after all).
Commenters can subscribe with one click
I activated the new feature as soon as I heard about it, because I figure if someone is interested enough in my blog to leave a comment, and they’re not already subscribed to my Weekly Web Tips, I might as well give them a really easy way to subscribe without filling out another form or clicking through to another page.
Here’s how to activate this feature on your blog:
First, navigate to Settings –> AWeber Web Form in your WordPress dashboard. Assuming you’ve been able to connect your AWeber account to your installed plugin as described in my instructions for configuring the AWeber WordPress plugin, here’s what your plugin settings now look like:
The two checkboxes here are checked by default. The “Allow subscriptions when visitors comment” is the important one here. Leave it checked to give commenters the option to subscribe.
A note about blog registrations
The second checkbox, “Allow subscriptions when visitors register to your blog,” is irrelevant for most of us, because you shouldn’t even be allowing registrations to your blog unless you have a good reason, such as a membership site. To check this setting on your site, visit Settings –> General in your WordPress dashboard, and verify that there is no check in the box labeled “Anyone can register.”
On the other hand, if you do have a membership site and you want to add your members to an email list at the same time they sign up, this is a super-simple way to do it. In this case, you’d want to UNcheck the first box, so that only new registrations to your blog, and not blog commenters, are added to the membership email list.
Remember that you can’t autosubscribe people, though, so you will almost certainly have members who register but don’t bother to check the box and thus don’t receive your emails. So you’ll want to have a backup method to ask those members to subscribe.
Anyway, here’s a shot of my saved settings for the AWeber WordPress plugin after I chose my list and edited my promotion text (the very same text you’ll see next to the checkbos on the comment form of this post…infinite meta loop alert!):
Limitations of the AWeber WordPress plugin “Subscribe by Commenting” feature
The plugin only allows you to connect one AWeber list with your comment form, so if you have more than one list, make sure you choose the one most relevant to your blog commenters sitewide to add to your comment form. You can switch lists and re-save after you’ve selected one in the drop-down menu, but remember that the new list will now apply to all your comment forms. There’s no way to let commenters on different posts subscribe to different lists.
There’s also no way to let commenters subscribe to one list and blog registrations to another — both checkboxes are connected to the same list. So if you are contemplating the membership-site option, you won’t be able to also use this plugin to add newsletter subscribers from your comment form.
Even with these small limitations, the new “Subscribe by Commenting” feature is a welcome addition to the AWeber WordPress plugin.
Comment card image adapted from Boonerator on Flickr, used under a Creative Commons ShareAlike License