add_fee()<\/code>ou trabalhar com get_discounted_price()<\/code>. Infelizmente, esses m\u00e9todos n\u00e3o funcionam mais ou s\u00e3o considerados legados e ser\u00e3o removidos em vers\u00f5es posteriores. A maneira estruturalmente boa de adicionar descontos \u00e9 usar a funcionalidade de cupom integrada no WooCommerce.<\/p>\nNo entanto, um cupom geralmente n\u00e3o pode ser aplicado automaticamente a um carrinho. Ele exige que o cliente digite manualmente um c\u00f3digo de cupom que ele ou ela deve ter recebido. Em algumas lojas online voc\u00ea s\u00f3 quer um desconto aplicado automaticamente quando uma determinada condi\u00e7\u00e3o for atendida sem que o cliente tenha que fazer nada. Isso \u00e9 o que vamos corrigir usando c\u00f3digo.<\/p>\n
Descontos personalizados com cupons<\/h2>\n
Voc\u00ea precisar\u00e1 criar um cupom com um c\u00f3digo e configur\u00e1-lo com os par\u00e2metros que desejar. Voc\u00ea poder\u00e1 aplic\u00e1-lo, remov\u00ea-lo e alterar diferentes sa\u00eddas onde quer que o cupom esteja vis\u00edvel para o cliente. Opcionalmente, se voc\u00ea n\u00e3o quiser cupons dispon\u00edveis para clientes em sua loja virtual, veremos alguns truques simples para ocultar as op\u00e7\u00f5es de inser\u00e7\u00e3o manual de c\u00f3digos de cupom.<\/p>\n
No exemplo de c\u00f3digo abaixo, estou agrupando todo o c\u00f3digo relacionado em uma classe PHP. Isso ajuda para um c\u00f3digo mais limpo, mas \u00e9 especialmente \u00fatil porque queremos fazer refer\u00eancia ao c\u00f3digo do cupom v\u00e1rias vezes. Defini-la como uma vari\u00e1vel de classe \u00e9 melhor do que repeti-la em v\u00e1rias fun\u00e7\u00f5es.<\/p>\n
Crie seu desconto como um cupom<\/h3>\n
O primeiro passo \u00e9 criar o cupom que ser\u00e1 o “placeholder" do seu desconto. O mais f\u00e1cil \u00e9 simplesmente criar um no administrador do WooCommerce (WooCommerce > Coupons > Add Coupon).<\/p>\n
Se voc\u00ea quiser criar o cupom programaticamente, um cupom \u00e9 na verdade uma postagem com a qual voc\u00ea pode criar wp_insert_post()<\/code>– mas voc\u00ea precisa ter o cuidado de criar sua postagem de cupom apenas uma vez. WooCommerce tem um pequeno guia sobre como criar um cupom programaticamente<\/a>.<\/p>\nForne\u00e7a um slug exclusivo como seu c\u00f3digo de cupom e, no m\u00ednimo, configure o valor do desconto (uma porcentagem ou taxa fixa). Quanto ao exemplo de c\u00f3digo abaixo, criei um c\u00f3digo de cupom ‘ example<\/code>‘ (recomendo usar um nome mais criativo e adequado para o seu).<\/p>\nCriando a classe PHP que conter\u00e1 todo o nosso c\u00f3digo<\/h3>\n
Vamos finalmente \u00e0 codifica\u00e7\u00e3o! Voc\u00ea pode definir esta classe diretamente dentro do seu tema functions.php<\/code>, c\u00f3digo de plugin ou um arquivo separado inclu\u00eddo.<\/p>\nclass AWPCustomDiscount {\n private $coupon_code = 'example';\n\u00a0\n public function __construct() {\n\u00a0\n }\n}\nnew AWPCustomDiscount();<\/code><\/pre>\nNomeie sua classe como quiser e substitua a vari\u00e1vel $coupon_code<\/code>de classe pelo nome que voc\u00ea deu ao seu cupom. N\u00e3o se esque\u00e7a de inicializar a classe depois no final (new AWPCustomDiscount()<\/code>).<\/p>\nSe voc\u00ea programou orienta\u00e7\u00e3o a objetos antes, isso deve ser familiar para voc\u00ea. Se n\u00e3o, n\u00e3o se preocupe, isso deve ser simples de seguir. Adicionaremos algumas fun\u00e7\u00f5es aqui e nos referiremos ao c\u00f3digo do cupom com $this->coupon_code<\/code>. Vamos come\u00e7ar com o c\u00f3digo respons\u00e1vel por realmente adicionar o cupom quando as condi\u00e7\u00f5es forem atendidas.<\/p>\nAplicando cupom programaticamente<\/h3>\n
Por experi\u00eancia, aprendi que ligar o c\u00f3digo para aplicar e remover cupons funciona melhor e de forma mais consistente usando os dois ganchos a seguir; um para o carrinho (woocommerce_before_cart<\/code>) e outro para o checkout (woocommerce_before_checkout_form<\/code>).<\/p>\nDentro da fun\u00e7\u00e3o, tudo o que precisamos fazer \u00e9 verificar as condi\u00e7\u00f5es que queremos. WooCommerce oferece fun\u00e7\u00f5es para obter o objeto do carrinho with WC()->cart<\/code>que podemos usar para obter todas as informa\u00e7\u00f5es que precisamos sobre o carrinho, como seus itens e totais. Como exemplo, o c\u00f3digo abaixo aplicar\u00e1 um desconto se o total do carrinho (excluindo quaisquer descontos) estiver acima de um determinado valor.<\/p>\nDevemos tamb\u00e9m garantir que se as condi\u00e7\u00f5es n\u00e3o forem atendidas, devemos remover o desconto se tiver sido adicionado anteriormente. No nosso exemplo, imagine que o cliente ultrapassou o valor m\u00e1ximo, mas depois foi ao carrinho, retirou alguns itens e assim voltou a ficar abaixo do valor exigido. Como os cupons n\u00e3o s\u00e3o aplicados automaticamente, todos os cupons aplicados tamb\u00e9m precisam ser removidos programaticamente.<\/p>\n
Usandoapply_coupon<\/code><\/h4>\nOs cupons s\u00e3o adicionados ao objeto do carrinho apply_coupon()<\/code>fornecendo o c\u00f3digo do cupom como par\u00e2metro e s\u00e3o removidos do objeto do carrinho remove_coupon()<\/code>com o c\u00f3digo do cupom como par\u00e2metro. Simples o suficiente. Tamb\u00e9m podemos usar a fun\u00e7\u00e3o t\u00e3o apropriadamente nomeada get_applied_coupons()<\/code>no objeto carrinho para verificar se nosso cupom j\u00e1 foi aplicado.<\/p>\n ...\n public function __construct() {\n add_action('woocommerce_before_cart', [$this, 'addDiscount']);\n add_action('woocommerce_before_checkout_form', [$this, 'addDiscount']);\n }\n\u00a0\n function addDiscount() {\n if (is_admin() && !defined('DOING_AJAX')) {\n return;\n }\n if (WC()->cart->get_subtotal() > 500) {\n \/\/ add discount, if not added already\n if (!in_array($this->coupon_code, WC()->cart->get_applied_coupons())) {\n WC()->cart->apply_coupon($this->coupon_code);\n }\n } else {\n \/\/ remove discount if it was previously added\n WC()->cart->remove_coupon($this->coupon_code);\n }\n }\n ...<\/code><\/pre>\nSe voc\u00ea n\u00e3o estiver familiarizado com o uso de PHP orientado a objetos no WordPress; aqui est\u00e1 um breve resumo de como o acima funciona: A __construct()<\/code>fun\u00e7\u00e3o ser\u00e1 executada sempre que a classe for inicializada, o que fazemos imediatamente ap\u00f3s a classe. Dentro __construct()<\/code>, voc\u00ea normalmente adicionar\u00e1 todos os ganchos como faria normalmente, por exemplo, dentro de functions.php<\/code>. Para que o WordPress encontre nossas fun\u00e7\u00f5es dentro de nossa classe, precisamos dizer ao gancho para se referir a uma fun\u00e7\u00e3o definida em uma matriz que consiste em $this<\/code>(o objeto de classe) e o nome da fun\u00e7\u00e3o.<\/p>\nDentro da fun\u00e7\u00e3o addDiscount()<\/code>programamos em nossas condi\u00e7\u00f5es. No exemplo acima eu busco o total do carrinho usando WC()->cart->get_subtotal()<\/code>e comparo com as minhas condi\u00e7\u00f5es \u2013 sendo acima de 500.<\/p>\nObserva\u00e7\u00e3o: se voc\u00ea precisar buscar e comparar os totais do carrinho, saiba que a maioria dos totais inclui cupons. Por exemplo, o mais familiar WC()->cart->get_cart_contents_total()<\/code>devolver\u00e1 o total antes do envio, mas inclui descontos; o que significa que, se seu desconto j\u00e1 foi aplicado anteriormente, esse total estar\u00e1 errado para compara\u00e7\u00e3o.<\/p>\nVoc\u00ea pode chamar apply_coupon()<\/code>sem verificar se o cupom j\u00e1 foi aplicado (a if<\/code>verifica\u00e7\u00e3o na linha #14), porque a pr\u00f3pria fun\u00e7\u00e3o apply_coupon()<\/code>se certificar\u00e1 de n\u00e3o adicion\u00e1-lo novamente se tiver sido aplicado antes. No entanto, esta if<\/code>verifica\u00e7\u00e3o evita que o cliente receba uma mensagem de erro dizendo “O cupom j\u00e1 foi aplicado” toda vez que o carrinho for atualizado.<\/p>\n\u00c9 assim que seu desconto aparecer\u00e1 nos totais do carrinho no carrinho e na finaliza\u00e7\u00e3o da compra:<\/p>\n
![\"Como](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152866-61e4fcd750a7d.png\")
<\/a><\/p>\nSuas condi\u00e7\u00f5es de desconto<\/h4>\n
As condi\u00e7\u00f5es do seu cupom dependem inteiramente de voc\u00ea e de suas necessidades. Configurei alguns exemplos de condi\u00e7\u00f5es para adicionar uma taxa personalizada em uma postagem anterior<\/a> – por exemplo, dependendo do local de envio ou de quais produtos est\u00e3o no carrinho. Voc\u00ea tamb\u00e9m pode comparar a data de hoje se quiser dar um desconto especial de Natal ou Halloween, ou dar um desconto com base nas condi\u00e7\u00f5es do cliente conectado.<\/p>\nSe preferir aplicar o cupom dependendo das configura\u00e7\u00f5es definidas no pr\u00f3prio cupom \u2013 por exemplo, excluir ou incluir determinados IDs de produtos, voc\u00ea tamb\u00e9m pode faz\u00ea-lo. Voc\u00ea pode instanciar um objeto do cupom a partir do c\u00f3digo do cupom, assim:<\/p>\n
$coupon = new WC_Coupon($this->coupon_code);<\/code><\/pre>\nCom esse objeto de cupom, voc\u00ea tem acesso a todas as fun\u00e7\u00f5es para buscar quaisquer configura\u00e7\u00f5es definidas no cupom. Por exemplo, obter IDs de produtos que devem ser inclu\u00eddos no cupom:<\/p>\n
$required_products = $coupon->get_product_ids();<\/code><\/pre>\n