外掛說明

Iteearmah Ad Rotation and Analytics is a powerful and lightweight advertisement management system for WordPress. It allows you to create, manage, and track advertisements with ease.

Key Features:

Custom Ad Management — Create ads as custom post types with full control.
Ad Rotation — Weighted rotation system to serve ads based on priority.
Impression & Click Tracking — Detailed tracking with 7-day statistics and analytics dashboard.
Geo-Targeting — Include or exclude ads based on the visitor’s country.
Device Targeting — Target ads by device type (Mobile, Tablet, Desktop).
Ad Zones — Group ads into zones for targeted placement.
Scheduling — Set start and end dates for your ad campaigns.
Capping — Set impression and click limits for each ad.
Duplicate Ads — Quickly clone existing advertisements with one click.
Ad Status Toggle — Easily enable or disable ads without deleting them.
Dashboard Widget — Quick overview of total impressions, clicks, and CTR.
Export/Import — Backup or migrate your advertisements and settings via JSON.
User Access Control — Granular control over who can manage ads.
Analytics Reports — Professional reporting dashboard with charts and CSV export.
AJAX Serving — Non-blocking, asynchronous ad delivery via WordPress AJAX.
Shortcode Support — Place ads using shortcodes or script tags.

Dependencies:

This plugin requires the Secure Custom Fields (formerly ACF) plugin to be installed and active. An admin notice will be displayed if the dependency is missing.

螢幕擷圖

Ad management list view with status indicators and quick stats.

Ad editor with scheduling, capping, geo-targeting, and device targeting options. — Ad management list view with status indicators and quick stats.

安裝方式

Upload the iteearmah-ad-rotation-analytics folder to the /wp-content/plugins/ directory.
Activate the plugin through the ‘Plugins’ menu in WordPress.
Install and activate the Secure Custom Fields plugin.
Go to Iteearmah Ad Rotation and Analytics in your admin menu to start creating ads.

常見問題集

How do I display an ad?

Use the shortcode [itea_adserver zone="your-zone-slug"] in any post or page. To find the zone slug, go to Iteearmah Ad Rotation and Analytics > Ad Zones.

How do I track statistics?

Statistics for each ad are displayed in the “Ad Statistics” meta box when editing an ad, as well as in the main Ads list view.

How do I use Ad Zones?

Go to Iteearmah Ad Rotation and Analytics > Ad Zones and create a new zone (e.g., “Sidebar”).
Note the Slug of the zone you created.
Edit an advertisement and select the zone from the Ad Zones box on the right.
Use the shortcode [itea_adserver zone="sidebar"] (replace “sidebar” with your slug) to display ads from that zone.
You can also use <div id="itea-ad-sidebar"></div><script src="https://your-site.com/?itea_ad_serve=1&zone=sidebar&uid=itea-ad-sidebar" async></script> for remote placement.

Does this plugin require any external services?

No. Geo-targeting relies on server-provided HTTP headers (e.g., HTTP_X_COUNTRY_CODE) typically set by your hosting provider or a CDN like Cloudflare. No external API calls are made.

What happens if Secure Custom Fields is not installed?

An admin notice will be displayed prompting you to install the required plugin. Core ad management features will not function without it.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Iteearmah Ad Rotation and Analytics〉的開發相關工作。

iteearmah

將〈Iteearmah Ad Rotation and Analytics〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。

變更記錄

2.0.0

Compliance: Updated plugin to adhere to WordPress.org detailed guidelines.
Compatibility: Updated “Tested up to” metadata to WordPress 7.0.
Security: Hardened admin notice visibility logic and refined ad export safety.
Device Detection: Improved reliability by integrating wp_is_mobile() as a baseline.
Maintenance: Bumped version to 2.0.0.

1.9.2

Maintenance: Created .gitattributes file for better archive management.
Maintenance: Bumped version to 1.9.2.

1.9.1

