From fe030435de8e67cd5e11c58e6e0d1f9519cb9996 Mon Sep 17 00:00:00 2001 From: Mike Little Date: Wed, 13 Nov 2024 15:46:06 +0000 Subject: [PATCH 1/3] Add v21 upgrade guide Add upgrade guide for V21 and updates the general guide to reference it. --- other-docs/guides/upgrading/README.md | 9 +-- other-docs/guides/upgrading/v21.md | 80 +++++++++++++++++++++++++++ 2 files changed, 85 insertions(+), 4 deletions(-) create mode 100644 other-docs/guides/upgrading/v21.md diff --git a/other-docs/guides/upgrading/README.md b/other-docs/guides/upgrading/README.md index 56202b00..f57aa4ca 100644 --- a/other-docs/guides/upgrading/README.md +++ b/other-docs/guides/upgrading/README.md @@ -12,16 +12,16 @@ specific version you are upgrading to. When upgrading multiple versions at once, all intermediate versions. To switch the version of Altis for your project, modify the version constraint for the `altis/altis` dependency in -your `composer.json`. For example, to upgrade to Altis version 20. +your `composer.json`. For example, to upgrade to Altis version 21. ```json { "name": "company-name/my-site", "require": { - "altis/altis": "^20.0.0" + "altis/altis": "^21.0.0" }, "require-dev": { - "altis/local-server": "^20.0.0" + "altis/local-server": "^21.0.0" } } ``` @@ -32,7 +32,7 @@ Next run `rm -rf vendor` on MacOS or Linux, or on Windows `rmdir vendor`. latest version of the package is used during the upgrade process. We are working to improve this process in future releases. -Next, run `composer update` to pull in the latest version of the packages. +Next, run `composer update -W ` to pull in the latest version of the packages. This will generate a new `composer.lock` file. Both the `composer.json` and `composer.lock` should be committed to version control, and deployed. @@ -43,6 +43,7 @@ with "BREAKING: " in the version release notes. ## Upgrade Guides +- [Version 21](./v21.md) - [Version 20](./v20.md) - [Version 19](./v19.md) - [Version 18](./v18.md) diff --git a/other-docs/guides/upgrading/v21.md b/other-docs/guides/upgrading/v21.md new file mode 100644 index 00000000..d78cebea --- /dev/null +++ b/other-docs/guides/upgrading/v21.md @@ -0,0 +1,80 @@ +--- +order: 21 +--- + +# Upgrading to v21 + +*If you are migrating from WordPress to Altis, check out the [migrating guide](../migrating/) first.* + +To upgrade to Altis v21, edit your `composer.json` and change the version constraint for `altis/altis` and any local environment +modules to `^21.0.0`. + +```json +{ + "require": { + "altis/altis": "^21.0.0" + }, + "require-dev": { + "altis/local-server": "^21.0.0" + }, + "config": { + "platform": { + "php": "8.2" + } + } +} +``` + +Once you have made these changes, run `composer update` and then run the `wp altis migrate` command: + +```sh +# For cloud environments +wp altis migrate + +# For local server +composer server cli -- altis migrate +``` + +## Breaking Changes + +## Changes to the Altis platform + +Altis Local Server no longer supports MySQL version 5.7. Please make sure to back up your database before upgrading. The database +will be upgraded automatically and we don't expect any issue, but it is always prudent to have a backup. + +## PHP + +We continue with our experimental support for PHP 8.3. This is not yet recommended for production use, but you can test +your code with PHP 8.3 in [Local Server](docs://local-server/). + +Refer to our [PHP Version Guide](docs://guides/updating-php/) for up-to-date compatibility, testing and upgrading information. + +## Headline Features + +### Node.js + +We continue to improve Altis support for Node.js applications alongside WordPress. This is an experimental feature, you can enable +it in Local Server, and we welcome feedback. + +### WordPress 6.7 + +WordPress 6.7 brings lots of new features, bug fixes, and improvements across the board. In particular, there are improvements +in performance and accessibility, and exciting new features for the block editor. A brand-new default theme, Twenty +Twenty-Five makes its debut in this release. Additionally, there have been many theming improvements of interest to theme +developers and designers. + +For developers, updates to the Interactivity API, including a new way to interact with server state changes in client-side +navigation, and improvements for loading existing scripts as module dependencies. + +See the +[WordPress 6.7 Field Guide](https://make.wordpress.org/core/2024/10/23/wordpress-6-7-field-guide/) for more information. + +### Altis Core improvements + +As always, we continue to incorporated updates and security fixes to modules and libraries in Altis to bring in important bug fixes +and improvements. + +### Documentation + +Our developer focused documentation has been improved again. As usual, feedback from our customers and partners is always welcome. +Please [send us any feedback you have](mailto:support@altis-dxp.com). From 1525b5b0b708b4ec35b5165b1d21df63f8cf969a Mon Sep 17 00:00:00 2001 From: Mike Little Date: Wed, 13 Nov 2024 15:59:56 +0000 Subject: [PATCH 2/3] Added WP CLI 2.11 to the upgrade guide --- other-docs/guides/upgrading/v21.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/other-docs/guides/upgrading/v21.md b/other-docs/guides/upgrading/v21.md index d78cebea..aea11dff 100644 --- a/other-docs/guides/upgrading/v21.md +++ b/other-docs/guides/upgrading/v21.md @@ -69,6 +69,11 @@ navigation, and improvements for loading existing scripts as module dependencies See the [WordPress 6.7 Field Guide](https://make.wordpress.org/core/2024/10/23/wordpress-6-7-field-guide/) for more information. +### WordPress CLI 2.11 + +We updated WP CLI to version 2.11. This brings new features and bug fixes, including the ability to manage your signup list, manage +unknown image sizes, an `i18n make-php` command and multisite commands now can specify `--slug`. + ### Altis Core improvements As always, we continue to incorporated updates and security fixes to modules and libraries in Altis to bring in important bug fixes From 6d1c6dfcecf5accb93d44a084d3630e2429b65a6 Mon Sep 17 00:00:00 2001 From: Mike Little Date: Wed, 13 Nov 2024 17:02:26 +0000 Subject: [PATCH 3/3] Add information about the Backup Shipping add-on. --- other-docs/guides/upgrading/v21.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/other-docs/guides/upgrading/v21.md b/other-docs/guides/upgrading/v21.md index aea11dff..447be321 100644 --- a/other-docs/guides/upgrading/v21.md +++ b/other-docs/guides/upgrading/v21.md @@ -59,8 +59,8 @@ it in Local Server, and we welcome feedback. ### WordPress 6.7 WordPress 6.7 brings lots of new features, bug fixes, and improvements across the board. In particular, there are improvements -in performance and accessibility, and exciting new features for the block editor. A brand-new default theme, Twenty -Twenty-Five makes its debut in this release. Additionally, there have been many theming improvements of interest to theme +in performance and accessibility, and exciting new features for the block editor. A brand-new default theme, Twenty +Twenty-Five makes its debut in this release. Additionally, there have been many theming improvements of interest to theme developers and designers. For developers, updates to the Interactivity API, including a new way to interact with server state changes in client-side @@ -76,7 +76,13 @@ unknown image sizes, an `i18n make-php` command and multisite commands now can s ### Altis Core improvements -As always, we continue to incorporated updates and security fixes to modules and libraries in Altis to bring in important bug fixes +### Backup shipping add-on + +Altis Cloud now offers Backup Shipping, an add-on service designed for customers requiring off-site backup storage for compliance +and disaster recovery. Adhering to the industry-standard 3-2-1 rule, this feature enables users to retain three copies of data +across two storage types, with one copy stored off-site. Contact your account manager for more information. + +As always, we continue to incorporated updates and security fixes to modules and libraries in Altis to bring in important bug fixes and improvements. ### Documentation