classes/XLite/Model/Attribute.php line 690

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;
  10. use ApiPlatform\Core\Annotation as ApiPlatform;
  11. use Doctrine\ORM\Mapping as ORM;
  12. use Doctrine\ORM\PersistentCollection;
  13. use XLite\API\Endpoint\Attribute\Checkbox\DTO\AttributeCheckboxInput as InputCheckbox;
  14. use XLite\API\Endpoint\Attribute\Checkbox\DTO\AttributeCheckboxOutput as OutputCheckbox;
  15. use XLite\API\Endpoint\Attribute\Hidden\DTO\AttributeHiddenInput as InputHidden;
  16. use XLite\API\Endpoint\Attribute\Hidden\DTO\AttributeHiddenOutput as OutputHidden;
  17. use XLite\API\Endpoint\Attribute\Select\DTO\AttributeSelectInput as InputSelect;
  18. use XLite\API\Endpoint\Attribute\Select\DTO\AttributeSelectOutput as OutputSelect;
  19. use XLite\API\Endpoint\Attribute\Text\DTO\AttributeTextInput as InputText;
  20. use XLite\API\Endpoint\Attribute\Text\DTO\AttributeTextOutput as OutputText;
  21. use XLite\API\Endpoint\ProductAttribute\Checkbox\DTO\ProductAttributeCheckboxInput as ProductAttributeInputCheckbox;
  22. use XLite\API\Endpoint\ProductAttribute\Checkbox\DTO\ProductAttributeCheckboxOutput as ProductAttributeOutputCheckbox;
  23. use XLite\API\Endpoint\ProductAttribute\Select\DTO\ProductAttributeSelectInput as ProductAttributeInputSelect;
  24. use XLite\API\Endpoint\ProductAttribute\Select\DTO\ProductAttributeSelectOutput as ProductAttributeOutputSelect;
  25. use XLite\API\Endpoint\ProductAttribute\Text\DTO\ProductAttributeTextInput as ProductAttributeInputText;
  26. use XLite\API\Endpoint\ProductAttribute\Text\DTO\ProductAttributeTextOutput as ProductAttributeOutputText;
  27. use XLite\Core\Cache\ExecuteCachedTrait;
  28. use XLite\Core\Database;
  29. use XLite\Model\AttributeValue\AttributeValueSelect;
  30. use XLite\Model\Repo\ARepo;
  31. use XLite\Model\AttributeValue\AAttributeValue;
  33. /**
  34.  * @ORM\Entity
  35.  * @ORM\Table (name="attributes")
  36.  * @ApiPlatform\ApiResource(
  37.  *     itemOperations={
  38.  *          "get_text"={
  39.  *              "method"="GET",
  40.  *              "path"="/attributes_text/{id}.{_format}",
  41.  *              "identifiers"={"id"},
  42.  *              "input"=InputText::class,
  43.  *              "output"=OutputText::class,
  44.  *              "openapi_context"={
  45.  *                  "summary"="Retrieve a global textarea attribute",
  46.  *                  "parameters"={
  47.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  48.  *                  }
  49.  *              }
  50.  *          },
  51.  *          "put_text"={
  52.  *              "method"="PUT",
  53.  *              "path"="/attributes_text/{id}.{_format}",
  54.  *              "identifiers"={"id"},
  55.  *              "input"=InputText::class,
  56.  *              "output"=OutputText::class,
  57.  *              "openapi_context"={
  58.  *                  "summary"="Update a global textarea attribute",
  59.  *                  "parameters"={
  60.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  61.  *                  }
  62.  *              }
  63.  *          },
  64.  *          "delete_text"={
  65.  *              "method"="DELETE",
  66.  *              "path"="/attributes_text/{id}.{_format}",
  67.  *              "identifiers"={"id"},
  68.  *              "input"=InputText::class,
  69.  *              "output"=OutputText::class,
  70.  *              "openapi_context"={
  71.  *                  "summary"="Delete a global textarea attribute",
  72.  *                  "parameters"={
  73.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  74.  *                  }
  75.  *              }
  76.  *          },
  77.  *          "get_checkbox"={
  78.  *              "method"="GET",
  79.  *              "path"="/attributes_checkbox/{id}.{_format}",
  80.  *              "identifiers"={"id"},
  81.  *              "input"=InputCheckbox::class,
  82.  *              "output"=OutputCheckbox::class,
  83.  *              "openapi_context"={
  84.  *                  "summary"="Retrieve a global yes/no attribute",
  85.  *                  "parameters"={
  86.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  87.  *                  }
  88.  *              }
  89.  *          },
  90.  *          "put_checkbox"={
  91.  *              "method"="PUT",
  92.  *              "path"="/attributes_checkbox/{id}.{_format}",
  93.  *              "identifiers"={"id"},
  94.  *              "input"=InputCheckbox::class,
  95.  *              "output"=OutputCheckbox::class,
  96.  *              "openapi_context"={
  97.  *                  "summary"="Update a global yes/no attribute",
  98.  *                  "parameters"={
  99.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  100.  *                  }
  101.  *              }
  102.  *          },
  103.  *          "delete_checkbox"={
  104.  *              "method"="DELETE",
  105.  *              "path"="/attributes_checkbox/{id}.{_format}",
  106.  *              "identifiers"={"id"},
  107.  *              "input"=InputCheckbox::class,
  108.  *              "output"=OutputCheckbox::class,
  109.  *              "openapi_context"={
  110.  *                  "summary"="Delete a global yes/no attribute",
  111.  *                  "parameters"={
  112.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  113.  *                  }
  114.  *              }
  115.  *          },
  116.  *          "get_select"={
  117.  *              "method"="GET",
  118.  *              "path"="/attributes_select/{id}.{_format}",
  119.  *              "identifiers"={"id"},
  120.  *              "input"=InputSelect::class,
  121.  *              "output"=OutputSelect::class,
  122.  *              "openapi_context"={
  123.  *                  "summary"="Retrieve a global plain field attribute",
  124.  *                  "parameters"={
  125.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  126.  *                  }
  127.  *              }
  128.  *          },
  129.  *          "put_select"={
  130.  *              "method"="PUT",
  131.  *              "path"="/attributes_select/{id}.{_format}",
  132.  *              "identifiers"={"id"},
  133.  *              "input"=InputSelect::class,
  134.  *              "output"=OutputSelect::class,
  135.  *              "openapi_context"={
  136.  *                  "summary"="Update a global plain field attribute",
  137.  *                  "parameters"={
  138.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  139.  *                  }
  140.  *              }
  141.  *          },
  142.  *          "delete_select"={
  143.  *              "method"="DELETE",
  144.  *              "path"="/attributes_select/{id}.{_format}",
  145.  *              "identifiers"={"id"},
  146.  *              "input"=InputSelect::class,
  147.  *              "output"=OutputSelect::class,
  148.  *              "openapi_context"={
  149.  *                  "summary"="Delete a global plain field attribute",
  150.  *                  "parameters"={
  151.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  152.  *                  }
  153.  *              }
  154.  *          },
  155.  *          "get_hidden"={
  156.  *              "method"="GET",
  157.  *              "path"="/attributes_hidden/{id}.{_format}",
  158.  *              "identifiers"={"id"},
  159.  *              "input"=InputHidden::class,
  160.  *              "output"=OutputHidden::class,
  161.  *              "openapi_context"={
  162.  *                  "summary"="Retrieve a global hidden attribute",
  163.  *                  "parameters"={
  164.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  165.  *                  }
  166.  *              }
  167.  *          },
  168.  *          "put_hidden"={
  169.  *              "method"="PUT",
  170.  *              "path"="/attributes_hidden/{id}.{_format}",
  171.  *              "identifiers"={"id"},
  172.  *              "input"=InputHidden::class,
  173.  *              "output"=OutputHidden::class,
  174.  *              "openapi_context"={
  175.  *                  "summary"="Update a global hidden attribute",
  176.  *                  "parameters"={
  177.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  178.  *                  }
  179.  *              }
  180.  *          },
  181.  *          "delete_hidden"={
  182.  *              "method"="DELETE",
  183.  *              "path"="/attributes_hidden/{id}.{_format}",
  184.  *              "identifiers"={"id"},
  185.  *              "input"=InputHidden::class,
  186.  *              "output"=OutputHidden::class,
  187.  *              "openapi_context"={
  188.  *                  "summary"="Delete a global hidden attribute",
  189.  *                  "parameters"={
  190.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  191.  *                  }
  192.  *              }
  193.  *          },
  194.  *          "product_class_based_get_text"={
  195.  *              "method"="GET",
  196.  *              "path"="/product_classes/{class_id}/attributes_text/{id}.{_format}",
  197.  *              "identifiers"={"id"},
  198.  *              "input"=InputText::class,
  199.  *              "output"=OutputText::class,
  200.  *              "openapi_context"={
  201.  *                  "summary"="Retrieve a product class textarea attribute",
  202.  *                  "parameters"={
  203.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  204.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  205.  *                  }
  206.  *              }
  207.  *          },
  208.  *          "product_class_based_put_text"={
  209.  *              "method"="PUT",
  210.  *              "path"="/product_classes/{class_id}/attributes_text/{id}.{_format}",
  211.  *              "identifiers"={"id"},
  212.  *              "input"=InputText::class,
  213.  *              "output"=OutputText::class,
  214.  *              "openapi_context"={
  215.  *                  "summary"="Update a product class textarea attribute",
  216.  *                  "parameters"={
  217.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  218.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  219.  *                  }
  220.  *              }
  221.  *          },
  222.  *          "product_class_based_delete_text"={
  223.  *              "method"="DELETE",
  224.  *              "path"="/product_classes/{class_id}/attributes_text/{id}.{_format}",
  225.  *              "identifiers"={"id"},
  226.  *              "input"=InputText::class,
  227.  *              "output"=OutputText::class,
  228.  *              "openapi_context"={
  229.  *                  "summary"="Delete a product class textarea attribute",
  230.  *                  "parameters"={
  231.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  232.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  233.  *                  }
  234.  *              }
  235.  *          },
  236.  *          "product_class_based_get_checkbox"={
  237.  *              "method"="GET",
  238.  *              "path"="/product_classes/{class_id}/attributes_checkbox/{id}.{_format}",
  239.  *              "identifiers"={"id"},
  240.  *              "input"=InputCheckbox::class,
  241.  *              "output"=OutputCheckbox::class,
  242.  *              "openapi_context"={
  243.  *                  "summary"="Retrieve a product class yes/no attribute",
  244.  *                  "parameters"={
  245.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  246.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  247.  *                  }
  248.  *              }
  249.  *          },
  250.  *          "product_class_based_put_checkbox"={
  251.  *              "method"="PUT",
  252.  *              "path"="/product_classes/{class_id}/attributes_checkbox/{id}.{_format}",
  253.  *              "identifiers"={"id"},
  254.  *              "input"=InputCheckbox::class,
  255.  *              "output"=OutputCheckbox::class,
  256.  *              "openapi_context"={
  257.  *                  "summary"="Update a product class yes/no attribute",
  258.  *                  "parameters"={
  259.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  260.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  261.  *                  }
  262.  *              }
  263.  *          },
  264.  *          "product_class_based_delete_checkbox"={
  265.  *              "method"="DELETE",
  266.  *              "path"="/product_classes/{class_id}/attributes_checkbox/{id}.{_format}",
  267.  *              "identifiers"={"id"},
  268.  *              "input"=InputCheckbox::class,
  269.  *              "output"=OutputCheckbox::class,
  270.  *              "openapi_context"={
  271.  *                  "summary"="Delete a product class yes/no attribute",
  272.  *                  "parameters"={
  273.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  274.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  275.  *                  }
  276.  *              }
  277.  *          },
  278.  *          "product_class_based_get_select"={
  279.  *              "method"="GET",
  280.  *              "path"="/product_classes/{class_id}/attributes_select/{id}.{_format}",
  281.  *              "identifiers"={"id"},
  282.  *              "input"=InputSelect::class,
  283.  *              "output"=OutputSelect::class,
  284.  *              "openapi_context"={
  285.  *                  "summary"="Retrieve a product class plain field attribute",
  286.  *                  "parameters"={
  287.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  288.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  289.  *                  }
  290.  *              }
  291.  *          },
  292.  *          "product_class_based_put_select"={
  293.  *              "method"="PUT",
  294.  *              "path"="/product_classes/{class_id}/attributes_select/{id}.{_format}",
  295.  *              "identifiers"={"id"},
  296.  *              "input"=InputSelect::class,
  297.  *              "output"=OutputSelect::class,
  298.  *              "openapi_context"={
  299.  *                  "summary"="Update a product class plain field attribute",
  300.  *                  "parameters"={
  301.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  302.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  303.  *                  }
  304.  *              }
  305.  *          },
  306.  *          "product_class_based_delete_select"={
  307.  *              "method"="DELETE",
  308.  *              "path"="/product_classes/{class_id}/attributes_select/{id}.{_format}",
  309.  *              "identifiers"={"id"},
  310.  *              "input"=InputSelect::class,
  311.  *              "output"=OutputSelect::class,
  312.  *              "openapi_context"={
  313.  *                  "summary"="Delete a product class plain field attribute",
  314.  *                  "parameters"={
  315.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  316.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  317.  *                  }
  318.  *              }
  319.  *          },
  320.  *          "product_based_get_text"={
  321.  *              "method"="GET",
  322.  *              "path"="/products/{product_id}/attributes_text/{id}.{_format}",
  323.  *              "identifiers"={"id"},
  324.  *              "input"=ProductAttributeInputText::class,
  325.  *              "output"=ProductAttributeOutputText::class,
  326.  *              "openapi_context"={
  327.  *                  "summary"="Retrieve a product-specific textarea attribute",
  328.  *                  "parameters"={
  329.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  330.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  331.  *                  }
  332.  *              }
  333.  *          },
  334.  *          "product_based_put_text"={
  335.  *              "method"="PUT",
  336.  *              "path"="/products/{product_id}/attributes_text/{id}.{_format}",
  337.  *              "identifiers"={"id"},
  338.  *              "input"=ProductAttributeInputText::class,
  339.  *              "output"=ProductAttributeOutputText::class,
  340.  *              "openapi_context"={
  341.  *                  "summary"="Update a product-specific textarea attribute",
  342.  *                  "parameters"={
  343.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  344.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  345.  *                  }
  346.  *              }
  347.  *          },
  348.  *          "product_based_delete_text"={
  349.  *              "method"="DELETE",
  350.  *              "path"="/products/{product_id}/attributes_text/{id}.{_format}",
  351.  *              "identifiers"={"id"},
  352.  *              "input"=ProductAttributeInputText::class,
  353.  *              "output"=ProductAttributeOutputText::class,
  354.  *              "openapi_context"={
  355.  *                  "summary"="Delete a product-specific textarea attribute",
  356.  *                  "parameters"={
  357.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  358.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  359.  *                  }
  360.  *              }
  361.  *          },
  362.  *          "product_based_get_checkbox"={
  363.  *              "method"="GET",
  364.  *              "path"="/products/{product_id}/attributes_checkbox/{id}.{_format}",
  365.  *              "identifiers"={"id"},
  366.  *              "input"=ProductAttributeInputCheckbox::class,
  367.  *              "output"=ProductAttributeOutputCheckbox::class,
  368.  *              "openapi_context"={
  369.  *                  "summary"="Retrieve a product-specific yes/no attribute",
  370.  *                  "parameters"={
  371.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  372.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  373.  *                  }
  374.  *              }
  375.  *          },
  376.  *          "product_based_put_checkbox"={
  377.  *              "method"="PUT",
  378.  *              "path"="/products/{product_id}/attributes_checkbox/{id}.{_format}",
  379.  *              "identifiers"={"id"},
  380.  *              "input"=ProductAttributeInputCheckbox::class,
  381.  *              "output"=ProductAttributeOutputCheckbox::class,
  382.  *              "openapi_context"={
  383.  *                  "summary"="Update a product-specific yes/no attribute",
  384.  *                  "parameters"={
  385.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  386.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  387.  *                  }
  388.  *              }
  389.  *          },
  390.  *          "product_based_delete_checkbox"={
  391.  *              "method"="DELETE",
  392.  *              "path"="/products/{product_id}/attributes_checkbox/{id}.{_format}",
  393.  *              "identifiers"={"id"},
  394.  *              "input"=ProductAttributeInputCheckbox::class,
  395.  *              "output"=ProductAttributeOutputCheckbox::class,
  396.  *              "openapi_context"={
  397.  *                  "summary"="Delete a product-specific yes/no attribute",
  398.  *                  "parameters"={
  399.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  400.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  401.  *                  }
  402.  *              }
  403.  *          },
  404.  *          "product_based_get_select"={
  405.  *              "method"="GET",
  406.  *              "path"="/products/{product_id}/attributes_select/{id}.{_format}",
  407.  *              "identifiers"={"id"},
  408.  *              "input"=ProductAttributeInputSelect::class,
  409.  *              "output"=ProductAttributeOutputSelect::class,
  410.  *              "openapi_context"={
  411.  *                  "summary"="Retrieve a product-specific plain field attribute",
  412.  *                  "parameters"={
  413.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  414.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  415.  *                  }
  416.  *              }
  417.  *          },
  418.  *          "product_based_put_select"={
  419.  *              "method"="PUT",
  420.  *              "path"="/products/{product_id}/attributes_select/{id}.{_format}",
  421.  *              "identifiers"={"id"},
  422.  *              "input"=ProductAttributeInputSelect::class,
  423.  *              "output"=ProductAttributeOutputSelect::class,
  424.  *              "openapi_context"={
  425.  *                  "summary"="Update a product-specific plain field attribute",
  426.  *                  "parameters"={
  427.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  428.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  429.  *                  }
  430.  *              }
  431.  *          },
  432.  *          "product_based_delete_select"={
  433.  *              "method"="DELETE",
  434.  *              "path"="/products/{product_id}/attributes_select/{id}.{_format}",
  435.  *              "identifiers"={"id"},
  436.  *              "input"=ProductAttributeInputSelect::class,
  437.  *              "output"=ProductAttributeOutputSelect::class,
  438.  *              "openapi_context"={
  439.  *                  "summary"="Delete a product-specific plain field attribute",
  440.  *                  "parameters"={
  441.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}},
  442.  *                     {"name"="id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  443.  *                  }
  444.  *              }
  445.  *          }
  446.  *     },
  447.  *     collectionOperations={
  448.  *          "get_texts"={
  449.  *              "method"="GET",
  450.  *              "path"="/attributes_text.{_format}",
  451.  *              "identifiers"={"id"},
  452.  *              "input"=InputText::class,
  453.  *              "output"=OutputText::class,
  454.  *              "openapi_context"={
  455.  *                  "summary"="Retrieve a list of global textarea attributes",
  456.  *              }
  457.  *          },
  458.  *          "post_text"={
  459.  *              "method"="POST",
  460.  *              "path"="/attributes_text.{_format}",
  461.  *              "identifiers"={"id"},
  462.  *              "input"=InputText::class,
  463.  *              "output"=OutputText::class,
  464.  *              "controller"="xcart.api.attribute.text.controller",
  465.  *              "openapi_context"={
  466.  *                  "summary"="Create a global textarea attribute",
  467.  *              }
  468.  *          },
  469.  *          "get_checkboxes"={
  470.  *              "method"="GET",
  471.  *              "path"="/attributes_checkbox.{_format}",
  472.  *              "identifiers"={"id"},
  473.  *              "input"=InputCheckbox::class,
  474.  *              "output"=OutputCheckbox::class,
  475.  *              "openapi_context"={
  476.  *                  "summary"="Retrieve a list of global yes/no attributes",
  477.  *              }
  478.  *          },
  479.  *          "post_checkbox"={
  480.  *              "method"="POST",
  481.  *              "path"="/attributes_checkbox.{_format}",
  482.  *              "identifiers"={"id"},
  483.  *              "input"=InputCheckbox::class,
  484.  *              "output"=OutputCheckbox::class,
  485.  *              "controller"="xcart.api.attribute.checkbox.controller",
  486.  *              "openapi_context"={
  487.  *                  "summary"="Create a global yes/no attribute",
  488.  *              }
  489.  *          },
  490.  *          "get_selects"={
  491.  *              "method"="GET",
  492.  *              "path"="/attributes_select.{_format}",
  493.  *              "identifiers"={"id"},
  494.  *              "input"=InputSelect::class,
  495.  *              "output"=OutputSelect::class,
  496.  *              "openapi_context"={
  497.  *                  "summary"="Retrieve a list of global plain field attributes",
  498.  *              }
  499.  *          },
  500.  *          "post_select"={
  501.  *              "method"="POST",
  502.  *              "path"="/attributes_select.{_format}",
  503.  *              "identifiers"={"id"},
  504.  *              "input"=InputSelect::class,
  505.  *              "output"=OutputSelect::class,
  506.  *              "controller"="xcart.api.attribute.select.controller",
  507.  *              "openapi_context"={
  508.  *                  "summary"="Create a global plain field attribute",
  509.  *              }
  510.  *          },
  511.  *          "get_hiddens"={
  512.  *              "method"="GET",
  513.  *              "path"="/attributes_hidden.{_format}",
  514.  *              "identifiers"={"id"},
  515.  *              "input"=InputHidden::class,
  516.  *              "output"=OutputHidden::class,
  517.  *              "openapi_context"={
  518.  *                  "summary"="Retrieve a list of global hidden attributes",
  519.  *              }
  520.  *          },
  521.  *          "post_hidden"={
  522.  *              "method"="POST",
  523.  *              "path"="/attributes_hidden.{_format}",
  524.  *              "identifiers"={"id"},
  525.  *              "input"=InputHidden::class,
  526.  *              "output"=OutputHidden::class,
  527.  *              "controller"="xcart.api.attribute.hidden.controller",
  528.  *              "openapi_context"={
  529.  *                  "summary"="Create a global hidden attribute",
  530.  *              }
  531.  *          },
  532.  *          "product_class_based_get_texts"={
  533.  *              "method"="GET",
  534.  *              "path"="/product_classes/{class_id}/attributes_text.{_format}",
  535.  *              "identifiers"={"id"},
  536.  *              "input"=InputText::class,
  537.  *              "output"=OutputText::class,
  538.  *              "openapi_context"={
  539.  *                  "summary"="Retrieve a list of product class textarea attributes",
  540.  *                  "parameters"={
  541.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  542.  *                  }
  543.  *              }
  544.  *          },
  545.  *          "product_class_based_post_text"={
  546.  *              "method"="POST",
  547.  *              "path"="/product_classes/{class_id}/attributes_text.{_format}",
  548.  *              "identifiers"={"id"},
  549.  *              "input"=InputText::class,
  550.  *              "output"=OutputText::class,
  551.  *              "controller"="xcart.api.attribute.text.product_class_based_controller",
  552.  *              "openapi_context"={
  553.  *                  "summary"="Add a textarea attribute to a product class",
  554.  *                  "parameters"={
  555.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  556.  *                  }
  557.  *              }
  558.  *          },
  559.  *          "product_class_based_get_checkboxes"={
  560.  *              "method"="GET",
  561.  *              "path"="/product_classes/{class_id}/attributes_checkbox.{_format}",
  562.  *              "identifiers"={"id"},
  563.  *              "input"=InputCheckbox::class,
  564.  *              "output"=OutputCheckbox::class,
  565.  *              "openapi_context"={
  566.  *                  "summary"="Retrieve a list of product class yes/no attributes",
  567.  *                  "parameters"={
  568.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  569.  *                  }
  570.  *              }
  571.  *          },
  572.  *          "product_class_based_post_checkbox"={
  573.  *              "method"="POST",
  574.  *              "path"="/product_classes/{class_id}/attributes_checkbox.{_format}",
  575.  *              "identifiers"={"id"},
  576.  *              "input"=InputCheckbox::class,
  577.  *              "output"=OutputCheckbox::class,
  578.  *              "controller"="xcart.api.attribute.checkbox.product_class_based_controller",
  579.  *              "openapi_context"={
  580.  *                  "summary"="Add a yes/no attribute to a product class",
  581.  *                  "parameters"={
  582.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  583.  *                  }
  584.  *              }
  585.  *          },
  586.  *          "product_class_based_get_selects"={
  587.  *              "method"="GET",
  588.  *              "path"="/product_classes/{class_id}/attributes_select.{_format}",
  589.  *              "identifiers"={"id"},
  590.  *              "input"=InputSelect::class,
  591.  *              "output"=OutputSelect::class,
  592.  *              "openapi_context"={
  593.  *                  "summary"="Retrieve a list of product class plain field attributes",
  594.  *                  "parameters"={
  595.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  596.  *                  }
  597.  *              }
  598.  *          },
  599.  *          "product_class_based_post_select"={
  600.  *              "method"="POST",
  601.  *              "path"="/product_classes/{class_id}/attributes_select.{_format}",
  602.  *              "identifiers"={"id"},
  603.  *              "input"=InputSelect::class,
  604.  *              "output"=OutputSelect::class,
  605.  *              "controller"="xcart.api.attribute.select.product_class_based_controller",
  606.  *              "openapi_context"={
  607.  *                  "summary"="Add a plain field attribute to a product class",
  608.  *                  "parameters"={
  609.  *                     {"name"="class_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  610.  *                  }
  611.  *              }
  612.  *          },
  613.  *          "product_based_get_texts"={
  614.  *              "method"="GET",
  615.  *              "path"="/products/{product_id}/attributes_text.{_format}",
  616.  *              "identifiers"={"id"},
  617.  *              "input"=ProductAttributeInputText::class,
  618.  *              "output"=ProductAttributeOutputText::class,
  619.  *              "openapi_context"={
  620.  *                  "summary"="Retrieve a list of product-specific textarea attributes",
  621.  *                  "parameters"={
  622.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  623.  *                  }
  624.  *              }
  625.  *          },
  626.  *          "product_based_post_text"={
  627.  *              "method"="POST",
  628.  *              "path"="/products/{product_id}/attributes_text.{_format}",
  629.  *              "identifiers"={"id"},
  630.  *              "input"=ProductAttributeInputText::class,
  631.  *              "output"=ProductAttributeOutputText::class,
  632.  *              "controller"="xcart.api.attribute.text.product_based_controller",
  633.  *              "openapi_context"={
  634.  *                  "summary"="Add a textarea attribute to a product",
  635.  *                  "parameters"={
  636.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  637.  *                  }
  638.  *              }
  639.  *          },
  640.  *          "product_based_get_checkboxes"={
  641.  *              "method"="GET",
  642.  *              "path"="/products/{product_id}/attributes_checkbox.{_format}",
  643.  *              "identifiers"={"id"},
  644.  *              "input"=ProductAttributeInputCheckbox::class,
  645.  *              "output"=ProductAttributeOutputCheckbox::class,
  646.  *              "openapi_context"={
  647.  *                  "summary"="Retrieve a list of product-specific yes/no attributes",
  648.  *                  "parameters"={
  649.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  650.  *                  }
  651.  *              }
  652.  *          },
  653.  *          "product_based_post_checkbox"={
  654.  *              "method"="POST",
  655.  *              "path"="/products/{product_id}/attributes_checkbox.{_format}",
  656.  *              "identifiers"={"id"},
  657.  *              "input"=ProductAttributeInputCheckbox::class,
  658.  *              "output"=ProductAttributeOutputCheckbox::class,
  659.  *              "controller"="xcart.api.attribute.checkbox.product_based_controller",
  660.  *              "openapi_context"={
  661.  *                  "summary"="Add a yes/no attribute to a product",
  662.  *                  "parameters"={
  663.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  664.  *                  }
  665.  *              }
  666.  *          },
  667.  *          "product_based_get_selects"={
  668.  *              "method"="GET",
  669.  *              "path"="/products/{product_id}/attributes_select.{_format}",
  670.  *              "identifiers"={"id"},
  671.  *              "input"=ProductAttributeInputSelect::class,
  672.  *              "output"=ProductAttributeOutputSelect::class,
  673.  *              "openapi_context"={
  674.  *                  "summary"="Retrieve a list of product-specific plain field attributes",
  675.  *                  "parameters"={
  676.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  677.  *                  }
  678.  *              }
  679.  *          },
  680.  *          "product_based_post_select"={
  681.  *              "method"="POST",
  682.  *              "path"="/products/{product_id}/attributes_select.{_format}",
  683.  *              "identifiers"={"id"},
  684.  *              "input"=ProductAttributeInputSelect::class,
  685.  *              "output"=ProductAttributeOutputSelect::class,
  686.  *              "controller"="xcart.api.attribute.select.product_based_controller",
  687.  *              "openapi_context"={
  688.  *                  "summary"="Add a plain field attribute to a product",
  689.  *                  "parameters"={
  690.  *                     {"name"="product_id", "in"="path", "required"=true, "schema"={"type"="integer"}}
  691.  *                  }
  692.  *              }
  693.  *          }
  694.  *     }
  695.  * )
  696.  */
  697. class Attribute extends \XLite\Model\Base\I18n
  698. {
  699.     use ExecuteCachedTrait;
  701.     /*
  702.      * Attribute types
  703.      */
  704.     public const TYPE_TEXT     = 'T';
  705.     public const TYPE_CHECKBOX = 'C';
  706.     public const TYPE_SELECT   = 'S';
  707.     public const TYPE_HIDDEN   = 'H';
  709.     /*
  710.      * Add to new products or class’s assigns automatically with select value
  711.      */
  712.     public const ADD_TO_NEW_YES    = 'Y'; // 'Yes'
  713.     public const ADD_TO_NEW_NO     = 'N'; // 'NO'
  714.     public const ADD_TO_NEW_YES_NO = 'B'; // 'YES/NO' (BOTH)
  716.     /*
  717.      * Attribute delimiter
  718.      */
  719.     public const DELIMITER = ', ';
  721.     /*
  722.      * Display modes
  723.      */
  724.     public const SELECT_BOX_MODE = 'S';
  725.     public const SPECIFICATION_MODE = 'P';
  726.     public const BLOCKS_MODE     = 'B';
  728.     /**
  729.      * @var int
  730.      *
  731.      * @ORM\Id
  732.      * @ORM\GeneratedValue (strategy="AUTO")
  733.      * @ORM\Column (type="integer", options={ "unsigned": true })
  734.      */
  735.     protected $id;
  737.     /**
  738.      * @var int
  739.      *
  740.      * @ORM\Column (type="integer")
  741.      */
  742.     protected $position = 0;
  744.     /**
  745.      * Is attribute shown above the price
  746.      *
  747.      * @var bool
  748.      *
  749.      * @ORM\Column (type="boolean", options={"default":"0"})
  750.      */
  751.     protected $displayAbove = false;
  753.     /**
  754.      * @var int
  755.      *
  756.      * @ORM\Column (type="integer", length=1)
  757.      */
  758.     protected $decimals = 0;
  760.     /**
  761.      * @var \XLite\Model\ProductClass
  762.      *
  763.      * @ORM\ManyToOne (targetEntity="XLite\Model\ProductClass", inversedBy="attributes")
  764.      * @ORM\JoinColumn (name="product_class_id", referencedColumnName="id", onDelete="CASCADE")
  765.      */
  766.     protected $productClass;
  768.     /**
  769.      * @var \XLite\Model\AttributeGroup
  770.      *
  771.      * @ORM\ManyToOne (targetEntity="XLite\Model\AttributeGroup", inversedBy="attributes")
  772.      * @ORM\JoinColumn (name="attribute_group_id", referencedColumnName="id")
  773.      */
  774.     protected $attributeGroup;
  776.     /**
  777.      * @var \Doctrine\Common\Collections\Collection
  778.      *
  779.      * @ORM\OneToMany (targetEntity="XLite\Model\AttributeOption", mappedBy="attribute", cascade={"all"})
  780.      */
  781.     protected $attribute_options;
  783.     /**
  784.      * @var \XLite\Model\Product
  785.      *
  786.      * @ORM\ManyToOne (targetEntity="XLite\Model\Product", inversedBy="attributes")
  787.      * @ORM\JoinColumn (name="product_id", referencedColumnName="product_id", onDelete="CASCADE")
  788.      */
  789.     protected $product;
  791.     /**
  792.      * Option type
  793.      *
  794.      * @var string
  795.      *
  796.      * @ORM\Column (type="string", options={"fixed": true}, length=1)
  797.      */
  798.     protected $type = self::TYPE_SELECT;
  800.     /**
  801.      * @var string
  802.      *
  803.      * @ORM\Column (type="string", options={"fixed": true}, length=1)
  804.      */
  805.     protected $displayMode = '';
  807.     /**
  808.      * Add to new products or class’s assigns automatically
  809.      *
  810.      * @var bool
  811.      *
  812.      * @ORM\Column (type="string", options={"fixed": true}, length=1)
  813.      */
  814.     protected $addToNew = '';
  816.     /**
  817.      * @var \Doctrine\Common\Collections\Collection
  818.      *
  819.      * @ORM\OneToMany (targetEntity="XLite\Model\AttributeProperty", mappedBy="attribute")
  820.      */
  821.     protected $attribute_properties;
  823.     /**
  824.      * @var \Doctrine\Common\Collections\Collection
  825.      *
  826.      * @ORM\OneToMany (targetEntity="XLite\Model\AttributeTranslation", mappedBy="owner", cascade={"all"})
  827.      */
  828.     protected $translations;
  830.     /**
  831.      * Return name of widget class
  832.      *
  833.      * @param string $type      Attribute type
  834.      * @param string $interface Interface (Admin | Customer) OPTIONAL
  835.      *
  836.      * @return string
  837.      */
  838.     public static function getWidgetClass($type, $interface = null)
  839.     {
  840.         if ($interface === null) {
  841.             $interface = \XLite::isAdminZone() ? 'Admin' : 'Customer';
  842.         }
  844.         return '\XLite\View\Product\AttributeValue\\'
  845.             . $interface
  846.             . '\\'
  847.             . static::getTypes($type, true);
  848.     }
  850.     /**
  851.      * Return name of value class
  852.      *
  853.      * @param string $type Type
  854.      *
  855.      * @return string
  856.      */
  857.     public static function getAttributeValueClass($type)
  858.     {
  859.         return '\XLite\Model\AttributeValue\AttributeValue'
  860.             . static::getTypes($type, true);
  861.     }
  863.     /**
  864.      * Constructor
  865.      *
  866.      * @param array $data Entity properties OPTIONAL
  867.      */
  868.     public function __construct(array $data = [])
  869.     {
  870.         $this->attribute_options = new \Doctrine\Common\Collections\ArrayCollection();
  872.         parent::__construct($data);
  873.     }
  875.     /**
  876.      * Return number of products associated with this attribute
  877.      *
  878.      * @return integer
  879.      */
  880.     public function getProductsCount()
  881.     {
  882.         return $this->getClass()->getProductsCount();
  883.     }
  885.     /**
  886.      * Return list of types or type
  887.      *
  888.      * @param string  $type              Type OPTIONAL
  889.      * @param boolean $returnServiceType Return service type OPTIONAL
  890.      *
  891.      * @return array | string
  892.      */
  893.     public static function getTypes($type = null, $returnServiceType = false)
  894.     {
  895.         $list = [
  896.             static::TYPE_SELECT   => static::t('Plain field'),
  897.             static::TYPE_TEXT     => static::t('Textarea'),
  898.             static::TYPE_CHECKBOX => static::t('Yes/No'),
  899.             static::TYPE_HIDDEN   => static::t('Hidden field'),
  900.         ];
  902.         $listServiceTypes = [
  903.             static::TYPE_SELECT   => 'Select',
  904.             static::TYPE_TEXT     => 'Text',
  905.             static::TYPE_CHECKBOX => 'Checkbox',
  906.             static::TYPE_HIDDEN   => 'Hidden',
  907.         ];
  909.         $list = $returnServiceType ? $listServiceTypes : $list;
  911.         return $type !== null
  912.             ? ($list[$type] ?? null)
  913.             : $list;
  914.     }
  916.     /**
  917.      * Return list of 'addToNew' types
  918.      *
  919.      * @return array
  920.      */
  921.     public static function getAddToNewTypes()
  922.     {
  923.         return [
  924.             static::ADD_TO_NEW_YES,
  925.             static::ADD_TO_NEW_NO,
  926.             static::ADD_TO_NEW_YES_NO,
  927.         ];
  928.     }
  930.     /**
  931.      * Return values associated with this attribute
  932.      *
  933.      * @return list<\Xlite\Model\AttributeValue\AAttributeValue>
  934.      */
  935.     public function getAttributeValues()
  936.     {
  937.         $cnd = new \XLite\Core\CommonCell();
  938.         $cnd->attribute = $this;
  940.         return Database::getRepo(static::getAttributeValueClass($this->getType()))
  941.             ->search($cnd);
  942.     }
  944.     /**
  945.      * Return number of values associated with this attribute
  946.      *
  947.      * @return integer
  948.      */
  949.     public function getAttributeValuesCount()
  950.     {
  951.         $cnd = new \XLite\Core\CommonCell();
  952.         $cnd->attribute = $this;
  954.         return Database::getRepo(static::getAttributeValueClass($this->getType()))
  955.             ->search($cnd, true);
  956.     }
  958.     /**
  959.      * Set 'addToNew' value
  960.      *
  961.      * @param string|array $value Value
  962.      *
  963.      * @return void
  964.      */
  965.     public function setAddToNew($value)
  966.     {
  967.         if (
  968.             is_array($value)
  969.             && $this->getType() === static::TYPE_CHECKBOX
  970.         ) {
  971.             if (count($value) === 2) {
  972.                 $value = static::ADD_TO_NEW_YES_NO;
  973.             } elseif (count($value) === 1) {
  974.                 $value = array_shift($value) ? static::ADD_TO_NEW_YES : static::ADD_TO_NEW_NO;
  975.             }
  976.         }
  978.         $this->addToNew = in_array($value, static::getAddToNewTypes()) ? $value : '';
  979.     }
  981.     /**
  982.      * Get 'addToNew' value
  983.      *
  984.      * @return array
  985.      */
  986.     public function getAddToNew()
  987.     {
  988.         $value = null;
  989.         if ($this->getType() === static::TYPE_CHECKBOX) {
  990.             switch ($this->addToNew) {
  991.                 case static::ADD_TO_NEW_YES:
  992.                     $value = [1];
  993.                     break;
  995.                 case static::ADD_TO_NEW_NO:
  996.                     $value = [0];
  997.                     break;
  999.                 case static::ADD_TO_NEW_YES_NO:
  1000.                     $value = [0, 1];
  1001.                     break;
  1003.                 default:
  1004.             }
  1005.         }
  1007.         return $value;
  1008.     }
  1010.     /**
  1011.      * Set type
  1012.      *
  1013.      * @param string $type Type
  1014.      *
  1015.      * @return void
  1016.      */
  1017.     public function setType($type)
  1018.     {
  1019.         $types = static::getTypes();
  1021.         if (isset($types[$type])) {
  1022.             if (
  1023.                 $this->type
  1024.                 && $type != $this->type
  1025.                 && $this->getId()
  1026.             ) {
  1027.                 foreach ($this->getAttributeOptions() as $option) {
  1028.                     Database::getEM()->remove($option);
  1029.                 }
  1030.                 foreach ($this->getAttributeValues() as $value) {
  1031.                     Database::getEM()->remove($value);
  1032.                 }
  1033.             }
  1034.             $this->type = $type;
  1035.         }
  1036.     }
  1038.     /**
  1039.      * Return product property (return new property if property does not exist)
  1040.      *
  1041.      * @param \XLite\Model\Product $product Product OPTIONAL
  1042.      *
  1043.      * @return \XLite\Model\AttributeProperty
  1044.      */
  1045.     public function getProperty($product)
  1046.     {
  1047.         return $this->executeCachedRuntime(function () use ($product) {
  1048.             $property = null;
  1049.             if ($product->getProductId()) {
  1050.                 $product = Database::getRepo(\XLite\Model\Product::class)?->find($product->getProductId());
  1051.                 $property = Database::getRepo(\XLite\Model\AttributeProperty::class)?->findOneBy([
  1052.                     'product' => $product,
  1053.                     'attribute'  => $this,
  1054.                 ]);
  1056.                 if ($property === null) {
  1057.                     $property = $this->getNewProperty($product);
  1058.                 }
  1059.             }
  1061.             return $property;
  1062.         }, ['getProperty', $this->getId(), $product->getProductId()]);
  1063.     }
  1065.     /**
  1066.      * Return new product property
  1067.      *
  1068.      * @param \XLite\Model\Product $product Product OPTIONAL
  1069.      *
  1070.      * @return \XLite\Model\AttributeProperty
  1071.      */
  1072.     protected function getNewProperty($product)
  1073.     {
  1074.         $result = new \XLite\Model\AttributeProperty();
  1075.         $result->setAttribute($this);
  1076.         $result->setProduct($product);
  1077.         $result->setDisplayAbove($this->getDisplayAbove());
  1078.         $this->addAttributeProperty($result);
  1079.         Database::getEM()->persist($result);
  1081.         return $result;
  1082.     }
  1084.     /**
  1085.      * Returns position
  1086.      *
  1087.      * @param \XLite\Model\Product $product Product OPTIONAL
  1088.      *
  1089.      * @return integer
  1090.      */
  1091.     public function getPosition($product = null)
  1092.     {
  1093.         if ($product) {
  1094.             $result = $this->getProperty($product);
  1095.             $result = $result ? $result->getPosition() : 0;
  1096.         } else {
  1097.             $result = $this->position;
  1098.         }
  1100.         return $result;
  1101.     }
  1103.     /**
  1104.      * Set the position
  1105.      *
  1106.      * @param integer|array $value
  1107.      *
  1108.      * @return void
  1109.      */
  1110.     public function setPosition($value)
  1111.     {
  1112.         if (is_array($value)) {
  1113.             $property = $this->getProperty($value['product']);
  1114.             $property->setPosition($value['position']);
  1115.         } else {
  1116.             $this->position = $value;
  1117.         }
  1118.     }
  1120.     /**
  1121.      * @param \XLite\Model\Product $product Product OPTIONAL
  1122.      *
  1123.      * @return integer
  1124.      */
  1125.     public function getDisplayAbove($product = null)
  1126.     {
  1127.         if ($product) {
  1128.             $result = $this->getProperty($product);
  1129.             $result = $result ? $result->getDisplayAbove() : $this->displayAbove;
  1130.         } else {
  1131.             $result = $this->displayAbove;
  1132.         }
  1134.         return $result;
  1135.     }
  1137.     /**
  1138.      * @param boolean|array $value
  1139.      *
  1140.      * @return void
  1141.      */
  1142.     public function setDisplayAbove($value)
  1143.     {
  1144.         if (is_array($value)) {
  1145.             $property = $this->getProperty($value['product']);
  1146.             $property->setDisplayAbove($value['displayAbove']);
  1147.         } else {
  1148.             $this->displayAbove = $value;
  1149.         }
  1150.     }
  1152.     /**
  1153.      * Add to new product
  1154.      *
  1155.      * @param \XLite\Model\Product $product Product
  1156.      *
  1157.      * @return void
  1158.      */
  1159.     public function addToNewProduct(\XLite\Model\Product $product)
  1160.     {
  1161.         $displayAbove = $this->getDisplayAbove();
  1163.         if ($this->getAddToNew()) {
  1164.             $displayAbove = count($this->getAddToNew()) > 1 ?: $displayAbove;
  1166.             foreach ($this->getAddToNew() as $value) {
  1167.                 $av = $this->createAttributeValue($product);
  1168.                 if ($av) {
  1169.                     $av->setValue($value);
  1170.                 }
  1171.             }
  1172.         } elseif ($this->getType() === static::TYPE_SELECT) {
  1173.             $attributeOptions = Database::getRepo(\XLite\Model\AttributeOption::class)->findBy(
  1174.                 [
  1175.                     'attribute' => $this,
  1176.                     'addToNew'  => true,
  1177.                 ],
  1178.                 ['position' => 'ASC']
  1179.             );
  1181.             $displayAbove = count($attributeOptions) > 1 ?: $displayAbove;
  1183.             foreach ($attributeOptions as $attributeOption) {
  1184.                 $av = $this->createAttributeValue($product);
  1185.                 if ($av) {
  1186.                     $av->setAttributeOption($attributeOption);
  1187.                     $av->setPosition($attributeOption->getPosition());
  1188.                 }
  1189.             }
  1190.         } elseif ($this->getType() === static::TYPE_TEXT) {
  1191.             $av = $this->createAttributeValue($product);
  1192.             if ($av) {
  1193.                 $av->setEditable(false);
  1194.                 $av->setValue('');
  1195.             }
  1196.         } elseif ($this->getType() === static::TYPE_HIDDEN) {
  1197.             $attributeOption = Database::getRepo(\XLite\Model\AttributeOption::class)->findOneBy(
  1198.                 [
  1199.                     'attribute' => $this,
  1200.                     'addToNew'  => true,
  1201.                 ]
  1202.             );
  1204.             if ($attributeOption) {
  1205.                 $av = $this->createAttributeValue($product);
  1206.                 if ($av) {
  1207.                     $av->setAttributeOption($attributeOption);
  1208.                 }
  1209.             }
  1210.         }
  1212.         $this->setDisplayAbove(
  1213.             [
  1214.                 'product' => $product,
  1215.                 'displayAbove' => $displayAbove,
  1216.             ]
  1217.         );
  1218.     }
  1220.     /**
  1221.      * Apply changes
  1222.      *
  1223.      * @param \XLite\Model\Product $product Product
  1224.      * @param mixed                $changes Changes
  1225.      *
  1226.      * @return void
  1227.      */
  1228.     public function applyChanges(\XLite\Model\Product $product, $changes)
  1229.     {
  1230.         if (
  1231.             (
  1232.                 !$this->getProductClass()
  1233.                 && !$this->getProduct()
  1234.             )
  1235.             || (
  1236.                 $this->getProductClass()
  1237.                 && $product->getProductClass()
  1238.                 && $this->getProductClass()->getId() == $product->getProductClass()->getId()
  1239.             )
  1240.             || ($this->getProduct()
  1241.                 && $this->getProduct()->getId() == $product->getId()
  1242.             )
  1243.         ) {
  1244.             $class = static::getAttributeValueClass($this->getType());
  1245.             $repo = Database::getRepo($class);
  1247.             switch ($this->getType()) {
  1248.                 case static::TYPE_TEXT:
  1249.                     $this->setAttributeValue($product, $changes);
  1250.                     break;
  1252.                 case static::TYPE_CHECKBOX:
  1253.                 case static::TYPE_SELECT:
  1254.                     foreach ($repo->findBy(['product' => $product, 'attribute' => $this]) as $av) {
  1255.                         $uniq = $this->getType() === static::TYPE_CHECKBOX
  1256.                             ? $av->getValue()
  1257.                             : $av->getAttributeOption()->getId();
  1259.                         if (in_array($uniq, $changes['deleted'])) {
  1260.                             $repo->delete($av, false);
  1261.                         } elseif (
  1262.                             isset($changes['changed'][$uniq])
  1263.                             || isset($changes['added'][$uniq])
  1264.                         ) {
  1265.                             $data = $changes['changed'][$uniq] ?? $changes['added'][$uniq];
  1267.                             if (
  1268.                                 isset($data['defaultValue'])
  1269.                                 && $data['defaultValue']
  1270.                                 && !$av->getDefaultValue()
  1271.                             ) {
  1272.                                 $pr = $repo->findOneBy(
  1273.                                     [
  1274.                                         'product'      => $product,
  1275.                                         'attribute'    => $this,
  1276.                                         'defaultValue' => true,
  1277.                                     ]
  1278.                                 );
  1279.                                 if ($pr) {
  1280.                                     $pr->setDefaultValue(false);
  1281.                                 }
  1282.                             }
  1284.                             $repo->update($av, $data);
  1286.                             if (isset($changes['added'][$uniq])) {
  1287.                                 unset($changes['added'][$uniq]);
  1288.                             }
  1289.                         }
  1290.                     }
  1292.                     if ($changes['added']) {
  1293.                         foreach ($changes['added'] as $uniq => $data) {
  1294.                             if (
  1295.                                 isset($data['defaultValue'])
  1296.                                 && $data['defaultValue']
  1297.                             ) {
  1298.                                 $pr = $repo->findOneBy(
  1299.                                     [
  1300.                                         'product'      => $product,
  1301.                                         'attribute'    => $this,
  1302.                                         'defaultValue' => true,
  1303.                                     ]
  1304.                                 );
  1305.                                 if ($pr) {
  1306.                                     $pr->setDefaultValue(false);
  1307.                                 }
  1308.                             }
  1309.                             $av = $this->createAttributeValue($product);
  1311.                             if ($av) {
  1312.                                 if ($this->getType() === static::TYPE_CHECKBOX) {
  1313.                                     $av->setValue($uniq);
  1314.                                 } else {
  1315.                                     $av->setAttributeOption(
  1316.                                         Database::getRepo(\XLite\Model\AttributeOption::class)->find($uniq)
  1317.                                     );
  1318.                                 }
  1319.                                 $repo->update($av, $data);
  1320.                             }
  1321.                         }
  1322.                     }
  1323.                     break;
  1325.                 default:
  1326.             }
  1327.             Database::getEM()->flush();
  1328.         }
  1329.     }
  1331.     /**
  1332.      * Set attribute value
  1333.      *
  1334.      * @param \XLite\Model\Product $product Product
  1335.      * @param mixed                $data    Value
  1336.      *
  1337.      * @return void
  1338.      */
  1339.     public function setAttributeValue(\XLite\Model\Product $product, $data, bool $flush = true)
  1340.     {
  1341.         $repo = Database::getRepo(
  1342.             static::getAttributeValueClass($this->getType())
  1343.         );
  1345.         $method = $this->defineSetAttributeValueMethodName($data);
  1346.         $this->$method($repo, $product, $data, $flush);
  1347.     }
  1349.     /**
  1350.      * Get attribute value
  1351.      *
  1352.      * @param \XLite\Model\Product $product  Product
  1353.      * @param boolean              $asString As string flag OPTIONAL
  1354.      *
  1355.      * @return mixed
  1356.      */
  1357.     public function getAttributeValue(\XLite\Model\Product $product, $asString = false)
  1358.     {
  1359.         $repo = Database::getRepo(static::getAttributeValueClass($this->getType()));
  1361.         if (in_array($this->getType(), [static::TYPE_SELECT, static::TYPE_CHECKBOX, static::TYPE_HIDDEN])) {
  1362.             $attributeValue = $repo->findBy(
  1363.                 ['product' => $product, 'attribute' => $this],
  1364.                 $this->getType() === static::TYPE_SELECT ? ['position' => 'ASC'] : null
  1365.             );
  1367.             if (
  1368.                 $attributeValue
  1369.                 && $asString
  1370.             ) {
  1371.                 if (is_array($attributeValue)) {
  1372.                     foreach ($attributeValue as $k => $v) {
  1373.                         $attributeValue[$k] = $v->asString();
  1374.                     }
  1375.                 } elseif (is_object($attributeValue)) {
  1376.                     $attributeValue = $attributeValue->asString();
  1377.                 } elseif ($this->getType() === static::TYPE_CHECKBOX) {
  1378.                     $attributeValue = static::t('Yes');
  1379.                 }
  1380.             }
  1381.         } else {
  1382.             $attributeValue = $repo->findOneBy(
  1383.                 ['product' => $product, 'attribute' => $this]
  1384.             );
  1385.             if ($attributeValue && $asString) {
  1386.                 $attributeValue = $attributeValue->getValue();
  1387.             }
  1388.         }
  1390.         return $attributeValue;
  1391.     }
  1393.     /**
  1394.      * Get attribute value
  1395.      *
  1396.      * @param \XLite\Model\Product $product Product
  1397.      *
  1398.      * @return \XLite\Model\AttributeValue\AAttributeValue
  1399.      */
  1400.     public function getDefaultAttributeValue(\XLite\Model\Product $product)
  1401.     {
  1402.         $repo = Database::getRepo(static::getAttributeValueClass($this->getType()));
  1404.         $attributeValue = $repo->findOneBy(['product' => $product, 'attribute' => $this, 'defaultValue' => true]);
  1405.         if (!$attributeValue) {
  1406.             $attributeValue = $repo->findDefaultAttributeValue(['product' => $product, 'attribute' => $this]);
  1407.         }
  1409.         return $attributeValue;
  1410.     }
  1412.     /**
  1413.      * This attribute is multiple or not flag
  1414.      *
  1415.      * @param \XLite\Model\Product $product Product
  1416.      *
  1417.      * @return boolean
  1418.      */
  1419.     public function isMultiple(\XLite\Model\Product $product)
  1420.     {
  1421.         $repo = Database::getRepo(static::getAttributeValueClass($this->getType()));
  1423.         return (!$this->getProduct() || $this->getProduct()->getId() == $product->getId())
  1424.             && (!$this->getProductClass()
  1425.                 || ($product->getProductClass()
  1426.                     && $this->getProductClass()->getId() == $product->getProductClass()->getId()
  1427.                 )
  1428.             )
  1429.             && 1 < count($repo->findBy(['product' => $product, 'attribute' => $this]));
  1430.     }
  1432.     /**
  1433.      * This attribute is hidden or not flag
  1434.      *
  1435.      * @return bool
  1436.      */
  1437.     public function isHidden()
  1438.     {
  1439.         return $this->getType() === static::TYPE_HIDDEN;
  1440.     }
  1442.     /**
  1443.      * Create attribute value
  1444.      *
  1445.      * @param \XLite\Model\Product $product Product
  1446.      *
  1447.      * @return mixed
  1448.      */
  1449.     protected function createAttributeValue(\XLite\Model\Product $product)
  1450.     {
  1451.         $class = static::getAttributeValueClass($this->getType());
  1453.         $attributeValue = new $class();
  1454.         $attributeValue->setProduct($product);
  1455.         $attributeValue->setAttribute($this);
  1456.         Database::getEM()->persist($attributeValue);
  1458.         return $attributeValue;
  1459.     }
  1461.     /**
  1462.      * Create attribute option
  1463.      *
  1464.      * @param string $value Option name
  1465.      *
  1466.      * @return \XLite\Model\AttributeOption
  1467.      */
  1468.     protected function createAttributeOption($value)
  1469.     {
  1470.         $attributeOption = new \XLite\Model\AttributeOption();
  1471.         $attributeOption->setAttribute($this);
  1472.         $attributeOption->setName($value);
  1474.         Database::getEM()->persist($attributeOption);
  1476.         return $attributeOption;
  1477.     }
  1479.     // {{{ Set attribute value
  1481.     /**
  1482.      * Define method name for 'setAttributeValue' operation
  1483.      *
  1484.      * @param mixed $data Data
  1485.      *
  1486.      * @return string
  1487.      */
  1488.     protected function defineSetAttributeValueMethodName($data)
  1489.     {
  1490.         if ($this->getType() === static::TYPE_SELECT) {
  1491.             $result = 'setAttributeValueSelect';
  1492.         } elseif ($this->getType() === static::TYPE_CHECKBOX && isset($data['multiple']) && $data['multiple']) {
  1493.             $result = 'setAttributeValueCheckbox';
  1494.         } elseif ($this->getType() === static::TYPE_HIDDEN) {
  1495.             $result = 'setAttributeValueHidden';
  1496.         } else {
  1497.             $result = 'setAttributeValueDefault';
  1498.         }
  1500.         return $result;
  1501.     }
  1503.     /**
  1504.      * Set attribute value (select)
  1505.      *
  1506.      * @param \XLite\Model\Repo\ARepo $repo    Repository
  1507.      * @param \XLite\Model\Product    $product Product
  1508.      * @param array                   $data    Data
  1509.      *
  1510.      * @return void
  1511.      */
  1512.     protected function setAttributeValueSelect(
  1513.         \XLite\Model\Repo\ARepo $repo,
  1514.         \XLite\Model\Product $product,
  1515.         array $data,
  1516.         bool $flush = true
  1517.     ) {
  1518.         $ids = [];
  1519.         $values = $data['value'] ?? [];
  1520.         krsort($values);
  1521.         foreach ($values as $id => $value) {
  1522.             $value = trim($value);
  1523.             if (strlen($value) > 0 && is_int($id)) {
  1524.                 if (!isset($data['deleteValue'][$id])) {
  1525.                     [$avId] = $this->setAttributeValueSelectItem($repo, $product, $data, $id, $value, $flush);
  1526.                     $ids[$avId] = $avId;
  1527.                 }
  1529.                 if (!isset($data['multiple'])) {
  1530.                     break;
  1531.                 }
  1532.             }
  1533.         }
  1535.         // Make a performance curtsy, especially to import.
  1536.         // We don't need to do anything with EM if the collection hasn't been initialized (fetched from DB).
  1537.         $isCollectionInitialized = $product
  1538.             && $product->getAttributeValueS() instanceof PersistentCollection
  1539.             && $product->getAttributeValueS()->isInitialized();
  1541.         foreach ($repo->findBy(['product' => $product, 'attribute' => $this]) as $data) {
  1542.             if ($data->getId() && !isset($ids[$data->getId()])) {
  1543.                 $repo->delete($data, false);
  1545.                 if ($isCollectionInitialized) {
  1546.                     // We have to delete child entities in EM otherwise it will be cascadePersisted again (unmark2delete)
  1547.                     // for ex. here \XLite\Logic\Import\Processor\AProcessor::importData()->\XLite\Core\Database::getEM()->persist($model); XCB-2770
  1548.                     // according to doctrine doc https://www.doctrine-project.org/projects/doctrine-orm/en/2.17/reference/working-with-objects.html#persisting-entities
  1549.                     $product->getAttributeValueS()->removeElement($data);
  1550.                 }
  1551.             }
  1552.         }
  1553.     }
  1555.     protected function setAttributeValueSelectItem(
  1556.         \XLite\Model\Repo\ARepo $repo,
  1557.         \XLite\Model\Product $product,
  1558.         array $data,
  1559.         $id,
  1560.         $value,
  1561.         bool $flush = true
  1562.     ) {
  1563.         static $runtimeCacheAttributeValues = [];
  1565.         static $runtimeCacheAttributeOptions = [];
  1567.         $result = [null, null, null];
  1568.         $attributeValue = $this->getAttributeOptionByValue($repo, $data, $id, $value);
  1569.         $attributeOption = $this->getAttributeOption($value, $attributeValue, $runtimeCacheAttributeOptions);
  1571.         if (!$attributeValue) {
  1572.             $attributeValue = $this->findOrCreateAttributeValue($repo, $attributeOption, $product, $id, $data, $runtimeCacheAttributeValues);
  1573.         }
  1575.         if ($attributeValue) {
  1576.             $this->processAttributeValue($attributeValue, $attributeOption, $data, $id);
  1578.             if ($flush) {
  1579.                 Database::getEM()->flush();
  1580.             }
  1582.             $result = [
  1583.                 $attributeValue->getId(),
  1584.                 $attributeValue,
  1585.                 $attributeOption,
  1586.             ];
  1587.         }
  1589.         return $result;
  1590.     }
  1593.     protected function getAttributeOptionByValue(Arepo $repo, array $data, ?int $id, ?string $value): ?AAttributeValue
  1594.     {
  1595.         if ($id > 0 &&  !isset($data['ignoreIds']) && $this->getProduct()) {
  1596.             $attributeValue = $repo->find($id);
  1597.             if ($attributeValue) {
  1598.                 $attributeOption = $attributeValue->getAttributeOption();
  1599.                 $attributeOption->setName($value);
  1600.                 return $attributeValue;
  1601.             }
  1602.         }
  1603.         return null;
  1604.     }
  1606.     protected function getAttributeOption(
  1607.         ?string $value,
  1608.         ?AAttributeValue $attributeValue,
  1609.         array &$attributeOptionsRuntimeCache
  1610.     ): AttributeOption {
  1611.         $attributeOptionKey = spl_object_id($this) . $value;
  1613.         if ($attributeOption = $attributeOptionsRuntimeCache[$attributeOptionKey] ?? null) {
  1614.             return $attributeOption;
  1615.         }
  1617.         if ($attributeValue) {
  1618.             return $attributeValue->getAttributeOption();
  1619.         }
  1621.         $attributeOption = Database::getRepo(\XLite\Model\AttributeOption::class)
  1622.             ->findOneByNameAndAttribute($value, $this);
  1624.         if ($attributeOption) {
  1625.             return $attributeOption;
  1626.         }
  1628.         $attributeOption = $this->createAttributeOption($value);
  1630.         $attributeOptionsRuntimeCache[$attributeOptionKey] = $attributeOption;
  1632.         return $attributeOption;
  1633.     }
  1635.     protected function findOrCreateAttributeValue(
  1636.         ARepo $repo,
  1637.         AttributeOption $attributeOption,
  1638.         Product $product,
  1639.         ?int $id,
  1640.         array $data,
  1641.         array &$runtimeCacheAttributeValues = []
  1642.     ): AAttributeValue {
  1643.         $attributeValueCacheKey = spl_object_id($product) . $attributeOption?->getId();
  1645.         $attributeValue = $repo->findOneBy([
  1646.             'attribute_option' => $attributeOption,
  1647.             'product' => $product,
  1648.         ]);
  1650.         if (!$attributeValue && $id > 0 && !isset($data['ignoreIds'])) {
  1651.             $attributeValue = $repo->find($id);
  1652.         } elseif (isset($runtimeCacheAttributeValues[$attributeValueCacheKey]) && $attributeOption?->getId()) {
  1653.             $attributeValue = $runtimeCacheAttributeValues[$attributeValueCacheKey];
  1654.         }
  1656.         if (!$attributeValue) {
  1657.             $attributeValue = $this->createAttributeValue($product);
  1658.             $this->setAttributeValuePosition($attributeValue, $product);
  1659.             $product->addAttributeValueS($attributeValue);
  1661.             $runtimeCacheAttributeValues[$attributeValueCacheKey] = $attributeValue;
  1662.         }
  1664.         return $attributeValue;
  1665.     }
  1667.     protected function setAttributeValuePosition(AAttributeValue $attributeValue, Product $product): void
  1668.     {
  1669.         $attributeValue->setPosition(
  1670.             array_reduce(
  1671.                 $product->getAttributeValueS()->toArray(),
  1672.                 function ($carry, AttributeValueSelect $item) {
  1673.                     return $item->getAttribute() === $this ? max($carry, $item->getPosition()) : $carry;
  1674.                 },
  1675.                 0
  1676.             ) + 10
  1677.         );
  1678.     }
  1680.     protected function processAttributeValue($attributeValue, $attributeOption, $data, $id)
  1681.     {
  1682.         $attributeValue->setAttributeOption($attributeOption);
  1683.         $attributeValue->setDefaultValue(isset($data['default'][$id]));
  1685.         foreach ($attributeValue::getModifiers() as $modifier => $options) {
  1686.             if (isset($data[$modifier][$id])) {
  1687.                 $attributeValue->setModifier($data[$modifier][$id], $modifier);
  1688.             }
  1689.         }
  1690.     }
  1692.     /**
  1693.      * Set attribute value (checkbox)
  1694.      *
  1695.      * @param \XLite\Model\Repo\ARepo $repo    Repository
  1696.      * @param \XLite\Model\Product    $product Product
  1697.      * @param array                   $data    Data
  1698.      *
  1699.      * @return void
  1700.      */
  1701.     protected function setAttributeValueCheckbox(
  1702.         \XLite\Model\Repo\ARepo $repo,
  1703.         \XLite\Model\Product $product,
  1704.         array $data,
  1705.         bool $flush = true
  1706.     ) {
  1707.         foreach ([true, false] as $value) {
  1708.             $this->setAttributeValueCheckboxItem($repo, $product, $data, $value);
  1709.         }
  1710.     }
  1712.     /**
  1713.      * Set attribute value (checkbox item)
  1714.      *
  1715.      * @param \XLite\Model\Repo\ARepo $repo    Repository
  1716.      * @param \XLite\Model\Product    $product Product
  1717.      * @param array                   $data    Data
  1718.      * @param boolean|int             $value   Item value
  1719.      *
  1720.      * @return \XLite\Model\AttributeValue\AttributeValueCheckbox
  1721.      */
  1722.     protected function setAttributeValueCheckboxItem(
  1723.         \XLite\Model\Repo\ARepo $repo,
  1724.         \XLite\Model\Product $product,
  1725.         array $data,
  1726.         $value
  1727.     ) {
  1728.         $attributeValue = $repo->findOneBy(
  1729.             [
  1730.                 'product'   => $product,
  1731.                 'attribute' => $this,
  1732.                 'value'     => $value,
  1733.             ]
  1734.         );
  1736.         if (!$attributeValue) {
  1737.             $attributeValue = $this->createAttributeValue($product);
  1738.             $attributeValue->setValue($value);
  1739.         }
  1741.         $value = (int) $value;
  1742.         $attributeValue->setDefaultValue(isset($data['default'][$value]));
  1743.         foreach ($attributeValue::getModifiers() as $modifier => $options) {
  1744.             if (isset($data[$modifier]) && isset($data[$modifier][$value])) {
  1745.                 $attributeValue->setModifier($data[$modifier][$value], $modifier);
  1746.             }
  1747.         }
  1749.         return $attributeValue;
  1750.     }
  1752.     /**
  1753.      * Set attribute value (hidden)
  1754.      *
  1755.      * @param \XLite\Model\Repo\ARepo $repo    Repository
  1756.      * @param \XLite\Model\Product    $product Product
  1757.      * @param array                   $data    Data
  1758.      *
  1759.      * @return void
  1760.      */
  1761.     protected function setAttributeValueHidden(
  1762.         \XLite\Model\Repo\ARepo $repo,
  1763.         \XLite\Model\Product $product,
  1764.         array $data,
  1765.         bool $flush = true
  1766.     ) {
  1767.         $value = $data['value'] ?? [];
  1769.         if (is_array($value)) {
  1770.             $value = end($value);
  1771.         }
  1772.         $value = trim($value);
  1774.         if (strlen($value) != 0) {
  1775.             $this->setAttributeValueHiddenItem($repo, $product, $data, $value, $flush);
  1776.         } else {
  1777.             $attributeValue = $repo->findOneBy(
  1778.                 [
  1779.                     'attribute' => $this,
  1780.                     'product' => $product,
  1781.                 ]
  1782.             );
  1784.             if ($attributeValue) {
  1785.                 $repo->delete($attributeValue);
  1786.             }
  1787.         }
  1788.     }
  1790.     /**
  1791.      * Set hidden attribute item
  1792.      *
  1793.      * @param \XLite\Model\Repo\ARepo $repo    Repository
  1794.      * @param \XLite\Model\Product    $product Product
  1795.      * @param array                   $data    Data
  1796.      * @param mixed                   $value   Attribute value
  1797.      *
  1798.      * @return \XLite\Model\AttributeValue\AttributeValueHidden
  1799.      */
  1800.     protected function setAttributeValueHiddenItem(
  1801.         \XLite\Model\Repo\ARepo $repo,
  1802.         \XLite\Model\Product $product,
  1803.         array $data,
  1804.         $value,
  1805.         bool $flush = true
  1806.     ) {
  1807.         $attributeValue = $repo->findOneBy(
  1808.             [
  1809.                 'attribute' => $this,
  1810.                 'product' => $product,
  1811.             ]
  1812.         );
  1814.         $attributeOption = Database::getRepo(\XLite\Model\AttributeOption::class)
  1815.             ->findOneByNameAndAttribute($value, $this);
  1817.         if (!$attributeOption) {
  1818.             $attributeOption = $this->createAttributeOption($value);
  1819.         }
  1821.         if (!$attributeValue) {
  1822.             $attributeValue = $this->createAttributeValue($product);
  1823.             $product->addAttributeValueH($attributeValue);
  1824.         }
  1826.         if ($attributeValue) {
  1827.             $attributeValue->setAttributeOption($attributeOption);
  1829.             if ($flush) {
  1830.                 Database::getEM()->flush();
  1831.             }
  1832.         }
  1834.         return $attributeValue;
  1835.     }
  1837.     /**
  1838.      * Set attribute value (default)
  1839.      *
  1840.      * @param \XLite\Model\Repo\ARepo $repo    Repository
  1841.      * @param \XLite\Model\Product    $product Product
  1842.      * @param mixed                   $data    Data
  1843.      *
  1844.      * @return \XLite\Model\AttributeValue\AttributeValueText
  1845.      */
  1846.     protected function setAttributeValueDefault(
  1847.         \XLite\Model\Repo\ARepo $repo,
  1848.         \XLite\Model\Product $product,
  1849.         $data,
  1850.         bool $flush = true
  1851.     ) {
  1852.         $editable = is_array($data) && $this->getType() === static::TYPE_TEXT && isset($data['editable'])
  1853.             ? (bool) preg_match('/^1|yes|y|on$/iS', $data['editable'])
  1854.             : null;
  1855.         $value = is_array($data) ? $data['value'] : $data;
  1856.         $value = is_null($value) ? '' : $value;
  1857.         if (is_array($value)) {
  1858.             $value = array_shift($value);
  1859.         }
  1860.         $delete = true;
  1861.         $attributeValue = null;
  1863.         if ($value !== '' || $editable !== null || $this->getType() === static::TYPE_TEXT) {
  1864.             $attributeValue = $repo->findOneBy(['product' => $product, 'attribute' => $this]);
  1866.             if (!$attributeValue) {
  1867.                 $attributeValue = $this->createAttributeValue($product);
  1868.                 $delete = false;
  1869.             }
  1871.             $attributeValue->setValue($value);
  1872.             if ($editable !== null) {
  1873.                 $attributeValue->setEditable($editable);
  1874.             }
  1875.         }
  1877.         if ($delete) {
  1878.             foreach ($repo->findBy(['product' => $product, 'attribute' => $this]) as $data) {
  1879.                 if (!$attributeValue || $attributeValue->getId() !== $data->getId()) {
  1880.                     $repo->delete($data, false);
  1881.                 }
  1882.             }
  1883.         }
  1885.         return $attributeValue;
  1886.     }
  1888.     // }}}
  1890.     /**
  1891.      * Get id
  1892.      *
  1893.      * @return integer
  1894.      */
  1895.     public function getId()
  1896.     {
  1897.         return $this->id;
  1898.     }
  1900.     /**
  1901.      * Set decimals
  1902.      *
  1903.      * @param integer $decimals
  1904.      * @return Attribute
  1905.      */
  1906.     public function setDecimals($decimals)
  1907.     {
  1908.         $this->decimals = $decimals;
  1909.         return $this;
  1910.     }
  1912.     /**
  1913.      * Get decimals
  1914.      *
  1915.      * @return integer
  1916.      */
  1917.     public function getDecimals()
  1918.     {
  1919.         return $this->decimals;
  1920.     }
  1922.     /**
  1923.      * Get type
  1924.      *
  1925.      * @return string
  1926.      */
  1927.     public function getType()
  1928.     {
  1929.         return $this->type;
  1930.     }
  1932.     /**
  1933.      * Get display mode
  1934.      *
  1935.      * @param \XLite\Model\Product $product Product OPTIONAL
  1936.      * @return string
  1937.      */
  1938.     public function getDisplayMode($product = null)
  1939.     {
  1940.         $productId = $product
  1941.             ? $product->getId()
  1942.             : \XLite\Core\Request::getInstance()->product_id;
  1944.         $prop = $this->getProductAttributeProperty($productId);
  1946.         if ($prop && $prop->getDisplayMode()) {
  1947.             return $prop->getDisplayMode();
  1948.         }
  1950.         return $this->displayMode;
  1951.     }
  1953.     /**
  1954.      * @param $productId
  1955.      *
  1956.      * @return null|\XLite\Model\AttributeProperty
  1957.      */
  1958.     protected function getProductAttributeProperty($productId)
  1959.     {
  1960.         return $this->executeCachedRuntime(function () use ($productId) {
  1961.             $property = null;
  1963.             if (
  1964.                 $productId
  1965.                 && ($product = Database::getRepo(\XLite\Model\Product::class)->find($productId))
  1966.             ) {
  1967.                 $property = Database::getRepo(\XLite\Model\AttributeProperty::class)->findOneBy([
  1968.                     'product' => $product,
  1969.                     'attribute'  => $this,
  1970.                 ]);
  1971.             }
  1973.             return $property;
  1974.         }, ['getProductAttributeProperty', $this->getId(), $productId]);
  1975.     }
  1977.     /**
  1978.      * Set display mode
  1979.      *
  1980.      * @param string $value
  1981.      * @param boolean $isNew New attribute flag OPTIONAL
  1982.      *
  1983.      * @return Attribute
  1984.      */
  1985.     public function setDisplayMode($value, $isNew = false)
  1986.     {
  1987.         if (
  1988.             $this->displayMode !== $value
  1989.             && $this->getAttributeProperties()
  1990.             && (!\XLite\Core\Request::getInstance()->product_id
  1991.                 || $isNew)
  1992.         ) {
  1993.             foreach ($this->getAttributeProperties() as $prop) {
  1994.                 $prop->setDisplayMode($value);
  1995.             }
  1996.         }
  1998.         $this->displayMode = $value;
  2000.         return $this;
  2001.     }
  2003.     /**
  2004.      * Return display modes
  2005.      *
  2006.      * @return array
  2007.      */
  2008.     public static function getDisplayModes()
  2009.     {
  2010.         return [
  2011.             static::SELECT_BOX_MODE    => static::t('Selectbox'),
  2012.             static::BLOCKS_MODE        => static::t('Blocks'),
  2013.             static::SPECIFICATION_MODE => static::t('Specification'),
  2014.         ];
  2015.     }
  2017.     /**
  2018.      * Return display mode name
  2019.      *
  2020.      * @return string
  2021.      */
  2022.     public function getDisplayModeName()
  2023.     {
  2024.         $displayModes = self::getDisplayModes();
  2026.         return $displayModes[$this->displayMode] ?? '';
  2027.     }
  2029.     /**
  2030.      * Set productClass
  2031.      *
  2032.      * @param \XLite\Model\ProductClass $productClass
  2033.      * @return Attribute
  2034.      */
  2035.     public function setProductClass(\XLite\Model\ProductClass $productClass = null)
  2036.     {
  2037.         $this->productClass = $productClass;
  2038.         return $this;
  2039.     }
  2041.     /**
  2042.      * Get productClass
  2043.      *
  2044.      * @return \XLite\Model\ProductClass
  2045.      */
  2046.     public function getProductClass()
  2047.     {
  2048.         return $this->productClass;
  2049.     }
  2051.     /**
  2052.      * Set attributeGroup
  2053.      *
  2054.      * @param \XLite\Model\AttributeGroup $attributeGroup
  2055.      * @return Attribute
  2056.      */
  2057.     public function setAttributeGroup(\XLite\Model\AttributeGroup $attributeGroup = null)
  2058.     {
  2059.         $this->attributeGroup = $attributeGroup;
  2060.         return $this;
  2061.     }
  2063.     /**
  2064.      * Get attributeGroup
  2065.      *
  2066.      * @return \XLite\Model\AttributeGroup
  2067.      */
  2068.     public function getAttributeGroup()
  2069.     {
  2070.         return $this->attributeGroup;
  2071.     }
  2073.     /**
  2074.      * Add attribute_options
  2075.      *
  2076.      * @param \XLite\Model\AttributeOption $attributeOptions
  2077.      * @return Attribute
  2078.      */
  2079.     public function addAttributeOptions(\XLite\Model\AttributeOption $attributeOptions)
  2080.     {
  2081.         $this->attribute_options[] = $attributeOptions;
  2082.         return $this;
  2083.     }
  2085.     /**
  2086.      * Get attribute_options
  2087.      *
  2088.      * @return \Doctrine\Common\Collections\Collection
  2089.      */
  2090.     public function getAttributeOptions()
  2091.     {
  2092.         return $this->attribute_options;
  2093.     }
  2095.     /**
  2096.      * Set product
  2097.      *
  2098.      * @param \XLite\Model\Product $product
  2099.      * @return Attribute
  2100.      */
  2101.     public function setProduct(\XLite\Model\Product $product = null)
  2102.     {
  2103.         $this->product = $product;
  2104.         return $this;
  2105.     }
  2107.     /**
  2108.      * Get product
  2109.      *
  2110.      * @return \XLite\Model\Product
  2111.      */
  2112.     public function getProduct()
  2113.     {
  2114.         return $this->product;
  2115.     }
  2117.     /**
  2118.      * Add attribute property
  2119.      *
  2120.      * @param \XLite\Model\AttributeProperty $attributeProperty
  2121.      * @return Attribute
  2122.      */
  2123.     public function addAttributeProperty(\XLite\Model\AttributeProperty $attributeProperty)
  2124.     {
  2125.         $this->attribute_properties[] = $attributeProperty;
  2126.         return $this;
  2127.     }
  2129.     /**
  2130.      * Get attribute_properties
  2131.      *
  2132.      * @return \Doctrine\Common\Collections\Collection
  2133.      */
  2134.     public function getAttributeProperties()
  2135.     {
  2136.         return $this->attribute_properties;
  2137.     }
  2139.     // {{{ Translation Getters / setters
  2141.     /**
  2142.      * @return string
  2143.      */
  2144.     public function getUnit()
  2145.     {
  2146.         return $this->getTranslationField(__FUNCTION__);
  2147.     }
  2149.     /**
  2150.      * @param string $unit
  2151.      *
  2152.      * @return \XLite\Model\Base\Translation
  2153.      */
  2154.     public function setUnit($unit)
  2155.     {
  2156.         return $this->setTranslationField(__FUNCTION__, $unit);
  2157.     }
  2159.     // }}}
  2160. }