Experimental project

This is a sandbox project, which contains experimental code for developer use only.

The Drupal 8 asynchronous paragraph translations module provides a Paragraphs widget for creating and editing asynchronous paragraph translations on multi-language Drupal sites. It helps to overcome content moderation and synchronous translation issues for classic paragraphs.

Uses

  • Translate paragraphs asynchronously
    Classic paragraphs don't allow different paragraphs between translated and source language pages. This can be limiting, when your translated pages don't have translations for all paragraphs of the source language. The asynchronous paragraph translations module allows to add, edit, reorder or remove paragraphs on each translation without requiring or affecting these paragraphs in other languages.
  • Use content moderation with paragraphs
    Non-translatable paragraph reference fields are not shown on translation forms since Drupal Core 8.5, if content moderation has been enabled. Using the asynchronous paragraph translations module, paragraphs translations can be edited with content moderation enabled.
  • Migrate classic paragraphs
    If your site already is using classic paragraphs with synchronous translations, you can optionally migrate your existing classic paragraphs and their translations to asynchronous paragraph translations.

Requirements

  • Paragraphs
  • Drupal core language
  • Drupal core content_translation

Installation

Install as you would install any Drupal module. See https://www.drupal.org/docs/8/extending-drupal-8/ for further information.

Configuration

The asynchronous paragraph translations module uses translatable paragraph reference fields on content entities (or any other entity using paragraph reference fields).

In order to use asynchronous paragraph translations, navigate to Configuration > Regional and language > Content language and translation and set the paragraphs entity revision reference fields of your entity to translatable by ticking the according checkbox.

Make sure to keep sub paragraph entity revision reference fields non-translatable, as required by the paragraphs module and the asynchronous paragraph translations module as well.

Then navigate to your entities' Manage form display page and switch the field widget of the paragraph reference fields to Asynchronous Paragraphs.

WARNING: The Asynchronous Paragraphs widget is required for translatable paragraph reference fields in order to prevent from data loss when editing your content type. Don't miss to switch the widget type!

Migrate existing paragraphs and translations

For your convenience, the asynchronous paragraph translations module comes with migration mechanisms for your existing paragraphs and translations. Navigate to Configuration > Regional and language > Asynchronous paragraph translations to find your migration options.

The migration mechanisms will set the translatability of the paragraph reference fields to the correct values, migrate existing content and translations, and switch the widget type of the paragraph reference fields within your entities' default form displays.

Disclaimer

The asynchronous paragraph translations module is available for Drupal 8 only and under active development. Till we have a first release candidate, some of its features are experimental and may be subject to change.

Credits

The asynchronous paragraph translations module is based on the work of the Drupal community in #2461695: Support asymmetric translations.

Supporting organizations: 
Initial development and maintenance

Project information