Live Copy module

Edition

Special Features

License

MLA

Issues

LIVECOPY

Maven site

LIVECOPY

Latest

3.2.10

Available on SPA/Headless

Yes

The Magnolia Special Feature Live Copy module helps you manage complex multisite installations that share similar content. It allows you to create live copies of master sites.

You can then push any changes you make in the master to the live copy pages.

You do not need to manually copy similar pages to multiple locations in order to perform updates.

Components and fields in components on live copy pages can be changed individually and protected from master content changes.

Installing with Maven

Maven is the easiest way to install the module. Add the following to your bundle:

<dependency>
  <groupId>info.magnolia.livecopy</groupId>
  <artifactId>magnolia-livecopy</artifactId>
  <version>3.2.10</version>
</dependency>

As a lot of content can be copied and linked, a single wrong action can have a negative impact on a big part of your website.

Plan your content structure in detail before using Live Copy.

Give the rights to execute Live Copy actions to privileged users with sufficient instructions only.

Note about transformers

For compatibility fields (before 6.2.3) that still use (deprecated) transformer classes, only the following default transformers are supported:

  • Composite field: info.magnolia.ui.form.field.transformer.composite.CompositeTransformer

  • Switchable field: info.magnolia.ui.form.field.transformer.composite.SwitchableTransformer

  • Multivalue field: info.magnolia.ui.form.field.transformer.multi.MultiValueTransformer

  • Multivalue composite field: info.magnolia.ui.form.field.transformer.multi.MultiValueSubChildrenNodePropertiesTransformer

For example, if you have a link field inside a composite field, the relink function only works if the composite field’s transformer class is CompositeTransformer.

Configuring Live Copy for internationalization

For single-tree, multi-language websites, you must:

  1. Use info.magnolia.livecopy.i18n.LiveCopyI18nContentSupport in the live copy site definition. This class processes the content of the live copy page based on the locale, programmatically retrieving the locale from the master page’s Site definition.

    Before version 3.2.6, this class introduced a masterLocale property which held the fallback language from the master copy. From Live Copy 3.2.6+ masterLocale is deprecated. For older versions of Live Copy, it is still use.

    image

  2. Enable multi-language authoring in /config/server/i18n/authoring and set the class to info.magnolia.livecopy.i18n.LiveCopyMultiSiteI18nAuthoringSupport.

    image

  3. If you only want to have one locale available in your live copy, delete the other locales from the live copy site definition.

    For example, if you have English and German versions in the master, but you only want the German version of the site to be available to authors in the live copy, remove the en locale folder from the live copy site definitions and set the fallback locale to de:

    image

    When the author then opens a live copy page, the language switcher does not appear at the bottom of the page and the content presented is the German version.

About locales

Locales are display languages on Magnolia instances. The live copy page takes the same tree structure as the master page. This means that locales of the master site definition is used to define the structure of both the master and live copy pages. Under the i18n node in the Site app for the respective site definition, you can see which locales (languages) are defined for the site. fallbackLocale defines which language is used by default from the available locales and which content is served if the content is not available for the current locale.

image

In the example above, German is used as the default locale for the master page (fallbackLocale = de). You can read the Internationalization page for more information about translated user interface texts (see examples in the table below).

Master Live copy

title = Hello world

title = Hello world

title_de = Hallo Welt

title_de = Hallo Welt

Defining fallbackLocale does not affect the structure of the live copy or the master pages. For example, defining this property as de is like stating that the content of the live copy page will be rendered in the German locale by default when first loaded.

Release history

Live Copy module 3.2.10

Released on October 18, 2022.

In this release, we have further improved the push functionality so that relinking and complex fields are handled better. Specifically, Live Copy 3.2.10 fully supports the protection of complex fields in separate internationalized live copies.

Improvements

  • LIVECOPY-336 Pushing changes to copies doesn’t perform relinks correctly

  • LIVECOPY-335 Complex fields with Internalisation are not protected correctly

    Fields that were protected already remain protected in this new version of Live Copy. However, now you can take advantage of the new code for complex fields. If a complex field is protected already, first unprotect it and then protect it again to enable the new code. Remember that you must protect complex fields for all languages, for example, both on the English and German versions of the page.
  • LIVECOPY-310 Relink doesn’t work for compositeField, switchableField and MultiField fields

