List view — Pagination, sorting, search and filters

By default, all entity columns are shown. Declaring list_display restricts the display to an ordered selection:

admin! {
    users: users::Model => RegisterForm {
        title: "Users",
        permissions: ["admin"],
        list_display: [
            ["username", "Username"],
            ["email", "Email"],
            ["is_active", "Active"],
        ]
    }
}

Each entry is a ["column_name", "Label"] pair. Columns declared in list_display also serve as the sorting whitelist: only these columns (and id) accept a sort_by parameter.

Available in the Tera context via visible_columns (list of names) and column_labels (corresponding labels).

Declaring list_filter enables a sidebar showing the distinct values of each field:

admin! {
    users: users::Model => RegisterForm {
        title: "Users",
        permissions: ["admin"],
        list_filter: [
            ["is_active", "Active"],                    // default: 10 values per page
            ["is_superuser", "Superuser"],              // default: 10 values per page
            ["username", "Username", 5],                // explicit limit: 5 values per page
        ]
    }
}

• For each column, the daemon generates a SQL query that loads distinct values with LIMIT / OFFSET.
• Sidebar pagination (‹ 1/N ›) is fully server-side via the fp_{column} URL parameter — no JavaScript required.
• The per-page limit is configured per column via the optional 3rd element (default: 10).
• Values are displayed as-is (CAST(column AS TEXT)). Do not use list_filter on foreign key (FK) or id columns — the raw value (35, 128…) is not human-readable. Use the search bar instead.
• Good candidates: booleans, enumerations, short codes (lang, status, block_type).
• Clicking a value applies a WHERE column = value filter to the SQL query.
• Multiple filters on different columns are combined with AND.

Each column header is clickable. The resulting URL:

/admin/users/list?sort_by=email&sort_dir=asc&page=1

• sort_by: column name (must be in list_display or be id)
• sort_dir: asc or desc
• Changing the sort automatically resets to page 1

The current direction is shown by ▲ / ▼ in the header. Clicking the same column a second time reverses the direction.

The search bar filters records across all visible text columns (ILIKE '%term%'). It preserves the active sort parameters.

/admin/users/list?search=alice&sort_by=email&sort_dir=asc

The entry counter reflects the filtered result.

Pagination is computed at the SQL level (LIMIT / OFFSET). Page size is configured at the application level:

.with_admin(|a| {
    a.site_title("Administration")
     .auth(RuniqueAdminAuth::new())
     .page_size(15)   // ← entries per page
})

Active filters and search are preserved in pagination links.