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
- Account Related Shortcodes
- Subscription Related Shortcodes
- Login Related Shortcodes
- Unauthorized Access Related Shortcodes
- Registration Related Shortcodes
Account Related Shortcodes
Show a Link to the Account Page
[mepr_account_link]
Mostra um link para a página Account (Conta) no MemberPress. Pode ser usado em qualquer página ou postagem.
Display the Account Information Form
[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.
Display User Account Information
[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.
Display a Link to User-Uploaded Files
[mepr_user_file slug="mepr_slug" user_id=""]Link Text[/mepr_user_file]
This shortcode displays a link to view or download a file uploaded by a user.
Setup Instructions:
- Substituir mepr_slug with the name of your custom field from MemberPress > Configurações > Guia Campos.
- If you don't add a user_id parameter, it shows the file for the logged-in user.
- Se o user_id parameter is given, the shortcode shows the file for that user.
- The text between the tags is the link text for the file.
You don't have to include the closing tag. If you leave it out, the link will just show normally.
Subscription Related Shortcodes
Display a List of Subscriptions
Exibe uma lista das assinaturas ativas e inativas do usuário atual.
[mepr_list_subscriptions status="all"]
Since the MemberPress 1.9.28 version have introduced an optional status attribute.
Status Options:
- status=”all” or no status attribute – displays all active and inactive subscriptions;
- status=”active” – displays only active subscriptions;
- status=”expired” – displays only inactive subscriptions.
You can set the status to “todos” or remove it like this:
[mepr_list_subscriptions]
As you can see above, it will display the default current active and inactive subscriptions.
[mepr_list_subscriptions status="active"]
When you set the status to “active”, you will see the current user's active subscriptions.
[mepr_list_subscriptions status="expired"]
You can also display the current user's inactive subscriptions by using the “expired” status.
Sorting Options:
A lista de assinaturas pode ser classificada por data:
[mepr_list_subscriptions orderby="date"]
Or title:
[mepr_list_subscriptions orderby="title"]
Sort Order Options:
Elas podem ser classificadas em ordem crescente:
[mepr_list-subscriptions orderby="title" order="asc"]
Or descending order:
[mepr_list_subscriptions orderby="title" order="desc"]
Login Related Shortcodes
Display Login or Logout Links
Login Link Shortcode:
[mepr_login_link]
Logout Link Shortcode:
[mepr_logout_link]
The above two shortcodes are both identical. They show login or logout links based on the current user's logged-in status.
The login link takes users to the login page, where they can log in. The logout link logs them out and sends them to the Redirect URL, which you can set in Dashboard > MemberPress > Settings > Guia Conta.
Display a Login Form
[mepr_login_form use_redirect="true"]
This shortcode shows a login form on a page or post. It can be used anywhere. When use_redirect = "true“, MemberPress will redirect the user to the login redirect URL setting located in the Painel de controle > MemberPress > Settings > Guia Conta.
Unauthorized Access Related Shortcodes
Display the Unauthorized Message
[mepr_unauthorized_message]
Shows the unauthorized message wherever this is placed. If you've set MemberPress up to redirect unauthorized visitors to a specific URL, then it is recommended to use this shortcode on that unauthorized page.
Show or Hide Content Based on Login Status
[mepr_show]Content to show in here[/mepr_show]
[mepr_hide]Content to hide in here[/mepr_hide]
Both shortcodes above support if=”X” attribute, where “X” can be “loggedin” ou “loggedout”.
Examples:
[mepr_show if="loggedin"]You’re logged in, congratulations![/mepr_show]
[mepr_show if="loggedout"]You’re now logged out![/mepr_show]
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.
Show or Hide Content Based on Membership Access
[mepr_active {parameters go here - see below}]Content to protect in here[/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):
Supported Shortcode Parameters
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]
Registration Related Shortcodes
Display Group Pricing Boxes
[mepr_group_price_boxes group_id="123"]
This shortcode is helpful if you want to place content above and below the group pricing boxes. If you're using this on the Group page itself, there's no need to specify a group_id. If you want to use it elsewhere on your site, you will need the group_id attribute.
Display a Link to a Membership Page
[mepr_membership_link id="0"]Link text in here[/mepr_membership_link]
Shows a link to the Membership identified by “id”. Replace id=”0″ with the real Membership ID. Find out how to get a Membership ID.
Display a Link to the Membership Access URL
[mepr_membership_access_url id="123"]Link text here[/mepr_membership_access_url]
Uses the Membership access URL set in the “Membership access URL” setting under the Membership Options section. Use this anywhere on your site to give the member a link to the Membership access URL. Membership id=”123″ should be replaced with the ID of your Membership. Onde encontrar uma ID de associado?
Display the Membership Registration Form
[mepr_membership_registration_form]
It is helpful if you want to place content above and below the Membership registration form. It can ONLY be used on the Membership page.
[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?
Display Custom Instructions for Offline Gateway Users
[mepr_offline_instructions gateway_id="abc-123"]Custom message here.[/mepr_offline_instructions]
This shortcode can be used on your Thank-You pages to display any type of message specific to users who registered via your offline gateway option. For gateway_id=”abc-123″, enter your gateway's ID. It could be used to provide additional instructions for users when they purchase your membership through your offline gateway.
Display Active Membership Titles
[mepr_user_active_membership_titles userid="" message=""]
Mostra os nomes dos membros atualmente ativos. Se não houver usuário is present, then it'll default to the current member. If the member has more than one active membership, the names will be separated by a comma.
Since the MemberPress 1.9.38 version have introduced an optional mensagem attribute. It can be used when you want to display a custom message when a user doesn't have any active subscriptions. If you leave it empty, the shortcode will not display any message.
Track E-commerce Conversions
[mepr_ecommerce_tracking]Message with %%variables%% in here[/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.
Supported Shortcode Variables
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. |