{"id":8071,"date":"2023-08-14T14:21:13","date_gmt":"2023-08-14T21:21:13","guid":{"rendered":"https:\/\/membermouse.com\/?post_type=ht_kb&p=8071"},"modified":"2024-08-07T14:02:15","modified_gmt":"2024-08-07T18:02:15","slug":"membermouse-wordpress-hooks","status":"publish","type":"ht_kb","link":"https:\/\/membermouse.com\/pt\/docs\/membermouse-wordpress-hooks\/","title":{"rendered":"MemberMouse WordPress Hooks"},"content":{"rendered":"

Hooks are provided by WordPress to allow your plugin to ‘hook into’ the rest of WordPress; that is, to call functions in your plugin at specific times, and thereby set your plugin in motion. MemberMouse defines its own set of hooks that you can utilize to ‘hook into’ MemberMouse so you can call functions in your plugin when specific events occur in MemberMouse.<\/p>\n\n\n\n

Here’s a basic example: <\/p>\n\n\n\n

<\/div>\n\n\n\n
function memberAdded($data)\n{\n    \/\/ executar a\u00e7\u00e3o\n}\nadd_action('mm_member_add', 'memberAdded');\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
In this example, we’re using the ‘add_action()<\/a>‘ method to indicate that the ‘memberAdded() ‘method should be called when MemberMouse executes a ‘mm_member_add’ action. To learn more about working with WordPress’ Action API leia este artigo<\/a>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Categorias de Hooks do WordPress<\/h5>\n\n\n\n
Refer\u00eancia da a\u00e7\u00e3o MemberMouse<\/h6>\n\n\n\n
The following table lists all of the MemberMouse actions, a description of when they’re executed and what data will be passed to any function hooked into the action.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A\u00e7\u00e3o<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td>Dados transmitidos<\/strong><\/td><\/tr>
mm_member_add<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando um novo membro \u00e9 adicionado ao MemberMouse.<\/td>dados do membro<\/a><\/td><\/tr>
mm_member_membership_change<\/code><\/td>This action is executed when a member’s membership level is changed.<\/td>dados do membro<\/a><\/td><\/tr>
mm_member_status_change<\/code><\/td>This action is executed when the status of a member’s account changes.<\/td>dados do membro<\/a><\/td><\/tr>
mm_member_account_update<\/code><\/td>This action is executed when certain data on a member’s account is updated.
Isso inclui: nome, sobrenome, endere\u00e7o de e-mail, nome de usu\u00e1rio, n\u00famero de telefone,
notas, endere\u00e7o de cobran\u00e7a, endere\u00e7o de entrega, m\u00e9todo de c\u00e1lculo de dias como membro e dados de campos personalizados.<\/td>		dados do membro<\/a><\/td><\/tr>
mm_member_delete<\/code><\/td>This action is executed when a member’s account is deleted.<\/td>dados do membro<\/a><\/td><\/tr>
mm_bundles_add<\/code><\/td>This action is executed when a bundle is added to a member’s account.<\/td>dados do membro<\/a>, dados do pacote<\/a><\/td><\/tr>
mm_bundles_status_change<\/code><\/td>This action is executed when the status of a bundle changes on a member’s account.<\/td>dados do membro<\/a>, dados do pacote<\/a><\/td><\/tr>
mm_product_purchase<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando um pedido \u00e9 enviado, antes da valida\u00e7\u00e3o e do pagamento.<\/td>dados do membro<\/a>, dados do pedido<\/a><\/td><\/tr>
mm_purchase_complete<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando uma compra \u00e9 conclu\u00edda. Ela est\u00e1 dispon\u00edvel no MemberMouse 3.0.6 e mais recente.<\/td>dados do membro<\/a>, dados do pedido<\/a><\/td><\/tr>
mm_payment_received<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando um pagamento \u00e9 recebido.<\/td>dados do membro<\/a>, dados do pedido<\/a><\/td><\/tr>
mm_payment_rebill<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando um pagamento de cobran\u00e7a \u00e9 recebido.<\/td>dados do membro<\/a>, dados do pedido<\/a><\/td><\/tr>
mm_payment_rebill_declined<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando um pagamento de cobran\u00e7a \u00e9 recusado.<\/td>dados do membro<\/a>, dados do pedido<\/a><\/td><\/tr>
mm_refund_issued<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando um reembolso \u00e9 emitido.<\/td>dados do membro<\/a>, dados do pedido<\/a><\/td><\/tr>
mm_commission_initial<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando uma comiss\u00e3o inicial de afiliado deve ser rastreada.<\/td>dados de afiliados<\/a><\/td><\/tr>
mm_commission_rebill<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando uma comiss\u00e3o de afiliado de cobran\u00e7a deve ser rastreada.<\/td>dados de afiliados<\/a><\/td><\/tr>
mm_commission_cancel<\/code><\/td>Essa a\u00e7\u00e3o \u00e9 executada quando uma comiss\u00e3o de afiliado deve ser cancelada.<\/td>dados de afiliados<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Atributos de dados por tipo<\/h5>\n\n\n\n
Todos os dados s\u00e3o passados para as fun\u00e7\u00f5es como uma matriz associativa e podem ser acessados da seguinte forma: <\/p>\n\n\n\n
<\/div>\n\n\n\n
$data[\"first_name\"]\n$data[\"last_name\"]\n$data[\"email\"]\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
As se\u00e7\u00f5es abaixo listam os atributos de dados dispon\u00edveis para cada tipo.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Dados do membro<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
member_id<\/code><\/td>A ID atribu\u00edda ao membro pelo MemberMouse.<\/td><\/tr>
registrado<\/code><\/td>A data em que o membro se registrou no formato AAAA-MM-DD HH:MM:SS.<\/td><\/tr>
last_logged_in<\/code><\/td>A data em que o membro fez login pela \u00faltima vez no formato AAAA-MM-DD HH:MM:SS.<\/td><\/tr>
last_updated<\/code><\/td>The date the member’s account was last updated in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr>
dias_como_membro<\/code><\/td>O n\u00famero de dias em que o membro \u00e9 membro.<\/td><\/tr>
status<\/code><\/td>The status of the member’s account as an integer: 1 = active, 2 = canceled, 3 = locked, 4 = paused, 5 = overdue, 6 = pending activation, 7 = error, 8 = expired, 9 = pending cancellation<\/td><\/tr>
nome_do_status<\/code><\/td>The status of the member’s account as a string (i.e. ativo<\/em>, cancelado<\/em>etc.).<\/td><\/tr>
is_complimentary<\/code><\/td>This indicates if the member’s account is complimentary or not. It will be set to ‘true’ if the account is complimentary and ‘false’ if not.<\/td><\/tr>
n\u00edvel de associa\u00e7\u00e3o<\/code><\/td>The ID of the membership level associated with the member’s account.<\/td><\/tr>
nome do n\u00edvel de associa\u00e7\u00e3o<\/code><\/td>The name of the membership level associated with the member’s account.<\/td><\/tr>
primeiro_nome<\/code><\/td>The member’s first name.<\/td><\/tr>
sobrenome<\/code><\/td>The member’s last name.<\/td><\/tr>
nome de usu\u00e1rio<\/code><\/td>The member’s username.<\/td><\/tr>
e-mail<\/code><\/td>The member’s email address.<\/td><\/tr>
telefone<\/code><\/td>The member’s phone number.<\/td><\/tr>
cf_#<\/code><\/td>Outputs the member’s value for the custom field with ID #. For example, if the ID of the custom field that stores birthday is 4 then to output the member’s birthday you would use ‘cf_4’.<\/td><\/tr>
endere\u00e7o de cobran\u00e7a<\/code><\/td>The member’s billing address.<\/td><\/tr>
cidade_de_faturamento<\/code><\/td>The member’s billing city.<\/td><\/tr>
billing_state<\/code><\/td>The member’s billing state.<\/td><\/tr>
billing_zip_code<\/code><\/td>The member’s billing zip code.<\/td><\/tr>
pa\u00eds_de_faturamento<\/code><\/td>The member’s billing country.<\/td><\/tr>
endere\u00e7o_de_envio<\/code><\/td>The member’s shipping address.<\/td><\/tr>
cidade_de_envio<\/code><\/td>The member’s shipping city.<\/td><\/tr>
shipping_state<\/code><\/td>The member’s shipping state.<\/td><\/tr>
c\u00f3digo_de_zip_de_envio<\/code><\/td>The member’s shipping zip code.<\/td><\/tr>
pa\u00eds_de_envio<\/code><\/td>The member’s shipping country.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Dados do pacote<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
bundle_id<\/code><\/td>A ID do pacote.<\/td><\/tr>
nome do pacote<\/code><\/td>O nome do pacote.<\/td><\/tr>
dias_com_bundle<\/code><\/td>The number of days the bundle has been active on the member’s account.<\/td><\/tr>
bundle_status<\/code><\/td>O status do pacote: 1 = ativo, 2 = cancelado, 3 = bloqueado, 4 = pausado, 5 = vencido, 6 = ativa\u00e7\u00e3o pendente, 7 = erro, 8 = expirado, 9 = cancelamento pendente<\/td><\/tr>
bundle_is_complimentary<\/code><\/td>This indicates if the bundle is complimentary or not. It will be set to ‘true’ if the bundle is complimentary and ‘false’ if not.<\/td><\/tr>
nome_do_conjunto<\/code><\/td>O status do pacote como uma cadeia de caracteres (ou seja ativo<\/em>, cancelado<\/em>etc.).<\/td><\/tr>
bundle_date_added<\/code><\/td>The date the bundle was added to the member’s account in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr>
bundle_last_updated<\/code><\/td>The date the bundle was last updated on the member’s account in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Dados do pedido<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
n\u00famero do pedido<\/code><\/td>O n\u00famero de refer\u00eancia atribu\u00eddo ao pedido pelo MemberMouse.<\/td><\/tr>
order_transaction_id<\/code><\/td>The transaction ID associated with the order. This can be used as a unique ID for all payments associated with an order. When a customer purchases a subscription, each rebill payment is part of the same order so they’ll all share the same order ID. Each rebill payment will have a unique transaction ID.<\/td><\/tr>
total_do_pedido<\/code><\/td>O total do pedido, que \u00e9 igual a (subtotal - desconto) + frete.<\/td><\/tr>
subtotal_do_pedido<\/code><\/td>O subtotal do pedido.<\/td><\/tr>
order_discount<\/code><\/td>O desconto aplicado ao pedido.<\/td><\/tr>
envio de pedidos<\/code><\/td>Custo de frete aplicado ao pedido.<\/td><\/tr>
order_shipping_method<\/code><\/td>O nome do m\u00e9todo de envio escolhido pelo cliente ao fazer o check-out.<\/td><\/tr>
endere\u00e7o de faturamento do pedido<\/code><\/td>O endere\u00e7o de cobran\u00e7a associado ao pedido.<\/td><\/tr>
order_billing_city<\/code><\/td>A cidade de cobran\u00e7a associada ao pedido.<\/td><\/tr>
order_billing_state<\/code><\/td>O estado de faturamento associado ao pedido.<\/td><\/tr>
order_billing_zip_code<\/code><\/td>O c\u00f3digo postal de cobran\u00e7a associado ao pedido.<\/td><\/tr>
pa\u00eds de faturamento do pedido<\/code><\/td>O pa\u00eds de cobran\u00e7a associado ao pedido.<\/td><\/tr>
endere\u00e7o de envio do pedido<\/code><\/td>O endere\u00e7o de entrega associado ao pedido.<\/td><\/tr>
cidade_de_envio_do_pedido<\/code><\/td>A cidade de envio associada ao pedido.<\/td><\/tr>
order_shipping_state<\/code><\/td>O estado de envio associado ao pedido.<\/td><\/tr>
c\u00f3digo postal de envio do pedido<\/code><\/td>O c\u00f3digo postal de remessa associado ao pedido.<\/td><\/tr>
pa\u00eds_de_envio_do_pedido<\/code><\/td>O pa\u00eds de remessa associado ao pedido.<\/td><\/tr>
produtos_pedidos<\/code><\/td>Uma matriz de produtos associados ao pedido. Consulte a se\u00e7\u00e3o Dados do produto<\/em> A tabela abaixo apresenta os par\u00e2metros dispon\u00edveis para cada produto.<\/td><\/tr>
cupons_de_pedido<\/code><\/td>Uma matriz de cupons associados ao pedido. Consulte a se\u00e7\u00e3o Dados do cupom<\/em> A tabela abaixo mostra os par\u00e2metros dispon\u00edveis para cada cupom.<\/td><\/tr>
order_prorations<\/code><\/td>Uma matriz de rateios associados ao pedido. Veja o Dados de precifica\u00e7\u00e3o<\/em> A tabela abaixo apresenta os par\u00e2metros dispon\u00edveis para cada item de rateio.<\/td><\/tr>
order_affiliate_id<\/code><\/td>O ID de afiliado associado ao pedido.<\/td><\/tr>
order_subaffiliate_id<\/code><\/td>A ID da subafiliada associada ao pedido.<\/td><\/tr>
endere\u00e7o_ip_do_pedido<\/code><\/td>O endere\u00e7o IP associado ao pedido.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Dados de afiliados<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
order_affiliate_id<\/code><\/td>O ID de afiliado associado ao pedido.<\/td><\/tr>
order_subaffiliate_id<\/code><\/td>A ID da subafiliada associada ao pedido.<\/td><\/tr>
member_id<\/code><\/td>A ID atribu\u00edda ao membro pelo MemberMouse.<\/td><\/tr>
n\u00famero do pedido<\/code><\/td>O n\u00famero exclusivo associado ao pedido concatenado com o ID da transa\u00e7\u00e3o associado ao pagamento (ou seja, 1456-3462). Isso garante que o n\u00famero do pedido fornecido aqui seja exclusivo em todas as transa\u00e7\u00f5es de cobran\u00e7a associadas ao pedido.<\/td><\/tr>
total_do_pedido<\/code><\/td>O total do pedido dispon\u00edvel para comiss\u00f5es, que \u00e9 igual ao total do pedido menos os descontos e os custos de envio.<\/td><\/tr>
endere\u00e7o_ip_do_pedido<\/code><\/td>O endere\u00e7o IP associado ao pedido.<\/td><\/tr>
produtos_pedidos<\/code><\/td>Uma matriz de produtos associados ao pedido. Consulte a se\u00e7\u00e3o Dados do produto<\/em> A tabela abaixo apresenta os par\u00e2metros dispon\u00edveis para cada produto.<\/td><\/tr>
cupons_de_pedido<\/code><\/td>Uma matriz de cupons associados ao pedido. Consulte a se\u00e7\u00e3o Dados do cupom<\/em> A tabela abaixo mostra os par\u00e2metros dispon\u00edveis para cada cupom.<\/td><\/tr>
order_prorations<\/code><\/td>Uma matriz de rateios associados ao pedido. Veja o Dados de precifica\u00e7\u00e3o<\/em> A tabela abaixo apresenta os par\u00e2metros dispon\u00edveis para cada item de rateio.<\/td><\/tr>
rebill_commission_flat_rate<\/code><\/td>This will only be included on commission rebill events. Based on the commission profile applied to the order, this indicates if there’s a flat rate commission override that should be taken into account.<\/td><\/tr>
rebill_commission_percent<\/code><\/td>This will only be included on commission rebill events. Based on the commission profile applied to the order, this indicates if there’s a percentage commission override that should be taken into account.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Dados do produto<\/h6>\n\n\n\n
Product data is stored as an array of JSON-encoded objects in the ‘order_products’ attribute and is included with Order Data and Affiliate Data. Prior to interacting with the array make sure to JSON decode is as follows:<\/p>\n\n\n\n
<\/div>\n\n\n\n
json_decode(stripslashes($data[\"order_products\"]);<\/code><\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
This sample code assumes that the data was passed to your script in variable called ‘$data’. The table below outlines the available parameters for each item in the ‘order_products’ array.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
id<\/code><\/td>A ID do produto.<\/td><\/tr>
nome<\/code><\/td>O nome do produto.<\/td><\/tr>
sku<\/code><\/td>A SKU do produto.<\/td><\/tr>
quantidade<\/code><\/td>O valor pago por cada unidade do produto.<\/td><\/tr>
quantidade<\/code><\/td>O n\u00famero deste produto adquirido.<\/td><\/tr>
total<\/code><\/td>O pre\u00e7o total pago \u00e9 equivalente ao valor * quantidade.<\/td><\/tr>
is_recurring<\/code><\/td>Indicates where this product has a subscription associated with it or not. Possible values are ‘true’ or ‘false’.<\/td><\/tr>
recurring_amount<\/code><\/td>O valor pago em cada per\u00edodo de cobran\u00e7a.<\/td><\/tr>
per\u00edodo de cobran\u00e7a<\/code><\/td>Um n\u00famero inteiro que representa a dura\u00e7\u00e3o do per\u00edodo de cobran\u00e7a. Para determinar a dura\u00e7\u00e3o completa do per\u00edodo de cobran\u00e7a, combine esse valor com rebill_frequency (ou seja, 1 m\u00eas, 30 dias, 2 semanas etc.).<\/td><\/tr>
rebill_frequency<\/code><\/td>Uma cadeia de caracteres que indica a unidade de medida usada para o per\u00edodo de cobran\u00e7a. Os valores poss\u00edveis s\u00e3o dias, semanas, meses ou anos.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Dados do cupom<\/h6>\n\n\n\n
Coupon data is stored as an array of JSON-encoded objects in the ‘order_coupons’ attribute and is included with Order Data and Affiliate Data. Prior to interacting with the array make sure to JSON decode is as follows:<\/p>\n\n\n\n
<\/div>\n\n\n\n
json_decode(stripslashes($data[\"order_coupons\"]);<\/code><\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
This sample code assumes that the data was passed to your script in variable called ‘$data’. The table below outlines the available parameters for each item in the ‘order_coupons’ array.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
id<\/code><\/td>A ID do cupom.<\/td><\/tr>
nome<\/code><\/td>O nome do cupom.<\/td><\/tr>
c\u00f3digo<\/code><\/td>O c\u00f3digo do cupom.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Dados de precifica\u00e7\u00e3o<\/h6>\n\n\n\n
Proration data is stored as an array of JSON-encoded objects in the ‘order_prorations’ attribute and is included with Order Data and Affiliate Data. Prior to interacting with the array make sure to JSON decode is as follows:<\/p>\n\n\n\n
<\/div>\n\n\n\n
json_decode(stripslashes($data[\"order_prorations\"]);\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
This sample code assumes that the data was passed to your script in variable called ‘$data’. The table below outlines the available parameters for each item in the ‘order_prorations’ array.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
quantidade<\/code><\/td>O valor do rateio.<\/td><\/tr>
descri\u00e7\u00e3o<\/code><\/td>A descri\u00e7\u00e3o associada \u00e0 compra.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>","protected":false},"excerpt":{"rendered":"
Os ganchos s\u00e3o fornecidos pelo WordPress para permitir que seu plug-in \"se conecte\" ao restante do WordPress, ou seja, para chamar fun\u00e7\u00f5es em seu plug-in em momentos espec\u00edficos e, assim, definir...<\/p>","protected":false},"author":21411,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"footnotes":""},"ht-kb-category":[188],"ht-kb-tag":[],"class_list":["post-8071","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mm-wp-hooks-filters"],"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t