Product Ad Shortcodes
This document explains how to use the product advertisement shortcodes for your LED effects website.
Available Shortcodes
1. Product Ad Card
Purpose: Display individual product advertisements with pricing and features.
HTML Implementation:
| |
Parameters:
product(required): Product identifierurl(required): Purchase URLdescription(optional): Product descriptionprice(optional): Current priceoriginal_price(optional): Original price for comparisonbadge(optional): Badge type (premium, popular, new, free)features(optional): Array of feature stringscta(optional): Button text (default: “Get Now”)
2. Special Offer Banner
Purpose: Display limited-time special offers with savings and urgency.
HTML Implementation:
| |
Parameters:
product(required): Product identifierurl(required): Purchase URLtitle(required): Offer titledescription(optional): Offer descriptionprice(optional): Sale priceoriginal_price(optional): Original pricesavings(optional): Savings amountbadge(optional): Badge type (limited-time, new, popular)features(optional): Array of feature stringscta(optional): Button text (default: “Get This Deal”)timer(optional): Timer/urgency textemoji(optional): Emoji for the offer
3. Call-to-Action Banner
Purpose: General purpose CTA banners for newsletters, downloads, etc.
HTML Implementation:
| |
Parameters:
url(required): Target URLtitle(required): Banner titledescription(optional): Banner descriptionfeatures(optional): Array of feature objects with icon and textcta(optional): Button text (default: “Get Started”)button_text(optional): Button text overridetype(optional): Banner style (info, warning, success)
Implementation Strategy
Where to Use These Shortcodes
- Homepage: Add special offers between main content sections
- Tutorial Pages: Insert relevant product ads in sidebars or between sections
- Download Pages: Promote premium packs near free downloads
- Controller Pages: Advertise compatible effects packs
- Project Gallery: Show related products for featured projects
Best Practices
- Strategic Placement: Place ads where users are most likely to convert
- Relevant Targeting: Match ads to page content (e.g., controller pages get controller-compatible effects)
- Value Proposition: Always highlight benefits and savings
- Mobile Optimization: All shortcodes are responsive
- SEO Friendly: Use descriptive alt text and proper link attributes
Styling Notes
All shortcodes use the existing CSS classes from your theme:
.product-card: Main product card container.product-badge: Badge styling (premium, popular, new, free).product-image: Product image styling.product-content: Content container.product-features: Feature tags container.feature-tag: Individual feature styling.product-pricing: Price display container.cta-banner: CTA banner container.cta-content: CTA content container.cta-features: CTA features grid.cta-feature: Individual CTA feature.feature-icon: Feature icon styling.cta-button: Main CTA button
Current Implementation
The site currently uses HTML implementations instead of Hugo shortcodes to avoid template parsing issues. All product advertisements are implemented using:
- Homepage: Special offer section with HTML banner
- Products Section: Additional product card for LED Effects Pack 1
- Free Software Section: Newsletter signup CTA banner
- Content Pages: Product cards with proper styling
This approach provides the same visual impact and conversion optimization while maintaining Hugo build stability.
- All shortcodes include responsive design
- Dark mode support built-in
- Hover effects and animations
- Consistent with site theme variables
- Mobile-optimized layouts
Tracking Implementation
To track ad performance, you can:
- Add UTM parameters to URLs
- Use different product identifiers
- Monitor clicks with analytics
- A/B test different placements
Example with UTM:
| |
Explore More Content
Controllers
- K-8000D LED Controller 2025 (Discontinued) - High-End Professional Multi-Port Controller 2025-05-14
- T-1000A LED Controller 2025 - Basic Multi-Channel SPI Controller 2025-05-14
- T-1000S LED Controller 2025 - Basic Single-Port Controller 2025-05-14