Live Copy module 3.2.9

Released on August 18, 2022.

In this release, we have improved the push functionality so that even live copies moved out of the root will reflect changes made on the master.

Improvements

  • LIVECOPY-317 Maintain push functionality when moving a Livecopy out of ROOT

Live Copy module 3.2.8

Released on April 19, 2022.

This is primarily a bug fixing release with one improvement to make the relinking of pages easier when creating a live copy.

Improvements

  • LIVECOPY-306 New option to automatically relink pages when a live copy is created

    See for yourself!

    Automatically relink

Bug fixes

  • LIVECOPY-307 Template annotations endpoint broken in combination with Live Copy

  • LIVECOPY-297 Create Live Copy files in combination with Magnolia Forms module

  • LIVECOPY-309 Wrong ordering of slave components

  • LIVECOPY-298 LiveCopyUtils#getMasterNode spams the Log if called on none Live Copy Node

  • LIVECOPY-305 Cannot protect inner fields of a multifield if PropertyNameDecorator is configured

  • LIVECOPY-308 Protect a multifield attributes does not work well

Live Copy module 3.2.7

Released on December 13, 2021.

This bug fixing release also brings the following improvements:

Improvements

Bug fixes

  • Relink doesn’t work for links outside of website workspace. LIVECOPY-296

Live Copy module 3.2.6

Released on September 23, 2021.

This bug fixing release also brings the following improvements:

Improvements

  • Node names are now protected (propertiesToIgnore added) from master content change pushes. LIVECOPY-290

  • Improved protection of the MultiValueField field. LIVECOPY-283

  • Field transformers are checked before relinking. LIVECOPY-282

Bug fixes

  • Updating a child page makes the parent page appear as updated. LIVECOPY-222

  • Live copy workflows have invalid markup leading to log errors. LIVECOPY-252

  • The defaultLocale property affects the selected language in the Pages app. LIVECOPY-266

  • Protecting fields in a Switchable Field does not work. LIVECOPY-281

  • Protect button does not work correctly if a locale is the default in a live copy tree but not the master default. LIVECOPY-288

Live Copy module 3.2.5

Released on August 9, 2021.

This release comes with a hot fix for version 3.2.4, which you may skip and update directly to version 3.2.5.

This is the recommended version for use with Magnolia 6.2.11.

This bug fixing release also brings the following improvements:

Improvements

Bug fixes

  • Variants are not published. LIVECOPY-237

  • Exception in relink if content does not matching definition. LIVECOPY-256

  • LiveCopy changes the user and timestamp of unedited pages. LIVECOPY-258

  • Two live copies in the same tree are not working. We have disabled some actions (Duplicate page, Copy page and Paste page) for live copies. LIVECOPY-260

  • RichText fields and MultiValueCompositeLinkField are automatically protected. LIVECOPY-263

  • Relink action doesn’t work for a link in switchableField. LIVECOPY-272

  • Relink action doesn’t work for linkField in area. LIVECOPY-273

  • MultiValueCompositeLinkField, MultiValueLinkField cannot relink in StandardRewirePageLinksHelper. LIVECOPY-275

  • MultiValueCompositeLinkField cannot relink in CompatibilityRewirePageLinksHelper. LIVECOPY-276

  • MultiValueCompositeRichTextField, MultiValueRichTextField cannot relink in StandardRewirePageLinksHelper. LIVECOPY-277

  • MultiValueCompositeRichTextField, MultiValueRichTextField cannot relink in CompatibilityRewirePageLinksHelper. LIVECOPY-278

Live Copy module 2.2.1

Released on August 6, 2021.

This is the recommended version for use with Magnolia 5.7.

Bug fixing release:

Live Copy module 3.2.3

Released on March 31, 2021.

