First and most importantly: Backup your database and entire project directory!
After every update you should delete all files within the
data/cache/
directory.
If you haven't made any changes to the core files, your configuration, customizations and data should stay intact after the update.
- Replace the
vendor/
directory
🚨 Warnings:
- This version is only compatible with PHP 8.1 or higher
- Due to extensive code changes for this compatibility, there may appear new (and not yet "issued") bugs.
Please test this version thoroughly before deploying in production.
Also, please report any PHP 8.1 related bugs in our GitHub issue section. - The bundled file manager has been removed in this version, as it was outdated and considered insecure.
Until we have implemented a new solution, you may have to upload files the old-fashioned way ((S)FTP or similar).
Update steps:
- Replace the
data/docs/
directory - Create a
data/mails
directory - Replace the
module/
directory- If you made custom changes to the code, you have to migrate them manually
- Replace files:
public/index.php
public/setup.php
- Delete the directory
public/vendor/filemanager
:
This is technically not necessary, but recommended. - Paste the new
src/
directory - Replace the
vendor/
directory - Technically not necessary, but for consistency reasons:
Replace the files in the project directory:composer.json
composer.lock
CONTRIBUTE.md
INSTALL.md
LICENSE
README.md
UPDATE.md
VERSION
- Delete files:
INSTALL
(without file extension)README
(without file extension)
Replace the following directories:
module/
vendor/
There are no steps necessary when updating from version 1.6.3
.
Replace the following directories:
-
data/docs/
-
data/res/i18n/
-
module/
-
public/js/jquery/
-
vendor/
(alternatively, you may update dependencies via Composer after replacing thecomposer.json
) -
All single files in the project root directory
There have been some internal changes to the configuration directory. Replace the following files:
-
config/init.php.dist
-
config/init.php
(and edit it according to your needs; if it does not yet exist, create it by copyinginit.php.dist
) -
data/docs/*
-
public/index.php
-
vendor/*
(alternatively, you may update dependencies via Composer after replacing thecomposer.json
) -
All single files in the project root directory
Replace the following directories and files with the new ones:
-
config/application.php
-
config/modules.php
-
config/setup.php
-
data/res/
(if you have custom translations youcanshould now place them indata/res/i18n-custom/
) -
module/
-
modulex/
-
public/js/
-
public/index.php
Replace the following directories and files with the new ones:
-
data/res/
-
module/
-
public/css/
-
public/docs/
-
public/imgs/
-
public/js/
-
public/misc/
-
public/vendor/
-
index.php
-
vendor/
(alternatively, you may update dependencies via Composer after replacing thecomposer.json
) -
All single files in the project root directory