v10.2.2

v10.2.2 — Bug Fix Release

Fixes

• Missing podcast platform_links column — was added in migration 10.1.0-20260303b but missing from install.mysql.utf8.sql. Now included in install SQL and preflight schema check.
• Preflight required-fixes pass — catches columns that should exist but were missed due to install SQL gaps, regardless of schema version.

Upgrade notes

• Safe to install over 10.2.0 or 10.2.1
• The preflight automatically adds the missing platform_links column if absent
• No data migration required

v10.2.1

v10.2.1 — Bug Fix Release

Fix: Upgrade failure from duplicate column errors

Fixes installation failure when upgrading between versions (e.g., 10.0.1 → 10.2.0) caused by MySQL ALTER TABLE ADD COLUMN failing on columns that already exist from a previous partial upgrade attempt.

What happened: Joomla's schema updater aborts on the first SQL error, leaving the site with updated PHP files but an incomplete database schema. Retrying the upgrade would fail again because some columns were already added.

What's fixed: New preflight schema check reads the currently installed install.mysql.utf8.sql to determine what columns each table should have, compares against the live database, and drops any leftover columns from failed upgrades — restoring the DB to a clean state before Joomla runs migration SQL.

Upgrade notes

• Safe to install over a failed 10.2.0 upgrade — the preflight will clean up automatically
• Also fixes database import/restore scenarios where schema doesn't match expectations
• No data migration required

v10.2.0

What's New in 10.2.0

New Features

• Media Chapters & Subtitles — VTT/SRT caption file upload, per-media chapter timestamps, clickable chapter lists on frontend players (YouTube iframe + HTML5 video/audio)
• YouTube OAuth Integration — OAuth status field, import chapters and download captions directly from YouTube, addon-aware capability flags across 7 platforms
• Per-Media Copy Description — Server-configurable description format templates with placeholder replacement ({title}, {series}, {teachers}, {chapters}, etc.)
• AI Assist Enhancements — Chapter generation, topic saving fixes, editor API updates for Joomla 6, toggle checkboxes for selective generation
• Google Drive Server Addon — Document sharing and embedding for Google Drive links
• Chunked Export/Import — Async post-restore steps for large databases
• YouTube Module Improvements — Countdown timer, notify button, mini-player, smart quota optimization
• Podcast Enhancements — Multi-platform links with Podcast Index API, configurable iTunes settings, artwork validation
• Schema-Driven Layout Editor — Settings modal driven by XML schema, media icon sizing
• Analytics Improvements — Archived indicators, status filtering, drill-down views, printable reports
• Social Sharing — Dual-mode sharing with GDPR-compliant local option
• Legacy URL Support — Redirect old com_biblestudy URLs to com_proclaim
• Playwright E2E Tests — Browser-based smoke tests for Joomla 5 + 6

Bug Fixes

