Merge pull request #20 from basicrum/wp-marketplace-address-feedback

Wp marketplace address feedback

Author: ceckoslab

.github/workflows/ci.yml

@@ -242,13 +242,13 @@ jobs:
         run: sh tools/build-release.sh
 
       - name: Install and test packaged plugin
-        run: sh tools/smoke-test-release.sh release/basicrum.zip
+        run: sh tools/smoke-test-release.sh release/basicrum-real-user-monitoring.zip
 
       - name: Upload release artifact
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: basicrum-release
           path: |
-            release/basicrum.zip
-            release/basicrum.zip.sha256
+            release/basicrum-real-user-monitoring.zip
+            release/basicrum-real-user-monitoring.zip.sha256
           if-no-files-found: error

.github/workflows/prerelease.yml

@@ -42,11 +42,11 @@ jobs:
         run: sh tools/build-release.sh
 
       - name: Install and test packaged plugin
-        run: sh tools/smoke-test-release.sh release/basicrum.zip
+        run: sh tools/smoke-test-release.sh release/basicrum-real-user-monitoring.zip
 
       - name: Upload release assets
         uses: softprops/action-gh-release@3d0d9888cb7fd7b750713d6e236d1fcb99157228 # v3.0.2
         with:
           files: |
-            release/basicrum.zip
-            release/basicrum.zip.sha256
+            release/basicrum-real-user-monitoring.zip
+            release/basicrum-real-user-monitoring.zip.sha256

.github/workflows/release.yml

@@ -45,7 +45,7 @@ jobs:
         run: sh tools/build-release.sh
 
       - name: Install and test packaged plugin
-        run: sh tools/smoke-test-release.sh release/basicrum.zip
+        run: sh tools/smoke-test-release.sh release/basicrum-real-user-monitoring.zip
 
       - name: Create GitHub release and upload assets
         uses: softprops/action-gh-release@3d0d9888cb7fd7b750713d6e236d1fcb99157228 # v3.0.2
@@ -54,5 +54,5 @@ jobs:
           generate_release_notes: true
           fail_on_unmatched_files: true
           files: |
-            release/basicrum.zip
-            release/basicrum.zip.sha256
+            release/basicrum-real-user-monitoring.zip
+            release/basicrum-real-user-monitoring.zip.sha256

.gitignore

@@ -27,7 +27,7 @@ coverage.xml
 
 # Release artifacts
 /release/
-/basicrum.zip
+/basicrum-real-user-monitoring.zip
 
 # Local research and planning notes
 /plan-refs/

AGENTS.md

@@ -50,7 +50,8 @@ in the matching skill.
 
 ## Conventions
 
-- Follow WordPress-Core/WPCS. The text domain is `basicrum`.
+- Follow WordPress-Core/WPCS. The WordPress.org slug and text domain are
+  `basicrum-real-user-monitoring`.
 - Guard PHP files with `ABSPATH`; escape output and sanitize all input.
 - Use ASCII hyphens (`-`); do not use typographic dashes in source, comments,
   documentation, or user-facing text.

CONTRIBUTING.md

@@ -24,7 +24,7 @@ The development site is available at <http://localhost:9080/> with `admin` / `ba
 
 The installable plugin is [`plugins/basicrum/`](plugins/basicrum/). Repository root files provide development, browser-test, Docker, CI, and release tooling.
 
-Follow the permanent conventions in [AGENTS.md](AGENTS.md), including WordPress Coding Standards, PHP 7.4 compatibility, ASCII hyphens, synchronized version metadata, privacy-safe consent behavior, and immutable GitHub Actions pins.
+Follow the permanent conventions in [AGENTS.md](AGENTS.md), including WordPress Coding Standards, PHP 7.4 compatibility, ASCII hyphens, the assigned WordPress.org text domain, synchronized version metadata, privacy-safe consent behavior, and immutable GitHub Actions pins.
 
 When changing user-facing text, regenerate the WordPress POT template. Locale-specific PO and MO files are not bundled. When changing settings, keep defaults, rendering, validation, runtime behavior, tests, and documentation synchronized.
 

Makefile

@@ -4,7 +4,9 @@ WP_SERVICE = wordpress
 DB_SERVICE = db
 WPCLI_SERVICE = wpcli
 JS_SERVICE = javascript
-WPCLI_PLUGIN_WORKDIR = /var/www/html/wp-content/plugins/basicrum
+PLUGIN_SLUG = basicrum-real-user-monitoring
+RELEASE_ARCHIVE = release/$(PLUGIN_SLUG).zip
+WPCLI_PLUGIN_WORKDIR = /var/www/html/wp-content/plugins/$(PLUGIN_SLUG)
 PLUGIN_DIR = plugins/basicrum
 PLUGIN_WORKDIR = /workspace
 TEST_DB_NAME = wordpress_test
@@ -92,6 +94,7 @@ composer-audit:
 conventions:
 	sh tools/verify-ascii-hyphens.sh
 	sh tools/verify-version-consistency.sh
+	sh tools/verify-text-domain.sh
 	sh tools/verify-boomerang-provenance.sh
 
 translations:
@@ -128,10 +131,10 @@ package:
 	$(COMPOSE) run --rm --no-deps -w /repo $(PHP_SERVICE) sh /tools/build-release.sh /repo/$(PLUGIN_DIR) /repo/release
 
 package-verify:
