Uso de la interfaz PHP

MemberMouse le ofrece una amplia gama de SmartTags™ (etiquetas inteligentes) que puede utilizar para crear una experiencia dinámica para sus afiliados. Hay SmartTags™ que muestran el nombre, la dirección de correo electrónico y otra información del usuario actual. Hay etiquetas que puedes utilizar para permitir a los usuarios gestionar sus suscripciones, otras para cambiar el contenido en función de los derechos de acceso del usuario actual, ¡y mucho más!

Todo esto es muy útil cuando trabajas con el editor de contenidos de WordPress, pero ¿qué pasa si quieres poder hacer todo esto con un script PHP personalizado?

Aquí es donde entra en juego la interfaz PHP.

NOTA: MemberMouse actualmente requiere PHP 7. Recomendamos la última versión de la rama PHP 7. Consulte nuestra Requisitos de sistema y alojamiento para obtener la información más actualizada.

Requisitos de la interfaz PHP

Las funciones de interfaz PHP requieren acceso a las bibliotecas MemberMouse para funcionar. Cuando utiliza las funciones de interfaz PHP dentro de una plantilla de WordPress, estas bibliotecas se cargan automáticamente. Sin embargo, si desea utilizarlas dentro de un script PHP independiente, tendrá que cargar manualmente las bibliotecas MemberMouse añadiendo los siguientes includes al principio de su archivo:

require_once("wp-load.php");
require_once("wp-content/plugins/membermouse/includes/mm-constants.php");
require_once("wp-content/plugins/membermouse/includes/init.php");

Si su script se encuentra en el directorio raíz de WordPress, entonces puede utilizar los includes exactamente como se presentan arriba. Si el script se encuentra en otro directorio, deberá actualizar las rutas de los archivos.

Traducción de SmartTags™ en funciones PHP

Con la interfaz PHP de MemberMouse puede utilizar las SmartTags™ de MemberMouse directamente en un script PHP personalizado. Puede utilizar cualquier plugin de WordPress para ejecutar PHP (es decir, PHP Exec) para utilizar las funciones de la interfaz PHP directamente en el editor de contenido de WordPress. Todas las SmartTags™ son compatibles con la interfaz PHP, excepto MM_Form... y MM_Error... SmartTags™.

Cuando se utilizan SmartTags™ dentro del editor de contenidos de WordPress se utiliza la siguiente sintaxis:

[MM_Member_Data name='email']
[MM_Member_Decision membershipId='2|3']...[/MM_Member_Decision]

Las SmartTags™ se transforman en su equivalente de interfaz PHP tomando el nombre de la SmartTag™, poniéndolo todo en minúsculas y añadiendo paréntesis para convertirlo en una función PHP válida.

Así, por ejemplo, [ MM_Order_Data ] se convierte en mm_order_data ( ). 

Los atributos se pasan a las funciones de la interfaz PHP como una matriz asociativa.

He aquí un par de ejemplos:

mm_member_data(array("nombre"=>"email"))
mm_member_decision(array("isMember"=>"true", "membershipId"=>"2|3"))

La función Interfaz PHP acepta todos los mismos atributos que la propia SmartTag™. Consulte la Documentación SmartTag para obtener una lista de atributos por SmartTag™.

Valores de retorno

mm_..._data() devuelven una cadena con los datos solicitados.

mm_..._enlace() devuelven una cadena que contiene una URL o una función javascript que debe colocarse dentro de un archivo <a> etiqueta o <button> para convertirlo en un enlace funcional.

mm_..._decisión() las funciones devuelven verdadero o falso en función de los atributos pasados a la función y del contexto en el que se ejecuta.

Ejemplos

Para ver ejemplos de cómo se puede utilizar cada SmartTag™ en PHP, descargar el script de ejemplo.