Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
110 lines (68 loc) · 4.46 KB

CONTRIBUTING.md

File metadata and controls

110 lines (68 loc) · 4.46 KB

Contributing to the MCP Adapter canonical plugin

Thank you for your interest in contributing to the MCP Adapter canonical plugin! This contains all the documentation for getting started and contributing to the plugin and will eventually be a part of the AI Team Handbook.

How to Contribute

Please report (non-security) issues and open pull requests on GitHub. See below for information on reporting potential security/privacy vulnerabilities.

Join the #core-ai channel on WordPress Slack (sign up here).

Coding standards

In general, all code must follow the WordPress Coding Standards and best practices. All code in the Performance Lab plugin must follow these requirements:

  • WordPress: As of MCP Adapter v0.1.0, released {@todo}, the plugin's minimum WordPress version requirement is 6.8.
  • PHP: The minimum required version right now is 7.4. This is subject to change and will be brought in sync with the WordPress core minimum PHP version requirement closer to release.

We include several tools to help ensure your code meets contribution

Guidelines

  • As with all WordPress projects, we want to ensure a welcoming environment for everyone. With that in mind, all contributors are expected to follow our Code of Conduct.

  • All WordPress projects are licensed under the GPLv2+, and all contributions to Gutenberg will be released under the GPLv2+ license. You maintain copyright over any contribution you make, and by submitting a pull request, you are agreeing to release that contribution under the GPLv2+ license.

Reporting Security Issues

Please see [SECURITY.md] (@TODO).

Local Setup

Prerequisites

  • Node.js: 20.x (NVM recommended)
  • Docker
  • Git
  • Composer: (if you prefer to run the Composer tools locally)

You can use Docker and the wp-env tool to set up a local development environment, instead of manually installing the specific testing versions of WordPress, PHP, and Composer. For more information, see the wp-env documentation.

Installation

  1. Clone the repository:

    git clone https://github.com/WordPress/mcp-adapter.git

  2. Change into the project folder and install the development dependencies:

    ## If you're using NVM, make sure to use the correct Node.js version:
nvm use

## Then install the NPM dependencies:
npm install

# If you are using Composer locally, also run:
composer install

  3. Start the local development environment:

    npm run wp-env start

The WordPress development site will be available at http://localhost:8888 and the WP Admin Dashboard will be available at http://localhost:8888/wp-admin/. You can log in to the admin using the username admin and password password.

Useful Commands

Installing Dependencies

  • composer install: Install PHP dependencies.
  • npm install: Install JavaScript dependencies.

Accessing the Local Environment

  • npm run wp-env start: Start the local development environment.
  • npm run wp-env stop: Stop the local development environment.
  • npm run wp-env run tests-cli YOUR_CMD_HERE: Run WP-CLI commands in the local environment.

For more information on using wp-env, see the wp-env documentation.

Linting and Formatting

  • npm run lint:php: Runs PHPCS linting on the PHP code.
  • npm run lint:php:fix: Autofixes PHPCS linting issues.
  • npm run lint:php:stan: Runs PHPStan static analysis on the PHP code.
  • npm run format: Formats non-PHP files using Prettier.

Running Tests

PHPUnit tests can be run using the following command:

npm run test:php

For detailed testing instructions including running specific tests, generating coverage reports, and troubleshooting, see the Testing Guide.

Building the plugin for distribution

To build the plugin for distribution, you can use the following command:

# IMPORTANT!: Make sure you've cleaned up any dev-dependencies from Composer first:
composer install --no-dev

npm run plugin-zip