Added a $folderId option to getMailItems() and getUnreadMailItems(). Upgrading version number

Author: Garethp

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.6.0 - 2015-11-16
+ * Added a `FolderIdType $folderId` option to `MailAPI::getMailItems()` and `MailAPI::getUnreadMailItems()`. Because this
+ is a minor BC breaking change, it gets a new new minor version, since this is a pre-1.0 release.
+
 ## 0.5.11 - 2015-11-16
  * Added an `API::getMailbox(string $folderName = null)` function
  * Added a `MailAPI::setFolderId(FolderIdType $folderId)` function

src/Mail/MailAPI.php

@@ -52,18 +52,23 @@ public function pickMailFolder($displayName = null, $parentFolder = 'inbox')
     /**
      * Get all mail items in the inbox
      *
+     * @param Type\FolderIdType
      * @param array $options
      * @return Type\MessageType[]
      */
-    public function getMailItems($options = array())
+    public function getMailItems($folderId = null, $options = array())
     {
+        if (!$folderId) {
+            $folderId = $this->getFolderId();
+        }
+
         $request = array(
             'Traversal' => 'Shallow',
             'ItemShape' => array(
                 'BaseShape' => 'AllProperties'
             ),
             'ParentFolderIds' => array(
-                'FolderId' => $this->getFolderId()->toXmlObject()
+                'FolderId' => $folderId->toXmlObject()
             )
         );
 
@@ -97,7 +102,12 @@ public function getMailItems($options = array())
         return $messages;
     }
 
-    public function getUnreadMailItems($options = array())
+    /**
+     * @param Type\FolderIdType $folderId
+     * @param array $options
+     * @return Type\MessageType[]
+     */
+    public function getUnreadMailItems($folderId = null, $options = array())
     {
         $unReadOption = array(
             'Restriction' => array(
@@ -109,7 +119,7 @@ public function getUnreadMailItems($options = array())
 
         $options = array_replace_recursive($unReadOption, $options);
 
-        return $this->getMailItems($options);
+        return $this->getMailItems($folderId, $options);
     }
 
     /**