ADStn Platform Hub & Monetization Suite for WordPress

The premier all-in-one WordPress suite connecting ADStn™ platform services to WordPress: Smart Ad Monetization, OAuth 2.0 Single Sign-On (SSO), Interactive Profile & Video Widgets, Viral Share Bar, and Auto-Poster Synergy.

🌐 Official Website • 📚 Developer API Documentation • 🚀 Report Issue

📖 Table of Contents

• Overview
• Key Features
  • 1. Smart Ad Monetization & Traffic Exchange
  • 2. OAuth 2.0 Single Sign-On (SSO)
  • 3. Interactive Embeds & Shortcodes
  • 4. Viral Social Share Bar
  • 5. Marketplace & Community Hub
  • 6. Seamless Synergy with ADStn Auto Poster
• Architecture & Security
• Requirements
• Installation
• Quick Start Guide
• Shortcode Cheat Sheet
• Developer Hooks & Filters
• Internationalization & RTL
• External Services Disclosure
• Contributing
• License

🌟 Overview

ADStn Platform Hub is engineered for creators, publishers, and site owners who want to seamlessly integrate their WordPress websites with the ADStn Network Platform (adstn.ovh).

It bridges high-performance monetization with community-driven user engagement, offering lightning-fast caching, zero-bloat modular architecture, and developer-friendly extensibility.

✨ Key Features

1. Smart Ad Monetization & Traffic Exchange

• Official Smart Ads Integration: Native support for ADStn responsive ad tags (smart.js?ID=...).
• Automated Ad Placements: In-content smart insertion (after paragraph N), Header, Footer, and Sidebar.
• Sticky Floating Bar: High-converting floating ad banner with smooth slide-up animation and close button.
• Live Performance Analytics: Real-time impressions and clicks synced from the ADStn Developer API.
• Gentle Anti-AdBlock Detection: Modal notification encouraging visitors to whitelist your site.

2. OAuth 2.0 Single Sign-On (SSO)

• 1-Click Social Login: Seamless "Log in with ADStn" button on wp-login.php, WooCommerce checkout/account pages, and custom shortcodes.
• Instant Provisioning: Automatically registers new users with verified email, display name, and avatar.
• Avatar & Profile Sync: Replaces default Gravatar with the user's verified ADStn profile picture.
• Customizable Button Themes: Modern Neon Glassmorphism, Dark Stealth, or Classic Flat.

3. Interactive Embeds & Shortcodes

• Profile Card ([adstn_profile]): Showcase your verified creator badge, avatar, bio, follower count, and cover banner.
• Interactive Follow Button ([adstn_follow]): AJAX-powered 1-click follow toggle directly from your articles.
• Short Video Clips ([adstn_clips]): Responsive video carousel with view counters and playback modals.
• Live Content Stream ([adstn_content_feed]): Embed your real-time ADStn channel timeline.

4. Viral Social Share Bar

• High-Speed Share Engine: Native ADStn Share integration (https://www.adstn.ovh/share) plus WhatsApp, Telegram, Facebook, X (Twitter), LinkedIn, and 1-Click Copy Link.
• Versatile Placements: Inline (Top, Bottom, Both) and Floating Vertical Bar (Left or Right with responsive auto-hide on mobile).
• Modern Aesthetic: Hexagon, Rounded, or Circular button geometry with micro-animations.

5. Marketplace & Community Hub

• Marketplace Embed ([adstn_store_products]): Display your latest digital products, themes, or services.
• Community Forums ([adstn_forum_topics]): Stream trending community topics and reply metrics.
• Gamification Widgets ([adstn_wallet], [adstn_badges]): Display member reward points and achievement badges.

6. Seamless Synergy with ADStn Auto Poster

• Cross-Plugin Bridge: Automatically detects if adstn-auto-poster is active.
• 1-Click Credential Sync: Shares OAuth tokens and API secrets across both plugins without duplicate configuration.
• Cache Invalidation on Publish: Automatically clears transient cache whenever Auto Poster publishes a new article.

🔒 Architecture & Security

• Secure OAuth 2.0 Flow: Uses cryptographic state nonces and transient verification against CSRF attacks.
• WordPress Security Standards: Strict user capability checks (current_user_can('manage_options')), nonces on all AJAX endpoints, input sanitization (sanitize_text_field, esc_url_raw), and output escaping (esc_html, esc_attr, esc_url).
• Intelligent Transients Caching: Honors the ADStn API rate limit (30 requests/min per IP) via configurable transient caching (TTL 10–60 minutes).
• Zero Database Bloat: Clean uninstall routine (uninstall.php) completely wipes options and transients when configured.

📋 Requirements

• WordPress: 5.8 or higher (Fully tested up to 6.7)
• PHP: 7.4, 8.0, 8.1, 8.2, or 8.3
• PHP Extensions: cURL, OpenSSL, JSON, MBString
• ADStn Account: Active account on adstn.ovh (Free)

📥 Installation

Method 1: WordPress Admin Dashboard

1. Go to Plugins > Add New in your WordPress admin.
2. Search for ADStn Platform Hub or click Upload Plugin and choose the adstn-platform-hub.zip file.
3. Click Install Now and then Activate.

Method 2: Manual FTP / SFTP

1. Download or clone this repository.
2. Upload the adstn-platform-hub directory to your WordPress /wp-content/plugins/ directory.
3. Activate the plugin in Plugins > Installed Plugins.

🚀 Quick Start Guide

1. Navigate to ADStn Hub in your WordPress admin menu.
2. In the Connection & Bridge tab, enter your Client ID and Client Secret (obtained from ADStn Developer Console).
3. Alternatively, click Sync from Auto Poster if credentials already exist in adstn-auto-poster.
4. Click Authorize with ADStn to grant API permissions.
5. Head over to the Ad Monetization, Social Login (SSO), Widgets, and Share Buttons tabs to customize your settings.

🏷️ Shortcode Cheat Sheet

🧩 Developer Hooks & Filters

Action Hooks

// Fired when an ADStn user successfully signs in via SSO
add_action( 'wp_login', function( $user_login, $user ) {
    $adstn_id = get_user_meta( $user->ID, 'adstn_user_id', true );
    if ( $adstn_id ) {
        // Custom logic for ADStn members
    }
}, 10, 2 );

// Fired when Auto Poster completes publishing (triggers cache refresh)
add_action( 'adstn_post_published_success', function( $post_id, $response ) {
    // Custom post-publish handler
}, 10, 2 );

Filters

// Customize API request language
add_filter( 'locale', function( $locale ) {
    return $locale;
} );

// Customize widget titles
add_filter( 'widget_title', function( $title ) {
    return $title;
} );

🌍 Internationalization & RTL

The plugin is 100% translatable and includes built-in translations:

• English (en_US) - Default
• Arabic (العربية - ar) - Bundled PO/MO with full RTL interface
• French (Français - fr_FR) - Bundled PO/MO

A complete .pot template is located in the /languages/ directory for community contributions via Poedit or Loco Translate.

🌐 External Services Disclosure

This plugin interacts with external APIs provided by ADStn Network Platform:

• Service: ADStn Developer Platform & APIs
• Website: https://www.adstn.ovh
• Terms of Service: https://www.adstn.ovh/terms
• Privacy Policy: https://www.adstn.ovh/privacy
• API Documentation: https://www.adstn.ovh/developer/guides

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

1. Fork the Project (https://github.com/ADStn-Network/adstn-platform-hub/fork)
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the GNU General Public License v2.0 or later. See LICENSE.txt for more information.

Copyright (c) 2026 ADStn Developer Team (https://www.adstn.ovh).