{"id":123878,"date":"2013-12-12T11:30:58","date_gmt":"2013-12-12T16:30:58","guid":{"rendered":"http:\/\/premium.wpmudev.org\/blog\/?p=123878"},"modified":"2013-12-11T22:21:49","modified_gmt":"2013-12-12T03:21:49","slug":"how-to-prevent-widget-titles-appearing-on-your-wordpress-site","status":"publish","type":"post","link":"https:\/\/wpmudev.com\/blog\/how-to-prevent-widget-titles-appearing-on-your-wordpress-site\/","title":{"rendered":"How To Prevent Widget Titles Appearing On Your WordPress Site"},"content":{"rendered":"

The humble default WordPress Text widget is arguably one of the most flexible widgets but it has a flaw.<\/p>\n

Give it a title for clarity in the Admin interface and it automatically gets output in your WordPress site.<\/p>\n

In this quick article, I’ll show you how stop that automatic output and let you have your Admin clarity.<\/p>\n

<\/p>\n

\"Composite
Giving your Text widgets titles adds real clarity<\/figcaption><\/figure>\n\n

The description of “add arbitrary text and HTML” shortchanges this widget’s capabilities as we all know that we can also include javascript and, with a bit of tweaking, shortcodes.<\/p>\n

\"Screenshot
What’s in each Text widget?<\/figcaption><\/figure>\n

But the Text widget has been bugging me recently, especially when reviewing the theme builders where I often have three or four text widgets in a sidebar containing custom text and javascript for an ad server.<\/p>\n

I wanted to give my widgets a title so I knew which was which but I didn’t necessarily want the titles being output in the public site (the default behavior).<\/p>\n

The solution, it turns out, is dead simple and a mere three lines of code.<\/p>\n

There are certain mantras that seem to always run true for WordPress one of which is “there’s a filter or action for that”. In this case, it’s a filter, more specifically the widget_title filter which is applied to every widget title before being output in a site’s sidebar or widget area.<\/p>\n

\"Screen
Clarity in Admin, hidden to public<\/figcaption><\/figure>\n

To have my cake and eat it then, I needed some way of identifying that the title should not be output. I decided to go with wrapping the title in square brackets – [Admin interface only].<\/p>\n

So, by hooking into the widget_title filter, I can check to see if the title is wrapped in [ ] and if it is then I’ll return an empty string, otherwise the original title is returned and ultimately displayed in the public site.<\/p>\n

As this filter is not applied in the Admin interface, I still get my titles.<\/p>\n

Here’s the code as a plugin. Save this as flexible-widget-titles.php in the wp-content\/plugins folder of your site, go to Plugins and activate it.<\/p>\n

<\/code><\/p>\n

<?php
\n\/**
\n* @package Flexible_Widget_Titles
\n* @version 1.0
\n*\/
\n\/*
\nPlugin Name: Flexible Widget Titles
\nPlugin URI: https:\/\/wpmudev.com\/blog
\nDescription: Wrap a widget title in [] to prevent it being displayed on your website
\nAuthor: Chris Knowles
\nVersion: 1.0
\nAuthor URI: https:\/\/wpmudev.com\/blog
\n*\/<\/p>\n

function flexible_widget_titles( $widget_title ) {<\/p>\n

\/\/ get rid of any leading and trailing spaces<\/p>\n

$title = trim( $widget_title );<\/p>\n

\/\/ check the first and last character, if [ and ] set the title to empty<\/p>\n

if ( $title[0] == ‘[‘ && $title[strlen($title) – 1] == ‘]’ ) $title = ”;<\/p>\n

return $title;<\/p>\n

}<\/p>\n

add_filter( ‘widget_title’, ‘flexible_widget_titles’ );<\/p>\n

?><\/p>\n

 <\/p>\n

This has certainly made managing multiple Text widgets a lot easier for me. Hopefully you might find it useful too.<\/p>\n\n","protected":false},"excerpt":{"rendered":"

You want to give a WordPress Text widget a title for clarity in the Admin interface but you can’t because the default behaviour is for that title to be output on the public site. In this quick article, I’ll show you how stop that automatic output and let you have your Admin clarity.<\/p>\n","protected":false},"author":262394,"featured_media":123885,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"blog_reading_time":"","wds_primary_category":0,"wds_primary_tutorials_categories":0,"footnotes":""},"categories":[263],"tags":[10211,52],"tutorials_categories":[],"class_list":["post-123878","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials","tag-admin","tag-widgets"],"_links":{"self":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/123878","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/users\/262394"}],"replies":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/comments?post=123878"}],"version-history":[{"count":2,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/123878\/revisions"}],"predecessor-version":[{"id":216098,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/123878\/revisions\/216098"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/media\/123885"}],"wp:attachment":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/media?parent=123878"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/categories?post=123878"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/tags?post=123878"},{"taxonomy":"tutorials_categories","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/tutorials_categories?post=123878"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}