WordPress widgets offer us a lot of flexibility. By using widgets, we can easily include a variety of functions into different widget areas within our WordPress blog. However, it can sometimes be difficult to figure out how to properly style these widgets.
Here we examine how to flexibly style the native WordPress Search Widget. This is the search widget found in the searchform.php file of the default theme.
Note – If your WordPress theme has a searchform.php file, then your theme search widget will be used.
The WordPress Search Widget has several key areas –
- Widget title – This is the title of the widget that you get to enter in the Appearance >> Widgets menu.
- Search for text – Fixed “Search for” text shown on the top of the text entry box.
- Search text entry area – This is where users enter the text they want to search for.
- Search submit button – This is the search button. Clicking on it will execute a search for all public blog posts and pages containing the search text.
The good news is that all these areas can be easily modified using css. The widget title is often set by your WordPress theme, and controls not just the search widget title, but all other widget titles in the widget area. For reasons of theme consistency, you generally want to leave the widget title alone.
1. Remove Search-For Text
I don’t know about you, but the ‘Search for’ text that appears at the top of the search box is not only repetitive, but also clutters up the space.
To remove it, just enter the code below into your theme style.css file.
.widget_search .screen-reader-text { display:none; }
widget_search is the container name of the entire search widget, and
screen-reader-text is the container name of the ‘Search for’ text area.
If you like the ‘Search for’ text, you can also style it using CSS instead of just removing it.
2. Style Search Text Box
The next step is to style our search widget text box. The code below allows you to define the position and width of your search text box.
.widget_search { position:relative; background: url("search_widget_image_url.jpg") top left no-repeat; height:60px; width:180px; } .widget_search #s { position:absolute; top:30px; }
First, we set the position of the parent widget area (widget_search) to relative. This will allow us to define positions for our search text box and search submit button relative to the search parent widget.
Here, you can also set a background image for your search widget. To make the background show properly, remember to define a width and height for the widget.
Next, we position our text box relative to its parent widget. In the example above, we place our text box 30 pixels down from its parent widget. This gives enough space for our search widget title to display properly.
3. Style Search Button
The most complex part of styling our search widget is the search button.
Here, we want to replace the regular button with a glossy button. We also want to replace the text with a standard magnifying-glass search graphic.
The first step is to create some search button graphics. Here are some glossy search button graphics I created with Photoshop CS4. The magnifying glass logo used is created by Derferman. It is listed as public domain on Wikimedia. Feel free to use any of the search buttons below –
Now that we have the glossy button graphics, we can apply it to our search button with the following CSS code –
.widget_search #searchsubmit { position:absolute; top:5px; left:135px; width:40px; height:40px; background: url("images/sbutton2.png") top left no-repeat; border: none; } .widget_search #searchsubmit:hover { background: url("images/sbutton2b.png") top left no-repeat; border: none; }
Resize the button images above to suit your needs and set the width and height of the #searchsubmit area to fit the size of your button graphic. Also position the button appropriately.
This gives us a nice search widget button that changes color on mouse-over.
4. Remove Search Text
We still have a last problem – the words ‘Search’ still appears on our graphic. Since we already have an appropriate logo, as well as a search title, this text is no longer necessary.
The easiest way to remove this text, is to hook into the get_search_form filter as described by Metacowboy.
// Add to your init function add_filter('get_search_form', 'my_search_form'); function my_search_form($text) { $text = str_replace('value="Search"', 'value=""', $text); return $text; }
5. Congratulations – You Are Done!
Play around with the position of the elements, the background images, as well as the search button graphics to create your very own, personalized, …
WordPress search widget.
TelFiRE says
How do you style the “X” that shows up when you start typing?
Bob says
Thank you so much…
Jon says
Thank you, thank you, thank you, thank you!
🙂
Gail says
I don’t have the .widget_search in my CSS or a searchform.php file. What should I do?
baydiver says
got the same problem…can’t find the right place to edit the search bar in wordpress 3.9.1
kendell says
Great stuff man…thanks alot 🙂
Peter says
Excellent article! Clear and well organized.
Thanks a lot!
Eleazar Resendez says
excellent and thank you
Danish says
that is so cool. but I would like to insert this widget inside a page/post. how can i do that? I mean instead of placing on the sidebar, is there a short-code or a work around for getting this widget inside my post
ShibaShake says
Yeah, this is something that is on my list to add but haven’t gotten to it yet.
Terry says
Thnx for the tutorial, almost there… I am not sure how to re-size the search box itself as mine spans the whole widget background (looks ugly) and the magnifying glass is therefore not at the right hand end.
Also, I’m afraid I don’t understand Metacowboy (your) instructions about filters…not sure where or in what file that would go.
I note that Johnny (latest comment) uses a different method…sorry, don’t understand that either.
Would really appreciate a little more help to get this over the line (sorry, if I appear dumb)…:)
–T
ShibaShake says
You can resize the search box by using CSS. The search box class is usually “s” so try something like –
.widget_search .s { width: 80%; }
As for filters, they can be a bit complicated to use, if you are not familiar with PHP. Here is more on WordPress filters –
http://codex.wordpress.org/Plugin_API
As I understand it, Johnny hid the “Search” text by indenting it using CSS so that it appears outside the widget, and therefore does not get rendered. Maybe try something like –
.widget_search #searchsubmit { text-indent: 500px; }