Buppaner – ぶっぱなー

By jojirushi

0+ active installationsVersion 1.2.0

Manage and insert WordPress ads using keywords, categories, tags, and content conditions.

Description

Buppaner is a WordPress plugin that helps you manage advertisement settings and automatically insert advertisements into your posts.

Configure advertisement HTML and insertion conditions from the WordPress admin dashboard. Buppaner helps you organize your advertisements and control where they appear on your website.

Key Features

  • Manage up to three advertisement settings in the free version.
  • Automatically insert advertisements into post content.
  • Configure insertion conditions using keywords, categories, tags, and content conditions.
  • Support compatible advertising and affiliate HTML snippets.
  • Handle Google AdSense loading and initialization through the plugin.
  • Convert certain dynamic affiliate HTML-writing scripts into static markup without executing JavaScript.
  • Detect existing advertisement-like HTML structures in post content to help avoid unintended duplication.
  • Preview advertisement placement in an isolated frame within the admin screen.

Advertisement Safety

  • Advertisement HTML is filtered using an explicit tag and attribute allowlist.
  • External scripts and iframes are restricted to approved advertising-network domains over HTTPS.
  • Inline JavaScript is not stored or output as advertisement HTML.
  • Advertisement previews are isolated from the WordPress admin page.

Buppaner is designed to make advertisement management easier while giving website owners control over their advertisement settings and insertion conditions.

Advertisement Placement

Ads are inserted only into front-end content of the public site. They are never inserted into WordPress admin pages (dashboard, post and page lists and editors, plugin list, add-plugin screen, themes, widgets, settings, and this plugin’s own screens), and they are never inserted into admin AJAX or REST responses that a browser renders inside wp-admin. Any advertisement markup left inside post content by an older version is stripped from admin and REST output before it reaches the browser. The advertisement preview inside this plugin’s admin screen is loaded in a sandboxed frame, so ad code shown there cannot read or change the admin page and cannot navigate it.

Initial Settings

The free admin screen provides three advertisement-setting cards. Only standard WordPress posts are enabled as the target post type by default. Existing saved settings are not overwritten automatically.

Author, Copyright, and License

Author: Jyoji

Except for third-party components identified separately, the Buppaner plugin code and original materials owned by the author in this distribution are provided under the GNU General Public License, version 2 or later (GPL-2.0-or-later). See the included LICENSE.txt for the license text.

The GPL applies only to rights held under applicable copyright law. It does not mean that the author owns or transfers rights to third-party libraries, services, trademarks, or materials subject to third-party rights.

Image Assets

The included card background images were created and selected by the author using generative AI tools. No third-party stock images are intentionally included. However, the author does not guarantee that AI-generated outputs are dissimilar to other works, free of third-party rights issues, or compliant with every applicable service’s terms. When distributing or using these assets, follow the applicable terms of each service used to generate them, including any content credential or attribution requirements. This notice does not constitute a guarantee of legal status for AI-generated content.

Third-Party Components

The admin interface uses jQuery and jQuery UI (Sortable) bundled with WordPress. These standard WordPress libraries are loaded locally and are not loaded from an external CDN.

Privacy

This plugin stores advertisement settings and post conditions on the WordPress site and does not send its settings data to external services. Admin scripts are loaded from the installed WordPress core. If an advertising service used with this plugin collects information separately, review that service’s privacy policy as well.

Support and Disclaimer

This software is provided “as is” without guarantees of suitability for a particular purpose or uninterrupted operation. Back up your site and database before use. Nothing in this disclaimer is intended to exclude liability that cannot be excluded by law.

External services

Buppaner does not send its saved settings, post content, or keyword conditions to an external service. If an administrator saves advertisement HTML that references a third-party advertising or affiliate provider, the visitor’s browser may connect directly to that provider when the advertisement is displayed. Those requests are handled by the provider and may be subject to its privacy policy. Administrators should review the provider’s terms and privacy documentation before using its advertisement code.

Advertisement HTML is filtered through an explicit tag and attribute allowlist before it is saved, and the same filtering runs again every time the stored HTML is inserted into post content. A value that is already in the database is never treated as safe. The allowlist does not depend on the user who saved the row: the WordPress unfiltered_html capability does not widen it, and inline JavaScript is never kept in saved or displayed advertisement HTML.

An external script or iframe embed is kept only when its source URL uses HTTPS, carries no port other than 443 and no user information, and its host is an official advertising-network domain on the plugin allowlist: googlesyndication.com, googleadservices.com, googletagmanager.com, doubleclick.net, amazon-adsystem.com, assoc-amazon.com, a8.net and moshimo.com, each with its subdomains. Only script loading attributes (src, type, charset, crossorigin, integrity, async, defer) survive. A site owner can register additional official hosts with the buppaner_ad_external_hosts filter. Sources from any other host, over HTTP, or with a scheme such as data: are removed.

Google AdSense units do not need site owners to keep inline JavaScript. When an AdSense block containing an ins element with class adsbygoogle and a publisher ID is output, the plugin generates the loader request to https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js and the (adsbygoogle = window.adsbygoogle || []).push({}) initialization itself, in a fixed form, instead of storing or echoing the script text that the saved HTML happened to contain.

Affiliate snippets that write one HTML string through document.write() (a common A8.net and もしもEasyLink format) are handled without executing any JavaScript: only the single quoted string of such a call is converted into static markup, which then goes through the same allowlist, and a script body containing anything else is removed.

Attributes that can carry behaviour are removed at both stages: event handlers, javascript:, vbscript:, data: and file: URLs inside URL attributes, and CSS declarations such as behavior, -moz-binding, expression() and @import. Rows stored by earlier releases of this plugin are filtered by these same rules when they are displayed, and the per-row script trust flag those releases recorded is discarded on the next save.

Installation

  1. In the WordPress admin dashboard, go to Plugins > Add New Plugin > Upload Plugin.
  2. Select this ZIP file, install it, and activate the plugin.
  3. Open Buppaner Settings in the admin dashboard to configure advertisements and insertion conditions.

FAQ

How many advertisements can I manage with the free version?

The free version provides three advertisement-setting cards. Each card can have its own advertisement HTML and insertion conditions.

Do I need to use all three advertisement cards?

No. You can use only the cards you need. Unused cards do not need to be configured or enabled.

How many keywords can I set for one advertisement?

You can specify up to three keywords per advertisement card. All specified keywords must match the post content. This uses AND matching, not OR matching.

Can I target posts using only a category or tag?

Yes. You can select one category and one tag per advertisement card. If no keyword is specified, selecting a category allows matching posts in that category to become candidates. Category, tag, and keyword conditions can also be combined.

What is the difference between inclusion and exclusion conditions?

Inclusion conditions select posts that may receive an advertisement. Exclusion conditions remove posts from those candidates. You can exclude posts using keywords, categories, tags, or individual post IDs.

How do multiple exclusion keywords work?

Multiple exclusion keywords use AND matching. A post is excluded only when all specified exclusion keywords are found in its content.

Can I exclude only one specific post?

Yes. You can enter the WordPress post ID in the exclusion settings to exclude an individual post.

Where can I place advertisements?

Each advertisement card supports four placement methods:

  • Automatic Optimization
  • After a Matching Keyword
  • At the Beginning of the Post
  • At the End of the Post

What does Automatic Optimization do?

Automatic Optimization evaluates possible positions in the post and selects a suitable location based on the plugin’s placement logic. You can adjust its strength using five levels. If no suitable position is found, the advertisement may be skipped.

Can I control which advertisement is inserted first?

Yes. Advertisement cards are processed according to their order in the settings screen. Cards nearer the top have higher priority. You can change their order by dragging and dropping the cards.

What happens when an advertisement limit is reached?

Buppaner can limit the total number of advertisements in a post. The count includes existing advertisements and advertisements managed by Buppaner. Advertisements that exceed the configured limit are not inserted.

Can I set a different advertisement limit for each card?

Yes. You can set an individual limit for each advertisement card. When an individual limit is specified, it takes priority over the global limit for that card. If the individual limit is left blank, the global limit is used.

