Merge pull request #1 from daryush/feature/custom-fields

Custom fields basic API support

Author: rtvisser

lib/Trello/Api/Board.php

@@ -336,4 +336,14 @@ public function powerUps()
     {
         return new Board\PowerUps($this->client);
     }
+
+    /**
+     * Board CustomFields API
+     *
+     * @return Board\CustomFields
+     */
+    public function customFields()
+    {
+        return new Board\CustomFields($this->client);
+    }
 }

lib/Trello/Api/Board/CustomFields.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Trello\Api\Board;
+
+use Trello\Api\AbstractApi;
+
+/**
+ * Trello Board custom fields API
+ * @link https://developers.trello.com/docs/getting-started-custom-fields
+ *
+ */
+class CustomFields extends AbstractApi
+{
+    /**
+     * Base path of board custom fields api
+     * @var string
+     */
+    protected $path = 'boards/#id#/customFields';
+
+    /**
+     * Get custom fields related to a given board
+     * @link https://developers.trello.com/docs/getting-started-custom-fields#section-get-custom-fields-on-a-board
+     *
+     * @param string $id     the board's
+     * @param array  $params optional parameters
+     *
+     * @return array
+     */
+    public function all($id, array $params = array())
+    {
+        return $this->get($this->getPath($id), $params);
+    }
+}

lib/Trello/Api/Card.php

@@ -517,4 +517,14 @@ public function stickers()
     {
         return new Card\Stickers($this->client);
     }
+
+    /**
+     * CustomFieldItems API
+     *
+     * @return Card\CustomFieldItems
+     */
+    public function customFieldItems()
+    {
+        return new Card\CustomFieldItems($this->client);
+    }
 }

lib/Trello/Api/Card/CustomFieldItems.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Trello\Api\Card;
+
+use Trello\Api\AbstractApi;
+
+/**
+ * Trello Card custom fields items API
+ * @link https://developers.trello.com/docs/getting-started-custom-fields#section-custom-field-values-on-cards
+ *
+ */
+class CustomFieldItems extends AbstractApi
+{
+    /**
+     * Base path of cards api
+     * @var string
+     */
+    protected $path = 'cards/#id#/';
+
+    /**
+     * Get custom fiedls items related to a given card
+     * @link https://developers.trello.com/docs/getting-started-custom-fields#section-getting-customfielditems-for-cards
+     *
+     * @param string $id     the card's id or short link
+     * @param array  $params optional parameters
+     *
+     * @return array
+     */
+    public function all($id, array $params = array())
+    {
+        $params = array_merge($params, array('customFieldItems' => 'true'));
+        $data = $this->get($this->getPath($id), $params);
+
+        return array_key_exists('customFieldItems', $data) ? $data['customFieldItems'] : array();
+    }
+}