包简介

A collection of helpful build scripts for the WordPress VIP staff.

README 文档

README

A collection of helpful scripts to be used in CI jobs.

Prerequisites

Make sure you have composer installed.

Install

To get setup run the following command in the vip-build-scripts directory:

composer install

Script: Changelog

Extracts changelog information from the last closed Pull Request description and sends a request to a WordPress posts endpoint.

Options

Option	Description	Required / Optional	Default Value
wp-endpoint	The WordPress posts endpoint the changelog will be posted at.	Required
start-marker	The text marker used to find the start of the changelog description inside the PR description.	Optional	`<h2>Changelog Description`
end-marker	The text marker used to find the end of the changelog description inside the PR description.	Optional	`<h2>`
wp-status	The WordPress post status.	Optional	`draft`
wp-tag-ids	A comma separated list of WordPress tag ids to add to the post.	Optional
link-to-pr	Whether or not to include the link to the PR in the post.	Optional	`true`
changelog-source	Source to create the changelog for. Use `last-release` to process release notes, otherwise processes last PR	Optional
wp-terms	Taxonomies and terms to add to the post. E.g. `custom_taxonomy_slug:1,2`	Optional
changelog-title	Custom title format. Supports placeholders: `{date}`, `{datetime}`, `{pr}`, `{version}`, `{repo}`	Optional	`{repo} {datetime}`

Environment Variables

Most of these variables are already built-in by CircleCI.

Option	Description	Required / Optional
CIRCLE_PROJECT_USERNAME	The GitHub username of the current project.	Required
CIRCLE_PROJECT_REPONAME	The name of the repository of the current project.	Required
CHANGELOG_POST_TOKEN	WordPress.com auth token required to post to the endpoint.	Required
GITHUB_TOKEN	The GitHub personal acess token needed to read private repositories.	Optional

CHANGELOG_POST_TOKEN can be generated using a helper app like https://github.com/Automattic/node-wpcom-oauth (example instructions)

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

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"

automattic/vip-build-tools 适用场景与选型建议

automattic/vip-build-tools 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 5.61k 次下载、GitHub Stars 达 2，最近一次更新时间为 2021 年 05 月 07 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 automattic/vip-build-tools 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 automattic/vip-build-tools 我们能提供哪些服务？

定制开发 / 二次开发

基于 automattic/vip-build-tools 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

automattic/vip-build-tools

包简介