Il est fréquent d'utiliser des morceaux de texte ou de code. Cette action vous permet :
- de définir un nom et le contenu correspondant
- de modifier le contenu pour un nom existant
- d'avoir la liste des noms et contenu de snippets existants
- de récupérer le contenu d'un snippet comme argument d'une autre action ou simplement comme texte
{up snippet=foo} // charge un fichier up/snippet/foo.html{up snippet=foo}texte{/up snippet} // écrit le texte dans le fichier up/snippet/foo.snippet{up snippet} // affiche la liste de tous les fichiers du dossier up/snippet/{up snippet=* | delete} // supprime tous les snippets- snippet = *: nom du fichier à charger/créer. vide ou mask pour list. ex: filter*
- strip-tags: supprime toutes les balises HTML
- delete: supprime le ou les fichiers passées comme argument principal
- id:
- dir-base = up/snippet: dossier pour les snippets. Utilisez custom/prefs.ini
Créer un snippet
Avant de pouvoir les lire, il faut les créer !
{up snippet=exemple1}Ceci est le premier exemple{/up snippet}Le shortcode ci-dessus va créer un fichier exemple1.txt avec le contenu entre les shortcodes et afficher un compte rendu
Ceci est le <strong>premier exemple</strong>Attention, tout le code HTML entre les shortcodes sera sauvegardé.
L'option strip-tags permet de conserver uniquement le contenu sans les balises HTML
Pour modifier un snippet, il suffit d'utiliser le même nom avec un autre contenu.
Par défaut, les snippets sont dans le dossier up/snippet en racine de votre site.
L'option dir-base permet de le modifier. A définir dans le custom/prefs.ini de l'action
Liste des snippets
Un shortcode sans argument retourne la liste des snippets enregistrés sur votre site.
Pour limiter la liste, vous pouvez mettre un joker comme argument.
Le shortcode ci-dessous retourne uniquement les snippets dont le nom commence par un a
{up snippet=a*}Récupérer un snippet
Pour lire un snippet, il suffit d'indiquer son nom.
Le contenu récupéré pourra être affiché directement ou passé comme argument pour une autre action.
Le contenu peut contenir du BBCode qui sera converti en HTML.
Supprimer des snippets
Pour supprimer un ou plusieurs snippets, il suffit d'ajouter l'option delete
Il est obligatoire d'indiquer le nom du snippet ou un masque comme argument de snippet.
Exemple pour supprimer tous les snippets :
{up snippet=* | delete}La liste des snippets supprimés sera affichée comme compte-rendu
span (1) upactionslist (1) div (1) jcontent-info (1)