se7enxweb / ticketsystem
ticketsystem for Exponential: help desk tickets as content objects, with readable ticket numbers, status sets, customer-scoped sharing, mail copies of every post and Exponential notification subscriptions. The 7x modernization of the ticketsystem extension.
Package info
github.com/se7enxweb/ticketsystem
Type:ezpublish-legacy-extension
pkg:composer/se7enxweb/ticketsystem
Requires
- php: >=8.0
- se7enxweb/exponential-legacy-installer: *
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Help desk tickets for Exponential: customers open tickets, follow them and reply from the site; support staff answer, change the status and solve them. Every post, including the customer's own, is mailed to everyone who follows the ticket, in HTML and plain text with the full message, so each person keeps an external record of the whole conversation.
ticketsystem was written by xrow GbR (Hannover, Germany) in 2006 and 2007 for eZ Publish 3.9 and published on projects.ez.no. 7x took it over in 2026 to keep it alive for its users: it now runs on Exponential 6.0.15 with PHP 8.0 to 8.5, and it was cleaned up, re-documented and extended.
Features
- Tickets are content objects, as in ticketsystem 1.x: a
ticketobject below the opener's user node (never in the public section), each reply aticket_commentbelow the ticket. - Readable ticket numbers like
7X-2026-00042: a gapless counter per prefix and year. - Status sets: the 7x set (Open, Waiting on customer, Waiting on staff, On hold, Resolved, Closed) by default, or the original ticketsystem set; resolved tickets close by themselves after a number of days.
- Sharing by account: the policy limitation Scope (Own, Account, All). With Katalyst the account is the Katalyst customer, so everybody linked to a customer sees its tickets; elsewhere a ticket belongs to its opener.
- Mail copies of every post, HTML and text, threaded per ticket, sent from one support address.
- Exponential notification subscriptions: the opener and everyone who posts follow the ticket node.
- Technical Support Group: a user group and the role Ticket Support for support staff.
- Assignment (1.1): staff take a ticket or assign it, optional round-robin per queue; the staff list filters "assigned to me" and "unassigned"; staff change the priority and the queue of an open ticket.
- Internal notes (1.1): for staff only; never shown to a customer, never mailed, never in a customer's search or an export.
- Attachments (1.1): files of tickets, replies and notes, checked (size, type, content, an optional virus scanner), stored outside the public storage, served only to readers of the ticket.
- Reply by e-mail (1.1): an answer to a ticket mail becomes a post on its ticket; every mail carries a signed reference of its ticket and reader, the sender is checked, quoted text is cut. From an IMAP/POP3 mailbox on any mail server (the site's own, a separate Plesk server, Google Workspace) or a mail server pipe (doc/mail-in.md).
- WHMCS import (1.1): past WHMCS tickets become help desk tickets of their customers (by WHMCS client id), as history, silently and only once; a dry run by default (doc/import-whmcs.md).
- Merge and split (1.2): a duplicate into the ticket that stays (same account only; posts, files, notes and followers move, the old number redirects), replies off into a new ticket (doc/merge-split.md).
- Followers, watchers and CC (1.2): follow or stop, staff add staff watchers, CC addresses get a copy of every post without ever becoming an identity (doc/watchers.md).
- Time tracking (1.2): minutes with a reply or note, billable unless an SLA or warranty covers the account, a report and a CSV; billing integrations mark what they billed (doc/time-tracking.md).
- Tickets for customers (1.2): staff open a ticket on behalf of a customer, with or without the mail (doc/staff-opened-tickets.md).
- Automatic tickets (1.2): other extensions and jobs open an internal ticket per problem, repeats are added to it (doc/auto-tickets.md).
- Every database of the kernel (1.1): MySQL/MariaDB, PostgreSQL, SQLite, Oracle and MongoDB, from one schema definition; the installer also upgrades the tables of an older release.
- Mobile-first views, light and dark, with no inline CSS; inside the Katalyst customer console they use its frame and components.
- The original views of ticketsystem 1.x in the administration are kept (fixed for Exponential 6).
Administration
Without Katalyst, the help desk is worked from the administration: activate the extension, run the installer and give the staff the role "Ticket Support" (the Technical Support Group has it). They then get the top menu tab TicketSystem with its left menu: the lists of tickets (not resolved, needing a staff reply, assigned to me, unassigned, urgent, escalated, resolved or closed, all), and the pages for reports, search, canned replies, SLA and escalation, queues and categories, mail, files and ratings, and the import when one is configured. The list shows the status figures, a filter bar, sortable columns and pages, every filter as a view parameter; a ticket shows its details, the work on it, the SLA state, the conversation, internal notes, the reply and the history. The pages are drawn with admin4's shared components, light and dark. See doc/views.md and doc/permissions.md. With Katalyst the tab stands next to Katalyst's own "Tickets" tab.
Requirements
- Exponential 6.0.15 or later
- PHP 8.0 to 8.5
- MySQL/MariaDB, PostgreSQL, SQLite, Oracle (with the ezoracle extension, 2.3.14 or later) or MongoDB
Installation
composer require se7enxweb/ticketsystem
Then activate the extension and run the installer; see doc/install.md.
Documentation
| Topic | File |
|---|---|
| Installation and update | doc/install.md |
| How it works: objects, index, numbers | doc/architecture.md |
| Views and forms | doc/views.md |
| Policies, roles and sharing | doc/permissions.md |
| Status sets | doc/statuses.md |
| doc/mail.md | |
| Reply by e-mail | doc/mail-in.md |
| Importing WHMCS tickets | doc/import-whmcs.md |
| Design and the Katalyst console | doc/design.md |
| Every setting | doc/settings.md |
| Assignment, priority and queue | doc/assignment.md |
| Internal notes | doc/notes.md |
| Attachments | doc/attachments.md |
| Databases | doc/databases.md |
| Search | doc/search.md |
| Reports and the CSV export | doc/reports.md |
| Canned replies and macros | doc/canned-replies.md |
| Merge and split | doc/merge-split.md |
| Followers, watchers and CC | doc/watchers.md |
| Time tracking | doc/time-tracking.md |
| Tickets staff open for a customer | doc/staff-opened-tickets.md |
| Automatic tickets | doc/auto-tickets.md |
| The workflow event | doc/workflow.md |
| Coming from ticketsystem 1.x | doc/upgrade.md |
License
GNU General Public License v2.0 or (at your option) any later version; see LICENSE and COPYRIGHT.txt.
Copyright (C) 2006 - 2007 xrow GbR, Hannover (Germany). Original authors: Konstantin Pogrebnoj, Björn Dieding. Copyright (C) 2026 7x (se7enx.com) for the take-over and all new work.