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. Por exemplo, você pode ter um shortcode que mostrará o primeiro nome do usuário conectado no momento. Um shortcode pode ter a seguinte aparência:
[mepr-account-info field="first_name"]
Quando a página em que o shortcode está for visualizada por um usuário conectado chamado John Doe. A página mostraria João no conteúdo em que esse shortcode foi colocado.
Visão geral em vídeo dos códigos curtos e como usá-los no MemberPress
Shortcodes disponíveis atualmente
Relacionado à conta
[mepr-account-link]
Mostra um link para a página Account (Conta) no MemberPress. Pode ser usado em qualquer página ou postagem.
[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.
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.
[mepr-list-subscriptions status="all"]
Exibe uma lista das assinaturas ativas e inativas do usuário atual.
Desde a versão MemberPress 1.9.28, introduzimos um atributo de status opcional. Quando você define o status como "all" (todos) ou o remove desta forma:
[mepr-list-subscriptions]
Como você pode ver acima, ele exibirá as assinaturas ativas e inativas da corrente padrão. Quando você define o status como "ativo":
[mepr-list-subscriptions status="active"]
e você verá as assinaturas ativas do usuário atual. Você também pode exibir as assinaturas inativas do usuário atual usando o status "expired" (expirado):
[mepr-list-subscriptions status="expired"]
A lista de assinaturas pode ser classificada por data:
[mepr-list-subscriptions orderby="date"]
ou título:
[mepr-list-subscriptions orderby="title"]
Elas podem ser classificadas em ordem crescente:
[mepr-list-subscriptions orderby="title" order="asc"]
ou ordem decrescente:
[mepr-list-subscriptions orderby="title" order="desc"]
[mepr-logout-link]
[mepr-login-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 direcionará o usuário para a página de login do MemberPress, onde ele poderá fazer login. O link de logout fará o logout do usuário e o redirecionará para o URL de redirecionamento de logout que você definiu na página de configurações do MemberPress.
[mepr-login-form use_redirect="true"]
Mostra um formulário de login em uma página ou post. Ele pode ser usado em qualquer lugar. Quando use_redirect = "true“, MemberPress will redirect the user to the login redirect URL setting located in the MemberPress Settings page.
[mepr-user-file slug="mepr_slug" user_id=""]Texto do link[/mepr-user-file]
Mostra um link para visualizar/baixar o arquivo carregado por um usuário. Substitua mepr_slug pelo slug do campo personalizado da guia MemberPress > Configurações > Campos. Se você omitir user_id, ele mostrará o arquivo para o usuário conectado no momento; caso contrário, mostrará o arquivo para o usuário especificado por user_id.
Você não precisa colocar a tag de fechamento do shortcode, mas, se o fizer, qualquer texto entre elas será usado como o texto do link para o arquivo.
[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 a versão MemberPress 1.9.38, introduzimos 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.
[mepr-account-info field="slug"]
Exibe o campo meta do usuário, que é escolhido por "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. |
Acesso não autorizado relacionado
[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, recomendamos o uso desse shortcode nessa página não autorizada.
[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 o atributo if="X", em que "X" pode ser "loggedin" ou "loggedout". Ambos os códigos de acesso funcionam de acordo com o fato de o usuário estar conectado ou desconectado e não se importam com quais associações o usuário comprou, se houver alguma. Exemplos disso podem ser:
[mepr-show if="loggedin"]Você está conectado, parabéns!
[mepr-show if="loggedout"]Você está desconectado![/mepr-show]
[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 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 | If you plan to use a single Membership ID (Onde encontrar a identificação de um membro?), then set this to one of the possible values:
Observação: when set to “message” or “both” AND the rule has a custom unauthorized message, it will display the custom unauthorized message instead of the global one. |
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]
Relacionado ao registro
[mepr-group-price-boxes group_id="123"]
Útil se você quiser colocar conteúdo acima e abaixo das caixas de preços do grupo. Se estiver usando isso na própria página Group, não há necessidade de especificar um group_id. Se quiser usá-lo em outro local do site, precisará do atributo group_id nele.
[mepr-membership-link id="0"]Texto do link aqui[/mepr-membership-link]
Mostra um link para a associação identificada por "id".
[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. Membership. id = 123 deve ser substituído pelo ID de sua associação. Onde encontrar uma ID de associado?
[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?
[mepr-offline-instructions gateway_id="abc-123"]Mensagem personalizada aqui[/mepr-offline-instructions].
Esse shortcode pode ser usado em suas páginas de "agradecimento" para exibir qualquer tipo de mensagem específica para usuários que se registraram por meio de sua opção de gateway off-line. Para gateway_id="abc-123″, digite o ID do seu gateway. Ele pode ser usado para fornecer instruções adicionais aos usuários quando eles comprarem sua associação por meio do gateway off-line. Observação: embora tenhamos projetado isso especificamente com os gateways off-line em mente, ele pode ser usado com sucesso com o ID do gateway de qualquer outro gateway compatível com o MemberPress.
[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.
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. |