• YouTube API Quota — Prevent quota exhaustion from search.list overuse; centralized file cache for throttle and scheduled start times; 15-minute search throttle saves ~200 units per hit
• AI Assist — Fix topic saving (only one topic saved instead of multiple), chapter generation not displaying, deprecated Joomla editor API warnings
• Image Handling — Protect source image from deletion during thumbnail cleanup; prevent File::copy error when source image is missing
• Frontend Filters — Series filter not clearing due to stale session state; AJAX pagination page numbers and CSS; clear button disabled; CSRF gate removed from read-only endpoint
• SEF URLs — Landing page URL fixes, session state bleeding, page caching; handle legacy 9.x SEF URLs and download redirects
• Dark Mode — Theme-aware colors throughout (tables, cards, buttons, YouTube integration, analytics); WCAG AA contrast compliance
• Sermon Views — Handle NULL series_id, custom not-found page with cached recent messages
• Layout Editor — Add missing hidden fields and option sources to mod_proclaim
• Content Hash Versioning — Bust browser cache for updated images
• AI Token Limits — Increased limits and truncated response detection
• Validation — Register JGLOBAL_VALIDATION_FORM_FAILED for JS; Text::sprintf() for hits/downloads strings
• Database — Correct AUTO_INCREMENT counters after backup restore; cast integer properties in Table bind() for PHP 8.3; add missing primary keys for sites upgraded from v7/v8/v9
• Analytics — Correct series thumbnail column, fix Cartesian product in getSeriesList, CSV export headers
• Play Tracking — Re-init YouTube players after AJAX filter, track inline mp3/Fancybox audio, use Joomla base href for multilingual sites
• Security — Escape exception text in innerHTML to prevent XSS (CodeQL #47)

Testing

• 523 PHPUnit tests (1,149 assertions)
• 231 Jest tests (17 suites) — includes 45 new tests for chapters, VTT upload, AI assist, and YouTube tracks
• PHP CS Fixer: 0 issues across 373 files
• PHP syntax: 1,245 files clean

Requirements

• PHP 8.3+
• Joomla 5.1+ (also runs on Joomla 6 without backward compatibility layer)

v10.1.1

Bug Fixes

• YouTube module quota exhaustion: Fixed aggressive API polling burning ~200 quota units/minute when no live stream is active. Added 15-minute search throttle, full cache TTL for null results, and removed expensive search.list fallback from AJAX polling (now 1 unit per poll instead of 200)
• Series filter not clearing: Fixed frontend sermons page filter reverting to old selections after clearing — session state was not being reset alongside model state
• Menu item SQL error: Fixed Unknown column 'text' in order clause when editing menu items for 8 Proclaim views — template picker SQL referenced non-existent column
• Defensive params fallback: Added try/catch around menu item parameter loading so corrupted XML degrades gracefully instead of breaking the sermons page

Installation

Download com_proclaim-10.1.1.zip and install via Joomla Extensions → Install.

v10.1.0

Proclaim 10.1.0

The biggest release in the project's history — a ground-up modernization for Joomla 5/6 and PHP 8.3 with dozens of new features for churches of every size.

Key Highlights

Visual Layout Editor

Drag-and-drop template editor with 6 configurable rows. Separate layout tabs for Messages, Details, Teachers, and Series views. Schema-driven settings modal with per-element configuration. Works within the mod_proclaim module.

Scripture Entry Redesign

Replaced legacy 10-field input with natural-text autocomplete. Supports unlimited references per message via new junction table, per-reference Bible versions, and drag-to-reorder functionality.

Multi-Campus Location System

Single installation can serve multiple campuses with content isolation. Location records map to Joomla user groups. All 11 admin list models filter by location. Non-super-admin users see only their campus's content.

Analytics Dashboard & Campus Reports

GDPR-aware event tracking (page views, plays, downloads) with Chart.js dashboard, four-level drill-down capability, date presets, campus filtering, CSV export, and printable pastor-ready reports.

CSV Bulk Import

Import messages in bulk from CSV or spreadsheet files. Client-side parsing with auto-detected delimiters, 15-field column mapping, preview table, auto-creation of teachers/series/locations, AJAX batch processing.

Bible API Provider Architecture

Three providers: GetBible (free), API.Bible (2,500+ translations), Local (offline/GDPR-safe). Two-level configuration with local translation management and frontend AJAX version switcher.

Image Optimization Pipeline

WebP generation, <picture> elements with JPEG fallback, lazy loading. Admin Image Tools include batch migration, WebP conversion, orphan cleanup, and broken-reference relinking.

9.x to 10.x Migration Wizard

In-place upgrade wizard for Proclaim 9.x to 10.x migration. Automatic legacy schema detection, 6-step AJAX wizard with per-step retry, comprehensive data fixes, and verification.

Content & Worship Features

• Archived messages display with badge options
• Multiple teachers per sermon with drag-to-reorder
• Full message body available in Layout Editor
• Series linking from detail pages
• Scripture verse tooltips with session caching
• Per-element scripture display settings
• Modal series picker with inline create/edit

Media & Players

• Video platform support: Vimeo, Wistia, Resi.io, Dailymotion, Rumble, SoundCloud addons
• Facebook video embeds (page videos, watch URLs, reels, events)
• URL normalization on save across all 8 platform addons
• Fancybox media player updated to v6
• Play count tracking across all player types
• YouTube module with countdown timer, notify button, and mini-player

Frontend Experience

• AJAX sermon filtering with URL state management
• Three pagination styles: standard, load more, infinite scroll
• Enhanced related studies with weighted multi-dimension scoring
• Dual-mode social sharing: Hide, AddToAny, or Local/Privacy
• Schema.org structured data (JSON-LD) for rich results
• Modernized div-based CSS Grid listings
• Multi-platform podcast subscribe links via Podcast Index API

Administration

• Improved control panel with dark mode support
• Color picker with 140+ named CSS colors
• Simple Mode streamlined interface (default for fresh installs)
• Record locking (check-in/checkout) across 12 entity types
• Batch operations across all entity types
• Reset Hits confirmation dialog
• Persistent caching: 15 minutes for dashboard, 1 hour for dropdowns

Platform & Compatibility

• Minimum PHP: 8.3.0
• Minimum Joomla: 5.1.0 (runs natively on Joomla 6)
• Complete PSR-12 compliance
• jQuery removal with Web Asset Manager migration
• Joomla 5/6 forward-compatible APIs
• 523 PHPUnit tests + 186 Jest tests

📖 Full details: What's New in 10.1

Proclaim 10.1.0 Beta 1

Proclaim 10.1.0 Beta 1

First public pre-release of the 10.1 feature set for testing.

Highlights

• Visual Layout Editor — Drag-and-drop template layout builder with per-element settings, context tabs, and module support
• Multiple Teachers Per Sermon — Assign multiple teachers to a single message with a subform interface
• Multi-Campus Locations — Full location management system with view-level filtering for multi-campus deployments
• Addon-Owned Rendering — Media players now rendered by platform-specific addon classes (YouTube, Vimeo, Wistia, Facebook, etc.) with per-addon embed options
• AI Topic Assistant — Generate sermon topics, descriptions, and content suggestions using AI
• Analytics Dashboard — GDPR-compliant two-tier event logging with Chart.js dashboard, drill-down views, scheduled task rollup, and printable reports
• CSV Bulk Import — Import messages from CSV files with auto-entity creation
• Scripture Enhancements — Autocomplete input, cross-browser popup viewer, Bible translation switcher
• Image Optimization — WebP format with lazy loading, image deduplication tools
• YouTube Sync & Quota Tracking — Automatic YouTube video sync with comprehensive API quota monitoring
• Context-Sensitive Help — Help system now links to GitHub Wiki documentation
• Archived Message Indicators — Visual badges and status filtering for archived items in analytics

Requirements

• Joomla 5.1+ or Joomla 6.x
• PHP 8.3+

Installation

Download com_proclaim-10.1.0-beta1.zip and install via Joomla Extension Manager.

Full Changelog

See the What's New in 10.1 wiki page for complete details.

---

Beta Notice: This is a pre-release for testing purposes. Please report any issues at GitHub Issues.

v10.0.1

• Fix podcastlink missing from users upgrading from the 9.x version.

• Update Readme

• new JInstaller() to new Installer()

• Fixed Bootstrap progress bar

• Update the PHP scripts and add the podcastlink to the SQL file.

• Update the display bootstrap workings.

• Fix some PSR-12 errors and PHPcs corrections

• Removed unnecessary sql.

• J6 Changes Needed

• Fixed the Error if the Series had no published studies.

• #992 This fixes the problem with Simple Mode selection

• Remove usage of HTMLHelper and introduce Cwmhtml.php to replace the old proclaim.php

• Fixed the Pagination layout at the footer.

• Work the Bible icon into the button for better layout.

• Reworked to use the new module function.

• PSI-12 rework

• Update HTMLHelper to Cwmhtml usage.

• PSR-12 cleanup and PHP 8.1 updates.

Full Changelog: v10.0.0...v10.0.1

v10.0.0

What's Changed

This is a major Release of Proclaim 10.0.0 for Joomla 4 & 5 support

• v10.0.0 by @bcordis in #988
  Full Changelog: v9.2.8...v10.0.0

v10.0.0-beta.2

Fixed HTML5 layouts
Fixes a lot of search systems
Removed some old code usage to align with Joomla 5
Fix text alignment and CSS Updates.

9.2.8

Fixes an XSS potential in Server Name creation.
This issue was discovered by Zhouyuan Yang of Fortinet's FortiGuard Labs.