prestashop helpers

Kelas pembantu untuk PrestaShop CMS

Kelas pembantu terdokumentasi lengkap untuk PrestaShop CMS (8, 1.7, 1.6, 1.5). Dengan bantuan ini beberapa tugas pemrograman menjadi lebih sederhana dan selesai lebih cepat. Beranda perpustakaan.

Daftar pembantu:

• Pembantu Array
• Pembantu Backend
• Pembantu Tanggal
• Pembantu Diagnostik
• Pembantu File
• Pembantu Formulir
• HtaccessHelper
• Pembantu Log
• ModulHelper
• Pembantu Objek
• Pembantu Keamanan
• Pembantu String
• Terjemahkan Pembantu
• Pembantu Url
• ValidasiHelper
• Pembantu Produk

Daftar pengontrol:

• BaseModuleFrontController.php
• AjaxModuleFrontController.php

Daftar komponen:

• Cache
• Layanan Kualitas
• Autoloader (menggunakan Komposer yang melakukan booting)

Contoh

Setiap metode dan kelas didokumentasikan secara lengkap, jadi berikut adalah beberapa contoh, yaitu hanya satu untuk setiap kelas.

ArrayHelper , mengindeks array.

 $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 , menghasilkan array sumber untuk elemen 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 , mencatat kesalahan dalam modul.

 public function example() {
    $this->log('An error occupied.');
}
public function log($messages, $level = AbstractLogger::WARNING) {
    LogHelper::log($messages, $level, $this->name, $this->id);
}

DiagnosticHelper , memeriksa apakah suatu metode diganti.

 if (DiagnosticHelper::isMethodOverridden('AddressController', 'init')) {
    $this->_errors[] = $this->l('The AddressController::init() already overridden.');
}

AjaxModuleFrontController , membuat pengontrol Ajax sederhana untuk sebuah modul.

 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 , mendapatkan instance modul dengan jalur direktori tertentu.

 $path   = '/var/www/prestashop/modules/homecategoriez/classes'; 
$module = ModuleHelper::getInstanceByPath($path); /** @var HomeCategoriez $module The instance of the module: HomeCategoriez */

FileHelper , mendapatkan ukuran file maksimal nyata yang dapat diunggah ke suatu situs.

 $sizeInBytes = FileHelper::getFileSizeUploadLimit();

Komponen cache , menyimpan hasil kueri DB.

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

Autoloader , menggunakan autoloader Composer untuk memuat kelas PHP secara otomatis, misalnya, dalam modul dengan menambahkan classmap ke file composer.json Anda.

 "autoload": {
  "classmap": [
    "classes/",
    "interfaces/"
  ]
}

Instalasi

Tambahkan ketergantungan langsung ke file composer.json Anda:

 "repositories": [
  {
    "type": "vcs",
    "url": "https://github.com/zapalm/prestashop-helpers"
  }
],
"require": {
  "php": ">=5.5",
  "zapalm/prestashop-helpers": "dev-master"
},

Cara membantu proyek berkembang dan mendapatkan pembaruan

Berikan bintang pada proyek tersebut. Itu saja! :)

Berkontribusi pada kode

Persyaratan untuk kontributor kode

Kontributor harus mengikuti aturan berikut:

• Buat Permintaan Tarik Anda di cabang dev , BUKAN cabang master .
• Jangan perbarui nomor versi pembantu.
• Ikuti standar pengkodean PSR.

Proses secara detail untuk kontributor kode

Kontributor yang ingin mengedit file proyek harus mengikuti proses berikut:

1. Buat akun GitHub Anda, jika Anda belum memilikinya.
2. Garpu proyek ke akun GitHub Anda.
3. Kloning garpu Anda ke mesin lokal Anda.
4. Buat cabang di klon lokal proyek Anda untuk perubahan Anda.
5. Ubah file di cabang Anda. Pastikan untuk mengikuti standar pengkodean.
6. Dorong cabang Anda yang telah diubah ke fork di akun GitHub Anda.
7. Buat permintaan tarik untuk perubahan Anda di cabang dev proyek. Jika Anda memerlukan bantuan untuk membuat permintaan tarik, baca halaman bantuan GitHub tentang membuat permintaan tarik.
8. Tunggu hingga pengelola menerapkan perubahan Anda.

Jangan ragu untuk membuat pull request meskipun sulit bagi Anda untuk menerapkan standar pengkodean.