Merge pull request zendesk#372 from abackstrom/helpcenter-article-cre…

…ation

Implement HelpCenter Article creation

samples/helpcenter/createArticles.php

@@ -0,0 +1,31 @@
+<?php
+
+include('../../vendor/autoload.php');
+
+use Zendesk\API\HttpClient as ZendeskAPI;
+
+/**
+ * Replace the following with your own.
+ */
+
+$subdomain = "subdomain";
+$username = "email@example.com";
+$token = "6wiIBWbGkBMo1mRDMuVwkw1EPsNkeUj95PIz2akv";
+
+$client = new ZendeskAPI($subdomain);
+$client->setAuth('basic', ['username' => $username, 'token' => $token]);
+
+try {
+    // Create a new HelpCenter Article
+    $sectionId = 1;
+    $article = $client->helpCenter->sections($sectionId)->articles()->create([
+        'locale' => 'en-us',
+        'title' => 'Smartest Fish in the World',
+    ]);
+    echo "<pre>";
+    print_r($article);
+    echo "</pre>";
+} catch (\Zendesk\API\Exceptions\ApiResponseException $e) {
+    echo $e->getMessage().'</br>';
+}
+

src/Zendesk/API/Resources/HelpCenter/Articles.php

@@ -14,7 +14,9 @@
 class Articles extends ResourceAbstract
 {
     use Defaults;
-    use Locales;
+    use Locales {
+        getRoute as protected localesGetRoute;
+    }
     use Search;
 
     /**
@@ -30,6 +32,7 @@ protected function setupRoutes()
         parent::setUpRoutes();
         $this->setRoutes([
             'bulkAttach'            =>  "$this->resourceName/{articleId}/bulk_attachments.json",
+            'create'                =>  "{$this->prefix}sections/{section_id}/articles.json",
             'updateSourceLocale'    =>  "$this->resourceName/{articleId}/source_locale.json",
         ]);
     }
@@ -60,4 +63,16 @@ public function bulkAttach($articleId, array $params, $routeKey = __FUNCTION__)
             ['attachment_ids' => $params]
         );
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getRoute($name, array $params = [])
+    {
+        $params = $this->addChainedParametersToParams($params, [
+            'section_id' => Sections::class,
+        ]);
+
+        return $this->localesGetRoute($name, $params);
+    }
 }

src/Zendesk/API/Resources/HelpCenter/Sections.php

@@ -4,13 +4,16 @@
 
 use Zendesk\API\Traits\Resource\Defaults;
 use Zendesk\API\Traits\Resource\Locales;
+use Zendesk\API\Traits\Utility\InstantiatorTrait;
 
 /**
  * Class Sections
  * https://developer.zendesk.com/rest_api/docs/help_center/categories
  */
 class Sections extends ResourceAbstract
 {
+    use InstantiatorTrait;
+
     use Defaults;
     use Locales {
         getRoute as protected localesGetRoute;
@@ -32,6 +35,16 @@ protected function setUpRoutes()
         ]);
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public static function getValidSubResources()
+    {
+        return [
+            'articles' => Articles::class,
+        ];
+    }
+
     /**
      * Returns a route and replaces tokenized parts of the string with
      * the passed params

tests/Zendesk/API/UnitTests/HelpCenter/ArticlesTest.php

@@ -78,4 +78,20 @@ public function testSearch()
             $this->client->helpCenter->articles()->search($params);
         }, 'help_center/articles/search.json', 'GET', ['queryParams' => $params]);
     }
+
+    /**
+     * Test if Create article endpoint is called with correct params.
+     */
+    public function testCreate()
+    {
+        $faker = Factory::create();
+        $sectionId = $faker->numberBetween(1);
+        $params = ['title' => $faker->word, 'locale' => 'en'];
+
+        $this->assertEndpointCalled(function () use ($params, $sectionId) {
+            $this->client->helpCenter->sections($sectionId)->articles()->create($params);
+        }, "help_center/sections/{$sectionId}/articles.json", 'POST', [
+            'postFields' => ['article' => $params],
+        ]);
+    }
 }