search

inofix / ch-inofix-timetracker

A timetracker plugin for Liferay.
GNU General Public License v3.0
3 stars 2 forks source link
liferay portlet timetracker

readme

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,

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