Integrate in your CI/CD

Nothing to configure to run wpc in a pipeline: the interactive rendering turns itself off outside a terminal (and whenever CI is set), so every command below behaves exactly as it prints here. Use --output=json when you need to parse the result.

Use the Docker image

The CLI is published on Docker Hub with PHP, the zip extension, composer, git and unzip. The image has no entrypoint: wpc is on the PATH, so it works as a GitLab CI job image as is.

Tag	Content
`latest`	Latest stable release, on the newest supported PHP (8.5).
`php8.2` … `php8.5`	Latest stable release, on that PHP version.
`<version>` (e.g. `2.0.0`)	That exact release, on the newest supported PHP.
`<version>-php8.2` … `<version>-php8.5`	That exact release, on that PHP version.

The php8.x and <version>-php8.x tags are published from 2.0.0 onwards; 1.x releases only have <version> tags. Pin a full X.Y.Z version in pipelines you want to keep stable. There are no X.Y or X tags.

Example of CI/CD with Gitlab

Example of .gitlab-ci.yml file to put in your git project :

.gitlab-ci.yml

stages:
  - 📦️ build
  - 🚀 publish

variables:
  GIT_SUBMODULE_STRATEGY: recursive
  GIT_SUBMODULE_FORCE_HTTPS: "true"
  PLUGIN_SLUG: dummy
  WPC_CLI_VERSION: "2.0.0"   # a full X.Y.Z release tag
  # Define WPC_API_KEY as a masked CI/CD variable in your project settings.

⛏️ generate zip:
  stage: 📦️ build
  image: wpcontent/wpc-cli:${WPC_CLI_VERSION}
  script:
    - composer install --no-dev --optimize-autoloader
    - wpc plugin build --slug=${PLUGIN_SLUG} --output-dir=./ .
  artifacts:
    paths:
      - ./${PLUGIN_SLUG}.zip

🗂️ push to registry:
  stage: 🚀 publish
  image: wpcontent/wpc-cli:${WPC_CLI_VERSION}
  script:
    - wpc plugin push -m "${CI_COMMIT_MESSAGE}" ./${PLUGIN_SLUG}.zip
  when: manual

workflow:
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

Use the CLI in your own image

If your build needs other tools or PHP extensions, copy the wpc binary from the official image into yours. Your image must provide PHP 8.2 or later with the zip extension, which wpc plugin build needs:

Dockerfile

FROM php:8.5-alpine

RUN apk add --no-cache libzip \
    && apk add --no-cache --virtual .build-deps $PHPIZE_DEPS libzip-dev \
    && docker-php-ext-install zip \
    && apk del .build-deps

COPY --from=wpcontent/wpc-cli:latest /usr/local/bin/wpc /usr/local/bin/wpc

Get Started

Manage plugins

Manage themes

Go further

Use the Docker image

Example of CI/CD with Gitlab

Use the CLI in your own image

​Use the Docker image

​Example of CI/CD with Gitlab

​Use the CLI in your own image

Use the Docker image

Example of CI/CD with Gitlab

Use the CLI in your own image