Does Buppaner detect advertisements that are already in my posts?

Buppaner analyzes HTML structures in post content to identify existing advertisement-like markup, including recognizable advertising elements, scripts, and iframes. It can show detected advertisement counts and positions in the preview.

Does existing advertisement detection recognize every advertisement format?

No. Detection is based on recognizable HTML structures and patterns. Shortcodes are not treated as existing advertisements because not every shortcode represents an advertisement. Custom or unusual formats may not be detected.

Does Buppaner automatically delete or replace existing advertisements?

No. Existing-advertisement detection is for identifying and reviewing advertisements. It does not automatically delete or replace the original advertisement code.

How can I check where an advertisement will appear before applying it?

You can use the preview feature to review planned insertion positions and detected existing advertisements. The preview is displayed in an isolated frame within the plugin’s admin screen.

Why is my advertisement not being inserted?

Check the following items:

  • The advertisement card is enabled.
  • Required advertisement HTML and conditions are configured.
  • The post matches all specified inclusion conditions.
  • The post does not match the exclusion conditions.
  • The advertisement limit has not been reached.
  • A suitable insertion position is available.
  • The advertisement HTML does not contain invalid or unsupported markup.

After changing settings, click Save & Apply to apply them.

What does the card status mean?

The card status indicates its current configuration and application state. It helps you identify whether a card is ready to apply, currently applied, disabled, duplicated, or contains an HTML error.

What happens if I disable an advertisement card?

Disabling a card marks its applied advertisement for removal. Click Save & Apply to apply the change.

Can I customize the appearance of the advertisement cards?

The free version includes three built-in card background styles. The available choices are provided in the plugin settings.

Does Buppaner modify my original post content?

Buppaner inserts advertisements into the front-end output of post content. It does not require you to manually insert advertisement markup into each post. Existing advertisement markup in posts remains separate from the plugin’s advertisement settings.

Does Buppaner send my post content or advertisement settings to external services?

No. Buppaner stores its advertisement settings and post conditions on your WordPress site and does not send them to external services. However, a visitor’s browser may connect directly to an advertising or affiliate provider referenced by your advertisement HTML.

Can I use advertising HTML from external providers?

Buppaner supports compatible advertising and affiliate HTML snippets. Advertisement HTML is filtered through an allowlist. External scripts and iframe embeds are restricted to approved HTTPS advertising-network domains. Inline JavaScript is not stored or output as advertisement HTML.

Does Buppaner support Google AdSense?

Buppaner supports compatible Google AdSense units. The plugin generates the required AdSense loader and initialization code when a supported AdSense block is displayed. You should still configure your AdSense account and advertising units correctly.

What happens to my existing settings when I update the plugin?

Existing saved settings are not automatically overwritten by installation or updates. However, advertisement HTML saved by older versions is filtered using the current security rules when displayed.

Does Buppaner work with custom post types?

The free version targets standard WordPress posts by default. Other post types are not enabled by default.

Where can I get help or report a problem?

Please use the developer’s contact page to report problems or request support. Include your WordPress version, PHP version, and a description of the issue when possible.

Changelog

1.2.0

  • Advertisement HTML: the per-row script trust flag and the unfiltered_html exception are removed. Saved advertisement HTML is filtered by one explicit allowlist at save time and again on output; external scripts and iframes are limited to the official advertising-network hosts over HTTPS; inline JavaScript is never stored or printed.
  • Advertisement HTML: Google AdSense loading and initialization are generated by the plugin through WordPress script enqueue APIs, so existing AdSense units keep working without stored inline JavaScript or raw script tags in post content.
  • Advertisement HTML: supported affiliate document.write snippets are converted to static markup instead of being executed.
  • Content filter: when no advertisement row is enabled, or when nothing is actually inserted, the original post content is returned unchanged instead of being rebuilt.
  • Internationalization: the gettext text domain and plugin header are aligned with the WordPress.org slug, buppaner.
  • Settings and preview JSON: request structure, allowed keys, value types and values are validated; malformed, oversized or deeply nested JSON is rejected, and AJAX responses no longer return internal fields.