ch-inofix-contact-manager

A vCard based contact manager for the Liferay Portal.

How To Build

1. Install blade: curl https://raw.githubusercontent.com/liferay/liferay-blade-cli/master/installers/local | sh
2. Create a liferay workspace: WORKSPACE=my-workspace; blade init $WORKSPACE
3. Checkout contact-manager sources to the workspace's module directory: cd $WORKSPACE/modules; git clone https://github.com/inofix/ch-inofix-contact-manager.git
4. Run ServiceBuilder: gradle buildService
5. Build: gradle jar

How To Deploy

Change the current working directory to $WORKSPACE/bundles/deploy and install the osgi-modules required by the contact-manager.

1. cd $WORKSPACE/bundles/deploy
2. wget http://liferay-repo.inofix.ch/7.0.3/vinnie_2.0.0.jar
3. wget http://central.maven.org/maven2/com/googlecode/ez-vcard/ez-vcard/0.10.2/ez-vcard-0.10.2.jar

How To Contribute

1. Fork this repository to your individual github account.
2. Clone your personal fork to your local machine.
3. Use feature branches to work on new features or known issues.
4. Merge finished features into your individual master branch and
5. create pull-requests, to contribute your solutions to the inofix master branch.

Stay up-to-date

1. Change the current working directory to your local project.
2. Configure https://github.com/inofix/ch-inofix-contact-manager as additional upstream remote (see: https://help.github.com/articles/configuring-a-remote-for-a-fork/)
3. Sync inofix-master with your individual fork (see: https://help.github.com/articles/syncing-a-fork/):
4. Fetch upstream/master to your local copy: git fetch upstream
5. Check out your fork's local 'master' branch: git checkout master
6. Merge the changes from 'upstream/master' into your local master branch. This brings your fork's master branch into sync with the upstream repository, without losing your local changes: git merge upstream/master
7. Push merged master to your individual github account and
8. create a pull-request, to contribute your solution to the inofix master branch.

Note for Eclipse / Liferay-IDE developers

If the JSPs of the contact-manager-web project aren't validated properly,

• select the contact-manager-web in the Project-Explorer view
• open the context menu with the right mouse key
• select "Configure" and
• choose "Add JSP Validation Support"
• select the contact-manager-web in the Project-Explorer view
• choose CTRL + F5 to refresh your project

You may have to restart Eclipse, too in order to have your JSPs validated.

How To Test

In the Liferay workspace

1. Select ch-inofix-timetracker -> verification -> testIntegration task from Gradle Tasks
2. Run

Standalone

1. cd ch-inofix-contact-manager
2. ln -s standalone-gradle.properties gradle.properties
3. ln -s standalone-settings.gradle settings.gradle
4. ./gradlew clean initBundle buildService testIntegration

Latest Travis-test-results for ch-inofix-contact-manager can be obtained from https://travis-ci.org/inofix/ch-inofix-contact-manager/builds