diff --git a/.gitattributes b/.gitattributes
index ad6142a..44d2276 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -23,3 +23,4 @@ composer.lock export-ignore
README.md export-ignore
.editorconfig export-ignore
docs/images/ export-ignore
+docs/update/ export-ignore
diff --git a/README.md b/README.md
index 161815e..3dcba7f 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,7 @@ Click a forum, topic, post or FAQ heading to copy a link to it, ready-made as BB
## Features
- Click a forum or topic title, a post subject, or a question in the FAQ or BBCode guide, and a link to it is copied as BBCode, for example `[url=https://example.com/forum/viewtopic.php?t=42]Topic title[/url]`. Paste it into a post and it shows as a readable link.
+- Code blocks have a separate **Copy code** button beside **Select all**. It copies plain text, preserving indentation and line breaks, and provides visible and screen reader feedback. If copying is blocked, the code is selected for manual copying. The ACP link-format setting does not affect code copying.
- Also works on the title above the posting form and on the posts in the topic review below it.
- Links are full addresses built from the forum, topic or post ID, so they work anywhere they're pasted and never carry a session ID. They always point at the forum, topic or post itself, not a page of it.
- A small icon (Font Awesome `fa-clone` by default) marks each copyable heading and turns into a tick for a moment after copying. Screen readers announce "The link has been copied."
@@ -54,7 +55,7 @@ Contributions are welcome!
## Acknowledgments
- Based on [Click/tap/Enter to copy pre-formatted links](https://www.phpbb.com/community/viewtopic.php?t=2676238), style code shared on phpBB.com by Gumboots, which itself grew out of the older Post Numbers extension.
-- Code review, bug fixes, and documentation assisted by [Claude](https://www.anthropic.com/claude).
+- Code review, bug fixes, and documentation assisted by [Claude](https://www.anthropic.com/claude) and [Codex](https://openai.com/codex/).
## License
diff --git a/docs/images/screenshots/README.md b/docs/images/screenshots/README.md
index 6bedf60..4210761 100644
--- a/docs/images/screenshots/README.md
+++ b/docs/images/screenshots/README.md
@@ -20,6 +20,14 @@ Clicking a question in the FAQ copies a link to that question.
+## Code block
+
+The separate **Copy code** button copies plain code without BBCode. **Select all**
+remains available. This Playwright screenshot shows the success label on phpBB
+3.3 after an actual clipboard write and read.
+
+
+
## ACP settings
**Extensions → Copy Links → Settings**: choose plain URLs or BBCode (the default), turn the icon on or off, and choose which Font Awesome icon it is. With the icon off, only the tick shows after a copy.
diff --git a/docs/images/screenshots/copylinks-code.png b/docs/images/screenshots/copylinks-code.png
new file mode 100644
index 0000000..9931cae
Binary files /dev/null and b/docs/images/screenshots/copylinks-code.png differ
diff --git a/docs/update/2026-10-25/01-copy-code.png b/docs/update/2026-10-25/01-copy-code.png
new file mode 100644
index 0000000..e4500f3
Binary files /dev/null and b/docs/update/2026-10-25/01-copy-code.png differ
diff --git a/docs/update/2026-10-25/02-code-copied.png b/docs/update/2026-10-25/02-code-copied.png
new file mode 100644
index 0000000..9794f37
Binary files /dev/null and b/docs/update/2026-10-25/02-code-copied.png differ
diff --git a/docs/update/2026-10-25/03-copy-manually.png b/docs/update/2026-10-25/03-copy-manually.png
new file mode 100644
index 0000000..f6afc7e
Binary files /dev/null and b/docs/update/2026-10-25/03-copy-manually.png differ
diff --git a/docs/update/2026-10-25/README.md b/docs/update/2026-10-25/README.md
new file mode 100644
index 0000000..1dd4d4b
--- /dev/null
+++ b/docs/update/2026-10-25/README.md
@@ -0,0 +1,27 @@
+# Copy Links update screenshots — 10/25/2026
+
+Recent changes in the rolling `1.0.0-dev` build. The complete screenshot gallery
+remains at [docs/images/screenshots/README.md](../../images/screenshots/README.md).
+
+Captured on phpBB 3.3 with prosilver and seed-forum fixtures using
+`tests/browser/capture_update.py`, which reuses phpbb-test-board’s screenshot
+tool. Clipboard success and failure are controlled for reproducible feedback
+states. The PNGs retain their original resolution.
+
+## Copy code control
+
+A separate Copy code button appears beside Select all. Keyboard focus remains visible.
+
+
+
+## Successful copy
+
+The button shows Copied! after plain code is copied. Indentation and line breaks are preserved.
+
+
+
+## Manual-copy fallback
+
+When clipboard access is unavailable, the code is selected and the button shows Copy manually.
+
+
diff --git a/language/en/common.php b/language/en/common.php
index ca37ebd..775de10 100644
--- a/language/en/common.php
+++ b/language/en/common.php
@@ -19,6 +19,11 @@
}
$lang = array_merge($lang, [
+ 'COPYLINKS_CODE' => 'Copy code',
+ 'COPYLINKS_CODE_FAILED_LABEL' => 'Copy manually',
+ 'COPYLINKS_CODE_COPIED_LABEL' => 'Copied!',
+ 'COPYLINKS_CODE_COPIED' => 'The code has been copied.',
+ 'COPYLINKS_CODE_COPY_FAILED' => 'Automatic copying failed. The code is selected; copy it manually.',
'COPYLINKS_HINT_PLAIN' => 'Copy a link to this',
'COPYLINKS_HINT' => 'Copy a link to this as BBCode',
'COPYLINKS_COPIED' => 'The link has been copied.',
diff --git a/styles/all/template/copylinks.js b/styles/all/template/copylinks.js
index 8186de6..1f1d33c 100644
--- a/styles/all/template/copylinks.js
+++ b/styles/all/template/copylinks.js
@@ -2,7 +2,8 @@
* Copy Links extension for the phpBB Forum Software package
*
* Turns forum, topic, post and FAQ headings into "copy link" controls. A
- * click copies a BBCode link or a plain URL to the clipboard.
+ * click copies a BBCode link or a plain URL to the clipboard. Code blocks
+ * have a separate control that copies their contents as plain text.
* Links are built from IDs, so they never carry a session ID, and always point
* at the forum, topic or post itself rather than a page within it.
*
@@ -24,6 +25,13 @@
var hint = status.getAttribute('data-hint');
var copiedMessage = status.getAttribute('data-copied');
var failedMessage = status.getAttribute('data-copy-failed');
+ var codeLabel = status.getAttribute('data-code-label');
+ var codeCopiedLabel = status.getAttribute('data-code-copied-label');
+ var codeCopiedMessage = status.getAttribute('data-code-copied');
+ var codeFailedMessage = status.getAttribute('data-code-copy-failed');
+ var codeFailedLabel = status.getAttribute('data-code-failed-label');
+ var announceTimer;
+ var statusTimer;
// How long the tick and the status message stay, in milliseconds
var SHOW_COPIED_FOR = 2000;
@@ -106,49 +114,71 @@
return '[url=' + url + ']' + text.replace(/\[(\/?url)/gi, '($1') + '[/url]';
}
+ /**
+ * Announce the latest action, including repeated identical messages.
+ *
+ * @param {string} message
+ */
+ function announce(message) {
+ window.clearTimeout(announceTimer);
+ window.clearTimeout(statusTimer);
+ status.textContent = '';
+ announceTimer = window.setTimeout(function () {
+ status.textContent = message;
+ }, ANNOUNCE_DELAY);
+ statusTimer = window.setTimeout(function () {
+ status.textContent = '';
+ }, SHOW_COPIED_FOR);
+ }
+
/**
* Show the tick and announce the copy to screen readers.
*
* @param {Element} target
+ * @param {string} message
*/
- function showCopied(target) {
+ function showCopied(target, message) {
var targetIcon = target.querySelector('.copylinks-icon');
target.classList.add('copylinks-copied');
+ if (target.classList.contains('copylinks-code')) {
+ target.textContent = codeCopiedLabel;
+ }
if (targetIcon) {
targetIcon.classList.remove(icon);
targetIcon.classList.add(COPIED_ICON);
}
- // Clear first so the same message is read out again on a repeat copy
- status.textContent = '';
- window.setTimeout(function () {
- status.textContent = copiedMessage;
- }, ANNOUNCE_DELAY);
+ announce(message);
// A repeat copy restarts the timer instead of being cut short by the
// previous one
window.clearTimeout(target.copylinksTimer);
target.copylinksTimer = window.setTimeout(function () {
target.classList.remove('copylinks-copied');
+ if (target.classList.contains('copylinks-code')) {
+ target.textContent = codeLabel;
+ }
if (targetIcon) {
targetIcon.classList.remove(COPIED_ICON);
targetIcon.classList.add(icon);
}
- status.textContent = '';
}, SHOW_COPIED_FOR);
}
/**
* Copy text to the clipboard, or let the reader copy it by hand when the
- * browser does not allow it (plain http, private windows, old browsers).
+ * browser does not allow it (for example, on plain http).
*
* @param {Element} target
* @param {string} text
+ * @param {string} successMessage
+ * @param {string} failureMessage
+ * @param {Function} [fallback] Optional manual-copy action for code blocks
*/
- function copy(target, text) {
- var copyByHand = function () {
- window.prompt(failedMessage, text);
+ function copy(target, text, successMessage, failureMessage, fallback) {
+ var copyByHand = fallback || function () {
+ window.prompt(failureMessage, text);
};
if (!navigator.clipboard || !window.isSecureContext) {
@@ -157,7 +187,7 @@
}
navigator.clipboard.writeText(text).then(function () {
- showCopied(target);
+ showCopied(target, successMessage);
}, copyByHand);
}
@@ -209,6 +239,37 @@
mark(anchor, 'faq');
});
+ // Keep Select all intact and add a native button beside it. Reading the
+ // rendered code preserves indentation, line breaks and highlighted text.
+ document.querySelectorAll('.codebox').forEach(function (box) {
+ var header = box.querySelector('p');
+ var code = box.querySelector('pre > code');
+ if (!header || !code) {
+ return;
+ }
+
+ var button = document.createElement('button');
+ button.type = 'button';
+ button.className = 'copylinks-code';
+ button.textContent = codeLabel;
+ button.addEventListener('click', function () {
+ copy(button, code.innerText, codeCopiedMessage, codeFailedMessage, function () {
+ // Select the code in place: a prompt's single-line field is not
+ // suitable for manually copying multiline code.
+ var selection = window.getSelection();
+ var range = document.createRange();
+ range.selectNodeContents(code);
+ selection.removeAllRanges();
+ selection.addRange(range);
+ window.clearTimeout(button.copylinksTimer);
+ button.classList.remove('copylinks-copied');
+ button.textContent = codeFailedLabel;
+ announce(codeFailedMessage);
+ });
+ });
+ header.appendChild(button);
+ });
+
// One listener for every control. Clicks with a modifier key or a
// middle button keep their normal behaviour, such as opening a new tab.
document.addEventListener('click', function (event) {
@@ -229,6 +290,6 @@
window.location.hash = fragment;
}
target.focus({preventScroll: true});
- copy(target, plainUrl ? url : bbcodeFor(url, headingText(target)));
+ copy(target, plainUrl ? url : bbcodeFor(url, headingText(target)), copiedMessage, failedMessage);
});
})();
diff --git a/styles/all/template/event/overall_footer_after.html b/styles/all/template/event/overall_footer_after.html
index 76959dd..25b6843 100644
--- a/styles/all/template/event/overall_footer_after.html
+++ b/styles/all/template/event/overall_footer_after.html
@@ -1,5 +1,10 @@
{% if not S_IS_BOT %}
int:
+ """Validate the topic and capture normal, success and fallback states."""
+ parser = argparse.ArgumentParser(description=__doc__)
+ parser.add_argument(
+ '-u', '--url', required=True,
+ help='Local topic URL with a code block')
+ parser.add_argument(
+ '-o', '--out', required=True, type=Path,
+ help='Dated gallery directory')
+ parser.add_argument('-t', '--tool-dir', type=Path,
+ default=(Path(__file__).resolve().parents[3]
+ / 'phpbb-release-tools/phpbb-test-board'),
+ help='Shared phpbb-test-board tool directory')
+ if len(sys.argv) == 1:
+ parser.print_help()
+ return 0
+ args = parser.parse_args()
+ target = urlsplit(args.url)
+ if (target.scheme != 'http'
+ or target.hostname not in ('localhost', '127.0.0.1')):
+ parser.error('--url must identify a local disposable HTTP board')
+ if not (args.tool_dir / 'screenshots.py').is_file():
+ parser.error('--tool-dir must contain screenshots.py')
+ sys.path.insert(0, str(args.tool_dir.resolve()))
+ import screenshots # pylint: disable=import-outside-toplevel
+
+ args.out.mkdir(parents=True, exist_ok=True)
+ board = SimpleNamespace(base=f'{target.scheme}://{target.netloc}')
+ topic = target.path.lstrip('/')
+ if target.query:
+ topic += '?' + target.query
+
+ def prepare(state):
+ """Return a screenshot-tool prepare hook for one controlled outcome."""
+ def run(page):
+ button = page.locator('.copylinks-code').first
+ button.wait_for()
+ if state == 'success':
+ page.evaluate("Object.defineProperty(navigator, 'clipboard', "
+ "{configurable:true,value:{writeText:() =>"
+ "Promise.resolve()}})")
+ button.press('Enter')
+ page.wait_for_function(
+ "document.querySelector('.copylinks-code').textContent"
+ " === 'Copied!'")
+ elif state == 'failure':
+ page.evaluate("Object.defineProperty(navigator, 'clipboard', "
+ "{configurable:true,value:undefined})")
+ button.press('Space')
+ page.wait_for_function(
+ "document.querySelector('.copylinks-code').textContent"
+ " === 'Copy manually'")
+ else:
+ button.focus()
+ button.press('Tab')
+ page.keyboard.press('Shift+Tab')
+ page.mouse.move(0, 0)
+ return run
+
+ with screenshots.sync_playwright() as playwright:
+ browser = screenshots.ensure_chromium(playwright)
+ try:
+ shooter = screenshots.Shooter(board, browser, args.out.resolve())
+ states = [('01-copy-code', 'normal'),
+ ('02-code-copied', 'success'),
+ ('03-copy-manually', 'failure')]
+ for name, state in states:
+ shooter.shot(name, topic, selector='.codebox',
+ prepare=prepare(state))
+ print(f'{len(shooter.saved)} screenshots saved; '
+ f'{len(shooter.failed)} failed')
+ return 1 if shooter.failed else 0
+ finally:
+ browser.close()
+
+
+if __name__ == '__main__':
+ raise SystemExit(main())
diff --git a/tests/browser/code-copy.js b/tests/browser/code-copy.js
new file mode 100644
index 0000000..c12c9d2
--- /dev/null
+++ b/tests/browser/code-copy.js
@@ -0,0 +1,110 @@
+/**
+ * Browser regression checks against a local phpBB topic with two code blocks.
+ * Input: COPYLINKS_TEST_URL; optional COPYLINKS_SCREENSHOT output path.
+ * Requires Playwright and a running board with Copy Links enabled.
+ */
+const assert = require('node:assert/strict');
+const { chromium } = require('playwright');
+
+(async function () {
+ if (!process.env.COPYLINKS_TEST_URL) {
+ console.log('Usage: COPYLINKS_TEST_URL=http://localhost:PORT/viewtopic.php?t=ID node tests/browser/code-copy.js');
+ return;
+ }
+ const browser = await chromium.launch({headless: !process.env.DISPLAY});
+ try {
+ const context = await browser.newContext();
+ await context.addInitScript(function () {
+ window.copiedTexts = [];
+ Object.defineProperty(navigator, 'clipboard', {
+ configurable: true,
+ value: {writeText: async function (text) { window.copiedTexts.push(text); }}
+ });
+ });
+ const page = await context.newPage();
+ const errors = [];
+ page.on('pageerror', error => errors.push(error.message));
+ await page.goto(process.env.COPYLINKS_TEST_URL);
+ const buttons = page.locator('.copylinks-code');
+ await buttons.first().waitFor();
+ assert.ok(await buttons.count() >= 2, 'fixture needs two code blocks');
+ const expected = await page.locator('.codebox pre > code').allInnerTexts();
+ const first = buttons.first();
+ await first.click();
+ await page.waitForFunction(() => document.getElementById('copylinks-status').textContent === 'The code has been copied.');
+ assert.equal(await first.textContent(), 'Copied!');
+ assert.equal(await page.evaluate(() => window.copiedTexts[0]), expected[0]);
+ assert.ok(await first.evaluate(button => button === document.activeElement));
+ await first.press('Enter');
+ await first.press('Space');
+ await page.waitForFunction(() => window.copiedTexts.length === 3);
+ assert.deepEqual(await page.evaluate(() => window.copiedTexts), [expected[0], expected[0], expected[0]]);
+ await buttons.nth(1).click();
+ await page.waitForFunction(() => window.copiedTexts.length === 4);
+ assert.equal(await page.evaluate(() => window.copiedTexts[3]), expected[1]);
+ await page.waitForFunction(() => Array.from(document.querySelectorAll('.copylinks-code')).every(button => button.textContent === 'Copy code'));
+ await page.locator('.codebox p a').first().click();
+ // Chromium's native selection omits the final block newline.
+ assert.equal(await page.evaluate(() => window.getSelection().toString()), expected[0].replace(/\n$/, ''));
+ assert.equal(await page.evaluate(() => window.copiedTexts.length), 4);
+
+ // Existing heading copying still uses the configured output format.
+ await page.locator('h2.topic-title > a').click();
+ await page.waitForFunction(() => window.copiedTexts.length === 5);
+ const headingCopy = await page.evaluate(() => window.copiedTexts[4]);
+ const plain = await page.locator('#copylinks-status').getAttribute('data-plain-url');
+ assert.ok(plain === '1' ? /^https?:\/\//.test(headingCopy) : /^\[url=/.test(headingCopy));
+
+ // Denied and missing APIs select the code in place for manual copying.
+ for (const mode of ['denied', 'missing', 'insecure']) {
+ await page.evaluate(mode => {
+ Object.defineProperty(window, 'isSecureContext', {configurable: true, value: mode !== 'insecure'});
+ Object.defineProperty(navigator, 'clipboard', {configurable: true, value: mode === 'missing' ? undefined : {
+ writeText: () => Promise.reject(new Error('Clipboard denied'))
+ }});
+ }, mode);
+ await first.click();
+ await page.waitForFunction(() => document.getElementById('copylinks-status').textContent === 'Automatic copying failed. The code is selected; copy it manually.');
+ assert.equal(await page.evaluate(() => window.getSelection().toString()), expected[0].replace(/\n$/, ''));
+ assert.equal(await first.textContent(), 'Copy manually');
+ assert.equal(await first.getAttribute('class'), 'copylinks-code');
+ assert.ok(await first.evaluate(button => button === document.activeElement));
+ }
+ await page.evaluate(() => {
+ Object.defineProperty(window, 'isSecureContext', {configurable: true, value: true});
+ Object.defineProperty(navigator, 'clipboard', {configurable: true, value: {
+ writeText: async text => { window.copiedTexts.push(text); }
+ }});
+ window.getSelection().removeAllRanges();
+ });
+ await first.click();
+ await page.waitForFunction(() => document.querySelector('.copylinks-code').textContent === 'Copied!');
+ assert.equal(await page.evaluate(() => window.copiedTexts[5]), expected[0]);
+ await page.waitForFunction(() => document.querySelector('.copylinks-code').textContent === 'Copy code');
+ await page.setViewportSize({width: 320, height: 740});
+ await first.focus();
+ await first.press('Tab');
+ await page.keyboard.press('Shift+Tab');
+ assert.ok(await first.evaluate(button => button === document.activeElement));
+ assert.notEqual(await first.evaluate(button => getComputedStyle(button).outlineStyle), 'none');
+ assert.ok(await first.evaluate(button => {
+ const rect = button.getBoundingClientRect();
+ return rect.left >= 0 && rect.right <= window.innerWidth;
+ }));
+ assert.match(await first.ariaSnapshot(), /button "Copy code"/);
+ if (process.env.COPYLINKS_SCREENSHOT) {
+ await page.locator('.codebox').first().screenshot({path: process.env.COPYLINKS_SCREENSHOT});
+ }
+ assert.deepEqual(errors, []);
+ const noJS = await browser.newContext({javaScriptEnabled: false});
+ const plainPage = await noJS.newPage();
+ await plainPage.goto(process.env.COPYLINKS_TEST_URL);
+ assert.equal(await plainPage.locator('.copylinks-code').count(), 0);
+ assert.ok(await plainPage.locator('.codebox p a').count() >= 2);
+ assert.deepEqual(await plainPage.locator('.codebox pre > code').allTextContents(), expected);
+ await noJS.close();
+ console.log('PASS: exact code, multiple blocks, Enter/Space, repeat feedback, Select all, heading format, denied/missing/insecure clipboard selection fallback and recovery, focus, 320px layout, accessible name, no-JS content.');
+ } finally {
+ await browser.close();
+ }
+})().catch(error => { console.error(error); process.exitCode = 1; });