oxid-esales/graphql-storefront

OXID eSales GraphQL storefront module

Installs: 30 004

Dependents: 1

Suggesters: 0

Security: 0

Stars: 20

Watchers: 9

Forks: 8

Type:oxideshop-module

v4.0.0-rc.1 2024-11-04 11:18 UTC

README

Build Status

Latest Version PHP Version

Quality Gate Status Coverage Technical Debt

This module provides GraphQL queries and mutations for the OXID eShop storefront.

Usage

This assumes you have OXID eShop (at least oxid-esales/oxideshop_ce: v7.0.0 component, which is part of the v7.0.0 compilation) up and running.

Branch compatibility

  • 4.0.x versions (or b-7.2.x branch) are compatible with OXID eShop compilation b-7.2.x (which uses graphql-base 10.x version resp. b-7.2.x branch)
  • 3.1.x versions (or b-7.1.x branch) are compatible with OXID eShop compilation b-7.1.x (which uses graphql-base 9.x version resp. b-7.1.x branch)
  • 3.x versions (or b-7.0.x branch) are compatible with OXID eShop compilation b-7.0.x (which uses graphql-base 8.x version resp. b-7.0.x branch)
  • ^2.1 versions (b-6.5.x branch) are compatible with OXID eShop compilation b-6.5.x (which uses graphql-base 7.x version resp. b-6.5.x branch)
  • 2.0.x versions (b-6.4.x branch) are compatible with OXID eShop compilation b-6.4.x (which uses graphql-base 6.x version resp. b-6.4.x branch)
  • 1.x versions (b-6.3.x branch) are compatible with OXID eShop compilation 6.3.x (no PHP8 support)

Install

Switch to the shop root directory (the file composer.json and the directories source/ and vendor/ are located there).

# Install desired version of oxid-esales/graphql-storefront module, in this case - latest released 3.x version
$ composer require oxid-esales/graphql-storefront ^3.0.0

If you didn't have the oxid-esales/graphql-base module installed, composer will do that for you.

You should run migrations both after installing the module and after each module update:

$ vendor/bin/oe-eshop-doctrine_migration migrations:migrate oe_graphql_base
$ vendor/bin/oe-eshop-doctrine_migration migrations:migrate oe_graphql_storefront

After installing the module, you need to activate it, either via OXID eShop admin or CLI.

$ vendor/bin/oe-console oe:module:activate oe_graphql_base
$ vendor/bin/oe-console oe:module:activate oe_graphql_storefront

How to use

A good starting point is to check the How to use section in the GraphQL Base Module

Testing

Linting, syntax check, static analysis

$ composer update
$ composer static

Unit/Integration/Acceptance tests

  • install this module into a running OXID eShop
  • reset shop's database
$ bin/oe-console oe:database:reset --db-host=db-host --db-port=db-port --db-name=db-name --db-user=db-user --db-password=db-password --force
  • run Unit tests
$ ./vendor/bin/phpunit -c vendor/oxid-esales/graphql-storefront/tests/phpunit.xml
  • run Integration tests
$ ./vendor/bin/phpunit --bootstrap=./source/bootstrap.php -c vendor/oxid-esales/graphql-storefront/tests/phpintegration.xml
  • run Acceptance tests
$ SELENIUM_SERVER_HOST=selenium MODULE_IDS=oe_graphql_storefront vendor/bin/codecept run acceptance -c vendor/oxid-esales/graphql-storefront/tests/codeception.yml

Contributing

You like to contribute? 🙌 AWESOME 🙌
Go and check the contribution guidelines

Build with

License

OXID Module and Component License, see LICENSE file.