Release notes

Proclaim's REST API works in this release. On every earlier 10.3.x release it returned "not found" at every address, on every site — so if you tried it and gave up, that was not your configuration.

Upgrading is recommended for every site. Two admin faults below could stop you reaching Proclaim's settings at all.

The REST API

• Turning it on is one step — enable the Web Services - Proclaim plugin under System → Plugins. There is no separate Proclaim setting to hunt for.
• Reads need an API token by default. If you want an open, read-only feed, switch on Allow public reads in that same plugin. Creating, updating and deleting always require a token either way.
• Twelve kinds of content are available. Sermons, teachers, series, podcasts, media files, topics, locations and study types can be read and written. Playlists, comments, servers and templates are read-only on purpose.
• Nothing is exposed that the caller could not already see. Every response is limited to the access levels of whoever is asking, so restricted content stays restricted. Media-server credentials and commenter email addresses are never returned to anyone.
• Changes are recorded. Edits made through the API appear in Joomla's Action Logs alongside edits made in the admin, each marked with where it came from, so an audit shows both together.

Fixed

• Proclaim's Options screen could fail to open with a "Cannot access offset of type string on string" error, depending on how a site's text-filter settings were stored.
• Saving Options could lock you out of Proclaim entirely, returning you to the licence screen no matter how many times you accepted it. A site already stuck can clear the Joomla cache and accept once more.

Release notes

What's Changed

• chore: bump active_development to 10.3.5 for next cycle by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1327
• fix(admin): repair three faults that locked administrators out of Proclaim by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1329

Full Changelog: https://github.com/Joomla-Bible-Study/Proclaim/compare/v10.3.4...v10.3.5

Release notes

What's Changed

• fix(api): install webservices plugin and ship API files to the api app by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1311
• chore(deps): bump cwm/build-tools to ^1.6.1 by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1312
• fix(build): don't fail the release gate on migration-free versions by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1313
• feat(api): expose 7 more resources, read-only where writes are unsafe by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1314
• feat(logging): record API activity, and make Proclaim's logging actually work by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1315
• feat(api): log authenticated callers refused an action by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1316
• chore(composer): exclude YouTube addon vendor from classmap scan by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1317
• chore(deps): refresh composer.lock by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1318
• fix(youtube): bump bundled Guzzle to 7.15.1 for 4 security advisories by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1319
• fix(deps): bump brace-expansion to 5.0.8 for GHSA-3jxr-9vmj-r5cp by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1320
• chore(deps): bump cwm/build-tools to ^1.6.2 by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1321
• docs(api): record that templatecode writes would be code execution by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1324
• chore(deps): bump cwm/build-tools to ^1.7.0 and sync build.dist.properties by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1325
• feat(api): explain why a write request will not route by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1326

Full Changelog: https://github.com/Joomla-Bible-Study/Proclaim/compare/v10.3.3...v10.3.4

Release notes

What's Changed

