oxid-esales / graphql-configuration-access
OXID eSales GraphQL configuration access module
Installs: 549
Dependents: 0
Suggesters: 0
Security: 0
Stars: 14
Watchers: 2
Forks: 1
Type:oxideshop-module
Requires
- php: ^8.2
- doctrine/dbal: ^v2.7
- oxid-esales/graphql-base: ^v10.0.0
Requires (Dev)
- codeception/codeception: ^5.0
- codeception/module-asserts: ^3.0
- codeception/module-db: *
- codeception/module-phpbrowser: *
- codeception/module-rest: *
- mikey179/vfsstream: ~1.6.8
- oxid-esales/codeception-modules: dev-b-7.2.x
- oxid-esales/oxideshop-ce: dev-b-7.2.x
- phpmd/phpmd: ^2.11
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^10.4
- qossmic/deptrac-shim: ^1.0.2
- squizlabs/php_codesniffer: 3.*
- dev-b-7.3.x
- v2.0.0
- v2.0.0-rc.1
- v1.2.0
- v1.2.0-rc.1
- v1.1.0
- v1.1.0-rc.1
- v1.0.0
- dev-b-7.2.x
- dev-b-7.2.x-add_mariadb-OXDEV-8009
- dev-b-7.1.x
- dev-b-7.1.x-fix-sonarcloud
- dev-b-7.2.x-improve-module-list
- dev-b-7.1.x-fixate-dependencies
- dev-b-7.0.x-new_dev_recipes-OXDEV-7845
- dev-b-7.0.x
- dev-b-7.0.x-list_queries-OXDEV-7460-rebased
- dev-b-7.0.x-list_queries-OXDEV-7460
- dev-b-7.0.x-shop_queries-OXDEV-7459
- dev-b-7.0.x-type_validation-OXDEV-7352
- dev-b-7.0.x-remove_datatypes_description-OXDEV-7509
This package is auto-updated.
Last update: 2025-04-25 13:49:54 UTC
README
graphql-configuration-access
OXAPI (GraphQL based) access to configuration settings
Why we use this schema
To fetch and update the configurations we implemented a different query/mutation per value-type. We have chosen this schema because of GraphQL's strictness which doesn't allow for dynamic types. Without these types, the API consumer would always have to convert the value after queries or before mutations if, for example, we decided to use json encoded strings instead.
To get the specific type of a configuration, we provide queries like
shopSettings
/moduleSettings
/themeSettings
to figure out the type for configurations.
As a result you get an array of setting types:
type SettingType {
name: string!
type: FieldType!
isSupported: boolean!
}
enum FieldType {
'str'
'select'
'bool'
'num
'arr'
'aarr'
}
Branch compatibility
- b-7.3.x branch is compatible with OXID eShop compilation b-7.3.x (which uses
graphql-base
b-7.3.x branch) - 1.2.x + 2.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) - 1.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)
Documentation
- Full documentation can be found here.
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-configuration-access module, in this case - latest released 2.x version
$ composer require oxid-esales/graphql-configuration-access ^2.0.0
If you didn't have the oxid-esales/graphql-base
module installed, composer will do that for you.
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_configuration_access
How to use
A good starting point is to check the How to use section in the GraphQL Base Module
Blocking modules from de/activation via GraphQL
The file module_blockilst.yaml contains a list of modules which are necessary to handle configurations or de/activate
modules via GraphQL or should be blocked for de/activation via GraphQL in general. Modules like oe_graphql_base
and
oe_graphql_configuration_access
are listed there.
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 + Integration tests
$ composer phpunit
- run Unit tests
$ ./vendor/bin/phpunit -c vendor/oxid-esales/graphql-configuration-access/tests/phpunit.xml
- run Integration tests
$ ./vendor/bin/phpunit --bootstrap=./source/bootstrap.php -c vendor/oxid-esales/graphql-configuration-access/tests/phpintegration.xml
- run Acceptance tests
$ composer codeception
Development installation on OXID eShop SDK
The installation instructions below are shown for the current SDK for shop 7.3. Make sure your system meets the requirements of the SDK.
-
Ensure all docker containers are down to avoid port conflicts
-
Clone the SDK for the new project
echo MyProject && git clone https://github.com/OXID-eSales/docker-eshop-sdk.git $_ && cd $_
- Clone the repository to the source directory
git clone --recurse-submodules https://github.com/OXID-eSales/graphql-configuration-access.git --branch=b-7.3.x ./source
- Run the recipe to setup the development environment
./source/recipes/setup-development.sh
You should be able to access the shop with http://localhost.local and the admin panel with http://localhost.local/admin (credentials: noreply@oxid-esales.com / admin)
Running tests locally
Check the "scripts" section in the composer.json
file for the available commands. Those commands can be executed
by connecting to the php container and running the command from there, example:
make php composer tests-coverage
Commands can be also triggered directly on the container with docker compose, example:
docker compose exec -T php composer tests-coverage