KaisarCode

PrestaShop Base Theme

License: AFL-3.0

PSTheme es un tema base minimalista para PrestaShop 8, pensado como punto de partida limpio para el desarrollo de temas personalizados. Implementa solo la estructura y plantillas esenciales requeridas por PrestaShop, sin estilos innecesarios ni complejidad, para que puedas construir tu propio diseño desde cero.

Descárgalo desde GitHub

https://github.com/kaisarcode/pstheme

Características

  • Base minimalista: Sin estilos ni scripts innecesarios, ideal para empezar desde cero.
  • Compatibilidad total: 100% compatible con PrestaShop 8.x.
  • Estructura estándar: Incluye todas las plantillas y archivos requeridos por PrestaShop.
  • Plantillas esenciales: Productos, checkout, cuenta de cliente, páginas de error y más.
  • Código limpio y mantenible: Fácil de entender y personalizar.
  • Preparado para herencia: Ideal para crear child themes y mantener tus personalizaciones separadas.

Requisitos previos

  • PrestaShop 8.x
  • PHP 7.4 o superior

Comenzando

1. Clona el repositorio

git clone git@github.com:kaisarcode/pstheme.git

2. Copia la carpeta del tema

  • Copia la carpeta pstheme al directorio /themes de tu instalación de PrestaShop.

3. Activa el tema

  1. Ingresa al back office de PrestaShop.
  2. Ve a Diseño > Tema & Logo.
  3. Haz clic en "Añadir nuevo tema" y selecciona pstheme.
  4. Actívalo como tema principal.

Flujo de trabajo recomendado: crea un child theme

La mejor práctica para personalizar tu tienda es crear un child theme basado en PSTheme. Así, puedes actualizar el tema base sin perder tus cambios y mantener tu código organizado.

¿Cómo crear un child theme?

  1. Crea la carpeta del tema hijo En /themes, crea una carpeta, por ejemplo pstheme_child.

  2. Crea el archivo theme.yml Dentro de pstheme_child, agrega un archivo theme.yml con este contenido:

    parent: pstheme
name: pstheme_child
display_name: PSTheme Child
version: 1.0.0
author:
  name: KaisarCode
  email: kaisar@kaisarcode.com
  url: https://kaisarcode.com
assets:
  use_parent_assets: true

  3. Agrega una imagen de previsualización Coloca un preview.png (100x100 px) en la raíz del tema hijo.

  4. Sobrescribe solo lo necesario Añade solo los archivos que quieras modificar (por ejemplo, plantillas en templates/, estilos en assets/css/, etc.). Para extender plantillas, usa {extends file='parent:...'} en tus archivos .tpl.

  5. Activa el tema hijo Desde el back office, ve a Diseño > Tema & Logo y selecciona tu child theme.

Personalización

  • Modifica o añade solo los archivos necesarios en tu child theme.
  • Agrega tus propios estilos, scripts e imágenes en las carpetas correspondientes.
  • Aprovecha la herencia de PrestaShop para mantener tu código limpio y seguro ante futuras actualizaciones.

Solución de problemas

  • El tema no aparece en el back office: Verifica que la carpeta esté en /themes y que el archivo theme.yml sea válido.
  • No se aplican los cambios: Limpia la caché de PrestaShop y asegúrate de estar editando el archivo correcto en el child theme.
  • Errores de plantilla: Usa la sintaxis {extends file='parent:...'} para extender plantillas del tema base.

Licencia

Este proyecto está licenciado bajo Academic Free License (AFL 3.0).

Contribuciones

Tus aportes son bienvenidos. Puedes:

  • Reportar bugs
  • Sugerir mejoras
  • Enviar pull requests

Tags: PrestaShop PHP Theme Ecommerce Development WebDevelopment OpenSource Boilerplate PSTheme ChildTheme PrestaShopTheme

Invítame un café en cafecito.app