Maintenance: Updated .distignore to include .idea directory.
Maintenance: Bumped version to 1.9.1.

1.9.0

Security hardening: Improved nonce verification across several admin and tracking functions.
Security hardening: Enhanced input sanitization for role capabilities and file uploads.
Code Quality: Resolved multiple WordPress Coding Standards (WPCS) warnings and PHPCS violations.
Code Quality: Improved SQL query safety by ensuring proper placement of PHPCS annotations for dynamic table names.
Maintenance: Cleaned up project structure by removing unnecessary configuration files.

1.8.3

Added safety checks for get_field() and acf_add_local_field_group() to prevent crashes when Secure Custom Fields is not active.
Refined cache clearing logic to target only the plugin’s custom post type.
Improved performance in the reporting dashboard by limiting ad filtering to the 100 most recent ads.
Standardized asset versioning to use the plugin’s version constant.
Hardened dependency checks to support both ‘Secure Custom Fields’ and standard ‘ACF’ naming conventions.
Updated bundled Chart.js to the latest stable version.
Replaced direct script tags with WordPress enqueue APIs for reports and shortcode rendering.

1.7.2

Removed external dependency on Chart.js CDN.
Included Chart.js locally in the plugin to comply with WordPress.org guidelines.

1.7.1

Renamed plugin to “Iteearmah Ad Rotation and Analytics” and updated slug to “iteearmah-ad-rotation-analytics”.
Updated text domain to “iteearmah-ad-rotation-analytics”.

1.7.0

Removed hidden .gitkeep file from languages directory to comply with WordPress.org guidelines.
Added index.php to languages directory to maintain the folder structure safely.

1.6.0

Finalized text domain migration to “adserver” across all files.
Verified WordPress.org automated scan fixes and bumped version for clean submission.

1.5.0

Fixed automated plugin scan issues: added sanitize_callback to register_setting() calls.
Updated “Tested up to” to WordPress 7.0.
Changed Text Domain to “adserver” to match plugin slug.
Created languages directory for Domain Path compliance.

1.4.0

Renamed plugin display name from “WP Iteearmah Ad Rotation and Analytics” to “Iteearmah Ad Rotation and Analytics” for WordPress.org directory compliance.

1.3.0

Security audit: added input sanitization, output escaping, and URL validation across all files.
Hardened click redirect with wp_http_validate_url() and wp_safe_redirect() fallback.
Secured import functionality with uploaded file checks and post data sanitization.
Replaced json_encode with wp_json_encode and date() with gmdate() for best practices.
Added Text Domain and Domain Path headers for i18n compliance.
Added proper cleanup of tracking table and transients on uninstall.
Updated git configuration files (.gitignore, .gitattributes, .distignore, .editorconfig).

1.2.0

Fixed ad serving reliability for non-public post types in AJAX contexts using direct database queries.
Improved cache invalidation with versioned transients and hooks for all ad status changes.
Enhanced administrator debug output with visitor context, filtering reasons, and ad status details.
Standardized zone slug handling to lowercase across shortcodes and AJAX handlers.
Added .gitattributes with export-ignore directives for clean distribution archives.

1.1.0

Added professional analytics reporting dashboard with interactive charts.
Added CSV export functionality for reporting data.
Migrated tracking to a custom database table for high-traffic performance.
Added duplicate ad, ad status toggle, and dashboard stats widget.
Added nonce verification and capability checks for settings.
Improved input sanitization and output escaping.
Added translation wrappers for core strings.
Refined admin notices and simplified the readme changelog.
Updated Access Configuration with user selection and SCF dependency enforcement.

1.0.0

Initial release.
Modular architecture for better maintainability.
Custom post type itea_ad for structured ad management.
Weighted rotation system using [itea_adserver] shortcode.
Advanced geo-targeting capabilities.
Ad scheduling and performance capping (impressions/clicks).
Zone-based ad delivery.
Detailed impression and click tracking with admin dashboard statistics.