CMS flat-file para desarrolladores front-end
<TextField>
Un CMS flat-file para desarrolladores front-end. Escriba su HTML, marque unas cuantas variables como editables y <TextField> le da a su cliente un panel para todo lo demás. Sin base de datos, sin tema de administración que aprender.
<article>
<h2>{article_title}</h2>
{article_text}
</article>
<TextField> es diferente.
Sin base de datos, sin asistente de instalación. <TextField> guarda todo en simples archivos JSON junto a su tema: instalarlo consiste en copiar una carpeta, nada más.
Usted conserva el control total del marcado. Construya su tema como quiera y después marque unas cuantas variables como editables. Su cliente obtiene un panel para textos, imágenes y bloques de contenido, sin tocar nunca su código.
La documentación que sigue es corta: en diez minutos de lectura sabrá cómo funciona <TextField>.
Instalación
Descomprima el archivo y copie todo su contenido (las carpetas core/, panel/, themes/, uploads/ y vendors/ y los archivos .php) en la raíz de su proyecto, y listo: <TextField> está instalado.
<TextField> guarda sus datos en archivos .json y no necesita base de datos. Funciona con PHP 8.4.
Abra ./panel/ en su servidor web. La primera vez, usted mismo crea la cuenta de administrador: nombre de usuario, correo electrónico y contraseña (8 caracteres como mínimo). No hay contraseña predeterminada que recordar o cambiar más tarde.
Para crear su tema, añada una carpeta en themes/ con al menos una plantilla index.html y selecciónela en Ajustes › Sistema › Tema: el sitio cambia de tema en cuanto guarda.
Construir el árbol de datos
Los datos se dividen en 2 tipos de elementos:
- Los contenidos estáticos, que son campos únicos. Ejemplo: la descripción del sitio web.
- Las colecciones, que son conjuntos de elementos. Ejemplo: un portfolio. Los elementos de una colección comparten los mismos campos.
Conviene crear un archivo .json para cada parte independiente de su sitio web y así evitar cargas inútiles. Ejemplo: el portfolio y el texto de presentación se guardan en home.json, y el blog en blog.json.
Los archivos, campos y colecciones se crean desde el panel mientras el modo desarrollador está activado (Ajustes › Sistema).
Cargar su tema
Cada página pública es un archivo PHP en la raíz. Abra index.php: load(DATAS.'home') carga el archivo de datos core/data/home.json, y tpl::parse(THEMES.'index') muestra la plantilla index.html del tema activo. Las rutas se escriben sin la extensión. Cambie estos nombres por los suyos y duplique la línea load() para cargar más de un archivo de datos.
Para crear otra página, copie index.php en la misma carpeta, cámbiele el nombre y modifique los archivos pasados a load() y tpl::parse(). Los enlaces entre páginas llaman a estos archivos .php de la raíz.
En sus plantillas, construya las rutas a los recursos del tema con {base_url} (la dirección del sitio) y {theme} (la carpeta del tema activo, p. ej. themes/mytheme/):
<link rel="stylesheet" href="{base_url}/{theme}css/main.css">
{include $theme.'header'}
Así sus rutas siguen funcionando se llame como se llame la carpeta del tema, incluso con direcciones reescritas como /blog/article/3.
Insertar los datos
En el panel, el nombre de la variable correspondiente aparece bajo cada campo y cada colección. Llame a una variable para mostrar su valor: {about_text}. Esta forma muestra el valor tal cual, HTML incluido, que es lo que necesita para un campo markdown o de editor. Para texto plano, un atributo HTML o cualquier valor escrito por un visitante, use {=about_text}, que escapa el HTML.
Use la siguiente sintaxis para las colecciones:
{item in $articles} <!-- "item" is a prefix to avoid conflicts, name it as you want -->
<h2>{=item_title}</h2>
{item_text}
{end}
Para establecer una condición, use esta sintaxis:
{if /*PHP syntax here, you have access to all the variables*/}
<!-- content -->
{elseif /*PHP syntax*/}
<!-- content -->
{else}
<!-- content -->
{end}
Algunas etiquetas más:
{include $theme.'header'}inserta otra plantilla, como una cabecera o un pie de página compartidos;{"Read more"}muestra un texto traducido por el archivo de idioma del tema (véase «Sitio multilingüe»);{?echo date('d/m/Y');}ejecuta PHP sin procesar;{!muestra una llave de apertura sin interpretarla, útil en un script o una hoja de estilos en línea.
<TextField> funciona con el motor Templite, que tiene su propia documentación (también corta) más abajo en esta página.
Contenidos adicionales
En un bucle, cada elemento recibe automáticamente un número, {item_id} (el prefijo seguido de _id): su posición en la colección, empezando por cero. En sortFlow() y filterFlow(), ese mismo número se llama id, es decir $item['id'].
Algunos tipos de campo crean variables adicionales, con el nombre del campo:
- fecha y hora:
{date_formatted}, con el formato definido en Ajustes › Sistema, y las partes{date_Y},{date_m},{date_d},{date_j},{date_F},{date_M}(más_H,_iy_scuando se indica una hora); - imagen: el valor pasa a ser la ruta
uploads/…, con{photo_width},{photo_height},{photo_alt}y, cuando existe una miniatura,{photo_thumb}; - archivo: el valor pasa a ser la ruta
uploads/…; - etiquetas: una lista que recorrer,
{t in $item_tags}{t_name}{end}. La colección también recibe la lista de todas sus etiquetas con su número de elementos:{t in $blog_tags}{t_name} ({t_items}){end}.
Cada página recibe además {base_url}, {theme}, {year}, {site_lang} y {site_languages}.
Para ver todas las variables disponibles y su contenido, active Ajustes › Sistema › Tema › «Lista de variables»: la lista se añade como comentario al final del código fuente de cada página, solo para los usuarios conectados al panel. También puede quitar el comentario de la línea #tpl::fix(); de un archivo PHP de la raíz, pero entonces cualquier visitante puede ver la lista.
Ordenar y filtrar los elementos
{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".
Las fechas se comparan cronológicamente. La condición de filterFlow() se escribe en PHP: $item contiene los campos del elemento. filterFlowByTag() lee el campo tags (indique otro nombre como tercer parámetro) y no distingue mayúsculas de minúsculas.
Sitio multilingüe
Declare los idiomas del sitio en Ajustes › Sistema › Idiomas: el primero es el idioma predeterminado. La opción «Usar el idioma preferido del navegador del visitante» elige automáticamente el idioma de un nuevo visitante.
Los textos traducidos están en una variante del archivo de datos, home.en.json junto a home.json. Solo contiene las entradas que cambian: todo lo demás (imágenes, fechas, ajustes) viene del archivo predeterminado. El panel crea esta variante por usted copiando la página.
Los textos escritos en las plantillas como {"Read more"} se traducen en themes/<theme>/lang/<code>.lang, una línea por texto: "Read more" = "Lire la suite".
Para un selector de idioma, y para el atributo <html lang="{site_lang}">:
{l in $site_languages}<a href="{l_url}"{if $l_active} aria-current="true"{end}>{l_label}</a>{end}Publicar
Antes de publicar el sitio, en Ajustes › Sistema:
- Desactive el modo desarrollador para congelar el árbol de datos: el panel se niega entonces a crear, renombrar o eliminar archivos, campos y colecciones.
- Desactive la «Lista de variables» y compruebe que ninguna línea
tpl::fix();está sin comentar en sus archivos PHP de la raíz. - Active la caché y defina su duración (0 en todos los campos: cada copia se conserva hasta que se vacía la caché).
La caché solo atiende a los visitantes anónimos, con una copia por dirección y por idioma. Cada vez que guarda en el panel se vacía, así que sus cambios aparecen al instante. El botón «Publicar» también vacía las plantillas compiladas y, si la opción correspondiente está activada, las miniaturas.
Templite
Templite es el motor de plantillas PHP de este CMS. Pesa unos 5 KB.
Saca el tratamiento de los datos de su HTML sin obligarle a aprender un lenguaje nuevo. Las etiquetas se compilan a PHP simple, así que entre su plantilla y la página resultante no hay casi nada.
Variables, bucles anidados, condiciones, inclusiones, traducciones, caché de páginas: tiene lo que se espera de un motor de plantillas, y sigue siendo rápido.
Sintaxis legible
Las etiquetas son cortas y encajan con el HTML que las rodea: una plantilla se sigue leyendo bien un mes después.
Bloques anidados
Anide tantos bucles como necesite. Cada bucle tiene su propio prefijo, así que las variables de dos niveles nunca chocan.
Condiciones
Las variables están disponibles directamente en la plantilla: una condición es una expresión PHP dentro de una etiqueta if.
Funciones PHP
Las plantillas aceptan PHP nativo: pase una variable por cualquier función antes de mostrarla.
Traducciones
Ponga los textos fijos de su sitio en un archivo de idioma y Templite los sustituye al mostrarlos. Un texto sin traducción se muestra tal como está escrito.
Inclusiones
Una plantilla puede incluir otra. Cada archivo incluido se compila por separado y se reutiliza en la siguiente llamada.
Rapidez
Templite se carga en unos 0,1 ms, compila una plantilla grande en menos de 5 ms y la muestra en unos 10 ms, sin ninguna caché.
Caché de páginas
Los visitantes anónimos reciben una copia en caché de cada página, una por dirección (parámetros incluidos) y por idioma. Usted elige en el panel cuánto dura una copia, y cada guardado vacía la caché.
Código legible
El código compilado es PHP simple que puede abrir, algo útil cuando una etiqueta no hace lo que esperaba. Templite nunca reescribe sus rutas: constrúyalas con {base_url} y {theme} y funcionarán se llame como se llame la carpeta del tema.
Depuración
Active la lista de variables en el panel y cada página terminará con un comentario que enumera todas las variables y bloques recibidos. Solo la ven los usuarios conectados al panel.
Recompilación automática
Modifique una plantilla o un archivo de idioma y Templite lo recompila en la siguiente petición. No hay nada que vaciar a mano.
Ligero como una pluma
Todo lo anterior cabe en unos 5 KB de PHP, sin contar los comentarios.
Comprar <TextField> CMS
Consulte el contrato de licencia para conocer las condiciones completas. Para cualquier pregunta sobre licencias, facturación y pago seguro, escriba a support@textfield.org.
Pago único, sin suscripción.
Pro
€199 IVA incl.
Es un equipo o un desarrollador y crea sitios para sus clientes, u ofrece un servicio web alojado por suscripción o una intranet.
- Ilimitado: sitios para sus propios clientes & proyectos
- Ilimitado: desarrolladores, dominios & subdominios
- Acceso completo al código fuente
- Actualizaciones gratuitas de la versión principal actual
- 50 % de descuento en la próxima versión principal
- Soporte técnico por correo electrónico
- No incluido: redistribuir <TextField> en un producto que usted vende — véase OEM
OEM
€999 IVA incl.
Vende o distribuye software, como una plantilla de diseño, y entrega <TextField> con el código de su producto.
- Derechos de redistribución: integre & entregue <TextField> en un producto (tema, kit de inicio, plataforma) que vende o distribuye
- Ilimitado: clientes finales que reciben su producto
- Ilimitado: desarrolladores, dominios & subdominios
- Acceso completo al código fuente
- Actualizaciones gratuitas de la versión principal actual
- 50 % de descuento en la próxima versión principal
- Soporte técnico por correo electrónico
Pago seguro con Stripe
- Visa
- Mastercard
- American Express
Nunca vemos ni guardamos los datos de su tarjeta. Pago único, recibo enviado por correo electrónico.
¿Ya es cliente? Descargue su versión