HTML::...Plugin(3pm)

💖 HTML::...Plugin 💖

okay bestie, so this is HTML::FormFu::Plugin, a User Contributed Perl Documentation page, and it's literally the blueprint for building plugins. Think of it as the ✨base class✨ energy — the blueprint every plugin inherits from. 🎀

---

✨ NAME ✨

HTML::FormFu::Plugin — it's the base class for plugins, no cap. 🫶

🌸 VERSION 🌸

version 2.07 — that's the one, periodt.

💅 DESCRIPTION 💅

So here's the tea: plugins are little add-ons you can slap onto a form or onto any element to modify how they behave. That's the whole vibe. 🦋

But listen — some plugins are designed to only go on a form, and some are designed to only go on an element. It's giving "know your audience". Depending on how the plugin was built, it belongs in one spot, not the other. 🙈

👑 METHODS 👑

Plugins get to override any of the following method stubs. These are your little hooks, bestie — fill 'em in and do your thing. 💖

⭐ process ⭐

okay so, real talk: only plugins that were added to a form, or to a field element that inherits from HTML::FormFu::Role::Element::Field, will actually have their process method run. Everyone else? Nothing. Silent. 💀

• For form plugins, it's called during process in HTML::FormFu, and that happens before process gets called on any of the elements.
• For field plugins, it's called during the field's own process call.

⭐ pre_process ⭐

• For form plugins, this fires immediately after pre_process has been run on the elements.
• For element plugins, this fires before pre_process is run on form plugins.

⭐ post_process ⭐

• For form plugins, this fires immediately before process in HTML::FormFu returns.
• For element plugins, this fires before post_process is run on form plugins.

⭐ render ⭐

Only plugins that were added to a form will have their render method run. Element plugins? Not invited to this one. 🙈

It's called during render in HTML::FormFu, before the render_method in HTML::FormFu gets called.

⭐ post_render ⭐

Again — only plugins added to a form will have their post_render method run.

It's called during render in HTML::FormFu, immediately before render in HTML::FormFu returns.

And guess what, it gets passed a reference to the return value of render_method in HTML::FormFu. Iconic behaviour, honestly. 💅

🌈 CORE PLUGINS 🌈

The one and only core plugin on the roster:

• HTML::FormFu::Plugin::StashValid

💜 AUTHOR 💜

Carl Franks, cfranks@cpan.org — thank you for your service, king. 👑

🍓 LICENSE 🍓

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself. slay. ✨

💜 AUTHOR 💜

Carl Franks <cpan@fireartist.com> — yes bestie, he's listed twice, it's a whole moment.

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2018 by Carl Franks. 🫶

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

and that's the whole page, bestie — this was generated from perl v5.28.1, dated 2019-01-12, for HTML::...Plugin(3pm). go forth and write plugins, you absolute main character. 🦋💖✨