Bug fixing release:

  • Publishing does not set the userName property on the task. LIVECOPY-246

  • Push action dialog ignores autoRewire property value. LIVECOPY-247

Live Copy module 3.2.2

Released on March 3, 2021.

Bug fixing release:

Live Copy module 3.2.1

Released on January 28, 2021.

This bug fixing release also brings full compatibility with Magnolia 6.2.6 and the following improvement:

Protect fields per language

You can protect a field in one language and not another using the language switcher and then clicking on the protect field icon. For example if you want to protect the German version of a given field and not the English version, you switch to German and protect the field. When you switch back to English, the field is not protected.

Links inside composite fields were not being relinked to the live copy pages correctly and continued to point to the master pages. Now, when you click Relink all pages to live copy pages, they are relinked correctly.

Live Copy module 3.2

Released on August 26, 2020

This release brings full compatibility with Magnolia 6.2.2 and the new UI framework as well as some new functionality and improvements:

Improvements

  • LIVECOPY-108 - Open the Master Page from a live copy

  • LIVECOPY-42 - Add a open as new window button for each page in the ReferencedPagesField

  • LIVECOPY-44 - Show if the referenced page has page variations in the ReferencedPagesField

  • LIVECOPY-145 - When I delete Master, LC still shows link to (and actions) to Master

  • LIVECOPY-149 - Locking the component when using the Relink live copy function should be optional

  • LIVECOPY-150 - Only push master content pages to specific pages

  • LIVECOPY-151 - When pushing master content changes users can auto publish content

  • LIVECOPY-159 - Fields under composite/switchable/multi fields are protected independently from the parent field

  • LIVECOPY-190 - Change the color of a partially protected component (only certain fields are disabled)

Bug fixes

  • LIVECOPY-171 - Protect/unprotect complex fields

  • LIVECOPY-194 - Push master content changes position of component order

  • LIVECOPY-195 - Enable/disable updates for component does not update the detail page

Live Copy module 3.1.2

Released on August 20, 2020.

This release provides the following bug fixes:

  • LIVECOPY-173 - Push master content changes position of component order

  • LIVECOPY-178 - NPE is thrown when attempting to create a live copy from page

  • LIVECOPY-217 - Live Copy relink does not work

  • LIVECOPY-218 - ItemNotFound exception when pushing master content changes

Live Copy module 3.1.1

Released on November 13, 2019.

Live Copy module 2.0.7

Released on September 11, 2019.

Live Copy module 3.1

Released on July 5, 2019.

Live Copy is now a Special Features module. Live Copy helps you manage complex multisite installations that share similar content by creating live copies of master sites.

These are legacy versions of Live Copy, previously available in the Magnolia Professional Services Incubator.

Live Copy module 3.0

Updated for Magnolia 6.0 compatibility.

Live Copy module 2.1

Updated for Magnolia 5.7 compatibility.

Live Copy module 2.0.6

Live Copy module 2.0.5

POM edited to prevent versioning clash with magnolia-pages-editor-widget.

Live Copy module 2.0.2

Live Copy module 2.0.1

Live Copy module 2.0

Initial release of the Incubator (previously called Extensions) version of the module.

Live Copy compatibility

In versions predating 3.1 and 2.0.7 this module was in the Incubator. Uninstall previous versions before installing a more recent one.

For 5.7 compatibility, we recommend you install version 2.2.1 since 2.2.0 is an Incubator version.

Module version Magnolia version

3.2.10

Magnolia 6.2.11

3.2.8

Magnolia 6.2.11

3.2.7

Magnolia 6.2.11

3.2.4

Magnolia 6.2.11

3.2.1

Magnolia 6.2.6

3.2.0

Magnolia 6.2.2

3.1.2

Magnolia 6.1

3.1.1

Magnolia 6.1

3.1

Magnolia 6.1

3.0

Magnolia 6.0

2.2.1

Magnolia 5.7

2.1.1

Magnolia 5.7

2.1

Magnolia 5.7

2.0.7

Magnolia 5.6

2.0.5

Magnolia 5.6

2.0.4

Magnolia 5.6

Feedback