[On Hold] - API-1859: PHP client Catalog update

Author: tomglvng

content/php-client/resources/app-catalog/app-catalog-product.md

@@ -0,0 +1,19 @@
+### App catalog product
+
+
+#### Get the list of product uuids
+::: php-client-availability versions=9.1 editions=CE,EE
+
+```php
+$client = new \Akeneo\Pim\ApiClient\AkeneoPimClientBuilder('https://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+/*
+ * Returns an array like the following:
+ * [
+ *  "844c736b-a19b-48a6-a354-6056044729f0",
+ *  "b2a683ef-4a91-4ed3-b3fa-76dab065a8d5",
+ *  "eddfbd2a-abc7-488d-b9e3-41289c824f80"
+ * ]
+ */
+$catalogs = $client->getAppCatalogProductApi()->all();
+```

content/php-client/resources/app-catalog/app-catalog.md

@@ -0,0 +1,75 @@
+### App catalog
+
+
+#### Get the list of owned catalogs
+::: php-client-availability versions=9.1 editions=CE,EE
+
+```php
+$client = new \Akeneo\Pim\ApiClient\AkeneoPimClientBuilder('https://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+/*
+ * Returns an array like the following:
+ * [
+ *  {
+ *      "id": "12351d98-200e-4bbc-aa19-7fdda1bd14f2",
+ *      "name": "Store FR",
+ *      "enabled": true
+ *  },
+ * {
+ *      "id": "12351d98-200e-4bbc-aa19-7fdda1bd14f3",
+ *      "name": "Store US",
+ *      "enabled": true
+ *  }
+ * ]
+ */
+$catalogs = $client->getAppCatalogApi()->all();
+```
+
+
+#### Get a catalog
+::: php-client-availability versions=9.1 editions=CE,EE
+
+```php
+$client = new \Akeneo\Pim\ApiClient\AkeneoPimClientBuilder('https://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+/*
+ * Returns an object like the following :
+ *  {
+ *      "id": "12351d98-200e-4bbc-aa19-7fdda1bd14f2",
+ *      "name": "Store FR",
+ *      "enabled": true
+ *  }
+ */
+$catalogs = $client->getAppCatalogApi()->get('12351d98-200e-4bbc-aa19-7fdda1bd14f2');
+```
+
+#### Create a new catalog
+::: php-client-availability versions=9.1 editions=CE,EE
+
+If the catalog does not exist yet, this method creates it, otherwise it throws an exception.
+
+```php
+$client = new \Akeneo\Pim\ApiClient\AkeneoPimClientBuilder('http://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+$client->getAppCatalogApi()->create(['name' => 'A catalog name']);
+```
+
+
+#### Update a catalog
+::: php-client-availability versions=9.1 editions=CE,EE
+
+```php
+$client = new \Akeneo\Pim\ApiClient\AkeneoPimClientBuilder('http://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+$client->getAppCatalogApi()->upsert(['name' => 'A catalog name']);
+```
+
+
+#### Delete a catalog
+::: php-client-availability versions=9.1 editions=CE,EE
+
+```php
+$client = new \Akeneo\Pim\ApiClient\AkeneoPimClientBuilder('http://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+$client->getAppCatalogApi()->delete('12351d98-200e-4bbc-aa19-7fdda1bd14f2');
+```

tasks/build-doc.js

@@ -647,6 +647,13 @@ gulp.task('build-concepts', ['clean-dist','less'], function () {
   }
 );
 
+gulp.task('create-app-catalog-md', function () {
+    return gulp.src(['content/php-client/resources/app-catalog/app-catalog.md','content/php-client/resources/app-catalog/app-catalog.md','content/php-client/resources/app-catalog/*.md'])
+        .pipe(concat('app-catalog.md'))
+        .pipe(insert.prepend('## App catalog\n'))
+        .pipe(gulp.dest('tmp/php-client-resources/'));
+});
+
 gulp.task('create-products-md', function () {
     return gulp.src(['content/php-client/resources/products/products.md','content/php-client/resources/products/product-models.md','content/php-client/resources/products/*.md'])
         .pipe(concat('products.md'))
@@ -683,13 +690,14 @@ gulp.task('create-asset-manager-md', function () {
         .pipe(insert.prepend('## Asset Manager\n'))
         .pipe(gulp.dest('tmp/php-client-resources/'));
 });
-gulp.task('create-resources-md', ['create-products-md','create-catalog-structure-md', 'create-target-market-settings-md', 'create-PAM-md', 'create-reference-entity-md', 'create-asset-manager-md'], function () {
+gulp.task('create-resources-md', ['create-app-catalog-md','create-products-md','create-catalog-structure-md', 'create-target-market-settings-md', 'create-PAM-md', 'create-reference-entity-md', 'create-asset-manager-md'], function () {
     return gulp.src(['tmp/php-client-resources/products.md',
                     'tmp/php-client-resources/catalog-structure.md',
                     'tmp/php-client-resources/target-market-settings.md',
                     'tmp/php-client-resources/asset-manager.md',
                     'tmp/php-client-resources/PAM.md',
-                    'tmp/php-client-resources/reference-entity.md'])
+                    'tmp/php-client-resources/reference-entity.md',
+                    'tmp/php-client-resources/app-catalog.md'])
         .pipe(concat('resources.md'))
         .pipe(insert.prepend('# Resources\n'))
         .pipe(gulp.dest('tmp/php-client'));