exiguous ecommerce

? exiguous ecommerce

exiguous ecommerce es una biblioteca de comercio electrónico súper simple, que utiliza archivos planos y adopta un enfoque muy minimalista.

Instalación

Simplemente ejecute el siguiente comando de Composer para descargar/instalar exiguous ecommerce y crear archivos de carga automática relevantes.

 composer require divineomega/exiguous-ecommerce

Si su marco aún no lo hace, debe agregar require_once "vendor/autoload.php" a cualquier archivo en el que desee utilizar exiguous ecommerce .

Configuración

exiguous ecommerce almacena todos sus datos dentro de un directorio data . En este paquete se proporciona un directorio data de ejemplo.

Antes de usarlo, debe copiar el directorio data a otra ubicación y luego especificar esta ubicación en el entorno de su proyecto. Si está utilizando Laravel, esto se puede hacer configurando una variable EXIGUOUS_ECOMMERCE_DATA_DIRECTORY en su archivo .env , de la siguiente manera.

 EXIGUOUS_ECOMMERCE_DATA_DIRECTORY=/var/www/ecommerce-site/path-to-data-directory/

Si no está utilizando un marco que admita esto, puede usar la función PHP estándar putenv para configurar esta variable de entorno. Alternativamente, puede usar dotenv-loader para agregar soporte para archivos .env a su proyecto.

Tenga en cuenta que es importante que la variable EXIGUOUS_ECOMMERCE_DATA_DIRECTORY esté configurada con una barra diagonal presente.

Por razones de seguridad, debe colocar el directorio data en una ubicación a la que no se pueda acceder desde la web. En caso de que el directorio de datos se coloque por accidente en una ubicación accesible desde la web, se proporciona un archivo .htaccess que debería negar a los usuarios web el acceso al contenido del directorio en las configuraciones de servidor web más comunes.

Ejemplos de inicio rápido

Obteniendo productos y categorías:

 $ category =  DivineOmega  ExiguousEcommerce Category:: findBySlug ( " fluffy-things " );
$ products = $ category -> products ();

foreach ( $ products as $ product ) {
    echo $ product -> data -> name ;
}

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );
$ categories = $ product -> categories ();

$ mainCategoryName = $ categories [ 0 ]-> data -> name ;

Obtener la cesta del usuario actual y agregarle un producto:

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );

$ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> addProduct ( $ product ); // Add one Teddy Bear

$ basket -> addProduct ( $ product , 2 ); // Add another two Teddy Bears!

var_dump ( $ basket -> items ); // Outputs an array of, you guessed it, basket items! ^_^

// ^ This would show 1 basket item with a quantity of 3 teddy bears.

Sacar un producto de una cesta:

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );

$ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> removeProduct ( $ product ); // Removes all teddy bears from the basket

Configurar/compensar la cantidad de un producto en la cesta:

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );

$ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> addProduct ( $ product ); // Add one Teddy Bear

$ basket -> setProductQuantity ( $ product , 10 ); // Set the number of Teddy Bears in the basket to ten

$ basket -> offsetProductQuantity ( $ product , 10 ); // Add ten more Teddy Bears

$ basket -> offsetProductQuantity ( $ product , - 5 ); // Remove five of those Teddy Bears

Migrando la cesta a un pedido:

 $ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> convertToOrder ();

Obtener y usar la configuración:

 // Retrieves settings from the core.json file within the .settings directory
$ coreSettings =  DivineOmega  ExiguousEcommerce Settings:: find ( ' core ' );

echo $ coreSettings -> data -> primaryCurrency ; // Output the ecommerce's primary currency setting