Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Java JavaScript Other
Failed to load latest commit information.
.idea WCM-364 Regen
analytics-api WCM-1 Regen
analytics-hook WCM-374 Random JS error instance.getPendingEvents is not a function a…
analytics-processor-service WCM-384 SF
analytics-test Update reference to arquillian libraries
anonymous-users-api WCM-330 HttpHeaders.X_FORWARDED_FOR is not valid for < GA4
anonymous-users-test Update reference to arquillian libraries
benchmarks WCM-382 More accurate values for the data generation tool so we don't…
content-targeting-api WCM-364 Regen
content-targeting-deploy-extender WCM-384 SF
content-targeting-test Update reference to arquillian libraries
content-targeting-web WCM-365 Apply changes for Audience Targeting
misc WCM-77 Add jalopy.xml to have source formatting in SB generated files
portal-6-2-x-compat-hook WCM-331 Apply changes from GA3 (copy and paste)
report-campaign-content-test Update reference to arquillian libraries
report-campaign-content WCM-376 SF
report-campaign-tracking-action-test Update reference to arquillian libraries
report-campaign-tracking-action WCM-364 Apply to report deletion
report-user-segment-content-test Update reference to arquillian libraries
report-user-segment-content WCM-376 SF
rule-age Merge branch pr-86 language keys from Pootle
rule-browser Merge branch pr-86 language keys from Pootle
rule-device-test Update reference to arquillian libraries
rule-device WCM-126 add a comment for those services for which we can't use the r…
rule-facebook WCM-342 Move select out of input label. Otherwise, clicking on it tri…
rule-gender Merge branch pr-86 language keys from Pootle
rule-ip-geocode WCM-375 SF
rule-organization-member-test Update reference to arquillian libraries
rule-organization-member Merge branch pr-86 language keys from Pootle
rule-os Merge branch pr-86 language keys from Pootle
rule-role-test Update reference to arquillian libraries
rule-role WCM-126 add a comment for those services for which we can't use the r…
rule-score-points WCM-330 Initial SF
rule-site-member-test Update reference to arquillian libraries
rule-site-member Merge branch pr-86 language keys from Pootle
rule-time Merge branch 'release/1.1' into develop
rule-user-group-member-test Update reference to arquillian libraries
rule-user-group-member WCM-126 add a comment for those services for which we can't use the r…
rule-user-logged-test Update reference to arquillian libraries
rule-user-logged Merge branch pr-86 language keys from Pootle
rule-visited-test Update reference to arquillian libraries
rule-visited WCM-349 SF
runtime-dependencies WCM-1 update ivy information
runtime-test-dependencies WCM-1 update ivy information
service-test-util WCM-1 update ivy information
simulator-hook WCM-384 SF
tools WCM-117 Setup benchmarks module
tracking-action-content WCM-376 SF
tracking-action-form ant build-lang
tracking-action-link ant build-lang
tracking-action-page WCM-349 SF
tracking-action-youtube ant build-lang
.gitignore WCM-117 Ignore benchmarks output
DEVELOPING.markdown WCM-128 Apply new naming pattern.
README.markdown Update README
audience_targeting_icon.png WCM-1 add app icon
build.xml WCM-1 Build services by default
create_report.bat WCM-112 Add tool to create reports
create_report.sh WCM-112 Add tool to create reports
create_rule.bat WCM-38 Rename scripts and task to make them more specific. The same p…
create_rule.sh WCM-38 Rename scripts and task to make them more specific. The same p…
create_tracking_action.bat WCM-113 Add tool to create tracking actions
create_tracking_action.sh WCM-113 Add tool to create tracking actions
sonar.properties Exclude service sources from sonar analysis, as they autogenerated
trunk.iml WCM-3 Add hook to support assets for layouts

README.markdown

Liferay Audience Targeting application

Audience Targeting is a new App for Liferay 6.2 that will put the engagement experience of your portal at a whole new level. This app allows you to segment your audience, target specific content to different user segments, create campaigns for them and measure the campaigns' effectivness quickly.

Audience Targeting App

