Skip to content

doc(v7): readme update for plugin v7 - #617

Merged
galbus merged 1 commit into
mainfrom
s-8865-update-wp-plugin-homepage-copy
Aug 11, 2026
Merged

doc(v7): readme update for plugin v7#617
galbus merged 1 commit into
mainfrom
s-8865-update-wp-plugin-homepage-copy

Conversation

@galbus

@galbus galbus commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Update plugin readme and bump version number for v7 release.

@linear-code

linear-code Bot commented Aug 11, 2026

Copy link
Copy Markdown

S-8865

@github-actions

Copy link
Copy Markdown

✅ WordPress Plugin Check Report

✅ Status: Passed

📊 Report

All checks passed! No errors or warnings found.


🤖 Generated by WordPress Plugin Check Action • Learn more about Plugin Check

@galbus
galbus requested review from gouravkhunger and ptrko August 11, 2026 10:08
@gouravkhunger

Copy link
Copy Markdown
Contributor

@galbus This is an initial automated PR review.

Soft score: Requires changes

  • No changelog entry for doc(v7): readme update for plugin v7 #617 in readme.txtAGENTS.md non-negotiable #4 blocks merge on this.
  • Site Health still hardcodes the old plugin name (class-site-health.php:88), so it now diverges from the new header.
  • Public copy nits that ship to wordpress.org: grammar error at readme.txt:23, and the Book a demo CTA lost its UTM params.
Full review

Metadata + copy only. Zero PHP/JS logic touched. Two independent changes rode in together: release version bump (7.0.0-rc.17.0.0) and brand/marketing rewrite (plugin name + description + readme body).

File Change
speechkit.php Plugin Name, Description, Version:, BEYONDWORDS__PLUGIN_VERSION
readme.txt Title, Stable tag, short description, full Description rewrite, new Installation + FAQ, release date
package.json / package-lock.json version ×3
composer.json description
languages/speechkit.pot Regenerated (catch-up from 7.0.0-beta.1)

Affected subsystems

Plugin bootstrap header, WordPress.org directory listing, i18n catalog. No runtime subsystem.

Dependency graph changes

None. The composer.json edit is the description string, not requires.

Public API changes

Plugin display name changedBeyondWords - Text-to-SpeechBeyondWords - AI audio for publishers. Slug (speechkit/speechkit.php) unchanged, so plugin_basename, activation hooks, and the update path are safe. This is a translatable string change: existing locale translations of the plugin name and description go stale.

DB changes

None directly. The bump crosses the version_compare( $version, '7.0.0', '<' ) gate in src/core/class-updater.php:44 one final time for anyone on rc.1 — the four migrations there are documented idempotent, so this is fine, and the gate never fires again after.

Auth / security changes

None.

Deployment / config changes

Release date: 11th August 2026 is hardcoded — this must merge and ship today or the changelog lies. All five version locations from scripts/bump-version.sh are correctly in sync.

Risky files

readme.txt — highest blast radius. It is the WordPress.org store page; wrong content is public immediately on deploy.


Findings

1. No changelog entry for #617 — blocks merge per AGENTS.md

AGENTS.md non-negotiable #4: every PR gets a bullet before merging into main. grep 617 readme.txt returns nothing. Needs a line under **Codebase Enhancements**.

2. Site Health label still shows the old plugin name

src/site-health/class-site-health.php:88 hardcodes __( 'BeyondWords - Text-to-Speech', 'speechkit' ). Previously this string was identical to the plugin name; now they diverge, so Site Health shows the retired brand. The .pot diff makes this visible — the msgid moved from #. Plugin Name of the plugin to a standalone entry. tests/phpunit/site-health/test-site-health.php:51 asserts the old string, so CI stays green while the product is inconsistent.

3. Grammar error in public store copy

readme.txt:23: "adds a customizable player, and automatically update audio when articles changes." Two agreement errors in one clause. This renders on wordpress.org.

4. Book a demo link lost its UTM parameters

readme.txt:65 is now a bare https://beyondwords.io/book-a-demo/. Every removed link carried ?utm_source=wordpress&utm_medium=referral&utm_content=plugin. Attribution for the plugin's primary conversion CTA is now gone.


Minor

  • The short description is duplicated verbatim as the first line of == Description ==. Harmless, but reads as a mistake.
  • "Voices are powered by ElevenLabs" — the voice picker still buckets non-ElevenLabs voices (VOICE_MODEL_STANDARD / "Legacy") in src/editor/components/select-voice/class-select-voice.php. Marketing's call, but the copy is narrower than the product.
  • The .pot regen sweeps in unrelated string churn from beta.1 onward (Accent, Native, bulk-action plurals). Expected, just noise in the diff. It also still ships msgids from plugins/beyondwords-debug-tool/ and plugins/beyondwords-import-tool/ — pre-existing, not this PR.

Review priority order

  1. readme.txt — changelog entry for doc(v7): readme update for plugin v7 #617, then the grammar and UTM fixes
  2. src/site-health/class-site-health.php (+ its PHPUnit assertion) — brand consistency
  3. speechkit.php — verify header/constant parity (confirmed correct)
  4. package*.json, composer.json — mechanical, confirmed correct
  5. languages/speechkit.pot — regenerated, no action

@galbus
galbus merged commit fc69f9e into main Aug 11, 2026
13 checks passed
@galbus
galbus deleted the s-8865-update-wp-plugin-homepage-copy branch August 11, 2026 10:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants