Monetize Me
| 开发者 |
shahalom
microsolutions |
|---|---|
| 更新时间 | 2026年8月5日 23:43 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Monetize Me is a modular, option-based advertising manager for Google AdSense and other trusted third-party monetization code. It does not register a custom post type or taxonomy.
The plugin provides four top-level settings tabs:
- Ads
- Ad Categories
- Sponsors
- Placements
- Header Ads (
header-ads) - Footer Ads (
footer-ads) - In-article Ads (
in-article-ads) - Sidebar Ads (
sidebar-ads)
general). The records are editable and removable.
Main features:
- Manage ad categories and sponsors independently.
- Save trusted Google AdSense, script, iframe, HTML, or other monetization code.
- Assign one category and one sponsor to each ad.
- Enable or disable individual ads.
- Keep saved ad cards collapsed initially and expand or collapse them from their headers for easier management of large ad libraries.
- Randomly select one enabled ad when several ads match the requested filters.
- Render ads through the
[mmps]shortcode. - Render ads through the dynamic Advertisement Gutenberg block.
- Map categories and sponsors to supported theme action hooks.
- Insert ads between archive items using random intervals or exact positions.
- Insert ads before content, after content, and between paragraphs.
- Select which public post types receive automatic Post Content Ads.
- Optionally enqueue the bundled frontend stylesheet.
- Extend selection, placement, and rendering with public functions, actions, and filters.
安装:
Single-site WordPress
- Upload the
monetize-medirectory to/wp-content/plugins/, or install the ZIP from Plugins > Add New > Upload Plugin. - Activate Monetize Me from the Plugins screen.
- Open the top-level Monetize Me menu.
- Review the starter categories and the General sponsor.
- Open Ads, create an ad, select its category and sponsor, paste trusted monetization code, enable the ad, and save. Saved ad cards load collapsed; click a card header whenever you need to edit its details.
- Use the shortcode or Gutenberg block, or configure theme and automatic placements from Placements.
- Install the plugin from Network Admin > Plugins > Add New, or upload the
monetize-medirectory to/wp-content/plugins/. - Network activate Monetize Me.
- Open Network Admin > Monetize Me.
- Create and manage the shared categories, sponsors, ads, and placements there.
- Individual sites do not receive a separate Monetize Me settings page.
- Confirm that the required category and sponsor exist.
- Create an ad and select both records.
- Paste code only from a trusted ad provider or advertiser.
- Enable the ad and save.
- Add
[mmps adcategory="category-slug" adsponsor="sponsor-slug"]to content, insert the Advertisement block, or configure a placement. - Clear page caches after changing ad code or placement settings.
屏幕截图:
常见问题:
Why are my saved ad fields hidden on the Ads page?
Saved ad cards are collapsed initially to prevent a large ad library from making the settings page unnecessarily tall. Click the ad card header to expand or collapse its fields. Clicking Remove deletes the card without toggling it. A newly added ad opens automatically for editing.
Why is no ad displayed?
Confirm that the ad is enabled and that its selected category and sponsor match the shortcode, block, hook, or automatic placement filters. Also clear page and CDN caches. For responsive Google AdSense units, keep the bundled frontend CSS enabled unless the theme gives .monetize-me and .ad-wrapper a non-zero measurable width. In browser developer tools, an AdSense error mentioning availableWidth=0 indicates a container-width problem.
Does Monetize Me add <br> tags to ad scripts?
No. The plugin does not run saved ad code through wpautop(), nl2br(), KSES, or HTML escaping during frontend rendering.
Why does the block editor not show the live advertisement?
The editor intentionally displays a safe configuration preview so third-party scripts and iframes do not execute inside the editor. The selected ad is rendered dynamically on the frontend.
Can I disable the plugin CSS?
Yes. Disable Load the Monetize Me frontend CSS file from Monetize Me > Placements > Frontend Styles.
Where are settings stored on Multisite?
One network option stores all categories, sponsors, ads, and placements. Individual sites do not have separate settings pages.
Are settings removed when the plugin is deactivated or deleted?
No. Monetize Me preserves its settings option on both deactivation and uninstall so the existing categories, sponsors, ads, and placements are available if the plugin is installed or activated again.
Can a theme add another placement hook?
Developers can filter monetize_me_theme_placements to register another action name, then call that action in the theme. The custom hook appears in the Placements mapping table.
更新日志:
3.0.3
- Collapsed saved ad cards initially on the Ads page to keep large ad libraries compact and easier to scan.
- Added accessible header-based expand/collapse controls, an animated state indicator, and independent Remove behavior.
- Opened newly added ad cards automatically so their fields are immediately available for editing.
- Fixed responsive Google AdSense units failing to render when the flex-based wrapper collapsed the initially empty
adsbygoogleelement to zero width. - Replaced the frontend flex wrapper with a full-width block layout that remains compatible with responsive AdSense and fixed-size third-party ads.
- Added explicit width, max-width, min-width, box-sizing, and responsive
.adsbygooglesafeguards. - Expanded frontend CSS and troubleshooting documentation for AdSense
availableWidth=0errors.
- Added optional CSS classes to theme action hooks and placement rendering APIs.
- Upgraded the plugin release version to 3.0.0.
- Resolved Plugin Check findings for direct nonce verification, one-time request unslashing, prefixed template variables, block API version 3, translator comments, and WordPress.org translation loading.
- Completed a repository-readiness review of capabilities, nonces, sanitization, escaping, asset loading, dynamic block registration, and uninstall behavior.
- Preserved all plugin settings during deactivation and uninstall for future reactivation or reinstallation.
- Preserved submitted monetization code without adding
<br>tags or applying automatic paragraph formatting. - Corrected unauthorized-request handling to return an HTTP 403 response.
- Improved block editor data loading with JSON-encoded inline script data.
- Made filtered custom theme placement hooks safe when no built-in default mapping exists.
- Added comprehensive installation, activation, shortcode, block, theme-hook, public API, raw-code, Multisite, and troubleshooting documentation.
- Added a GPLv2 license file.
- NEW: Added Network Admin tool to copy all
adCPT posts from one site to one or more selected destination subsites. - NEW: Ad copy operation skips destination posts when the same
adslug already exists. - NEW: Copied Ad posts preserve content, excerpt, status, menu order, custom fields, and assigned Monetize Me taxonomy terms.
- NEW: Missing destination
adcategoryandadsponsorterms are created automatically while copying Ads. - SECURITY: Restricted Ad copy workflow to Network Administrators using nonce verification and
manage_network_optionschecks.
- NEW: Network Admin settings page for Multisite environments.
- NEW: Copy taxonomy terms (
adcategory,adsponsor) from a source site to selected subsites. - NEW: Bulk subsite selection for term synchronization.
- IMPROVED: Duplicate detection using term slug (skip existing terms).
- IMPROVED: Operation summary showing copied, skipped, and failed counts.
- SECURITY: Restrict term synchronization tools to Network Admin only.
- Added a centralized Ad_Service class used by shortcode, widget, block, and renderer layers
- Added cache-aware ad queries with automatic cache purging on ad save, delete, and taxonomy changes
- Added public helper API functions: monetize_me_get_ad(), monetize_me_get_random_ads(), monetize_me_render_ad(), mm_get_ad(), mm_get_random_ad(), and mm_render_ad()
- Added internal filters and actions for query arguments and rendered output
- Preserved backward compatibility for existing shortcode, widget, block, and Renderer::render() usage
- Major internal refactor for maintainability
- Added modern plugin bootstrap structure
- Removed runtime rewrite flushing
- Improved shortcode normalization and rendering
- Fixed widget slug handling bug
- Modernized block registration structure
- Added safer uninstall behavior
- Updated readme and repository packaging
- Revert back the ad sponsor taxonomy
- Recreated the plugin by removing legacy width and height taxonomies
- Added Ad Category taxonomy
- Added Gutenberg block support