Skip to content
This repository has been archived by the owner on May 10, 2022. It is now read-only.

Latest commit

 

History

History
133 lines (84 loc) · 4.67 KB

CONTRIBUTING.md

File metadata and controls

133 lines (84 loc) · 4.67 KB
Raw

Contributing

Thank you for thinking about contributing to WP Product Review! All sorts of contributions are welcomed.

License

WP Product Review is licensed under the GPLv2+, and all contributions to WP Product Review will be released under the GPLv2+ license. By contributing to this repository, you agree to release your contribution under the GPLv2+ license.

Setting Up Local Environment

You need a WordPress Environment to run the plugin on. This project needs a lot of different packages to be installed before you can start coding, but we've made the process easier with Docker.

Getting Started with Docker

The quickest way to get up and running is to use the provided Docker setup which takes care of setting up the environment for you within seconds. Install docker and docker-compose by following the most recent instructions on the Docker site.

Once Docker is installed, fork WP Product Review repository. Clone your fork of this project and enter the working directory:

git clone http://github.com/YOUR-USERNAME/wp-product-review/
cd wp-product-review

Once inside the folder, you can run the following command to start your Docker container:

docker-compose up -d

This will make your WordPress instance up and running at http://localhost:8888

  • If you want to use a different port for your environment, then you can change it from docker-compose.yml file.

  • If you're developing themes, or core WordPress functionality alongside WP Product Review, you can make the WordPress files accessible in /wp-product-review/wordpress/ folder in your home directory.

  • If you want bash access to your environment, you can use the following command to find the ID of your Docker container:

docker ps

And then you can get bash access with the following command:

docker exec -it <ID OF YOUR CONTAINER> bash

If you want to stop your Docker container, for the time being, you can use the following command:

docker-compose stop

Moreover, if you want to delete your Docker instance, you can use:

docker-compose down

Installing Dependencies

Once you've bash access of your WordPress container, you need to enter your WP Product Review directory with:

cd /var/www/html/wp-content/plugins/wp-product-review/

Now, we need to install npm and composer dependencies with the following commands:

npm install
composer install

Now you can start making your changes to the plugin.

Running Grunt Tasks

We use Grunt for automating many tasks, such as compiling Sass to CSS, PHP Code Sniffer, and more.

Once you have made your changes, you can run Grunt tasks by running:

grunt local

It will take some time to finish all the tasks. If there are any issues found in PHP or JavaScript, it gives you a detailed log inside /logs/ folder of the plugin. Fix those issues and run grunt local again until it finishes without an error.

PHP Unit Testing

Tests for PHP use PHPUnit as the testing framework, which is run with:

phpunit

Sending a Pull Request

A good workflow for pull requests to follow is listed below:

  • Fork WP Product Review repository
  • Clone forked repository
  • Use development branch for your changes, or create a new branch from development branch.
  • Setup environment
  • Make code changes
  • Run Grunt tasks and PHPUnit tests.
  • Push branch to forked repository
  • Submit Pull Request

Reporting Security Issues

ThemeIsle team takes security bugs very seriously. Do not report potential security vulnerabilities here. Email them privately to our team at [email protected]

Reporting a Bug

We use GitHub issues for tracking bugs. When filing an issue, make sure to answer these questions:

  • What version of WP Product Review are you using?
  • What version of WordPress are you using are you using?
  • What did you do?
  • What did you expect to see?
  • What did you see instead?

Explain the problem and include additional details to help maintainers reproduce the problem:

  • Use a clear and descriptive title for the issue to identify the problem.
  • Describe the exact steps which reproduce the problem in as many details as possible, including screenshots if needed.

Localizing WP Product Review Plugin

You don't need to be a developer to contribute to WP Product Review. You can also contribute to the project by translating it to your language. You can find your locale here.

Language packs are automatically generated once 95% of the plugin's strings are translated and approved for a locale.