Home

Developing webERP - maintaining a fork and submitting improvements

First Create Your Personal Fork of webERP

To create a fork of webERP for use in your business and to keep track of your changes (and potentially give improved code back to webERP) you first create your own github login - then browse back to

https://github.com/webERP-team/webERP

and click on the fork button - this creates a copy of the webERP repository as it is now to your own repository.

Making your own changes

If your github login is "JoeCool" then browse to your github page

http://github.com/JoeCool

click on your webERP repository - that you created above then click on the "Clone/Download" button and then the copy button to copy the URL to your repository. Now on your development machine (with git installed on it) in a terminal window change to the directory where you wish to create your copy of your webERP repository for working on. It makes sense to have the webERP code under your web-root directory so that you can test any changes you make in a browser on the same machine with http://localhost/webERP - e.g. My web-root directory is /var/www/html I had to add my user phil to the www-data group (your web-server user group my be different) and then add permissions to the downloaded files to allow the members of the group to have write access (sudo chmod -R g+w webERP ) then to clone the webERP git repository to this directory enter:

$git clone https://github.com/PhilDaintree/webERP.git

This downloads the git repository and makes a working copy on your machine under the current directory.

Getting updated code from webERP-team/webERP repository into your forked repository

When webERP developers add new functionality to the code you can keep your fork in sync with the webERP code by fetching the latest webERP code and merging back into your code. github reports on your fork if there have been commits on the webERP-team/webERP/master repository from which your fork was created in the github web interface. To get the latest changes/commits, from the command line under linux enter:

$git remote add upstream https://github.com/webERP-team/webERP.git

to make the upstream repository the webERP-team/webERP repository then

$git fetch upstream

to get the latest code then this code has to be merged with the code in your repository/branch - assuming your branch is called master to perform the merge enter:

$git merge upstream/master