Migration from M4.4 to M5.0

Page tree
Skip to end of metadata
  • Created on 2012-07-11, last edited by Antti Hietala on 2016-06-10
Go to start of metadata

Templating library tags and their migration status to Magnolia CMS 4.5.

Taglib-cms table

Tag name

Working Status (in Compatibility Module)

Migration Status (for Magnolia 4.5.4)

Replacement Functionality/Comment

AdminOnly

(tick)

Will not be migrated.

Use cmsfn.editMode or cmsfn.editMode || cmsfn.previewMode instead.

Attribute

 

Will not be migrated.

Use contextAttributes parameter of cms of @cms.Component or @cms.Area instead.

ButtonTag

(warning)

Will not be migrated.

Currently there is no replacement for this function. In order to add custom buttons to the bars it is necessary to extend the PageBar or ComponentBar or AreaBar and use protected methods #addPrimaryButton(com.google.gwt.user.client.ui.Widget) or #addSecondaryButton(com.google.gwt.user.client.ui.Widget).

ContentNodeIterator

(warning)

Will not be migrated.

Use

[#list components as component ]
[@cms.component content=component /]
[/#list]

instead.

EditBar

(warning)

Will not be migrated.

Edit bar is rendered automatically for each component. Use cms.component editable='false' for components that should not be editable.

EditButton

(tick)

will be supported

 

IfEmpty

(tick)

Will not be migrated.

Use <c:if test='node.getProperty("xyz") == null' > instead in JSP or [ #if !node.xyz?has_content] in Freemarker

IfExisting

(tick)

Will not be migrated.

Use <c:if test='node.hasProperty("xyz")' > instead in JSP or [ #if !node.xyz?has_content] in Freemarker

IfFirstContentNode

 

Will not be migrated.

Use component.@handle?matches(cmsfn.siblings(component).goTofirst().@handle) instead

IfLastContentNode

 

Will not be migrated.

Use component.@handle?matches(cmsfn.siblings(component).goTolast().@handle) instead

IfNotEmpty

(tick)

Will not be migrated.

Use <c:if test='node.getProperty("xyz") != null' > instead in JSP or [ #if node.xyz?has_content] in Freemarker

IfNotExisting

(tick)

Will not be migrated.

Use <c:if test='!node.hasProperty("xyz")' > instead in JSP or [ #if node.xyz?has_content] in Freemarker

IncludeTemplate

(warning)

Will not be migrated.

use cms.component instead.

LinkTag

 

Will not be migrated.

Use cms.init instead.

LoadPage

 

Will not be migrated.

Currently there is no replacement for this functionality.

LoadPagePath

 

Will not be migrated.

Currently there is no replacement for this functionality.

MainBar

(warning)

Will not be migrated.

Main bar is rendered automatically.

NewBar

(warning)

Will not be migrated.

Use cms.area instead.

Out

(tick)

Will not be migrated.

Page content is exposed as a content map so you can output all properties of page or component using ${content.myProperty} syntax.

PageIterator

 

Will not be migrated.

Use cmsfn.children instead.

PublicOnly

(tick)

Will not be migrated.

Use cmsfn.isPublicInstance instead.

Query

(tick)

Will not be migrated.

Added to templating functions,

[#assign results = cmsfn.search("website" "select * from [mgnl:page] where title like '%News%'" "JCR-SQL2" "mgnl:page") /]
[#list results as result]
${result!}
[/#list]

Resource

Deprecated

Will not be migrated.

No replacement.

Set

(warning)

Will not be migrated.

Using Resources util class deprecated since 4.0. No replacement.

SetNode

 

Will not be migrated.

Use cmsfn.asContentMap(Node) instead

UnloadPage

 

Will not be migrated.

Currently there is no replacement for this functionality.

UserTag

(tick)

Will not be migrated.

Use ${ctx.user} instead.

Taglibs-util table

Tag name

Working Status (in Compatibility Module)

Migration Status (for Magnolia 4.5.4)

Replacement Functionality/Comment

AHref

(warning)

Will not be migrated.

Use cmsfn.link(node) instead.

BreadCrumb

(warning)

will be migrated

fix issue: do not depend on Resource class

ConvertNewLine

(tick)

will be migrated

 

Date

Deprecated

Will not be migrated.

This tag was deprecated in prior version already. Use Java or FM functions to convert dates.

FileSrc

Deprecated

Will not be migrated.

This tag was deprecated in prior version already. File attributes such as name and path can be accessed directly from content map.

ImgTag

 

Will not be migrated.

Use cmsfn.getAsset() instead.

PoweredBy

(tick)

will be migrated

 

Redirect

(warning)

Will not be migrated.

Use redirect template, virtual URI mapping instead

ScaleImage

(tick)

will be migrated

 

SearchResultSnippets

(warning)

will be migrated

 

SimpleMail

(warning)

Will not be migrated.

This tag was deprecated in prior version already. Use info.magnolia.module.mail.commands.MailCommand instead.

SimpleNavigation

(tick)

will be migrated

 

SimpleSearch

(warning)

will be migrated

Added to templating functions,

  [#assign results = cmsfn.simpleSearch("website", "word1,word2...", "mgnl:page", "/path") /]
[#list results as result]
${result!}
[/#list]

Str2Obj

(warning)

will not be migrated

Use JSP or FM functionality to split \n separated lists to String arrays.

TableTag

(warning)

will not be migrated

Tag provided very limited functionality to construct tables. Use external tag libraries to construct tables or directly inlined script/macros instead.

Text2Image

(warning)

will be migrated

 

Xmp

(warning)

will not be migrated

The only functionality provided by this tag - escaping of html can be achieved better with built-in functions in JSP and FM.

3 Comments

  1. Boris Kraft

    I thought there won't be a compatibility module? Insights on its status should be listed on this page.

    1. Pascal Mangold

      thought the same!

  2. Tomas Brimor

    AdminOnly

    (tick)

    Will not be migrated.

    Use cmsfn.isAuthorInstance instead.

    This is an incorrect replacement?

    The AdminOnly tag tested both author instance and for non-preview mode. isAuthorInstance only checks if its on the author instance. Replacement should be info.magnolia.templating.functions.TemplatingFunctions#isEditMode which tests for both author instance and non-preview mode?