PHPackages automattic/vip-build-tools - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. automattic/vip-build-tools ActiveLibrary[Utility & Helpers](/categories/utility) automattic/vip-build-tools ========================== A collection of helpful build scripts for the WordPress VIP staff. 1.4.0(3mo ago)25.3k↓50%1[2 PRs](https://github.com/Automattic/vip-build-tools/pulls)MITPHPCI passing Since May 6Pushed 3mo ago7 watchersCompare [ Source](https://github.com/Automattic/vip-build-tools)[ Packagist](https://packagist.org/packages/automattic/vip-build-tools)[ RSS](/packages/automattic-vip-build-tools/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (4)Versions (27)Used By (0) VIP Build Tools =============== [](#vip-build-tools) A collection of helpful scripts to be used in CI jobs. Prerequisites ------------- [](#prerequisites) Make sure you have [composer](https://getcomposer.org/) installed. Install ------- [](#install) To get setup run the following command in the `vip-build-scripts` directory: ``` composer install ``` Script: Changelog ----------------- [](#script-changelog) Extracts changelog information from the last closed Pull Request description and sends a request to a WordPress posts endpoint. ### Options [](#options) OptionDescriptionRequired / OptionalDefault Valuewp-endpointThe WordPress posts endpoint the changelog will be posted at.Requiredstart-markerThe text marker used to find the start of the changelog description inside the PR description.Optional`Changelog Description`end-markerThe text marker used to find the end of the changelog description inside the PR description.Optional``wp-statusThe WordPress post status.Optional`draft`wp-tag-idsA comma separated list of WordPress tag ids to add to the post.Optionallink-to-prWhether or not to include the link to the PR in the post.Optional`true`changelog-sourceSource to create the changelog for. Use `last-release` to process release notes, otherwise processes last PROptionalwp-termsTaxonomies and terms to add to the post. E.g. `custom_taxonomy_slug:1,2`Optionalchangelog-titleCustom title format. Supports placeholders: `{date}`, `{datetime}`, `{pr}`, `{version}`, `{repo}`Optional`{repo} {datetime}`### Environment Variables [](#environment-variables) Most of these variables are already [built-in](https://circleci.com/docs/2.0/env-vars/#built-in-environment-variables) by CircleCI. OptionDescriptionRequired / OptionalCIRCLE\_PROJECT\_USERNAMEThe GitHub username of the current project.RequiredCIRCLE\_PROJECT\_REPONAMEThe name of the repository of the current project.RequiredCHANGELOG\_POST\_TOKENWordPress.com auth token required to post to the endpoint.RequiredGITHUB\_TOKENThe GitHub personal acess token needed to read private repositories.Optional- `CHANGELOG_POST_TOKEN` can be generated using a helper app like ([example instructions](https://wp.me/p6jPRI-4xy#comment-26288)) ### Usage Example [](#usage-example) ``` GITHUB_TOKEN="" CHANGELOG_POST_TOKEN="" CIRCLE_PROJECT_USERNAME="" CIRCLE_PROJECT_REPONAME="" php scripts/github-changelog.php \ --wp-endpoint=https://example.com/wp-json/wp/v2/posts \ --wp-status=draft \ --wp-categories=3 \ --link-to-pr=true \ --changelog-source=last-release \ --wp-terms=custom_taxonomy_slug:1 \ --wp-terms=tags:4 \ --changelog-title="VIP Dashboard {date}" ``` ### Custom Title Examples [](#custom-title-examples) The `--changelog-title` option supports the following placeholders: - `{date}` - Current date in YYYY-MM-DD format - `{datetime}` - Current date and time in YYYY-MM-DD HH:MM format - `{pr}` - Pull request number (when using default or last-pr source) - `{version}` - Release version tag (when using last-release source) - `{repo}` - Repository name **Examples:** ``` # For date-based titles --changelog-title="VIP Dashboard {date}" # Result: "VIP Dashboard 2025-01-19" # For PR-based titles --changelog-title="VIP MU plugins PR {pr}" # Result: "VIP MU plugins PR 1234" # For version-based titles (use with --changelog-source=last-release) --changelog-title="VIP-CLI v{version}" # Result: "VIP-CLI v2.3.0" ``` ### Health Score 49 — FairBetter than 95% of packages Maintenance81 Actively maintained with recent releases Popularity25 Limited adoption so far Community16 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~133 days Recently: every ~58 days Total 14 Last Release 99d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7c5869ecbb8e0eac7e8b8e0f3cf7bdd8d5fcdc4abc10a72281872c53f8639d44?d=identicon)[automattic](/maintainers/automattic) --- Top Contributors [![brunobasto](https://avatars.githubusercontent.com/u/156388?v=4)](https://github.com/brunobasto "brunobasto (19 commits)")[![nickdaugherty](https://avatars.githubusercontent.com/u/1103700?v=4)](https://github.com/nickdaugherty "nickdaugherty (18 commits)")[![seanlanglands](https://avatars.githubusercontent.com/u/565973?v=4)](https://github.com/seanlanglands "seanlanglands (13 commits)")[![t-wright](https://avatars.githubusercontent.com/u/4177859?v=4)](https://github.com/t-wright "t-wright (10 commits)")[![pschoffer](https://avatars.githubusercontent.com/u/19240162?v=4)](https://github.com/pschoffer "pschoffer (7 commits)")[![mjangda](https://avatars.githubusercontent.com/u/86105?v=4)](https://github.com/mjangda "mjangda (2 commits)") --- Tags vip ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/automattic-vip-build-tools/health.svg) ``` [![Health](https://phpackages.com/badges/automattic-vip-build-tools/health.svg)](https://phpackages.com/packages/automattic-vip-build-tools) ``` ### Alternatives [afragen/git-updater A plugin to automatically update GitHub, Bitbucket, GitLab, or Gitea hosted plugins, themes, and language packs. 3.3k1.6k](/packages/afragen-git-updater)[wp-hooks/generator Generates a JSON representation of the WordPress actions and filters in your code 86178.4k3](/packages/wp-hooks-generator)[stepanenko3/nova-cards A Laravel Nova info cards. 33143.0k](/packages/stepanenko3-nova-cards)[mobizel/markdown-docs-bundle Explore your markdown documentation files via html web pages 108.6k](/packages/mobizel-markdown-docs-bundle)[benmanu/silverstripe-styleguide Generates a styleguide for a SilverStripe theme 108.1k1](/packages/benmanu-silverstripe-styleguide) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)