The Liferay Audience Targeting application is part of the Liferay Portal project. Liferay Portal is an open source enterprise web platform for building business solutions that deliver immediate results and long-term value. Liferay Portal started out as a personal development project in 2000 and was open sourced in 2001.

To get started, check out the project's community homepage at http://liferay.org!

The Audience Targeting application is a subset of plugins related to the Web Content Management Experience that enhance Liferay WCM capabilities.

The Audience Targeting App can be easily installed on Liferay Portal via Liferay Marketplace. To build the app yourself, read below for details.

Quick Start

Deployment

In order to deploy the Audience Targeting application, you need to go through the following steps:

  1. Obtain the latest version of the Liferay 6.2 SDK. You can clone locally the 6.2.x branch of the liferay-plugins repository.
  2. Init the Audience Targeting application submodule in the Liferay 6.2 SDK by running these commands inside the directory apps/content-targeting:

    git submodule init
    git submodule update
    
  3. Set these properties in the build.<username>.properties of your Liferay SDK:

    plugins.includes=*-api,*-hook,*-service,*-web,report-*,rule-*,runtime-dependencies,tracking-action-*
    plugin.excludes=*-test
    
  4. Go to apps/content-targeting and run ant build-app

Documentation

Take a look at the Liferay Portal User Guide for information about using Liferay Portal.

The Audience Targeting application is built on top of Liferay Portal and follows the same usability patterns. For more information about how to use Audience Targeting, read the Targeting Content to your Audience section.

There are also available several Tutorials in the Liferay Developer Network to guide you through all the available extensions to the Audience Targeting App.

Development

The master branch of this repository will always contain the latest release available of the app.

The latest work can be found in the branch develop.

Please, send any pull request to the user @liferay and the branch develop and we will start a discussion there about your changes.

The master branch of the Liferay Audience Targeting application is developed for Liferay 6.2 CE using the 6.2 version of the plugins SDK.

The Audience Targeting application is designed as a framework to be extended by other developers easily. See the Audience Targeting tutorials.

Source Code

The source code of the Audience Targeting application is located in the liferay-apps-content-targeting repository. This repository is aggregated as a submodule of the liferay-plugins repository under /apps.

Execute git tag to see the tags of the different released versions of the app.

Contributing

We welcome any and all contributions! If you have an idea for a new plugin or a new feature in an existing plugin, and wish to implement it, just send a pull request to the user @liferay and to the branch develop and we will start a discussion there around your changes.

You can contact us in the forums and create bugs or feature requests in our issue tracker.

Testing

In order to execute the Integration tests locally, you have to go through the following steps:

  1. Append the test modules to the plugins.includes property of your build.<username>.properties file:

    plugins.includes=<all other audience targeting application modules>,*-test,runtime-test-dependencies
    
  2. Make sure you have deployed all the Audience Targeting application plugins and that your server is running.

  3. Go to apps/content-targeting and run ant test. In order to run the tests from the IDE (e.g. IntelliJ), you should update the folder of the runner to use the folder of your plugin as the working directory.

OSGI Console

The OSGi bundle console gives information about the bundles that are currently available in the container and allows some operations over them. In order to start the console you need to add this line to your portal-ext.properties

module.framework.properties.osgi.console=11311

Then you can just run telnet localhost 11311 once the Audience Targeting application plugins have been deployed.

Some useful commands:

  • bundles: list bundles and status
  • start [bundle id]: starts a bundle
  • stop [bundle id]: stops a bundle
  • uninstall [bundle id]: uninstalls a bundle

More Information

Bugs and Feature Requests for the project can be found in our issue tracker.

Feel free to ask us anything in our forums.

For more information about filing bugs, staying updated with Liferay on social media, and other ways to participate, check out the Liferay Community Homepage and consult the README file in the liferay-portal repository.

Liferay Portal Community Edition License

This library, Liferay Portal Community Edition, is free software ("Licensed Software"); you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; including but not limited to, the implied warranty of MERCHANTABILITY, NONINFRINGEMENT, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

Something went wrong with that request. Please try again.