first commit

2025-05-30 03:09:08 -06:00
parent 99d54737de
commit 1932509066
6221 changed files with 298434 additions and 212 deletions
--- a/README.md
+++ b/README.md
@ -1,133 +1,139 @@
-# 🎨 Laravel Vuexy Website Layout Porto - Vuexy Website Admin
+# 🧩 Laravel Vuexy Website Layout: Porto

 <p align="center">
-    <a href="https://koneko.mx" target="_blank"> <img src="https://git.koneko.mx/Koneko-ST/koneko-st/raw/branch/main/logo-images/horizontal-05.png" width="400" alt="Koneko Soluciones Tecnológicas Logo"> </a> 
+    <a href="https://koneko.mx" target="_blank">
+        <img src="https://git.koneko.mx/Koneko-ST/koneko-st/raw/branch/main/logo-images/horizontal-05.png" width="400" alt="Logo de Koneko Soluciones Tecnológicas">
+    </a>
 </p>
+
 <p align="center">
-    <a href="https://koneko.mx"><img src="https://img.shields.io/badge/Website-koneko.mx-blue" alt="Sitio Web"></a> 
-    <a href="https://packagist.org/packages/koneko/laravel-vuexy-website-layout-porto"><img src="https://img.shields.io/packagist/v/koneko/laravel-vuexy-website-layout-porto" alt="Latest Stable Version"></a>
-    <a href="https://packagist.org/packages/koneko/laravel-vuexy-website-layout-porto"><img src="https://img.shields.io/packagist/l/koneko/laravel-vuexy-website-layout-porto" alt="License"></a>
-    <a href="https://git.koneko.mx/koneko"><img src="https://img.shields.io/badge/Git%20Server-Koneko%20Git-orange" alt="Servidor Git"></a> 
-    <a href="https://github.com/koneko-mx/laravel-vuexy-website-layout-porto/actions/workflows/tests.yml"><img src="https://github.com/koneko-mx/laravel-vuexy-website-layout-porto/actions/workflows/tests.yml/badge.svg" alt="Build Status"></a> 
-    <a href="https://github.com/koneko-mx/laravel-vuexy-website-layout-porto/issues"><img src="https://img.shields.io/github/issues/koneko/laravel-vuexy-website-layout-porto" alt="Issues"></a> 
+    <a href="https://koneko.mx"><img src="https://img.shields.io/badge/Sitio%20Web-koneko.mx-blue" alt="Sitio Web"></a>
+    <a href="https://github.com/koneko-mx/laravel-vuexy-website-layout-porto"><img src="https://img.shields.io/github/license/koneko-mx/laravel-vuexy-website-layout-porto" alt="Licencia"></a>
+    <a href="https://github.com/koneko-mx/laravel-vuexy-website-layout-porto/issues"><img src="https://img.shields.io/github/issues/koneko-mx/laravel-vuexy-website-layout-porto" alt="Issues"></a>
 </p>

 ---

 ## 📌 Descripción

