PHPackages                             nowyouwerkn/wecommerce - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. nowyouwerkn/wecommerce

ActiveLibrary[Payment Processing](/categories/payments)

nowyouwerkn/wecommerce
======================

WeCommerce is an eCommerce ecosystem designed for everyone to build and scale their business. It offers a wide range of functionalities that allows you to have full control of your store. It is combined with easy product information management and fast response time.

2.5(1y ago)36232[9 issues](https://github.com/nowyouwerkn/wecommerce/issues)MITJavaScriptPHP ^8.0

Since Feb 25Pushed 1y ago1 watchersCompare

[ Source](https://github.com/nowyouwerkn/wecommerce)[ Packagist](https://packagist.org/packages/nowyouwerkn/wecommerce)[ Docs](https://github.com/nowyouwerkn/wecommerce)[ RSS](/packages/nowyouwerkn-wecommerce/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (18)Used By (0)

[![Forks](https://camo.githubusercontent.com/fbc4d10a81a5095cc05a4fe288005e9ed04990ff04800c0535b24de35a68bd1b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e6f77796f757765726b6e2f7765636f6d6d65726365)](https://github.com/nowyouwerkn/wecommerce/network/members)[![Stargazers](https://camo.githubusercontent.com/8f830dce43b47b93d3e15793a18a202a95920cf76e95ef2f27aea6b643da46c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f77796f757765726b6e2f7765636f6d6d65726365)](https://github.com/nowyouwerkn/wecommerce/stargazers)[![Issues]()](https://github.com/nowyouwerkn/wecommerce/issues)

 [ ![Logo](images/logo.png) ](https://github.com/nowyouwerkn/wecommerce)

### WeCommerce

[](#wecommerce)

 La plataforma autoadministrable de E-commerce de Werken
 [**Lee la documentación »**](https://github.com/nowyouwerkn/wecommerce)

 [Reportar Problema](https://github.com/nowyouwerkn/wecommerce/issues) · [Solicitar Funcionalidad](https://github.com/nowyouwerkn/wecommerce/issues)

 ##### Indice de Contenido

[](#indice-de-contenido)

1. [Acerca del Proyecto](#acerca-del-proyecto)
    - [Tecnologías](#tecnologías)
2. [Comenzando](#comenzado)
    - [Pre-requisitos](#pre-requisitos)
    - [Configurando Servidor]()
    - [Instalación](#instalación)
3. [Uso](#uso)

- [Configurando Eventos de Facebook]()

4. [Personalizar](#personalizar)
5. [Roadmap](#roadmap)
6. [Contirbuir](#contributing)
7. [Licencia](#licencia)
8. [Contacto](#contacto)
9. [Agradecimientos](#agradecimientos)
 Acerca del Proyecto
-------------------

[](#acerca-del-proyecto)

[![Product Name Screen Shot](images/screenshot.png)](https://werkn.mx/wecommerce)

### Tecnologías

[](#tecnologías)

- [Bootstrap](https://getbootstrap.com)
- [JQuery](https://jquery.com)
- [Laravel](https://laravel.com)
- PHP: `^7.4\|^8.0`
- Laravel: `8.*`
- MySQL: `^7.4`

Comenzando
----------

[](#comenzando)

### Pre-requisitos

[](#pre-requisitos)

Requerimientos mínimos de servidor:

- 1 CPU (Doble Nucleo)
- 1GB RAM
- 25GB SSD
- 1 TB Transferencia

Requerimientos recomendados de servidor:

- 1 CPU (Doble Nucleo)
- 2GB RAM
- 25 GB SSD
- 2 TB Transferencia

La configuración recomendada es LAMP Stack.

- Ubuntu - 18.04
- Apache2 - 2.4.29
- MySQL server 5.7.23
- PHP - 7.2
- Fail2ban - 0.10.2
- Postfix - 3.3.0
- Certbot - 0.26.1
- Phpmyadmin (OPCIONAL)

Tambien es posible implementar la plataforma en un Stack LEMP

- Ubuntu - 18.04
- Nginx - 1.14.0
- MySQL server 5.7.23
- PHP - 7.2
- Fail2ban - 0.10.2
- Postfix - 3.3.0
- Certbot - 0.26.1
- Phpmyadmin (OPCIONAL)

Las instrucciones de instalación se enfocarán en Apache 2, si se implementa en Nginx hacer modificaciones en donde sea necesario.

\### Configuración de Servidor

#### Instalar Git, Unzip.

[](#instalar-git-unzip)

```
sudo apt-get install git
sudo apt-get install unzip

```

#### Instalar CURL + Composer

[](#instalar-curl--composer)

```
sudo apt-get install curl php8.0-curl php8.0-xml php8.0-gd php8.0-opcache php8.0-mbstring php8.0-zip php7.4-curl php7.4-xml php7.4-gd php7.4-opcache php7.4-mbstring php7.4-zip

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

```

#### Habilitar Mods

[](#habilitar-mods)

```
sudo phpenmod mbstring
sudo a2enmod rewrite
sudo systemctl restart apache2

```

#### Git CLONE del Proyecto en carpeta HTML

[](#git-clone-del-proyecto-en-carpeta-html)

```
cd /var/www/html
git clone [RUTA DEL PROYECTO]

```

#### Habilitar Rewrite para la carpeta

[](#habilitar-rewrite-para-la-carpeta)

```
sudo chmod -R 777 [NOMBRE_DE_LA_CARPETA]

```

#### Entrar en carpeta de proyecto

[](#entrar-en-carpeta-de-proyecto)

```
cd /[NOMBRE_DE_LA_CARPETA]

```

#### Actualizar carpeta con COMPOSER

[](#actualizar-carpeta-con-composer)

```
composer update

```

#### Crear una Llave de Encriptación

[](#crear-una-llave-de-encriptación)

```
cp .env.example .env
php artisan key:generate

```

Es importante abrir el archivo .env para configurar la conexión a la base de datos si es que se requiere.

#### Configurar Directorio de Proyecto

[](#configurar-directorio-de-proyecto)

/etc/apache2/sites-available/default.com.conf

```

	ServerName [RUTA].com
	DocumentRoot /var/www/html/[[ NOMBRE_DE_LA_CARPETA ]]/public

		AllowOverride All
		Require all granted

```

Si es necesario utilizar un certificado de seguridad utilizar el puerto 443 y activar las capacidades SSL del servidor por medio de la linea de comandos. Es importante que el certificado se encuentre en la ruta correcta que se determina en ese documento.

#### Reiniciar Servidor

[](#reiniciar-servidor)

```
service apache2 reload

```

### Instalación

[](#instalación)

Para comenzar a usar este paquete debes usar el siguiente comando para agregarlo a tu instalación de Laravel.

```
composer require nowyouwerkn/wecommerce

```

Es necesario agregar proveedores al proyecto para poder utilizar todas las funciones de las librerias utilizadas por el paquete. Esto se agrega en el archivo `config/app.php`

```
'providers' => [
    // ...
    Nowyouwerkn\WeCommerce\WeCommerceServiceProvider::class,
    Maatwebsite\Excel\ExcelServiceProvider::class,
];

'aliases' => [
    // ...
    'Excel' => Maatwebsite\Excel\Facades\Excel::class
];

```

Publica todos los assets del paquete y sus dependencias usando

```
php artisan vendor:publish --provider="Nowyouwerkn\WeCommerce\WeCommerceServiceProvider" --force

```

Para que funcione correctamente el sistema es OBLIGATORIO publicar los archivos de `migrations`, `seeders`, `theme`, `public` y `config`. Puedes escoger que elemento quieres publicar con las siguientes etiquetas.

Etiquetas de elementos publicables:

- --tag=werkn-bootstrap (Tema principal)
- --tag=error-views
- --tag=translations
- --tag=public
- --tag=config
- --tag=seeders

Recomendamos correr la publicación automáticamente pero puedes seleccionar que es lo que necesitas. Principalmente los temas.

**IMPORTANTE:**  El sistema utiliza Fortify para Autenticar usuarios asi que es importante publicar tambien los recursos de fortify con el siguiente comando:

```
php artisan vendor:publish --provider="Laravel\Fortify\FortifyServiceProvider"

```

Esto creará una carpeta llamada `Actions` dentro de `app`. En esta carpeta se encuentran los archivos de autenticación de Fortify. Si no has eliminado o editado tu archivo `User` dentro de tu carpeta de Modelos no necesitas hacer más, en caso contrario para que funcione con WeCommerce tendrás que editar el archivo `CreateNewUser` cambiando lo siguiente:

```
use App\Models\User;

cambiar por...

use Nowyouwerkn\WeCommerce\Models\User;

```

Actualiza tu archivo `app.php` con el proveedor de Fortify Esto se agrega en el archivo `config/app.php`

```
    App\Providers\FortifyServiceProvider::class,

```

Limpia el caché de tu configuración

```
php artisan optimize:clear
#o
php artisan config:clear

```

El sistema necesita utilizar la ruta "/" que usa Laravel como vista de ejemplo en las rutas. Accede al documento `web.php` de tu proyecto de Laravel y sobreescribe la información con el archivo que se encuentra aqui: `https://github.com/nowyouwerkn/wecommerce/blob/main/src/routes.php`. Al realizarlo podrás usar.

```
php artisan serve

```

para prender tu servidor y acceder a `/instalador` para comenzar la instalación. Si estás usando Homestead no es necesario usar `php artisan serve`.

Si prefieres preparar manualmente el proyecto sigue los siguientes comandos.

```
php artisan migrate
php artisan db:seed

```

### Modificaciones necesarias a Laravel

[](#modificaciones-necesarias-a-laravel)

1. Cambiar en el archivo RouteServiceProvider la ruta de redirección a:

```
public const HOME = '/profile';

```

2. En tu archivo `app.php` dentro de la carpeta `config` sobreescribe la información de zona horaria con lo siguiente:

```
'timezone' => 'America/Mexico_City',

```

3. (OPCIONAL) Si quieres usar las traducciones en español debes sobreescribir tu objeto `locale` de tu archivo `app.php` dentro de la carpeta `config` con lo siguiente. Si publicaste los archivos del paquete correctamente el sistema automáticamente usará la traducción:

```
'locale' => 'es',

```

Uso
---

[](#uso)

El paquete publica automáticamente las vistas de front que verán los compradores asi como todos los estilos relacionados a su funcionamiento. Puedes editar las vistas de front que se encuentran en `resources/views/front/theme/werkn-backbone-bootstrap`.

Estructura:

- 📂 theme
    - 📂 werkn-backbone-bootstrap
        - 📂 auth
            - login.blade.php
            - register.blade.php
            - forgot-password.blade.php
            - reset-password.blade.php
        - 📂 checkout
            - 📂 utilities
                - \_order\_address.blade.php
                - \_order\_address.blade.php
                - \_order\_contact.blade.php
                - \_order\_payment.blade.php
                - \_order\_shipping.blade.php
                - \_order\_summary.blade.php
            - index.blade.php
        - 📂 layouts
            - 📂 checkout
                - footer.blade.php
                - header.blade.php
                - main.blade.php
            - 📂 partials
                - *cookies\_notice*.blade.php
                - \_headerbands.blade.php
                - \_messages\_errors.blade.php
                - \_messages.blade.php
                - \_modal\_messages.blade.php
                - \_modal\_popup.blade.php
                - *werkn\_bar*.blade.php
            - 📂 utilities
                - *cart\_item*.blade.php
                - *filter\_sidebar*.blade.php
                - *order\_card*.blade.php
                - *product\_card*.blade.php
            - \_filter\_sidebar.blade.php
            - footer.blade.php
            - header.blade.php
            - main.blade.php
            - nav-user.blade.php
        - 📂 search
            - element.blade.php
            - index.blade.php
            - query.blade.php
        - 📂 user\_profile
            - account.blade.php
            - address.blade.php
            - edit\_address.blade.php
            - image.blade.php
            - profile.blade.php
            - shopping.blade.php
            - wishlist.blade.php
        - cart.blade.php
        - catalog.blade.php
        - catalog\_filter.blade.php
        - detail.blade.php
        - faqs.blade.php
        - legal.blade.php
        - order\_tracking.blade.php
        - purchase\_complete.blade.php
        - index.blade.php 🏠

### Eventos de Facebook

[](#eventos-de-facebook)

La plataforma esta preparada para recibir eventos de Facebook integrando el código de pixel desde `Integraciones del Sistema` en la sección de `Preferencias Generales` de la configuración, asi como la conexión con la API de Conversiones de Facebook.

Los eventos que el sistema monitorea son:

- PageView
- ViewContent
- Search
- Purchase
- InitiateCheckout
- Contact
- AddToWishlist
- AddToCart
- AddPaymentInfo

Para activar el evento **Contact** agrega la clase `contact_action` a los links que ejecuten una acción de contacto. (mailto, tel, chat, etc.)

Personalizar
------------

[](#personalizar)

Para hacer cambios en los estilos puedes modificar libremente el archivo `main.blade.php` dentro de `layouts` para modificar o eliminar los archivos originales de la plantilla. Para sobreescribir los preexistentes recomendamos hacer todo dentro de la carpeta `css` en el archivo `w-custom.css`

Si prefieres crear un nuevo tema que no se sobreescriba al actualizar puedes copiar y pegar la carpeta `werkn-backbone-bootstrap` y ponerle el nombre de tu proyecto. Siguiendo la estructura de la sección anterior el controlador `FrontController` vinculará automaticamente las vistas a la carpeta dentro de `theme`. **Este cambio de estilo se debe configurar en el panel administrativo en Configuración > Apariencia y dar de alta el nombre de la carpeta.**

**Recomendación:** Para mantener limpio el proyecto para facilitar su actualización a futuro lo mejor es colocar los estilos básicos de tu nuevo tema dentro de la carpeta public > themes > \[NOMBRE DE TU TEMA\]. Los estilos particulares los puedes encontrar en la carpeta css.

Estructura de carpeta theme

- 📂 themes
    - werkn-backbone-bootstrap
        - \[...\]
    - \[TU PROYECTO\]

Estructura de carpeta css:

- 📂 css
    - w-custom.css (Estilos particulares globales)
    - w-checkout.css (Para personalizar tu checkout)

Roadmap
-------

[](#roadmap)

Revisa los [tickets abiertos](https://github.com/nowyouwerkn/wecommerce/issues) para una lista estructurada de las funcionalidades propuestas y problemas conocidos en producción.

Licencia
--------

[](#licencia)

MIT License

Copyright (c) \[2024\] \[Werken Lab S.A de C.V\]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contacto
--------

[](#contacto)

Werken Lab S.A de C.V - [@nowyouwerkn](https://instagram.com/werken.mx) - Link de Proyecto:

Agradecimientos
---------------

[](#agradecimientos)

- [GitHub Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet)
- [Img Shields](https://shields.io)
- [Choose an Open Source License](https://choosealicense.com)
- [Font Awesome](https://fontawesome.com)

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 65.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~92 days

Recently: every ~21 days

Total

11

Last Release

611d ago

Major Versions

1.9.3 → 2.02024-06-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/30912d569bc87856fa25f85c7127a9e79c1b369d0963955e27b3f3853ea18c95?d=identicon)[jorgeepena](/maintainers/jorgeepena)

---

Top Contributors

[![jorgeepena](https://avatars.githubusercontent.com/u/8557724?v=4)](https://github.com/jorgeepena "jorgeepena (269 commits)")[![noehassiel](https://avatars.githubusercontent.com/u/60529420?v=4)](https://github.com/noehassiel "noehassiel (107 commits)")[![Rakdo](https://avatars.githubusercontent.com/u/64712282?v=4)](https://github.com/Rakdo "Rakdo (36 commits)")[![fossabot](https://avatars.githubusercontent.com/u/29791463?v=4)](https://github.com/fossabot "fossabot (1 commits)")

---

Tags

ecommercesystemecommercecartcheckoutwerkenheadless-ecommerce

### Embed Badge

![Health badge](/badges/nowyouwerkn-wecommerce/health.svg)

```
[![Health](https://phpackages.com/badges/nowyouwerkn-wecommerce/health.svg)](https://phpackages.com/packages/nowyouwerkn-wecommerce)
```

###  Alternatives

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4845.9k](/packages/sebdesign-laravel-viva-payments)[lunarphp/stripe

Stripe payment driver for Lunar.

2055.8k4](/packages/lunarphp-stripe)[vanilo/checkout

Vanilo Checkout Module

1592.5k](/packages/vanilo-checkout)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)