This tutorial covers all the major features of the DBP Tracking Link Generator block.
The DBP Tracking Link Generator block is a powerful Gutenberg block that allows users to create custom tracking URLs for funnel pages with personalized tracking IDs. This comprehensive tutorial will guide you through all its features and capabilities.
Getting Started
Adding the Block
- In the WordPress editor, click the “+” button to add a new block
- Search for “DBP Tracking Link Generator” or find it in the Widgets category
- Click to add the block to your post or page
Initial Setup
Important: This block generates tracking URLs for pages tagged with “funnel-page”. Make sure your funnel pages have this tag for them to appear in the dropdown menu.
Core Settings
Content Settings Panel
Button Text
- Purpose: Text displayed on the generate button
- Default: “Generate URL”
- Examples: “Create Link”, “Generate Tracking URL”, “Build Link”
Dropdown Text Options
- Select Funnel Page Text: Placeholder for dropdown (default: “Select a Funnel Page”)
- No Funnel Pages Text: Message when no pages found (default: “No Funnel Pages found”)
- Use Case: Customize messages to match your site’s language and tone
Input Field Settings
- Tracking Placeholder: Placeholder text for tracking ID field (default: “Enter Tracking ID”)
- Tracking Required Alert: Alert message when tracking ID is empty (default: “Tracking value is required!”)
- Tracking URL Label: Label for generated URL (default: “Your Tracking URL:”)
Layout Settings Panel
Stack Fields
- Purpose: Controls whether fields stack vertically or display side by side
- Default: Enabled (stacked layout)
- Stacked: Dropdown and input appear vertically
- Side-by-side: Dropdown (60%) and input (40%) appear horizontally
- Mobile: Stacked layout works better for mobile devices
Form Alignment
- Form Width: Controls the width of the entire form (100%, 600px, etc.)
- Form Alignment: Left, Center, Right alignment options
- Button Alignment: Separate alignment control for the generate button
Styling Options
Container Styling Panel
Background & Border
- Background Color: Set container background color
- Text Color: Set container text color
- Border Color: Add border color to container
- Border Width: Set border thickness
- Border Radius: Round corners
- Padding: Internal spacing
Dropdown Styling Panel
Dropdown Colors & Spacing
- Background Color: Dropdown background (default: #ffffff)
- Text Color: Dropdown text color (default: #333333)
- Border Color: Dropdown border color (default: #dddddd)
- Border Width: Dropdown border thickness (default: 1px)
- Border Radius: Dropdown corner roundness (default: 4px)
- Padding & Margin: Control spacing around dropdown
- Width & Font Size: Dropdown dimensions and text size
Input Field Styling Panel
Input Colors & Spacing
- Background Color: Input field background (default: #ffffff)
- Text Color: Input text color (default: #333333)
- Border Color: Input border color (default: #dddddd)
- Border Width: Input border thickness (default: 1px)
- Border Radius: Input corner roundness (default: 4px)
- Padding & Margin: Control spacing around input field
- Width & Font Size: Input dimensions and text size
Button Styling Panel
Button Colors & Effects
- Background Color: Button background (default: #007cba)
- Text Color: Button text color (default: #ffffff)
- Border Color: Button border color
- Dimensions: Width, padding, margin, radius controls
- Typography: Font size and weight options
Result Display Styling Panel
Generated URL Display
- Background Color: Result field background (default: #f0f0f0)
- Text Color: Result text color (default: #333333)
- Border Color: Result field border (default: #dddddd)
- Border Width & Radius: Border styling options
- Padding & Margin: Spacing around result display
How It Works
URL Generation Process
- Select Funnel Page: User chooses from dropdown of pages tagged “funnel-page”
- Enter Tracking ID: User inputs a custom tracking identifier
- Generate URL: Click button to create tracking link
- URL Format:
page-url?id=username&tracking=tracking-id
- Copy Link: Generated URL appears in read-only field for easy copying
URL Parameters
- id parameter: Automatically includes current user’s username
- tracking parameter: Custom tracking ID entered by user
- Example:
https://yoursite.com/sales-page?id=john&tracking=campaign-2024
- Use Case: Track referral sources, campaign performance, affiliate activity
Examples
Basic Link Generator
Configuration:
- Default text and styling
- Stacked layout (mobile-friendly)
- Center alignment
- 100% width
Use Case: Simple link generator for member dashboards or affiliate tools.
Professional Link Builder
Configuration:
- Custom text: “Build Your Tracking Link”
- Container background and border styling
- Professional color scheme
- Side-by-side layout for desktop
- Custom result display styling
Use Case: Branded affiliate portal with professional appearance and advanced tracking capabilities.
Compact Sidebar Generator
Configuration:
- Stacked layout for narrow spaces
- Compact padding and margins
- Smaller font sizes
- Auto-width button
- Simple styling for minimal space
Use Case: Widget areas or sidebar placements where space is limited but tracking functionality is needed.
Best Practices
Setup Requirements
- Funnel Page Tags: Ensure your funnel pages are tagged with “funnel-page”
- Page Accessibility: Make sure funnel pages are published and accessible
- User Login: Block works best when users are logged in for username inclusion
- Tracking System: Have a system in place to utilize the tracking parameters
User Experience
- Clear Instructions: Provide guidance on how to use tracking IDs effectively
- Layout Choice: Use stacked layout for mobile, side-by-side for desktop
- Copy Function: Generated URLs are automatically selected for easy copying
- Validation: Form validates tracking ID input before generating URLs
Tracking Strategy
- Naming Convention: Establish consistent tracking ID formats
- Campaign Tracking: Use tracking IDs to identify specific campaigns
- Analytics Integration: Connect tracking parameters to your analytics system
- Performance Monitoring: Track which links generate the best results
Troubleshooting
Common Issues
No Funnel Pages in Dropdown:
- Check if pages are tagged with “funnel-page”
- Verify pages are published (not draft or private)
- Ensure pages are of type “page” not “post”
- Check spelling of the “funnel-page” tag
URL Not Generating:
- Ensure both dropdown and tracking ID field are filled
- Check for JavaScript errors in browser console
- Verify jQuery is loaded on the page
- Test with different tracking ID values
Styling Issues:
- Ensure “Use Custom Style” is enabled for styling options to work
- Clear browser cache after making styling changes
- Check for theme CSS conflicts that may override styles
- Test layout responsiveness on different screen sizes
Advanced Customization
For advanced users who need additional functionality beyond the block options:
- Use CSS class:
.wp-block-downline-builder-plugin-tracking-link-generator
- Target form:
#dbp-tracking-link-form
- Style dropdown:
#dbp-tracking-link-dropdown
- Style input:
#tracking_id
- Style button:
#submit_tracking_id
- Style result:
#tracking_url_display
Add custom CSS to your theme’s style.css or use the WordPress Customizer for advanced styling requirements.