# Shortcodes do All Access
Este documento explica como usar os shortcodes disponíveis na [extensão All Access do EDD](https://easydigitaldownloads.com/downloads/all-access/) para Easy Digital Downloads.
### Fornecer detalhes do Passe All Access aos clientes
**Shortcode:** `[[edd_aa_customer_passes]]`
Este shortcode exibirá uma lista dos Passes All Access do cliente juntamente com todos os detalhes relevantes. Recomendamos colocá-lo na página da conta do cliente.
Exemplo de saída do shortcode `[[edd_aa_customer_passes]]`:
Após o cliente clicar em "Ver Detalhes Completos", ele verá mais detalhes sobre esse Passe All Access:
**Observação:** Se o Passe All Access tiver um limite de downloads, o cliente verá informações adicionais sobre quando o período do limite de downloads expira e recomeça.
### Mostrar aos usuários quantos downloads restam
Shortcode: `[edd_aa_download_limit]`
Este shortcode exibirá quantos downloads um cliente com passe tem restantes e a data de expiração.
Existem três parâmetros opcionais:
- **download\_id="123,654"** permite especificar Downloads All Access específicos que você deseja que apareçam na saída do shortcode. Se o cliente não possuir o download especificado, nenhuma saída aparecerá.
- **message="texto da mensagem aqui"**
- **%1$s** é o nome do passe.
- %2$d** é o espaço reservado para o número de downloads restantes
- **%3$d** é o espaço reservado para o número total de downloads
- **expiration=" texto de expiração aqui"**
- **%1$s** é o espaço reservado para a data de expiração
Exemplo de shortcode com parâmetros:
`[edd_aa_download_limit download_id="123" message="%1$s tem %2$d de %3$d downloads restantes." expiration="Downloads restantes expiram em %1$s."]`
Exemplo de saída do shortcode `[edd_aa_download_limit]`:
### Botões de Compra e Login do Passe All Access
**Shortcode:** `[[edd_aa_all_access]]`
Este shortcode é poderoso para proporcionar uma ótima experiência ao usuário. Ele oferece uma maneira rápida e fácil de fazer com que os clientes façam login *e/ou* comprem um Passe All Access específico. É perfeito para uma página onde você pode estar anunciando um Passe All Access, mas também deseja que os clientes existentes com Passe All Access possam fazer login.
Este shortcode mostrará uma das 3 coisas diferentes:
**1. Deslogado:** Se o cliente estiver deslogado, ele verá os botões "Login" e "Comprar Agora".
**2. Logado sem acesso:** Se estiver logado, mas não comprou o Passe All Access, ele verá apenas o botão "Comprar Agora" para o Passe All Access.
**3. Logado com acesso:** Se estiver logado E comprou o Passe All Access, ele verá uma mensagem de "sucesso". Por padrão, essa mensagem é:
"Você tem um Passe All Access para o Produto X". Você também pode configurá-lo para redirecioná-lo automaticamente para uma página diferente (como uma página "Boas-vindas VIP"). Alternativamente, você também pode fazer com que ele mostre conteúdo HTML restrito para usuários que possuem este Passe All Access. **Observação:** No exemplo abaixo, "All Access 2 Produtos" é o nome do download/produto.
Este shortcode pode aceitar os seguintes parâmetros:
- ***id*** – o número de ID do download All Access necessário
- ***price*** – se deve mostrar ou não o preço do produto. 1 para mostrar, 0 para ocultar.
- ***text*** – o texto exibido no botão Comprar Agora
- ***style*** – o estilo do link de compra, seja “button” ou “text”
- ***color***– a cor do botão (ao usar o estilo “button”:
- gray
- blue
- green
- dark gray
- yellow
- ***class*** – uma ou mais classes CSS personalizadas que você deseja aplicar ao botão Comprar All Access
- ***popup\_login*** – Se o formulário de login deve abrir em uma janela modal pop-up. Se você quiser que isso aconteça, use "true" aqui. Caso contrário, deixe em branco.
- ***buy\_instructions*** – Instruções de texto acima do botão Comprar Agora. Se estiver em branco, não será exibido.
- ***login\_instructions*** – Instruções de texto acima do botão Login. Se estiver em branco, não será exibido.
- ***login\_btn\_style*** – o estilo do link de login, seja “button” ou “text”. O padrão é "text".
- ***direct*** – se o botão de compra deve enviar o cliente diretamente para o PayPal ou para a tela de checkout.
- ***preview\_image*** – Um URL para uma imagem que será exibida se o usuário não tiver acesso.
- ***success\_redirect\_url*** – A URL para a qual o usuário deve ser redirecionado se estiver logado e possuir o Passe All Access.
- ***success\_text*** – A mensagem exibida ao usuário antes de ser redirecionado quando logado com sucesso e comprado. Por padrão, é "Você tem um Passe All Access para o Produto X".
**Exemplo de uso:**
Para exibir um botão de login e um botão de compra e redirecionar o usuário se ele estiver logado com um Passe All Access, use o shortcode desta forma:
```
[edd_aa_all_access id="94" price_id="0" text="Adicionar ao Carrinho" style="button" popup_login="true" success_redirect_url="https://meusite.com/boas-vindas-vip" success_text="Ótimo! Você tem All Access"]
```
### Restringindo Conteúdo usando `[[edd_aa_all_access]]`
Em vez de usar success\_text, você também pode exibir conteúdo de sucesso. Isso é perfeito para páginas únicas onde você deseja restringir conteúdo exclusivo para detentores de Passe All Access. Para exibir conteúdo exclusivo e restrito para detentores de Passe All Access, use o shortcode desta forma:
```
[edd_aa_all_access id="SEU_ID_DO_PRODUTO_ALL_ACCESS_AQUI"]
Seu conteúdo restrito vai aqui. Pode ser HTML.
[/edd_aa_all_access]
```
### Restringindo Conteúdo usando `[[edd_aa_all_access]]` com uma imagem de pré-visualização e texto instrutivo
Para exibir uma imagem de pré-visualização, bem como exibir mensagens instrutivas personalizadas para o usuário, use o shortcode desta forma:
```
[edd_aa_all_access id="SEU_ID_DO_PRODUTO_ALL_ACCESS_AQUI" preview_image="https://url-da-imagem.jpg" buy_instructions="Compre agora para desbloquear o acesso" login_instructions="Já comprou? Faça login aqui para desbloquear o acesso"]
Seu conteúdo restrito vai aqui. Pode ser HTML.
[/edd_aa_all_access]
```
Você também pode colocar outros shortcodes na área restrita. Por exemplo, você pode querer mostrar o histórico de compras de um usuário no mesmo local onde ele faz login ou compra. Para fazer isso, use algo como:
```
[edd_aa_all_access id="SEU_ID_DO_PRODUTO_ALL_ACCESS_AQUI" buy_instructions="Compre agora para desbloquear o acesso" login_instructions="Já comprou? Faça login aqui para desbloquear o acesso"]
[purchase_history]
[/edd_aa_all_access]
```
### Restringir Conteúdo `[[edd_aa_restrict_content]]`
**Shortcode:** `[[edd_aa_restrict_content]]`
Este shortcode é muito simples e pode ser usado para exibir conteúdo apenas se o cliente possuir um passe all access específico. É uma versão simplificada de `[[edd_aa_all_access]]`. Exemplo de Uso:
```
[edd_aa_restrict_content id="SEU_ID_DO_PRODUTO_ALL_ACCESS_AQUI"]
Conteúdo restrito vai aqui. Pode ser qualquer coisa que você queira - até mesmo HTML.
[/edd_aa_restrict_content]
```
### Exibir conteúdo para aqueles sem acesso a um passe específico
**Shortcode:** `[[edd_aa_no_access_pass]]`
Este shortcode é muito simples e pode ser usado para exibir conteúdo apenas se o cliente NÃO possuir um passe all access específico. Por exemplo, você pode querer exibir informações de "vendas" apenas se o cliente ainda não comprou. Exemplo de Uso:
```
[edd_aa_no_access_pass id="SEU_ID_DO_PRODUTO_ALL_ACCESS_AQUI"]
Conteúdo de vendas vai aqui. Pode ser qualquer coisa que você queira - até mesmo HTML.
[/edd_aa_no_access_pass]
```
### Mostrar produtos incluídos em um passe de cliente
**Shortcode:** `[[downloads all_access_customer_downloads_only="yes"]]`
O shortcode `[[downloads]]` (que faz parte do próprio Easy Digital Downloads), pode ser modificado para mostrar apenas produtos aos quais o cliente tem acesso através do All Access. Para fazer isso, basta adicionar isto ao shortcode: **all\_access\_customer\_downloads\_only="yes"**.
Por exemplo:
```
[downloads all_access_customer_downloads_only="yes"]
```
### Modificar o texto do `[[purchase_link]]` para clientes que possuem um passe
**Shortcode**: `[[purchase_link all_access_download_now_text="Baixar Agora"]]`
O shortcode `[[purchase_link]]` (que faz parte do próprio Easy Digital Downloads), permite modificar o texto exibido aos seus clientes All Access para que você possa modificar o texto "Baixar Agora". Para fazer isso, basta adicionar isto ao shortcode: **all\_access\_download\_now\_text="Baixar Agora"**. Em seguida, substitua "Baixar Agora" por sua própria mensagem personalizada.
Por exemplo:
```
[purchase_link all_access_download_now_text="SEU TEXTO PERSONALIZADO AQUI"]
```