Add orientation parameter for printfile endpoint.

Author: MBriedis

src/PrintfulMockupGenerator.php

@@ -1,9 +1,7 @@
 <?php
 
-
 namespace Printful;
 
-
 use Printful\Structures\Generator\GenerationResultItem;
 use Printful\Structures\Generator\MockupGenerationFile;
 use Printful\Structures\Generator\MockupGenerationParameters;
@@ -33,12 +31,19 @@ public function __construct(PrintfulApiClient $printfulClient)
      * Get all available templates for specific printful product
      *
      * @param int $productId Printful product id
+     * @param string|null $orientation Used for products with multiple orientations (e.g. wall art) {@see TemplateItem::ORIENTATION_HORIZONTAL} {@see TemplateItem::ORIENTATION_VERTICAL}
      * @return ProductPrintfiles
      * @throws Exceptions\PrintfulException
      */
-    public function getProductPrintfiles($productId)
+    public function getProductPrintfiles($productId, $orientation = null)
     {
-        $raw = $this->printfulClient->get('mockup-generator/printfiles/' . $productId);
+        $query = [];
+
+        if ($orientation) {
+            $query['orientation'] = $orientation;
+        }
+
+        $raw = $this->printfulClient->get('mockup-generator/printfiles/' . $productId, $query);
 
         $productPrintfiles = new ProductPrintfiles;
 
@@ -185,7 +190,7 @@ private function parametersToArray(MockupGenerationParameters $parameters)
      * This includes background images and area positions.
      *
      * @param int $productId
-     * @param string|null $orientation Used for wall art only {@see TemplateItem::ORIENTATION_HORIZONTAL} {@see TemplateItem::ORIENTATION_VERTICAL}
+     * @param string|null $orientation Used for products with multiple orientations (e.g. wall art) {@see TemplateItem::ORIENTATION_HORIZONTAL} {@see TemplateItem::ORIENTATION_VERTICAL}
      * @return ProductTemplates
      * @throws Exceptions\PrintfulApiException
      * @throws Exceptions\PrintfulException

tests/MockupGenerator/PrintfilesTest.php

@@ -14,13 +14,14 @@ class PrintfilesTest extends TestCase
     /**
      * @dataProvider productProvider
      * @param $productId
+     * @param string|null $orientation
      * @throws \Printful\Exceptions\PrintfulException
      */
-    public function testPrintfileRetrieval($productId)
+    public function testPrintfileRetrieval($productId, $orientation = null)
     {
         $generator = new PrintfulMockupGenerator($this->api);
 
-        $productPrintfiles = $generator->getProductPrintfiles($productId);
+        $productPrintfiles = $generator->getProductPrintfiles($productId, $orientation);
 
         self::assertEquals($productId, $productPrintfiles->productId);
 
@@ -49,10 +50,11 @@ public function testPrintfileRetrieval($productId)
     public function productProvider()
     {
         return [
-            [1], // Poster
+            [1],
+            [1, 'vertical'], // Poster
+            [1, 'horizontal'], // Poster
             [19], // 11oz mug
             [83], // Square Pillow Case w/ stuffing
-            [230], // PL401 Sublimation T-Shirt
         ];
     }
 }