Service Addons
Follow every add-on sold across this installation on a single list, so a suspension, a cancellation or a clean-up is finished in one pass instead of service by service.
Opening the Screen
Open Orders › Service Addons from the main menu: {admin}/services/addons. It is the panel-wide view of the records a service's Addons tab shows.
The menu entry counts the add-ons still at Pending Approval or In Progress, so you see there is work waiting before opening the screen.
Filter values travel in the address, so a saved link lands on an already narrowed list: {admin}/services/addons?filter[status]=waiting.
What Is on the Screen
Three bands: an options row, an advanced filter panel that stays closed until a filter carries a value, and the list. Below 768 pixels the options row folds behind Show Options.
The Options Row
Apply to Selected sits on the left and only appears when your role may operate on services. Its four choices are Activate, Suspend, Cancel and Delete. Picking one opens a confirmation window at once, then the selector clears. With no row ticked, nothing happens.
On the right sits Service Status, carrying every status the panel knows: Pending Approval, In Progress, Active, Completed, Suspended, Expired and Cancelled. Next to it, Advanced Filter opens the panel below and badges the number of advanced filters filled in.
The Advanced Filter Panel
The panel opens by itself when a filter is already in the address, so you can see why the list is short. The left box narrows by identity (Addon ID, Addon Name, Client, Service ID), the right one by billing (Billing Cycle, Start Date Range, End Date Range).
The date boxes open a calendar, and the symbol button beside each one switches the comparison: Equals, On or After, After, On or Before, Before, Exclude Date. Closing the panel clears every filter it holds and reloads the list.
The Add-on List
One row per add-on record, across every client and every service, sorted by status first so anything waiting floats to the top.
| Column | What it shows | Sorting |
|---|---|---|
| Selection | Feeds Apply to Selected; the header box takes the whole page. | Not sortable |
| Client | Name, company and, for staff allowed to open client records, a link to that record. | Not sortable |
| Service | The parent service, linked, with its record number underneath. | Not sortable |
| Addon | Addon name, option name below it. A quantity above one shows as a small badge before the option. | Not sortable |
| End Date | The add-on's own due date, or a dash when it carries none. | Sortable |
| Price | Total amount when one was calculated, otherwise the unit amount, cycle underneath. | Sortable |
| Status | The status badge of the add-on record. | Sorted first by default |
| (actions) | Row menu with View and, with the operation privilege, Delete. | Not sortable |
Rows needing attention carry a faint tint: red for Pending Approval, blue for In Progress, amber for Suspended. The search box matches the addon name, the option, the service name and the client's name or e-mail; the download icon beside it appears when your role may export tables.
The Addon Details Window
View in the row menu opens the Addon Details window, titled with the add-on's own record number. It is the window the service's Addons tab opens, with the same four cards (Client & Service, Addon Information, Date Details, Billing Details) and a Save Changes button that stays disabled until something changes. Saving closes it and reloads the list. Its walkthrough is in Addons of a Service.
Fields
The controls of the options row and the advanced filter panel.
Tasks
Narrowing the List
- Pick a state in the Service Status selector on the options row, for instance Pending Approval.
- For anything finer, press Advanced Filter next to it and fill in what you need: client, service number, cycle or the end date range.
- The list narrows as you go and the counter under it reports how many rows are left; the badge on the button says how many boxes are filled in.
Activating, Suspending or Cancelling Several Add-ons
- Tick the rows in the first column, or use the box in the column header to take the whole page.
- Choose Activate, Suspend or Cancel in Apply to Selected. A confirmation window opens, naming the number of add-ons and what the action does.
- Decide on Apply via API there; it is offered, and ticked, when at least one selected add-on belongs to a service bound to a module.
- Suspending or cancelling more than one record also asks for your admin password, the same guard the delete window uses; activating never does.
- Press the confirm button in the window footer (Activate, Suspend or Cancel Addons). The list reloads, and the status badges and row tints follow the new state.
Deleting Add-ons
- For a single record open its row menu and choose Delete; for several, tick them and choose Delete in Apply to Selected.
- Read the two information boxes in the Delete Addon Confirmation window (Delete Addons Confirmation for several) and decide on Apply via API, ticked when a module is involved. More than one record also asks for your admin password.
- Press Delete in the window footer. The rows leave the list at once, and each deletion is recorded in the action log.
Opening a Single Add-on
- Open the row menu at the end of the row and choose View.
- Work in the Addon Details window: status and manage actions in Client & Service, product and option in Addon Information, dates and pricing below.
- Press Save Changes in the window footer. The window closes and the list reloads with the new values.
Taking the List out of the Panel
- Narrow the list first: what leaves the panel is the filtered set, not the page you are looking at.
- Press the download icon at the right of the search box line and pick a format. The file drops the tick box and the row menu, and adds the record number the list hides as its own column.
Things to Watch
Each selected add-on is handled on its own, and a record that refuses to move is quietly skipped while the message still reports success. After the list reloads, check the Status column of the rows you picked.
Cancel leaves the record in place with a cancelled status, so the history stays readable. Delete removes it, and with Apply via API ticked the resource on the server too. Neither can be undone here.
Left ticked, the action is also sent to the server or external system behind the service. Unticked, only the record in this installation changes, which is what you want when the resource is already gone there.
Required Privileges
Opening the screen and the details window needs SERVICES_LOOK or SERVICES_OPERATION. Bulk actions, deleting and saving the window need SERVICES_OPERATION; without it the tick boxes, the bulk selector and the Delete entry are not printed and the screen is read-only.
Related Articles
Merci pour votre retour !
Notre équipe d'assistance est disponible 24h/24 pour tout ce que vous ne trouvez pas ci-dessus.