Yeoman generator for PrestaShop - lets you quickly set up a payment module
Payment modules for PrestaShop almost always share the same architecture and it's painful to write them from scratch for each new payment provider.
This project generates a well architectured payment module which follows the PrestaShop best practices. It lets you focus on the implementation of the payment provider API and the user experience.
What you get
. ├── README.md ├── classes │ ├── PaymentProviderApi.php │ └── index.php ├── controllers │ ├── front │ │ ├── index.php │ │ ├── notification.php │ │ └── redirect.php │ └── index.php ├── index.php ├── mymodule.php ├── translations │ └── index.php ├── upgrade │ ├── index.php │ └── upgrade-1.1.0.php └── views ├── css │ ├── back.css │ ├── front.css │ └── index.php ├── index.php ├── js │ ├── back.js │ ├── front.js │ └── index.php └── templates ├── admin │ └── index.php ├── front │ ├── index.php │ └── redirect.tpl ├── hooks │ ├── index.php │ └── payment.tpl └── index.php
You just need
NPM installed on your machine
Install Yeoman if you don't have it already:
npm install -g yo
Install this generator:
npm install -g generator-prestashop-payment-module
Let the magic happen 🎉 :
At this stage you'll be prompted for the following details:
Technical Name: The module repository name. The generator will also create a PascalCase version of this string, and use it as the module main class
Display Name: This is the name that the merchant will see in the PrestaShop backoffice.
Author Email: Just put your name and your email
Description: This text will be displayed in the PrestaShop backoffice, just under the
Display Name. You can use buzzwords and marketing stuff here but keep it short ( <= 200 characters)
Select hooks: This is a work in progress. Just type
Enterbecause this input will be ignored for now. By default, the module is hooked on
Confirm Uninstall Message: The message to display when the merchants uninstall the module from his store.
Payment provider name: There are tons of payment service providers (or PSP) out there. Just put the name of the one you want to implement.
⚠️ These inputs are piped through validation functions so if you're stuck on the prompt, that probably means that you're current proposition doesn't match the expected format. Feel free to open an issue if you find a bug.
Et voilà ! A brand new payment module is born at your current location, put in in the
modules folder of a PrestaShop store, and install it via its backoffice.
- 100% code coverage
- Hooks selection on the prompt - WIP
- Instructions for the prompt
- Developer documentation
- Generic logo/images
- PHPDoc Compliancy
- PSR-2 Compliancy