-**Laravel Vuexy Website Layout Porto** es un módulo diseñado para **Laravel Vuexy Website Admin**, proporcionando [breve descripción de la funcionalidad].
+**Laravel Vuexy Website Layout: Porto** es un layout profesional y modular para sitios web, diseñado para funcionar con el módulo [Vuexy Website Admin](https://github.com/koneko-mx/laravel-vuexy-website-admin) dentro del ecosistema ERP de Koneko.

-### ✨ Características:
- 🔹 Integración completa con Vuexy Website Admin.
- 🔹 Funcionalidad clave 1.
- 🔹 Funcionalidad clave 2.
+Basado en el reconocido **template HTML Porto**, este paquete incluye soporte para más de 85 variantes visuales listas para usar, incluyendo sitios corporativos, blogs, portafolios, landings de productos y mucho más. Todo ello integrado mediante componentes Blade y bloques de contenido dinámicos.

 ---

-## 📦 Instalación
+### ⚠️ Legal

-Instalar vía **Composer**:
+Este repositorio **no incluye archivos de plantillas premium**. Para producción debes adquirir una licencia legal del template a través del siguiente enlace:
+
+👉 [https://themeforest.net/item/porto-responsive-html5-template/4106987](https://themeforest.net/item/porto-responsive-html5-template/4106987)
+
+---
+
+## 🚀 Instalación Rápida

 ```bash
-composer require koneko/laravel-vuexy-website-layout-porto
+composer require koneko/laravel-vuexy-website-layout-porto:dev-develop
+php artisan vendor:publish --tag=vuexy-website-layout-porto-assets
 ```

-Publicar archivos de configuración y migraciones (si aplica):
+Esto publicará los assets en:

-```bash
-php artisan vendor:publish --tag=laravel-vuexy-website-layout-porto-config
-php artisan migrate
+```
+/public/vendor/vuexy-layout-porto/
 ```

 ---

-## 🚀 Uso básico
+## 📦 Características

-```php
-use Koneko\NombreLibreria\Models\Model;
+* ⚡ Más de 85 plantillas Porto listas para usar
+* 🧹 Componentes Blade para cada plantilla
+* 🎨 Cambio de plantilla desde la UI de Vuexy Website Admin
+* 🖼️ Banners, widgets y secciones dinámicas
+* 🧠 Integrado con el CMS Koneko y contenido multilenguaje
+* 📁 Preparado para SCSS, Vite y optimización con Blade
+* 🔌 Diseñado para rendimiento y SEO

-$model = Model::create([
-    'campo1' => 'Valor',
-    'campo2' => 'Otro valor',
-]);
+---
+
+## 📁 Estructura de Carpetas Destacada
+
+```
+resources/
+├── views/templates/
+│   ├── accounting-1/
+│   ├── digital-agency/
+│   ├── real-estate/
+│   ├── ...
+│   └── vuexy-website-layout-porto/
+│
+├── views/templates/{template}/components/
+├── public/
+│   └── vendor/vuexy-layout-porto/
+└── img/module-cover.png
 ```

 ---

-## 📚 Configuración adicional
+## 📎 Plantillas Visuales Incluidas

-Si necesitas personalizar la configuración del módulo, publica el archivo de configuración:
+Algunas de las variantes disponibles:

-```bash
-php artisan vendor:publish --tag=laravel-vuexy-website-layout-porto-config
-```
+* Arquitectura e Interiorismo
+* Agencia Digital (oscura y clara)
+* Finanzas y Contabilidad
+* Servicios de Limpieza
+* Iglesia, Barbería, Restaurante, Cafetería
+* Construcción y Energía Renovable
+* Educación, Boda, Portafolio, CV
+* Landing de Productos, Aplicaciones y SaaS
+* Diseños enfocados en SEO y eventos

-Esto generará `config/nombre_libreria.php`, donde puedes modificar valores predeterminados.
+Consulta el listado completo en el directorio `views/templates/`.

 ---

-## 🛠 Dependencias
+## ⚙️ Integración con el Ecosistema Koneko

-Este paquete requiere las siguientes dependencias:
- Laravel 11
- `koneko/laravel-vuexy-website-layout-porto`
- Dependencias específicas de la librería
+Este layout se registra automáticamente en la interfaz de **Koneko Vuexy Admin** como un módulo visual. Desde la interfaz administrativa puedes:
+
+* Seleccionar Porto como plantilla para tu sitio
+* Configurar banners y variantes específicas
+* Activar o desactivar bloques por página
+* Usar variantes multilenguaje con soporte para `hreflang`
+
+Es totalmente compatible con los módulos `website_contents`, `website_seo_profiles` y `website_menus`.

 ---

-## 📦 Publicación de Assets y Configuraciones
+## 🛠️ Requisitos

-Para publicar configuraciones y seeders:
-
-```bash
-php artisan vendor:publish --tag=laravel-vuexy-website-layout-porto-config
-php artisan vendor:publish --tag=laravel-vuexy-website-layout-porto-seeders
-php artisan migrate --seed
-```
-
-Para publicar imágenes del tema:
-
-```bash
-php artisan vendor:publish --tag=laravel-vuexy-website-layout-porto-images
-```
+* PHP `^8.2`
+* Laravel `^11.31`
+* [koneko/laravel-vuexy-website-admin](https://github.com/koneko-mx/laravel-vuexy-website-admin)
+* Node + Vite para personalización con SCSS (opcional pero recomendado)

 ---

-## 🛠 Pruebas
+## 📄 Licencia

-Ejecuta los tests con:
-
-```bash
-php artisan test
-```
+Este paquete se distribuye bajo la [Licencia Business Source 1.1 personalizada](LICENSE.es), con transición automática a MIT a los 3 años. Para uso comercial, redistribución o integraciones ampliadas, contacta a:

+📧 [opensource@koneko.mx](mailto:opensource@koneko.mx)
+    
 ---

-## 🌍 Repositorio Principal y Sincronización
+## 📚 Más Información

-Este repositorio es una **copia sincronizada** del repositorio principal alojado en **[Tea - Koneko Git](https://git.koneko.mx/koneko/laravel-vuexy-website-layout-porto)**.
-
-### 🔄 Sincronización con GitHub
- **Repositorio Principal:** [git.koneko.mx](https://git.koneko.mx/koneko/laravel-vuexy-website-layout-porto)
- **Repositorio en GitHub:** [github.com/koneko/laravel-vuexy-website-layout-porto](https://github.com/koneko/laravel-vuexy-website-layout-porto)
- **Los cambios pueden reflejarse primero en Tea antes de GitHub.**
-
-### 🤝 Contribuciones
-Si deseas contribuir:
-1. Puedes abrir un **Issue** en [GitHub Issues](https://github.com/koneko/laravel-vuexy-website-layout-porto/issues).
-2. Para Pull Requests, **preferimos contribuciones en Tea**. Contacta a `admin@koneko.mx` para solicitar acceso.
-
-⚠️ **Nota:** Algunos cambios pueden tardar en reflejarse en GitHub, ya que este repositorio se actualiza automáticamente desde Tea.
-
---
-
-## 🏅 Licencia
-
-Este paquete es de código abierto bajo la licencia [MIT](LICENSE).
+* [Módulo Website Admin](https://github.com/koneko-mx/laravel-vuexy-website-admin)
+* [Core Vuexy Admin](https://github.com/koneko-mx/laravel-vuexy-admin)
+* [Documentación en inglés](README.en.md)
+* [Sitio Oficial Koneko ST](https://koneko.mx)
+* [Correo de Contacto](mailto:opensource@koneko.mx)

 ---

 <p align="center">
-    Hecho con ❤️ por <a href="https://koneko.mx">Koneko Soluciones Tecnológicas</a>
+    Hecho con ❤️ en México por <a href="https://koneko.mx">Koneko Soluciones Tecnológicas</a>
 </p>