Added context into the custom connector documentation

Author: sebprt

content/connectivity/custom/_index.en.md

@@ -33,169 +33,58 @@ This plugin is already integrated into the Satellite package, so you can’t req
 
 Unlike other plugins, the configuration is the same whether it is an extractor, a transformer or a loader.
 
-First you need to [determine your services](../../feature/services) in your pipeline or workflow and then use the `use` 
-option which allows you to define which service to use.
-
 ### Building an extractor
 
+In the example given, we explain how to configure a custom extractor with the `Bar` class located in the `App\Class` namespace.
+
+Here's a more detailed explanation:
+
 ```yaml
 custom:
   extractor:
-    use: 'App\Class\Bar'
+    use: 'App\Class\Bar' # This line specifies the extractor class you want to use.
     services:
-      App\Class\Bar: ~
+      App\Class\Bar: ~ # Here, we declare the service associated with the Bar class with the syntax App\Class\Bar: ~. This simply indicates that we want to use the default parameters for this service.
 ```
 
+For more details about service configurations, please visit the [declaring-services](../../feature/services) documentation.
+
 ### Building a transformer
 
+In the example given, we explain how to configure a custom extractor with the `Bar` class located in the `App\Class` namespace.
+
+Here's a more detailed explanation:
+
 ```yaml
 custom:
   transformer:
-    use: 'App\Class\Bar'
+    use: 'App\Class\Bar' # This line specifies the extractor class you want to use.
     services:
-      App\Class\Bar:
-        factory: 
+      App\Class\Bar: # Here, we declare the service associated with the Bar class.
+        factory: # This section indicates that the service must be created by calling the extract method of the App\Class\Bar class.
           class: App\Class\Bar
           method: extract
-        arguments:
+        arguments: # The arguments to be passed to the extract method. In this example, the @foo symbol indicates that the foo service should be injected as an argument. Make sure that the foo service is configured correctly elsewhere in your pipeline.
           - '@foo'
+      foo: ~
 ```
 
-### Building a loader
-
-```yaml
-custom:
-  loader:
-    use: 'App\Class\Bar'
-    services:
-      App\Class\Bar:
-        calls:
-          - withUsername: [ 'admin' ]
-```
-
-## Usage examples
-
-Some examples of pipeline with Magento to extract, FastMap to transform and ZohoCRM to load data
+For more details about service configurations, please visit the [declaring-services](../../feature/services) documentation.
 
-### Example of an extractor
-
-```yaml
-custom:
-  extractor:
-    use: 'App\Component\Flow\Magento2\CustomerExtractor'
-    services:
-      App\Component\Flow\Magento2\CustomerExtractor:
-        arguments:
-          - '@Monolog\Logger'
-          - ['@firstname_filter_group_1', '@firstname_filter_group_2']
-        public: true
-      firstname_filter_group_1:
-        class: App\Component\Flow\Magento2\FilterGroup
-        calls:
-          - withFilter: [ '@firstname_filter_1' ]
-      firstname_filter_1:
-        class: App\Component\Flow\Magento2\Filter
-        arguments:
-          - 'firstname'
-          - 'nlike'
-          - '%bm01.cc'
-      firstname_filter_group_2:
-        class: App\Component\Flow\Magento2\FilterGroup
-        calls:
-          - withFilter: [ '@firstname_filter_2' ]
-      firstname_filter_2:
-        class: App\Component\Flow\Magento2\Filter
-        arguments:
-          $field: 'firstname'
-          $conditionType: 'nlike'
-          $value: '%.xyz'
-      Monolog\Logger:
-        arguments:
-          - 'app'
-          - [ '@Monolog\Handler\StreamHandler' ]
-      Monolog\Handler\StreamHandler:
-        arguments:
-          - 'var/dev.log'
-          - 300
-```
+### Building a loader
 
-You can write the arguments of your service in 2 different ways.
-You can list them with a '-' but you need to respect the order of the arguments in the constructor,
-or you can simply name the arguments by their variable name in the constructor.
-
-#### Filter class constructor :
-```php
-class Filter
-{
-  public function __construct(
-      public string $field,
-      public string $conditionType,
-      public string $value,
-  ) {
-  }
-}
-```
+In the example given, we explain how to configure a custom extractor with the `Bar` class located in the `App\Class` namespace.
 
-### Example of a transformer
-```yaml
-custom:
-  transformer:
-    use: 'App\CachedAttributeLookup'
-    services:
-      PDO:
-        arguments:
-          - 'mysql:host=127.0.0.1;port=3306;dbname=lacelier'
-          - 'user'
-          - 'password'
-      App\CachedAttributeLookup:
-        arguments:
-          - '@PDO'
-          - 'SELECT * FROM color WHERE region=:region AND code=:code'
-          - '@Cache\Adapter\Apcu\ApcuCachePool'
-          - 'color'
-          - '@App\ColorLookupMapper'
-        public: true
-      App\ColorLookupMapper: ~
-      Cache\Adapter\Apcu\ApcuCachePool: ~
-      Symfony\Component\Cache\Adapter\ApcuAdapter: ~
-```
+Here's a more detailed explanation:
 
-### Example of a loader
 ```yaml
 custom:
   loader:
-    use: 'App\Component\Flow\ZohoCRM\ContactLoader'
+    use: 'App\Class\Bar' # This line specifies the extractor class you want to use.
     services:
-      App\Component\Flow\ZohoCRM\ContactLoader:
-        arguments:
-          - '@App\Component\Flow\ZohoCRM\Client\Client'
-          - '@Monolog\Logger'
-        public: true
-      GuzzleHttp\Client: ~
-      GuzzleHttp\Psr7\HttpFactory: ~
-      App\Component\Flow\ZohoCRM\Client\AuthenticationMiddleware:
-        arguments:
-          - '@GuzzleHttp\Client'
-          - '@GuzzleHttp\Psr7\HttpFactory'
-          - '@GuzzleHttp\Psr7\HttpFactory'
-          - '%env(ZOHO_OAUTH_HOST)%'
-          - '%env(ZOHO_CLIENT_ID)%'
-          - '%env(ZOHO_CLIENT_SECRET)%'
-          - '%env(ZOHO_ACCESS_TOKEN)%'
-          - '%env(ZOHO_REFRESH_TOKEN)%'
-      App\Component\Flow\ZohoCRM\Client\Client:
-        arguments:
-          - '%env(ZOHO_BASE_HOST)%'
-          - '@App\Component\Flow\ZohoCRM\Client\AuthenticationMiddleware'
-          - '@GuzzleHttp\Psr7\HttpFactory'
-          - '@GuzzleHttp\Psr7\HttpFactory'
-          - '@GuzzleHttp\Psr7\HttpFactory'
-      Monolog\Logger:
-        arguments:
-          - 'app'
-          - [ '@Monolog\Handler\StreamHandler' ]
-      Monolog\Handler\StreamHandler:
-        arguments:
-          - 'var/dev.log'
-          - 300
+      App\Class\Bar: # Here, we declare the service associated with the Bar class.
+        calls: # This section indicates that specific method calls must be made to the service instance.
+          - withUsername: [ 'admin' ] # This means that a method call named withUsername must be made to the instance of the Bar class, with the username "admin" passed as an argument.
 ```
+
+For more details about service configurations, please visit the [declaring-services](../../feature/services) documentation.