Bootstrap Liferay Advanced Developer Environments (BLADE)

Liferay's Blade samples provides bootstrap project environments for all major build tools in common use for Java projects so that Liferay development can start quickly and easily. These templates can be copied freely and contributions are welcome. See the Contribution Guidelines for more information on how to contribute new sample projects and/or documentation.

Build Tools

The template projects are categorized under three build tools:

gradle - A set of Liferay projects that can be bootstrapped onto the com.liferay.plugin (a Gradle plugin) based development environment.
liferay-workspace - A set of Liferay projects configured to work in a Liferay Workspace environment.
maven - A set of Liferay projects that can be bootstrapped onto the Maven development environment.

Contribution Guidelines

When contributing a new sample, you must include accompanying documentation.

Sample Code

You can contribute additional template samples by creating the project for one of the three build tools and sending a pull request to liferay/liferay-blade-samples. A repository admin will review the submission and replicate the project for the other three build tools, once the submission is approved.

Sample Docs

You can contribute documentation by adding a README.markdown file to the root folder of a sample project. This article should include the following sections:

What does this sample do when it's deployed?
What API(s) and/or code components does this sample highlight?
How does this sample leverage the API(s) and/or code component?

For example, the Resource Bundle Override article explains the resource-bundle-override sample using the aforementioned sections.

You can send a pull request to codyhoag/liferay-blade-samples for documentation-only submissions, or tag @codyhoag in a new sample contributed to liferay/liferay-blade-samples that includes documentation.

Frameworks

The template projects also demonstrate how to use various frameworks:

Blueprint
Declarative Services (DS)
OSGi API

A Note on Blueprint

Liferay does not provide a Blueprint implementation out of the box. To use the Blueprint modules provided in Blade, you must deploy a Blueprint implementation such as Apache Aries - Blueprint. Three bundles are needed:

Simply download the bundles from mvnrepository and drop them in your osgi/modules folder before deploying Blueprint bundles.

Liferay Extension Points and Template Projects

Apps

Action Command Portlet

Template project description: Demonstrates the MVCActionCommand extension point. It integrates the action command named greet with portlet greeter. To see how this example works, a portlet plugin with a portlet named greeter (javax.portlet.name='greeter') should be deployed. The command adds a key greeting_message to Liferay SessionMessages, along with a session attribute GREETER_MESSAGE. You can independently deploy the bundle blade.portlet.actioncommand (i.e., refresh the bundle without the need to redeploy the Portlet plugin).

Build tool	Link to project's source code
Gradle	./gradle/apps/action-command-portlet
Liferay Workspace	./liferay-workspace/apps/action-command-portlet
Maven	./maven/apps/action-command-portlet

Blueprint Portlet

Template project description: Demonstrates how to use the Blueprint framework for registering a Liferay MVC portlet.

Build tool	Link to project's source code
Gradle	./gradle/apps/blueprint-portlet
Liferay Workspace	./liferay-workspace/apps/blueprint-portlet
Maven	./maven/apps/blueprint-portlet

Configuration Action

Template project description: Demonstrates the ConfigurationAction integration point.

Build tool	Link to project's source code
Gradle	./gradle/apps/configuration-action
Liferay Workspace	./liferay-workspace/apps/configuration-action
Maven	./maven/apps/configuration-action

Control Panel Portlet

Build tool	Link to project's source code
Gradle	./gradle/apps/control-panel-portlet
Liferay Workspace	./liferay-workspace/apps/control-panel-portlet
Maven	./maven/apps/control-panel-portlet

DS Portlet

Template project description: Demonstrates how to use the DS (Declarative Services) framework for registering a Liferay MVC portlet.

Build tool	Link to project's source code
Gradle	./gradle/apps/ds-portlet
Liferay Workspace	./liferay-workspace/apps/ds-portlet
Maven	./maven/apps/ds-portlet

Filter Portlet

Template project description: Demonstrates how to apply PortletFilters.

Build tool	Link to project's source code
Gradle	./gradle/apps/filter-portlet
Liferay Workspace	./liferay-workspace/apps/filter-portlet
Maven	./maven/apps/filter-portlet

FreeMarker Portlet

Template project description: Demonstrates a simple FreeMarker portlet.

Build tool	Link to project's source code
Gradle	./gradle/apps/freemarker-portlet
Liferay Workspace	./liferay-workspace/apps/freemarker-portlet
Maven	./maven/apps/freemarker-portlet

Greedy Policy Option Portlet

