oxid-solution-catalysts/paypal-module

OXID eSales PayPal payment module for OXID

v3.4.1-rc.3 2025-04-03 19:05 UTC

Requires

• php: >=8.0
• brick/phonenumber: ^0.5.0
• oxid-solution-catalysts/paypal-client: v3.0.15
• viison/address-splitter: ^0.3.4
• webmozart/path-util: ^2.3.0

Requires (Dev)

• codeception/module-db: ^3.0.0
• codeception/module-phpbrowser: ^3.0.0
• codeception/module-rest: ^3.3.0
• oxid-esales/oxideshop-ce: dev-b-7.0.x
• phpmd/phpmd: ^2.15
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9.1.1
• squizlabs/php_codesniffer: 3.*
• symfony/dotenv: ^5.1

GPL-3.0

• payment
• modules
• paypal
• eshop
• OXID

README

PayPal checkout integration for OXID eShop 6.1 and above.

Documentation

• Official German PayPal Checkout for OXID 6.1 to 6.2 documentation
• Official German PayPal Checkout for OXID 6.3 to 6.5 documentation
• Official German PayPal Checkout for OXID from 7.0 documentation
• Official English PayPal Checkout for OXID 6.1 to 6.2 documentation
• Official English PayPal Checkout for OXID 6.3 to 6.5 documentation
• Official English PayPal Checkout for OXID from 7.0 documentation

Branch Compatibility

• b-7.0.x module branch is compatible with OXID eShop compilation 7.0, 7.1
• b-6.3.x module branch is compatible with OXID eShop compilation 6.3, 6.4, 6.5
• b-6.1.x module branch is compatible with OXID eShop compilation 6.1, 6.2

Install for OXID

• see Official documentation

Limitations

• no limitations

Merging Strategy

• The b-6.3.x branch is compatible with OXID6.3 to 6.5 and will not be merged automatically into the b-7.0.x branch
• if something changes in the b-6.3.x main branch, it must be ported to the b-7.0.x branch

Running tests

Warning: Running tests will reset the shop.

Requirements

• Ensure test_config.yml is configured:

  partial_module_paths: osc/paypal
  

  activate_all_modules: true
  run_tests_for_shop: false
  run_tests_for_modules: true
  

• For codeception tests to be running, selenium server should be available, several options to solve this:
  • Use OXID official docker sdk configuration.
  • Use other preconfigured containers, example: image: 'selenium/standalone-chrome-debug:3.141.59'

Run

Running phpunit tests:

vendor/bin/runtests

Running phpunit tests with coverage reports (report is generated in .../paypal/Tests/reports/ directory):

XDEBUG_MODE=coverage vendor/bin/runtests-coverage

Running codeception tests default way (Host: selenium, browser: chrome): in OXID 6.3 and above:

vendor/bin/runtests-codeception

Running codeception tests example with specific host/browser/testgroup: in OXID 6.3 and above:

SELENIUM_SERVER_HOST=seleniumchrome BROWSER_NAME=chrome vendor/bin/runtests-codeception --group=examplegroup

CodeStyle commands

The following Composer commands are available for checking and maintaining code quality:

PHP Mess Detector (PHPMD)

• composer md - Run PHPMD checks on locally modified files
• composer md:commit - Run PHPMD checks on files changed in the last commit

PHPStan

• composer stan - Run static analysis checks on locally modified files
• composer stan:commit - Run static analysis checks on files changed in the last commit

PHP CodeSniffer (PHPCS)

• composer cs - Run coding standards checks on locally modified files
• composer cs:commit - Run coding standards checks on files changed in the last commit

Combined Checks

• composer style - Run all code quality checks (PHPMD, PHPStan, and PHPCS) on locally modified files
• composer style:commit - Run all code quality checks on files changed in the last commit

Each command has two variants:

• Default version checks files that have local modifications but haven't been committed
• :commit suffix version checks only the files that were changed in the most recent commit

These commands help maintain consistent code quality by checking:

• Code style and formatting (PHPCS)
• Potential problems and complexity issues (PHPMD)
• Type safety and potential bugs (PHPStan)