Release notes

## What's Changed * Release v10.1.0 by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1137 * fix: YouTube quota, series filter, and menu item SQL hotfixes by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1145 * refactor: extract duplicated option-source fields into reusable Field classes by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1146 * fix: YouTube poller concurrent fetch guard and versions.json update by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1147 * feat: interactive transcript panel with VTT parsing, seek, and search by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1148 * perf: apply database LIMIT to landing page queries by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1149 * fix: add search/autocomplete to teacher selection in message subform by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1150 * feat: add New Message Wizard for guided sermon creation by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1151 * refactor: extract inline JS/CSS to external files for CSP compliance by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1152 * refactor: extract 4 reusable layouts from 40+ duplicated template blocks by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1153 * fix: remove redundant controller overrides and fix edit() return bug by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1154 * refactor: extract controller traits + fix calendar date save error by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1155 * feat: landing page styles, teacher ordering, and module fix by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1168 * refactor: use real Joomla packages for tests, clean up stubs by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1169 * refactor: require joomla-cms clone for tests, delete all stubs by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1170 * feat: Schema.org structured data integration by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1171 * fix: prevent YouTube API quota exhaustion (#1157) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1175 * Fix security vulnerabilities: XSS, open redirect, path traversal, IDOR by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1176 * feat: add teacher organization name to frontend rendering by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1177 * feat: add spacer element for layout spacing by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1178 * fix: preflight schema check prevents duplicate column errors on upgrade by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1183 * feat: visual indicators for custom-overridden schema fields by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1185 * feat: location merge/reassign workflow and delete safety by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1187 * feat: link teachers to Joomla user accounts for auto-access by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1188 * feat: Podcasting 2.0 full namespace support for RSS feeds by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1189 * feat: migrate scripture settings to ScriptureLinks plugin by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1191 * Create pkg_proclaim package installer by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1192 * feat: AI writing voice options, study text improvements, and Bible Brain provider by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1200 * fix: add missing org_name migration for teacher table by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1201 * feat: expand debug mode with CwmDebug helper (#1194) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1202 * feat: REST API with full CRUD, changelog wiring, npm updates by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1204 * feat: Setup Wizard — guided first-run configuration (#1196) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1205 * chore(deps-dev): bump phpunit/phpunit from 11.5.55 to 12.5.22 by @dependabot[bot] in https://github.com/Joomla-Bible-Study/Proclaim/pull/1207 * style: align match arms after php-cs-fixer 3.95 update by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1208 * refactor: replace deprecated Joomla APIs with J6-native equivalents by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1209 * fix(teacher): biography editors, social_links column, asset cleanup crash by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1212 * Release 10.3.0: development → main by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1213 * build(deps): upgrade intl-tel-input 26.x → 28.x by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1214 * feat: first-time adoption of cwm-build-tools v0.4 dev-environment commands by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1216 * chore(deps): bump phpseclib/phpseclib from 3.0.51 to 3.0.52 in /admin/src/Addons/Servers/Youtube by @dependabot[bot] in https://github.com/Joomla-Bible-Study/Proclaim/pull/1215 * chore: adopt cwm/build-tools v0.4.0-alpha and remove local duplicates by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1218 * test: decouple Joomla app setup from DB and use real services when available by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1217 * Release 10.3.2 — scripture provider fix, build infrastructure, and dependency upgrades by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1219 **Full Changelog**: https://github.com/Joomla-Bible-Study/Proclaim/compare/v10.2.0...v10.3.2

Release notes

**Full Changelog**: https://github.com/Joomla-Bible-Study/Proclaim/compare/v10.3.0...v10.3.1

Release notes

## What's Changed * Release 10.3.0: development → main by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1213 **Full Changelog**: https://github.com/Joomla-Bible-Study/Proclaim/compare/v10.2.2...v10.3.0

Release notes

Release notes

Release notes

 

• 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

 

Release notes

Release notes

Release notes

# 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, `` 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](https://github.com/Joomla-Bible-Study/Proclaim/wiki/What's-New-v10.1)

Release notes

Release notes

## 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.

Release notes

Release notes

## 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)

Release notes

Release notes

## 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

Release notes

## 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

Release notes

Release notes

Release notes

Fixes FontAwesome CSS CDN
Fixes #788 Filters not confirming to settings.

Release notes

Fixing sermons search problems.
Fix search filets
Update Caching
Hardening Uploader This issue was discovered by Zhouyuan Yang of Fortinet's FortiGuard Labs.