mbess/paheko-fork

Fork 0

Matthieu Bessat 5ebc506921 initial commit

2024-01-19 16:39:49 +01:00

31 KiB

Raw Permalink Blame History

Title: Référence des sections Brindille

{{{.nav

Sections généralistes

foreach

Permet d'itérer sur un tableau par exemple. Ainsi chaque élément du tableau exécutera une fois le contenu de la section.

Paramètre	Optionnel / obligatoire ?	Fonction
`from`	obligatoire	Variable sur laquelle effectuer l'itération
`key`	optionnel	Nom de la variable à utiliser pour la clé de l'élément
`item`	optionnel	Nom de la variable à utiliser pour la valeur de l'élément

Considérons ce tableau :

{{:assign var="tableau" a="bleu" b="orange"}}

On peut alors itérer pour récupérer les clés (a et b ainsi que les valeurs bleu et orange) :

{{#foreach from=$tableau key="key" item="value"}}
{{$key}} = {{$value}}
{{/foreach}}

Cela affichera :

a = bleu
b = orange

Si on a un tableau à plusieurs niveaux, les éléments du tableau sont automatiquement transformés en variable :

{{:assign var="tableau.a" couleur="bleu"}}
{{:assign var="tableau.b" couleur="orange"}}

{{#foreach from=$variable}}
{{$couleur}}
{{/foreach}}

Affichera :

bleu
orange

Itérer sans tableau

Il est aussi possible de faire X itérations, arbitrairement, sans avoir de tableau en entrée, en utilisant le paramètre count.

C'est l'équivalent des boucles for dans les autres langages de programmation.

Exemple :

{{#foreach count=3 key="i"}}
- {{$i}}
{{/foreach}}

Affichera :

- 0
- 1
- 2

restrict

Permet de limiter (restreindre) une partie de la page aux membres qui sont connectés et/ou qui ont certains droits.

Deux paramètres optionnels peuvent être utilisés ensemble (il n'est pas possible d'utiliser seulement un des deux) :

Paramètre	Optionnel / obligatoire ?	Fonction
`level`	optionnel	Niveau d'accès : `read`, `write`, `admin`
`section`	optionnel	Section où le niveau d'accès doit s'appliquer : `users`, `accounting`, `web`, `documents`, `config`
`block`	optionnel	Si ce paramètre est présent et vaut `true`, alors l'accès sera interdit si les conditions d'accès demandées ne sont pas remplies : une page d'erreur sera renvoyée.

Exemple pour voir si un membre est connecté :

{{#restrict}}
	Un membre est connecté, mais on ne sait pas avec quels droits.
{{else}}
	Aucun membre n'est connecté.
{{/restrict}}

Exemple pour voir si un membre qui peut administrer les membres est connecté :

{{#restrict section="users" level="admin"}}
	Un membre est connecté, et il a le droit d'administrer les membres.
{{else}}
	Aucun membre n'est connecté, ou un membre est connecté mais n'est pas administrateur des membres.
{{/restrict}}

Pour bloquer l'accès aux membres non connectés, ou qui n'ont pas accès en écriture à la comptabilité.

{{#restrict block=true section="accounting" level="write"}}
{{/restrict}}

Le mieux est de mettre ce code au début d'un squelette.

Requêtes SQL

select

Exécute une requête SQL SELECT et effectue une itération pour chaque résultat de la requête.

Pour une utilisation plus simplifiée des requêtes, voir aussi la section sql.

Attention : la syntaxe de cette section est différente des autres sections Brindille. En effet après le début ({{#select) doit suivre la suite de la requête, et non pas les paramètres :

Liste des membres inscrits à la lettre d'informations :
{{#select nom, prenom FROM users WHERE lettre_infos = 1;}}
    - {{prenom}} {{$nom}}<br />
{{else}}
    Aucun membre n'est inscrit à la lettre d'information.
{{/select}}

Des paramètres nommés de SQL peuvent être présentés après le point-virgule marquant la fin de la requête SQL :

{{:assign prenom="Karim"}}
{{#select * FROM users WHERE prenom = :prenom;
    :prenom=$prenom}}
...
{{/select}}

Notez les deux points avant le nom du paramètre. Ces paramètres sont protégés contre les injections SQL (généralement appelés paramètres nommés).

Pour intégrer des paramètres qui ne sont pas protégés (attention !), il faut utiliser le point d'exclamation :

{{:assign var="categories." value=1}}
{{:assign var="categories." value=2}}
{{#select * FROM users WHERE !categories;
    !categories='id_category'|sql_where:'IN':$categories}}

Cela créera la requête suivante : SELECT * FROM users WHERE id_category IN (1, 2);

Il est aussi possible d'intégrer directement des variables dans la requête, en utilisant la syntaxe {$variable|filtre:argument1:argument2}, comme une variable classique donc, mais au lieu d'utiliser des doubles accolades, on utilise ici des accolades simples. Ces variables seront automatiquement protégées contre les injections SQL.

{{:assign prenom="Camille"}}
{{#select * FROM users WHERE initiale_prenom = {$prenom|substr:0:1};}}

Cependant, pour plus de lisibilité il est conseillé d'utiliser la syntaxe des paramètres nommés SQL (voir ci-dessus).

Il est aussi possible d'insérer directement du code SQL (attention aux problèmes de sécurité dans ce cas !), pour cela il faut rajouter un point d'exclamation après l'accolade ouvrante :

{{:assign var="prenoms." value="Karim"}}
{{:assign var="prenoms." value="Camille"}}
{{#select * FROM users WHERE {!"prenom"|sql_where:"IN":$prenoms};}}
...
{{/select}}

Il est aussi possible d'utiliser les paramètres suivants :

Paramètre	Fonction
`debug`	Si ce paramètre existe, la requête SQL exécutée sera affichée avant le début de la boucle.
`explain`	Si ce paramètre existe, l'explication de la requête SQL exécutée sera affichée avant le début de la boucle.
`assign`	Si renseigné, une variable de ce nom sera créée, et le contenu de la ligne y sera assigné.

Exemple avec debug :

{{:assign prenom="Karim"}}
{{#select * FROM users WHERE prenom = :prenom; :prenom=$prenom debug=true}}
...
{{/select}}

Affichera juste au dessus du résultat la requête exécutée :

SELECT * FROM users WHERE nom = 'Karim'

Paramètre assign

Exemple avec assign :

{{#select * FROM users WHERE prenom = 'Camille' LIMIT 1; assign="membre"}}{{/select}}
{{$membre.nom}}

Il est possible d'utiliser un point final pour que toutes les lignes soient mises dans un tableau :

{{#select * FROM users WHERE prenom = 'Camille' LIMIT 10; assign="membres."}}{{/select}}

{{#foreach from=$membres}}
	Nom : {{$nom}}<br />
	Adresse : {{$adresse}}
{{/foreach}}

sql

Effectue une requête SQL de type SELECT dans la base de données, mais de manière simplifiée par rapport à select.

{{#sql select="*, julianday(date) AS day" tables="membres" where="id_categorie = :id_categorie" :id_categorie=$_GET.id_categorie order="numero DESC" begin=":page*100" limit=100 :page=$_GET.page}}
…
{{/sql}}

Paramètre	Optionnel / obligatoire ?	Fonction
`tables`	obligatoire	Liste des tables à utiliser dans la requête (séparées par des virgules).
`select`	optionnel	Liste des colonnes à sélectionner, si non spécifié, toutes les colonnes (`*`) seront sélectionnées

Sections qui héritent de `sql`

Certaines sections (voir plus bas) héritent de sql et rajoutent des fonctionnalités. Dans toutes ces sections, il est possible d'utiliser les paramètres facultatifs suivants :

Paramètre	Fonction
`where`	Condition de sélection des résultats
`begin`	Début des résultats, si vide une valeur de `0` sera utilisée.
`limit`	Limitation des résultats. Si vide, une valeur de `10000` sera utilisée.
`group`	Contenu de la clause `GROUP BY`
`having`	Contenu de la clause `HAVING`
`order`	Ordre de tri des résultats. Si vide le tri sera fait par ordre d'ajout dans la base de données.
`assign`	Si renseigné, une variable de ce nom sera créée, et le contenu de la ligne du résultat y sera assigné.
`debug`	Si ce paramètre existe, la requête SQL exécutée sera affichée avant le début de la boucle.
`explain`	Si ce paramètre existe, l'explication de la requête SQL exécutée sera affichée avant le début de la boucle.
`count`	Booléen ou texte. Si ce paramètre est `TRUE`, le nombre de résultats sera retourné. Si une chaîne de texte est indiquée, elle sera utilisée dans la clause `COUNT(<texte>)`.

Il est également possible de passer des arguments dans les paramètres à l'aides des arguments nommés qui commencent par deux points : :

{{#articles where="title = :montitre" :montitre="Actualité"}}

Exemples d'utilisation du paramètre count :

{{#articles count=true}}
	Il y a {{$count}} articles.
{{/articles}}

{{#articles count=true assign="result"}}
{{/articles}}
Il y a {{$result.count}} articles.

{{#articles count="DISTINCT title"}}
	Il y a {{$count}} articles avec un titre différent.
{{/articles}}

Membres

users

Liste les membres.

Paramètres possibles :

Paramètre	Optionnel / obligatoire ?	Fonction
`id`	optionnel	Identifiant unique du membre, ou tableau contenant une liste d'identifiants.
`search_name`	optionnel	Ne lister que les membres dont le nom correspond au texte passé en paramètre.
`id_parent`	optionnel	Ne lister que les membres rattachés à l'identifiant unique du membre responsable indiqué.

Chaque itération renverra la fiche du membre, ainsi que ces variables :

Variable	Description
`$id`	Identifiant unique du membre
`$_name`	Nom du membre, tel que défini dans la configuration
`$_login`	Identifiant de connexion du membre, tel que défini dans la configuration
`$_number`	Numéro du membre, tel que défini dans la configuration

subscriptions

Liste les inscriptions à une ou des activités.

Paramètres possibles :

Paramètre		Fonction
`user`	optionnel	Identifiant unique du membre
`active`	optionnel	Si `TRUE`, seules les inscriptions à jour sont listées
`id_service`	optionnel	Ne renvoie que les inscriptions à l'activité correspondant à cet ID.

Comptabilité

accounts

Liste les comptes d'un plan comptable.

Paramètre	Fonction
`codes` (optionel)	Ne renvoyer que les comptes ayant ces codes (séparer par des virgules).
`id` (optionel)	Ne renvoyer que le compte ayant cet ID.

balances

Renvoie la balance des comptes.

Paramètre	Fonction
`codes` (optionel)	Ne renvoyer que les balances des comptes ayant ces codes (séparer par des virgules).
`year` (optionel)	Ne renvoyer que les balances des comptes utilisés sur l'année (indiquer ici un ID de year).

transactions

Renvoie des écritures.

Paramètre		Fonction
`id`	optionnel	Indiquer un ID d'écriture pour récupérer ses informations.
`user`	optionnel	Indiquer ici un ID utilisateur pour lister les écritures liées à un membre.

years

Liste les exercices comptables

Paramètre	Fonction
`closed` (optionel)	Mettre `closed=true` pour ne lister que les exercices clôturés, ou `closed=false` pour ne lister que les exercices ouverts.

Pour le site web

breadcrumbs

Permet de récupérer la liste des pages parentes d'une page afin de constituer un fil d'ariane permettant de remonter dans l'arborescence du site

Un seul paramètre est possible :

Paramètre	Fonction
`uri` (obligatoire)	Adresse unique de la page parente
ou `id_page` (obligatoire)	Numéro unique (ID) de la page parente

Chaque itération renverra trois variables :

Variable	Contenu
`$id`	Numéro unique (ID) de la page ou catégorie
`$title`	Titre de la page ou catégorie
`$uri`	Nom unique de la page ou catégorie
`$url`	Adresse HTTP de la page ou catégorie

Exemple

<ul>
{{#breadcrumbs id_page=$page.id}}
	<li>{{$title}}</li>
{{/breadcrumbs}}
</ul>

pages, articles, categories ^(sql)

Note : ces sections héritent de sql (voir plus haut).

pages renvoie une liste de pages, qu'elles soient des articles ou des catégories
categories ne renvoie que des catégories
articles ne renvoie que des articles

À part cela ces trois types de section se comportent de manière identique.

Paramètre	Fonction
`search`	Renseigner ce paramètre avec un terme à rechercher dans le texte ou le titre. Dans ce cas par défaut le tri des résultats se fait sur la pertinence, sauf si le paramètre `order` est spécifié.
`future`	Renseigner ce paramètre à `false` pour que les articles dont la date est dans le futur n'apparaissent pas, `true` pour ne renvoyer QUE les articles dans le futur, et `null` (ou ne pas utiliser ce paramètre) pour que tous les articles, passés et futur, apparaissent.
`uri`	Adresse unique de la page/catégorie à retourner.
`id_parent`	Numéro unique (ID) de la catégorie parente. Utiliser `null` pour n'afficher que les articles ou catégories de la racine du site.
`parent`	Adresse unique (URI) de la catégorie parente. Exemple pour renvoyer la liste des articles de la sous-catégorie "Événements" de la catégorie "Notre atelier" : `evenements`. Utiliser `null` pour n'afficher que les articles ou catégories de la racine du site. Ajouter un point d'exclamation au début de la valeur pour inverser la condition.

Par exemple lister 5 articles de la catégorie "Actualité", qui ne sont pas dans le futur, triés du plus récent au plus ancien :

{{#articles future=false parent="actualite" order="published DESC" limit=5}}
	<h3>{{$title}}</h3>
{{/articles}}

Chaque élément de ces boucles contiendra les variables suivantes :

Nom de la variable	Description	Exemple
`id`	Numéro unique de la page (ID)	`1312`
`id_parent`	Numéro unique de la catégorie parente (ID)	`42`
`type`	Type de page : `1` = catégorie, `2` = article	`2`
`uri`	Adresse unique de la page	`bourse-aux-velos`
`url`	Adresse HTTP de la page	`https://site.association.tld/bourse-aux-velos`
`path`	Chemin complet de la page	`actualite/atelier/bourse-aux-velos`
`parent`	Chemin de la catégorie parente	`actualite/atelier`
`title`	Titre de la page	`Bourse aux vélos`
`content`	Contenu brut de la page	`# Titre …`
`html`	Rendu HTML du contenu de la page	`<div class="web-content"><h1>Titre</h1>…</div>`
`has_attachments`	`true` si la page a des fichiers joints, `false` sinon	`true`
`published`	Date de publication	`2023-01-01 01:01:01`
`modified`	Date de modification	`2023-01-01 01:01:01`

Si une recherche a été effectuée, deux autres variables sont fournies :

Nom de la variable	Description	Exemple
`snippet`	Extrait du contenu contenant le texte recherché (entouré de balises `<mark>`)	`L’ONU appelle la France à s’attaquer aux « profonds problèmes » de <mark>racisme</mark> au sein des forces de…`
`url_highlight`	Adresse de la page, où le texte recherché sera mis en évidence	`https://.../onu-racisme#:~:text=racisme%20au%20sein`

attachments, documents, images ^(sql)

Note : ces sections héritent de sql (voir plus haut).

attachments renvoie une liste de fichiers joints à une page du site web
documents renvoie une liste de fichiers joints qui ne sont pas des images
images renvoie une liste de fichiers joints qui sont des images

À part cela ces trois types de section se comportent de manière identique.

Note : seul les fichiers de la section site web sont accessibles, les fichiers de membres, de comptabilité, etc. ne sont pas disponibles.

Paramètre	Optionnel / obligatoire ?	Fonction
`parent`	obligatoire si `id_parent` n'est pas renseigné	Nom unique (URI) de l'article ou catégorie parente dont ont veut lister les fichiers
`id_parent`	obligatoire si `parent` n'est pas renseigné	Numéro unique (ID) de l'article ou catégorie parente dont ont veut lister les fichiers
`except_in_text`	optionnel	passer `true` à ce paramètre , et seuls les fichiers qui ne sont pas liés dans le texte de la page seront renvoyés

Sections relatives aux modules

form

Permet de gérer la soumission d'un formulaire (<form method="post"…> en HTML).

Si l'élément dont le nom spécifié dans le paramètre on a été envoyé en POST, alors le code à l'intérieur de la section est exécuté.

Toute erreur à l'intérieur de la section arrêtera son exécution, et le message sera ajouté aux erreurs du formulaire.

Une vérification de sécurité anti-CSRF est également appliquée. Si cette vérification échoue, le message d'erreur "Merci de bien vouloir renvoyer le formulaire." sera renvoyé. Pour que cela marche il faut que le formulaire dispose d'un bouton de type "submit", généré à l'aide de la fonction button. Exemple : {{:button type="submit" name="save" label="Enregistrer"}}.

En cas d'erreurs, le reste du contenu de la section ne sera pas exécuté. Les messages d'erreurs seront placés dans un tableau dans la variable $form_errors.

Il est aussi possible de les afficher simplement avec la fonction {{:form_errors}}. Cela revient à faire une boucle sur la variable $form_errors.

{{#form on="save"}}
	{{if $_POST.titre|trim === ''}}
		{{:error message="Le titre est vide."}}
	{{/if}}
	{{* La ligne suivante ne sera pas exécutée si le titre est vide. *}}
	{{:save title=$_POST.titre|trim}}
{{else}}
	{{:form_errors}}
{{/form}}

Il est possible d'utiliser {{:form_errors}} en dehors du bloc {{else}} :

{{#form on="save"}}
	…
{{/form}}
…
{{:form_errors}}

load ^(sql)

Note : cette section hérite de sql (voir plus haut). De ce fait, le nombre de résultats est limité à 10000 par défaut, si le paramètre limit n'est pas renseigné.

Charge un ou des documents pour le module courant.

Paramètre	Optionnel / obligatoire ?	Fonction
`module`	optionnel	Nom unique du module lié (par exemple : `recu_don`). Si non spécifié, alors le nom du module courant sera utilisé.
`key`	optionnel	Clé unique du document
`id`	optionnel	Numéro unique du document
`each`	optionnel	Traiter une clé du document comme un tableau

Il est possible d'utiliser d'autres paramètres : {{#load cle="valeur"}}. Cela va comparer "valeur" avec la valeur de la clé cle dans le document JSON. C'est l'équivalent d'écrire where="json_extract(document, '$.cle') = 'valeur'".

Pour des conditions plus complexes qu'une simple égalité, il est possible d'utiliser la syntaxe courte $$… dans le paramètre where. Ainsi where="$$.nom LIKE 'Bourse%' est l'équivalent de where="json_extract(document, '$.nom') LIKE 'Bourse%'".

Voir la documentation de SQLite pour plus de détails sur la syntaxe de json_extract.

Note : un index SQL dynamique est créé pour chaque requête utilisant une clause json_extract.

Chaque itération renverra ces deux variables :

Variable	Valeur
`$key`	Clé unique du document
`$id`	Numéro unique du document

Ainsi que chaque élément du document JSON lui-même.

Exemples

Afficher le nom du document dont la clé est facture_43 :

{{#load key="facture_43"}}
{{$nom}}
{{/load}}

Afficher la liste des devis du module invoice depuis un autre module par exemple :

{{#load module="invoice" type="quote"}}
<h1>Titre du devis : {{$subject}}</h1>
<h2>Montant : {{$total}}</h2>
{{/load}}

Utilisation du paramètre `each`

Le paramètre each est utile pour faire une boucle sur un tableau contenu dans le document. Ce paramètre doit contenir un chemin JSON valide. Par exemple membres[1].noms pour boucler sur le tableau noms, du premier élément du tableau membres. Voir la documentation de la fonction json_each de SQLite pour plus de détails.

Pour chaque itération de la section, la variable {{$value}} contiendra l'élément recherché dans le critère each.

Par exemple nous pouvons avoir un élément membres dans notre document JSON qui contient un tableau de noms de membres :

{{:assign var="membres." value="Greta Thunberg}}
{{:assign var="membres." value="Valérie Masson-Delmotte"}}
{{:save membres=$membres}}

Nous pouvons utiliser each pour faire une liste :

{{#load each="membres"}}
- {{$value}}
{{/load}}

Ou pour récupérer les documents qui correspondent à un critère :

{{#load each="membres" where="value = 'Greta Thunberg'"}}
Le document n°{{$id}} est celui qui parle de Greta.
{{/load}}

list

Attention : cette section n'hérite PAS de sql.

Un peu comme {{#load}} cette section charge les documents d'un module, mais au sein d'une liste (tableau HTML).

Cette liste gère automatiquement l'ordre selon les préférences des utilisateurs, ainsi que la pagination.

Cette section est très puissante et permet de générer des listes simplement, une fois qu'on a saisi la logique de son fonctionnement.

Paramètre	Optionnel / obligatoire ?	Fonction
`schema`	requis si `select` n'est pas fourni	Chemin vers un fichier de schéma JSON qui représenterait le document
`select`	requis si `schema` n'est pas fourni	Liste des colonnes à sélectionner, sous la forme `$$.colonne AS "Colonne"`, chaque colonne étant séparée par un point-virgule.
`module`	optionnel	Nom unique du module lié (par exemple : `recu_don`). Si non spécifié, alors le nom du module courant sera utilisé.
`columns`	optionnel	Permet de n'afficher que certaines colonnes du schéma. Indiquer ici le nom des colonnes, séparées par des virgules.
`order`	optionnel	Colonne utilisée par défaut pour le tri (si l'utilisateur n'a pas choisi le tri sur une autre colonne). Si `select` est utilisé, il faut alors indiquer ici le numéro de la colonne, et non pas son nom.
`desc`	optionnel	Si ce paramètre est à `true`, l'ordre de tri sera inversé.
`max`	optionnel	Nombre d'éléments à afficher dans la liste, sur chaque page.
`where`	optionnel	Condition `WHERE` de la requête SQL.
`debug`	optionnel	Si ce paramètre existe, la requête SQL exécutée sera affichée avant le début de la boucle.
`explain`	optionnel	Si ce paramètre existe, l'explication de la requête SQL exécutée sera affichée avant le début de la boucle.
`disable_user_ordering`	optionnel	Booléen. Si ce paramètre est `true`, il ne sera pas possible à l'utilisateur d'ordonner les colonnes.

Pour déterminer quelles colonnes afficher dans le tableau, il faut utiliser soit le paramètre schema pour indiquer un fichier de schéma JSON qui sera utilisé pour donner le libellé des colonnes (via la description indiquée dans le schéma), soit le paramètre select, où il faut alors indiquer le nom et le libellé des colonnes sous la forme $$.colonne1 AS "Libellé"; $$.colonne2 AS "Libellé 2".

Comme pour load, il est possible d'utiliser des paramètres supplémentaires : cle="valeur". Cela va comparer "valeur" avec la valeur de la clé cle dans le document JSON. C'est l'équivalent d'écrire where="json_extract(document, '$.cle') = 'valeur'".

Voir la documentation de SQLite pour plus de détails sur la syntaxe de json_extract.

Note : un index SQL dynamique est créé pour chaque requête utilisant une clause json_extract.

Chaque itération renverra toujours ces deux variables :

Variable	Valeur
`$key`	Clé unique du document
`$id`	Numéro unique du document

Ainsi que chaque élément du document JSON lui-même.

La section ouvre un tableau HTML et le ferme automatiquement, donc le contenu de la section doit être une ligne de tableau HTML (<tr>).

Dans chaque ligne du tableau il faut respecter l'ordre des colonnes indiqué dans columns ou select. Une dernière colonne est réservée aux boutons d'action : <td class="actions">...</td>.

Attention : une seule liste peut être utilisée dans une même page. Avoir plusieurs listes provoquera des problèmes au niveau du tri des colonnes.

Exemples

Lister le nom, la date et le montant des reçus fiscaux, à partir du schéma JSON suivant :

{
	"$schema": "https://json-schema.org/draft/2020-12/schema",
	"type": "object",
	"properties": {
		"date": {
			"description": "Date d'émission",
			"type": "string",
			"format": "date"
		},
		"adresse": {
			"description": "Adresse du bénéficiaire",
			"type": "string"
		},
		"nom": {
			"description": "Nom du bénéficiaire",
			"type": "string"
		},
		"montant": {
			"description": "Montant",
			"type": "integer",
			"minimum": 0
		}
	}
}

Le code de la section sera alors comme suivant :

{{#list schema="./recu.schema.json" columns="nom, date, montant"}}
	<tr>
		<th>{{$nom}}</th>
		<td>{{$date|date_short}}</td>
		<td>{{$montant|raw|money_currency}}</td>
		<td class="actions">
			{{:linkbutton shape="eye" label="Ouvrir" href="./voir.html?id=%d"|args:$id target="_dialog"}}
		</td>
	</tr>
{{else}}
	<p class="alert block">Aucun reçu n'a été trouvé.</p>
{{/list}}

Si le paramètre columns avait été omis, la colonne adresse aurait également été incluse.

Il est à noter que si l'utilisation directe du schéma est bien pratique, cela ne permet pas de récupérer des informations plus complexes dans la structure JSON, par exemple une sous-clé ou l'application d'une fonction SQL. Dans ce cas il faut obligatoirement utiliser select. Par exemple ici on veut pouvoir afficher l'année, et trier sur l'année par défaut :

{{#list select="$$.nom AS 'Nom du donateur' ; strftime('%Y', $$.date) AS 'Année'" order=2}}
	<tr>
		<th>{{$nom}}</th>
		<td>{{$col2}}</td>
		<td class="actions">
			{{:linkbutton shape="eye" label="Ouvrir" href="./voir.html?id=%d"|args:$id target="_dialog"}}
		</td>
	</tr>
{{else}}
	<p class="alert block">Aucun reçu n'a été trouvé.</p>
{{/list}}

On peut utiliser le nom des clés du document JSON, mais sinon pour faire référence à la valeur d'une colonne spécifique dans la boucle, il faut utiliser son numéro d'ordre (qui commence à 1, pas zéro). Ici on veut afficher l'année, donc la seconde colonne, donc $col1.

Noter aussi l'utilisation du numéro de la colonne de l'année (2) pour le paramètre order, qui avec select doit indiquer le numéro de la colonne à utiliser pour l'ordre.

31 KiB Raw Permalink Blame History Unescape Escape

Sections généralistes

foreach

Itérer sans tableau

restrict

Requêtes SQL

select

Paramètre assign

sql

Sections qui héritent de sql

Membres

users

subscriptions

Comptabilité

accounts

balances

transactions

years

Pour le site web

breadcrumbs

Exemple

pages, articles, categories (sql)

attachments, documents, images (sql)

Sections relatives aux modules

form

load (sql)

Exemples

Utilisation du paramètre each

list

Exemples

31 KiB

Raw Permalink Blame History

Sections qui héritent de `sql`

pages, articles, categories ^(sql)

attachments, documents, images ^(sql)

load ^(sql)

Utilisation du paramètre `each`