Skip to content

Latest commit

 

History

History
71 lines (51 loc) · 2.74 KB

contributing.md

File metadata and controls

71 lines (51 loc) · 2.74 KB
Raw

AMP Contributing Guide

Thanks for taking the time to contribute!

To clone this repository

$ git clone --recursive [email protected]:Automattic/amp-wp.git

Updating Allowed Tags And Attributes

The file class-amp-allowed-tags-generated.php has the AMP specification's allowed tags and attributes. It's used in sanitization. To update that file:

  1. cd to the root of this plugin
  2. run bash bin/amphtml-update.sh That script is intended for a Linux environment like VVV.

Testing Media And Embed Support

The following script creates a post in order to test support for WordPress media and embeds. To run it:

  1. ssh into an environment like VVV
  2. cd to the root of this plugin
  3. run wp eval-file bin/create-embed-test-post.php
  4. go to the URL that is output in the command line

Testing Widgets Support

The following script adds an instance of every default WordPress widget to the first registered sidebar. To run it:

  1. ssh into an environment like VVV
  2. cd to the root of this plugin
  3. run wp eval-file bin/add-test-widgets-to-sidebar.php
  4. There will be a message indicating which sidebar has the widgets. Please visit a page with that sidebar.

Testing Comments Support

The following script creates a post with comments in order to test support for WordPress comments. To run it:

  1. ssh into an environment like VVV
  2. cd to the root of this plugin
  3. run wp eval-file bin/create-comments-on-test-post.php
  4. go to the URL that is output in the command line

PHPUnit Testing

Please run these tests in an environment with WordPress unit tests installed, like VVV.

Run tests:

$ phpunit

Run tests with an HTML coverage report:

$ phpunit --coverage-html /tmp/report

When you push a commit to your PR, Travis CI will run the PHPUnit tests and sniffs against the WordPress Coding Standards.

Creating a Release

Contributors who want to make a new release, follow these steps:

  1. Bump plugin versions in package.json (×1), package-lock.json (×1, just do npm install first), composer.json (×1), and in amp.php (×2: the metadata block in the header and also the AMP__VERSION constant).
  2. Add changelog entry to readme.
  3. Merge release branch into master.
  4. Run grunt deploy to to commit the plugin to WordPress.org.
  5. Create new release on GitHub targeting master, with the new plugin version as the tag and release title. Attaching the amp.zip build to the release. Publish.