This document explains how to use the shortcodes available in the EDD All Access extension for Easy Digital Downloads.
Provide All Access Pass details to customers
Shortcode: [edd_aa_customer_passes]
This shortcode will output a list of the customer’s All Access Passes along with all of the relevant details. We recommend putting it on their Customer account page.
Sample output from the [edd_aa_customer_passes] shortcode:
Once the customer clicks on “View Full Details”, they will see more details about that All Access Pass:
Note: If the All Access Pass has a download limit, the customer will see additional information about when their download limit period expires and starts over.
Show users how many downloads they have left
Shortcode: [edd_aa_download_limit]
This shortcode will output how many downloads a pass customer has remaining and the date they expire.
There are three optional parameters:
- download_id=”123,654″ allows you to specify specific All Access Downloads that you want to appear in the shortcode output. If the customer does not own the specified download, no output will appear.
- message=”message text here”
- %1$s is the name of the pass.
- %2$d is the number of downloads left placeholder
- %3$d is the total number of downloads placeholder
- expiration=” expiration text here”
- %1$s is the expiration date placeholder
Shortcode example with parameters:
[edd_aa_download_limit download_id="123" message="%1$s has %2$d of %3$d downloads remaining." expiration="Remaining downloads expire %1$s."]
Sample output from the [edd_aa_download_limit] shortcode:
All Access Pass Purchase & Login buttons
Shortcode: [edd_aa_all_access]
This shortcode is powerful for giving your customers a great user experience. It gives you a quick and easy way to get customers to log in and/or to purchase a specific All Access Pass. It’s perfect for a page where you might be advertising an All Access Pass but also want existing All Access Pass customers to be able to log in.
This shortcode will show one of 3 different things:
1. Logged out: If the customer is logged out, they will see both “Login” and “Buy Now” buttons.
2. Logged in without access: If they are logged in but haven’t purchased the All Access Pass, they will only see the “Buy Now” button for the All Access Pass.
3. Ingelogd met toegang: Als ze zijn ingelogd EN de All Access Pass hebben gekocht, zien ze een "succes" bericht. Standaard is dat bericht:
“Je hebt een All Access Pass voor Product X”. Je kunt het ook zo instellen dat ze automatisch worden doorgestuurd naar een andere pagina (zoals een “VIP Welkomst” pagina). Als alternatief kun je het ook zo instellen dat het beperkte HTML-inhoud toont aan gebruikers die deze All Access Pass hebben. Opmerking: In het onderstaande voorbeeld is “All Access 2 Products” de download/productnaam.
Deze shortcode kan de volgende parameters accepteren:
- id – het ID-nummer van de vereiste All Access download
- price – of de productprijs wel of niet moet worden weergegeven. 1 om het te tonen, 0 om het te verbergen.
- text – de tekst die wordt weergegeven op de Koop Nu knop
- style – de stijl van de aankooplink, ofwel “button” of “text”
- color– de kleur van de knop (bij gebruik van de “button” stijl”:
- grijs
- blauw
- groen
- donkergrijs
- geel
- class – een of meer aangepaste CSS-klassen die je wilt toepassen op de All Access Koop knop
- popup_login – Of het inlogformulier in een pop-up modal moet worden geopend. Als je wilt dat dit gebeurt, gebruik dan hier “true”. Laat anders leeg.
- buy_instructions – Tekstinstructies boven de Koop Nu knop. Indien leeg wordt dit niet weergegeven.
- login_instructions – Tekstinstructies boven de Inlog knop. Indien leeg wordt dit niet weergegeven.
- login_btn_style – de stijl van de inloglink, ofwel “button” of “text”. Standaard is “text”.
- direct – of de aankoopknop de klant rechtstreeks naar PayPal moet sturen of naar het afrekenscherm.
- preview_image – Een URL naar een afbeelding die wordt getoond als de gebruiker geen toegang heeft.
- success_redirect_url – De URL waar de gebruiker naartoe moet worden gestuurd als hij is ingelogd en de All Access Pass heeft.
- success_text – Het bericht dat aan een gebruiker wordt getoond voordat deze wordt doorgestuurd na succesvolle inlog en aankoop. Standaard is dit “Je hebt een All Access Pass voor Product X”.
Voorbeeld van gebruik:
Om een inlogknop en een aankoopknop weer te geven en de gebruiker door te sturen als hij is ingelogd met een All Access Pass, gebruik de shortcode als volgt:
[edd_aa_all_access id="94" price_id="0" text="Add to Cart" style="button" popup_login="true" success_redirect_url="https://mywebsite.com/vip-welcome" success_text="Great! You have All Access"]Inhoud beperken met [edd_aa_all_access]
In plaats van success_text te gebruiken, kun je ook succesinhoud tonen. Dit is perfect voor enkele pagina's waar je exclusieve inhoud wilt beperken tot All Access Pass-houders. Om exclusieve, beperkte inhoud te tonen aan All Access Pass-houders, gebruik de shortcode als volgt:
[edd_aa_all_access id="YOUR_ALL_ACCESS_PRODUCT_ID_HERE"]
Your restricted content goes here. It can be HTML.
[/edd_aa_all_access]Inhoud beperken met [edd_aa_all_access] met een voorbeeldafbeelding en instructietekst
Om een voorbeeldafbeelding weer te geven en aangepaste instructies aan de gebruiker te tonen, gebruikt u de shortcode als volgt:
[edd_aa_all_access id="YOUR_ALL_ACCESS_PRODUCT_ID_HERE" preview_image="https://url-to-image.jpg" buy_instructions="Buy Now to unlock access" login_instructions="Already purchased? Login here to unlock access"]
Your restricted content goes here. It can be HTML.
[/edd_aa_all_access]U kunt ook andere shortcodes in het beperkte gebied plaatsen. U wilt bijvoorbeeld mogelijk de aankoopgeschiedenis van een gebruiker weergeven op dezelfde plek waar ze inloggen of kopen. Om dat te doen, gebruikt u zoiets als dit:
[edd_aa_all_access id="YOUR_ALL_ACCESS_PRODUCT_ID_HERE" buy_instructions="Buy Now to unlock access" login_instructions="Already purchased? Login here to unlock access"]
[purchase_history]
[/edd_aa_all_access]Restrict Content [edd_aa_restrict_content]
Shortcode: [edd_aa_restrict_content]
Deze shortcode is heel eenvoudig en kan worden gebruikt om inhoud alleen weer te geven als de klant een specifieke all-accesspas heeft. Het is een vereenvoudigde versie van [edd_aa_all_access]. Voorbeeldgebruik:
[edd_aa_restrict_content id="YOUR_ALL_ACCESS_PRODUCT_ID_HERE"]
Restricted content goes here. It can be anything you'd like - even HTML.
[/edd_aa_restrict_content]Inhoud weergeven voor degenen zonder toegang tot een specifieke pas
Shortcode: [edd_aa_no_access_pass]
Deze shortcode is heel eenvoudig en kan worden gebruikt om inhoud alleen weer te geven als de klant GEEN specifieke all-accesspas heeft. U wilt bijvoorbeeld "verkoop" informatie alleen weergeven als de klant nog niet heeft gekocht. Voorbeeldgebruik:
[edd_aa_no_access_pass id="YOUR_ALL_ACCESS_PRODUCT_ID_HERE"]
Sales content goes here. It can be anything you'd like - even HTML.
[/edd_aa_no_access_pass]Producten tonen die bij een klantpas horen
Shortcode: [downloads all_access_customer_downloads_only="yes"]
De [downloads] shortcode (die deel uitmaakt van Easy Digital Downloads zelf), kan worden aangepast om alleen producten weer te geven waartoe de klant toegang heeft via All Access. Voeg hiervoor simpelweg dit toe aan de shortcode: all_access_customer_downloads_only=”yes”.
Bijvoorbeeld:
[downloads all_access_customer_downloads_only="yes"]Wijzig de tekst van [purchase_link] voor klanten die een pas bezitten
Shortcode: [purchase_link all_access_download_now_text="Download Nu"]
De [purchase_link] shortcode (die deel uitmaakt van Easy Digital Downloads zelf), stelt u in staat de tekst die aan uw All Access-klanten wordt getoond aan te passen, zodat u de tekst "Download Nu" kunt wijzigen. Voeg hiervoor simpelweg dit toe aan de shortcode: all_access_download_now_text=”Download Nu”. Vervang vervolgens "Download Nu" door uw eigen aangepaste bericht.
Bijvoorbeeld:
[purchase_link all_access_download_now_text="YOUR CUSTOM TEXT HERE"]
