feat(Customer): add salutation to customer

Closes #324

Author: Jens Schulze

src/Core/Model/Customer/Customer.php

@@ -65,12 +65,14 @@
  * @method Customer setShippingAddressIds(array $shippingAddressIds = null)
  * @method array getBillingAddressIds()
  * @method Customer setBillingAddressIds(array $billingAddressIds = null)
+ * @method string getSalutation()
+ * @method Customer setSalutation(string $salutation = null)
  * @method CustomerReference getReference()
  */
 class Customer extends Resource
 {
     use LocaleTrait;
-    
+
     public function fieldDefinitions()
     {
         return [
@@ -107,6 +109,7 @@ public function fieldDefinitions()
             'locale' => [static::TYPE => 'string'],
             'shippingAddressIds' => [static::TYPE => 'array'],
             'billingAddressIds' => [static::TYPE => 'array'],
+            'salutation' => [static::TYPE => 'string'],
         ];
     }
 

src/Core/Model/Customer/CustomerDraft.php

@@ -60,6 +60,8 @@
  * @method CustomerDraft setBillingAddresses(array $billingAddresses = null)
  * @method array getShippingAddresses()
  * @method CustomerDraft setShippingAddresses(array $shippingAddresses = null)
+ * @method string getSalutation()
+ * @method CustomerDraft setSalutation(string $salutation = null)
  */
 class CustomerDraft extends JsonObject
 {
@@ -92,6 +94,7 @@ public function fieldDefinitions()
             'locale' => [static::TYPE => 'string'],
             'billingAddresses' => [static::TYPE => 'array'],
             'shippingAddresses' => [static::TYPE => 'array'],
+            'salutation' => [static::TYPE => 'string'],
         ];
     }
 

src/Core/Request/Customers/Command/CustomerSetSalutationAction.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * @author @jayS-de <[email protected]>
+ */
+
+namespace Commercetools\Core\Request\Customers\Command;
+
+use Commercetools\Core\Model\Common\Context;
+use Commercetools\Core\Request\AbstractAction;
+
+/**
+ * @package Commercetools\Core\Request\Customers\Command
+ * @link https://dev.commercetools.com/http-api-projects-customers.html#set-salutation
+ * @method string getSalutation()
+ * @method CustomerSetSalutationAction setSalutation(string $salutation = null)
+ * @method string getAction()
+ * @method CustomerSetSalutationAction setAction(string $action = null)
+ */
+class CustomerSetSalutationAction extends AbstractAction
+{
+    public function fieldDefinitions()
+    {
+        return [
+            'action' => [static::TYPE => 'string'],
+            'salutation' => [static::TYPE => 'string'],
+        ];
+    }
+
+    /**
+     * @param array $data
+     * @param Context|callable $context
+     */
+    public function __construct(array $data = [], $context = null)
+    {
+        parent::__construct($data, $context);
+        $this->setAction('setSalutation');
+    }
+}

tests/fixtures/models.yaml

@@ -305,6 +305,7 @@ customer:
     - locale
     - shippingAddressIds
     - billingAddressIds
+    - salutation
 customerSigninResult:
   domain: customer
   model: CustomerSigninResult

tests/integration/Customer/CustomerUpdateRequestTest.php

@@ -31,6 +31,7 @@
 use Commercetools\Core\Request\Customers\Command\CustomerSetLastNameAction;
 use Commercetools\Core\Request\Customers\Command\CustomerSetLocaleAction;
 use Commercetools\Core\Request\Customers\Command\CustomerSetMiddleNameAction;
+use Commercetools\Core\Request\Customers\Command\CustomerSetSalutationAction;
 use Commercetools\Core\Request\Customers\Command\CustomerSetTitleAction;
 use Commercetools\Core\Request\Customers\Command\CustomerSetVatIdAction;
 use Commercetools\Core\Request\Customers\CustomerCreateRequest;
@@ -86,6 +87,23 @@ public function testCustomerEmail()
         $this->assertSame($email, $customer->getEmail());
     }
 
+    public function testSalutation()
+    {
+        $draft = $this->getDraft('salutation');
+        $customer = $this->createCustomer($draft);
+
+        $salutation = 'new-salutation';
+
+        $request = CustomerUpdateRequest::ofIdAndVersion($customer->getId(), $customer->getVersion())
+            ->addAction(CustomerSetSalutationAction::of()->setSalutation($salutation))
+        ;
+        $response = $request->executeWithClient($this->getClient());
+        $customer = $request->mapResponse($response);
+        $this->deleteRequest->setVersion($customer->getVersion());
+
+        $this->assertSame($salutation, $customer->getSalutation());
+    }
+
     public function testNoopCustomerEmail()
     {
         $draft = $this->getDraft('email');