Refer to this sample's Readmes for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/greedy-policy-option-portlet
Liferay Workspace	./liferay-workspace/apps/greedy-policy-option-portlet
Maven	./maven/apps/greedy-policy-option-portlet

JSP Portlet

Template project description: Demonstrates a simple JSP portlet.

Build tool	Link to project's source code
Gradle	./gradle/apps/jsp-portlet
Liferay Workspace	./liferay-workspace/apps/jsp-portlet
Maven	./maven/apps/jsp-portlet

JSP WAR Portlet

Build tool	Link to project's source code
Gradle	./gradle/apps/jsp-war-portlet
Liferay Workspace	./liferay-workspace/wars/jsp-war-portlet
Maven	./maven/apps/jsp-portlet

Kotlin Portlet

Build tool	Link to project's source code
Gradle	./gradle/apps/kotlin-portlet

npm

Angular npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/angular-npm-portlet

Billboard.js npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/billboardjs-npm-portlet

Isomorphic npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/isomorphic-npm-portlet

jQuery npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/jquery-npm-portlet

Metal.js npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/metaljs-npm-portlet

React npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/react-npm-portlet

Simple npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/simple-npm-portlet

Vue.js npm Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/npm/vuejs-npm-portlet

OSGi Portlet

Template project description: Demonstrates how to use the raw OSGI APIs for registering a Liferay MVC portlet.

Build tool	Link to project's source code
Gradle	./gradle/apps/osgi-portlet
Liferay Workspace	./liferay-workspace/apps/osgi-portlet
Maven	./maven/apps/osgi-portlet

Render Command Portlet

Build tool	Link to project's source code
Gradle	./gradle/apps/render-command-portlet
Liferay Workspace	./liferay-workspace/apps/render-command-portlet
Maven	./maven/apps/render-command-portlet

Resource Command Portlet

Build tool	Link to project's source code
Gradle	./gradle/apps/resource-command-portlet
Liferay Workspace	./liferay-workspace/apps/resource-command-portlet
Maven	./maven/apps/resource-command-portlet

REST

Extension point description: Lets developers create custom JAX-RS standard based RESTful services.

Template project description: Demonstrates how to create a JAX-RS service that lists Liferay users.

NOTE: Before this service is accessible, the developer needs to configure endpoints for it. To do so, go to the Control Panel → System → System Settings → Foundation and then

Search for CXF Endpoints
Create a new CXFEndpoint publisher configuration providing a context path (e.g., /rest-test).
Go back to System Settings → Foundation and select REST Extender.
Create a new REST extender configuration (i.e., search with rest) providing context paths (e.g., /rest-test) and jaxrs.applications.filters set to (jaxrs.application=true).

Then you can access the service via http://localhost:8080/o/rest-test/blade.users/list/.

Build tool	Link to project's source code
Gradle	./gradle/apps/rest
Liferay Workspace	./liferay-workspace/apps/rest
Maven	./maven/apps/rest

Sample Verifier

Build tool	Link to project's source code
Gradle	./gradle/apps/sample-verifier
Liferay Workspace	./liferay-workspace/apps/sample-verifier
Maven	./maven/apps/sample-verifier

Service Builder

Basic

Template project description: Demonstrates how to create a Service Builder project separated into three bundles:

api bundle is for interfaces
service bundle is for implementations
web bundle is a portlet calling the generated services

Build tool	Link to project's source code
Gradle	./gradle/apps/service-builder/basic
Liferay Workspace	./liferay-workspace/apps/service-builder/basic
Maven	./maven/apps/service-builder/basic

JDBC

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/service-builder/jdbc
Liferay Workspace	./liferay-workspace/apps/service-builder/jdbc
Maven	./maven/apps/service-builder/jdbc

JNDI

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/service-builder/jndi
Liferay Workspace	./liferay-workspace/apps/service-builder/jndi
Maven	./maven/apps/service-builder/jndi

Shared Language Keys

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/shared-language-keys
Liferay Workspace	./liferay-workspace/apps/shared-language-keys
Maven	./maven/apps/shared-language-keys

Simulation Panel App

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/simulation-panel-app
Liferay Workspace	./liferay-workspace/apps/simulation-panel-app
Maven	./maven/apps/simulation-panel-app

Spring MVC Portlet

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/apps/springmvc-portlet
Liferay Workspace	./liferay-workspace/wars/springmvc-portlet
Maven	./maven/apps/springmvc-portlet

Extensions

Auth Failure

Template project description: Demonstrates a hook for auth.failure and auth.max.failures.

