Commit 2d3d2872639 for woocommerce
commit 2d3d287263901625c26995f883bd51e8f1ef6e7f
Author: Ján Mikláš <neosinner@gmail.com>
Date: Wed Nov 18 19:58:16 2026 +0100
Prepare the extension changelog formatter mirror (#71109)
* build: add the changelog formatter mirror
* chore: prepare the formatter 1.0.0 changelog
* docs: format the formatter release changelog
diff --git a/packages/php/extension-tooling/CHANGELOG.md b/packages/php/extension-tooling/CHANGELOG.md
new file mode 100644
index 00000000000..d3d84f05fe0
--- /dev/null
+++ b/packages/php/extension-tooling/CHANGELOG.md
@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0 - 2026-11-18
+
+### Added functionality
+
+- Add the shared Jetpack Changelogger formatter for WooCommerce extensions. [#71099]
diff --git a/packages/php/extension-tooling/README.md b/packages/php/extension-tooling/README.md
index 7b47f28f9c3..6583d695212 100644
--- a/packages/php/extension-tooling/README.md
+++ b/packages/php/extension-tooling/README.md
@@ -1,12 +1,16 @@
# WooCommerce extension changelog formatter
-`woocommerce/extension-changelogger` formats the `changelog.txt` used by WooCommerce extensions. Add it to `require-dev` in the extension's Composer manifest. It works with Jetpack Changelogger 6 and PHP 7.4 or later.
+`woocommerce/extension-changelogger` formats the `changelog.txt` used by WooCommerce extensions. It works with Jetpack Changelogger 6 and PHP 7.4 or later. Install it from the extension root:
+
+```sh
+composer require --dev woocommerce/extension-changelogger:^1.0
+```
Set `extra.changelogger.formatter.class` to `Automattic\WooCommerce\ExtensionTools\Changelogger\Changelog_Formatter`. Keep the plugin's title under `extra.changelogger.formatter.title` and its change types, entry ordering and versioning under `extra.changelogger`. Use the extension's existing Changelogger commands to validate change files and compile releases.
## Test with a local checkout
-Before publication, add a Composer path repository to the extension's root `composer.json`. Set a version for the local package and require that same version. Adjust the path for the location of the WooCommerce checkout.
+To rehearse unpublished changes, add a Composer path repository to the extension's root `composer.json`. Use a distinct development version and adjust the path to your WooCommerce checkout.
```json
{
@@ -15,11 +19,11 @@ Before publication, add a Composer path repository to the extension's root `comp
"type": "path",
"url": "../woocommerce/packages/php/extension-tooling",
"options": {
- "versions": { "woocommerce/extension-changelogger": "1.0.0" }
+ "versions": { "woocommerce/extension-changelogger": "dev-local" }
}
}
],
- "require-dev": { "woocommerce/extension-changelogger": "1.0.0" }
+ "require-dev": { "woocommerce/extension-changelogger": "dev-local" }
}
```
diff --git a/packages/php/extension-tooling/changelog/.gitkeep b/packages/php/extension-tooling/changelog/.gitkeep
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/packages/php/extension-tooling/changelog/wooprd-4116-extract-the-shared-woo-extension-changelog b/packages/php/extension-tooling/changelog/wooprd-4116-extract-the-shared-woo-extension-changelog
deleted file mode 100644
index 0da27310c45..00000000000
--- a/packages/php/extension-tooling/changelog/wooprd-4116-extract-the-shared-woo-extension-changelog
+++ /dev/null
@@ -1,4 +0,0 @@
-Significance: minor
-Type: add
-
-Add the shared Jetpack Changelogger formatter for WooCommerce extensions.
diff --git a/packages/php/extension-tooling/package.json b/packages/php/extension-tooling/package.json
index 0e04fb6e376..ff61f715a43 100644
--- a/packages/php/extension-tooling/package.json
+++ b/packages/php/extension-tooling/package.json
@@ -3,6 +3,7 @@
"private": true,
"description": "Jetpack Changelogger formatter for WooCommerce extensions.",
"scripts": {
+ "build:composer-package": "bash tasks/build-package.sh",
"changelog": "XDEBUG_MODE=off composer install --quiet && composer exec -- changelogger",
"lint": "composer install --no-interaction --prefer-dist && composer exec -- phpcs -s -p",
"test:php": "composer install --no-interaction --prefer-dist && composer test"
diff --git a/packages/php/extension-tooling/tasks/build-package.sh b/packages/php/extension-tooling/tasks/build-package.sh
new file mode 100644
index 00000000000..5cd88479de8
--- /dev/null
+++ b/packages/php/extension-tooling/tasks/build-package.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+package_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+build_dir="$package_dir/build"
+mirror="woocommerce/extension-changelogger"
+mirror_dir="$build_dir/$mirror"
+
+rm -rf -- "$build_dir"
+mkdir -p -- "$mirror_dir"
+printf '%s\n' "$mirror" > "$build_dir/mirrors.txt"
+
+cd -- "$package_dir"
+cp -R CHANGELOG.md LICENSE README.md composer.json composer.lock phpcs.xml src tests "$mirror_dir/"