Capability / Filter Documentation?

Resolved Jason LeMahieu (MadtownLems)
(@madtownlems)

9 months ago

Hi there! I’m just getting started exploring Table Press, but it seems like a front-runner in the table plugin category so far.

We run a multisite environment with a very curated experience for our content managers, and tend to make extensive use of filters and managing user capabilities to give them the tools they need without overwhelming them.

I saw this line: “TablePress has a large number of WordPress Plugin Hooks (Actions and Filters) in its source code” and am curious if these actions and filters are documented anywhere, or if the expectation is to search the source code for apply_filters and look what’s possible.

Some quick examples of the kinds of customizations we’re looking at doing with filters, in case you’re curious:
* Restrict custom CSS to users with the manage_network capability
* Remove the “Uninstall TablePress” information and dialog (which shouldn’t be possible anyway, given we defined DISALLOW_FILE_MODS in wp-config.php)
* Remove the About page (or replace it with our own custom, simpler text and links)
* Remove “Upgrade to Premium” calls to action, as our content providers can’t do that on their own. (We might still upgrade to premium as a network, of course)

Cheers and thanks!

Viewing 1 replies (of 1 total)

Plugin Author Tobias Bäthge
(@tobiasbg)

9 months ago

Hi Jason!

Thanks for your post and the questions!

I have never really gotten around to properly document the hooks and filters (as I was never really fully happy with potential tools for this), but I do have an (however likely outdated) Gist on GitHub that can maybe serve as a starting point: https://gist.github.com/TobiasBg/8d21efba251941d479e50e14334baaa3

Beyond that, searching for apply_filters and do_action in the code base, e.g. on https://github.com/TablePress/TablePress/ will probably yield the best results for now.

The function https://github.com/TablePress/TablePress/blob/main/models/model-options.php#L211-L255 should serve as a good list of access capabilities that TablePress adds to various WordPress user roles. Adding/removing those from your site’s user roles should help with some of your more direct questions already, like offering the “Custom CSS” settings screen or the “About” screen. Hooks like tablepress_admin_view_actions might also be helpful for that.

The “Uninstall TablePress” feature also checks for various capabilities (and is turned off for a network-activated TablePress), see https://github.com/TablePress/TablePress/blob/main/controllers/controller-admin.php#L1379-L1381.

For the “Upgrade to Premium” calls to action, you would likely need to work with CSS code to hide these — or of course upgrade 🙂

I hope this helps! If you have more direct questions, please don’t hesitate to get in touch via email as well, see the bottom of https://tablepress.org/pricing/

Of course, if hooks in certain places would be helpful, I’m always open to checking if I can add them!

Best wishes,
Tobias

Viewing 1 replies (of 1 total)

The topic ‘Capability / Filter Documentation?’ is closed to new replies.