=== DIY Sermons ===
Contributors: diychurchwebsite
Tags: sermons, church, podcast, bible, speakers, campuses, ai
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A free, theme-independent sermon library, speaker and campus manager, Bible reader, podcast publisher, migration toolkit, and optional WordPress AI assistant.

== Description ==

DIY Sermons is provided free by DIY Church Website as a practical resource for churches. It has no premium tier and does not require a particular theme.

Version 1.0 includes:

* Sermons with audio, video, livestreams, transcripts, Scripture, podcast fields, and unlimited resources.
* WordPress Media Library and remote URL support by default.
* Optional direct uploads to Amazon S3, Cloudflare R2, Wasabi, Backblaze B2 S3, DigitalOcean Spaces, and compatible object storage.
* Rich speaker biography profiles with history, education, credentials, testimony, campus relationships, contact, and social profiles.
* Single- and multi-campus profiles with service times, directions, livestreams, pastors, speakers, and sermon archives.
* KJV by default with cached HelloAO Bible API passages and per-sermon translation overrides.
* Multiple podcast shows, standards-oriented RSS, Apple/iTunes tags, Podcasting 2.0 people and transcript tags, feed discovery, and diagnostics.
* Grid, list, compact, media-first, masonry, carousel, playlist, and calendar-style sermon libraries.
* Horizontal, vertical, compact, widget, shortcode, and block filters with real URL parameters.
* Gutenberg blocks, classic widget support, and a comprehensive shortcode API.
* Native sharing, direct social links, copy link, structured data, and SEO-plugin compatibility.
* Importers for Advanced Sermons, Sermon Manager for WordPress, and official Series Engine CSV exports.
* Duplicate-safe source mapping and rollback of imported DIY records.
* Optional WordPress 7.0 AI Client integration using Settings > Connectors, structured plans, explicit approval, history, and rollback.
* WPML and Polylang readiness, RTL layouts, translated fields, and language-aware extension hooks.
* Completeness scoring, accessibility checks, remote media health checks, duplication, bulk actions, embeddable players, print styles, and a browser-local listening queue.

== Installation ==

1. Upload `diy-sermons.zip` under Plugins > Add New > Upload Plugin.
2. Activate DIY Sermons.
3. Open Sermons > Setup & Settings.
4. Add the church campus or campuses and speakers.
5. Add a sermon and select its media, Scripture, resources, and podcast show.
6. Place the Sermon Library block or `[diy_sermons filters="yes"]` on a page.

== External services ==

= HelloAO Bible API =

When an authorized editor loads a Bible passage, DIY Sermons requests translation, book, or chapter JSON from `https://bible.helloao.org/`. Responses are cached on the WordPress site, including a last-known-good copy. Translation attribution and license links are preserved. No visitor information is sent for normal sermon-page viewing.

= WordPress AI Client =

AI is optional. When an authorized editor requests an AI plan, selected sermon content is sent through the AI provider configured by the administrator under Settings > Connectors. DIY Sermons does not store provider credentials. Provider terms and retention policies apply. AI is never used to supply displayed Bible text.

= Embedded and remote media =

YouTube, Vimeo, podcast hosts, object storage, CDNs, and other media providers may receive normal browser request information when their media is embedded or played. Their policies apply.

== Frequently Asked Questions ==

= Does it require the DIY/Cheetah theme or another companion plugin? =

No. It works with classic and block themes and has its own templates, blocks, widgets, shortcodes, feed engine, and optional AI integration.

= Does it work without AI? =

Yes. Every sermon, Scripture, media, podcast, migration, filter, and display feature works without an AI provider.

= Does it send Bible quotations to an AI model? =

The AI snapshot includes reference labels but deliberately excludes cached verse text. Displayed Scripture comes from the configured Bible API snapshot.

= Can it publish to every podcast platform automatically? =

DIY Sermons creates the RSS feed. The church submits that feed to Apple, Spotify, YouTube, Amazon, and other directories, then saves the directory URLs on the Podcast Show profile.

= Does it support Google Drive storage? =

No. Google Drive is not used as a podcast or media CDN. WordPress media, remote URLs, and S3-compatible object storage are supported.

= Where can users get support? =

Visit https://diychurchwebsite.com/ for the self-serve portal, documentation, and community forum.

== Changelog ==

= 1.1.0 =
* Adds a stable child-theme design-token API, context classes, customizable sermon-card classes, and profile-section hooks for companion plugins.
* Adds first-party integration support for DIY Church Events speaker and campus event listings.

= 1.0.0 =
* Initial free release.
