=== Widget Logic === Contributors: widgetlogics Tags: widget, sidebar, conditional tags, blocks, gutenberg widgets Requires at least: 3.0 Tested up to: 6.6 Stable tag: 6.02 Requires PHP: 5.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Widget Logic lets you control on which pages widgets appear using WP's conditional tags. == Description == This plugin gives every widget an extra control field called "Widget logic" that lets you control the pages that the widget will appear on. The text field lets you use WP's [Conditional Tags](http://codex.wordpress.org/Conditional_Tags), or any general PHP code. PLEASE NOTE The widget logic you introduce is EVAL'd directly. Anyone who has access to edit widget appearance will have the right to add any code, including malicious and possibly destructive functions. There is an optional filter 'widget_logic_eval_override' which you can use to bypass the EVAL with your own code if needed. (See [Other Notes](other_notes/)). The configuring and options are in the usual widget admin interface. BIG UPDATE: * Now you can control widget in Gutenberg Widgets editor as well as in Classic Editor. It is just as easy as before but also in gutenberg view. * Pre-installed widgets let you add special widget with one click of the mouse. First pre-installed widget is Live Match that let you add widget of one random live football game with real time score updates (teams logos, livescore, minute of the match, tournament name). And more interesting widgets to come! = Configuration = Aside from logic against your widgets, there are three options added to the foot of the widget admin page (see screenshots). * Use 'wp_reset_query' fix -- Many features of WP, as well as the many themes and plugins out there, can mess with the conditional tags, such that is_home is NOT true on the home page. This can often be fixed with a quick wp_reset_query() statement just before the widgets are called, and this option puts that in for you rather than having to resort to code editing * Load logic -- This option allows you to set the point in the page load at which your widget logic if first checked. Pre v.50 it was when the 'wp_head' trigger happened, ie during the creation of the HTML's HEAD block. Many themes didn't call wp_head, which was a problem. From v.50 it happens, by default, as early as possible, which is as soon as the plugin loads. You can now specify these 'late load' points (in chronological order): * after the theme loads (after_setup_theme trigger) * when all PHP loaded (wp_loaded trigger) * after query variables set (parse_query) – this is the default * during page header (wp_head trigger) You may need to delay the load if your logic depends on functions defined, eg in the theme functions.php file. Conversely you may want the load early so that the widget count is calculated correctly, eg to show an alternative layour or content when a sidebar has no widgets. * Don't cache widget logic results -- From v .58 the widget logic code should only execute once, but that might cause unexpected results with some themes, so this option is here to turn that behaviour off. (The truth/false of the code will be evaluated every time the sidebars_widgets filter is called. = Interaction with External Services = Widget Logic uses the external service to obtain up-to-date information about the results of football matches. widgetlogic.org is a source of sports information, that provides a wide range of information about football, including various leagues, tournaments, and championships from around the world. The functioning of the widgetlogic.org service is based on delivering real-time data about selected matches without the need to refresh the page. This means that data is automatically updated without requiring page reload. This approach ensures users quick and uninterrupted access to the latest sports data without the effort of manually updating information, allowing them to stay informed about ongoing events in real-time. == Frequently Asked Questions == = Can I use Widget Logic in Gutenberg widgets view? = Yes, you can! Starting from 6.0.0 you can use Widget Logic in Gutenberg widgets and in Classic Widgets. So if you have earlier version, please update plugin. = 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](http://codex.wordpress.org/Conditional_Tags#The_Main_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](http://codex.wordpress.org/Function_Reference/is_page#Cannot_Be_Used_Inside_The_Loop). = 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](../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](http://wordpress.org/extend/plugins/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')` == Screenshots == 1. The 'Widget logic' field at work in Gutenberg widgets. 2. The 'Widget logic' field at work in Classic widgets. 3. The plugin options are at the foot of the usual widget admin page… `wp_reset_query` option, 'load logic point' and 'evaluate more than once'. You can also export and import your site's WL options as a plain text file for a quick backup/restore and to help troubleshoot issues. 4. Pre-installed 'Live Match' widget in widgets section 5. Pre-installed 'Live Match' widget on website == Changelog == = 6.02 = * fixed bug for php7.2 = 6.0.1 = * Bug fixes = 6.0.0 = * Gutenberg widgets editor added * Pre-installed widgets added (Live Match) * Bug fixes * Code cleanup = 5.10.4 = * Security update. The export feature has been protected with nonce. = 5.10.3 = * Security update. Huge thanks to the [Plugin Vulnerabilities](https://www.pluginvulnerabilities.com/) Team! = 5.10.2 = * The plugin's security has been improved, big thanks to [Paul Dannewitz](https://dannewitz.ninja/) for his excellent security audit! * The widget_content filter option has been removed from the settings block, but kept in the code for backward compatibility. The plan is to remove it completely and make the plugin simpler (let us know what you think). * Code cleanup. = 5.9.0 = wp_reset_query works better under certain conditions. = 5.8.2 = The code has been adapted to work on the servers with restricted post_parent=="13"));` -- home page OR the page that's a child of page 13 Note the extra ';' on the end where there is an explicit 'return'. == The 'widget_logic_eval_override' filter == Before the Widget Logic code is evaluated for each widget, the text of the Widget Logic code is passed through this filter. If the filter returns a BOOLEAN result, this is used instead to determine if the widget is visible. Return TRUE for visible.