nowyouwerkn/wecommerce

eCommerce ecosystem to build and scale our clients businesses.

Installs: 169

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Open Issues: 0

Language:JavaScript

dev-main 2021-10-21 21:11 UTC

This package is auto-updated.

Last update: 2021-10-21 21:12:07 UTC


README

Forks Stargazers


Logo

WeCommerce

La plataforma autoadministrable de E-commerce de Werkn
Lee la documentación »

Reportar Problema · Solicitar Funcionalidad

Indice de Contenido
  1. Acerca del Proyecto
  2. Comenzando
  3. Uso
Personalizar Roadmap Contirbuir Licencia Contacto Agradecimientos

Acerca del Proyecto

Product Name Screen Shot

Tecnologías

Comenzando

Pre-requisitos

  • PHP: ^7.4\|^8.0
  • Laravel: 8.*

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,
    Intervention\Image\ImageServiceProvider::class,
    Maatwebsite\Excel\ExcelServiceProvider::class,
    App\Providers\FortifyServiceProvider::class,
];

'aliases' => [
    // ...
    'Image' => Intervention\Image\Facades\Image::class,
    '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=theme
  • --tag=error-views
  • --tag=translations
  • --tag=public
  • --tag=config
  • --tag=migrations
  • --tag=seeders

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;

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

  1. Cambiar en el archivo RouteServiceProvider la ruta de redirección a:
public const HOME = '/profile';
  1. Sobreescribir el archivo routes.php de tu proyecto de laravel con el archivo routes del repositorio.
Ruta:
https://github.com/nowyouwerkn/wecommerce/blob/main/src/routes.php
  1. En tu archivo app.php dentro de la carpeta config sobreescribe la información de zona horaria con lo siguiente:
'timezone' => 'America/Mexico_City',
  1. (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

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.

Estructura:

  • 📂 theme
    • 📂 werkn-backbone
      • 📂 layouts
        • 📂 partials
          • _messages.blade.php
          • _modal_messages.blade.php
        • _filter_sidebar.blade.php
        • _product_card.blade.php
        • footer.blade.php
        • header.blade.php
        • main.blade.php
        • nav-user.blade.php
      • 📂 search
        • general_query.blade.php
      • 📂 user_profile
        • account.blade.php
        • address.blade.php
        • profile.blade.php
        • shopping.blade.php
        • wishlist.blade.php
      • auth.blade.php
      • cart.blade.php
      • catalog.blade.php
      • catalog_filter.blade.php
      • checkout.blade.php
      • detail.blade.php
      • index.blade.php 🏠

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

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 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
      • [...]
    • [TU PROYECTO]

Estructura de carpeta css:

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

Roadmap

Revisa los tickets abiertos para una lista estructurada de las funcionalidades propuestas y problemas conocidos en producción.

Licencia

MIT License

Copyright (c) [2021] [Werkn 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

Werkn S.A de C.V - @nowyouwerkn - hey@werkn.mx Link de Proyecto: https://github.com/nowyouwerkn/wecommerce

Agradecimientos