chore: release wordpress plugin v1.2.7

Author: shortov

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.2.7] - 2026-04-14
+
+### Added
+- Direct Docs and Support Forum links on the plugin Connect screen for both connected and disconnected states
+- Support and Settings links on the Plugins list page, plus Docs and Support Forum links in plugin row meta
+- WordPress.org FAQ updates covering the Studio-first connection flow, Push as Draft troubleshooting, and what to include in support requests
+
 ## [1.2.6] - 2026-04-14
 
 ### Fixed

admin/views/audit-page.php

@@ -533,6 +533,12 @@
 									<span aria-hidden="true">•</span>
 									<a href="<?php echo esc_url( $aeocas_terms_url ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Terms', 'aeo-content-ai-studio' ); ?></a>
 								</p>
+								<p class="description aeo-connect-help">
+									<?php esc_html_e( 'Need help?', 'aeo-content-ai-studio' ); ?>
+									<a href="<?php echo esc_url( AEOCAS_Settings::get_docs_url() ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Docs', 'aeo-content-ai-studio' ); ?></a>
+									<span aria-hidden="true">•</span>
+									<a href="<?php echo esc_url( AEOCAS_Settings::get_support_forum_url() ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Support Forum', 'aeo-content-ai-studio' ); ?></a>
+								</p>
 							<?php else : ?>
 								<p class="description"><?php esc_html_e( 'Only a site administrator can manage billing, disconnect the site, or change plugin features.', 'aeo-content-ai-studio' ); ?></p>
 							<?php endif; ?>
@@ -627,6 +633,12 @@
 									<?php esc_html_e( 'and', 'aeo-content-ai-studio' ); ?>
 									<a href="<?php echo esc_url( $aeocas_privacy_url ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Privacy Policy', 'aeo-content-ai-studio' ); ?></a>.
 								</p>
+								<p class="description aeo-connect-help">
+									<?php esc_html_e( 'Need help installing or connecting the plugin?', 'aeo-content-ai-studio' ); ?>
+									<a href="<?php echo esc_url( AEOCAS_Settings::get_docs_url() ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Docs', 'aeo-content-ai-studio' ); ?></a>
+									<span aria-hidden="true">•</span>
+									<a href="<?php echo esc_url( AEOCAS_Settings::get_support_forum_url() ); ?>" target="_blank" rel="noopener"><?php esc_html_e( 'Support Forum', 'aeo-content-ai-studio' ); ?></a>
+								</p>
 							<?php else : ?>
 								<p class="description aeo-connect-help"><?php esc_html_e( 'Ask a site administrator to complete the connection flow or provide a verified site token.', 'aeo-content-ai-studio' ); ?></p>
 							<?php endif; ?>

aeo-content-ai-studio.php

@@ -2,7 +2,7 @@
 /**
  * Plugin Name: AEO Content AI Studio
  * Description: AI visibility audits and content publishing for WordPress. Track citations, prioritize fixes, and publish optimized drafts from AEO Content AI Studio.
- * Version: 1.2.6
+ * Version: 1.2.7
  * Author: AEO Content, Inc.
  * Author URI: https://www.aeocontent.ai
  * License: GPL v2 or later
@@ -17,7 +17,7 @@
 	exit;
 }
 
-define( 'AEOCAS_VERSION', '1.2.6' );
+define( 'AEOCAS_VERSION', '1.2.7' );
 define( 'AEOCAS_PLUGIN_FILE', __FILE__ );
 define( 'AEOCAS_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
 define( 'AEOCAS_PLUGIN_URL', plugin_dir_url( __FILE__ ) );

includes/class-aeo-settings.php

@@ -11,6 +11,8 @@ class AEOCAS_Settings {
 
 	const CONNECT_NOTICE_TRANSIENT = 'aeocas_connect_notice';
 	const STUDIO_CONNECT_ACTION    = 'aeocas_complete_studio_connect';
+	const SUPPORT_FORUM_URL        = 'https://wordpress.org/support/plugin/aeo-content-ai-studio/';
+	const DOCS_URL                 = 'https://www.aeocontent.ai/knowledge/';
 
 	public function __construct() {
 		add_action( 'admin_menu', array( $this, 'add_menu' ) );
@@ -20,6 +22,7 @@ public function __construct() {
 		add_action( 'admin_post_aeocas_disconnect', array( $this, 'handle_disconnect' ) );
 		add_action( 'wp_ajax_aeocas_google_connect', array( $this, 'ajax_google_connect' ) );
 		add_filter( 'plugin_action_links_' . plugin_basename( AEOCAS_PLUGIN_FILE ), array( $this, 'add_settings_link' ) );
+		add_filter( 'plugin_row_meta', array( $this, 'add_plugin_row_meta' ), 10, 2 );
 		add_filter( 'submenu_file', array( $this, 'highlight_submenu_tab' ) );
 	}
 
@@ -31,10 +34,30 @@ public function __construct() {
 	 */
 	public function add_settings_link( $links ) {
 		$settings_link = '<a href="' . esc_url( admin_url( 'admin.php?page=aeocas-audit-report&tab=connect' ) ) . '">' . esc_html__( 'Settings', 'aeo-content-ai-studio' ) . '</a>';
+		$support_link  = '<a href="' . esc_url( self::get_support_forum_url() ) . '" target="_blank" rel="noopener">' . esc_html__( 'Support', 'aeo-content-ai-studio' ) . '</a>';
+		array_unshift( $links, $support_link );
 		array_unshift( $links, $settings_link );
 		return $links;
 	}
 
