...
Info |
---|
Since March 20th, 2014, all of PrestaShop's default modules have been moved into their own Github repositories (or "submodules"). This implies a few changes on your side:
|
...
- Go to the PrestaShop Github repository.
- Fork the project by clicking on the "Fork" button. The fork will appear as a "PrestaShop" repository in your own account.
You've successfully forked the PrestaShop repository, but so far it only exists on your Github account. To be able to work on the project, you will need to clone it to your local machine. - On your local machine:
- Clone your fork:
- Create a new folder on your local machine. We'll name it "PS-MyChanges", but you can use whatever name you want.
- Get the HTTPS clone URL from your Github PrestaShop repository. It should resemble this: https://github.com/xBorderie/PrestaShop.git
- Right-click on your PS-MyChanges folder, and in the Git section of the menu that appears, choose "Git Clone..."
- In the window that opens, paste the clone URL in the "URL" field and the final "\PrestaShop" mention in the "Directory" field, so that the files are downloaded at the root of the folder.
Finally, do not forget to check the "Recursive" box so that you will also get all the default modules!- If you want TortoiseGit to remember your Github username instead of asking it every time you push content to your online repository, you can add that username to your clone URL. For instance, in my case, that's https://[email protected]/xBorderie/PrestaShop.git. Note that TortoiseGit will still ask for your password. You can store that too in the clone URL, but it is not recommended, for obvious reasons: https://xBorderie:[email protected]/xBorderie/PrestaShop.git.
- Click OK: TortoiseGit will download the files and folders from your Github repo.
- (optional) Add the "upstream" remote: When a repository is cloned, it has a default remote repository called "origin" that points to your fork on Github, not the original PrestaShop repository it was forked from. To keep track of the changes in the original repository and keep your local clone updated, you need to add another remote named "upstream":
- Right-click on the PrestaShop folder in the PS-MyChanges folder (it should have a green mark if no change has been made yet), and at the bottom of the TortoiseGit submenu, choose "Settings..."
- Open the Git/Remote section of the option panel.
- Type "upstream" in the "Remote field".
- From PrestaShop's Github repository, copy the HTTPS clone URL and paste it in TortoiseGit's "URL" field. It should https://github.com/PrestaShop/PrestaShop.git.
- Click the "Add new/Save" button. TortoiseGit asks you if you want to disable tag fetching: choose "No".
- TortoiseGit asks you if you want to fetch remote branches from the newly added remote: choose "Yes".
- TortoiseGit displays a summary window: click "OK". A window will open showing that Git is fetching data. Close it once it is done, and close the still-open Settings window.
- Clone your fork:
...