• chore: migrate to cwm-build-tools v0.5.x by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1220
• chore(js): ESLint cleanup — auto-fix + globals + ignore minified vendor by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1234
• chore(js): migrate Joomla.editors.instances → JoomlaEditor.get by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1235
• fix(js): replace Joomla.Text._() truthy-key trap with safe helper by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1236
• chore(build): delete orphan build/cwm-article.sh by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1239
• chore(build): migrate build:assets to cwm-build-tools template by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1238
• fix(ai-assist): Add Selected appends topics instead of replacing by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1237
• fix(css): dark-mode contrast for already-selected Choices.js dropdown items by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1240
• feat(captions): auto-fill subtitle track label/srclang from site default by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1241
• Epic #1210 integration: caption format support + YouTube Captions API by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1232
• chore: gitignore media/captions/ runtime upload directory by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1242
• chore(version): sync versions.json + package.json with shipped 10.3.2 by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1243
• fix(version): retag today's captions epic work as @since 10.3.3 by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1244
• chore(submodule): bump lib_cwmscripture + scripturelinks for CSS fix by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1245
• style(css): drop redundant % unit from zero-width progress bars by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1246
• test(site): expand CwmsermonsModel filter regression coverage by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1247
• fix(images): surface low-res warning on all uploads; preserve ratio in migration by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1248
• chore: untrack Claude local settings + sync lockfiles by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1249
• test(site): integration-test module-state query path; log mod_proclaim render errors by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1250
• feat(cpanel): surface content awaiting editorial review on the dashboard by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1251
• fix(layout-editor): align fields in landing section settings modal by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1252
• feat(debug): wire CwmDebug::logQuery into the main list query paths by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1253
• feat(debug): instrument AI provider HTTP calls; add CwmDebug::logApi by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1254
• feat(debug): instrument podcast HTTP calls with CwmDebug::logApi by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1255
• feat(debug): shared addon apiRequest() + instrument Vimeo HTTP calls by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1256
• feat(debug): instrument Wistia and Resi HTTP calls via apiRequest by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1257
• chore(deps): dependency maintenance — patch bumps, unused dep removal, phan v6, intl-tel-input v29 by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1258
• chore(deps): bump google/apiclient v2.19.3 in YouTube addon by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1259
• build: add composer release:wiki to sync wiki Home.md version table by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1260
• refactor: remove dead code flagged by stale TODOs (cluster A) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1261
• refactor: resolve cluster-B TODOs (slug routing + stale-comment cleanup) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1262
• refactor: consolidate duplicated MIME detection into Cwmmime helper (B2) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1263
• refactor: resolve cluster-C TODOs (dead code + stale-comment cleanup) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1264
• refactor: remove stale 'deprecate this override' TODO on CwmtopicTable::bind() (cluster D) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1265
• chore: gitignore local .claude/settings.json by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1266
• test: remove orphaned legacy files from tests/ root by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1267
• chore(deps-dev): bump @babel/core from 7.29.0 to 7.29.6 by @dependabot[bot] in https://github.com/Joomla-Bible-Study/Proclaim/pull/1269
• chore(deps): bump guzzlehttp/guzzle from 7.11.1 to 7.12.1 in /admin/src/Addons/Servers/Youtube by @dependabot[bot] in https://github.com/Joomla-Bible-Study/Proclaim/pull/1270
• chore(deps): bump guzzlehttp/psr7 from 2.11.0 to 2.12.1 in /admin/src/Addons/Servers/Youtube by @dependabot[bot] in https://github.com/Joomla-Bible-Study/Proclaim/pull/1271
• chore(deps): patch all npm audit vulnerabilities via overrides by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1274
• chore(deps): refresh dev-only composer dependencies by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1275
• chore(deps): bump intl-tel-input 29.0.5 -> 29.1.1 (closes #1268) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1276
• fix(images): sanitize & length-cap generated message image filenames (closes #1272) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1277
• feat(media): polish the General Items tab — Podcast fancy-select, inline Browse, layout (closes #1278) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1279
• chore(lang): sync translations after podcast hint change by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1280
• feat(playlist): scaffold Playlist entity (#1273 phase 1) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1282
• feat(playlist): bulk import + reconcile YouTube playlists (#1273 phase 2) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1283
• feat(playlist): scheduled YouTube playlist sync task + conflict gate (#1273 phase 3) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1284
• feat(playlist): Browse Playlists picker + capability registry (#1273 phase 4) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1285
• feat(playlist): platform-neutral contract + Vimeo, remote_* columns (#1273 phase 5) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1286
• feat: YouTube/Vimeo Playlist system — import, sync, picker (#1273 phases 1-5) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1287
• feat(playlist): OAuth title write-back — completes the conflict gate (#1273 phase 6.1) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1288
• feat(playlist): membership write-back — series videos into playlists (#1273 phase 6.2) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1290
• feat(playlist): description write-back (#1273 phase 6.3) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1291
• feat(playlist): per-media playlist assignment field (#1273 phase 6.2b, PR A) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1292
• feat(playlist): bidirectional removal — de-select removes video from platform (#1273 phase 6.2b, PR B) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1293
• feat(actionlog): cover all content entities + cpanel link to Proclaim logs by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1294
• fix(sql): CREATE TABLE ( on table-name line so Database-fix parses playlist tables by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1296
• feat(actionlog): log delete + publish-state changes across list views (PR 2) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1295
• chore(deps): weekly dependency sweep (#1289) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1297
• feat(podcast): download tracking redirect + permanent episode GUIDs (#1281) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1299
• feat(podcast): default download tracking to ON (#1281) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1300
• feat(analytics): surface podcast downloads on the dashboard (#1281) by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1301
• fix(youtube): decode API-encoded titles to stop double-escaping by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1303
• fix(release): repair pkg assembly + clean-install install-script bugs by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1304
• test(release): clean-install / upgrade / migration validation harness by @bcordis in https://github.com/Joomla-Bible-Study/Proclaim/pull/1305

Full Changelog: https://github.com/Joomla-Bible-Study/Proclaim/compare/v10.3.2...v10.3.3

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

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

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

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

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

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