Usando a interface PHP

O MemberMouse oferece a você uma ampla gama de SmartTags™ you can use to create a dynamic experience for your members. There are SmartTags™ that display the current member's name, email address, and other information. There are tags you can use to allow members to manage their subscriptions, others to change content based on the current member's access rights, and a lot more!

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: MemberMouse currently requires a minimum of PHP 7.4. We recommend the latest version of the PHP branch. Please see our 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.

Translating SmartTags™ in PHP Functions

With MemberMouse's PHP Interface you can utilize MemberMouse SmartTags™ right within a custom PHP script. You can use any WordPress plugin for executing PHP (i.e. PHP Exec) to use the PHP Interface functions right within the WordPress content editor. All SmartTags™ are supported through the PHP Interface with the exception of MM_Form… and MM_Error… SmartTags™.

When using SmartTags™ within the WordPress content editor the following syntax is used:

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

SmartTags™ are transformed into their PHP interface equivalent by taking the SmartTag™ name, making it all lowercase, and adding parenthesis to make it a valid PHP function.

So for example, [ MM_Order_Data ] becomes 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"))

The PHP Interface function accepts all of the same attributes as the SmartTag™ itself. Refer to the SmartTag™ documentation for a list of attributes by 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

To see examples of how each SmartTag™ can be used in PHP, Faça o download do script de amostra.