jf-viguier / stripe_official

Stripe Official PrestaShop Addon

Stripe Official

About

Let customer pay with one of this payment methods :

On PrestaShop 1.7 :

• Credit card
• bancontact
• giropay
• ideal
• sofort

Product page on PrestaShop Addons:

https://addons.prestashop.com/fr/paiement-carte-wallet/24922-stripe-officiel-sca-ready.html

Module version guide

PrestaShop version	Module version	Repo	Doc	PHP Version
1.5.x	1.5.x	[release/1.5.2]		5.3 or greater
1.6.x - 1.7.x	2.x	[master]		5.6 or greater

Requirements

1. PHP version (check Module version guide)
2. TLS 1.2 & cURL 1.0.1c

The Payment Card Industry (PCI) Council has mandated that early versions of TLS be retired from service. All organizations that handle credit card information are required to comply with this standard. As part of this obligation, Stripe has upgraded its services to require TLS 1.2 for all HTTPS connections. Connections to the sandbox environment use only TLS 1.2.

For more official, relevant information, see the 2017-2018 Merchant Security Roadmap Microsite:

• TLS 1.2 and HTTP/1.1 Upgrade Microsite

Check the version of your URL’s underlying security library. If you use OpenSSL libraries, please update them to at least version 1.0.1c.

Installation

To install module on PrestaShop, download zip package form [product page on PrestaShop Addons][addons].

This module contain composer.json file. If you clone or download the module from github repository, run the composer install from the root module folder.

See the composer documentation to learn more about the composer.json file.

Compiling assets

For development

We use Webpack to compile our javascript and scss files.
In order to compile those files, you must :

1. have Node 10+ installed locally
2. run npm install in the root folder to install dependencies
3. then run npm run watch to compile assets and watch for file changes

For production

Run npm run build to compile for production.
Files are minified, console.log and comments dropped.

Contributing

PrestaShop modules are open-source extensions to the PrestaShop e-commerce solution. Everyone is welcome and even encouraged to contribute with their own improvements.

Requirements

Contributors must follow the following rules:

• Make your Pull Request on the "develop" branch, NOT the "master" branch.
• Do not update the module's version number.
• Follow the coding standards.

Process in details

Contributors wishing to edit a module's files should follow the following process:

1. Create your GitHub account, if you do not have one already.
2. Fork the stripe_offical project to your GitHub account.
3. Clone your fork to your local machine in the /modules directory of your PrestaShop installation.
4. Create a branch in your local clone of the module for your changes.
5. Change the files in your branch. Be sure to follow the coding standards!
6. Push your changed branch to your fork in your GitHub account.
7. Create a pull request for your changes on the 'develop' branch of the module's project. Be sure to follow the commit message norm in your pull request. If you need help to make a pull request, read the Github help page about creating pull requests.
8. Wait for one of the core developers either to include your change in the codebase, or to comment on possible improvements you should make to your code.

That's it: you have contributed to this open-source project! Congratulations!

Command line launched by GitHub actions

Please launch these command line before submitting a Pull Request.

phpcs fixer

~$ vendor/bin/php-cs-fixer --fix

phpstan

You need a docker container to launch phpstan:

# create the prestashop container
~$ docker run -tid --rm -v ps-volume:/var/www/html --name temp-ps prestashop/prestashop

# launch phpstan
~$ docker run --rm --volumes-from temp-ps -v $PWD:/var/www/html/modules/stripe_official -e _PS_ROOT_DIR_=/var/www/html --workdir=/var/www/html/modules/stripe_official phpstan/phpstan:0.12 analyse --configuration=/var/www/html/modules/stripe_official/202/phpstan/phpstan.neon