O que é um shortcode?
Os códigos curtos são pequenos espaços reservados que podem ser inseridos em praticamente qualquer lugar do conteúdo de sua página e post do WordPress. Quando a página é visualizada por um visitante, esses marcadores de posição são processados e substituídos por algum conteúdo gerado dinamicamente.
Shortcodes disponíveis atualmente
- Shortcodes relacionados à conta
- Shortcodes relacionados à assinatura
- Shortcodes relacionados a login
- Shortcodes relacionados a acesso não autorizado
- Shortcodes relacionados ao registro
Shortcodes relacionados à conta
Mostrar um link para a página da conta
[mepr_account_link]
Mostra um link para a página Account (Conta) no MemberPress. Pode ser usado em qualquer página ou postagem.
Exibir o formulário de informações da conta
[mepr_account_form]
Mostra o formulário de informações da conta do usuário. Normalmente, isso não é usado, a menos que você queira mostrar as informações da conta em algum lugar além da página Account (Conta) do MemberPress que existe por padrão. Isso também pode ser útil para pessoas que usam o WPML e criam páginas de conta separadas para cada idioma.
Exibir informações da conta do usuário
[mepr_account_info field="slug"]
Esse shortcode mostrará o primeiro nome do usuário conectado no momento, com base no "slug":
| Lesma | Resultado |
| nome_completo | John Doe |
| nome_completo_último_primeiro | Doe, John |
| primeiro_nome_último_inicial | John D. |
| sobrenome_primeiro_inicial | Doe, J. |
| primeiro_nome | João |
| sobrenome | Doe |
| user_login | johndoe |
| email_do_usuário | johndoe@email.com |
| apelido | johndoe |
| descrição | (também conhecido como Informações biográficas) |
| mepr-address-one | 123 Fake Street |
| mepr-endereço-dois | Apt. 123 |
| mepr-address-city | Vidor |
| mepr-address-state | Texas |
| mepr-address-zip | 77662 |
| mepr-address-country | EUA |
| mepr_user_message | A "Mensagem personalizada da conta MemberPress" que você definiu para o membro em seu perfil |
| usuário_registrado | A data/hora em que o usuário entrou no seu site pela primeira vez |
| nome_de_exibição | johndoe |
| ID | A ID exclusiva atribuída ao usuário no momento do registro. Deve ser inserido como ID, não como id. |
| "Sua lesma personalizada" | Qualquer um dos slugs do campo de conta personalizado nas configurações do MemberPress. |
Por exemplo, talvez você queira mostrar o usuário conectado o primeiro nome do usuário em algum lugar da página. Você usaria o seguinte shortcode:
[mepr_account_info field="first_name"]
Portanto, se um usuário chamado John Doe visita a página, ela mostrará João no local onde o shortcode foi colocado.
Além disso, lembre-se de que o MemberPress campo personalizado Os dados podem ser coletados somente nas páginas de registro de conta ou associação. O shortcode adicionado às suas páginas personalizadas não exibirá nenhum campo personalizado adicionado aos formulários.
Exibir um link para arquivos carregados pelo usuário
[mepr_user_file slug="mepr_slug" user_id=""]Texto do link[/mepr_user_file]
Esse shortcode exibe um link para visualizar ou fazer download de um arquivo carregado por um usuário.
Instruções de configuração:
- Substituir mepr_slug com o nome de seu campo personalizado de MemberPress > Configurações > Guia Campos.
- Se você não adicionar um user_id ele mostra o arquivo para o usuário conectado.
- Se o user_id é fornecido, o shortcode mostra o arquivo para esse usuário.
- O texto entre as tags é o texto do link para o arquivo.
Não é necessário incluir a tag de fechamento. Se você não a incluir, o link será exibido normalmente.
Shortcodes relacionados à assinatura
Exibir uma lista de assinaturas
Exibe uma lista das assinaturas ativas e inativas do usuário atual.
[mepr_list_subscriptions status="all"]
Desde a versão MemberPress 1.9.28, foi introduzido um atributo de status opcional.
Opções de status:
- status="all" ou nenhum atributo de status - exibe todas as assinaturas ativas e inativas;
- status="active" - exibe apenas as assinaturas ativas;
- status="expired" - exibe apenas as assinaturas inativas.
Você pode definir o status como "todos" ou removê-lo desta forma:
[mepr_list_subscriptions]
Como você pode ver acima, ele exibirá as assinaturas ativas e inativas atuais padrão.
[mepr_list_subscriptions status="active"]
Quando você define o status como "ativo"você verá as assinaturas ativas do usuário atual.
[mepr_list_subscriptions status="expired"]
Você também pode exibir as assinaturas inativas do usuário atual usando o status "expired" (expirado).
Opções de classificação:
A lista de assinaturas pode ser classificada por data:
[mepr_list_subscriptions orderby="date"]
Ou título:
[mepr_list_subscriptions orderby="title"]
Opções de ordem de classificação:
Elas podem ser classificadas em ordem crescente:
[mepr_list-subscriptions orderby="title" order="asc"]
Ou ordem decrescente:
[mepr_list_subscriptions orderby="title" order="desc"]
Shortcodes relacionados a login
Exibir links de login ou logout
Shortcode do link de login:
[mepr_login_link]
Shortcode do link de logout:
[mepr_logout_link]
Os dois códigos de acesso acima são idênticos. Eles mostram links de login ou logout com base no status de login do usuário atual.
O link de login leva os usuários à página de login, onde eles podem fazer login. O link de logout faz o logout e envia os usuários para o URL de redirecionamento, que pode ser definido em Painel de controle > MemberPress > Configurações > Guia Conta.
Exibir um formulário de login
[mepr_login_form use_redirect="true"]
Esse shortcode mostra um formulário de login em uma página ou publicação. Ele pode ser usado em qualquer lugar. Quando use_redirect = "true“o MemberPress redirecionará o usuário para a configuração de URL de redirecionamento de login localizada no Painel de controle > MemberPress > Configurações > Guia Conta.
Shortcodes relacionados a acesso não autorizado
Exibir a mensagem não autorizada
[mepr_unauthorized_message]
Mostra a mensagem não autorizada onde quer que ela seja colocada. Se você configurou o MemberPress para redirecionar visitantes não autorizados para um URL específicoé recomendável usar esse shortcode nessa página não autorizada.
Mostrar ou ocultar conteúdo com base no status de login
[mepr_show]Conteúdo a ser exibido aqui[/mepr_show]
[mepr_hide]Conteúdo a ser ocultado aqui[/mepr_hide]
Os dois códigos de acesso acima suportam if="X" atributo, onde "X" pode ser "loggedin" ou "logout".
Exemplos:
[mepr_show if="loggedin"Você está conectado, parabéns!
[mepr_show if="loggedout"Agora você está desconectado!
Conforme mostrado acima, os dois códigos de acesso verificam se o usuário está conectado ou desconectado. Esse shortcode não está relacionado às associações que o usuário adquiriu.
Mostrar ou ocultar conteúdo com base no acesso de membro
[mepr_active {parâmetros vão aqui - veja abaixo}]Conteúdo a ser protegido aqui[/mepr_active]
Usado para mostrar ou ocultar conteúdo em páginas de seu site. Esse shortcode suporta os seguintes parâmetros (Os parâmetros marcados com * são obrigatórios. Somente um em vermelho abaixo pode ser aplicado por shortcode):
Parâmetros de shortcode suportados
| Parâmetros do código curto | Descrição |
| regra(s) * | Se você planeja usar uma única ID de regra, defina-a como rule="X". Se você planeja usar várias IDs de regra, defina isso como rules="X, XX, XXX". Em que X = IDs da(s) regra(s). Onde encontrar a ID de uma regra? |
| membro(s) * | Se você planeja usar uma única ID de associação, defina isso como membership="X". Se você planeja usar várias IDs de associação, defina isso como memberships="X, XX, XXX". Onde X's = as IDs dos membros. Onde encontrar a identificação de um membro? |
| se permitido* | Quando definido como ifallowed="show", o conteúdo intermediário é mostrado apenas para membros autorizados. Quando definido como ifallowed="hide" (se permitido="ocultar"), o conteúdo é ocultado dos membros autorizados. |
|
sem autorização | Se você planeja usar um único Membership ID (Onde encontrar a identificação de um membro?) e, em seguida, defina-o como um dos valores possíveis:
ObservaçãoQuando definido como "mensagem" ou "ambos" E a regra tiver uma mensagem não autorizada personalizada, ela exibirá a mensagem não autorizada personalizada em vez da global. |
| unauth_message | Use isso para substituir a mensagem não autorizada padrão. Isso só se aplica quando o atributo "unauth" acima for definido como "message" ou "both". |
Um exemplo de shortcode usando todos os atributos acima pode ser o seguinte:
[mepr_active rules="1, 2, 3" ifallowed="show" unauth="message" unauth_message="Download link hidden, please login or purchase a membership to view."]<a href="#">Faça o download do link aqui</a>[/mepr_active]
Shortcodes relacionados ao registro
Exibir caixas de preços de grupos
[mepr_group_price_boxes group_id="123"]
Esse shortcode é útil se você quiser colocar conteúdo acima e abaixo das caixas de preços do grupo. Se você estiver usando isso na própria página do grupo, não há necessidade de especificar um group_id. Se quiser usá-lo em outro local do site, você precisará do atributo group_id.
Exibir um link para uma página de associação
[mepr_membership_link id="0"]Texto do link aqui[/mepr_membership_link]
Mostra um link para a associação identificada por "id". Substituir id="0″ com a ID de associação real. Saiba como obter uma ID de membro.
Exibir um link para o URL de acesso à associação
[mepr_membership_access_url id="123"]Texto do link aqui[/mepr_membership_access_url]
Usa o URL de acesso à associação definido na configuração "URL de acesso à associação" na seção Opções de associação. Use isso em qualquer lugar de seu site para fornecer ao membro um link para o URL de acesso à associação. Associação id="123″ deve ser substituído pela ID de sua associação. Onde encontrar uma ID de associado?
Exibir o formulário de registro de associação
[mepr_membership_registration_form]
É útil se você quiser colocar conteúdo acima e abaixo do formulário de registro de associação. Ele pode ser usado SOMENTE na página de associação.
[mepr_membership_registration_form id="123"]
Você pode usar esse shortcode em qualquer página, post ou tipo de post personalizado do WordPress para exibir o formulário de registro de associação de uma associação específica. Basta substituir 123 com a ID exclusiva de sua própria associação. Onde encontrar uma ID de associado?
Exibir instruções personalizadas para usuários de gateway off-line
[mepr_offline_instructions gateway_id="abc-123"]Mensagem personalizada aqui[/mepr_offline_instructions].
Esse shortcode pode ser usado em seu Obrigado para exibir qualquer tipo de mensagem específica para os usuários que se registraram por meio da sua opção de gateway off-line. Para gateway_id="abc-123″Digite o ID do gateway. Ele pode ser usado para fornecer instruções adicionais aos usuários quando eles compram sua associação por meio do gateway off-line.
Exibir títulos de associação ativos
[mepr_user_active_membership_titles userid="" message=""]
Mostra os nomes dos membros atualmente ativos. Se não houver usuário estiver presente, então o padrão será o membro atual. Se o membro tiver mais de uma associação ativa, os nomes serão separados por uma vírgula.
Desde que a versão MemberPress 1.9.38 introduziu uma opção mensagem atributo. Ele pode ser usado quando você quiser exibir uma mensagem personalizada quando um usuário não tiver nenhuma assinatura ativa. Se você deixar esse atributo vazio, o shortcode não exibirá nenhuma mensagem.
Acompanhe as conversões de comércio eletrônico
[mepr_ecommerce_tracking]Mensagem com %%variables%% aqui[/mepr_ecommerce_tracking]
Esse shortcode pode ser usado SOMENTE na página de agradecimento ou em mensagens personalizadas da página de agradecimento. Ele não funciona em nenhum outro lugar.
Variáveis de shortcode compatíveis
Ele suporta as seguintes variáveis %%%%, que são automaticamente substituídas pelos valores da compra.
| Variável | Descrição |
| %%subtotal%% | Emite o subtotal do primeiro pagamento. Se o primeiro pagamento tiver sido um período de avaliação gratuita, será 0,00. Se o primeiro pagamento foi um período de avaliação pago, esse será o subtotal do pagamento do período de avaliação. |
| %%total%% | Emite o subtotal + imposto do primeiro pagamento. Se o primeiro pagamento foi um período de avaliação gratuita, esse valor será 0,00. Se o primeiro pagamento foi um período de avaliação pago, esse será o total do pagamento da avaliação. |
| %%tax_amount%% | Emite o valor do imposto do primeiro pagamento. Se o primeiro pagamento foi um período de avaliação gratuita, será 0,00. Se o primeiro pagamento foi um período de teste pago, será o valor do imposto do pagamento do período de teste pago. |
| %%tax_rate%% | Emite a taxa de imposto do usuário sobre essa compra. |
| %%txn_num%% | Emite o número da transação do primeiro pagamento. Para pagamentos recorrentes, esse número de transação provavelmente será um número temporário gerado pelo MemberPress, pois leva algum tempo para o gateway de pagamento processar o primeiro pagamento. |
| %%sub_id%% | Emite o ID da assinatura recorrente. Se a compra feita não for recorrente, essa variável não será substituída. |
| %%txn_id%% | Emite o ID da primeira transação. Para assinaturas recorrentes, esse ID será, na maioria dos casos, o ID do período de carência oculto |
| %%sub_num%% | Emite o número de assinatura da assinatura recorrente. Se a compra feita não for recorrente, essa variável não será substituída. Com o PayPal Standard, esse pode ser um número temporário gerado pelo MemberPress, pois pode levar algum tempo para que o gateway atualize o registro com um número de assinatura válido. |
| %%membership_amount%% | Emite o custo recorrente regular de uma assinatura recorrente. Se a compra feita não for recorrente, essa variável não será substituída. |
| %%trial_days%% | Gera o número de dias no período de avaliação paga ou gratuita de uma assinatura recorrente. Se a compra feita não for recorrente, essa variável não será substituída. |
| %%trial_amount%% | Gera o custo do período de avaliação de uma assinatura recorrente. Se a compra feita não for recorrente, essa variável não será substituída. |
| %1TP6Nome de usuário%% | Emite o nome de usuário do membro. Se você tiver configurado a página Configurações do MemberPress para que o endereço de e-mail do usuário seja o nome de usuário, isso produzirá o endereço de e-mail. |
| %%user_email%% | Emite o endereço de e-mail do membro. |
| %%user_id%% | Emite o ID de usuário do WordPress do membro. |
| %%membership_name%% | Emite o nome (título) da associação adquirida. |
| %%membership_id%% | Emite a ID da associação. |