CMS flat-file per sviluppatori front-end
<TextField>
Un CMS flat-file per sviluppatori front-end. Scrivi il tuo HTML, segna qualche variabile come modificabile e <TextField> offre al tuo cliente una bacheca per tutto il resto. Nessun database, nessun tema di amministrazione da imparare.
<article>
<h2>{article_title}</h2>
{article_text}
</article>
<TextField> è diverso.
Nessun database, nessuna procedura guidata di installazione. <TextField> salva tutto in semplici file JSON accanto al tuo tema: installarlo significa copiare una cartella, nient’altro.
Mantieni il pieno controllo del markup. Costruisci il tuo tema come vuoi, poi segna una manciata di variabili come modificabili. Il tuo cliente ottiene una bacheca per testi, immagini e blocchi di contenuto, senza mai toccare il tuo codice.
La documentazione qui sotto è breve: in dieci minuti di lettura saprai come funziona <TextField>.
Installazione
Decomprimi l’archivio e copia tutto il suo contenuto (le cartelle core/, panel/, themes/, uploads/ e vendors/ e i file .php) nella radice del tuo progetto, ed è fatta: <TextField> è installato.
<TextField> salva i suoi dati in file .json e non ha bisogno di un database. Funziona con PHP 8.4.
Apri ./panel/ sul tuo server web. La prima volta crei tu stesso l’account amministratore: nome utente, email e password (almeno 8 caratteri). Non c’è nessuna password predefinita da ricordare o da cambiare in seguito.
Per creare il tuo tema, aggiungi in themes/ una cartella con almeno un template index.html, poi sceglila in Impostazioni › Sistema › Tema: il sito cambia tema appena salvi.
Costruire l’albero dei dati
I dati si dividono in 2 tipi di elementi:
- I contenuti statici, cioè campi unici. Esempio: la descrizione del sito.
- Le raccolte, cioè insiemi di elementi. Esempio: un portfolio. Gli elementi di una raccolta condividono gli stessi campi.
Conviene creare un file .json per ogni parte indipendente del sito, così eviti caricamenti inutili. Esempio: il portfolio e il testo di presentazione stanno in home.json, il blog in blog.json.
File, campi e raccolte si creano dal pannello quando la modalità sviluppatore è attiva (Impostazioni › Sistema).
Caricare il tuo tema
Ogni pagina pubblica è un file PHP nella radice. Apri index.php: load(DATAS.'home') carica il file di dati core/data/home.json, e tpl::parse(THEMES.'index') mostra il template index.html del tema attivo. I percorsi si scrivono senza estensione. Sostituisci questi nomi con i tuoi e duplica la riga load() per caricare più di un file di dati.
Per creare un’altra pagina, copia index.php nella stessa cartella, rinominalo, poi cambia i file passati a load() e tpl::parse(). I link tra le pagine richiamano questi file .php della radice.
Nei tuoi template, costruisci i percorsi verso le risorse del tema con {base_url} (l’indirizzo del sito) e {theme} (la cartella del tema attivo, ad es. themes/mytheme/):
<link rel="stylesheet" href="{base_url}/{theme}css/main.css">
{include $theme.'header'}
Così i tuoi percorsi funzionano qualunque sia il nome della cartella del tema, anche con indirizzi riscritti come /blog/article/3.
Inserire i dati
Nel pannello, il nome della variabile corrispondente è indicato sotto ogni campo e ogni raccolta. Richiama una variabile per mostrarne il valore: {about_text}. Questa forma stampa il valore così com’è, HTML incluso, ed è quello che serve per un campo markdown o editor. Per il testo semplice, un attributo HTML o qualsiasi valore digitato da un visitatore, usa {=about_text}, che fa l’escape dell’HTML.
Per le raccolte usa la sintassi seguente:
{item in $articles} <!-- "item" is a prefix to avoid conflicts, name it as you want -->
<h2>{=item_title}</h2>
{item_text}
{end}
Per impostare una condizione, usa questa sintassi:
{if /*PHP syntax here, you have access to all the variables*/}
<!-- content -->
{elseif /*PHP syntax*/}
<!-- content -->
{else}
<!-- content -->
{end}
Qualche altro tag:
{include $theme.'header'}inserisce un altro template, per esempio un’intestazione o un piè di pagina condivisi;{"Read more"}stampa un testo tradotto dal file di lingua del tema (vedi «Sito multilingue»);{?echo date('d/m/Y');}esegue PHP puro;{!stampa una parentesi graffa aperta senza interpretarla, comodo in uno script o un foglio di stile in linea.
<TextField> si basa sul motore Templite, che ha una sua documentazione (breve anche questa) più in basso in questa pagina.
Contenuti aggiuntivi
In un ciclo, ogni elemento riceve automaticamente un numero, {item_id} (il prefisso seguito da _id): la sua posizione nella raccolta, a partire da zero. In sortFlow() e filterFlow(), lo stesso numero si chiama id, cioè $item['id'].
Alcuni tipi di campo creano variabili aggiuntive, che prendono il nome del campo:
- data e ora:
{date_formatted}, nel formato impostato in Impostazioni › Sistema, e le parti{date_Y},{date_m},{date_d},{date_j},{date_F},{date_M}(più_H,_ie_squando è indicata un’ora); - immagine: il valore diventa il percorso
uploads/…, con{photo_width},{photo_height},{photo_alt}e, se esiste una miniatura,{photo_thumb}; - file: il valore diventa il percorso
uploads/…; - tag: un elenco da scorrere,
{t in $item_tags}{t_name}{end}. La raccolta riceve anche l’elenco di tutti i suoi tag con il numero di elementi:{t in $blog_tags}{t_name} ({t_items}){end}.
Ogni pagina riceve inoltre {base_url}, {theme}, {year}, {site_lang} e {site_languages}.
Per vedere tutte le variabili disponibili e il loro contenuto, attiva Impostazioni › Sistema › Tema › «Elenco delle variabili»: l’elenco viene aggiunto come commento in fondo al sorgente di ogni pagina, solo per gli utenti connessi al pannello. Puoi anche togliere il commento alla riga #tpl::fix(); di un file PHP della radice, ma allora qualsiasi visitatore vede l’elenco.
Ordinare e filtrare gli elementi
{prefix in sortFlow($flow, 'id')}...{end} sorts a flow by ascending id.
{prefix in sortFlow($flow, 'date', true)}...{end} sorts a flow by descending date.
{prefix in filterFlow($flow, fn($item) => $item['id'] <= 3)}...{end} selects the items whose id is 3 or less.
{prefix in sortFlow(filterFlow($flow, fn($item) => $item['id'] <= 3), 'id', true)}...{end} filters, then sorts the matching items.
{prefix in filterFlowByTag($flow, 'php')}...{end} keeps the items tagged "php".
Le date vengono confrontate in ordine cronologico. La condizione di filterFlow() si scrive in PHP: $item contiene i campi dell’elemento. filterFlowByTag() legge il campo tags (passa un altro nome come terzo parametro) e non distingue maiuscole e minuscole.
Sito multilingue
Dichiara le lingue del sito in Impostazioni › Sistema › Lingue: la prima è la lingua predefinita. L’opzione «Usa la lingua preferita del browser del visitatore» sceglie automaticamente la lingua di un nuovo visitatore.
I testi tradotti si trovano in una variante del file di dati, home.en.json accanto a home.json. Contiene solo le voci che cambiano: tutto il resto (immagini, date, impostazioni) viene dal file predefinito. Il pannello crea questa variante per te copiando la pagina.
I testi scritti nei template come {"Read more"} si traducono in themes/<theme>/lang/<code>.lang, una riga per testo: "Read more" = "Lire la suite".
Per un selettore di lingua, e per l’attributo <html lang="{site_lang}">:
{l in $site_languages}<a href="{l_url}"{if $l_active} aria-current="true"{end}>{l_label}</a>{end}Pubblicare
Prima di andare online, in Impostazioni › Sistema:
- Disattiva la modalità sviluppatore per congelare l’albero dei dati: il pannello rifiuta allora di creare, rinominare o eliminare file, campi e raccolte.
- Disattiva l’«Elenco delle variabili» e verifica che nessuna riga
tpl::fix();sia scommentata nei file PHP della radice. - Attiva la cache e imposta la sua durata (0 ovunque: ogni copia viene conservata finché la cache non viene svuotata).
La cache serve solo i visitatori anonimi, con una copia per indirizzo e per lingua. Ogni salvataggio nel pannello la svuota, così le tue modifiche compaiono subito. Il pulsante «Pubblica» svuota anche i template compilati e, se l’opzione corrispondente è attiva, le miniature.
Templite
Templite è il motore di template PHP di questo CMS. Pesa circa 5 KB.
Tiene la gestione dei dati fuori dal tuo HTML senza costringerti a imparare un nuovo linguaggio. I tag vengono compilati in PHP semplice, quindi tra il tuo template e la pagina prodotta non c’è quasi nulla.
Variabili, cicli annidati, condizioni, inclusioni, traduzioni, cache delle pagine: c’è quello che ci si aspetta da un motore di template, e resta veloce.
Sintassi leggibile
I tag sono brevi e si inseriscono bene nell’HTML che li circonda: un template si rilegge senza fatica anche un mese dopo.
Blocchi annidati
Annida tutti i cicli che ti servono. Ogni ciclo ha il suo prefisso, così le variabili di due livelli non si scontrano mai.
Condizioni
Le variabili sono disponibili direttamente nel template: una condizione è un’espressione PHP dentro un tag if.
Funzioni PHP
I template accettano PHP nativo: passa una variabile in qualsiasi funzione prima di mostrarla.
Traduzioni
Metti i testi fissi del tuo sito in un file di lingua e Templite li sostituisce in fase di visualizzazione. Un testo senza traduzione viene mostrato così com’è scritto.
Inclusioni
Un template può includerne un altro. Ogni file incluso viene compilato a parte e riutilizzato alla chiamata successiva.
Velocità
Templite si carica in circa 0,1 ms, compila un template corposo in meno di 5 ms e lo mostra in una decina di ms, senza alcuna cache.
Cache delle pagine
I visitatori anonimi ricevono una copia in cache di ogni pagina, una per indirizzo (parametri compresi) e per lingua. Scegli dal pannello quanto dura una copia, e ogni salvataggio svuota la cache.
Codice leggibile
Il codice compilato è PHP semplice che puoi aprire, comodo quando un tag non fa quello che ti aspettavi. Templite non riscrive mai i tuoi percorsi: costruiscili con {base_url} e {theme} e funzioneranno qualunque sia il nome della cartella del tema.
Debug
Attiva l’elenco delle variabili dal pannello e ogni pagina finirà con un commento che elenca tutte le variabili e i blocchi ricevuti. Lo vedono solo gli utenti connessi al pannello.
Ricompilazione automatica
Modifica un template o un file di lingua e Templite lo ricompila alla richiesta successiva. Niente da svuotare a mano.
Leggero come una piuma
Tutto questo sta in circa 5 KB di PHP, commenti esclusi.
Acquista <TextField> CMS
Consulta il contratto di licenza per le condizioni complete. Per qualsiasi domanda su licenze, fatturazione e pagamento sicuro, scrivi a support@textfield.org.
Pagamento unico, nessun abbonamento.
Pro
€199 IVA incl.
Sei un team o uno sviluppatore e crei siti per i tuoi clienti, oppure offri un servizio web in hosting in abbonamento o una intranet.
- Illimitati: siti per i tuoi clienti & progetti
- Illimitati: sviluppatori, domini & sottodomini
- Accesso completo al codice sorgente
- Aggiornamenti gratuiti della versione principale in corso
- Sconto del 50 % sulla prossima versione principale
- Supporto tecnico via email
- Non incluso: ridistribuire <TextField> in un prodotto che vendi — vedi OEM
OEM
€999 IVA incl.
Vendi o distribuisci software, come un modello di design, e consegni <TextField> insieme al codice del tuo prodotto.
- Diritti di ridistribuzione: integra & consegna <TextField> in un prodotto (tema, starter kit, piattaforma) che vendi o distribuisci
- Illimitati: clienti finali che ricevono il tuo prodotto
- Illimitati: sviluppatori, domini & sottodomini
- Accesso completo al codice sorgente
- Aggiornamenti gratuiti della versione principale in corso
- Sconto del 50 % sulla prossima versione principale
- Supporto tecnico via email
Pagamento sicuro con Stripe
- Visa
- Mastercard
- American Express
Non vediamo né conserviamo mai i dati della tua carta. Pagamento unico, ricevuta inviata via email.
Sei già cliente? Scarica la tua versione