[DAPUpline] Shortcode Overview
The [DAPUpline] shortcode is a powerful tool in Digital Access Pass (DAP) that allows you to display the referring affiliate’s (or sponsor’s) information to a user on any WordPress page or post. It can also be considered a “downline builder” as it shows the user who their upline affiliate is, pulling data directly from the referring affiliate’s profile.
This shortcode can dynamically show any field from the affiliate’s profile, giving you the flexibility to share customized information.
How [DAPUpline] Works
When a user visits a page with the [DAPUpline] shortcode, DAP determines who the user’s affiliate (sponsor) is using one of the following methods:
- Affiliate Cookie – If the user has an affiliate cookie, it will show the affiliate’s data.
- Logged-in Members – If the user is logged into DAP, it will show the information of the current affiliate linked to their account.
- Fallback to Admin – If no cookie exists and no affiliate is attached to the user, it will default to showing the DAP Admin’s information.
This provides a simple and efficient way for users to see who referred them, and it enables affiliates to promote third-party products by automatically embedding their affiliate information in referral links.
Example Use Case
Let’s break down an example:
- John joins your site and fills out his profile, adding his ClickBank nickname.
- John refers Adam.
- When Adam logs in, the page shows affiliate links to third-party products where John’s ClickBank nickname automatically replaces the generic nickname in the link. If Adam purchases the product, John earns the commission.
- Adam then updates his own profile with his ClickBank nickname.
- Adam refers Jill.
- When Jill logs in, she sees the same third-party affiliate link, but now with Adam’s ClickBank nickname. If Jill makes a purchase, Adam earns the commission.
This logic applies to any number of third-party programs, allowing affiliates to fill out multiple profile fields like ClickBankNick, CommissionJunctionNick, JVZooId, GoogleAnalyticsId, and more.
Admin Fallback
If an affiliate (e.g., Adam) doesn’t fill out their ClickBank nickname, the system will automatically insert the site admin’s nickname into the affiliate link, meaning the admin earns the commission for any unclaimed links.
How to Use the [DAPUpline] Shortcode
You can display specific data from the referring affiliate’s profile by inserting the shortcode with the desired field. Here are examples:
To show the affiliate’s first name, use:
[DAPUpline showField="first_name"]To show the affiliate’s email, use:
[DAPUpline showField="email"]Full List of Available Fields
- First Name:
[DAPUpline showField="first_name"] - Last Name:
[DAPUpline showField="last_name"] - Username:
[DAPUpline showField="user_name"] - Email:
[DAPUpline showField="email"] - Address 1:
[DAPUpline showField="address1"] - Address 2:
[DAPUpline showField="address2"] - City:
[DAPUpline showField="city"] - State:
[DAPUpline showField="state"] - ZIP Code:
[DAPUpline showField="zip"] - Country:
[DAPUpline showField="country"] - Phone:
[DAPUpline showField="phone"] - Fax:
[DAPUpline showField="fax"] - Company:
[DAPUpline showField="company"] - Title:
[DAPUpline showField="title"] - PayPal Email:
[DAPUpline showField="paypal_email"]
Displaying Custom Fields
If you have custom fields set up in the affiliate profile, you can display those as well. For example:
- To display a custom field like SSN (assuming you’ve already created a custom field called
ssn), use:
[DAPUpline showField="custom_ssn"]Important Note
Before displaying any custom fields, ensure that they have already been created in the system. You can create and manage custom fields in DAP’s settings.
This shortcode gives you a highly customizable way to share affiliate and sponsor data, empowering affiliates to promote products more effectively and ensuring that all referred users can see exactly who brought them to your site!
