Migrating a Theme from the Plugins SDK to Workspace

After you’ve adapted your Plugins SDK theme to Liferay Portal’s API, you can continue maintaining it in the Plugins SDK. The Plugins SDK, however, is deprecated as of Liferay Portal CE 7.0. Maintaining plugins in the SDK will become increasingly difficult. Liferay Workspace replaces the Plugins SDK, providing a comprehensive Gradle development environment and more. A simple command migrates Plugins SDK (Ant-based) themes to Workspace (Gradle-based) themes. From there you can build and deploy them to Liferay Portal CE 7.0 as Web ARchives (WARs).

Running the Migration Command

Blade CLI’s convert command migrates Plugins SDK themes to Workspace themes in Workspace’s wars folder. Theme files are re-organized to follow the standard Liferay Portal CE 7.0 theme folder structure.

In a terminal, navigate to the Liferay Workspace root folder. Then pass your Plugins SDK theme’s name to Blade CLI’s convert command:

blade convert --themebuilder [THEME_PROJECT_NAME]

Blade CLI extracts the plugin from the Plugins SDK and reorganizes it in a standard web application project in Workspace’s wars folder. Blade CLI uses the Theme Builder plugin to migrate your theme to a workspace. You can also migrate your Plugins SDK theme to a Liferay Theme Generator theme using Blade CLI. Follow the Migrating Themes to the Theme Generator Using Workspace tutorial for more information.

The image below shows the theme files before and after they’re migrated to Workspace.

convert-theme-compare-folder-structure.png

Figure 1: The convert command migrates a Plugins SDK theme project to a Workspace theme project.

From your theme’s new location, you can deploy it to Liferay Portal CE 7.0 and maintain it using Workspace Gradle tasks. Welcome to your theme’s new home in Workspace!

Related Topics

Migrating a Theme from the Plugins SDK to the Theme Generator

Workspace Development lifecycle

Workspace Gradle Tasks

0 (0 Votes)
Migrating a Theme from the Plugins SDK to the Liferay Theme Generator Previous