{"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\/es\/docs\/membermouse-wordpress-hooks\/","title":{"rendered":"Ganchos para WordPress de MemberMouse"},"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    \/\/ realizar acci\u00f3n\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 leer este art\u00edculo<\/a>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Categor\u00edas de ganchos de WordPress<\/h5>\n\n\n\n
MemberMouse Referencia de acci\u00f3n<\/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
Acci\u00f3n<\/strong><\/td>Descripci\u00f3n<\/strong><\/td>Datos transmitidos<\/strong><\/td><\/tr>
mm_member_add<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se a\u00f1ade un nuevo miembro a MemberMouse.<\/td>datos de los miembros<\/a><\/td><\/tr>
mm_member_membership_change<\/code><\/td>This action is executed when a member’s membership level is changed.<\/td>datos de los miembros<\/a><\/td><\/tr>
mm_member_status_change<\/code><\/td>This action is executed when the status of a member’s account changes.<\/td>datos de los miembros<\/a><\/td><\/tr>
mm_member_account_update<\/code><\/td>This action is executed when certain data on a member’s account is updated.
Esto incluye: nombre, apellidos, direcci\u00f3n de correo electr\u00f3nico, nombre de usuario, n\u00famero de tel\u00e9fono,
notas, direcci\u00f3n de facturaci\u00f3n, direcci\u00f3n de env\u00edo, m\u00e9todo de c\u00e1lculo de d\u00edas como afiliado y datos de campos personalizados.<\/td>		datos de los miembros<\/a><\/td><\/tr>
mm_member_delete<\/code><\/td>This action is executed when a member’s account is deleted.<\/td>datos de los miembros<\/a><\/td><\/tr>
mm_bundles_add<\/code><\/td>This action is executed when a bundle is added to a member’s account.<\/td>datos de los miembros<\/a>, datos del paquete<\/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>datos de los miembros<\/a>, datos del paquete<\/a><\/td><\/tr>
mm_producto_compra<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se env\u00eda un pedido, antes de su validaci\u00f3n y pago.<\/td>datos de los miembros<\/a>, datos del pedido<\/a><\/td><\/tr>
mm_compra_completa<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se completa una compra. Est\u00e1 disponible en MemberMouse 3.0.6 y versiones posteriores.<\/td>datos de los miembros<\/a>, datos del pedido<\/a><\/td><\/tr>
mm_pago_recibido<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se recibe un pago.<\/td>datos de los miembros<\/a>, datos del pedido<\/a><\/td><\/tr>
mm_payment_rebill<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se recibe un pago de refacturaci\u00f3n.<\/td>datos de los miembros<\/a>, datos del pedido<\/a><\/td><\/tr>
mm_payment_rebill_declined<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se rechaza un pago de refacturaci\u00f3n.<\/td>datos de los miembros<\/a>, datos del pedido<\/a><\/td><\/tr>
mm_reembolso_emitido<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se emite una devoluci\u00f3n.<\/td>datos de los miembros<\/a>, datos del pedido<\/a><\/td><\/tr>
mm_commission_initial<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se debe realizar el seguimiento de una comisi\u00f3n de afiliaci\u00f3n inicial.<\/td>datos de afiliaci\u00f3n<\/a><\/td><\/tr>
mm_commission_rebill<\/code><\/td>Esta acci\u00f3n se ejecuta cuando se debe realizar el seguimiento de una comisi\u00f3n de afiliado refacturada.<\/td>datos de afiliaci\u00f3n<\/a><\/td><\/tr>
mm_commission_cancel<\/code><\/td>Esta acci\u00f3n se ejecuta cuando una comisi\u00f3n de afiliado debe ser cancelada.<\/td>datos de afiliaci\u00f3n<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Atributos de datos por tipo<\/h5>\n\n\n\n
Todos los datos se pasan a las funciones como una matriz asociativa y se puede acceder a ellos de la siguiente manera: <\/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
En las secciones siguientes se enumeran los atributos de datos disponibles para cada tipo.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Datos de los miembros<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descripci\u00f3n<\/strong><\/td><\/tr>
member_id<\/code><\/td>El ID asignado al miembro por MemberMouse.<\/td><\/tr>
registrado<\/code><\/td>La fecha en que el afiliado se registr\u00f3 en el formato AAAA-MM-DD HH:MM:SS.<\/td><\/tr>
last_logged_in<\/code><\/td>La fecha en que el miembro se conect\u00f3 por \u00faltima vez en el formato AAAA-MM-DD HH:MM:SS.<\/td><\/tr>
\u00faltima_actualizaci\u00f3n<\/code><\/td>The date the member’s account was last updated in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr>
d\u00edas_como_miembro<\/code><\/td>El n\u00famero de d\u00edas que el miembro ha sido miembro.<\/td><\/tr>
estado<\/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>
nombre_estado<\/code><\/td>The status of the member’s account as a string (i.e. activo<\/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>
nivel_de_afiliaci\u00f3n<\/code><\/td>The ID of the membership level associated with the member’s account.<\/td><\/tr>
nombre_nivel_socio<\/code><\/td>The name of the membership level associated with the member’s account.<\/td><\/tr>
nombre<\/code><\/td>The member’s first name.<\/td><\/tr>
apellido<\/code><\/td>The member’s last name.<\/td><\/tr>
nombre de usuario<\/code><\/td>The member’s username.<\/td><\/tr>
correo electr\u00f3nico<\/code><\/td>The member’s email address.<\/td><\/tr>
tel\u00e9fono<\/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>
direcci\u00f3n_facturaci\u00f3n<\/code><\/td>The member’s billing address.<\/td><\/tr>
ciudad_facturaci\u00f3n<\/code><\/td>The member’s billing city.<\/td><\/tr>
estado_de_facturaci\u00f3n<\/code><\/td>The member’s billing state.<\/td><\/tr>
c\u00f3digo_zip_facturaci\u00f3n<\/code><\/td>The member’s billing zip code.<\/td><\/tr>
pa\u00eds_de_facturaci\u00f3n<\/code><\/td>The member’s billing country.<\/td><\/tr>
direcci\u00f3n_de_env\u00edo<\/code><\/td>The member’s shipping address.<\/td><\/tr>
ciudad_de_env\u00edo<\/code><\/td>The member’s shipping city.<\/td><\/tr>
estado_de_env\u00edo<\/code><\/td>The member’s shipping state.<\/td><\/tr>
c\u00f3digo_zip_de_env\u00edo<\/code><\/td>The member’s shipping zip code.<\/td><\/tr>
pa\u00eds_de_env\u00edo<\/code><\/td>The member’s shipping country.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Datos del paquete<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descripci\u00f3n<\/strong><\/td><\/tr>
bundle_id<\/code><\/td>ID del paquete.<\/td><\/tr>
nombre_paquete<\/code><\/td>El nombre del paquete.<\/td><\/tr>
d\u00edas_con_paquete<\/code><\/td>The number of days the bundle has been active on the member’s account.<\/td><\/tr>
bundle_status<\/code><\/td>Estado del paquete: 1 = activo, 2 = cancelado, 3 = bloqueado, 4 = en pausa, 5 = vencido, 6 = pendiente de activaci\u00f3n, 7 = error, 8 = vencido, 9 = pendiente de cancelaci\u00f3n.<\/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>
nombre_estado_paquete<\/code><\/td>El estado del paquete como una cadena (es decir. activo<\/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
Datos del pedido<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descripci\u00f3n<\/strong><\/td><\/tr>
n\u00famero_pedido<\/code><\/td>El n\u00famero de referencia asignado al pedido por 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_pedido<\/code><\/td>El total del pedido que es igual a (subtotal - descuento) + gastos de env\u00edo.<\/td><\/tr>
subtotal_pedido<\/code><\/td>El subtotal del pedido.<\/td><\/tr>
descuento_pedido<\/code><\/td>El descuento aplicado al pedido.<\/td><\/tr>
pedido_env\u00edo<\/code><\/td>Gastos de env\u00edo aplicados al pedido.<\/td><\/tr>
m\u00e9todo_env\u00edo_pedido<\/code><\/td>El nombre del m\u00e9todo de env\u00edo elegido por el cliente al realizar el pago.<\/td><\/tr>
direcci\u00f3n_facturaci\u00f3n_pedido<\/code><\/td>La direcci\u00f3n de facturaci\u00f3n asociada al pedido.<\/td><\/tr>
order_billing_city<\/code><\/td>La ciudad de facturaci\u00f3n asociada al pedido.<\/td><\/tr>
order_billing_state<\/code><\/td>El estado de facturaci\u00f3n asociado al pedido.<\/td><\/tr>
order_billing_zip_code<\/code><\/td>El c\u00f3digo postal de facturaci\u00f3n asociado al pedido.<\/td><\/tr>
order_billing_country<\/code><\/td>El pa\u00eds de facturaci\u00f3n asociado al pedido.<\/td><\/tr>
direcci\u00f3n_env\u00edo_pedido<\/code><\/td>La direcci\u00f3n de env\u00edo asociada al pedido.<\/td><\/tr>
ciudad_env\u00edo_pedido<\/code><\/td>La ciudad de env\u00edo asociada al pedido.<\/td><\/tr>
estado_env\u00edo_pedido<\/code><\/td>El estado de env\u00edo asociado al pedido.<\/td><\/tr>
c\u00f3digo_zip_env\u00edo_pedido<\/code><\/td>El c\u00f3digo postal de env\u00edo asociado al pedido.<\/td><\/tr>
pa\u00eds_env\u00edo_pedido<\/code><\/td>El pa\u00eds de env\u00edo asociado al pedido.<\/td><\/tr>
productos_pedidos<\/code><\/td>Matriz de productos asociados al pedido. Consulte el Datos del producto<\/em> tabla siguiente para conocer los par\u00e1metros disponibles para cada producto.<\/td><\/tr>
pedir_cupones<\/code><\/td>Una matriz de cupones asociados al pedido. Consulte el Datos del cup\u00f3n<\/em> tabla siguiente para conocer los par\u00e1metros disponibles para cada cup\u00f3n.<\/td><\/tr>
precios_pedidos<\/code><\/td>Matriz de prorrateos asociados a la orden. V\u00e9ase el Datos de prorrateo<\/em> tabla siguiente para conocer los par\u00e1metros disponibles para cada elemento de prorrateo.<\/td><\/tr>
ID_afiliado_pedido<\/code><\/td>El ID de afiliado asociado a la orden.<\/td><\/tr>
order_subaffiliate_id<\/code><\/td>El ID de subfilial asociado a la orden.<\/td><\/tr>
direcci\u00f3n_ip_pedido<\/code><\/td>La direcci\u00f3n IP asociada a la orden.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Datos de afiliaci\u00f3n<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Atributo<\/strong><\/td>Descripci\u00f3n<\/strong><\/td><\/tr>
ID_afiliado_pedido<\/code><\/td>El ID de afiliado asociado a la orden.<\/td><\/tr>
order_subaffiliate_id<\/code><\/td>El ID de subfilial asociado a la orden.<\/td><\/tr>
member_id<\/code><\/td>El ID asignado al miembro por MemberMouse.<\/td><\/tr>
n\u00famero_pedido<\/code><\/td>El n\u00famero \u00fanico asociado al pedido concatenado con el ID de transacci\u00f3n asociado al pago (es decir, 1456-3462). Esto garantiza que el n\u00famero de pedido proporcionado aqu\u00ed sea \u00fanico en todas las transacciones de refacturaci\u00f3n asociadas al pedido.<\/td><\/tr>
total_pedido<\/code><\/td>El total del pedido disponible para comisiones, que es igual al total del pedido menos los descuentos y los gastos de env\u00edo.<\/td><\/tr>
direcci\u00f3n_ip_pedido<\/code><\/td>La direcci\u00f3n IP asociada a la orden.<\/td><\/tr>
productos_pedidos<\/code><\/td>Matriz de productos asociados al pedido. Consulte el Datos del producto<\/em> tabla siguiente para conocer los par\u00e1metros disponibles para cada producto.<\/td><\/tr>
pedir_cupones<\/code><\/td>Una matriz de cupones asociados al pedido. Consulte el Datos del cup\u00f3n<\/em> tabla siguiente para conocer los par\u00e1metros disponibles para cada cup\u00f3n.<\/td><\/tr>
precios_pedidos<\/code><\/td>Matriz de prorrateos asociados a la orden. V\u00e9ase el Datos de prorrateo<\/em> tabla siguiente para conocer los par\u00e1metros disponibles para cada elemento de prorrateo.<\/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
Datos del producto<\/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>Descripci\u00f3n<\/strong><\/td><\/tr>
id<\/code><\/td>El ID del producto.<\/td><\/tr>
nombre<\/code><\/td>El nombre del producto.<\/td><\/tr>
sku<\/code><\/td>La SKU del producto.<\/td><\/tr>
importe<\/code><\/td>El importe pagado por cada unidad del producto.<\/td><\/tr>
cantidad<\/code><\/td>El n\u00famero de este producto comprado.<\/td><\/tr>
total<\/code><\/td>El precio total pagado equivale al importe * cantidad.<\/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>
importe_recurrente<\/code><\/td>El importe pagado en cada periodo de facturaci\u00f3n.<\/td><\/tr>
per\u00edodo_facturaci\u00f3n<\/code><\/td>Un n\u00famero entero que representa la duraci\u00f3n del periodo de facturaci\u00f3n. Para determinar la duraci\u00f3n completa del periodo de facturaci\u00f3n, comb\u00ednelo con rebill_frequency (es decir, 1 mes, 30 d\u00edas, 2 semanas, etc.).<\/td><\/tr>
frecuencia_de_facturaci\u00f3n<\/code><\/td>Cadena que indica la unidad de medida utilizada para el periodo de facturaci\u00f3n. Los valores posibles son d\u00edas, semanas, meses o a\u00f1os.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Datos del cup\u00f3n<\/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[\"cupones_pedido\"]);<\/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>Descripci\u00f3n<\/strong><\/td><\/tr>
id<\/code><\/td>ID del cup\u00f3n.<\/td><\/tr>
nombre<\/code><\/td>El nombre del cup\u00f3n.<\/td><\/tr>
c\u00f3digo<\/code><\/td>El c\u00f3digo del cup\u00f3n.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Datos de prorrateo<\/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>Descripci\u00f3n<\/strong><\/td><\/tr>
importe<\/code><\/td>Importe del prorrateo.<\/td><\/tr>
descripci\u00f3n<\/code><\/td>La descripci\u00f3n asociada a la compra.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>","protected":false},"excerpt":{"rendered":"
Los ganchos son proporcionados por WordPress para permitir que su plugin se 'enganche' al resto de WordPress; es decir, para llamar a funciones de su plugin en momentos espec\u00edficos, y...<\/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