add_filters seem to have its use in a WordPress context. However, debugging them is shit. And there are not a whole lot of good examples around to explain how to work with them.
I was trying to figure out a way to modify the colour defaults for the quotes component in AESOP Story Engine, and that took me a couple of hours to figure out (I’m just not that used to mucking around with plugins, filters and hooks); mainly because there are absolutely zero actual examples on how you can override them defaults.
So, here it is
add_filter() – The bare minimum
add_filter([a filter associated to the component you want to affect], [a method name reference that you come up with]). E.g:
add_filter(‘aesop_quote_defaults’, ‘modify_defaults’)
modify_defaults() – A couple things
You actually get an incoming argument that contains stuff in it, that you can review with… let’s say… var_dump()?
modify_defaults($whatsThis) {
var_dump($whatsThis);
}
and stuff comes out that you can actually work with! Yeah, it’s going to print all over your wordpress page whenever this is being called, but it sure beats not knowing _anything_ about the contents!
So, what a total add_filter code snippet could look at in the context of changing the background colour for the quote module, that could go into a functions.php file in a child theme:
add_filter(‘aesop_quote_defaults‘, ‘modify_quote_defaults‘);
function modify_quote_defaults($defaults) {
$defaults[‘background‘] = ‘white‘;
return $defaults;
}
So, now the background will by default be white, in terms of the quote module.
AESOP STORY MODE ENGINE; WAS THAT SO BLOODY HARD FOR YOU TO WRITE?!
I’m not (quite yet) a super savvy WordPress developer, and I shouldn’t have to resort to make a lot of Google searches (as an extra to reading your documentation), that proved to be several rabbit holes, and still I have to go through the core source code(!) to figure this out.
And not only that AESOP HORROR STORY ENGINE; It is your RESPONSIBILITY to document these things CLEARLY, but you seem to actually expect your userbase to go trawl your Github to find the fields that are applicable for these things. SHAME!
Anyways, apart from that, there’s a thing that I am a bit uncertain of how to do or handle appropriately;
- How to modify the defaults used in the admin area of WordPress when adding each component?