{"id":3854,"date":"2022-09-20T00:05:00","date_gmt":"2022-09-20T03:05:00","guid":{"rendered":"https:\/\/www.magenteiro.com\/blog\/?p=3854"},"modified":"2022-09-19T22:01:59","modified_gmt":"2022-09-20T01:01:59","slug":"atributo-de-promocao-personalizado","status":"publish","type":"post","link":"https:\/\/www.magenteiro.com\/blog\/magento-2\/atributo-de-promocao-personalizado\/","title":{"rendered":"Promo\u00e7\u00e3o personalizada: como criar um atributo de promo\u00e7\u00e3o"},"content":{"rendered":"\n

Neste tutorial veremos como criar uma condi\u00e7\u00e3o de promo\u00e7\u00e3o personalizada<\/strong> no Magento. Como sabemos, o Magento possui diversos tipos de promo\u00e7\u00f5es<\/a>, pre\u00e7os especiais, etc.<\/p>\n\n\n\n

Essas promo\u00e7\u00f5es nos permitem criar regras de (quase) infinitos tipos. Voc\u00ea pode criar promo\u00e7\u00f5es com base em categorias, grupo de clientes, quantidade de itens no carrinho, atributos de produto, e muito mais. E voc\u00ea ainda pode combinar estas condi\u00e7\u00f5es entre si.<\/p>\n\n\n\n

\"Regras<\/figure>\n\n\n\n

Outras condi\u00e7\u00f5es<\/h2>\n\n\n\n

Embora seja extremamente raro, pode haver casos onde o atributo que voc\u00ea deseja utilizar n\u00e3o exista. E ainda, que n\u00e3o haja outra forma de se contornar a necessidade com recursos existentes do Magento<\/a>.<\/p>\n\n\n\n

Falando nisso, recentemente precisei criar um m\u00f3dulo que me permitisse utilizar uma vari\u00e1vel do servidor ($_SERVER<\/code>) como atributo de promo\u00e7\u00e3o.<\/p>\n\n\n\n

Para minha surpresa, a implementa\u00e7\u00e3o disso foi mais f\u00e1cil do que eu esperava. Veja s\u00f3…<\/p>\n\n\n\n

Adicionando uma condi\u00e7\u00e3o de promo\u00e7\u00e3o personalizada<\/h2>\n\n\n\n

No exemplo a seguir, criarei um m\u00f3dulo que adicionar\u00e1 uma propriedade personalizada que poder\u00e1 ser usada nas promo\u00e7\u00f5es de carrinho.<\/p>\n\n\n\n

Esta propriedade ir\u00e1 ler o valor de $_SERVER['HTTP_CF_IPCOUNTRY']<\/code>, que \u00e9 uma propriedade enviada pelo Cloudflare para identificar o pa\u00eds de origem do visitante<\/a>, e disponibilizar\u00e1 ela nas regras.<\/p>\n\n\n\n

\"Promo\u00e7\u00e3o<\/figure>\n\n\n\n

Passo 1: criar um m\u00f3dulo base<\/h3>\n\n\n\n

O primeiro passo \u00e9 criar um m\u00f3dulo base para Magento 2.<\/a> Se voc\u00ea n\u00e3o sabe como fazer isso, leia o artigo mencionado ou fa\u00e7a meu curso de cria\u00e7\u00e3o de m\u00f3dulos para Magento 2<\/a>.<\/p>\n\n\n\n

Para o exemplo abaixo, criarei um m\u00f3dulo chamado Magenteiro_IpCountryCartRule<\/code>. Todos os caminhos abaixo se referenciam \u00e0 pasta raiz do m\u00f3dulo criado.<\/p>\n\n\n\n

Passo 2: implemente a condi\u00e7\u00e3o<\/h3>\n\n\n\n

Para implementar uma condi\u00e7\u00e3o personalizada, n\u00f3s estendemos a classe Magento\\Rule\\Model\\Condition\\AbstractCondition<\/code> e implementamos alguns de seus m\u00e9todos. Veja no exemplo:<\/p>\n\n\n\n

<?php\ndeclare(strict_types=1);\n\nnamespace Magenteiro\\IpCountryCartRule\\Model\\Rule\\Condition;\n\nuse Magento\\Rule\\Model\\Condition\\AbstractCondition;\n\nclass IpCountry extends AbstractCondition\n{\n    \/** @var \\Magento\\Checkout\\Model\\Session  *\/\n    protected $_checkoutSession;\n\n    public function __construct(\n        \\Magento\\Rule\\Model\\Condition\\Context $context,\n        \\Magento\\Checkout\\Model\\Session $checkoutSession,\n        array $data = []\n    ) {\n        parent::__construct($context, $data);\n        $this->_checkoutSession = $checkoutSession;\n    }\n\n    public function loadAttributeOptions()\n    {\n        $this->setAttributeOption([\n            'ipcountry' => __('User Country by Ip')\n        ]);\n\n        return $this;\n    }\n\n    public function getInputType()\n    {\n        return 'select';  \/\/ tipo de entrada do admin\n    }\n\n    public function getValueElementType()\n    {\n        return 'text';\n    }\n\n    public function validate(\\Magento\\Framework\\Model\\AbstractModel $model)\n    {\n        $ipCountry = $_SERVER['HTTP_CF_IPCOUNTRY'] ?? null;\n        $model->setData('ipcountry', $ipCountry);  \/\/ valor a ser validado\n\n        return parent::validate($model); \/\/verifica se valor a ser validado \u00e9 o mesmo configurado na regra e retorna true se a regra tem que ser aplicada\n    }\n}<\/pre>\n\n\n\n
Passo 3: Cria\u00e7\u00e3o de um Observer<\/h3>\n\n\n\n
Usaremos um Observer para o evento salesrule_rule_condition_combine<\/code> que \u00e9 disparado em Magento\\SalesRule\\Model\\Rule\\Condition\\Combine::getNewChildSelectOptions<\/code>. Fazemos isso para adicionar a op\u00e7\u00e3o que acabamos de criar \u00e0 lista de atributos dispon\u00edveis na cria\u00e7\u00e3o de regras promocionais.<\/p>\n\n\n\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<config xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"urn:magento:framework:Event\/etc\/events.xsd\">\n    <event name=\"salesrule_rule_condition_combine\">\n        <observer name=\"magenteiro_useripcountry\" instance=\"Magenteiro\\IpCountryCartRule\\Observer\\UserIpCountry\"\/>\n    <\/event>\n<\/config><\/pre>\n\n\n\n
<?php\ndeclare(strict_types=1);\n\nnamespace Magenteiro\\IpCountryCartRule\\Observer;\n\nuse Magento\\Framework\\Event\\ObserverInterface;\n\nclass UserIpCountry implements ObserverInterface\n{\n    public function execute(\\Magento\\Framework\\Event\\Observer $observer)\n    {\n        $additional = $observer->getAdditional();\n        $conditions = (array) $additional->getConditions();\n\n        $conditions = array_merge_recursive($conditions, [\n            $this->getCustomerCountryCondition()\n        ]);\n\n        $additional->setConditions($conditions);\n        return $this;\n    }\n\n    private function getCustomerCountryCondition()\n    {\n        return [\n            'label'=> __('User Country (by Ip)'),\n            'value'=> \\Magenteiro\\IpCountryCartRule\\Model\\Rule\\Condition\\IpCountry::class\n        ];\n    }\n}<\/pre>\n\n\n\n
Passo 4: Injete o argumento $data na classe da condi\u00e7\u00e3o<\/h3>\n\n\n\n
Por fim, injete a propriedade<\/a> form_name<\/code> no array $data<\/code> que \u00e9 passado para a classe que criamos.<\/p>\n\n\n\n
<?xml version=\"1.0\"?>\n<config xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"urn:magento:framework:ObjectManager\/etc\/config.xsd\">\n    <type name=\"Magenteiro\\IpCountryCartRule\\Model\\Rule\\Condition\\IpCountry\">\n        <arguments>\n            <argument name=\"data\" xsi:type=\"array\">\n                <item name=\"form_name\" xsi:type=\"string\">sales_rule_form<\/item>\n            <\/argument>\n        <\/arguments>\n    <\/type>\n<\/config><\/pre>\n\n\n\n
Pronto! Basta ativar o m\u00f3dulo, limpar os caches e voc\u00ea ter\u00e1 uma nova propriedade promocional para utilizar em sua loja.<\/p>\n\n\n\n
Se preferir, baixe o m\u00f3dulo final preenchendo o formul\u00e1rio abaixo.<\/p>\n\n\n\n