ZnetDK 4 Module theme chooser

Allows the ZnetDK 4 Mobile application to be displayed with a dark theme.

FEATURES

This module add a "Theme" button to the User Panel.
When clicked, a modal dialog is displayed to apply the dark theme or to come back to the light theme.
The favorite theme is saved in database for the logged in user.

REQUIREMENTS

• ZnetDK 4 Mobile version 3.2 or higher,
• A MySQL database is configured to store the application data,
• PHP version 7.4 or higher,
• Authentication is enabled (CFG_AUTHENT_REQUIRED is TRUE in the App's config.php).

INSTALLATION

1. Copy module's code in the ./engine/modules/z4m_themechooser/ subdirectory,
2. Edit the App's config.php located in the ./applications/default/app/ subfolder and set the path or URL of your dark theme CSS stylesheet to the MOD_Z4M_THEMECHOOSER_CSS_DARK_THEME PHP constant.
   If the app logo to be displayed for dark theme is different from the one for light theme, also set the path of your light and dark logos to the MOD_Z4M_THEMECHOOSER_LOGO_LIGHT_THEME and MOD_Z4M_THEMECHOOSER_LOGO_DARK_THEME PHP constants.
   For example:

define('MOD_Z4M_THEMECHOOSER_CSS_DARK_THEME', 'applications/'.ZNETDK_APP_NAME.'/public/css/theme-dark.css');
// Optional: the paths of the light and dark logos
define('MOD_Z4M_THEMECHOOSER_LOGO_LIGHT_THEME', 'applications/'.ZNETDK_APP_NAME.'/public/images/logo-light.png');
define('MOD_Z4M_THEMECHOOSER_LOGO_DARK_THEME', 'applications/'.ZNETDK_APP_NAME.'/public/images/logo-dark.png');

3. In option, If the app logo to be displayed for dark theme is different from the one for light theme, edit the locale.php script of your application and set the LC_HEAD_IMG_LOGO PHP constant to the path of the dark logo if dark theme is to be displayed.
   For example:

/* Heading images */
use z4m_themechooser\mod\controller\Users;
if (Users::getUserTheme() === MOD_Z4M_THEMECHOOSER_CSS_DARK_THEME) {
    define('LC_HEAD_IMG_LOGO', MOD_Z4M_THEMECHOOSER_LOGO_DARK_THEME);
} else {
    define('LC_HEAD_IMG_LOGO', MOD_Z4M_THEMECHOOSER_LOGO_LIGHT_THEME);
}

TRANSLATIONS

This module is translated in French, English and Spanish languages. To translate this module in another language or change the standard translations:

1. Copy in the clipboard the PHP constants declared within the locale_en.php script of the module,
2. Paste them from the clipboard within the locale.php script of your application,
3. Finally, translate each text associated with these PHP constants into your own language.

ISSUES

The zdk_user_themes SQL table is created automatically by the module when the user's favorite theme is read or saved for the first time. If the MySQL user declared through the CFG_SQL_APPL_USR PHP constant does not have CREATE privilege, the module can't create the required SQL table. In this case, you can create the zdk_user_themes SQL table by importing in MySQL or phpMyAdmin the script z4m_themechooser.sql provided by the module.

CHANGE LOG

See CHANGELOG.md file.

CONTRIBUTING

Your contribution to the ZnetDK 4 Mobile project is welcome. Please refer to the CONTRIBUTING.md file.