Liferay Theme Migration from 6.2 to 7.x / DXP

  

Liferay Theme Migration: from 6.2 to 7.x / DXP


Overview


This article describes the steps required to migrate a Liferay theme from 6.2 to 7.x / DXP.


Migration Steps


1. Prepare Theme for Migration


Liferay Theme for 6.2 should be Plugin-SDK-compatible (“docroot” structure).

All custom changes should be inside _diffs folder:



2. Prepare Environment for Migration


Use Node v10 with NVM (or instal appropriate version manually):

nvm use v10.12.0


Install Gulp/Yeoman/Liferay Theme Generator:


npm install -g gulp@3.9.1

npm install -g yo@3.1.0

npm install -g generator-liferay-theme@8.x.x


* install them globally, keep the mentioned version numbers.


Verify the installation:


lunar-resort-dxp-theme$ npm list -g --depth=0

/home/vitaliy/.nvm/versions/node/v10.12.0/lib

├── generator-liferay-theme@8.2.4

├── gulp@3.9.1

├── npm@6.4.1

└── yo@3.1.0


3. Theme Import


Create a folder for DXP theme, and run a command from inside it:


yo liferay-theme:import

, answer the questions and finish theme import:


4. Theme Migration from 6.2 to 7.0


Navigate to the imported theme’s folder. Install liferay-theme-tasks v8 for upgrade to 7.0:


npm install --save-dev liferay-theme-tasks@8.x.x


Run the upgrade command:


gulp upgrade



Check the upgrade logs. 

See the automatically applied changes, and make the manually required ones (according to the instructions in logs).

5. Theme Migration from 7.0 to 7.1


Install liferay-theme-tasks and liferay-theme-deps-7.1 v8.0.9:


npm install --save-dev liferay-theme-tasks@8.0.9

npm install --save-dev liferay-theme-deps-7.1@8.0.9 


Verify the installation:


lunar-resort-ce-theme$ npm list --depth=0

lunar-resort-ce-theme@1.0.0

├── gulp@3.9.1

├── liferay-theme-deps-7.1@8.0.9

└── liferay-theme-tasks@8.0.9


Run the upgrade command again:


gulp upgrade



Check the upgrade logs, implement the required manual fixes according to them.

Update Velocity templates (VM) to FreeMarker (FTL).


See also:

https://help.liferay.com/hc/en-us/articles/360029316691-Upgrading-Your-Theme-from-Liferay-Portal-6-2-to-7-2


Enjoy 😏

Comments

Post a Comment

Popular posts from this blog

Liferay Search Container Example

Or how to implement a custom search container in Liferay Overview   Search Containers are used in Liferay to display the table data. This article shows a simple example of how to implement a custom search container.  Example < liferay-portlet :renderURL varImpl ="iteratorURL" /> < liferay-ui :search-container total =" <%= ProjectLocalServiceUtil. getProjectsCount (scopeGroupId) %> "                              delta ="10"                              emptyResultsMessage ="no-projects-found"                              iterato...
Read more

Installing Blade CLI from Command Line

Installing Blade CLI from Command Line Download JPM Jar file Download biz.aQute.jpm.run.jar file using link: https://raw.githubusercontent.com/jpm4j/jpm4j.installers/master/dist/biz.aQute.jpm.run.jar Initialize JPM Run command: java -jar biz.aQute.jpm.run.jar init Install Blade Run command: jpm install -f https://releases.liferay.com/tools/blade-cli/latest/blade.jar to install blade. Update blade to make sure you have the latest version, sample:  blade update Current blade version 3.3.0.201811151753 Updating from: https://repository-cdn.liferay.com/nexus/content/repositories/liferay-public-releases/com/liferay/blade/com.liferay.blade.cli//3.8.0/com.liferay.blade.cli-3.8.0.jar Update completed successfully. Congratulations! Now you have Blade CLI installed. Sample command for mvc-portlet: blade create -t mvc-portlet -p com.demo.portlet -c DemoPortlet demo-portlet Enjoy 😏
Read more

Liferay Keycloak integration

Image
Liferay Keycloak integration using OpenID Overview This tutorial explains how to configure OpenID SSO between Liferay 7.2 and Keycloak 7.0.1 Installation instructions KeyCloak Configuration 1. Install and startup Keycloak server Download latest Keycloak server:  https://www.keycloak.org/downloads.html Unzip keycloak-7.0.1.zip folder. Run  keycloak-7.0.1/bin/standalone.sh  (or  keycloak-7.0.1/bin/standalone.bat ) file. Keycloak should be started on 8080 port:  http://localhost:8080 2. Create default admin user: and sign in to Admin Console. 3. Check OpenID configuration Click on "OpenID Endpoint Configuration": JSON configuration should appear, like this: { "issuer": "http://localhost:8080/auth/realms/master", "authorization_endpoint": "http://localhost:8080/auth/realms/master/protocol/openid-connect/auth", "token_endpoint": "http://localhost:8080/auth/realms/master/protocol/openid-con...
Read more