Build tool	Link to project's source code
Gradle	./gradle/extensions/auth-failure
Liferay Workspace	./liferay-workspace/extensions/auth-failure
Maven	./maven/extensions/auth-failure

Authenticator Shiro

Template project description: Uses Apache Shiro for hooking auth.pipeline.pre.

Build tool	Link to project's source code
Gradle	./gradle/extensions/authenticator-shiro
Liferay Workspace	./liferay-workspace/extensions/authenticator-shiro
Maven	./maven/extensions/authenticator-shiro

Auto Login

Template project description: Demonstrates the AutoLogin integration point.

Build tool	Link to project's source code
Gradle	./gradle/extensions/auto-login
Liferay Workspace	./liferay-workspace/extensions/auto-login
Maven	./maven/extensions/auto-login

Control Menu Entry

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/extensions/control-menu-entry
Liferay Workspace	./liferay-workspace/extensions/control-menu-entry
Maven	./maven/extensions/control-menu-entry

Doclib Resource Command Override

Build tool	Link to project's source code
Gradle	./gradle/extensions/doclib-resource-command-override
Liferay Workspace	./liferay-workspace/extensions/doclib-resource-command-override
Maven	./maven/extensions/doclib-resource-command-override

Document Action

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/extensions/document-action
Liferay Workspace	./liferay-workspace/extensions/document-action
Maven	./maven/extensions/document-action

Friendly URL

Extension point description: Lets a developer provide (or overwrite) friendly URL mapping for portlets.

Template project description: Demonstrates how to create a FriendlyURLMapper for the standard NetworkUtilities portlet.

The NetworkUtilities portlet does not provide friendly URLs out of the box. To test this plugin, put a NetworkUtilities portlet on the home page. After deploying this plugin, you can access its tabs directly using the following URLs:

Build tool	Link to project's source code
Gradle	./gradle/extensions/friendly-url
Liferay Workspace	./liferay-workspace/extensions/friendly-url
Maven	./maven/extensions/friendly-url

Gogo Command

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/extensions/gogo
Liferay Workspace	./liferay-workspace/extensions/gogo
Maven	./maven/extensions/gogo

Indexer Post Processor

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/extensions/indexer-post-processor
Liferay Workspace	./liferay-workspace/extensions/indexer-post-processor
Maven	./maven/extensions/indexer-post-processor

Lifecycle Login Pre-action

Extension point description: Demonstrates how to implement a Liferay com.liferay.portal.kernel.events.LifecycleAction. This API replaces all the legacy lifecycle events such as com.liferay.portal.kernel.events.Action, com.liferay.portal.kernel.events.SessionAction, and com.liferay.portal.kernel.events.SimpleAction. Connecting a LifecycleAction to a particular event is determined by the OSGi service property key. The following keys are supported:

application.shutdown.events - fired during destruction of company instances at portal shutdown.
application.startup.events - fired during initialization of company instances at portal start, or when a new instance is created.
global.shutdown.events - fired during destruction of the portal's main servlet.
global.startup.events - fire during initialization of the portal's main servlet.
layout.configuration.action.delete - fired during destruction of a page (Layout).
layout.configuration.action.update - fired during initialization of a page (Layout).
login.events.post - fired immediately following login.
login.events.pre - fired immediately prior to login.
logout.events.post - fired immediately following logout.
logout.events.pre - fired immediately prior to logout.
servlet.service.events.post - fired following requests to the portal (including all portlet container requests).
servlet.service.events.pre - fired prior to requests to the portal (including all portlet container requests & post login).
servlet.session.create.events - fired during creation of a portal's HTTP session.
servlet.session.destroy.events - fired during destruction of a portal's HTTP session.

Template project description: Demonstrates a hook for login.events.pre.

Build tool	Link to project's source code
Gradle	./gradle/extensions/lifecycle-login-preaction
Liferay Workspace	./liferay-workspace/extensions/lifecycle-login-preaction
Maven	./maven/extensions/lifecycle-login-preaction

Model Listener

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/extensions/model-listener
Liferay Workspace	./liferay-workspace/extensions/model-listener
Maven	./maven/extensions/model-listener

Poll Processor

Template project description: Demonstrates how to make a hook for a PollerProcessor.

Build tool	Link to project's source code
Gradle	./gradle/extensions/poll-processor
Liferay Workspace	./liferay-workspace/extensions/poll-processor
Maven	./maven/extensions/poll-processor

Portlet Configuration Icon

Build tool	Link to project's source code
Gradle	./gradle/extensions/portlet-configuration-icon
Liferay Workspace	./liferay-workspace/extensions/portlet-configuration-icon
Maven	./maven/extensions/portlet-configuration-icon

Portlet Toolbar Contributor

Build tool	Link to project's source code
Gradle	./gradle/extensions/portlet-toolbar-contributor
Liferay Workspace	./liferay-workspace/extensions/portlet-toolbar-contributor
Maven	./maven/extensions/portlet-toolbar-contributor

Resource Bundle

Build tool	Link to project's source code
Gradle	./gradle/extensions/resource-bundle
Liferay Workspace	./liferay-workspace/extensions/resource-bundle
Maven	./maven/extensions/resource-bundle

Scheduler Entry

Build tool	Link to project's source code
Gradle	./gradle/extensions/scheduler-entry
Liferay Workspace	./liferay-workspace/extensions/scheduler-entry
Maven	./maven/extensions/scheduler-entry

Screen Name Validator

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/extensions/screen-name-validator
Liferay Workspace	./liferay-workspace/extensions/screen-name-validator
Maven	./maven/extensions/screen-name-validator

Struts Action

Template project description: Demonstrates how to write a StrutsAction.

Build tool	Link to project's source code
Gradle	./gradle/extensions/struts-action
Liferay Workspace	./liferay-workspace/extensions/struts-action
Maven	./maven/extensions/struts-action

Struts Portlet Action

Template project description: Demonstrates how to write a StrutsPortletAction.

Build tool	Link to project's source code
Gradle	./gradle/extensions/struts-portlet-action
Liferay Workspace	./liferay-workspace/extensions/struts-portlet-action
Maven	./maven/extensions/struts-portlet-action

User Service Wrapper

Template project description: Demonstrates how to wrap the UserLocalService with custom a UserLocalServiceWrapper.

Build tool	Link to project's source code
Gradle	./gradle/extensions/user-service-wrapper
Liferay Workspace	./liferay-workspace/user-service-wrapper
Maven	./maven/user-service-wrapper

Overrides

Core JSP Override

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/overrides/core-jsp-override
Liferay Workspace	./liferay-workspace/overrides/core-jsp-override
Maven	./maven/overrides/core-jsp-override

Module JSP Override

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/overrides/module-jsp-override
Liferay Workspace	./liferay-workspace/overrides/module-jsp-override
Maven	./maven/overrides/module-jsp-override

Resource Bundle Override

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/overrides/resource-bundle-override
Liferay Workspace	./liferay-workspace/overrides/resource-bundle-override
Maven	./maven/overrides/resource-bundle-override

Themes

Simple Theme

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/themes/simple-theme
Liferay Workspace	./liferay-workspace/wars/simple-theme
Maven	./maven/themes/simple-theme

Template Context Contributor

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/themes/template-context-contributor
Liferay Workspace	./liferay-workspace/themes/template-context-contributor
Maven	./maven/themes/template-context-contributor

Theme Contributor

Refer to this sample's Readme for more information.

Build tool	Link to project's source code
Gradle	./gradle/themes/theme-contributor
Liferay Workspace	./liferay-workspace/themes/theme-contributor
Maven	./maven/themes/theme-contributor

Liferay Extension Points Without Template Projects

This project does not yet have template projects for the following extension points. We encourage you to contribute some!

