To 4.0.0 from 3.0.1
In this release, the whole codebase is refreshed and updated to support the latest version of PHP. A lot of files have been changed, but for some of them, there are some minor cosmetic updates, like adding return types to class functions, so you don't have to update those files if you don't want to.
The list of modified files:
ASEngine/AS.php | 25 +-
ASEngine/ASAjax.php | 46 +-
ASEngine/ASComment.php | 54 ++-
ASEngine/ASCsrf.php | 42 +-
ASEngine/ASDatabase.php | 37 +-
ASEngine/ASEmail.php | 18 +-
ASEngine/ASHelperFunctions.php | 29 +-
ASEngine/ASLang.php | 65 +--
ASEngine/ASLogin.php | 236 +++++-----
ASEngine/ASPasswordHasher.php | 25 +-
ASEngine/ASRegister.php | 151 ++++---
ASEngine/ASResponse.php | 36 +-
ASEngine/ASRole.php | 60 +--
ASEngine/ASSession.php | 27 +-
ASEngine/ASUser.php | 139 +++---
ASEngine/ASValidator.php | 60 +--
assets/css/bootstrap.min.css | 12 +-
assets/css/bootstrap.min.css.map | 2 +-
assets/js/app/index.js | 16 +-
assets/js/vendor/bootstrap.bundle.min.js | 7 -
assets/js/vendor/bootstrap.bundle.min.js.map | 1 -
assets/js/vendor/bootstrap.min.css.map | 2 +-
assets/js/vendor/bootstrap.min.js | 7 +
assets/js/vendor/bootstrap.min.js.map | 1 +
assets/js/vendor/dataTables.bootstrap4.js | 184 ++++++++
assets/js/vendor/dataTables.bootstrap5.js | 14 -
assets/js/vendor/jquery-validate/additional-methods.js | 2462 +-
assets/js/vendor/jquery-validate/additional-methods.min.js | 6 +-
assets/js/vendor/jquery-validate/jquery.validate.js | 3230 +-
assets/js/vendor/jquery-validate/jquery.validate.min.js | 6 +-
assets/js/vendor/jquery.dataTables.min.js | 354 +++++++--------
assets/js/vendor/jquery.min.js | 4 +-
assets/js/vendor/popper.min.js | 5 +
assets/js/vendor/popper.min.js.map | 1 +
composer.json | 10 +-
composer.lock | 405 +++++++++--------
confirm.php | 4 +-
index.php | 18 +-
install/check.php | 2 +-
install/stubs/config.stub | 8 +-
login.php | 74 ++--
passwordreset.php | 4 +-
profile.php | 14 +-
socialauth.php | 148 ++++++-
socialauth_callback.php | 148 +------
templates/footer.php | 3 +-
templates/header.php | 2 +-
templates/languages.php | 16 +-
templates/navbar.php | 14 +-
user_roles.php | 4 +-
users.php | 54 +--
51 files changed, 4031 insertions(+), 4261 deletions(-)
To 3.0.1 from 3.0.0
This is a bug-fix release. You will need to update the modified application files given below to the latest versions and run composer update (or just overwrite the vendor folder if you are not using composer).
Modified files:
ASEngine/AS.php | 2 +-
ASEngine/ASUser.php | 2 +-
assets/css/app.css | 8 ++++++++
composer.json | 2 +-
composer.lock | 129 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++----------------
login.php | 2 +-
socialauth.php | 2 +-
7 files changed, 126 insertions(+), 21 deletions(-)To 3.0.0 from 2.4
Version 3, as another major version, has a lot of mainly frontend breaking changes and the only way to update it is to do do it manually and to update one file at the time.
The app now uses Bootstrap 4 and all frontend files are updated to match the new bootstrap classes. All javascript files are updated as well, so you will need to manually update your old javascript files.
Here are some guidelines that might help you in the update process:
-
All JavaScript files are moved from
ASLibraryfolder toassets/js/appfolder andASLibraryfolder is removed from the app. -
All application CSS files are now in
assets/cssfolder. -
You can overwrite the complete
installfolder if you haven't removed it from the app. This will make sure that all future installations of the app work properly. -
Some of the backend files from
ASEnginedirectory have been refactored, so it is recommended to update them too. -
The app now uses jQuery Validation plugin for frontend validation, which has it's own language files. The files are located inside
assets/js/vendor/jquery-validate/localizationdirectory in case you want to customize them. -
Overwrite your
vendorfolder with latest one. In case you modified something inside the vendor folder, just copy new files instead of overwriting. This version is using the most recent packages (which you can update by runningcomposer updatebtw) so it is important that you update them so application can work properly (especially for social authentication feature). - Update all files from
Langdirectory to the latest version, since version 3 of the app have a few more translation strings added.
To 2.4 from 2.3
This version contains few bug fixes from previous release. Here is what you wound need to do:
-
Overwrite your
vendorfolder with latest one. In case you modified something inside the vendor folder, just copy new files instead of overwriting. This version is using the most recent packages (which you can update by runningcomposer updatebtw) so it is important that you update them so application can work properly (especially for social authentication feature). -
Copy new file called
socialauth_callback.phpto your AS root directory. -
Update
socialauth.phpfile with the latest one. -
Update your social callback url to look like following:
http://yourdomain.com/socialauth_callback.php -
Update
ASEngine/ASCsrf.phpfile to the latest version. -
Overwrite complete
installfolder if you haven't removed it from the app. This will make sure that all future installations of the app work properly. -
Make sure that your
ASEngine/ASDatabase.phpfile is up to date with latest version. -
Update
ASEngine/ASLang.phpfile to match the latest version. -
Update
ASEngine/ASEmail.phpfile to match the latest version. - Make sure that you have
de.phpfile inside yourLangfolder and then updatetemplates\languages.phpfile to add German language to the top list of available languages. Also, if you want to display German flag there, you can copy it from the latest version where it is located insideassets\imgfolder.
To 2.3 from 2.2
This update contains a lot of changes comparing to previous version, and in order to properly do the update, I recommend you to go through all files and carefully update them. In case you haven't modified any of AS files, just overwrite everything and there should not be any issues.
Here are some guidelines on how you should perform the update:
Vendor Folder
Overwrite your vendor folder with latest one. In case you modified something inside the vendor folder, just copy new files instead of overwriting.
Install Folder
Completely replace the install folder. This is not required if you have app in production, since you won't install it again.
ASConfig
Since SESSION_REGENERATE_ID constant is removed, and session is regenerated always when some critical actions occur (after successful authentication, after user update his password etc), you can remove the constant from your ASConfig.php file.
Add following constants to ASConfig.php file:
// Name used when emails are sent from your server.
// Default is your website name.
define('MAIL_FROM_NAME', "your_mail_from_name_here");
// Email used when emails are sent from your server.
// The recepients will see this as an email from
// which they receive their emails.
define('MAIL_FROM_EMAIL', "your_from_email_here");PHP Classes
Copy new classes into ASEngine folder Update ASEngine\AS.php file to the latest version
Go through all PHP classes, one by one, and move all dependencies to the constructor. For example, if somewhere inside ASUser class you have $validator = new ASValidator(); you will create new protected $validator; property and move the ASValidator instance to be passed through the constructor (check latest version of ASUser class). Now, everywhere inside ASUser class you will use validator instance like $this->validator
This has to be done with all dependencies in every PHP class that AS has, and the easiest way to find all dependencies is to simply search the file for "new" keyword. This is simple preparation for some future updates that will modernize the code structure and make script testable and easier to maintain.
Assets
You should update assets folder to match the latest version. This basically means that you must copy all new files and folders from latest version, but you don't have to remove old files if you don't want to. Script will just ignore them if they are not included on your pages.
Update ASLibrarly/js/users.js, ASLibrarly/js/roles.js and ASLibrarly/js/register.js to the latest version that contains few fixes. Other JavaScript files located inside ASLibrary/js folder are not modified.
Copy newly created js-bootstrap.php file into ASLibrary/js directory.
Pages
Go through all pages (login.php, index.php...) and apply all changes from latest version. If you haven't modified those files, you can just overwrite them.
In case that you are using your own design, you probably don't need to change anything that is HTML/CSS/JavaScript related. All you have to do in that case is to update the query that is responsible for fetching data and displaying it to database (usually located on top of every file).
Update templates/footer.php to include some common scripts as well as newly created js-bootstrap.php file that is now used to initialize $_lang variable and set up jQuery AJAX to send CSRF token automatically. This means that you should now remove $_lang variable initialization from any other files than js-bootstrap.php.