====== Unclaimed Vouchers Page ======

===== Overview =====
The **Unclaimed Vouchers** page allows users to view, select, and manage vouchers that have not yet been claimed. This page is typically used for reviewing voucher details, editing vouchers (where permitted), and performing bulk actions on selected vouchers.
{{ :user_manual:global_pages:unclaimed_vouchers.png?600 |}}


===== Page Layout Overview =====

The page is split into two main sections:

==== 1. Header Section ====
The header provides tools for searching, filtering, and acting on vouchers.

 *Header features:*

  * **Search bar** – Search vouchers by token, notes, or other indexed fields.
  * **Advanced filters** – Refine the voucher list using available filter options.
  * **Selection counter** – Displays how many vouchers are currently selected.
  * **Clear selection** – Clears all selected vouchers.
  * **Action / page buttons** – Actions available depend on your permissions and current selection.

Updating the search query or filters refreshes the table automatically.


==== 2. Unclaimed Vouchers Grid ====

The grid displays a paginated list of all unclaimed vouchers.

 *Grid behavior:*

  * Server-side pagination and sorting
  * Multi-row selection enabled
  * Loading indicator shown while data is retrieved
  * Rows are selectable via checkboxes only (row click is disabled)

If no vouchers match the current filters, an empty-state message is displayed.



===== Table Columns & Interactions =====

==== Token ====

  * Displays the voucher token.
  * Shown as a chip with a copy icon.
  * Click the chip to **copy the token to your clipboard**.
  * A toast notification confirms a successful copy action.

==== Created At ====

  * Shows when the voucher was created.
  * Displayed in short date format.
  * Hover over the date to see the full date in a tooltip.

==== Quotas ====

  * Lists the services and credits included in the voucher.
  * Each service is displayed as a compact chip.
  * Format:

  * **Service Name : Credit Amount**

==== Notes ====

  * Displays notes associated with the voucher.
  * Notes longer than 64 characters are truncated with an ellipsis.
  * Click the text to **copy the full note** to your clipboard.

==== Options ====

  * Available via the **More Options (⋮)** menu.
  * Visible only to users with the **Voucher Edit** permission.
  * Currently supported action:

  * **Edit** – Opens the edit voucher dialog.



===== Row Selection & Bulk Actions =====

  * Select vouchers using the checkboxes in the table.
  * Multiple vouchers can be selected at once.
  * The number of selected vouchers is shown in the header.
  * Use header action buttons to perform bulk operations on selected vouchers (if available).


===== Pagination & Sorting =====

  * Page sizes available:

  * 25 vouchers
  * 50 vouchers
  * 100 vouchers
  * Use the paginator at the bottom of the grid to navigate pages.
  * Sorting is supported via column headers and is processed server-side.


===== Typical User Workflow =====

  * Open the Unclaimed Vouchers page
  * Use search or filters to find relevant vouchers
  * Review voucher details such as token, quotas, and notes
  * Select one or more vouchers if bulk actions are required
  * Use the options menu to edit a voucher (if permitted)


===== Tips =====

  * Copy voucher tokens directly from the table to avoid errors.
  * Use filters together with sorting for faster navigation.
  * Clear selections before changing context or filters.