Interested in contributing to the development of TastyIgniter? That is fantastic! All contributions are appreciated and welcome: from opening a bug report to creating a pull request.
Before contributing, please read the code of conduct.
To order to learn a little more about how TastyIgniter operates, we suggest that you read the documentation, if you’re just beginning.
This article is a guide for developers interested in contributing code to TastyIgniter.
If you have a feature idea, the TastyIgniter forum is the best place to suggest it. Please do not use GitHub issues to suggest a new feature.
Use GitHub only if you plan to contribute and develop a new feature. If you’d like to discuss your idea first, you can always join us on Slack before posting it “officially” anywhere.
Please don’t use the main GitHub for reporting issues with extensions or themes. If you have found a bug in an extension or theme, the best place to report it is with the author.
Issues are a quick way to point out a bug. If you find a bug in TastyIgniter then please check a few things first:
- Search the TastyIgniter forum, ask the community if they have seen the bug or know how to fix it.
- There is not already an open Issue
- The issue has already been fixed (look for closed Issues)
- Is it something really obvious that you can fix yourself?
We work hard to process bugs that are reported, to assist with this please ensure the following details are always included:
- Bug summary: Make sure your summary reflects what the problem is and where it is.
- Reproduce steps: Clearly mention the steps to reproduce the bug.
- Version number: The TastyIgniter version affected.
- Expected behavior: How TastyIgniter should behave on above mentioned steps.
- Actual behavior: What is the actual result on running above steps i.e. the bug behavior - include any error messages.
Please be very clear on your commit messages and pull request, duplicate or empty commit or pull request messages may be rejected without reason.
Note: This section applies specifically to those sending pull requests to any repositories under the Slack organization.
All bug fixes should be sent to the latest stable branch. Bug fixes should never be sent to the
Minor features that are fully backwards compatible with the current TastyIgniter release may be sent to the latest stable branch.
Major new features should always be sent to the
master branch, which contains the upcoming TastyIgniter release.
If you are planning to send pull requests via GitHub to the TastyIgniter repository, we suggest sending them to the
develop branch where all the latest updates and bug fixes take place.
git clone https://github.com/tastyigniter/TastyIgniter.git cd TastyIgniter # Set up a Composer path repository for TastyIgniter packages composer config repositories.0 path "packages/*" git clone https://github.com/tastyigniter/flame.git packages/flame git clone https://github.com/tastyigniter/ti-ext-frontend.git packages/frontend # etc
Next, make sure Composer accepts unstable releases from your local copies by adjusting the value of
composer install to complete the installation from the path repositories.
Follow these steps:
- Clone the tastyigniter/TastyIgniter repository
- Branch off the develop branch into a new feature branch.
- Run composer install
- Make your changes
- Run ./vendor/bin/phpunit to test your code
- Commit your code with a descriptive message.
- Submit in the pull request on Github
Reporting security issues
If you wish to contact us about any security vulnerability in TastyIgniter you may find, please send an e-mail to [email protected]
To keep the TastyIgniter codebase clean and consistent, we follow a number of coding style guidelines. Read source code when in doubt.
Do not worry if the style of your code isn’t great! After pull requests are merged, StyleCI will automatically merge any style fixes into TastyIgniter repositories. This helps us to focus on what matters.
TastyIgniter follows the PSR-2 coding and the PSR-4 autoloading standard. We do comply with a range of other style rules. Where possible, we use PHP 7 type hinting and return type declarations, and PHPDoc for inline documentation. Try to imitate the style used by the rest of the codebase.
You are very welcome to contribute to the TastyIgniter documentation. Please follow these rules if you want to contribute. Here’s how styling perfect TastyIgniter documentation pages is done:
- Try not to use H1 headers.
- A TOC list would be generated automatically for each page with at least one H2 header. The TOC would have links to all of the page’s H2 headers.
- The introductory text would be displayed below the TOC.
- Try to use only H2 and H3 headers.
- Each H2 and H3 header could have a link defined as
<a name="event-handlers"></a>or have it generated automatically.
- Avoid short, 1 sentence paragraphs. Combine short paragraphs and try to be a bit more verbose.
- Avoid short paragraphs hanging below code sections. Combine these paragraphs with the text above the code blocks.
- Use the inline code tags for all code-related - variable names, function names, syntax examples, etc.
- Don’t hesitate to make cross links to other documentation articles. There is no need to add links to the same article in the same paragraph.
- For your reference, see the pages.md or themes.md files.
Most TastyIgniter contributors develop with PHPStorm. However, feel free to use your preferred IDE.
For more information on contributing, read the guide here
See a mistake? Edit this page