Runique Admin — Variables Tera par vue

Ces variables sont injectées sur toutes les routes par l'extracteur Request du framework, avant même que les handlers admin s'exécutent.

Champs de static_runique

{{ static_runique.static_url }}   {# URL de base des assets, ex: /static #}
{{ static_runique.static_dir }}   {# Répertoire physique sur disque #}

Route : GET /admin/login

inject_context n'est pas appelé — les variables resource, resources, resource_key ne sont pas disponibles.

Clés obligatoires — login

csrf_token, site_title, lang

error est optionnel — présent uniquement après un échec POST. En cas d'échec POST, les messages i18n de la section base sont aussi injectés.

Exemple minimal :

{% extends "admin/admin_template.html" %}

{% block title %}{{ admin_login_title }}{% endblock %}

{% block content %}
<div class="login-container">
    <h1>{{ admin_login_title }}</h1>
    <p>{{ admin_login_subtitle }}</p>

    {% if error %}
    <div class="alert alert-danger">{{ error }}</div>
    {% endif %}

    <form method="POST" action="{{ admin_prefix }}/login">
        <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
        <div>
            <label>{{ admin_login_label_username }}</label>
            <input type="text" name="username" required>
        </div>
        <div>
            <label>{{ admin_login_label_password }}</label>
            <input type="password" name="password" required>
        </div>
        <button type="submit">{{ admin_login_btn_submit }}</button>
    </form>
</div>
{% endblock %}

Le template login étend admin_template.html (contrat de blocs vides), pas admin_base.html — la sidebar et la topbar ne doivent pas apparaître sur la page de connexion.

Route : GET /admin/

inject_context n'est pas appelé. La variable current_resource est explicitement None.

Clés obligatoires — dashboard

resources, resource_counts, current_page

Exemple minimal :

{% extends "admin/admin_base" %}

{% block title %}{{ admin_dashboard_title }}{% endblock %}

{% block content %}
<h1>{{ admin_dashboard_title }}</h1>
<p>{{ admin_dashboard_subtitle }}</p>

{% if resources %}
<h2>{{ admin_dashboard_card_resources }}</h2>
<table class="table">
    <thead>
        <tr>
            <th>{{ admin_dashboard_th_resource }}</th>
            <th>{{ admin_dashboard_th_key }}</th>
            <th>{{ admin_dashboard_th_permissions }}</th>
            <th>{{ admin_dashboard_th_actions }}</th>
        </tr>
    </thead>
    <tbody>
        {% for res in resources %}
        <tr>
            <td>{{ res.title }}</td>
            <td><code>{{ res.key }}</code></td>
            <td>{{ res.permissions.list | join(sep=", ") }}</td>
            <td>
                <a href="{{ admin_prefix }}/{{ res.key }}/list">
                    {{ admin_dashboard_btn_list }}
                    {% if resource_counts[res.key] %}({{ resource_counts[res.key] }}){% endif %}
                </a>
                <a href="{{ admin_prefix }}/{{ res.key }}/create">{{ admin_dashboard_btn_create }}</a>
            </td>
        </tr>
        {% endfor %}
    </tbody>
</table>
{% else %}
<p>{{ admin_dashboard_empty_title }}</p>
<p>{{ admin_dashboard_empty_desc }}</p>
{% endif %}
{% endblock %}

Route : GET /admin/{resource}/list

Pagination

Colonnes

Tri

Recherche

Filtres sidebar

Note : active_filters est pré-rempli pour toutes les colonnes de list_filter (valeur "" si inactif). Tera lève une erreur si on accède à une clé absente — cette pré-initialisation l'évite. Plusieurs colonnes peuvent avoir une valeur non vide simultanément : les liens de filtre préservent les filtres des autres colonnes.

Structure de filter_meta[colonne]

Clés obligatoires — list

Référencées via runique::utils::constante::admin_ctx::list::REQUIRED :

entries, total, page, page_count, has_prev, has_next,
prev_page, next_page, visible_columns,
sort_by, sort_dir, sort_dir_toggle, search

Les variables i18n de la section list sont listées dans les variables globales ci-dessus.

Exemple minimal :

{% extends "admin/admin_base" %}

{% block title %}{{ resource.title }}{% endblock %}

{% block content %}
<div class="d-flex justify-content-between align-items-center mb-3">
    <h1>{{ resource.title }}
        <small class="text-muted fs-6">{{ total }} {{ admin_list_entries_count }}</small>
    </h1>
    <a href="{{ admin_prefix }}/{{ resource_key }}/create" class="btn btn-primary">
        {{ admin_list_btn_create }}
    </a>
</div>

{% if entries %}
<table class="table">
    <thead>
        <tr>
            <th>{{ admin_list_th_id }}</th>
            {# ajouter les colonnes selon le modèle #}
            <th>{{ admin_list_th_actions }}</th>
        </tr>
    </thead>
    <tbody>
        {% for entry in entries %}
        <tr>
            <td>{{ entry.id }}</td>
            <td>
                <a href="{{ admin_prefix }}/{{ resource_key }}/{{ entry.id }}/detail">{{ admin_list_btn_detail }}</a>
                <a href="{{ admin_prefix }}/{{ resource_key }}/{{ entry.id }}/edit">{{ admin_list_btn_edit }}</a>
                <a href="{{ admin_prefix }}/{{ resource_key }}/{{ entry.id }}/delete">{{ admin_list_btn_delete }}</a>
            </td>
        </tr>
        {% endfor %}
    </tbody>
</table>
{% else %}
<p>{{ admin_list_empty_title }}</p>
<p>{{ admin_list_empty_desc }}</p>
<a href="{{ admin_prefix }}/{{ resource_key }}/create">{{ admin_list_btn_create_first }}</a>
{% endif %}
{% endblock %}

Route : GET /admin/{resource}/create

Chaque entrée de m2m_fields expose :

Exemple Tera :

{% if m2m_fields is defined and m2m_fields %}
  {% for field in m2m_fields %}
  <div class="form-group">
    <label>{{ field.label }}</label>
    {% for choice in field.choices %}
    <label>
      <input type="checkbox"
             name="m2m_{{ field.field_name }}__{{ choice[0] }}"
             value="1">
      {{ choice[1] }}
    </label>
    {% endfor %}
  </div>
  {% endfor %}
{% endif %}

Clés obligatoires — create

form_fields, is_edit

Les variables i18n de la section create sont listées dans les variables globales ci-dessus.

Exemple minimal :

{% extends "admin/admin_base" %}

{% block title %}{{ admin_create_title }} — {{ resource.title }}{% endblock %}

{% block content %}
<h1>{{ admin_create_title }} — {{ resource.title }}</h1>
<p class="text-muted">{{ admin_create_card_info }}</p>

<form method="POST" action="{{ admin_prefix }}/{{ resource_key }}/create">
    {# csrf.js gère le token automatiquement pour les formulaires admin #}
    {% if form_fields.html %}
        {{ form_fields.html | safe }}
    {% else %}
        <p>{{ admin_create_no_fields }}</p>
    {% endif %}
    <button type="submit" class="btn btn-primary">{{ admin_create_btn_submit }}</button>
    <a href="{{ admin_prefix }}/{{ resource_key }}/list" class="btn btn-secondary">{{ admin_create_btn_cancel }}</a>
</form>
{% endblock %}

Route : GET /admin/{resource}/{id}/edit

Exemple Tera (avec pré-sélection) :

{% if m2m_fields is defined and m2m_fields %}
  {% for field in m2m_fields %}
  <div class="form-group">
    <label>{{ field.label }}</label>
    {% for choice in field.choices %}
    <label>
      <input type="checkbox"
             name="m2m_{{ field.field_name }}__{{ choice[0] }}"
             value="1"
             {% if choice[0] in field.selected %}checked{% endif %}>
      {{ choice[1] }}
    </label>
    {% endfor %}
  </div>
  {% endfor %}
{% endif %}

Clés obligatoires — edit

form_fields, is_edit, object_id

Les variables i18n de la section edit sont listées dans les variables globales ci-dessus.

Exemple minimal :

{% extends "admin/admin_base" %}

{% block title %}{{ admin_edit_title }} — {{ resource.title }} #{{ object_id }}{% endblock %}

{% block content %}
<h1>{{ admin_edit_title }} — {{ resource.title }} <small>#{{ object_id }}</small></h1>
<p class="text-muted">{{ admin_edit_card_info }}</p>

<form method="POST" action="{{ admin_prefix }}/{{ resource_key }}/{{ object_id }}/edit">
    {% if form_fields.html %}
        {{ form_fields.html | safe }}
    {% else %}
        <p>{{ admin_edit_no_fields }}</p>
    {% endif %}
    <button type="submit" class="btn btn-primary">{{ admin_edit_btn_submit }}</button>
    <a href="{{ admin_prefix }}/{{ resource_key }}/list" class="btn btn-secondary">{{ admin_edit_btn_cancel }}</a>
</form>
{% endblock %}

Route : GET /admin/{resource}/{id}/detail

Clés obligatoires — detail

object_id

entry est optionnel — absent si get_fn n'est pas configurée sur la ressource. Les variables i18n de la section detail sont listées dans les variables globales ci-dessus.

Exemple minimal :

{% extends "admin/admin_base" %}

{% block title %}{{ admin_detail_title }} — {{ resource.title }} #{{ object_id }}{% endblock %}

{% block content %}
<h1>{{ admin_detail_title }} — {{ resource.title }} <small>#{{ object_id }}</small></h1>

{% if entry %}
<dl class="row">
    {# itération dynamique sur les champs de l'entrée #}
    {% for key, value in entry %}
    <dt class="col-sm-3">{{ key }}</dt>
    <dd class="col-sm-9">{{ value }}</dd>
    {% endfor %}
</dl>
{% endif %}

<a href="{{ admin_prefix }}/{{ resource_key }}/list" class="btn btn-secondary">{{ admin_detail_btn_list }}</a>
<a href="{{ admin_prefix }}/{{ resource_key }}/{{ object_id }}/edit" class="btn btn-primary">{{ admin_detail_btn_edit }}</a>
<a href="{{ admin_prefix }}/{{ resource_key }}/{{ object_id }}/delete" class="btn btn-danger">{{ admin_detail_btn_delete }}</a>
{% endblock %}

Route : GET /admin/{resource}/{id}/delete

Clés obligatoires — delete

object_id

entry est optionnel — absent si get_fn n'est pas configurée sur la ressource. Les variables i18n de la section delete sont listées dans les variables globales ci-dessus.

Exemple minimal :

{% extends "admin/admin_base" %}

{% block title %}{{ admin_delete_title }} — {{ resource.title }} #{{ object_id }}{% endblock %}

{% block content %}
<h1>{{ admin_delete_heading }}</h1>

<div class="alert alert-danger">
    <strong>{{ admin_delete_warning_title }}</strong>
    <p>{{ admin_delete_warning_desc }}</p>
    {% if entry %}
    <p>{{ admin_delete_warning_of }} <strong>#{{ object_id }}</strong></p>
    {% endif %}
    <p>{{ admin_delete_warning_irreversible }}</p>
</div>

<form method="POST" action="{{ admin_prefix }}/{{ resource_key }}/{{ object_id }}/delete">
    <button type="submit" class="btn btn-danger">{{ admin_delete_btn_confirm }}</button>
    <a href="{{ admin_prefix }}/{{ resource_key }}/list" class="btn btn-secondary">{{ admin_delete_btn_cancel }}</a>
</form>
{% endblock %}

{{ admin_create_title }}

Ne pas utiliser | default(value="...") — les variables i18n sont toujours présentes si la langue est configurée.

Via .templates() dans le builder, remplace le template pour toutes les ressources :

RuniqueApp::builder(config)
    .with_admin(|a| a
        .templates(|t| t
            .with_list("mon_theme/list")
            .with_create("mon_theme/create")
            .with_edit("mon_theme/edit")
            .with_detail("mon_theme/detail")
            .with_delete("mon_theme/delete")
            .with_dashboard("mon_theme/dashboard")
            .with_login("mon_theme/login")
            .with_base("mon_theme/admin_base")
        )
    )
    .build().await?

Les templates surchargés ont accès aux mêmes variables que les templates par défaut.