Application Android - DoliDroid



= Informations =

= Features = DoliDroid is the Android front-end client for Dolibarr ERP & CRM web software.

This application is not a standalone program. It is a front end to use on your online hosted Dolibarr ERP & CRM software.

The advantage of DoliDroid are :
 * DoliDroid is not a duplicate code of Dolibarr, but a front-end of a Dolibarr web installation, so all your online existing features are supported by this application. This is also true for external modules features.
 * Upgrading Dolibarr will not break DoliDroid.
 * DoliDroid use embedded image resources to reduce bandwidth.
 * DoliDroid use internal cache for pages that should not change (like menu page)
 * Connections parameters are saved. No need to enter them each time you use DoliDroid.
 * Integration with your phone or other applications (Clicking on PDF open PDF reader, clicking onto email or phone launch your email application or launch Android dialer, ...)

WARNING !

Due to bugs into Dolibarr 3.4, all features you can use in read mode are guaranteed, however, some create or update features are disabled, like creating/editing invoice/order/proposal/contract. With release of Dolibarr 3.5+, all features should be supported with no restrictions.

This application need Android 2.2+ (3.0+ recommended) and an online hosted Dolibarr ERP & CRM version 3.4+ (for example an online instance provided by one of the SaaS/Cloud hosting provider).

Voir video on Youtube: https://www.youtube.com/watch?v=ult2dmHaP4sSee



= Installation =
 * From Google Play Store, click here: https://play.google.com/store/apps/details?id=com.nltechno.dolidroidpro


 * Manually: If you get the .apk file (whatever is the source), just open the .apk from the smartphone/tablet web browser or file-system browser. This should launch installation of .apk file on your phone.

Once package installation has been done, a new icon called "DoliDroid" is available into the list of your application.

= Setup = There is nothing to do once application is installed onto your smartphone.

= Usage =
 * Run the application
 * Enter the root URL access to your Dolibarr instance (for next time, it will be saved in drop-down list)
 * Use Dolibarr
 * The "Menu" button will bring up the options (permanent display of the back button, purge cache, ...)
 * The "Quick access" button will open a page with the search form you find on left menu when using a standard desktop browser.

= Development = Development of this module is not included inside the standard GIT repository of Dolibarr but inside a repository dedicated to modules not supported by the Dolibarr development team but supported by NLTechno on platform Doliforge: Note this is a private repository, so you must apply to be a member from Doliforge web site to be able to clone sources using GIT.
 * Repository: https://doliforge.org/projects/AndroidApp/

=Troubleshooting =

JSERR001
If you get this error when loaing a page/feature with DoliDroid (including tha login page), this means your Dolibarr installation on server side serve bugged pages. In a common usage of Dolibarr, this may have no visible effect for user. But when used from a smartphone, this make DoliDroid fails loading pages. This is common things to check to solve the problem: - Install missing packages by launching from command line - Go into config file /etc/dolibarr/conf.php and check you have the following line uncommented (if line is not found, add it at end of file).
 * If you have installed external modules, try after disabling them (some external modules introduce bugs).
 * Try also to call login page from a standard PC by adding &dol_use_jmobile=1 as parameter of URL and check you don't have any javascript errors.
 * If you installed Dolibarr with the debian package, check into directory /usr/share/javascript that you find a directory called jquery, jquery-ui and flot. If one of this directory is missing (or if all directory /usr/share/javascript) is missing:
 * If you installed Dolibarr with the debian package, check into directory /usr/share/javascript/flot that you find a file called jquery.flot.pie.js. If file does not exists, ...