Templa...::Mojo(3pm)

💖 Template::Provider::Mojo 💖

okay bestie, so this is a page from the User Contributed Perl Documentation collection, and it's literally the manual for Template::Provider::Mojo, which lives in the 3pm section (that's the perl module manual section, iykyk). it's giving "let Mojolicious do the template heavy lifting" and honestly? iconic. 💅

---

✨ NAME ✨

Template::Provider::Mojo — use Mojolicious to provide templates 🦋

---

🌸 SYNOPSIS 🌸

my $app = Mojolicious->new;
$provider = Template::Provider::Mojo->new({MOJO_RENDERER => $app->renderer});

($template, $error) = $provider->fetch($name);

no cap, that's the whole vibe right there 🫶

---

💜 DESCRIPTION 💜

so Template::Provider::Mojo is a subclass of Template::Provider — a glow-up, if you will — and it uses a Mojolicious::Renderer instance to resolve template names. main character energy fr fr. 💅

what that actually means for you:

• "paths" in Mojolicious::Renderer get searched for file-based templates 📂
• "classes" in Mojolicious::Renderer get searched for DATA templates 🗂️
• the "ENCODING" configuration setting gets initialized to "encoding" in Mojolicious::Renderer if it's unset — so if you didn't set it, it gets set for you, slay ✨

---

🎀 METHODS 🎀

Template::Provider::Mojo inherits all the methods from Template::Provider, and then implements these new ones. it's giving "family recipes plus my own secret sauce" 😭💖

🧚 fetch

returns a compiled template for the name you specify. for all the usage details, go check out "fetch($name)" in Template::Provider. literally just peek over there, it's all there 🔥

🦋 load

loads a template without parsing or compiling it. this one is used by the INSERT directive — so it's the lowkey workhorse behind the scenes, no parsing, no compiling, just vibes 💀✨

---

💀 BUGS 💀

found something broken? report any issues on the public bugtracker. not me asking you to file a bug report but also yes me asking you to file a bug report 🙈🫶

---

👑 AUTHOR 👑

Dan Book <dbook@cpan.org> — legend behaviour, periodt 💅

---

🌈 COPYRIGHT AND LICENSE 🌈

this software is Copyright (c) 2015 by Dan Book.

it's free software, licensed under:

The Artistic License 2.0 (GPL Compatible)

so yes bestie, you can use it, it's GPL compatible, go off 🎀

---

⭐ SEE ALSO ⭐

• Template
• Mojolicious::Renderer
• Mojolicious::Plugin::TemplateToolkit

---

and that's the whole page, bestie!! this was documented for perl v5.36.0, dated 2023-02-24, and the original header/footer called it Templa...::Mojo(3pm) because even manpage titles get truncated sometimes 😭💖 mwah, go build something cute with it 🫶✨