fatchip-gmbh/kustom-checkout-oxid7

Kustom Checkout module for OXID eShop version 7.X

dev-main 2025-10-23 15:08 UTC

Requires

• php: >=8.0
• rmccue/requests: ^1.0
• viison/address-splitter: ^0.3.4

Requires (Dev)

• phpunit/phpunit: *
• phpunit/phpunit-selenium: >=1.2

Apache-2.0

README

General

Title: Kustom Checkout Module for the OXID eShop

Author: Fatchip GmbH, https://www.fatchip.de

Prefix: fckustom

Version: 1.0.0

Link: https://www.kustom.co/checkout

Mail: [e-mail]

Description

OXID eShop Plugin to integrate Kustom Checkout to OXID eShop Version >= 7.0.0

Installation

1. Run composer require to install the package.

In the shop's main folder ( the one with composer.json file) run this command:

composer require fatchip-gmbh/kustom-checkout-oxid7:*

or add the following line within the "require" section to your composer.json file:

"fatchip-gmbh/kustom-checkout-oxid7": "*"

and run

composer install

Update

For update instructions, please check the documentation.

Testing

The tests are configured to work with OXIDs docker-eshop-sdk-recipes. To set up the testing environment using the sdk-recipies, follow these steps:

• follow the installation instructions and chose ./recipes/oxid-esales/shop/b-7.0.x-ce-dev/run.sh as the desired recipe.
• install the module using composer.
• activate the module.
• tweak the shop root's composer.json to prepare it for the oxid testing libraries dependencies:

// notice: some packages need to be downgraded for the testing library to work.
    "require-dev": {
        "phpunit/phpunit": "^9.6",
        "squizlabs/php_codesniffer": "^3.5.4",
        "oxid-esales/testing-library": "dev-b-7.0.x",
        "codeception/module-webdriver": "^3",
        "codeception/lib-innerbrowser": "^3"
    }

• run composer update
• add a test_config.yml to your shop root and configure it for the module:

mandatory_parameters:
  partial_module_paths: fatchip-gmbh/kustom-checkout-oxid7
  shop_path: /var/www/source

optional_parameters:
  activate_all_modules: true
  run_tests_for_shop: false
  run_tests_for_modules: true

• configure a symlink from source/modules to vendor/[MODULE REPO]
• run the tests using phpunit -c [SOURCE/MODULES PATH]/phpunit.xml

Documentation

You'll find a detailed documentation in German here: https://wiki.fatchip.de/public/faqkustom7 and in English here: https://github.com/FATCHIP-GmbH/kustom-checkout-oxid7/wiki