Advertisement
  1. Code
  2. WordPress
Code

50 Filters of WordPress: Filters 41-50

by
Difficulty:BeginnerLength:MediumLanguages:
This post is part of a series called 50 Filters of WordPress.
50 Filters of WordPress: Filters 31-40
50 Filters of WordPress: Series Finale

In the previous parts of this series, we went through 40 WordPress filters. In this tutorial, we're going to see the last 10 filters and do examples with each.

Let's begin!

Filtering the Script Loader Source

WordPress has its own script loader, wp_enqueue_script(), which allows us to "queue" JavaScript files and not hard-code them. And this little filter called script_loader_src lets us how the scripts will be queued and outputted.

Example: Remove the Version Parameter from Scripts

Google Page Speed, Yahoo YSlow and other website performance measurement tools usually hate URL parameters in JavaScript files. And they're right, too: Scripts with parameters at the end of their URLs don't get cached by "proxy servers" (more info on this topic here) and sadly, WordPress enables "version" parameters for scripts (and styles, too) by default. Luckily, we can simply remove those ver parameters with a few lines of code:

Done! Your JavaScript (and CSS) files will not have any version parameters anymore.

If you want to learn more about proper JavaScript usage with WordPress, be sure to check out my article on this topic.

Adding HTML to the "Featured Image" metabox

The admin_post_thumbnail_html filter, as its name suggests, allows you to add HTML content inside the "Featured Image" metabox. The HTML will appear right below the "Set featured image" link.

Example: How to Help Your Client Set Featured Images Correctly

Imagine that you're making a personal blog for your client, but he insisted on maintaining the blog on his own instead of hiring an assistant. He always forgets how to add a featured image (He calls it "top image".) and you need to leave a reminder on the New Post page. Here's how you do it:

With your helpful reminder, your client will never forget to set a "top image" with a minimum width of 900 pixels.

Controlling Comment Flooding Attacks - comment_flood_filter

By default, WordPress prevents "comment flooders" who repeatedly comments on your posts. For example, if a visitor posts a comment to a post in your website, they must wait 15 seconds (default value) before posting another comment. This filter lets you change the time setting to another value – or disable flood checking altogether.

Example: Making Commenters Wait Longer

As I said, WordPress makes visitors wait for 15 seconds before posting another comment. In some scenarios, you might need to increase this time limit to, say, 60 seconds. Here's how you do it:

Change the value "60" above to anything you want.

Bonus Example: Disabling Comment Flood Checking

If you don't care about visitors speed-commenting, you can disable checking for flooding by using the two simple lines below:

Notice the remove_all_filters() function? As its name suggests, it removes all filtering functions from a filter hook.

Changing the Items at the "At a Glance" Section 

The "At a Glance" section (formerly named "Right Now") keeps us up to date about how many posts, pages and comments are there in the database of your website. The dashboard_glance_items filter helps us show additional information there, like the number of posts of a custom post type.

Example: Showing Your "Events" Post Type at the "At a Glance" Section

Let's imagine that you have an "event blog" where you keep your visitors informed by new local events which you post as a custom post type named "Events" (and with the id event). To be able to see the count of events in your blog, you can use the function below and hook it to the dashboard_glance_items filter like so:

Easy, right? Change the value of the $post_types variable (array) to suit your needs.

Changing the Default Login Form Messages

The login_message filter allows us to edit default messages that's outputted right above the login forms of our WordPress installations. (Not "errors", just neutral messages.)

Example: Changing the Default "Lost Password" Messages

If you ever need to simplify the default "lost password" instructions ("Please enter your username or email address. You will receive a link to create a new password via email."), you can change it like so:

There are a number of actions that can be found in the wp-login.php file:

  • logout
  • lostpassword and retreivepassword (alias)
  • resetpass and rp (alias)
  • register
  • login

Just like the one we did in the example, you can write different messages for different action.

Changing Bulk Update Messages

There are messages displayed when you update, trash, untrash, or delete posts. If you want to edit those messages, the bulk_post_updated_messages is your guy.

Example: Editing Custom Messages for a Custom Post Type

Let's say you don't like the way those messages are displayed for bulk actions of your custom post type "event" and you want to change them. Here's how you do it:

Easy, right? Remember to make the strings translatable if you're not the only one to use the plugin or theme.

Filtering the Default Categories Widget

In some cases, you may need to tamper with the core Categories widget. With the widget_categories_args filter, you can do that.

Example: Excluding Categories From the Widget

If you ever need to "hide" some categories in the Categories widget, use this code snippet:

Change the $exclude_arr array items with the IDs of your "unwanted" categories and you're good to go.

Redirecting the User Upon Successful Registration

By default, WordPress just reminds you to check your email after registration and doesn't redirect you anywhere. With the registration_redirect filter, however, you can set a custom safe address to redirect upon successful registrations.

Example: Letting New Users Download Your Awesome E-book

If you offer a free e-book to your visitors if they sign up for your website, you can redirect them to the page with the download link of your e-book by using this simple code snippet:

Remember, the redirection is done with the wp_safe_redirect() function which means that you can't redirect to an external site unless you used the allowed_redirect_hosts filter to specify external and "safe" hosts. We went through that filter in the first batch of these examples, be sure to read that tutorial if you haven't yet.

Altering Fields of the Comment Form

WordPress has the comment_form() function for displaying the comment form, and you can change its field by using the function's arguments. If you're developing a plugin, however, you won't be able to change any parameters of the function. This little filter allows us to change the HTML code of the default form fields – or remove them.

Example: Removing the URL Field in the Comment Form

Let's say you, as a freelance web designer, are making a "default adjustments plugin" for all your clients and for security purposes, you want to remove the URL fields in the comment forms of all your websites. You can add a really simple function (and hook it to a filter) to make it happen:

Paste this lines into your plugin file and you're done!

Altering the List of Acceptable File Types

By default, you can upload a number of file types into WordPress' Media Library – check out the full list of file types here. With the help of the upload_mime filter, you can make changes with the list of allowed file types.

Example: Prevent Uploading GIFs

Ah, GIFs... They were popular in 1999 and they're still popular at 2014. Did you know that one of the first memes was a GIF of a dancing baby? Those were simpler times when we created "homepages" in Yahoo! Geocities and enjoying the annoying monkey sound of ICQ every time a friend IMed us...

Ahem, anyways... If you want to end this nonsense and stop your users to upload GIFs into your website's Media Library, you can disable GIF uploads with a simple code snippet like below:

Bye bye, four-second movie clips that doesn't need to be seen more than one time but keeps repeating endlessly!

End of Part Five

We went through the last batch of 50 filters in this article. I hope you liked and learned new things from it. In the next article, we're going to have a quick look at what we've seen and close the series. See you there!

I want to hear your thoughts, too. What do you think about these filters? Post your comments below; and if you liked the article, don't forget to share it!

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.