Skip to content

Commit ecc3c00

Browse files
committed
update_to_5.0.md: outro
DB backup warning Detailed icon update HTTP cache's VCL Ibexa Cloud Conclusion
1 parent 9f4124a commit ecc3c00

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

docs/update_and_migration/from_4.6/update_to_5.0.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -281,6 +281,8 @@ composer run-script post-update-cmd
281281

282282
### Update database
283283

284+
[[% include 'snippets/update/db/db_backup_warning.md' %]]
285+
284286
The main schema has changed and the provided SQL file `ibexa-4.6.latest-to-5.0.0.sql` updates it:
285287

286288
=== "MySQL"
@@ -693,7 +695,6 @@ The output as an `alias` column with new identifiers and a `legacy_alias` column
693695
| ezurl | ibexa_url |
694696
| ezuser | ibexa_user |
695697

696-
```suggestion
697698
You may have to update them in several places, for example:
698699

699700
- Update the field identifiers in templates to display or edit fields or their definition. For example, in a `@IbexaCore/content_fields.html.twig` extension, `{% block ezstring_field %)` must be changed for `{% block ibexa_string_field %}`
@@ -702,9 +703,13 @@ You may have to update them in several places, for example:
702703
#### Update icons
703704

704705
The provided built-it icon set has been changed.
706+
705707
The `ibexa/rector` JavaScript Transform module's plugin `ibexa-rename-icons.js` refactors the icon usage in JavaScript files.
706708
You may have to update them in other contexts, for example, in configuration files associating icons to content types or Page Builder blocks.
707709

710+
The icon library file's path changed from `/bundles/ibexaicons/img/all-icons.svg` to `/bundles/ibexaadminuiassets/vendors/ids-assets/dist/img/all-icons.svg`
711+
712+
Some icons have been renamed.
708713
You can find an [`ibexa-rename-icons` map in `vendor/ibexa/rector/js/rules.config.json` (`"old-name": "new-name"`)](https://github.com/ibexa/rector/blob/v5.0.0/js/rules.config.json#L63).
709714
710715
??? note "Icons renaming map"
@@ -963,3 +968,25 @@ The following example illustrates the update of a custom page block's icon:
963968
- thumbnail: /bundles/ibexaicons/img/all-icons.svg#about
964969
+ thumbnail: /bundles/ibexaadminuiassets/vendors/ids-assets/dist/img/all-icons.svg#info-square
965970
```
971+
972+
### Finalising
973+
974+
#### HTTP Cache
975+
976+
Use the newer VCL files.
977+
Depending on your reverse proxy, you'll find them in the following directories:
978+
979+
- Varnish: `vendor/ibexa/http-cache/docs/varnish/vcl/`
980+
- Fastly: `vendor/ibexa/fastly/fastly/`
981+
982+
#### Ibexa Cloud
983+
984+
Generate the Ibexa Cloud Platform.sh configuration files, review the changes with your own version, and merge your customizations.
985+
986+
```bash
987+
composer ibexa:setup --platformsh
988+
```
989+
990+
#### Conclusion
991+
992+
Your project is now running the latest major version of Ibexa DXP.

0 commit comments

Comments
 (0)