CMS flat-file pour les développeurs front-end
<TextField>
Un CMS flat-file pour les développeurs front-end. Écrivez votre HTML, rendez quelques variables éditables, et <TextField> offre à votre client un tableau de bord pour tout le reste. Pas de base de données, pas de thème d'administration à apprendre.
<article>
<h2>{article_title}</h2>
{article_text}
</article>
<TextField> est différent.
Pas de base de données, pas d'assistant d'installation. <TextField> enregistre tout dans de simples fichiers JSON, à côté de votre thème : l'installer, c'est copier un dossier, rien de plus.
Vous gardez le contrôle total du balisage. Construisez votre thème comme vous l'entendez, puis rendez éditables quelques variables. Votre client dispose d'un tableau de bord pour les textes, les images et les blocs de contenu, sans jamais toucher à votre code.
Jetez un œil à la documentation la plus courte du monde : une fois lue, <TextField> deviendra votre meilleur ami.
Installation
Décompressez l'archive et copiez tout son contenu (les dossiers core/, panel/, themes/, uploads/, vendors/ et les fichiers .php) à la racine de votre projet : <TextField> est installé.
<TextField> enregistre ses données dans des fichiers .json et n'a besoin d'aucune base de données. Il fonctionne avec PHP 8.4.
Ouvrez ./panel/ sur votre serveur. La première fois, vous créez vous-même le compte administrateur : identifiant, e-mail et mot de passe (8 caractères minimum). Il n'y a aucun mot de passe par défaut à retenir ou à changer plus tard.
Pour créer votre thème, ajoutez un dossier dans themes/ contenant au moins un gabarit index.html, puis choisissez-le dans Paramètres › Système › Thème : le site change de thème dès l'enregistrement.
Construire l'arbre de données
Les données se répartissent en 2 types d'éléments :
- Les contenus statiques, qui sont des champs uniques. Exemple : la description du site.
- Les flux, qui sont des ensembles d'éléments. Exemple : un portfolio. Les éléments d'un flux partagent les mêmes champs.
Il est conseillé de créer un fichier .json pour chaque partie indépendante de votre site, afin d'éviter des chargements inutiles. Exemple : le portfolio et le texte de présentation sont dans home.json, et le blog dans blog.json.
Les fichiers, champs et flux se créent depuis le panel tant que le mode développeur est activé (Paramètres › Système).
Charger votre thème
Chaque page publique est un fichier PHP à la racine. Ouvrez index.php : load(DATAS.'home') charge le fichier de données core/data/home.json, et tpl::parse(THEMES.'index') affiche le gabarit index.html du thème actif. Les chemins s'écrivent sans extension. Adaptez ces noms aux vôtres, et dupliquez la ligne load() pour charger plusieurs fichiers de données.
Pour créer une page séparée, copiez index.php dans le même dossier, renommez-le, puis changez les fichiers passés à load() et à tpl::parse(). Les liens entre les pages appellent ces fichiers .php racine.
Dans vos gabarits, construisez les chemins vers les ressources du thème avec {base_url} (l'adresse du site) et {theme} (le dossier du thème actif, par exemple themes/montheme/) :
<link rel="stylesheet" href="{base_url}/{theme}css/main.css">
{include $theme.'header'}
Vos chemins restent ainsi valables quel que soit le nom du dossier du thème, et même avec les adresses réécrites comme /blog/article/3.
Injecter les données
Dans le panel, le nom de la variable correspondante s'affiche sous chaque champ et chaque flux. Appelez une variable pour afficher sa valeur : {about_text}. Cette forme affiche la valeur telle quelle, HTML compris : c'est celle qu'il faut pour un champ markdown ou éditeur. Pour un texte simple, un attribut HTML ou toute valeur saisie par un visiteur, utilisez {=about_text}, qui échappe le HTML.
Pour les flux, utilisez la syntaxe suivante :
{item in $articles} <!-- "item" est un préfixe qui évite les conflits, nommez-le comme vous voulez -->
<h2>{=item_title}</h2>
{item_text}
{end}
Pour poser une condition, utilisez cette syntaxe :
{if /*syntaxe PHP ici, toutes les variables sont accessibles*/}
<!-- contenu -->
{elseif /*syntaxe PHP*/}
<!-- contenu -->
{else}
<!-- contenu -->
{end}
D'autres balises complètent le tout :
{include $theme.'header'}insère un autre gabarit, par exemple un en-tête ou un pied de page partagé ;{"Lire la suite"}affiche un texte traduit par le fichier de langue du thème (voir « Site multilingue ») ;{?echo date('d/m/Y');}exécute du PHP brut ;{!affiche une accolade ouvrante sans l'interpréter, utile dans un script ou une feuille de style en ligne.
<TextField> repose sur le moteur Templite, qui a sa propre documentation (courte, elle aussi) plus bas sur cette page.
Contenus supplémentaires
Dans une boucle, chaque élément reçoit automatiquement un numéro, {item_id} (le préfixe suivi de _id) : sa position dans le flux, en partant de zéro. Dans sortFlow() et filterFlow(), ce même numéro s'appelle id, soit $item['id'].
Certains types de champs créent des variables supplémentaires, nommées d'après le champ :
- date et heure :
{date_formatted}, au format réglé dans Paramètres › Système, et les parties{date_Y},{date_m},{date_d},{date_j},{date_F},{date_M}(plus_H,_iet_squand une heure est saisie) ; - image : la valeur devient le chemin
uploads/…, avec{photo_width},{photo_height},{photo_alt}et, quand une miniature existe,{photo_thumb}; - fichier : la valeur devient le chemin
uploads/…; - tags : une liste à parcourir,
{t in $item_tags}{t_name}{end}. Le flux reçoit aussi la liste de tous ses tags avec leur nombre d'éléments :{t in $blog_tags}{t_name} ({t_items}){end}.
Chaque page reçoit en plus {base_url}, {theme}, {year}, {site_lang} et {site_languages}.
Pour voir toutes les variables disponibles et leur contenu, activez Paramètres › Système › Thème › « Liste des variables » : la liste s'ajoute en commentaire tout en bas du code source de chaque page, uniquement pour les utilisateurs connectés au panel. Vous pouvez aussi décommenter la ligne #tpl::fix(); d'un fichier PHP racine, mais la liste est alors visible par tous les visiteurs.
Trier et filtrer les éléments d'un flux
{prefix in sortFlow($flow, 'id')}...{end} trie un flux par id croissant.
{prefix in sortFlow($flow, 'date', true)}...{end} trie un flux par date décroissante.
{prefix in filterFlow($flow, fn($item) => $item['id'] <= 3)}...{end} sélectionne les éléments dont l'id vaut 3 ou moins.
{prefix in sortFlow(filterFlow($flow, fn($item) => $item['id'] <= 3), 'id', true)}...{end} filtre puis trie les éléments retenus.
{prefix in filterFlowByTag($flow, 'php')}...{end} garde les éléments qui portent le tag « php ».
Les dates sont comparées chronologiquement. La condition de filterFlow() s'écrit en PHP : $item contient les champs de l'élément. filterFlowByTag() lit le champ tags (passez un autre nom en troisième paramètre) et ignore la casse.
Site multilingue
Déclarez les langues du site dans Paramètres › Système › Langues : la première est la langue par défaut. L'option « Utiliser la langue préférée du navigateur du visiteur » choisit automatiquement la langue d'un nouveau visiteur.
Les textes traduits vivent dans une variante du fichier de données, home.en.json à côté de home.json. Elle ne contient que les entrées qui changent : tout le reste (images, dates, réglages) vient du fichier par défaut. Le panel crée cette variante pour vous en copiant la page.
Les textes écrits dans les gabarits avec {"Lire la suite"} se traduisent dans themes/<thème>/lang/<code>.lang, une ligne par texte : "Lire la suite" = "Read more".
Pour un sélecteur de langue, et pour l'attribut <html lang="{site_lang}"> :
{l in $site_languages}<a href="{l_url}"{if $l_active} aria-current="true"{end}>{l_label}</a>{end}Publier
Avant la mise en ligne, dans Paramètres › Système :
- Désactivez le mode développeur pour figer l'arbre de données : le panel refuse alors de créer, renommer ou supprimer des fichiers, champs et flux.
- Désactivez « Liste des variables » et vérifiez qu'aucune ligne
tpl::fix();n'est décommentée dans vos fichiers PHP racine. - Activez le cache et réglez sa durée (0 partout : chaque copie est gardée jusqu'au prochain vidage).
Le cache ne sert que les visiteurs anonymes, avec une copie par adresse et par langue. Chaque enregistrement dans le panel le vide, vos modifications sont donc visibles aussitôt. Le bouton « Publier » vide en plus les gabarits compilés, ainsi que les miniatures si l'option correspondante est activée.
Templite
Templite est le moteur de gabarits PHP de ce CMS. Il pèse environ 5 ko.
Il sort le traitement des données de votre HTML sans vous obliger à apprendre un nouveau langage. Les balises sont compilées en PHP simple : entre votre gabarit et la page produite, il n'y a presque rien.
Variables, boucles imbriquées, conditions, inclusions, traductions, cache des pages : on y trouve ce qu'on attend d'un moteur de gabarits, et il reste rapide.
Syntaxe lisible
Les balises sont courtes et se fondent dans le HTML qui les entoure : un gabarit reste facile à relire un mois plus tard.
Blocs imbriqués
Imbriquez autant de boucles que nécessaire. Chaque boucle a son propre préfixe, les variables de deux niveaux ne se mélangent jamais.
Conditions
Les variables sont disponibles directement dans le gabarit : une condition, c'est une expression PHP dans une balise if.
Fonctions PHP
Les gabarits acceptent le PHP natif : passez une variable dans n'importe quelle fonction avant de l'afficher.
Traductions
Mettez les textes fixes de votre site dans un fichier de langue, Templite les remplace à l'affichage. Un texte sans traduction s'affiche tel qu'il est écrit.
Inclusions
Un gabarit peut en inclure un autre. Chaque fichier inclus est compilé à part et réutilisé à l'appel suivant.
Rapidité
Templite se charge en 0,1 ms environ, compile un gros gabarit en moins de 5 ms et l'affiche en une dizaine de ms, sans aucun cache.
Cache des pages
Les visiteurs anonymes reçoivent une copie en cache de chaque page, une par adresse (paramètres compris) et par langue. Vous choisissez sa durée de vie dans le panel, et chaque enregistrement vide le cache.
Code compilé lisible
Le code compilé est du PHP simple que vous pouvez ouvrir, pratique quand une balise ne fait pas ce que vous attendiez. Templite ne réécrit jamais vos chemins : construisez-les avec {base_url} et {theme}, ils fonctionnent quel que soit le nom du dossier du thème.
Débogage
Activez la liste des variables dans le panel : chaque page se termine par un commentaire qui liste toutes les variables et tous les blocs reçus. Seuls les utilisateurs connectés au panel la voient.
Recompilation automatique
Modifiez un gabarit ou un fichier de langue, Templite le recompile à la requête suivante. Rien à vider à la main.
Léger comme une plume
Tout ce qui précède tient dans environ 5 ko de PHP, commentaires retirés.
Acheter <TextField> CMS
Consultez le contrat de licence pour les conditions complètes. Pour toute question sur les licences, la facturation et le paiement sécurisé, écrivez à support@textfield.org.
Paiement unique, pas d’abonnement.
Pro
€199 TTC
Vous êtes une équipe ou un développeur et créez des sites pour vos clients, ou proposez un service web hébergé par abonnement ou un intranet.
- Illimité : sites pour vos propres clients & projets
- Illimité : développeurs, domaines & sous-domaines
- Accès complet au code source
- Mises à jour gratuites de la version majeure en cours
- 50 % de remise sur la prochaine version majeure
- Support technique par e-mail
- Non inclus : redistribuer <TextField> dans un produit que vous vendez — voir OEM
OEM
€999 TTC
Vous vendez ou distribuez un logiciel, comme un modèle de design, et livrez <TextField> avec le code de votre produit.
- Droits de redistribution : intégrez & livrez <TextField> dans un produit (thème, kit de démarrage, plateforme) que vous vendez ou distribuez
- Illimité : clients finaux recevant votre produit
- Illimité : développeurs, domaines & sous-domaines
- Accès complet au code source
- Mises à jour gratuites de la version majeure en cours
- 50 % de remise sur la prochaine version majeure
- Support technique par e-mail
Paiement sécurisé par Stripe
- Visa
- Mastercard
- American Express
Nous ne voyons ni ne stockons vos données de carte bancaire. Paiement unique, reçu envoyé par e-mail.
Déjà client ? Téléchargez votre version