Advanced
Advanced holds the settings you reach for when something needs adjusting rather than designing - a class to hook your own styles onto, where the page jumps to after a click, whether this filter is recorded in analytics, and a box for your own CSS.
In short
Five sections: Add Extra Classes, Security, Scroll To Container, Analytics and Custom CSS. You can leave all of it alone and have a working filter - each one solves a specific problem rather than being part of the setup. Everything here is free except Analytics, which is Pro.
One section, worked through from top to bottom.
Add Extra Classes
One field, and it exists so you can style the results yourself.
Add Css Class
A class name added to every post in the results. Type it without a dot - the panel adds the class, you write the selector.
It gives you something specific to target, so your CSS reaches this filter's posts and nothing else on the site. Useful when you run more than one filter and want them to look different.
/* class typed into the field: mtfilter */
.mtfilter {
border-radius: 12px;
}
The classes the plugin adds on its own are listed in the CSS classes reference.
Security
One setting, and it changes how the filter's requests are checked.
Enable Nonce
A nonce is the token WordPress uses to confirm that a request came from the page it claims to have come from. This setting decides whether the filter sends one with each AJAX request.
It is set to Disable by default. The reason is caching: a nonce has a limited life, so on a page served from a cache a visitor can be handed one that has already expired, and the filter stops responding until the page is reloaded.
Tip
If your filter works when you are logged in but not for logged-out visitors, and the site is behind a page cache, this setting is the first thing to check.
Scroll To Container
What the page does after a visitor clicks a term or a pagination button. Three settings, and the last two only matter once the first is on.
Scroll To Container
Scrolls the page to the results after a click, instead of leaving the visitor where they were. It is disabled by default.
Turn it on where the filter sits above a long list, or in a sidebar beside one - without it, someone who ticks a term further down the filter may not see that the results above them have changed.
Scroll Position For Desktop and Scroll Position For Mobile
An offset in pixels, set separately for the two screen sizes. The page scrolls to the results container, and this number shifts where it stops.
the element the page scrolls to:
#Caf-Post-Layout-ContainerThis is what a fixed header needs. A header that stays pinned to the top of the screen covers the first part of the results, and the offset pushes the scroll far enough to clear it. The two fields take different numbers because a mobile header is rarely the same height as a desktop one.
Tip
Start with roughly the height of your header, then adjust. A positive number stops the page higher up; a negative one stops it lower down.
Analytics
One setting, and it is the only part of this tab that needs a licence.
Analytics is a Pro feature
Recording and the reports it feeds are both Pro. On the free version the setting is there but nothing is collected and the Analytics screen stays empty.
Enable Analytics
Records what visitors do with this filter - the terms they choose and the searches they run - so it shows up in the plugin's Analytics screen. It is enabled by default. What the reports contain is covered in What the Analytics dashboard shows.
Because it is set per filter, you can leave it on for the filters you are watching and off for the rest, which keeps the reports readable.
Custom CSS
A code editor, with line numbers, for CSS that applies to this filter. It starts empty.
Anything the tabs before this one cannot reach, you write here. Keeping it in the filter rather than in your theme means it travels with the filter and survives a theme update.
Careful
CSS written here is not checked before it is saved. A missing bracket can affect the rest of the rules in the box, so if the styling stops behaving after an edit, look at what you added last.
Note
Nothing here is live until you save. The button at the top right reads Publish on a filter you have never saved, and Update once it has been published.
Common Questions
Do I need to change anything on this tab?
No. A filter works with every setting here left as it is. Each one is here for a specific situation.
Enable Analytics is on but my Analytics screen is empty.
Analytics is a Pro feature. On the free version the setting shows but nothing is recorded.
My filter works for me but not for logged-out visitors.
Check Enable Nonce. On a cached site an expired nonce can stop the request going through, which is why the setting ships disabled.
The results change but the visitor does not notice.
Turn on Scroll To Container so the page moves to the results after each click.
My fixed header is covering the top of the results after scrolling.
Set Scroll Position For Desktop and Scroll Position For Mobile to roughly the height of your header, then adjust until it stops in the right place.
Where do I put a class name - with or without the dot?
Without. Type mtfilter in the field and write .mtfilter in your CSS.
Was this page helpful?
Thanks for your feedback!