﻿=== Talariasoft ShopLite ===
Colaboradores: talariasoft
Etiquetas: ecommerce, pagos, stripe, paypal, bizum, catálogo, ligero
Requiere al menos: 5.8
Probado hasta: 6.8
Requiere PHP: 7.4
Etiqueta estable: 1.0
Licencia: GPLv2 o posterior
URI de licencia: https://www.gnu.org/licenses/gpl-2.0.html

Plugin de comercio electrónico ligero con catálogo, carrito e integración de pagos mediante Stripe, Bizum y PayPal. Desarrollado por Talariasoft.

== Descripción ==

ShopLite es una solución ligera de comercio electrónico para WordPress que permite crear tiendas completas sin la complejidad de grandes frameworks.  
Incluye gestión de productos, visualización de catálogos, manejo del carrito e integración con múltiples métodos de pago en un solo plugin optimizado.

**Características principales:**
- Catálogo de productos con imágenes, precios y descripciones.  
- Importación masiva de productos mediante archivos CSV.  
- Sistema de carrito y checkout con cálculo automático del total.  
- Integración con **Stripe**, **Bizum** y **PayPal**.  
- Arquitectura basada en shortcodes para un diseño flexible.  
- Uso mínimo de recursos — optimizado para velocidad y estabilidad.  
- 100% compatible con la mayoría de los temas de WordPress.

ShopLite es ideal para autónomos, pequeñas empresas o emprendedores que necesitan un sistema de venta en línea simple pero profesional.

== Instalación ==

1. Sube los archivos del plugin al directorio `/wp-content/plugins/shoplite`, o instala el archivo ZIP mediante el instalador de plugins de WordPress.  
2. Activa el plugin desde el menú **Plugins** de WordPress.  
3. Crea una página para mostrar el catálogo y el carrito.  
4. Añade los shortcodes recomendados en este orden:  
   `[shoplite_search]`, `[shoplite_catalogo per_page=4]`, `[tienda_catalogo]`, `[tienda_carrito]`.  
5. Configura tus claves de pago para Stripe, Bizum y PayPal en los ajustes de ShopLite.

== Shortcodes ==

ShopLite incluye varios shortcodes para mostrar los diferentes componentes de la tienda:

- `[shoplite_search]` → Muestra la barra de búsqueda de productos.  
- `[shoplite_catalogo per_page=4]` → Muestra el catálogo de productos.  
   El número indicado en *per_page* determina cuántos productos se muestran por página,  
   y puede ajustarse libremente según las preferencias de diseño y rendimiento del usuario.  
   Ejemplo: `[shoplite_catalogo per_page=8]` mostrará ocho productos por página.  
- `[tienda_catalogo]` → Disposición alternativa del catálogo.  
- `[tienda_carrito]` → Muestra el carrito de compras del usuario.

El orden de los shortcodes es importante para el correcto funcionamiento y sincronización del catálogo y el carrito.

== Importación de productos mediante CSV ==

Los productos pueden importarse de forma masiva mediante un archivo CSV en formato UTF-8 con las siguientes cabeceras:

`title;sku;price;category;image_url;stock;description;gallery`

Ejemplo de fila:
`Croissant de mantequilla;BOL-0003;1.50;Bollería;https://example.com/img/croissant.jpg;150;Hojaldre 100% mantequilla;`

**Proceso de importación:**
1. Ve a **ShopLite → Importar (CSV)** en el panel de administración de WordPress.  
2. Selecciona tu archivo CSV y haz clic en *Importar*.  
3. Activa la opción *Actualizar si existe el mismo SKU* para evitar duplicados.  
4. Espera hasta que aparezca el mensaje de confirmación.

“Requisitos mínimos del producto”

Precio (price): obligatorio. Los productos sin precio o con precio 0 no se muestran en el catálogo.

SKU: muy recomendable. Se usa para evitar duplicados al importar y para actualizaciones fiables.

Título (title): obligatorio.

Stock: si se deja vacío, el sistema asume stock disponible (según configuración).

Imagen: recomendable para una presentación correcta.

CSV correcto (cabeceras en este orden):
title;sku;price;category;image_url;stock;description;gallery

Ejemplo válido:
Pan de centeno;PAN-001;2.50;Panadería;https://ejemplo.com/img/centeno.jpg;120;Pan artesanal de centeno;

Buenas prácticas al importar:

Marca “Actualizar si existe el mismo SKU” para evitar duplicados.

Revisa que el separador sea ; y la codificación UTF-8 sin BOM.

Si tras importar no ves los productos, limpia caché/cookies y confirma que estén en publish.

Nota: Si alguna vez necesitas mostrar artículos sin precio, decide un comportamiento explícito (p. ej., texto “Consultar precio”) y ajusta el catálogo en consecuencia.

== Configuración de pagos ==

**Stripe:**  
Introduce tu *Publishable Key* y *Secret Key* en los ajustes de ShopLite. Es obligatorio disponer de HTTPS.

**Bizum:**  
Disponible a través de Stripe para cuentas empresariales registradas en España.  
Si no está disponible en tu país, el botón permanecerá inactivo.

**PayPal:**  
Introduce el correo electrónico de tu cuenta PayPal Business.  
Realiza pruebas con el modo *Sandbox* antes de activar los pagos reales.

== Personalización ==

ShopLite hereda la mayoría de los estilos del tema activo de WordPress.  
Para personalizar la apariencia:
- Añade reglas CSS en la hoja de estilos de tu tema.  
- Modifica las plantillas ubicadas en `/templates` (evita editar los archivos principales).  

== Solución de problemas ==

- Los productos no aparecen → Comprueba el orden de los shortcodes y que el estado sea *publish*.  
- Error en la importación CSV → Verifica la codificación UTF-8 y las cabeceras obligatorias.  
- Error en el pago → Comprueba la conexión HTTPS y la validez de las claves API.

== Documentación ==

Las guías completas de usuario y desarrollador se incluyen en:
- `/docs/es/Guía_de_uso_y_desarrollo_ShopLite_v1.pdf`
- `/docs/en/ShopLite_User_and_Developer_Guide_v1.pdf`

== Registro de cambios ==

= 1.0 =
Versión inicial de Talariasoft ShopLite Checkout.  
- Sistema de catálogo y carrito de productos.  
- Integraciones con Stripe, Bizum y PayPal.  
- Importador de productos mediante CSV.  
- Control de diseño mediante shortcodes.

== Licencia ==

Este plugin se distribuye bajo la **Licencia Pública General GNU v2 o posterior**.  
Puedes modificarlo y redistribuirlo bajo los mismos términos de la licencia.

© 2025 Talariasoft. Todos los derechos reservados.  
https://talariasoft.com
