Los filtros son funciones a trav\u00e9s de las cuales WordPress pasa los datos, en ciertos puntos de la ejecuci\u00f3n, justo antes de tomar alguna acci\u00f3n con los datos. MemberMouse define su propio conjunto de filtros que puede utilizar para controlar el flujo de ejecuci\u00f3n en MemberMouse antes de realizar determinadas acciones.<\/p>\n\n\n\n
He aqu\u00ed un ejemplo b\u00e1sico:<\/p>\n\n\n\n
function customContentProtection($data)\n{\n devuelve true;\n}\nadd_filter('mm_bypass_content_protection', 'customContentProtection');\n<\/code><\/pre>\n\n\n\n<\/div>\n\n\n\nEn este ejemplo, utilizamos la funci\u00f3n add_filter()<\/em><\/a> para indicar que el customContentProtection()<\/em> cuando MemberMouse aplique el m\u00e9todo mm_bypass_content_protection<\/em> filtro. <\/p>\n\n\n\nPara obtener m\u00e1s informaci\u00f3n sobre c\u00f3mo trabajar con la Action API de WordPress leer este art\u00edculo<\/a>.<\/p>\n\n\n\nReferencia del filtro MemberMouse<\/h2>\n\n\n\n
A continuaci\u00f3n se muestra una lista de todos los filtros MemberMouse, una descripci\u00f3n de cu\u00e1ndo se ejecutan e informaci\u00f3n sobre los datos que se pasar\u00e1n a cualquier funci\u00f3n enganchada al filtro.<\/p>\n\n\n\n
<\/div>\n\n\n\nIntervalo de exploraci\u00f3n de facturaci\u00f3n<\/h3>\n\n\n\n
mm_billing_scan_interval<\/strong><\/p>\n\n\n\nMemberMouse 3.0+<\/mark><\/em><\/p>\n\n\n\nMemberMouse ejecuta peri\u00f3dicamente un WP-Cron<\/a> tarea que busca suscripciones pendientes de refacturaci\u00f3n y las pone en cola para que las procese el sistema de facturaci\u00f3n local. Por defecto, los escaneos se realizan cada quince minutos. Este filtro le permite modificar el intervalo entre exploraciones, lo que puede ser \u00fatil para optimizar el rendimiento de su sitio. <\/p>\n\n\n\nEl plugin pasa un \u00fanico argumento $scanInterval<\/code> a su funci\u00f3n, un n\u00famero entero que representa el n\u00famero predeterminado de minutos entre exploraciones. Su funci\u00f3n debe devolver un n\u00famero entero que represente los minutos deseados entre exploraciones. Por ejemplo, lo siguiente buscar\u00e1 suscripciones que est\u00e9n listas para facturar una vez cada cinco minutos:<\/p>\n\n\n\nfunction customBillingScanInterval($scanInterval)\n{\n return 5;\n}\nadd_filter(\"mm_billing_scan_interval\", \"customBillingScanInterval\", 10, 2);\n<\/code><\/pre>\n\n\n\n<\/div>\n\n\n\n
\n\n\n\nSuscripci\u00f3n Intervalo de reclamaci\u00f3n<\/h3>\n\n\n\n
mm_billing_subscription_dunning_interval<\/strong><\/p>\n\n\n\nMemberMouse 3.0+<\/mark><\/em><\/p>\n\n\n\nSi una suscripci\u00f3n no se factura en la fecha prevista, MemberMouse realiza tres intentos adicionales para cobrar el pago. Este filtro permite controlar el intervalo entre los intentos.<\/p>\n\n\n\n
MemberMouse pasa dos argumentos a su funci\u00f3n. El primero es un entero $failureInterval<\/code> que representa el n\u00famero predeterminado de d\u00edas antes de que se realice el siguiente intento. El segundo es un n\u00famero entero $failureState<\/code> que representa el estado concreto de facturaci\u00f3n fallida. Actualmente existen tres estados de fallo: 2, 3, 4 que representan el segundo, tercer y \u00faltimo intento de cobro, respectivamente.<\/p>\n\n\n\nSu funci\u00f3n debe devolver un n\u00famero entero que represente el n\u00famero de d\u00edas que deben transcurrir antes del siguiente intento. He aqu\u00ed un ejemplo que reproduce los intervalos de reclamaci\u00f3n por defecto:<\/p>\n\n\n\n
function customDunningInterval($failureInterval, $failureState)\n{\n switch ($failureState)\n {\n caso 2:\n return 2; \/\/ Primer reintento, dos d\u00edas despu\u00e9s del fallo de facturaci\u00f3n inicial\n \n caso 3: return 3\n return 3; \/\/ Segundo reintento, tres d\u00edas despu\u00e9s del primer reintento\n \n caso 4: return 2\n return 2; \/\/ Tercer reintento, dos d\u00edas despu\u00e9s del segundo reintento\n \n por defecto:\n return $failureInterval;\n }\n}\nadd_filter(\"mm_billing_subscription_dunning_interval\", \"customDunningInterval\", 10, 2);<\/code><\/pre>\n\n\n\nPara personalizar los intervalos de reclamaci\u00f3n, s\u00f3lo tiene que cambiar los valores devueltos en las tres sentencias case a la duraci\u00f3n deseada en d\u00edas.<\/p>\n\n\n\n
<\/div>\n\n\n\n
\n\n\n\nAcceso en bloque<\/h3>\n\n\n\n
mm_block_access<\/strong><\/p>\n\n\n\nEste filtro se aplica despu\u00e9s de que MemberMouse haya determinado que el visitante actual tiene acceso al contenido, y le permite bloquear selectivamente el acceso al contenido protegido.<\/p>\n\n\n\n
MemberMouse pasa un valor booleano $blockAccess<\/code> a su funci\u00f3n, indicando si bloquear\u00e1 el acceso al contenido por defecto. Tu funci\u00f3n debe devolver un booleano indicando si MemberMouse debe bloquear el acceso al contenido.<\/p>\n\n\n\nPor ejemplo, para bloquear el acceso de todos los miembros a contenidos protegidos:<\/p>\n\n\n\n
function blockMemberAccess($blockAccess)\n{\n devuelve true;\n}\nadd_filter(\"mm_block_access\", \"blockMemberAccess\", 10, 2);\n<\/code><\/pre>\n\n\n\n<\/div>\n\n\n\n
\n\n\n\nEludir la protecci\u00f3n de contenidos<\/h3>\n\n\n\n
mm_bypass_content_protection<\/strong><\/p>\n\n\n\nEste filtro se aplica despu\u00e9s de que MemberMouse haya determinado que el visitante actual no tiene acceso al contenido, y le permite eludir selectivamente la protecci\u00f3n de contenidos. <\/p>\n\n\n\n
MemberMouse pasa un valor booleano $allowAccess<\/code> a su funci\u00f3n, indicando si proporcionar\u00e1 acceso al contenido por defecto. Su funci\u00f3n debe devolver un booleano que indique si MemberMouse debe permitir el acceso al contenido.<\/p>\n\n\n\nPor ejemplo, lo siguiente permitir\u00e1 que cualquier miembro al que se le haya asignado el Colaborador<\/em> acceso a todas las p\u00e1ginas y entradas protegidas: <\/p>\n\n\n\nfunction allowAccessForContributors($allowAccess)\n{\n if (current_user_can(\"contributor\"))\n {\n return true;\n }\n else\n {\n return $allowAccess;\n }\n}\nadd_filter(\"mm_bypass_content_protection\", \"allowAccessForContributors\", 10, 2);\n<\/code><\/pre>\n\n\n\nTenga en cuenta que, aunque este filtro le permitir\u00e1 acceder a p\u00e1ginas y entradas que de otro modo ser\u00edan inaccesibles, no afecta al an\u00e1lisis sint\u00e1ctico de las SmartTags de decisi\u00f3n.<\/p>\n\n\n\n
<\/div>\n\n\n\n
\n\n\n\nRedirecci\u00f3n de inicio de sesi\u00f3n<\/h3>\n\n\n\n
mm_login_redirect<\/strong><\/p>\n\n\n\nEste filtro se aplica antes de que MemberMouse ejecute su comportamiento predeterminado de redirecci\u00f3n de inicio de sesi\u00f3n, que es configurado en los ajustes de la p\u00e1gina de inicio de los miembros<\/a>. Devuelve una URL para indicar que MemberMouse debe redirigir al usuario a esa URL. Devuelve una cadena vac\u00eda para indicar que MemberMouse debe utilizar sus propias reglas internas para determinar a d\u00f3nde se debe enviar al usuario.<\/p>\n\n\n\nEl objeto pasado a su funci\u00f3n contiene la URL a la que MemberMouse redirigir\u00e1 al usuario si no devuelve una URL de anulaci\u00f3n y un objeto de usuario que contiene datos sobre el usuario conectado.
Si el nombre del objeto en su funci\u00f3n es $infoObj<\/code> entonces acceder\u00e1s a los dos elementos de datos de la siguiente manera:<\/p>\n\n\n\n<\/div>\n\n\n\n$infoObj->currentUrl\n$infoObj->user<\/code><\/pre>\n\n\n\n
\n\n\n\n<\/p>\n\n\n\n
Descriptor de declaraci\u00f3n de raya<\/h3>\n\n\n\n
mm_stripe_billing_statement_descriptor<\/strong><\/p>\n\n\n\nCuando MemberMouse inicia una refacturaci\u00f3n, env\u00eda varios datos descriptivos sobre el cargo. El descriptor del extracto es lo que se mostrar\u00e1 al cliente en la factura de su tarjeta de cr\u00e9dito y tambi\u00e9n es visible en Stripe. Este filtro le permite personalizar el descriptor del extracto para las transacciones de refacturaci\u00f3n.<\/p>\n\n\n\n
Tenga en cuenta que la longitud total m\u00e1xima del descriptor de extracto es de 22 caracteres, y que el env\u00edo de una cadena m\u00e1s larga har\u00e1 que no se procese el pago. Adem\u00e1s, los datos que env\u00ede pueden estar truncados. Stripe crea en \u00faltima instancia un \"descriptor de extracto calculado\" a\u00f1adiendo el descriptor que usted env\u00eda al descriptor abreviado especificado en Configuraci\u00f3n p\u00fablica del panel de Stripe<\/a>pero la longitud m\u00e1xima de esta cadena calculada tambi\u00e9n es de 22 caracteres, y todo lo que supere esta longitud ser\u00e1 descartado. <\/p>\n\n\n\nPara calcular la longitud m\u00e1xima del contenido que se mostrar\u00e1, utilice la siguiente f\u00f3rmula:<\/p>\n\n\n\n
longitud m\u00e1xima mostrada = 22 - (longitud del descriptor acortado + 2)<\/em><\/p>\n\n\n\nMemberMouse pasar\u00e1 dos par\u00e1metros a su funci\u00f3n. El primero es Descriptor $<\/code> que es una cadena que contiene la informaci\u00f3n que MemberMouse enviar\u00e1 a menos que se modifique. El segundo es 1TP4Pedido<\/code> que es un objeto de clase est\u00e1ndar que contiene datos de orden MemberMouse, que puede utilizar en la construcci\u00f3n del descriptor de sentencia. <\/p>\n\n\n\nHe aqu\u00ed un ejemplo: <\/p>\n\n\n\n
add_filter(\"mm_stripe_billing_statement_descriptor\", function($descriptor, $order)\n{\n\n $descriptor = \"Pedido #: \" . $order->orderNumber;\n $maxLengthDescriptor = substr($descriptor,0,22);\n return $maxLengthDescriptor;\n}, 1, 2);<\/code><\/pre>\n\n\n\nSi su Descriptor abreviado es ABC<\/em> sus clientes deber\u00edan ver algo parecido en los extractos de sus tarjetas de cr\u00e9dito:<\/p>\n\n\n\nABC* Pedido #: 10043<\/em><\/p>\n\n\n\nEste filtro s\u00f3lo puede actuar sobre las refacturaciones, no sobre los pagos iniciales. <\/p>\n\n\n\n
<\/div>\n\n\n\n
\n\n\n\nDescripci\u00f3n de Stripe PaymentIntent<\/h3>\n\n\n\n
mm_stripe_paymentintent_description<\/strong><\/p>\n\n\n\nOtro dato que se env\u00eda a Stripe con las refacturaciones es la Descripci\u00f3n, que este filtro le permite personalizar. La Descripci\u00f3n es una de las columnas que se muestran al seleccionar Pagos<\/em> en el Panel de Stripe. La longitud m\u00e1xima de este campo es de 350 caracteres.<\/p>\n\n\n\nMemberMouse pasar\u00e1 dos par\u00e1metros a su funci\u00f3n. El primero es $descripci\u00f3n<\/code> que es una cadena que contiene la informaci\u00f3n que MemberMouse enviar\u00e1 a menos que se modifique. El segundo es 1TP4Pedido<\/code> que es un objeto de clase est\u00e1ndar que contiene datos de la orden MemberMouse, que puede utilizar en la construcci\u00f3n de la Descripci\u00f3n. <\/p>\n\n\n\nPor ejemplo, para establecer este campo en Pedido# 1234, Art\u00edculo: Miembro Digital <\/em>puede utilizar la siguiente funci\u00f3n en su plugin:<\/p>\n\n\n\nadd_filter('mm_stripe_paymentintent_description', function($description, $order)\n{\n $description = \"Pedido # \" . $order->n\u00fameroDePedido;\n if (isset($order->orderProducts) && is_array($order->orderProducts))\n {\n $description .= \", Art\u00edculo: \" . array_pop($order->orderProducts)->description;\n }\n return $description;\n}, 1, 2);<\/code><\/pre>\n\n\n\nEste filtro s\u00f3lo puede actuar sobre las refacturaciones, no sobre los pagos iniciales. Para ver todos los datos a los que es posible acceder en el filtro 1TP4Pedido<\/code> ver este objeto\u00a0ejemplo de objeto de pedido<\/a>.<\/p>\n\n\n\n<\/div>\n\n\n\n
\n\n\n\nFiltros por defecto de MemberMouse<\/h2>\n\n\n\n
Se trata de filtros incluidos en el plugin que pueden anularse en el c\u00f3digo personalizado utilizando eliminar_filtro<\/a> para implementar sus propios filtros relacionados.<\/p>\n\n\n\n<\/div>\n\n\n\nValidador de contrase\u00f1as<\/h3>\n\n\n\n
mm_password_strength_validator<\/strong><\/p>\n\n\n\nA partir de la versi\u00f3n 2.2.9, MemberMouse permite a\u00f1adir un filtro de validaci\u00f3n de contrase\u00f1as personalizado. Esto permite evaluar la contrase\u00f1a en funci\u00f3n de requisitos personalizados. De forma predeterminada, MemberMouse adjunta un filtro b\u00e1sico que comprueba que la contrase\u00f1a tenga al menos 8 caracteres. Los desarrolladores tienen la opci\u00f3n de a\u00f1adir un filtro adicional que se aplicar\u00e1 junto con el predeterminado, o eliminar el predeterminado y sustituirlo por un filtro personalizado.<\/p>\n\n\n\n