ADStn Auto Poster for WordPress

Auto-publish and synchronize WordPress articles to the ADStn social platform seamlessly via Developer REST API & OAuth 2.0.

📖 Overview

ADStn Auto Poster is an enterprise-grade WordPress plugin developed to connect WordPress sites directly with the ADStn Developer Platform (https://www.adstn.ovh). It enables automatic broadcasting of newly published articles and pages to ADStn feeds in real-time, boosting social distribution and referral traffic.

✨ Features

• OAuth 2.0 Authorization Code Flow: Secure, one-click connection with automated token refresh (refresh_token).
• Direct Access Token Support: Optional manual bearer token entry for developer workflows.
• Smart Template Builder: Customize shared message templates using dynamic placeholders:
  • {title} - Article title
  • {url} - Post direct permalink
  • {excerpt} - Post excerpt / summary
  • {hashtags} - Automatically formatted #hashtags
  • {author} - Post author name
  • {categories} - Comma-separated post categories
  • {tags} - Comma-separated post tags
  • {site_name} - WordPress site title
• Live Feed Simulation: Real-time simulated feed preview of how your post will render on ADStn.
• Granular Publishing Rules:
  • Filter by Post Types (Posts, Pages, Custom Post Types).
  • Include or exclude specific categories.
  • Set default privacy levels (public, followers, private).
• Per-Post Editor Sidebar (Metabox):
  • Toggle auto-publishing on/off for specific posts.
  • Write custom per-post messages overriding default templates.
  • Instant "Share to ADStn Now" button via AJAX.
• Full Activity & Sync Logs: Searchable, filterable audit trail of all API requests, responses, and errors with one-click retry.
• Multilingual (i18n & L10n): 100% WordPress translation standard compliant with complete English source and ready-to-use Arabic translations (.pot, .po, .mo).

🚀 Installation & Setup

1. Clone or download this repository into your WordPress plugins directory:

   cd wp-content/plugins/
   git clone https://github.com/ADStn-Network/adstn-auto-poster.git

2. Activate the plugin from the WordPress Admin > Plugins menu.
3. Navigate to ADStn Poster > Connection.
4. Create an application on the ADStn Developer Portal:
   • URL: https://www.adstn.ovh/developer/apps/create
   • Copy the Authorized Redirect URI from plugin settings into your ADStn App settings.
   • Request scopes: user.identity.read, user.content.write.
5. Enter your Client ID and Client Secret, then click Connect & Authorize with ADStn.

🔒 Security & Standards

• All API communications use HTTPS.
• Full protection against CSRF with WordPress Nonces across all AJAX endpoints.
• User capability checks on all administrative actions (manage_options).
• Strict data sanitization and escaping for all user inputs and database queries.

📝 Changelog

1.0.1 (2026-09-03)

• Fix (WAF Compatibility): Streamlined OAuth 2.0 scopes to user.identity.read and user.content.write to avoid aggressive Web Application Firewall (WAF) / ModSecurity rules blocking .profile.
• Fix (Callback Resilience): Added defensive query parameter parsing in OAuth callback to handle servers appending query strings with ? instead of &.
• Fix (WPCS & Compatibility): Replaced str_contains() with strpos() for full WordPress 5.8+ compatibility and sanitized all callback inputs per WordPress Coding Standards.

1.0.0 (2026-09-02)

• Initial release with ADStn Developer REST API v1 & OAuth 2.0 Authorization Code flow.

📄 License

This project is licensed under the GNU General Public License v2.0 or later - see the LICENSE file for details.