فصول مساعدة موثقة كاملة لنظام PrestaShop CMS (8، 1.7، 1.6، 1.5). مع هؤلاء المساعدين، تصبح بعض مهام البرمجة أكثر بساطة ويتم تنفيذها بشكل أسرع. الصفحة الرئيسية للمكتبة.
قائمة المساعدين:
قائمة التحكم:
قائمة المكونات:
تم توثيق كل طريقة وفئة بالكامل، لذا إليك عدة أمثلة، أي مثال واحد فقط لكل فئة.
ArrayHelper ، فهرسة مصفوفة.
$array = [
['id' => '123', 'data' => 'abc'],
['id' => '345', 'data' => 'def'],
];
$result = ArrayHelper::index($array, 'id');
// The result is:
// [
// '123' => ['id' => '123', 'data' => 'abc'],
// '345' => ['id' => '345', 'data' => 'def'],
// ]
FormHelper ، إنشاء مصفوفة مصدر لعنصر select
.
$array = [
['123' => 'abc'],
['345' => 'def'],
];
$result = FormHelper::generateList($array);
// The result is:
// [
// ['id' => '123', 'name' => 'abc'],
// ['id' => '345', 'name' => 'def']
// ]
// The usage in a form definition:
array(
'type' => 'select',
'label' => 'Example',
'name' => 'example',
'options' => array(
'query' => $result,
'id' => 'id',
'name' => 'name',
),
)
LogHelper ، تسجيل خطأ في الوحدة النمطية.
public function example() {
$this->log('An error occupied.');
}
public function log($messages, $level = AbstractLogger::WARNING) {
LogHelper::log($messages, $level, $this->name, $this->id);
}
DiagnosticHelper ، التحقق مما إذا تم تجاوز الطريقة.
if (DiagnosticHelper::isMethodOverridden('AddressController', 'init')) {
$this->_errors[] = $this->l('The AddressController::init() already overridden.');
}
AjaxModuleFrontController ، إنشاء وحدة تحكم Ajax بسيطة لوحدة نمطية.
class ExampleAjaxModuleFrontController extends AjaxModuleFrontController {
protected function actionSave() {
$this->ajaxResponse->result = true;
$this->ajaxResponse->message = 'Success!';
}
}
// The output result is:
// {"result":true,"data":null,"html":"","message":"Success!","errors":[]}
ModuleHelper ، الحصول على مثيل للوحدة عن طريق مسار الدليل المحدد.
$path = '/var/www/prestashop/modules/homecategoriez/classes';
$module = ModuleHelper::getInstanceByPath($path); /** @var HomeCategoriez $module The instance of the module: HomeCategoriez */
FileHelper ، الحصول على الحد الأقصى الحقيقي لحجم الملف الذي يمكن تحميله على الموقع.
$sizeInBytes = FileHelper::getFileSizeUploadLimit();
مكون ذاكرة التخزين المؤقت ، التخزين المؤقت لنتيجة استعلام قاعدة البيانات.
public function getAllCustomers() {
$cacheKey = CacheProvider::getKeyName(__METHOD__);
$data = CacheProvider::getInstance()->get($cacheKey);
if (false === $data) {
$data = Db::getInstance()->executeS('SELECT * FROM ps_customer', true, false);
CacheProvider::getInstance()->set($cacheKey, $data, 60 * 60 * 24);
}
return $data;
}
أداة التحميل التلقائي ، تستخدم أداة التحميل التلقائية الخاصة بـ Composer لتحميل فئات PHP تلقائيًا، على سبيل المثال، في وحدة نمطية عن طريق إضافة خريطة الفصل إلى ملف composer.json
الخاص بك.
"autoload": {
"classmap": [
"classes/",
"interfaces/"
]
}
أضف التبعية مباشرة إلى ملف composer.json
الخاص بك:
"repositories": [
{
"type": "vcs",
"url": "https://github.com/zapalm/prestashop-helpers"
}
],
"require": {
"php": ">=5.5",
"zapalm/prestashop-helpers": "dev-master"
},
إعطاء النجمة للمشروع. هذا كل شيء! :)
يجب على المساهمين اتباع القواعد التالية:
يجب على المساهمين الراغبين في تحرير ملفات المشروع اتباع العملية التالية:
لا تتردد في إنشاء طلب سحب حتى لو كان من الصعب عليك تطبيق معايير الترميز.