Skip to content

Latest commit

 

History

History
63 lines (39 loc) · 1.49 KB

CONTRIBUTING.md

File metadata and controls

63 lines (39 loc) · 1.49 KB

This guide is meant for developers wanting to work on the plugin code.

Setup

Make a fork and clone it:

git clone --recurse-submodules [email protected]:{YOUR GITHUB USERNAME}/wp-posts-to-posts.git posts-to-posts

You can now work on the PHP and CSS files. Please follow the WordPress Coding Standards.

JavaScript

Don't modify admin/box.js directly. Instead:

npm install -g coffee-script

and edit the admin/box.coffee file. To compile it, run:

coffee -c admin

Unit Tests

If you want to add a new feature, please consider adding a new test for it as well.

The following instructions assume a UNIX-like environment (OS X, Linux, etc.).

Step 1: Set un an environemt variable that defines the path to the test suite:

export WP_TESTS_DIR=/tmp/wordpress-tests/

This step will be needed each time you want to run the tests, so you might want to put it in your .bashrc file, to be executed automatically.

Step 2: Install and configure the official WordPress testing suite:

./bin/install-wp-tests

Note that all data in the test DB will be deleted once you run the tests.

Step 4: Install PHPUnit via Composer:

php composer.phar install --dev

Step 5: Run the tests:

./vendor/bin/phpunit