classes/XLite/Model/Image/Category/Image.php line 90

Open in your IDE?
  1. <?php
  3. /**
  4.  * Copyright (c) 2011-present Qualiteam software Ltd. All rights reserved.
  5.  * See https://www.x-cart.com/license-agreement.html for license details.
  6.  */
  8. namespace XLite\Model\Image\Category;
  10. use ApiPlatform\Core\Annotation as ApiPlatform;
  11. use Doctrine\ORM\Mapping as ORM;
  12. use XLite\API\Endpoint\CategoryIcon\DTO\CategoryIconInput;
  13. use XLite\API\Endpoint\CategoryIcon\DTO\CategoryIconOutput;
  14. use XLite\Controller\API\CategoryIcon\DeleteCategoryIcon;
  16. /**
  17.  * Category
  18.  *
  19.  * @ORM\Entity
  20.  * @ORM\Table  (name="category_images")
  21.  * @ApiPlatform\ApiResource(
  22.  *     shortName="Category Icon",
  23.  *     output=CategoryIconOutput::class,
  24.  *     itemOperations={
  25.  *         "get"={
  26.  *             "method"="GET",
  27.  *             "path"="/categories/{category_id}/icon.{_format}",
  28.  *             "identifiers"={"category_id"},
  29.  *             "requirements"={"category_id"="\d+"},
  30.  *             "openapi_context"={
  31.  *                  "summary"="Retrieve an icon from a category",
  32.  *                  "parameters"={
  33.  *                      {"name"="category_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  34.  *                  }
  35.  *             },
  36.  *          },
  37.  *         "delete"={
  38.  *             "method"="DELETE",
  39.  *             "path"="/categories/{category_id}/icon.{_format}",
  40.  *             "identifiers"={"category_id"},
  41.  *             "requirements"={"category_id"="\d+"},
  42.  *             "controller"=DeleteCategoryIcon::class,
  43.  *             "read"=false,
  44.  *             "openapi_context"={
  45.  *                  "summary"="Delete an icon from a category",
  46.  *                  "parameters"={
  47.  *                      {"name"="category_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  48.  *                  }
  49.  *             },
  50.  *         },
  51.  *     },
  52.  *     collectionOperations={
  53.  *         "post"={
  54.  *             "method"="POST",
  55.  *             "input"=CategoryIconInput::class,
  56.  *             "output"=CategoryIconOutput::class,
  57.  *             "path"="/categories/{category_id}/icon.{_format}",
  58.  *             "identifiers"={"category_id"},
  59.  *             "requirements"={"category_id"="\d+"},
  60.  *             "openapi_context"={
  61.  *                 "summary"="Add an icon to a category",
  62.  *                 "parameters"={
  63.  *                     {"name"="category_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  64.  *                 },
  65.  *                 "requestBody"={
  66.  *                     "content"={
  67.  *                         "application/json"={
  68.  *                             "schema"={
  69.  *                                 "type"="object",
  70.  *                                 "properties"={
  71.  *                                     "alt"={
  72.  *                                         "type"="string",
  73.  *                                         "description"="Alt text"
  74.  *                                     },
  75.  *                                     "externalUrl"={
  76.  *                                         "type"="string",
  77.  *                                         "description"="URL to the image file which will be downloaded from there"
  78.  *                                     },
  79.  *                                     "attachment"={
  80.  *                                         "type"="string",
  81.  *                                         "description"="base64-encoded image"
  82.  *                                     },
  83.  *                                     "filename"={
  84.  *                                         "type"="string",
  85.  *                                         "description"="Image name with correct extension. Required for 'attachement' field."
  86.  *                                     },
  87.  *                                 },
  88.  *                             },
  89.  *                         },
  90.  *                     },
  91.  *                 },
  92.  *             },
  93.  *         },
  94.  *     }
  95.  * )
  96.  */
  97. class Image extends \XLite\Model\Base\Image
  98. {
  99.     /**
  100.      * Relation to a category entity
  101.      *
  102.      * @var \XLite\Model\Category
  103.      *
  104.      * @ORM\OneToOne   (targetEntity="XLite\Model\Category", inversedBy="image")
  105.      * @ORM\JoinColumn (name="category_id", referencedColumnName="category_id", onDelete="CASCADE")
  106.      */
  107.     protected $category;
  109.     /**
  110.      * Alternative image text
  111.      *
  112.      * @var string
  113.      *
  114.      * @ORM\Column (type="string", length=255)
  115.      */
  116.     protected $alt = '';
  118.     /**
  119.      * Set alt
  120.      *
  121.      * @param string $alt
  122.      * @return Image
  123.      */
  124.     public function setAlt($alt)
  125.     {
  126.         $this->alt = $alt;
  127.         return $this;
  128.     }
  130.     /**
  131.      * Get alt
  132.      *
  133.      * @return string
  134.      */
  135.     public function getAlt()
  136.     {
  137.         return $this->alt;
  138.     }
  140.     /**
  141.      * Set category
  142.      *
  143.      * @param \XLite\Model\Category $category
  144.      * @return Image
  145.      */
  146.     public function setCategory(\XLite\Model\Category $category = null)
  147.     {
  148.         $this->category = $category;
  149.         return $this;
  150.     }
  152.     /**
  153.      * Get category
  154.      *
  155.      * @return \XLite\Model\Category
  156.      */
  157.     public function getCategory()
  158.     {
  159.         return $this->category;
  160.     }
  162.     protected function isSvgAllowed(): bool
  163.     {
  164.         return true;
  165.     }
  166. }