Code development platform for open source projects from the European Union institutions

Skip to content
Snippets Groups Projects
Commit c11122c2 authored by Andreas Hennings's avatar Andreas Hennings
Browse files

OEL-1283: Remove redundant info from README, but add some more useful hints.

parent eb63462d
No related branches found
No related tags found
5 merge requests!121OEL-1421: Fix cosmetic changes.,!116OEL-1394: Merge 1.x into EPIC-1293-Project, align with new version of card:search pattern,!115Upate the EPIC-1293-project,!105EPIC: OEL-1255: Migrate paragraphs,!99OEL-1283: Add update instructions for paragraphs move
......@@ -152,21 +152,20 @@ docker-compose exec web ./vendor/bin/phpunit
### Upgrade from 1.0.0-alpha5 and earlier
Target release: You can upgrade directly to the version that contains this README.md.
#### Paragraphs migration
Paragraphs-related theming and functionality has been moved from `oe_bootstrap_theme` to `oe_whitelabel`.
Paragraphs-related theming and functionality has been moved from the [OpenEuropa Bootstrap base theme](https://github.com/openeuropa/oe_bootstrap_theme) to [OpenEuropa Whitelabel](https://github.com/openeuropa/oe_whitelabel).
Special paragraphs fields that were introduced in `oe_bootstrap_theme_paragraphs` are being renamed in `oe_whitelabel_paragraphs`.
If you have the `oe_paragraphs` module enabled, you should:
- Create a `hook_update_N()` or `hook_post_update_NAME()` in a custom module, to enable the `oe_whitelabel_paragraphs` module.
- Run `drush updb` in your local installation.
- Run `drush config:export`, to export the changes.
- For deployment, make sure that `drush updb` runs _before_ `drush config:import`.
If you have the `oe_paragraphs` module enabled, you should create a `hook_update_N()` or `hook_post_update_NAME()` in a custom module, to enable the `oe_whitelabel_paragraphs` module during deployment.
```php
function EXAMPLE_post_update_00001(): void {
\Drupal::service('module_installer')->install(['oe_whitelabel_paragraphs']);
}
```
If you did _not_ have `oe_paragraphs` enabled, but you want to do so now, you should:
- Enable the new `oe_whitelabel_paragraphs` module in your local installation, ideally with `drush en`.
- Export configuration, e.g. via `drush cex`. This should add the module to `core.extension.yml`.
- For deployment, `drush config:import` will do the job. No update hook needed.
This is needed to make sure that the install hook for `oe_whitelabel_paragraphs` runs _before_ config-import during a deployment.
Note that `drush updb` will also trigger update hooks in `oe_bootstrap_theme_helper`, which will uninstall the legacy module `oe_bootstrap_theme_paragraphs`.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment