Sanil Ads Kit

开发者	sonill
更新时间	2026年10月13日 16:41
PHP版本:	8.1 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

详情介绍:

Sanil Ads Kit is a lightweight, performance-focused WordPress ad management plugin. Create and display banners, image ads, custom HTML/JS ads, iframes, and Google AdSense — then control exactly where and when they appear using flexible placements, scheduling, and targeting conditions. Whether you're running a personal blog, a content-heavy publication, or a client site, Sanil Ads Kit gives you full control over your advertising without slowing down your site. Learn more at sanil.app/sanil-ads-kit. Step-by-step guides and tutorials are in the documentation. Key Features Ad Creation & Management

Create image ads, custom HTML/JS/CSS ads, iframes, and Google AdSense units
Upload ad images directly from the WordPress Media Library
Set custom dimensions, margins, and alignment (left, center, right, float)
Control ad visibility per device — desktop, mobile, or both Ad Groups & Rotation
Group multiple ads together for A/B testing or campaign rotation
Supports sequential and random rotation modes
Give each ad a priority: higher-priority ads come first in sequential rotation and are picked more often in random rotation
Control how many ads are visible per group at once
Horizontal or vertical group layout options Ad Placements
Inject ads into specific positions across your site without touching theme files
Supports before content, after content, after the first paragraph, the site footer, popup and skip-ad overlays, and manual placement
Place manual placements with the [amkit_ad_placement] shortcode, the amkit_ad_placement() template function, or do_action( 'amkit_ads_placement', 'placement-id' )
Assign individual ads or entire groups to a placement
Duplicate and manage placements from a clean admin interface Scheduling
Set an expiry date and time for any ad, and use WordPress's scheduled publishing for a start date
Ads automatically go live and expire on schedule — no manual intervention needed
Timezone-aware scheduling using your WordPress site timezone Targeting & Conditions
Show or hide ads based on post type, specific pages, categories, tags, any public taxonomy, author, post format, page template, parent page, content age, archive type, and more
Add several conditions per ad: ads show when any "is" condition matches, and any matching "is not" condition hides them
Show an ad on desktop only, mobile only, or all devices
Fine-grained control without writing custom code Popup & Skip Ads
Built-in popup ad overlay support
Skip ad countdown timer for interstitial-style ads Flexible Display Options
Shortcodes — embed ads, groups and placements anywhere with [amkit_ad], [amkit_ad_group] and [amkit_ad_placement]
Gutenberg Block — insert ads directly in the block editor
Template Functions — developer-friendly PHP functions for theme integration
Placements — automatic injection with zero code Analytics
Track impressions, clicks, and click-through rate (CTR) for every ad
Views, Clicks and CTR columns right in the All Ads list, sortable so you can see your best performers at a glance
Per-ad report on the ad edit screen: daily chart, countries, pages, and peak click hours, for 7, 30 or 90 days or a custom date range
Country detection uses a bundled local database — no external service, and visitor IP addresses are never stored
Sends ad_impression and ad_click events to Google Analytics (gtag.js) or Google Tag Manager when either is already on your site Developer Friendly
Clean namespace-based PHP architecture (PSR-4)
Hooks and filters for extensibility (for example amkit_group_ads_query_args, amkit_server_side_device_filter and amkit_ad_rendered)
No jQuery dependency in frontend output
Minimal CSS footprint — easy to style to match your theme

安装:

Upload the sanil-ads-kit folder to /wp-content/plugins/.
Activate the plugin via the Plugins menu in WordPress.
Navigate to Sanil Ads Kit in the WordPress admin sidebar.
Create your first ad under Sanil Ads Kit → All Ads → Add New.
Optionally configure placements under Sanil Ads Kit → Placements to auto-inject ads sitewide.

屏幕截图:

升级注意事项:

1.0.1

Updates the plugin homepage and documentation links. No functional changes.

1.0.0

Initial release.

常见问题:

Does it support Google AdSense?

Yes. Use the AdSense ad type to paste your AdSense code directly. Admins with the unfiltered_html capability can enter raw script tags.

Can I rotate multiple ads in the same spot?

Yes. Create an Ad Group, add your ads to it, choose sequential or random rotation, and assign the group to a placement or shortcode.

How do I display an ad inside a post?

Use the shortcode [amkit_ad id="123"] (or [amkit_ad_group id="4"] for a group) or insert a Sanil Ads Kit Gutenberg block in the post editor.

Can I show ads only on certain pages?

Yes. Each ad has a Targeting section where you can set conditions based on post type, specific pages, categories, tags, taxonomies, author, post format, page template, parent page, content age and archive type. The Show On field limits an ad to desktop or mobile visitors. Targeting by user role is not available.

How do I add an ad to my theme template?

Use the template function <?php amkit_ad_group( 'your-group-slug' ); ?> or <?php amkit_ad_placement( 'placement-id' ); ?> anywhere in your theme files.

Will it slow down my site?

No. The plugin is built for performance. On the front end it loads one small stylesheet (about 2 KB, under 1 KB compressed) and, only on pages that display an ad, a small analytics script (about 2 KB compressed). Neither needs jQuery; the popup/skip-ad stylesheet and script load only when you have created a popup or skip-ad placement. The heavier admin scripts load only on the plugin's own screens.

How do I see how my ads are performing?

The All Ads list shows all-time views, clicks and CTR for every ad, and you can sort by any of them. Open an ad to see its detailed report (daily chart, countries, pages and peak click hours) in the Analytics box.

How are views and clicks counted?

A view is counted when at least half of an ad is visible in the visitor's browser, at most once per ad per browser session. A click is counted each time a visitor clicks an ad's link. Counts are grouped by hour, ad, page and country.

Does analytics work with page caching?

Counting happens in the visitor's browser, so cached pages are still tracked. Page caches can serve a page after the security token embedded in it has expired (typically 12–24 hours); if you see tracking stop on heavily cached pages, shorten the cache lifetime.

Does analytics store personal data?

No IP addresses, cookies or user identifiers are stored. See the Privacy section below.

Does it work with page builders like Elementor or Divi?

Yes. You can use shortcodes in any page builder that supports shortcode widgets or text blocks.

Is it compatible with caching plugins?

Yes. Ads are output as plain HTML, so they work with caching plugins. Because targeting conditions and the desktop/mobile setting are evaluated when the page is built, a page cache will keep serving the version it first stored. If you use Show On (desktop/mobile) together with full-page caching, either vary the cache by device or return false from the amkit_server_side_device_filter filter so every ad is output and CSS hides the wrong one.

Where can I find the documentation?

Step-by-step guides, tutorials and troubleshooting articles are at sanil.app/help/sanil-ads-kit.

Where can I report a bug or request a feature?

Please open a thread in the WordPress.org support forum for this plugin. You can also reach out through sanil.app/support.

How does clean uninstall work?

Enable the "Action on uninstall" option in plugin settings, then delete the plugin from the WordPress Plugins screen. This permanently removes all ads, ad groups, placements, analytics data and plugin settings. Cleanup only runs during WordPress uninstall flow. Manual folder deletion (FTP/file manager) does not trigger uninstall hooks.

更新日志: