Feat: adds reversed order to axis component

Author: mindline-analytics

docs/usage/shapes/chart.md

@@ -121,6 +121,31 @@ $shape->getPlotArea()->getAxisY()->setCrossesAt('3');
 | `AXIS::CROSSES_MIN`  | Axis crosses at minimum. |
 | `AXIS::CROSSES_MAX`  | Axis crosses at maximum. |
 
+#### Reversed Order
+
+You can reverse the order of a categorial or value axis trought `setIsReversedOrder`.
+
+Notice: If you reverse the order of a axis, this automatically changes the position of the other axis.
+To reset this effect, the axis intersection point on the other axis must be set to `Axis::CROSSES_MAX` using `setCrossesAt`.
+
+``` php
+use PhpOffice\PhpPresentation\Shape\Axis;
+
+$bar = new Bar();
+
+$shape = $slide->createChartShape();
+$shape->getPlotArea()->setType($bar);
+
+// default value, will return false
+$shape->getPlotArea()->getAxisY()->isReversedOrder()
+
+// reverse order
+$shape->getPlotArea()->getAxisY()->setIsReversedOrder(true);
+
+// revert the automatic intersection switch on x axis
+$shape->getPlotArea()->getAxisX()->setCrossesAt(Axis::CROSSES_MAX);
+```
+
 #### Outline
 
 You can define outline for each axis (X & Y).

src/PhpPresentation/Shape/Chart/Axis.php

@@ -93,6 +93,11 @@ class Axis implements ComparableInterface
      */
     protected $crossesAt = self::CROSSES_AUTO;
 
+    /**
+     * @var bool
+     */
+    protected $isReversedOrder = false;
+
     /**
      * @var string
      */
@@ -272,6 +277,26 @@ public function setCrossesAt(string $value = self::CROSSES_AUTO): self
         return $this;
     }
 
+    /**
+     * @return bool
+     */
+    public function isReversedOrder(): bool
+    {
+        return $this->isReversedOrder;
+    }
+
+    /**
+     * @param bool $value
+     *
+     * @return self
+     */
+    public function setIsReversedOrder(bool $value = false): self
+    {
+        $this->isReversedOrder = $value;
+
+        return $this;
+    }
+
     public function getMajorGridlines(): ?Gridlines
     {
         return $this->majorGridlines;

src/PhpPresentation/Writer/PowerPoint2007/PptCharts.php

@@ -2298,6 +2298,7 @@ protected function writeAxis(XMLWriter $objWriter, Chart\Axis $oAxis, string $ty
         }
 
         $crossesAt = $oAxis->getCrossesAt();
+        $orientation = $oAxis->isReversedOrder() ? 'maxMin' : 'minMax';
 
         if (Chart\Axis::AXIS_X == $typeAxis) {
             $mainElement = 'c:catAx';
@@ -2324,7 +2325,7 @@ protected function writeAxis(XMLWriter $objWriter, Chart\Axis $oAxis, string $ty
 
         // $mainElement > c:scaling > c:orientation
         $objWriter->startElement('c:orientation');
-        $objWriter->writeAttribute('val', 'minMax');
+        $objWriter->writeAttribute('val', $orientation);
         $objWriter->endElement();
 
         if (null != $oAxis->getMaxBounds()) {

tests/PhpPresentation/Tests/Shape/Chart/AxisTest.php

@@ -70,6 +70,16 @@ public function testCrossesAt(): void
         $this->assertEquals(Axis::CROSSES_MAX, $object->getCrossesAt());
     }
 
+    public function testIsReversedOrder(): void
+    {
+        $object = new Axis();
+        $this->assertFalse($object->isReversedOrder());
+        $this->assertInstanceOf(Axis::class, $object->setIsReversedOrder(true));
+        $this->assertTrue($object->isReversedOrder());
+        $this->assertInstanceOf(Axis::class, $object->setIsReversedOrder(false));
+        $this->assertFalse($object->isReversedOrder());
+    }
+
     public function testFont(): void
     {
         $object = new Axis();

tests/PhpPresentation/Tests/Writer/PowerPoint2007/PptChartsTest.php

@@ -324,6 +324,35 @@ public function testAxisCrosses(): void
         $this->assertIsSchemaECMA376Valid();
     }
 
+    public function testIsReversedOrder(): void
+    {
+        $element = '/c:chartSpace/c:chart/c:plotArea/c:catAx/c:scaling/c:orientation';
+
+        $oSlide = $this->oPresentation->getActiveSlide();
+        $oShape = $oSlide->createChartShape();
+        $oLine = new Line();
+        $oShape->getPlotArea()->setType($oLine);
+
+        // default
+        $this->assertFalse($oShape->getPlotArea()->getAxisX()->isReversedOrder());
+        $this->assertZipXmlAttributeEquals('ppt/charts/' . $oShape->getIndexedFilename(), $element, 'val', 'minMax');
+        $this->assertIsSchemaECMA376Valid();
+
+        // reversed order
+        $this->assertInstanceOf('PhpOffice\PhpPresentation\Shape\Chart\Axis', $oShape->getPlotArea()->getAxisX()->setIsReversedOrder(true));
+        $this->resetPresentationFile();
+        $this->assertZipXmlElementExists('ppt/charts/' . $oShape->getIndexedFilename(), $element);
+        $this->assertZipXmlAttributeEquals('ppt/charts/' . $oShape->getIndexedFilename(), $element, 'val', 'maxMin');
+        $this->assertIsSchemaECMA376Valid();
+
+        // reset reversed order
+        $this->assertInstanceOf('PhpOffice\PhpPresentation\Shape\Chart\Axis', $oShape->getPlotArea()->getAxisX()->setIsReversedOrder(false));
+        $this->resetPresentationFile();
+        $this->assertZipXmlElementExists('ppt/charts/' . $oShape->getIndexedFilename(), $element);
+        $this->assertZipXmlAttributeEquals('ppt/charts/' . $oShape->getIndexedFilename(), $element, 'val', 'minMax');
+        $this->assertIsSchemaECMA376Valid();
+    }
+
     public function testAxisFont(): void
     {
         $oSlide = $this->oPresentation->getActiveSlide();