exiguous ecommerce

؟ exiguous ecommerce

exiguous ecommerce هي مكتبة تجارة إلكترونية بسيطة للغاية، تستخدم الملفات المسطحة وتتخذ أسلوبًا بسيطًا للغاية.

تثبيت

ما عليك سوى تشغيل أمر Composer التالي لتنزيل/تثبيت exiguous ecommerce وإنشاء ملفات التحميل التلقائي ذات الصلة.

 composer require divineomega/exiguous-ecommerce

إذا لم يكن إطار العمل الخاص بك يقوم بذلك بالفعل، فيجب عليك إضافة require_once "vendor/autoload.php" إلى أي ملفات ترغب في استخدام exiguous ecommerce فيها.

إعدادات

تقوم exiguous ecommerce بتخزين جميع بياناتها داخل دليل data . يتم توفير مثال لدليل data في هذه الحزمة.

قبل الاستخدام، يجب عليك بعد ذلك نسخ دليل data إلى موقع آخر ثم تحديد هذا الموقع لبيئة مشروعك. إذا كنت تستخدم Laravel، فيمكن القيام بذلك عن طريق تعيين متغير EXIGUOUS_ECOMMERCE_DATA_DIRECTORY في ملف .env الخاص بك، كما يلي.

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

إذا كنت لا تستخدم إطارًا يدعم ذلك، فيمكنك استخدام وظيفة PHP القياسية putenv لتعيين متغير البيئة هذا. وبدلاً من ذلك، يمكنك استخدام dotenv-loader لإضافة دعم ملفات .env إلى مشروعك.

يرجى ملاحظة أنه من المهم تعيين المتغير EXIGUOUS_ECOMMERCE_DATA_DIRECTORY بشرطة مائلة زائدة.

لأسباب أمنية، يجب عليك وضع دليل data في موقع لا يمكن الوصول إليه عبر الويب. في حالة وضع دليل البيانات في موقع يمكن الوصول إليه عبر الويب عن طريق الصدفة، يتم توفير ملف .htaccess الذي يجب أن يمنع مستخدمي الويب من الوصول إلى محتوى الدليل في معظم تكوينات خادم الويب الشائعة.

أمثلة البدء السريع

الحصول على المنتجات والفئات:

 $ 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 ;

الحصول على سلة المستخدم الحالي وإضافة منتج إليها:

 $ 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.

إزالة منتج من السلة:

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

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

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

ضبط/موازنة كمية المنتج في السلة:

 $ 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

ترحيل السلة إلى أمر:

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

$ basket -> convertToOrder ();

الحصول على الإعدادات واستخدامها:

 // 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