WordPress.org

Plugin Directory

Test out the new Plugin Directory and let us know what you think.

Widget Logic

Widget Logic lets you control on which pages widgets appear using WP's conditional tags. It also adds a 'widget_content' filter.

I upgraded to Version 5.7.0 and my site's widgets now behave differently

There was an important change to how your Widget Logic code is evaluated. There is a new default 'Load logic' point of 'after query variables set'. For most people this should be better, but you could try reverting to the old default 'when plugin starts'.

What can I try if it's not working?

  • Switch to the default theme. If the problem goes away, your theme may be interfering with the WP conditional tags or how widgets work
  • Try the wp_reset_query option. If your theme performs custom queries before calling the dynamic sidebar this might help.
  • Try a different 'Load logic' point. Most wordpress conditional tags only work 'after query variables set', but some plugins may require evaluation earlier or later.
  • The 'Evaluate widget logic more than once' option may be needed if you have to use an early 'Load logic' point.

I'm getting errors that read like "PHP Parse error… … eval()'d code on line 1"

You have a PHP syntax error in one of your widget's Widget Logic fields. Review them for errors. You might find it easiest to check by using 'Export options' and reading the code there (Though be aware that single and double quotes are escaped with multiple backslash characters.)

If you are having trouble finding the syntax error, a simple troubleshooting method is to use 'Export options' to keep a copy and then blank each Widget Logic field in turn until the problem goes. Once you've identified the problematic code, you can restore the rest with 'Import options'.

It's causing problems with Woo Commerce / other popular plugin

This is often, not always, fixed by trying the different 'Load Logic' options. The 'after query variables set' option looks like it might be a better default, try it.

What's this stuff in my sidebar when there are no widgets?

Since v .50 the widget logic code runs such that when dynamic_sidebar is called in a theme's code it will 'return false' if no widgets are present. In such cases many themes are coded to put in some default sidebar text in place of widgets, which is what you are seeing.

Your options, if you want this default sidebar content gone, are to either edit the theme, or as a work around, add an empty text widget (no title, no content) to the end of the sidebar's widget list.

How do I get widget X on just my 'home' page? (Or on every page except that.)

There is some confusion between the Main Page and the front page. If you want a widget on your 'front page' whether that is a static page or a set of posts, use is_front_page(). If it is a page using is_page(x) does not work. If your 'front page' is a page and not a series of posts, you can still use is_home() to get widgets on that main posts page (as defined in Admin > Settings > Reading).

Logic using is_page() doesn't work

I believe this is fixed in 5.7.0. Let me know if that is not the case.

If your theme calls the sidebar after the loop you should find that the wp_reset_query option fixes things. This problem is explained on the is_page codex page.

How do I get a widget to appear both on a category page and on single posts within that category?

Take care with your conditional tags. There is both an in_category and is_category tag. One is used to tell if the 'current' post is IN a category, and the other is used to tell if the page showing IS for that category (same goes for tags etc). What you want is the case when:

(this page IS category X) OR (this is a single post AND this post is IN category X)

which in proper PHP is:

is_category(X) || (is_single() && in_category(X))

How do I get a widget to appear when X, Y and Z?

Have a go at it yourself first. Check out the 'Writing Logic Code' section under Other Notes.

Why is Widget Logic so unfriendly, you have to be a code demon to use it?

This is sort of deliberate. I originally wrote it to be as flexible as possible with the thought of writing a drag'n'drop UI at some point. I never got round to it, because (I'm lazy and) I couldn't make it both look nice and let you fall back to 'pure code' (for the possibilities harder to cater for in a UI).

The plugin Widget Context presents a nice UI and has a neat 'URL matching' function too.

Widgets appear when they shouldn't

It might be that your theme performs custom queries before calling the sidebar. Try the wp_reset_query option.

Alternatively you may have not defined your logic tightly enough. For example when the sidebar is being processed, in_category('cheese') will be true if the last post on an archive page is in the 'cheese' category.

Tighten up your definitions with PHPs 'logical AND' &&, for example:

is_single() && in_category('cheese')

Requires: 3.0 or higher
Compatible up to: 4.7.3
Last Updated: 1 month ago
Active Installs: 300,000+

Ratings

4.6 out of 5 stars

Support

7 of 27 support threads in the last two months have been marked resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,2,2
100,1,1 100,6,6
100,1,1 100,9,9
100,8,8
100,1,1 0,1,0 0,1,0 78,18,14 100,4,4
86,14,12 100,36,36 100,1,1 0,1,0
87,31,27 0,1,0
96,49,47
100,1,1
100,7,7
100,11,11 0,1,0
100,3,3 100,1,1 0,1,0
95,37,35 100,7,7
100,8,8
100,12,12
100,18,18
100,2,2
100,6,6
95,58,55 100,1,1 100,1,1
100,7,7 0,1,0 91,11,10 100,1,1
96,53,51 100,6,6
100,4,4 97,29,28 0,1,0
100,6,6
89,38,34 0,6,0
93,28,26 100,1,1 100,1,1
60,5,3 20,5,1 100,5,5 69,13,9
92,36,33 100,1,1
100,3,3
83,6,5
100,7,7 100,1,1
100,6,6 67,3,2
70,10,7
88,16,14
100,1,1
67,3,2
100,8,8
100,5,5
89,9,8
100,8,8
100,3,3
75,4,3
50,4,2
100,5,5
100,1,1
83,6,5
100,2,2
67,3,2
100,7,7
100,1,1
100,4,4
100,2,2
100,3,3
100,1,1
50,2,1
100,2,2
100,1,1
100,1,1 40,5,2