﻿=== Talariasoft ShopLite ===
Contributors: Talariasoft
Tags: ecommerce, payments, stripe, paypal, bizum, catalog, lightweight
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight e-commerce plugin with catalog, cart, and integrated payments via Stripe, Bizum, and PayPal. Developed by Talariasoft.

== Description ==

ShopLite is a lightweight e-commerce solution for WordPress that allows you to create complete online stores without the complexity of large frameworks.  
It includes product management, catalog display, cart handling, and multiple payment integrations in a single streamlined plugin.

**Main features:**
- Product catalog with images, prices, and descriptions.
- CSV import for bulk product management.
- Cart and checkout system with automatic total calculation.
- Integration with **Stripe**, **Bizum**, and **PayPal**.
- Shortcode-based architecture for flexible page design.
- Minimal resource usage — optimized for speed and stability.
- 100% compatible with most WordPress themes.

ShopLite is ideal for freelancers, small businesses, or entrepreneurs who need a simple yet professional e-commerce system.


== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/shoplite` directory, or install the ZIP file via the WordPress plugin installer.  
2. Activate the plugin through the **Plugins** menu in WordPress.  
3. Create a page to display your catalog and cart.  
4. Add the recommended shortcodes in this order:
   `[shoplite_search]`, `[shoplite_catalogo per_page=4]`, `[tienda_catalogo]`, `[tienda_carrito]`.  
5. Configure your payment keys for Stripe, Bizum, and PayPal in the ShopLite settings.

== Shortcodes ==

ShopLite provides several shortcodes for displaying store components:

- `[shoplite_search]` → Displays the product search bar.  
- `[shoplite_catalogo per_page=4]` → Displays the product catalog.  
   The number after *per_page* determines how many products are shown per page,  
   and can be freely adjusted by the user depending on design preference and performance.  
   Example: `[shoplite_catalogo per_page=8]` will display eight products per page.  
- `[tienda_catalogo]` → Alternative layout for catalog display.  
- `[tienda_carrito]` → Displays the user’s shopping cart.

The order of the shortcodes is important for correct catalog and cart synchronization.


== Product Import via CSV ==

Products can be imported in bulk using a UTF-8 CSV file with the following headers:

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

Example row:
`Croissant de mantequilla;BOL-0003;1.50;Bakery;https://example.com/img/croissant.jpg;150;100% butter puff pastry;`

Import process:
1. Go to **ShopLite → Import (CSV)** in the WordPress admin panel.
2. Select your CSV file and click *Import*.
3. Optionally enable *Update if same SKU exists*.
4. Wait until the confirmation message appears.

“Minimum product requirements”

Price: required. Items with empty price or price 0 are not displayed in the catalog.

SKU: strongly recommended. It prevents duplicates during import and enables reliable updates.

Title: required.

Stock: if empty, the system assumes available stock (depending on configuration).

Image: recommended for proper presentation.

CSV headers (exact order):
title;sku;price;category;image_url;stock;description;gallery

Valid example:
Rye Bread;PAN-001;2.50;Bakery;https://example.com/img/rye.jpg;120;Artisanal rye bread;

Import best practices:

Enable “Update if same SKU exists” to avoid duplicates.

Ensure ; as delimiter and UTF-8 (no BOM) encoding.

If items don’t appear after import, clear cache/cookies and confirm publish status.

Note: If you ever need to display items without a price, define explicit behavior (e.g., “Contact us for price”) and adjust the catalog accordingly.

== Payment Configuration ==

**Stripe:**  
Enter your *Publishable Key* and *Secret Key* in the ShopLite settings. HTTPS is required.

**Bizum:**  
Available through Stripe for Spanish Business accounts. If unavailable, the button remains inactive.

**PayPal:**  
Enter your PayPal Business email. Test transactions with Sandbox mode before going live.

== Customization ==

ShopLite inherits styles from your active WordPress theme.  
To customize appearance:
- Add CSS overrides in your theme stylesheet.  
- Modify templates inside `/templates` (not core files).  

== Troubleshooting ==

- Products not appearing → Check shortcode order and publish status.  
- CSV import fails → Verify UTF-8 encoding and correct headers.  
- Payment errors → Confirm HTTPS and API key validity.


== Documentation ==

Complete user and developer guides are included inside:
- `/docs/es/Guía_de_uso_y_desarrollo_ShopLite_v1.pdf`
- `/docs/en/ShopLite_User_and_Developer_Guide_v1.pdf`

== Changelog ==

= 1.0 =
Initial release of Talariasoft ShopLite Checkout.
- Core product catalog and cart system.
- Stripe, Bizum, and PayPal integrations.
- CSV importer for products.
- Shortcode-based layout control.

== License ==

This plugin is licensed under the GNU General Public License v2 or later.  
You may modify and redistribute it under the same license.

© 2025 Talariasoft. All rights reserved.
https://talariasoft.com