+	/**
+	 * Add documentation links to the plugin row meta on the plugins list page.
+	 *
+	 * @param array  $links Existing plugin row meta links.
+	 * @param string $file  Plugin file basename.
+	 * @return array
+	 */
+	public function add_plugin_row_meta( $links, $file ) {
+		if ( plugin_basename( AEOCAS_PLUGIN_FILE ) !== $file ) {
+			return $links;
+		}
+
+		$links[] = '<a href="' . esc_url( self::get_docs_url() ) . '" target="_blank" rel="noopener">' . esc_html__( 'Docs', 'aeo-content-ai-studio' ) . '</a>';
+		$links[] = '<a href="' . esc_url( self::get_support_forum_url() ) . '" target="_blank" rel="noopener">' . esc_html__( 'Support Forum', 'aeo-content-ai-studio' ) . '</a>';
+
+		return $links;
+	}
+
 	public function add_menu() {
 		$cap      = AEOCAS_Capabilities::view_reports_capability();
 		$icon     = self::get_menu_icon_data_uri();
@@ -279,6 +302,24 @@ public static function get_connect_url( $intent = 'start' ) {
 		return add_query_arg( $args, trailingslashit( AEOCAS_ACCOUNT_URL ) . 'login' );
 	}
 
+	/**
+	 * Return the public documentation URL for onboarding and troubleshooting.
+	 *
+	 * @return string
+	 */
+	public static function get_docs_url() {
+		return self::DOCS_URL;
+	}
+
+	/**
+	 * Return the public WordPress.org support forum URL.
+	 *
+	 * @return string
+	 */
+	public static function get_support_forum_url() {
+		return self::SUPPORT_FORUM_URL;
+	}
+
 	/**
 	 * Build an account URL for connected users who want to manage their account.
 	 *

readme.txt

@@ -4,7 +4,7 @@ Tags: ai, content, publishing, audit, optimization
 Requires at least: 6.2
 Tested up to: 6.9
 Requires PHP: 7.4
-Stable tag: 1.2.6
+Stable tag: 1.2.7
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
@@ -65,6 +65,8 @@ Start from **AEO Content** in your WordPress admin sidebar:
 2. The popup closes automatically and your site is connected
 3. Or use **Create Account Manually** / **I Already Have an Account** for email-based setup
 
+You can also start from AEO Content AI Studio, enter your site URL, and finish the connection from WordPress admin.
+
 = External Service =
 
 This plugin connects to the AEO Content platform at `aeocontent.ai` for the following purposes:
@@ -92,6 +94,10 @@ Alternatively, search for "AEO Content AI Studio" in the WordPress plugin direct
 
 Yes. The plugin connects to the AEO Content platform which manages content optimization and audit scoring. Visit [aeocontent.ai](https://www.aeocontent.ai) to get started with a free audit.
 
+= Can I connect my WordPress site from AEO Content AI Studio? =
+
+Yes. You can start from Studio, enter your site URL, and complete the connection from your WordPress admin screen. You can also start from the plugin inside WordPress. Both flows connect the same site.
+
 = What does the Audit Report show? =
 
 The site audit evaluates 48 criteria across five pillars: Content Originality (25%), Content Uniqueness (25%), Extractability (25%), Entity and Data Richness (15%), and Structural Signals (10%). Each page also gets a per-page AEO Page Rank score from 0 to 100 with letter grades (A through F) based on 17 content-specific checks. The workflow screen is organized into Connect, Diagnose, Fix, and AI Visibility stages. Most websites score between 30 and 60. Above 70 indicates strong AI citation readiness.
@@ -104,6 +110,10 @@ The AI Visibility stage tracks whether AI engines actually cite your site in the
 
 AEO Content AI Studio reads your posts via the plugin's REST API, optimizes them using AI, and sends updated content back. The plugin creates or updates WordPress posts with the optimized content, including categories, tags, featured images, and FAQ structured data. You control which posts are updated from the platform.
 
+= Why does Push as Draft fail? =
+
+Most draft publishing failures come from one of these issues: the site is not fully connected, the connected domain does not match the current WordPress site URL, the plugin is out of date, or a security layer is blocking REST API requests. Update the plugin, confirm the site connection, and try again.
+
 = Is it compatible with Yoast SEO / Rank Math? =
 
 Yes. The plugin does not inject schema or modify meta tags on the frontend. It manages post content and metadata through standard WordPress functions, so it works alongside any SEO plugin without conflicts.
@@ -112,6 +122,14 @@ Yes. The plugin does not inject schema or modify meta tags on the frontend. It m
 
 The heartbeat sends only technical metadata: site URL, plugin version, WordPress version, PHP version, and enabled features. Post content is only transmitted when you explicitly use AEO Content AI Studio to read or publish posts. All communication is encrypted via HTTPS.
 
+= Where do I get support? =
+
+For plugin setup, connection, audit, and publishing issues, use the [WordPress.org support forum](https://wordpress.org/support/plugin/aeo-content-ai-studio/). For private account or billing issues, use support through [aeocontent.ai](https://www.aeocontent.ai).
+
+= What information should I include in a support request? =
+
+Please include your plugin version, WordPress version, PHP version, site URL, whether you started from WordPress or Studio, the exact error message, and the steps needed to reproduce the issue. Do not post API keys, tokens, or passwords.
+
 = Does the plugin slow down my site? =
 
 No. The plugin has zero frontend footprint:it does not add scripts, styles, or markup to your public pages. The heartbeat runs via WP-Cron in the background, and audit data is cached locally.
@@ -130,6 +148,11 @@ The plugin requires a valid site connection to the AEO Content platform. Without
 
 == Changelog ==
 
+= 1.2.7 =
+* Added support visibility improvements in WordPress admin with direct Docs and Support Forum links
+* Added plugin list links for Settings, Support, Docs, and Support Forum discovery
+* Expanded the FAQ with Studio-first connection help and publishing troubleshooting guidance
+
 = 1.2.6 =
 * Security hardening for Studio connection handoff: admin confirmation is now nonce-protected instead of auto-completing on page load
 * Local content index now excludes posts the current dashboard user cannot edit
@@ -176,6 +199,9 @@ Local logging remains available for secure platform-to-plugin diagnostics, but u
 
 == Upgrade Notice ==
 
+= 1.2.7 =
+Improves support visibility with direct Docs and Support Forum links in WordPress admin and adds troubleshooting FAQ updates on WordPress.org.
+
 = 1.2.2 =
 Adds AI Visibility stage with live daily monitoring from 5 AI engines, workflow-based 4-stage UI, and discovery profiles.
 

tests/AEOCASSettingsTest.php

@@ -231,9 +231,33 @@ public function test_add_settings_link_prepends_settings_link(): void {
 
         $result = $settings->add_settings_link( $links );
 
-        $this->assertCount( 2, $result );
+        $this->assertCount( 3, $result );
         $this->assertStringContainsString( 'aeocas-audit-report', $result[0] );
         $this->assertStringContainsString( 'Settings', $result[0] );
+        $this->assertStringContainsString( 'wordpress.org/support/plugin/aeo-content-ai-studio', $result[1] );
+        $this->assertStringContainsString( 'Support', $result[1] );
+    }
+
+    public function test_add_plugin_row_meta_appends_docs_and_support_for_plugin_file(): void {
+        $settings = new AEOCAS_Settings();
+        $links    = array( '<a href="#">Version</a>' );
+
+        $result = $settings->add_plugin_row_meta( $links, plugin_basename( AEOCAS_PLUGIN_FILE ) );
+
+        $this->assertCount( 3, $result );
+        $this->assertStringContainsString( 'https://www.aeocontent.ai/knowledge/', $result[1] );
+        $this->assertStringContainsString( 'Docs', $result[1] );
+        $this->assertStringContainsString( 'wordpress.org/support/plugin/aeo-content-ai-studio', $result[2] );
+        $this->assertStringContainsString( 'Support Forum', $result[2] );
+    }
+
+    public function test_add_plugin_row_meta_leaves_other_plugins_unchanged(): void {
+        $settings = new AEOCAS_Settings();
+        $links    = array( '<a href="#">Version</a>' );
+
+        $result = $settings->add_plugin_row_meta( $links, 'other-plugin/other-plugin.php' );
+
+        $this->assertSame( $links, $result );
     }
 
     public function test_sanitize_and_register_clears_connection_on_empty_key(): void {

tests/bootstrap.php

@@ -35,7 +35,7 @@
 }
 
 if ( ! defined( 'AEOCAS_VERSION' ) ) {
-    define( 'AEOCAS_VERSION', '1.2.6' );
+    define( 'AEOCAS_VERSION', '1.2.7' );
 }
 
 $GLOBALS['wp_version'] = '6.9';