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"                              iteratorURL =" <%= iteratorURL %> " >     < liferay-ui :search-container-results             results =" <%= ProjectLocalServiceUtil. getProjects (scopeGroupId, searchContainer.getStart(), searchContainer.getEnd()) %> " />     < liferay-ui :search-container-row className ="com.sample.sb.model.Project" modelVar ="project" keyP
Read more

Liferay DXP - max upload file size

Image
Liferay DXP - increase Maximum Upload Request Size By default, Liferay has limit to 100 MB for file upload. Sometimes you need to upload larger files, and this restriction can be changed in configuration. Go to Control Panel -> Configuration -> System Settings -> Infrastructure. Click on "Upload Servlet Request". Modify " Overall Maximum Upload Request Size"  value and set which you need: Save the configuration. Now you should be able to upload large files to your Liferay DXP instance.
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