v3.5.3 - Latest Release

Third Audience v3.5.3

This is the latest stable release of the Third Audience WordPress Plugin.

Installation

1. Download the third-audience-v3.5.3.zip file below
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the ZIP file
4. Click Install Now then Activate

Full Changelog

See CHANGELOG.md for full details.

v2.0.4: Cache Browser & Enhanced Footer

What's New in v2.0.4

Cache Browser (Issue #5)

A comprehensive cache management interface that makes it easy to browse, search, and manage cached markdown entries:

• Browse All Cached Pages: View all cached markdown entries in a clean, sortable table
• Search & Filter: Quickly find specific cached URLs
• Educational Help: Clear explanations throughout the UI for non-technical users
• Cache Statistics: Dashboard cards showing cached items, size, hit rate, and expired entries
• View Content: Preview cached markdown in a modal popup
• Regenerate Cache: Force regeneration for specific posts
• Delete Operations: Single delete, bulk delete, and clear expired entries
• Safe Operations: Confirmation dialogs before destructive actions

Enhanced Footer Metadata

Markdown files now include tracking information in the footer:

• Plugin version number (helps identify which version generated the markdown)
• Generation timestamp in UTC (helps identify stale cache)
• Useful for debugging and tracking cache freshness

Bug Fixes

• Fixed SQL "ambiguous column" error in cache query methods
• Improved cache key lookup with proper table aliasing

Technical Changes

• Added 3 new cache query methods to TA_Cache_Manager
• Added 5 AJAX handlers for cache operations
• Created new admin page with view template, JavaScript, and CSS
• Enhanced generate_footer() method in local converter
• Comprehensive security with nonce verification on all AJAX calls

Upgrade Notes

After upgrading, you may want to clear and regenerate your cache to get the enhanced footer metadata in all cached files.

Full Changelog: v2.0.3...v2.0.4

v2.0.3 - AI-Optimized Markdown Output

🎯 Critical Fixes for AI-Friendly Markdown (Issue #9)

This release addresses fundamental issues with markdown conversion that prevented AI agents from receiving clean, semantic content.

What's Fixed

1. Pure Markdown Output ✅

• Before: HTML tags mixed with markdown
• After: All HTML stripped, pure markdown syntax only
• Changed strip_tags => true in converter configuration

2. Main Content Extraction ✅

• Before: Entire page HTML (navigation, forms, sidebars, comments)
• After: Only main article content extracted
• New intelligent detection:
  • Strategy 1: Look for <article> tag (HTML5 semantic)
  • Strategy 2: WordPress content classes (.entry-content, .post-content, etc.)
  • Strategy 3: <main> tag detection
  • Strategy 4: Fallback removal of UI chrome

3. What Gets Removed ❌

The converter now strips all UI chrome that AI agents don't need:

• Navigation menus
• Headers and footers
• Sidebars and widgets
• Contact forms
• Comments sections
• Related posts
• All elements with classes/IDs: sidebar, menu, nav, footer, header, widget

4. Enhanced Table Support 📊

• Added table pipe escaping
• Proper markdown table formatting
• Clean table output for structured data

Testing

Comprehensive local testing on Docker WordPress:

• ✅ Pure markdown output (no HTML tags)
• ✅ Main content only (no sidebars/navigation)
• ✅ Clean frontmatter with metadata
• ✅ Homepage and post markdown verified
• ✅ Screenshots included in testing

Why This Matters

The Third Audience philosophy:

• First Audience: Humans (need full UI - navigation, forms, CTAs)
• Second Audience: Search engines (need structured HTML for SEO)
• Third Audience: AI agents (need clean, semantic markdown)

AI agents (ClaudeBot, GPTBot, PerplexityBot) need focused content without UI noise. This release delivers exactly that.

Files Changed

• includes/class-ta-local-converter.php - Complete rewrite of content extraction
• third-audience.php - Version bump to 2.0.3

Upgrade Notes

No breaking changes. Simply update and clear cache to regenerate all markdown files with the new clean format.

---

Related: Issue #9 - AI-Optimized Markdown Content Enhancements

v2.0.2 - Critical Homepage Bug Fix + Live Preview

🐛 Critical Bug Fix

This release fixes the homepage markdown URL detection bug reported in Issue #1.

What Was Fixed

Homepage URL Detection Bug

• Homepage with static page now correctly generates /index.md instead of .md
• Fixed incorrect is_front_page() && is_home() condition that failed for static homepages
• Resolves Issue #1: #1

🎯 New Features

Live Preview & Validation

• Real-time URL preview in Settings → General
• Shows the exact markdown URL that will be generated
• "Test URL" button to open and validate markdown in new tab
• Preview updates dynamically as you change settings

User Experience

• No more guessing if your homepage URL will work
• Instant validation without leaving settings page
• Visual feedback before saving changes

📸 Screenshot

The new preview section shows:

• Your exact homepage markdown URL
• Test button to validate it works
• Updates in real-time as you change patterns

🔧 Technical Changes

• Changed homepage detection from is_front_page() && is_home() to is_front_page()
• Added live preview UI to settings page
• Added dynamic JavaScript preview updates
• Added homeUrl to localized admin script data

📦 Installation

Download the plugin ZIP file and install via WordPress admin:

1. Go to Plugins → Add New → Upload Plugin
2. Choose the downloaded ZIP file
3. Click Install Now
4. Activate the plugin

⚠️ After Update

Important: After updating, go to Settings → Permalinks and click Save Changes to flush rewrite rules.

🧪 Testing

Test your homepage markdown URL:

1. Go to Settings → Third Audience → General
2. Scroll to Homepage Markdown Pattern
3. See the live preview of your URL
4. Click "Test URL" to validate it works

---

Previous Release: v2.0.1

v2.0.1 - Critical Bug Fixes

🐛 Bug Fixes

This release addresses critical issues discovered in the homepage markdown URL generation and adds important improvements.

Fixed Issues

Homepage .md URL Bug

• Homepage URLs now correctly generate as /index.md instead of .md
• Fixes Issue #1 where https://example.com/ was generating https://example.com.md

Customizable Homepage Pattern

• New settings option to choose homepage markdown pattern:
  • index.md (Recommended)
  • home.md
  • root.md
  • Custom pattern support

Edge Case Handling

• Automatically fallback to latest published post when no static homepage is configured
• Improved URL parsing to handle edge cases with query parameters and fragments

Update Checker

• Fixed GitHub repository reference to point to correct repo
• spcaeo/third-audience-wordpress-plugin

Changelog Display

• Added comprehensive version history in System Health page
• Added version changelog in About page
• Shows what's new in each version

Installation

Download the plugin ZIP file and install via WordPress admin:

1. Go to Plugins → Add New → Upload Plugin
2. Choose the downloaded ZIP file
3. Click Install Now
4. Activate the plugin

After Update

Important: After updating, go to Settings → Permalinks and click Save Changes to flush rewrite rules.

Full Changelog

• Fix homepage .md URL generation bug
• Add customizable homepage markdown pattern settings
• Add automatic fallback to latest post when no homepage configured
• Fix GitHub repository reference in update checker
• Add comprehensive version history and changelog display

---

Previous Release: v2.0.0

v1.1.1 - Fix Homepage .md URL Bug

Bug Fix

• Homepage URLs now generate correct .md URLs (e.g., /index.md instead of .md)

New Features

• Customizable homepage markdown pattern (index.md, home.md, root.md, or custom)
• Automatic fallback to latest post when no static homepage is set

Improvements

• Better URL parsing to handle edge cases
• Settings UI with pattern examples and warnings
• JavaScript for custom pattern toggle

Files Changed

• includes/class-ta-discovery.php - Fixed discovery link generation
• includes/class-ta-url-router.php - Fixed rewrite rules and request handling
• admin/views/settings-page.php - Added settings UI
• admin/class-ta-admin.php - Registered new settings
• admin/js/admin.js - Added JavaScript for custom pattern toggle
• third-audience.php - Updated version to 1.1.1

Installation

Download the plugin ZIP from the releases page and install via WordPress admin or upload via FTP to wp-content/plugins/.

Full Changelog: v1.1.0...v1.1.1