Liferay is a Gartner Magic Quadrant Leader for the Sixth Year! Find out why
« Back to Liferay Faces

Contributing to Liferay Faces

The Liferay Faces project source code is contained in a Git repository hosted at GitHub. If you would like to make a contribution to the source code, here are some instructions:

1. Create an issue in the JIRA issue tracker for the FACES project. For example, see: FACES-1460

2. If you haven't done so already, create an account at GitHub.

3. Visit the following page with your browser and fork the liferay-faces project to your account:

4. Clone the repository to your local hard drive:

    git clone
    cd liferay-faces

5. Determine the branch that is most appropriate, and switch to that branch. For most software projects, contributions are done using the master branch, but this might not be appropriate for Liferay Faces. Currently, the master branch is designed for JSF 2.2 which has not yet been released by the JCP. So if you are using JSF 2.0/2.1 on Liferay 6.1, then it would be more appropriate to switch to the 3.1.x branch. For example:

    git checkout 3.1.x

6. If you haven't done so already, then specify "upstream" as one of your remotes:

    git remote add upstream

7. PLEASE KEEP YOUR FORK IN SYNC with upstream. For example:

    git pull --rebase upstream 3.1.x
     git push origin 3.1.x
8. Create a branch with the same name as the JIRA issue. For example:
    git branch FACES-1460
9. Switch to the new branch
    git checkout FACES-1460
10. Do your development/bugfix work in this branch, commit files, and then push to origin.
    git commit -a
    git push origin FACES-1460
11. Send a pull request using the button at the GitHub website: 
12. Click on the "Contribute Solution" button for the JIRA issue and complete the form, and please enter the URL of the pull request so that we can associate the issue with your contribution branch.
Thanks in advance for your contributions!
2 Attachments
Average (0 Votes)
The average rating is 0.0 stars out of 5.