Estructura

FlowKit organiza su código para que tus personalizaciones no se mezclen con el core del theme. Las actualizaciones automáticas solo tocan el core.

Árbol de carpetas

flowkit/
├── functions.php         Carga el theme y registra hooks
├── style.css             Cabecera del child theme
├── theme.json            Ajustes del editor
├── admin/                Panel de administración propio
│   └── panels/           Pestañas: Elementos, Assets, Ecommerce, Layers, Tailwind
├── assets/               CSS y JS compilados
├── inc/                  Clases core: asset loader, logger, licencia
├── library/              Código funcional reutilizable
│   ├── elements/         Elementos personalizados de Bricks
│   ├── queries/          Queries registradas para Bricks
│   ├── woocommerce/      Integración WooCommerce
│   ├── tailwind/         Loader de temas Tailwind
│   └── custom/           Código específico de tu proyecto
└── woocommerce/          Templates override de WooCommerce

Qué va dónde

CarpetaQué poner ahí
library/custom/Tu código. PHP, elementos propios, hooks del proyecto. No se sobrescribe.
library/elements/Elementos core de FlowKit. No tocar.
library/woocommerce/Integración WooCommerce core. No tocar.
woocommerce/Templates WooCommerce override. Copiar a library/custom/woocommerce/ para customizar.

Carga automática de library/custom/

FlowKit escanea library/custom/ al cargar el theme y carga automáticamente todos los archivos PHP que encuentre dentro, sin necesidad de que los añadas a functions.php.

// library/custom/mi-shortcode.php

add_shortcode('saludo', function ($atts) {
    $atts = shortcode_atts(['nombre' => 'mundo'], $atts);
    return sprintf('<p>Hola, %s</p>', esc_html($atts['nombre']));
});

Elementos Bricks propios del proyecto

Si registras un elemento propio, ponlo en library/custom/elements/. FlowKit lo detecta y lo expone en el editor de Bricks.

Evita editar el core

Cualquier archivo fuera de library/custom/ se sobrescribe en la siguiente actualización. Si necesitas modificar un archivo core, copia su lógica a library/custom/ o abre una issue en el repositorio.

Flujo recomendado para agencias

  1. Fork o clone del repositorio de FlowKit en GitHub (requiere licencia).
  2. Branch por proyecto, con library/custom/ gestionado en Git.
  3. Despliegue por deploy push o ZIP.
  4. Actualizaciones del core se mergean como upstream.