Usando a interface PHP

O MemberMouse oferece a você uma ampla gama de SmartTags™ que você pode usar para criar uma experiência dinâmica para seus membros. Há SmartTags™ que exibem o nome do membro atual, o endereço de e-mail e outras informações. Há tags que você pode usar para permitir que os membros gerenciem suas assinaturas, outras para alterar o conteúdo com base nos direitos de acesso do membro atual e muito mais!

Tudo isso é muito útil quando você está trabalhando no editor de conteúdo do WordPress, mas e se você quiser fazer tudo isso em um script PHP personalizado?

É aqui que entra a interface PHP.

OBSERVAÇÃO: O MemberMouse atualmente requer PHP 7. Recomendamos a versão mais recente do ramo do PHP 7. Consulte nosso Requisitos de sistema e hospedagem para obter as informações mais atualizadas.

Requisitos da interface PHP

As funções da interface PHP requerem acesso às bibliotecas do MemberMouse para funcionar. Quando você usa as funções de interface PHP em um modelo do WordPress, essas bibliotecas são carregadas automaticamente. No entanto, se quiser usá-las em um script PHP autônomo, será necessário carregar manualmente as bibliotecas do MemberMouse adicionando as seguintes inclusões à parte superior do arquivo:

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

Se o seu script estiver localizado no diretório raiz do WordPress, você poderá usar os includes exatamente como foram apresentados acima. Se o seu script estiver localizado em outro diretório, será necessário atualizar os caminhos dos arquivos adequadamente.

Traduzindo SmartTags™ em funções PHP

Com a interface PHP do MemberMouse, você pode utilizar o MemberMouse SmartTags™ diretamente em um script PHP personalizado. Você pode usar qualquer plug-in do WordPress para execução de PHP (ou seja, PHP Exec) para usar as funções da interface PHP diretamente no editor de conteúdo do WordPress. Todas as SmartTags™ são suportadas pela interface PHP, com exceção das SmartTags™ MM_Form... e MM_Error....

Ao usar SmartTags™ no editor de conteúdo do WordPress, é usada a seguinte sintaxe:

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

As SmartTags™ são transformadas em seu equivalente na interface PHP, pegando o nome da SmartTag™, colocando-o em letras minúsculas e adicionando parênteses para torná-lo uma função PHP válida.

Assim, por exemplo, [ MM_Order_Data ] torna-se mm_order_data ( ). 

Você passa atributos para as funções da interface PHP como uma matriz associativa.

Aqui estão alguns exemplos:

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

A função Interface PHP aceita todos os mesmos atributos que o próprio SmartTag™. Consulte a seção Documentação do SmartTag para obter uma lista de atributos do SmartTag™.

Valores de retorno

mm_..._data() retornam uma cadeia de caracteres que contém os dados solicitados.

mm_..._link() retornam uma string contendo um URL ou uma função javascript que deve ser colocada em um <a> tag ou  para torná-lo um link funcional.

mm_..._decision() retorno de funções verdadeiro ou falso com base nos atributos passados para a função e no contexto em que ela é executada.

Exemplos

Para ver exemplos de como cada SmartTag™ pode ser usado no PHP, Faça o download do script de amostra.