bestit / commercetools-odm-bundle
Makes the commercetools database accessible with the doctrine commons api.
Installs: 23 723
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 2
Open Issues: 1
Type:lib
Requires
- php: ^7.2.5
- bestit/commercetools-odm: ^1.0
- symfony/dependency-injection: ^3.1 || ^4.0 || ^5.0
- symfony/http-kernel: ^3.1 || ^4.0 || ^5.0
- symfony/yaml: ^3.1 || ^4.0 || ^5.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-11-22 20:06:12 UTC
README
Makes the commercetools database accessible with the doctrine commons api. It still uses the commmercetools/php-sdk under the hood.
Installation
Step 1: Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
$ composer require bestit/commercetools-odm-bundle
This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.
Step 2: Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the app/AppKernel.php
file of your project:
<?php // app/AppKernel.php // ... class AppKernel extends Kernel { public function registerBundles() { $bundles = array( // ... new BestIt\CommercetoolsODMBundle\BestItCommercetoolsODMBundle(), ); // ... } // ... }
Step 3: Configure the Bundle
# Default configuration for "BestItCommercetoolsODMBundle"
bestit_commercetools_odm:
# Please provide the service id for your commercetools client.
client_service_id: ~ # Required
# Please provide the service id for your commercetools request async pool.
pool_service_id: ~
This bundle ships a client factory which you can use to create a client. Example:
services:
Commercetools\Core\Client:
factory: 'BestIt\CommercetoolsODMBundle\Factory\ClientFactory:create'
arguments:
- {client_id: '%env(COMMERCETOOLS_CLIENT_ID)%', client_secret: '%env(COMMERCETOOLS_CLIENT_SECRET)%', project: '%env(COMMERCETOOLS_PROJECT)%', scope: ['manage_project'] }
- {locale: 'de', languages: ['de'] }
BestIt\CommercetoolsODMBundle\Factory\ClientFactory:
class: BestIt\CommercetoolsODMBundle\Factory\ClientFactory
arguments: ['@cache.app', '@logger']
Usage
Event Listener with the sercice container
You can add an event listener to the typical live cycle events if you tag your service with the name best_it_commercetools_odm.event_listener. But don't forget the name of the event with the key event on your tag.
Example:
# app/config/services.yml services: app.tokens.action_listener: class: AppBundle\EventListener\TokenListener arguments: ['%tokens%'] tags: - { name: best_it_commercetools_odm.event_listener, event: postPersist }
the method of the service should match the event name.
Services
The service best_it.commercetools_odm.manager provices you with an extended Doctrine\Common\Persistence\ObjectManager.
the method of the service should match the event name.
Filters
You can add multiple filters to apply on requests. Just create one filter, implement the FilterInterface and tag the service with best_it_commercetools_odm.filter. The filter get the raw created request and will be applied just before the request will be send.
Example:
// ProductFilter.php class ProductFilter implements FilterInterface { /** * {@inheritdoc} */ public function getKey() { return 'product'; } /** * {@inheritdoc} */ public function apply($request) { $request->setExpands(['masterVariant.attributes[*].value', 'productType', 'categories[*].ancestors[*]']); $request->channel('xyz'); $request->currency('EUR'); } }
# app/config/services.yml services: app.filter.product_filter: class: AppBundle\Filter\ProductFilter tags: - { name: best_it_commercetools_odm.filter }
Now you can apply the one or more filter whenever you want:
app.repository.product_projection: class: BestIt\CommercetoolsODM\Model\ProductProjectionRepository factory: ["@best_it.commercetools_odm.manager", getRepository] arguments: - Commercetools\Core\Model\Product\ProductProjection calls: - [filter, ['projection', 'projection-categories']]