Mail::...BLEval(3pm)

💖 Mail::...BLEval — the blocklist & welcomelist bestie 💖

okay so hi 🫶 you found the manual page for Mail::SpamAssassin::Plugin::WLBLEval, and yeah it ships as part of the User Contributed Perl Documentation (so it's a community icon, not a core-coded legend, iykyk). It's a SpamAssassin plugin, it's giving gatekeeper energy, and it's literally here to tell your mail who's allowed in and who's getting ✨ignored✨.

---

🎀 NAME 🎀

Mail::SpamAssassin::Plugin::WLBLEval — a SpamAssassin plugin for blocklist and welcomelist evaluation. no cap, that's the whole vibe.

---

✨ SYNOPSIS ✨

load it up like this, bestie:

loadplugin Mail::SpamAssassin::Plugin::WLBLEval

and then in your rules you just… call it. yes it's that easy:

# In your rules:
header   FROM_IN_BLOCKLIST   eval:check_from_in_blocklist()
header   TO_IN_WELCOMELIST   eval:check_to_in_welcomelist()

periodt. 💅

---

🌈 DESCRIPTION 🌈

okay so here's the tea 🍓: this plugin hands you a whole collection of functions for blocklists and welcomelists covering sender addresses, recipient addresses, and URI host lists too. so it's not just one little list girlie, it does the most and we love that for it.

and it doesn't just match the plain address either — it can match by address, by domain, and by relay information. three whole flavor options, iconic. 👑

---

💅 METHODS 💅

every single one, in order, no skips, no cuts, we're doing the whole setlist:

• check_from_in_blocklist() — is the sender address sitting in the blocklist? that's the check. 🚫
• check_to_in_blocklist() — is the recipient address in the blocklist? yeah. that one.
• check_to_in_welcomelist() — is the recipient address in the welcomelist? cute, they're invited. 💖
• check_to_in_more_spam() — is the recipient address chillin' in the more_spam_to list? 👀
• check_to_in_all_spam() — and is the recipient address in the all_spam_to list? 💀
• check_from_in_list($list) — is the sender address in the list you named in $list? you tell it which list, it does the lookup. 🤝
• check_replyto_in_list($list) — same energy but for the Reply-To address instead. check if it's in the specified $list. 📬
• check_wb_list($params) — the flexible one 🦋: checks whether an address is in a welcomelist or a blocklist, and it figures that out based on the parameters you pass it.
• check_to_in_list($list) — is the recipient address in the specified $list? yes bestie, that exact thing.
• check_from_in_welcomelist() — is the sender address in the welcomelist? 🌸
• check_forged_in_welcomelist() — spicy one 🔥: is the sender address forged with respect to the welcomelist? (callout behavior fr fr)
• check_from_in_default_welcomelist() — is the sender address in the default welcomelist? the default one specifically, not just any.
• check_forged_in_default_welcomelist() — and is that sender address forged with respect to the default welcomelist? yeah, same callout energy but scoped to the default list.
• check_mailfrom_matches_rcvd() — does the envelope sender domain match the relay domain? 🔍 because sometimes those two are giving different stories.
• check_uri_host_in_blocklist() — is any URI host in the blocklist? (any. not just one. all of them get checked. 😤)
• check_uri_host_in_welcomelist() — and is any URI host in the welcomelist? same deal, opposite vibe. ✨
• check_uri_host_listed($subname) — is any URI host listed in the list you specify with $subname? that's it, that's the function. 🎯

---

heads up bestie: this is a 3pm manual page, so it's documenting the Perl module — the calls above are exactly the calls, spelled exactly like that, don't freestyle the names. 💜

---

and that's the whole page, we ate and left no crumbs 🍽️✨. officially signed, sealed, and part of perl v5.40.1, dated 2026-07-23. mwah, go forth and evaluate those lists, you main character. 🎀🦋💅