Merge pull request #128 from akeneo/API-410

API-410: Add doc for php client about family variant and product model creation

Author: Willy Mesnage

content/php-client/resources/family-variants.md

@@ -30,3 +30,29 @@ $client = new \Akeneo\Pim\AkeneoPimClientBuilder('http://akeneo.com/')->buildAut
  */
 $familyVariant = $client->getFamilyVariantApi()->get('boots', 'boots_color_size');
 ```
+
+### Create a family variant
+
+If the family variant does not exist yet, this method creates it, otherwise it throws an exception.
+
+```php
+$client = new \Akeneo\Pim\AkeneoPimClientBuilder('http://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+$client->getFamilyVariantApi()->create('boots', 'boots_size_color', [
+    'labels' => [
+        'en_US' => 'Boots by color and size'
+    ],
+    'variant_attribute_sets' => [
+        [
+            'level' => 1,
+            'axes' => ['size'],
+            'attributes' => ['name', 'description', 'size']
+        ],
+        [
+            'level' => 2,
+            'axes' => ['color'],
+            'attributes' => ['sku', 'color']
+        ]
+    ]
+]);
+```

content/php-client/resources/product-models.md

@@ -27,3 +27,35 @@ $client = new \Akeneo\Pim\AkeneoPimClientBuilder('http://akeneo.com/')->buildAut
  */
 $productModel = $client->getProductModelApi()->get('rain_boots_red');
 ```
+
+### Create a product model
+
+If the product model does not exist yet, this method creates it, otherwise it throws an exception.
+
+```php
+$client = new \Akeneo\Pim\AkeneoPimClientBuilder('http://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+$client->getProductModelApi()->create('saddle_rain_boots', [
+  'family_variant' => 'boots_color_size',
+  'parent' => 'rain_boots',
+  'categories' => ['2014_collection', 'winter_boots', 'winter_collection'],
+  'values' => [
+      'name' => [
+          [
+              'locale' => 'en_US',
+              'scope' => null,
+              'data' => 'Saddle rain boots',
+          ]
+      ],
+      'color' => [
+          [
+              'locale' => null,
+              'scope' => null,
+              'data' => 'saddle'
+          ]
+      ]
+  ]
+]);
+```
+
+Product model values use the same format as the product values. If you want to know more, take a look at [here](/documentation/resources.html#product-values).