Docs /Wrangler

Getting started

Before tickets can arrive

Three settings need attention on a fresh install. Everything else has a working default.

  1. From email — the address Wrangler sends as. Nothing goes out without a valid one.
  2. Staff notification recipients — separate addresses with commas or semicolons. Empty means nobody is told when a ticket is opened.
  3. Ticket page URL — the absolute URL of the template that shows a single ticket, with no trailing slash. Until this is set, emails go out with no link to the ticket.

Who can use Wrangler

ExpressionEngine has no per-add-on permission. Access to these pages is module access:

  • Super Admins always have it.
  • Anyone else needs a role with Wrangler assigned, under Members → Roles → (a role) → Add-Ons.

Anyone else gets the standard unauthorized response on every Wrangler URL.

That same group is what "staff" means everywhere in Wrangler. It is exactly who appears in the Assignee dropdown on a ticket and in the bulk-assign menu. If someone is missing from that list, give their role access to the module.

Note that the staff notification recipients setting is a separate, manual list of email addresses. Assigning a ticket to someone does not email them.

Queues

Queues are free text, defined as a comma-separated list in settings. They default to General, Sales, Bug Report.

Renaming a queue does not move the tickets already filed under the old name. Those stay filterable — the old name appears in the queue filter marked (retired) until the last ticket using it is re-filed or closed out.

"Wrangler is not licensed on this domain"

ExpressionEngine reports that this site has no valid Wrangler licence, or that it has expired. Nothing is disabled: tickets, replies, email and every screen keep working, and customers never see it. The notice shows only at the top of Wrangler's own control panel pages.

For the first 7 days it counts down, then the wording firms up. To clear it, add or renew the licence in Add-ons (the add-on's licence key field) and load any control panel page. ExpressionEngine refreshes its licence check from the browser, so the notice can take one page load to disappear. Local development hosts (.ddev.site, .test, .local, localhost) never show it.