GitHub Tutorial Instructions for Beginners
With 25,000+ commits from 175+ contributors in only 18 months, PrestaShop’s GitHub branches are an enormous success. Use this Github Tutorial to join in on the action. Staying true to our commitment of being Open-Source, our GitHub Repositories are becoming increasingly active each day as more community developers collaborate together. We welcome and encourage everyone to contribute to our Ecommerce solution using GitHub. You want in? Great. I’ll briefly describe what GitHub is and provide step by step instructions on how you can contribute to the PrestaShop software using GitHub.
GitHub is fueled by the version control system Git, an Open-Source project built by Linus Torvalds, creator of Linux. GitHub allows easy collaboration for developers to contribute by allowing them to “fork” (copy) project files, make changes and submit the changes to the owner of the project. The owner of the project can then easily review the changes and accept or decline the changes. All of this is done with a user-friendly navigation on a web-based interface.
It provides a central hub for anyone around the world to modify and submit code to a project, while still allowing the owner easy management collaboration with their respective contributors. GitHub, sums it up nicely, “Git allows groups of people to work on the same documents (often code) at the same time, and without stepping on each other’s toes. It’s a distributed version control system.”
GitHub Tutorial: Contribute to PrestaShop in 10 Steps
Developers who want to contribute to PrestaShop’s Open-Source software can follow these steps. [Please note that these steps are only for contributing to the PrestaShop core 1.6 development branch. Pull requests made to other branches may be ignored or deleted for code consistency.]
1) Create your GitHub account
2) Find the PrestaShop Repository List
3) Choose the Repository named “PrestaShop” this will be the latest version PrestaShop v1.6
4) Select the “1.6” branch from the dropdown seen below. [IMPORTANT: Do not select branch named “master”, requests should only be made to the “1.6” branch.]
5) Next, click on “Fork” to copy the project to your personal Github account.
6) Create another Branch within your Fork for your changes. I named mine “My-Changes”
7) Once you are in your newly created branch, example “My-Changes”, navigate to the specific file you want to modify and click Edit. Make sure that your code changes follow our Coding Standards
8) Scroll to the bottom of the page and in Commit Summary, you must follow our notation rules in order for your request to be committed. Then click, “Commit Changes”
9) [IMPORTANT] You must test your changes on your own local installation or test environment of PrestaShop to make sure the change is working as you expected.