Skip to content

Fix language pack validation errors and add a validation workflow - #21

Merged
R3gi merged 3 commits into
R3gi:masterfrom
bonelifer:add-validation-ci
Sep 24, 2026
Merged

R3gi merged 3 commits into
R3gi:masterfrom
bonelifer:add-validation-ci

Conversation

@bonelifer

@bonelifer bonelifer commented Sep 21, 2026 •

Copy link
Copy Markdown
Contributor

@R3gi This PR is part of #14. It replaces #16 (thanks to @janinko for the first draft).

This comes from William Jacoby (bonelifer). The pack came up while the phpbbdocs-hugo documentation translation project was looking for reference language packs.

The master branch fails the phpBB Translation Validator (version 1.6.x, phpBB 3.3.17) with 5 fatal and 4 error findings. This PR fixes all of them. It also adds a workflow that checks the pack on every change.

Fixes

  • Email templates:
    • report_pm_closed.txt and short/report_pm.txt now use the same variables as the English templates.
    • short/bookmark.txt and short/topic_notify.txt: removed the {U_TOPIC} and {U_FORUM} paragraphs. English has them only in the long templates.
    • newtopic_notify.txt: added the missing {U_TOPIC} paragraph.
  • install.php:
    • INTRODUCTION_BODY uses %1$s for the link, like English, and not the fixed link ../docs/INSTALL.html.
    • SUPPORT_BODY now matches English: removed the Welcome Package link and a stray ?, and added the Twitter and Facebook links.
    • The documentation links point to the 3.3 docs.
  • ucp.php: new GPL link in TERMS_OF_USE_CONTENT. Removed an extra <br /> at the end of PRIVACY_POLICY.

Result: 0 fatal, 0 error. 20 warnings remain (mostly plural forms and extra links).

Workflow (.github/workflows/validate.yml)

It runs on pull requests, on pushes to master, once a week, and by hand. It:

  • Gets the current stable phpBB 3.3 version from version.phpbb.com.
  • Downloads the official phpBB zip and checks its SHA-256.
  • Checks only ext/, language/ and styles/.
  • Fails on any fatal or error finding. (The validator's own exit code shows only fatal findings, so the workflow reads the summary too.)

It needs no secrets and only reads the code. It does not publish anything.

Difference from #16: it uses validator 1.6.x (the master branch supports only phpBB 4.0), the official phpBB zip, and PHP 8.3. It also checks ext/ and styles/.

A new phpBB 3.3 release can make the weekly run fail until the pack is updated. This is on purpose.

Please note

  • GitHub may ask you to approve the first run. This is normal for a PR from a new contributor.
  • Please check that GitHub Actions is turned on (Settings > Actions > General). This repository has never run a workflow.

How it was tested

The workflow ran on GitHub in a fork, on two test branches:

Not tested yet:

  • Running on a pull request. The workflow is set to run when someone opens or updates a PR. The test on the fork ran it on a push instead. The steps are the same. This PR will be the first real test, once you allow the run.
  • The installer link. INTRODUCTION_BODY now uses %1$s, like the English text. The phpBB installer fills it in with the link to the installation guide. Nobody has run the installer in Czech to see the link work.

Not done

  • The terms and privacy texts in ucp.php have fewer paragraphs than English. A Czech speaker should check them.
  • Two sentences are new Czech text and need a check: the {U_TOPIC} paragraph in newtopic_notify.txt and the Twitter and Facebook sentence in SUPPORT_BODY.
  • The release zip for phpBB.com must not contain README.md or SECURITY.md. The workflow already leaves them out. To build the zip (czech_<version>.zip), you can use the script in phpbb-release-tools. This is optional. Nothing in this PR needs it.

Investigated and written by Claude on behalf of William Jacoby (bonelifer).

bonelifer and others added 3 commits September 21, 2026 00:49
Email templates: use the variables of the English templates (report_pm_closed, short/report_pm), drop the topic/forum links that exist only in the long templates (short/bookmark, short/topic_notify), and add the missing {U_TOPIC} link (newtopic_notify).

install.php: use %1$s for the installation guide link in INTRODUCTION_BODY and point the documentation links at 3.3 instead of 3.1/3.2. Remove a stray question mark in SUPPORT_BODY.

ucp.php: use the current GPL URL in TERMS_OF_USE_CONTENT and remove a trailing <br /> from PRIVACY_POLICY.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Drop the phpBB Welcome Package link, which the English text no longer has, and replace the mailing-list sentence with the Twitter and Facebook links.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Runs the phpBB Translation Validator (1.6.x) against the official English files of the current stable phpBB 3.3 release on pull requests, pushes to master and weekly. Fails on any fatal or error finding.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@bonelifer bonelifer mentioned this pull request Sep 21, 2026
3 tasks done
@R3gi
R3gi requested review from R3gi and webdeal September 24, 2026 16:25

@R3gi R3gi left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, thanks!

@R3gi
R3gi merged commit 45bc975 into R3gi:master Sep 24, 2026
@bonelifer
bonelifer deleted the add-validation-ci branch September 29, 2026 18:36
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.

2 participants