| 1 |
<?php |
| 2 |
|
| 3 |
if ( ! defined('ABSPATH') ) { |
| 4 |
exit; |
| 5 |
} |
| 6 |
|
| 7 |
?> |
| 8 |
<div class="wpc-filter-set-advices"> |
| 9 |
<ul class="wpc-advices"> |
| 10 |
<li> |
| 11 |
<div class="wpc-advice-head wpc-opened"> |
| 12 |
<span class="wpc-advice-title">Show selected terms (Chips)</span> |
| 13 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 14 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 15 |
</button> |
| 16 |
</div> |
| 17 |
<div class="wpc-advice-body"> |
| 18 |
<p>Please use <strong>Filter Everything — Chips</strong> widget to display selected terms. Or insert shortcode <code>[fe_chips]</code> in the desired place.</p> |
| 19 |
<h4>Display via hook</h4> |
| 20 |
<p>On WooCommerce product pages Chips are displayed automatically.<br />But you can also add your theme hooks (actions) in <em>Filters -> Settings -> Selected Filters (Chips) integration</em> to display Chips in places where these hooks fire.</p> |
| 21 |
</div> |
| 22 |
</li> |
| 23 |
<li> |
| 24 |
<div class="wpc-advice-head"> |
| 25 |
<span class="wpc-advice-title">Setup on mobile</span> |
| 26 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 27 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 28 |
</button> |
| 29 |
</div> |
| 30 |
<div class="wpc-advice-body"> |
| 31 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 32 |
<p>In most cases, the most convenient option will be to use the Pop-up widget on mobile. Just enable this option in <em>Filters -> Settings -> Enable the Pop-up Filters widget</em>. And on mobile devices will appear the button that opens the Pop-up Filters widget.</p> |
| 33 |
<?php else : ?> |
| 34 |
<p>In the current Free version of the plugin you can enable the option <strong>Collapse the widget and show the Filters opening button</strong> in <em>Filters -> Settings</em>.<br />The <a href="<?php echo FLRT_PLUGIN_URL; ?>" target="_blank" class="wpc-external-link">PRO version</a> allows you to use a more convenient <strong>Pop-up Filters widget</strong> on mobile.<br />After activating any of these options on mobile devices will appear the button that opens Filters widget.</p> |
| 35 |
<?php endif; ?> |
| 36 |
<h4>Typical issues on mobile</h4> |
| 37 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 38 |
<p><strong>Pop-up does not appear after clicking on the button.</strong><br />Usually the reason is that it is placed in a block that becomes hidden on mobile. Please make the block visible on mobile devices, or move the Filters widget to another location that is always visible.</p> |
| 39 |
<?php endif; ?> |
| 40 |
<p><strong><?php |
| 41 |
if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : |
| 42 |
?>How to display the button that opens the Pop-up?<?php |
| 43 |
else : |
| 44 |
?>How to display the button that opens the Filters widget?<?php |
| 45 |
endif; |
| 46 |
?></strong><br /> Usually on mobile devices it is displayed automatically in popular themes. But if it is displayed where it is not needed, you can disable it in <em>Filters -> Settings -> Experimental -> Hide opening widget buttons</em>. And after insert the button with the shortcode <code>[fe_open_button]</code> in desired places. The button is visible only on mobile devices and is hidden on desktop devices by default.</p> |
| 47 |
<p><strong>How do I change the width of the screen that is considered a mobile screen?</strong><br /> In other words, how to change the mobile device breakpoint? The default value is 768px. However, you can change this value with <a href="https://gist.github.com/wpserve/8982d160b58ecd7a174b90fa0f953e44" target="_blank" class="wpc-external-link">this code example</a>, if you need to display the open button and Pop-up widget for example on desktops. You can place the code in the <code>functions.php</code> file of your active theme.</p> |
| 48 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 49 |
<p><strong>The Pop-up widget disappears after selecting a filter.</strong><br /> In 99% of cases, the reason is that as the <strong>HTML id or class of the Posts Container</strong> you specified a block that contains both: the filtered Posts list and the Filters widget.<br />By default, the Filters widget is closed, and when the content on the page is updated through AJAX, the Pop-up is also updated and returns to the closed state. Please set the <strong>HTML id or class of the Posts Container</strong> as recommended in <a href="https://filtereverything.pro/resources/plugin-settings/#ajax" target="_blank" class="wpc-external-link">this article</a></p> |
| 50 |
<?php endif; ?> |
| 51 |
</div> |
| 52 |
</li> |
| 53 |
<li> |
| 54 |
<div class="wpc-advice-head"> |
| 55 |
<span class="wpc-advice-title">Sort / Search in filtered results</span> |
| 56 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 57 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 58 |
</button> |
| 59 |
</div> |
| 60 |
<div class="wpc-advice-body"> |
| 61 |
<h4>Sort</h4> |
| 62 |
<p>To Sort the filtering results, please use the <strong>Filter Everything — Sorting</strong> widget. It allows you to specify almost any sorting criteria. You can also use the shortcode <code>[fe_sort]</code> to display the sorting widget where a widget area is not available.</p> |
| 63 |
<p><blockquote><strong>Note:</strong> the shortcode that displays the sorting field requires the presence of a real widget in the WordPress dashboard, since the sorting criteria can only be configured in a widget. This widget may be placed in the Inactive widgets area.</blockquote></p> |
| 64 |
<p><blockquote><strong>Note:</strong> Sorting only works for posts for which a Filter Set exists. In other words, only those posts that are filtered can be sorted. At the same time, you don't have to display the Filters widget on the page, just the existence of such a Filter Set is enough.</blockquote></p> |
| 65 |
<h4>Search</h4> |
| 66 |
<p>To Search in filtering results, please enable the <strong>Search Field</strong> in the Filter Set settings and set its position in the Filters widget. Please, remember that the search considers Post titles, their content and excerpt and the SKU field of WooCommerce products.</p> |
| 67 |
</div> |
| 68 |
</li> |
| 69 |
<li> |
| 70 |
<div class="wpc-advice-head"> |
| 71 |
<span class="wpc-advice-title">Resolve popular issues</span> |
| 72 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 73 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 74 |
</button> |
| 75 |
</div> |
| 76 |
<div class="wpc-advice-body"> |
| 77 |
<ol> |
| 78 |
<li> |
| 79 |
<div class="wpc-advice-head"> |
| 80 |
<span class="wpc-advice-title"><strong>Filters Do not appear on the page</strong></span> |
| 81 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 82 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 83 |
</button> |
| 84 |
</div> |
| 85 |
<div class="wpc-advice-body"> |
| 86 |
<p>If nothing at all appears in the place where you expect to see the Filters Widget, then most likely you have added it somewhere else. Please, check where you added your widget and whether it is in the correct Widget area.</p> |
| 87 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 88 |
<p>If you see the message <em>"No one Filter Set is related to this page..."</em> it means that no Filter Set has been registered for this page yet. Please open the Filter Set you want to use and specify this page in the field called <strong>Where to filter?</strong></p> |
| 89 |
<?php else: ?> |
| 90 |
<p>If you've placed the Filters widget or its shortcode in the correct location or widget area, you should at least see a diagnostic message telling you what you need to do to fix the problem.</p> |
| 91 |
<?php endif; ?> |
| 92 |
</div> |
| 93 |
</li> |
| 94 |
<li> |
| 95 |
<div class="wpc-advice-head"> |
| 96 |
<span class="wpc-advice-title"><strong>I see "There are no filter terms yet" instead of filter terms</strong></span> |
| 97 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 98 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 99 |
</button> |
| 100 |
</div> |
| 101 |
<div class="wpc-advice-body"> |
| 102 |
<p>a) This usually means that you have incorrectly specified the Meta key for your filter by a Custom Field. </p> |
| 103 |
<p>b) If you are sure that the Meta key is correct, then most likely you have not yet added any values from this meta field to your posts. This often happens with ACF Select type fields, because the Filter Everything does not get values from the ACF field directly, but from the existing values in Post meta fields.<br />Please edit several posts you are going to filter and specify any values for this field.</p> |
| 104 |
</div> |
| 105 |
</li> |
| 106 |
<li> |
| 107 |
<div class="wpc-advice-head"> |
| 108 |
<span class="wpc-advice-title"><strong>I select filter terms but the posts are Not filtered</strong></span> |
| 109 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 110 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 111 |
</button> |
| 112 |
</div> |
| 113 |
<div class="wpc-advice-body"> |
| 114 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 115 |
<p>a) Most often, the reason is that you chose an incorrect WP_Query in the <strong>What to filter?</strong> field in the Filter Set. Please choose another value. If you are not sure which one to choose, please experiment with different ones until the filter starts working correctly.</p> |
| 116 |
<?php else : ?> |
| 117 |
<p>a) Usually it means that you are trying to filter a Custom WP_Query, but not the default Main WP_Query for this archive page. To filter Custom WP_Queries, please use the <a href="<?php echo FLRT_PLUGIN_URL; ?>" target="_blank" class="wpc-external-link">PRO version</a> of the plugin.</p> |
| 118 |
<?php endif; ?> |
| 119 |
<p>b) If you have AJAX enabled and the filter is not working, try disabling this option and check again. If the filter starts working with AJAX disabled, it's usually because you specified the wrong value for the <strong>HTML id or class of the Posts Container</strong> option. Please set the correct value for the option as recommended in <a href="https://filtereverything.pro/resources/plugin-settings/#ajax" class="wpc-external-link" target="_blank">this article</a></p> |
| 120 |
<p>c) Rarely, but sometimes, this behavior can be caused by caching, which is implemented through a plugin or on the server. Please disable or reset the cache and check if the filter has started working.</p> |
| 121 |
</div> |
| 122 |
</li> |
| 123 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 124 |
<li> |
| 125 |
<div class="wpc-advice-head"> |
| 126 |
<span class="wpc-advice-title"><strong>I can not Activate the License</strong></span> |
| 127 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 128 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 129 |
</button> |
| 130 |
</div> |
| 131 |
<div class="wpc-advice-body"> |
| 132 |
<p>a) If you can't activate it at all and get an <strong>Unknown error</strong>, the problem is usually that access between your site and the <em>connect.filtereverything.pro</em> license server is restricted for some reason. You can ask support to activate your license.<br />To do this, please send us two things <a href="https://codecanyon.net/user/fe_support" target="_blank" class="wpc-external-link">via PM</a>:<br /> |
| 133 |
- the address of your website<br /> |
| 134 |
- license key, which you can get on <em>Filters -> Settings -> License</em>. |
| 135 |
</p> |
| 136 |
<p>b) If the plugin tells you that your license is already in use on two sites, then deactivate it on one of your sites to activate on the new one.<br />If you have deleted this site and are unable to deactivate the license there, please contact support and ask them to deactivate the license for you.</p> |
| 137 |
</div> |
| 138 |
</li> |
| 139 |
<?php endif; ?> |
| 140 |
<li> |
| 141 |
<div class="wpc-advice-head"> |
| 142 |
<span class="wpc-advice-title"><strong>I can't Sort the terms the way I need</strong></span> |
| 143 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 144 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 145 |
</button> |
| 146 |
</div> |
| 147 |
<div class="wpc-advice-body"> |
| 148 |
<p>If none of the filter terms sorting options is useful for you, you can always sort the terms exactly the way you want with the hook <code>wpc_terms_before_display</code>. Please, see example how it can be done <a href="https://filtereverything.pro/resources/hooks/#terms-before-display-hook" target="_blank" class="wpc-external-link">here</a></p> |
| 149 |
</div> |
| 150 |
</li> |
| 151 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 152 |
<li> |
| 153 |
<div class="wpc-advice-head"> |
| 154 |
<span class="wpc-advice-title"><strong>404 errors appear</strong></span> |
| 155 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 156 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 157 |
</button> |
| 158 |
</div> |
| 159 |
<div class="wpc-advice-body"> |
| 160 |
<p>a) If, after activating the plugin, you see that many pages are giving 404 errors, then it is usually a conflict with a plugin like Permalink Manager.<br />By default this plugin is not compatible with the Filter Everything and you can use both at the same time only if you disable permalinks for Filters. This can be done by adding the following code to the <code>functions.php</code> file of your active theme:<br /><code>define( 'FLRT_PERMALINKS_ENABLED', false );</code><br /> Or you can deactivate the Permalink Manager plugin.</p> |
| 161 |
<p>b) If only some filter generates 404 errors usually it means a conflict between the URL prefix you chose for the filter and a post slug or taxonomy term slug. For example, you chose the word <strong>department</strong> as the URL prefix and at the same time a link to the page contains the same word <strong>department</strong> e.g. <em>https://example.com/department</em>. In this case, simply edit the URL prefix in <em>Filters -> Settings -> URL Prefixes</em>.</p> |
| 162 |
</div> |
| 163 |
</li> |
| 164 |
<?php endif; ?> |
| 165 |
<?php if( flrt_is_woocommerce() ): ?> |
| 166 |
<li> |
| 167 |
<div class="wpc-advice-head"> |
| 168 |
<span class="wpc-advice-title"><strong>I want to hide "Out of stock" products in filtered results</strong></span> |
| 169 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 170 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 171 |
</button> |
| 172 |
</div> |
| 173 |
<div class="wpc-advice-body"> |
| 174 |
<?php if ( defined( 'FLRT_FILTERS_PRO' ) && FLRT_FILTERS_PRO ) : ?> |
| 175 |
<p>a) You can create a filter by Stock status as shown in <a href="https://demo.filtereverything.pro/example/by-stock/" target="_blank" class="wpc-external-link">this example</a> and your visitors will be able to choose products with the status <strong>In Stock</strong> only.</p> |
| 176 |
<p>b) You can add <a href="https://gist.github.com/wpserve/6bb6d1c7141f23b058a1ca726ca57372" target="_blank" class="wpc-external-link">this code</a> to your theme's <code>functions.php</code> file so that products with <strong>Out of stock</strong> status are hidden by default when filtering.<br />This code hides both: Simple and Variable products, if the variation matched to selected filters has the status <strong>Out of stock</strong>.</p> |
| 177 |
<?php else: ?> |
| 178 |
<p>You can create a filter by Stock status as shown in <a href="https://demo.filtereverything.pro/example/by-stock/" target="_blank" class="wpc-external-link">this example</a> and your visitors will be able to choose products with the status <strong>In Stock</strong> only.</p> |
| 179 |
<?php endif; ?> |
| 180 |
</div> |
| 181 |
</li> |
| 182 |
<?php endif; ?> |
| 183 |
<li> |
| 184 |
<div class="wpc-advice-head"> |
| 185 |
<span class="wpc-advice-title"><strong>Cannot add Two filters by the same criteria to one Filter Set</strong></span> |
| 186 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 187 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 188 |
</button> |
| 189 |
</div> |
| 190 |
<div class="wpc-advice-body"> |
| 191 |
<p>Unfortunately, it is not possible for a technical reasons. But <?php |
| 192 |
if ( ! defined( 'FLRT_FILTERS_PRO' ) ) : |
| 193 |
?>in case of the <a href="<?php echo FLRT_PLUGIN_URL; ?>" target="_blank" class="wpc-external-link">PRO version</a> of the plugin <?php |
| 194 |
endif; |
| 195 |
?>you can use a trick:<br /> |
| 196 |
- create two Filter Sets<br /> |
| 197 |
- put the filter by the same criteria in them both<br /> |
| 198 |
- add two Filter widgets to the page next to each other.</p> |
| 199 |
<p>But in any case such solution is poor from the software design point of view. Much better is to create two different taxonomies for example with free <a href="https://wordpress.org/plugins/custom-post-type-ui/" target="_blank" class="wpc-external-link">CPTUI plugin</a> and create two filters by these taxonomies.</p> |
| 200 |
</div> |
| 201 |
</li> |
| 202 |
<li> |
| 203 |
<div class="wpc-advice-head"> |
| 204 |
<span class="wpc-advice-title"><strong>New values in the ACF field does not Appear in the filter</strong></span> |
| 205 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 206 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 207 |
</button> |
| 208 |
</div> |
| 209 |
<div class="wpc-advice-body"> |
| 210 |
<p>The fact is that the Filter Everything plugin selects values for filters directly from the Custom field in posts, and not from the ACF field. And so until you set these values for specific posts, they don't appear in the filter.</p> |
| 211 |
<p>If you have added new or edited existing options for example in the Select ACF field, please edit the few posts you are going to filter and set these new ACF field values in them. After that, check your filter by this Custom field.</p> |
| 212 |
</div> |
| 213 |
</li> |
| 214 |
<li> |
| 215 |
<div class="wpc-advice-head"> |
| 216 |
<span class="wpc-advice-title"><strong>Terms show Old counters. Cache issue.</strong></span> |
| 217 |
<button type="button" class="wpc-action wpc-advice-toggle widget-action hide-if-no-js" aria-expanded="false"> |
| 218 |
<span class="toggle-indicator" aria-hidden="true"></span> |
| 219 |
</button> |
| 220 |
</div> |
| 221 |
<div class="wpc-advice-body"> |
| 222 |
<p>If you have updated your posts but counters in the filter terms has not changed, resetting the internal plugin's cache may help in this case.</p> |
| 223 |
<p>To reset the cache, you need to open any page of your site with the <strong>?reset_filters_cache=true</strong> parameter added to its URL. For example <strong>https://example.com/?reset_filters_cache=true</strong>.</p> |
| 224 |
<p>After that, all the filter terms cached by the plugin and their counters will be updated and get their current values.</p> |
| 225 |
</div> |
| 226 |
</li> |
| 227 |
</ol> |
| 228 |
</div> |
| 229 |
</li> |
| 230 |
<li> |
| 231 |
<p><span>Check out the <a href="https://filtereverything.pro/resources/" target="_blank" class="wpc-external-link">Documentation</a></span></p> |
| 232 |
</li> |
| 233 |
<p><span>Ask for <a href="https://filtereverything.pro/support/" target="_blank" class="wpc-external-link">Support</a></span></p> |
| 234 |
</li> |
| 235 |
</ul> |
| 236 |
</div> |