com.liferay.mail.util.Hook
com.liferay.portal.kernel.atom.AtomCollectionAdapter
com.liferay.portal.kernel.format.PhoneNumberFormat
com.liferay.portal.kernel.lar.PortletDataHandler
com.liferay.portal.kernel.lar.StagedModelDataHandler
com.liferay.portal.kernel.lock.LockListener
com.liferay.portal.kernel.notifications.UserNotificationHandler
com.liferay.portal.kernel.pop.MessageListener
com.liferay.portal.kernel.portlet.FriendlyURLMapper
com.liferay.portal.kernel.portlet.PortletLayoutListener
com.liferay.portal.kernel.sanitizer.Sanitizer
com.liferay.portal.kernel.scheduler.SchedulerEntry
com.liferay.portal.kernel.search.Indexer
com.liferay.portal.kernel.search.OpenSearch
com.liferay.portal.kernel.servlet.URLEncoder
com.liferay.portal.kernel.template.TemplateHandler
com.liferay.portal.kernel.template.TemplateManager
com.liferay.portal.kernel.trash.TrashHandler
com.liferay.portal.kernel.upgrade.UpgradeProcess (call the Release service)
com.liferay.portal.kernel.webdav.WebDAVStorage
com.liferay.portal.kernel.workflow.WorkflowHandler
com.liferay.portal.kernel.xmlrpc.Method
com.liferay.portal.model.ModelListener
com.liferay.portal.security.auth.AuthToken
com.liferay.portal.security.auth.AuthVerifierConfiguration
com.liferay.portal.security.auth.AutoLogin
com.liferay.portal.security.auth.EmailAddressGenerator
com.liferay.portal.security.auth.EmailAddressValidator
com.liferay.portal.security.auth.FullNameGenerator
com.liferay.portal.security.auth.FullNameValidator
com.liferay.portal.security.auth.ScreenNameGenerator
com.liferay.portal.security.auth.ScreenNameValidator
com.liferay.portal.security.ldap.AttributesTransformer
com.liferay.portal.security.membershippolicy.OrganizationMembershipPolicy
com.liferay.portal.security.membershippolicy.RoleMembershipPolicy
com.liferay.portal.security.membershippolicy.SiteMembershipPolicy
com.liferay.portal.security.membershippolicy.UserGroupMembershipPolicy
com.liferay.portal.security.permission.BaseModelPermissionChecker
com.liferay.portal.security.permission.PermissionPropagator
com.liferay.portal.security.pwd.Toolkit
com.liferay.portal.verify.VerifyProcess
com.liferay.portlet.asset.model.AssetRendererFactory
com.liferay.portlet.ControlPanelEntry
com.liferay.portlet.DefaultControlPanelEntryFactory
com.liferay.portlet.dynamicdatamapping.render.DDMFormFieldRenderer
com.liferay.portlet.dynamicdatamapping.util.DDMDisplay
com.liferay.portlet.expando.model.CustomAttributesDisplay
com.liferay.portlet.social.model.SocialActivityInterpreter
com.liferay.portlet.social.model.SocialRequestInterpreter
java.util.ResourceBundle
javax.portlet.filter.ActionFilter
javax.portlet.filter.EventFilter
javax.portlet.filter.RenderFilter
javax.portlet.filter.ResourceFilter
javax.portlet.PreferencesValidator
javax.servlet.Filter (Liferay InvokerFilterChain Filters)

License

References

OSGI R5

OSGI Compendium R5

Blueprint

Name		Name	Last commit message	Last commit date
Latest commit History 1,570 Commits
.gradle		.gradle
gradle		gradle
liferay-workspace		liferay-workspace
maven		maven
.gitignore		.gitignore
.travis.yml.offline		.travis.yml.offline
LICENSE.txt		LICENSE.txt
README.markdown		README.markdown
build-notests.sh		build-notests.sh
build.bat		build.bat
build.gradle		build.gradle
build.sh		build.sh
diff.sh		diff.sh
gradlew		gradlew
gradlew.bat		gradlew.bat

License

senacor/liferay-blade-samples

Folders and files

Latest commit

History

Repository files navigation

Bootstrap Liferay Advanced Developer Environments (BLADE)

Build Tools

Contribution Guidelines

Sample Code

Sample Docs

Frameworks

A Note on Blueprint

Liferay Extension Points and Template Projects

Apps

Action Command Portlet

Blueprint Portlet

Configuration Action

Control Panel Portlet

DS Portlet

Filter Portlet

FreeMarker Portlet

Greedy Policy Option Portlet

JSP Portlet

JSP WAR Portlet

Kotlin Portlet

npm

Angular npm Portlet

Billboard.js npm Portlet

Isomorphic npm Portlet

jQuery npm Portlet

Metal.js npm Portlet

React npm Portlet

Simple npm Portlet

Vue.js npm Portlet

OSGi Portlet

Render Command Portlet

Resource Command Portlet

REST

Sample Verifier

Service Builder

Basic

JDBC

JNDI

Shared Language Keys

Simulation Panel App

Spring MVC Portlet

Extensions

Auth Failure

Authenticator Shiro

Auto Login

Control Menu Entry

Doclib Resource Command Override

Document Action

Friendly URL

Gogo Command

Indexer Post Processor

Lifecycle Login Pre-action

Model Listener

Poll Processor

Portlet Configuration Icon

Portlet Toolbar Contributor

Resource Bundle

Scheduler Entry

Screen Name Validator

Struts Action

Struts Portlet Action

User Service Wrapper

Overrides

Core JSP Override

Module JSP Override

Resource Bundle Override

Themes

Simple Theme

Template Context Contributor

Theme Contributor

Liferay Extension Points Without Template Projects

License

References

About