Skip to content

[ticket/16957] Improve ACP extension explanations and remove HTML#6986

Open
ECYaz wants to merge 1 commit into
phpbb:masterfrom
ECYaz:ticket/16957
Open

[ticket/16957] Improve ACP extension explanations and remove HTML#6986
ECYaz wants to merge 1 commit into
phpbb:masterfrom
ECYaz:ticket/16957

Conversation

@ECYaz

@ECYaz ECYaz commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Checklist:

  • Correct branch: master for new features; 3.3.x for fixes
  • Tests pass
  • Code follows coding guidelines: master and 3.3.x
  • Commit follows commit message format

The EXTENSION_*_EXPLAIN language keys are used as title attributes for the
action links on the extensions list, where any HTML is displayed literally
(see the screenshot in the ticket). This removes the remaining HTML from the
explanation strings on the ACP extensions pages and applies the wording for
composer-managed extensions proposed in the ticket:

  • EXTENSION_UPDATE_EXPLAIN and EXTENSION_REMOVE_EXPLAIN now use the
    ticket's wording — they describe the composer flow (disable, delete files,
    upload the most recent compatible release, re-enable), since these two
    actions are only offered for catalog-managed extensions.
  • The alpha-phase warning inside EXTENSIONS_CATALOG_EXPLAIN (added in
    PHPBB-17682) moved to a new EXTENSIONS_CATALOG_WARNING key; the warning
    markup now lives in the template, using the same
    <strong class="error">{{ lang('WARNING') }}… pattern the page already
    uses for the packagist and minimum-stability warnings.
  • <samp> markup in EXTENSION_INSTALLING_EXPLAIN_STEP2 and
    COMPOSER_MINIMUM_STABILITY_EXPLAIN replaced with typographic quotes.

Not touched, deliberately: EXTENSION_INVALID_LIST and
EXTENSION_DELETE_DATA_CONFIRM still contain <br /> — they are an error
message and a confirm-box message rather than explanation lines, they never
reach a title attribute, and confirm-box messages use <br /> throughout
the language files. Happy to include them if preferred.

The functional tests now also assert that no action tooltip on the
extensions list contains HTML, that the composer-managed update and remove
tooltips carry the new explanations, and that the catalog page renders the
explanation and the warning separately.

Tracker ticket:

https://tracker.phpbb.com/browse/PHPBB-16957

Remove the remaining HTML from the explanation strings on the ACP
extensions pages, as they are used as title attributes where HTML is
displayed literally. Apply the ticket's wording for the update and
remove explanations of composer-managed extensions, and move the
extensions catalog alpha warning into the template.

PHPBB-16957
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.

1 participant