=== Digital Portal Companion ===
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free advertising shortcodes for Digital Portal. No Freemius license, account connection or paid plugin is required.

== Installation ==

1. In Plugins > Add New > Upload Plugin, upload digital-portal-companion-1.0.0.zip and activate it. Install the separate Digital Portal theme ZIP under Appearance, not under Plugins.
2. In Appearance > Customize > Digital Portal - Advertising, enable and configure the desired position, then Publish.
3. Add [dp_ad slot="article-bottom"] or [dportal_ad slot="article-bottom"] in a WordPress Shortcode block or Elementor Free Shortcode widget. Use the stable slot ID from the theme's advertising guide.
4. Open the published page and check the configured device and AMP variant. A disabled, empty, unknown or excluded placement produces no output.

The plugin delegates to the theme's public renderer. It accepts no provider scripts through shortcode attributes and does not alter advertising permissions, settings, exclusion rules, device targeting or consent behavior. The theme supplies all CSS, scripts and advertising configuration. Automatic theme positions, classic advertising widgets and the Elementor Ad Slot widget do not require this companion.

== Theme changes and removal ==

With another theme active, these shortcodes return an empty string without an error. Reactivating Digital Portal restores its existing configured placements. Other plugins' already registered callbacks are preserved. Deactivating or deleting this companion does not delete posts, settings, ads, accounts or licenses. WordPress may display literal shortcode text while its registering plugin is inactive; remove its tags from content before permanently deactivating it.

== Distribution and updates ==

This is a separate free GPL package supplied with Digital Portal, not an entry in the WordPress.org directory. Obtain future ZIP updates from the theme owner and replace this plugin through WordPress's plugin uploader. Directory auto-updates are intentionally disabled by Update URI: false. There are no remote requests or telemetry in the plugin.

== Changelog ==

= 1.0.0 =
* Move the dp_ad and dportal_ad shortcode registrations out of the theme into a free, guarded companion plugin.
