Struct WidgetParams 

pub struct WidgetParams {
    pub period: Option<String>,
    pub start: Option<String>,
    pub end: Option<String>,
    pub raw: HashMap<String, String>,
}

Per-request parameters a widget’s data closure can read. Sourced from the query string on GET /admin/api/dashboard/widgets/<key>/data?<params>.

Defaults are all None — closures that don’t care can use WidgetDataFn::new(|user| ...) and ignore params entirely. Closures that DO care use WidgetDataFn::with_params and branch on params.period / params.start / params.end.

Fields

period: Option<String>

Period preset like "7d", "30d", "90d". The rendering side emits chips that pass this through.

start: Option<String>

Explicit ISO start date (YYYY-MM-DD) — overrides period when both are present.

end: Option<String>

Explicit ISO end date (YYYY-MM-DD).

raw: HashMap<String, String>

Catch-all for any other widget-specific query params — ?model=order for a future per-model filter, etc. Closures read by params.raw.get("...").

Implementations

impl WidgetParams

pub fn from_query<S: AsRef<str>>(query: S) -> Self

Build from a ?key=value&... query string. Recognised keys (period, start, end) populate the typed fields; the rest land in raw.

pub fn period_days(&self) -> Option<i64>

Number of days the period preset represents. "7d" → 7, "30d" → 30, "90d" → 90. None for unrecognised / missing values so callers fall back to a default.

pub fn choice(&self, key: &str) -> Option<&str>

Value of a WidgetFilter::choice control, by its key.

let status = params.choice("status").unwrap_or("open");

pub fn date_range(&self) -> Option<(&str, &str)>

The resolved window as (start, end) ISO dates, if a date-range filter supplied both. Takes precedence over period — a caller who picked explicit dates meant them.

Trait Implementations

impl Clone for WidgetParams

fn clone(&self) -> WidgetParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WidgetParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WidgetParams

fn default() -> WidgetParams

Returns the “default value” for a type.