Skip to content

Add screenshots.py for extension documentation images - #9

Merged
bonelifer merged 1 commit into
mainfrom
test-board-screenshots
Oct 7, 2026
Merged

bonelifer merged 1 commit into
mainfrom
test-board-screenshots

Conversation

@bonelifer

Copy link
Copy Markdown
Contributor

Adds phpbb-test-board/screenshots.py, which saves PNG screenshots of an extension's board and ACP pages for its documentation.

  • How: installs the extension on a clean test board, renames the board "Example board", and takes the screenshots with Playwright and Chromium (prosilver, English). The board is restored afterwards. The first run downloads Playwright's Chromium.
  • What: the pages are listed per extension in a SHOTS table. phpbbmodders/documentation is the first: a documentation page (desktop and phone), the navbar, search results, the ACP settings page and its permissions. It needs --build DIR, a phpbbdocs-hugo build to serve.
  • Also: playwright is added to the tool's requirements, the README describes the script, and tests/test-phpbb-test-board.sh covers its arguments.

Testing
Claude ran the script against phpbbmodders/documentation on a 3.3.19 test board with a fresh phpbbdocs-hugo build. All six screenshots were saved and checked, and the board was left clean. The tool's own test script passes.


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

Takes PNG screenshots of an extension's board and ACP pages with
Playwright (Chromium, prosilver, English) on a test board renamed
"Example board", for the extension's docs/images. Pages are listed per
extension in SHOTS; phpbbmodders/documentation is the first, served from
a phpbbdocs-hugo build given with --build. The first run downloads
Playwright's Chromium.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@bonelifer
bonelifer requested a review from kaileymsnay October 7, 2026 17:02
@bonelifer
bonelifer merged commit d492a34 into main Oct 7, 2026
1 check passed
@bonelifer
bonelifer deleted the test-board-screenshots branch October 7, 2026 17:11
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