ch-inofix-newsletter

A newsletter plugin for Liferay.

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 newsletter sources to the workspace's module directory: cd $WORKSPACE/modules; git clone https://github.com/inofix/ch-inofix-newsletter.git
4. Run ServiceBuilder: ./gradlew buildService
5. Build: ./gradlew 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-newsletter 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 newsletter-web project aren't validated properly,

• select the newsletter-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-newsletter -> verification -> testIntegration task from Gradle Tasks
2. Run

Standalone

1. cd ch-inofix-newsletter
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-newsletter can be obtained from https://travis-ci.org/inofix/ch-inofix-newsletter/builds