ch-inofix-timetracker

A timetracker plugin for Liferay.

How To Build

Commandline

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 timetracker sources to the workspace's module directory: cd $WORKSPACE/modules; git clone https://github.com/inofix/ch-inofix-timetracker.git
4. Change working directory to ch-inofix-timetracker: cd $WORKSPACE/modules/ch-inofix-timetracker
5. Run ServiceBuilder: ./gradlew buildService
6. Build: ./gradlew jar

IDE

1. Download latest IDE from Sourceforge: https://sourceforge.net/projects/lportal/files/Liferay%20IDE/3.1.2%20GA3/liferay-ide-eclipse-linux-x64-3.1.2-ga3-201709011126.tar.gz/download
2. tar -xvzf liferay-ide-eclipse-linux-x64-3.1.2-ga3-201709011126.tar.gz
3. mv eclipse liferay-ide-3.1.2
4. Start IDE with: ./liferay-ide-3.1.2/eclipse &
5. Create Eclipse Workspace: ~/workspace
6. Close welcome screen
7. File -> New-> Project -> Liferay Workspace Project
8. Project name: my-liferay-project, Use default location: yes (default), Build Type: Gradle (default)
9. Finish
10. Update liferay.workspace.bundle.url in gradle.properties. Use: liferay.workspace.bundle.url=https://cdn.lfrs.sl/releases.liferay.com/portal/7.0.4-ga5/liferay-ce-portal-tomcat-7.0-ga5-20171018150113838.zip
11. Switch to Gradle Tasks view
12. Expand workspace node
13. Expand bundle node
14. run initBundle
15. Switch to Servers view
16. New Server -> Liferay 7.x -> Next
17. Name: Liferay 7.x
18. Liferay Portal Bundle Directory: $WORKSPACE/bundles
19. Select runtime JRE: java-8-openjdk-amd64
20. Finish
21. Doubleclick configured server (Liferay 7.x., see above), edit Launch settings:
22. Liferay Launch: Custom Launche Settings: yes; Use developer mode: yes
23. Save
24. Start server

How To Contribute

1. Fork this repository to your individual github account.
2. Clone your personal fork to your local liferay worspace: cd $WORKSPACE/modules/
3. git clone https://github.com/<your-personal-github-account>/ch-inofix-timetracker
4. Use feature branches to work on new features or known issues.
5. Merge finished features into your individual master branch and
6. 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-timetracker 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 timetracker-web project aren't validated properly,

• select the timetracker-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 timetracker-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-timetracker
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-timetracker can be obtained from https://travis-ci.org/inofix/ch-inofix-timetracker/builds