doublesecretagency / craft-adwizard
Easily manage custom advertisements on your website.
Installs: 17 508
Dependents: 0
Suggesters: 0
Security: 0
Stars: 7
Watchers: 4
Forks: 8
Open Issues: 21
Type:craft-plugin
Requires
- craftcms/cms: ^5.0.0
README
Ad Wizard plugin for Craft CMS
Easily manage custom advertisements on your website.
For complete documentation, see plugins.doublesecretagency.com/ad-wizard
Create Ads
Manage your ads in the Craft control panel by clicking the "Ad Wizard" tab.
Before you can create any Ads, you will first need to create at least one Group. Every ad you create will belong to a specific group. Once you've created your ads, you'll then be able to embed them into your Twig templates.
Embed Ads
You have two Twig tags available to you...
Render a random ad from a specific group. Specify the group by its handle.
{{ craft.adWizard.randomizeAdGroup('rightSidebar') }}
Render a single, specific ad. Specify the ad by its ID number.
{{ craft.adWizard.displayAd(42) }}
Both methods can display an ad until:
- The ad expires, or
- The ad reaches the maximum allowed impressions, or
- The ad is manually disabled.
Read more about embedding ads...
Track Views & Clicks
From the control panel Dashboard, click the settings icon. You can click the "New Widget" button to add a new widget to your dashboard.
Two new widget types will be available to you:
- Ad Timeline - A line chart showing the view/click trends of a single ad over time.
- Group Totals - A bar chart showing the total views/clicks for each ad in a specified group.
Read more about seeing your ad statistics...
Use Image Transforms (supports Retina display)
You can easily apply an image transform to your ads...
{{ craft.adWizard.randomizeAdGroup('rightSidebar', { 'image': { 'transform': 'large', 'retina': true } }) }}
Read more about image transforms...
Further Reading
If you haven't already, flip through the complete plugin documentation.
And if you have any remaining questions, feel free to reach out to us (via Discord is preferred).
On behalf of Double Secret Agency, thanks for checking out our plugin! 🍺