-	$(COMPOSE) run --rm --no-deps -w /repo $(PHP_SERVICE) sh /tools/verify-release.sh /repo/release/basicrum.zip
+	$(COMPOSE) run --rm --no-deps -w /repo $(PHP_SERVICE) sh /tools/verify-release.sh /repo/$(RELEASE_ARCHIVE)
 
 package-smoke: package
-	sh tools/smoke-test-release.sh release/basicrum.zip
+	sh tools/smoke-test-release.sh $(RELEASE_ARCHIVE)
 
 clean:
 	$(COMPOSE) down -v

README.md

@@ -2,7 +2,7 @@
 
 Basicrum is a privacy-first Real User Monitoring integration for WordPress. It loads the bundled Boomerang library, tags WordPress and WooCommerce page types, and sends performance beacons to a configured hosted or self-hosted Basicrum collector.
 
-The installable plugin lives in [`plugins/basicrum/`](plugins/basicrum/). Build release artifacts through the repository tooling instead of zipping the source directory directly.
+The plugin source lives in [`plugins/basicrum/`](plugins/basicrum/). Release tooling packages it under the assigned WordPress.org directory slug `basicrum-real-user-monitoring`; do not zip the source directory directly.
 
 ## Privacy
 
@@ -18,7 +18,7 @@ The complete webmaster-facing behavior and consent instructions live in the [Wor
 
 | Path | Purpose |
 | --- | --- |
-| [`plugins/basicrum/`](plugins/basicrum/) | Installable plugin source |
+| [`plugins/basicrum/`](plugins/basicrum/) | Plugin source packaged under the WordPress.org slug |
 | [`tools/`](tools/) | Setup, test, and release scripts |
 | [`docker/`](docker/) | Local WordPress and WooCommerce environments |
 | [`tests/javascript/`](tests/javascript/) | Browser tests for loaders, consent adapters, and settings |
@@ -53,7 +53,7 @@ See [AGENTS.md](AGENTS.md) for repository invariants, the complete check suite,
 
 ## Releases
 
-`make package` creates `release/basicrum.zip` and its SHA-256 checksum from a temporary production Composer install. `make package-smoke` installs that ZIP into clean WordPress and checks activation, the administration page, frontend loading, and PHP logs.
+`make package` creates `release/basicrum-real-user-monitoring.zip` and its SHA-256 checksum from a temporary production Composer install. `make package-smoke` installs that ZIP into clean WordPress and checks activation, the administration page, frontend loading, and PHP logs.
 
 The plugin header version, `BASICRUM_VERSION`, WordPress `Stable tag`, top changelog version, and `v<version>` release tag must match.
 
@@ -64,7 +64,7 @@ git tag -a vX.Y.Z -m "Basicrum vX.Y.Z"
 git push origin vX.Y.Z
 ```
 
-The tag workflow verifies the version, runs the release tests, builds and smoke-tests the installable ZIP, and only then creates the GitHub Release with `basicrum.zip` and `basicrum.zip.sha256`. Do not create the GitHub Release or upload the ZIP manually.
+The tag workflow verifies the version, runs the release tests, builds and smoke-tests the installable ZIP, and only then creates the GitHub Release with `basicrum-real-user-monitoring.zip` and `basicrum-real-user-monitoring.zip.sha256`. Do not create the GitHub Release or upload the ZIP manually.
 
 ## Contributing and security
 

checklist.md

@@ -148,7 +148,7 @@ Acceptance criteria:
 - [ ] Record the minifier and its version in a lock file.
 - [ ] Make CI regenerate the loaders and fail when the committed output differs.
 - [ ] Document the source and version of the bundled Boomerang asset.
-- [x] Add a repeatable command for generating `languages/basicrum.pot`.
+- [x] Add a repeatable command for generating `languages/basicrum-real-user-monitoring.pot`.
 - [x] Keep locale-specific PO and MO files out of the repository and release ZIP.
 - [x] Keep POT generation as a local maintenance command; the standalone
   translation CI job was removed by product decision.
@@ -164,7 +164,10 @@ Acceptance criteria:
   tracked source, comments, documentation, and user-facing text.
 - [x] Add a version consistency check covering the plugin header,
   `BASICRUM_VERSION`, `Stable tag`, changelog, and release tag.
-- [x] Run both checks in pull requests and pushes to the main branch.
+- [x] Add a WordPress.org slug and text-domain consistency check covering the
+  plugin header, source literals, WPCS configuration, POT filename, and release
+  package identity.
+- [x] Run all convention checks in pull requests and pushes to the main branch.
 - [x] Document the checks in `AGENTS.md` and the contributor documentation.
 
 Acceptance criteria:

docker-compose.yml

@@ -33,7 +33,7 @@ services:
       - "${WORDPRESS_PORT:-9080}:80"
     volumes:
       - wordpress_data:/var/www/html
-      - ./plugins/basicrum:/var/www/html/wp-content/plugins/basicrum
+      - ./plugins/basicrum:/var/www/html/wp-content/plugins/basicrum-real-user-monitoring
 
   wpcli:
     image: wordpress:cli-2.12.0-php8.2
@@ -53,7 +53,7 @@ services:
       WP_ADMIN_EMAIL: ${WP_ADMIN_EMAIL:-admin@example.test}
     volumes:
       - wordpress_data:/var/www/html
-      - ./plugins/basicrum:/var/www/html/wp-content/plugins/basicrum
+      - ./plugins/basicrum:/var/www/html/wp-content/plugins/basicrum-real-user-monitoring
       - ./tools:/tools:ro
 
   php: