Frequently Asked Questions about ZnetDK for Mobile.
No answer to your question? Feel free to ask your question on the ZnetDK for Mobile forum.
The main difficulty when developing a large application is to structure and organize the source code as efficiently and logically as possible.
ZnetDK meets these requirements through the development of modules, each of them offering business (eg invoice management) or technical (eg sending marketing emails) functionalities.
A module groups together the source code of the view (in HTML, JavaScript and CSS), of the controllers (in PHP) and of models (DAO and MySQL), all in a tree structure of files making it possible to clearly separate the responsibility of each.
By distributing the source code within the different modules, the application can ultimately be very small in terms of software code and be limited to global configuration scripts of the application (INSTALL_DIR/applications/default/app/config.php
and INSTALL_DIR/applications/default/app/lang/locale.php
) and to the definition of the navigation menu in the INSTALL_DIR/applications/default/app/menu.php
script.
The PHP errors are logged in the INSTALL_DIR/engine/log/errors.log
file.
The errors.log
file traces:
\General::writeErrorLog()
method and the exceptions which he threw.When the .htaccess
Apache file located in the ZnetDK root directory is properly configured, then HTTP 403 and HTTP 404 errors are redirected to a dedicated view in charge of displaying the error.
This view named httperrors.php
can be customized by :
INSTALL_DIR/engine/core/view/
directory to the INSTALL_DIR/applications/default/app/view/
directory.httperrors.php
script and changing its content according to your needs.If your application is configured for multi-language display, the view once translated in another language, can be suffixed by the language code as is done for an application view (eg httperrors_es.php
in Spanish).
The Starter App shipped with ZnetDK is displayed in English. The ZnetDK core features are also translated in Spanish and French.
To develop your Web App with a display that matches your own language, please see the Language settings section.
The source code of the Starter App is located within the INSTALL_DIR/applications/default/
folder (see App folders).
To upgrade ZnetDK to the latest version while preserving the source code of your Web Application:
.OLD
extension (eg to /home/john/www/znetdk4m.OLD/
)./home/john/www/znetdk4m/
) in replacement of the old version.default/
folder in the installation directory of the latest version of ZnetDK (eg the /home/john/www/znetdk4m/applications/default/
folder),default/
folder (eg from the /home/john/www/znetdk4m.OLD/applications/default/
folder).modules/
folder (eg from the /home/john/www/znetdk4m.OLD/engine/modules/
folder),/home/john/www/znetdk4m.OLD/
folder).Just edit the INSTALL_DIR/applications/default/app/config.php
of your Web App and set the Color Theme Style Sheet URL by changing the CFG_MOBILE_W3CSS_THEME
parameter.
The procedure to customize the color theme of your Web App is explained in the section Setting the theme colors.
Edit the INSTALL_DIR/applications/default/app/config.php
of your Web App and change the values of the CFG_MOBILE_CSS_FONT
and CFG_MOBILE_CSS_FONT_FAMILY
parameters.
The procedure to customize the theme font of your Web App is explained in the section Setting the theme font.
Access to the navigation menu can be limited via User Profiles.
For more informations, see section User rights.
By default, once a user is authenticated, his user session expires after 10 minutes of inactivity.
session.gc_maxlifetime
parameter in the hosting php.ini
file).CFG_SESSION_TIMEOUT
parameter.CFG_SESSION_SELECT_MODE
parameter is set to FALSE
and the session expiration is disabled when the CFG_SESSION_DEFAULT_MODE
parameter is set to 'private'
.Extra style sheets can be added permanently to your Web App by specifying explicitly their path or URL to the CFG_APPLICATION_CSS
PHP constant in the INSTALL_DIR/applications/default/app/config.php
script.
When style sheets are directly hosted by the Web App, then they can be copied into a module (for example in INSTALL_DIR/engine/modules/my_module/public/css/minified/
). In this way, ZnetDK automatically detects their presence and adds them to the Web App.
According to the same principle as the style sheets, extra JavaScript libraries can be added permanently to your Web App by specifying explicitly their path or URL to the CFG_APP_JS
PHP constant in the INSTALL_DIR/applications/default/app/config.php
script.
When JS libraries are directly hosted by the Web App, then they can be copied into a module (for example in INSTALL_DIR/engine/modules/my_module/public/js/minified/
). In this way, ZnetDK automatically detects their presence and adds them to the Web App.
One or several controller actions of a Web App can be exposed as web services and be invoked by a remote application or process.
See the Web Services section for more details.
By default, the Web App is configured to run as a Single Page Application (or SPA). This means that only the main page is loaded at the start and the views are then loaded on demand via AJAX calls.
Once a view is loaded and is no longer useful, it is hidden but not removed from the DOM (Document Object Model) of the main page. So if it is to be displayed later, it is not reloaded and is simply displayed again.
This behaviour can be changed under the following scenarios:
CFG_VIEW_PAGE_RELOAD
set to TRUE
. zdk-viewreload
CSS class must be added to any HTML element in the view (see Application views section).CFG_VIEW_PRELOAD
PHP Constant to TRUE
.Here is the procedure to deploy your Web App on a web hosting:
./znetdk4m/
folder) to the web hosting target directory (eg in /home/www/znetdk4m
).INSTALL_DIR/engine/log/
directory where the errors.log
file is created and populated by ZnetDK when errors occur.
Usually, the username under which PHP runs is www-data if Apache is installed.
if necessary, use chmod
and chown
in command line to give write access to the user or group www-data on the INSTALL_DIR/engine/log/
directory..htaccess
with statements Order deny,allow
and Deny from all
exists in the subfolders named app/
(see Folder tree of the Starter App) and mod/
(see Where are the modules installed?).INSTALL_DIR/.htaccess
and configure the ErrorDocument
Apache directive for the HTTP errors 403 and 404 (see HTTP errors 403 and 404).config.php
script (see Database settings).