D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
home
/
realadss
/
thathagroup.com
/
wp-content
/
plugins
/
cmb2
/
Filename :
CONTRIBUTING.md
back
Copy
# Contributing to CMB2 Thank you for your interest in contributing back to CMB2. Please help us review your issues and/or merge your pull requests by following the below guidelines. #### NOTE: The issues section is for bug reports and feature requests only. _Support is not offered for this library, and the likelihood that the maintainers will respond is very low. If you need help, please use [stackoverflow](http://stackoverflow.com/search?q=cmb), or the [wordpress.org plugin forums](http://wordpress.org/support/plugin/cmb2)._ Before reporting a bug --- 1. Please review the [documentation](https://github.com/CMB2/CMB2/wiki). Most questions revolve around the [field types](https://github.com/CMB2/CMB2/wiki/Field-Types), [field parameters](https://github.com/CMB2/CMB2/wiki/Field-Parameters), or are addressed in the [troubleshooting](https://github.com/CMB2/CMB2/wiki/Troubleshooting) section. 2. Search [issues](https://github.com/CMB2/CMB2/issues) to see if the issue has been previously reported. 3. Install the [`develop`](https://github.com/CMB2/CMB2/tree/develop) version of CMB2 and test there. How to report a bug --- 1. Specify the version number for both WordPress and CMB2. 3. Describe the problem in detail. Explain what happened, and what you expected would happen. 4. Provide a small test-case and a link to a [gist](https://gist.github.com/) containing your entire metabox registration code. 5. If helpful, include a screenshot. Annotate the screenshot for clarity. How to contribute to CMB2 --- All contributions welcome. If you would like to submit a pull request, please follow the steps below. 1. Make sure you have a GitHub account. 2. Fork the repository on GitHub. 3. **Check out the [`develop`](https://github.com/CMB2/CMB2/tree/develop) version of CMB2.** If you submit to the master branch, the PR will be closed with a link back to this document. 4. **Verify your issue still exists in the [`develop`](https://github.com/CMB2/CMB2/tree/develop) branch.** 5. Make changes to your clone of the repository. 1. Please follow the [WordPress code standards](https://make.wordpress.org/core/handbook/coding-standards). 2. If possible, and if applicable, please also add/update unit tests for your changes. 3. Please add documentation to any new functions, methods, actions and filters. 4. When committing, reference your issue (if present) and include a note about the fix. 6. [Submit a pull request](https://help.github.com/articles/creating-a-pull-request/). **Note:** You may gain more ground and avoid unecessary effort if you first open an issue with the proposed changes, but this step is not necessary. Translations --- If you are looking to provide language translation files, Please do so via [WordPress Plugin Translations](https://translate.wordpress.org/projects/wp-plugins/cmb2). Creating/Running Tests --- We use PHPUnit and the WordPress test suite for our unit/integration tests. 1. You can install the WordPress test suite [using the installer](https://github.com/CMB2/CMB2/blob/develop/tests/bin/install-wp-tests.sh#L3): `bash tests/bin/install-wp-tests.sh wordpress_test root ''`. (this will install the test suite in the temp folder on your computer, using a test database with those given credentials) 1. Install PHPUnit via composer, `composer install`. 1. Once Composer and the WordPress test sutie are installed, you can run phpunit via `./vendor/bin/phpunit` in the CMB2 directory. Additional Resources --- * [CMB2 Documentation Wiki](https://github.com/CMB2/CMB2/wiki) * [CMB2 Snippet Library](https://github.com/CMB2/CMB2-Snippet-Library) * [CMB2 API Documentation](http://cmb2.io/api/) * [General GitHub Documentation](http://help.github.com/) * [GitHub Pull Request documentation](http://help.github.com/send-pull-requests/) * [PHPUnit Tests Guide](http://phpunit.de/manual/current/en/writing-tests-for-phpunit.html)