diff --git a/doc/upgrade/upgrade.docbook b/doc/upgrade/upgrade.docbook index 7a6405e8..9aff707a 100644 --- a/doc/upgrade/upgrade.docbook +++ b/doc/upgrade/upgrade.docbook @@ -95,7 +95,20 @@ sur votre configuration et votre code personnalisé. Fichiers CSS + Les fichiers light-*.css ont été retravaillés pour tous hériter + du fichier light-blue.css qui défini les couleurs de l'interface au travers + des variables. Ainsi, il est très simple d'ajuster ce thème à vos couleurs. Si cela vous intéresse, vous + pouvez prendre exemple sur les autres fichiers light-*.css. + Au passage, ce thème a été retravaillé pour prendre en compte la mise en forme d'un maximum de + composants de l'application. Si vous avez un thème personnalisé, il est conseillé de regarder si celui-ci + ne pourrait pas tirer partie du fichier light-blue.css en le surchargeant. À minima, + vous pouvez analyser les évolutions de ce fichier pour identifier les modifications intéressantes à reporter + sur votre thème personnel. + + Si vous utilisez un des fichiers light-*.css autre que le fichier + light-blue.css, vous devez désormais également charger ce dernier en premier. + corriger les URL des images : url(../../images/default/find.png) devient url(../image/find). Pour identifier les fichiers CSS concernés, vous pouvez utiliser les commandes suivantes :grep -Er 'url\(.*images' /etc/ldapsaisie/local/css @@ -112,29 +125,52 @@ grep -Er 'url\(.*\.(png|gif|jpg)' /etc/ldapsaisie/local/cssgrep -Er 'LSsession *:: *redirect *\(' /etc/ldapsaisie/local/ - Les inclusions de fichiers Javascript via LSsession :: addJSscript() doivent - être adaptées : + Les méthodes de gestion des Javascript et CSS additionels ont été migrées de la classe LSsession + vers la classe LStemplate : - LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js'); - devient LSsession :: addJSscript('LSformElement_eetelephone.js'); - LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js'); - devient LSsession :: addJSscript('LSformElement_eetelephone.js'); - LSsession :: addJSscript('click-to-dial_view.js', 'local/includes/js/'); - devient LSsession :: addJSscript('click-to-dial_view.js'); + LSsession :: addJSscript() devient LStemplate :: addJSscript(). + + Par ailleurs le paramètre $path disparait et la méthode addLibJSscript + à été ajoutée pour permettre spécifiquement l'inclusion des fichiers Javascript des librairies. Voici quelques + exemples d'utilisation et leur équivalent à présent: + + LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js'); + devient LStemplate :: addJSscript('LSformElement_eetelephone.js'); + LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js'); + devient LStemplate :: addJSscript('LSformElement_eetelephone.js'); + LSsession :: addJSscript('click-to-dial_view.js', 'local/includes/js/'); + devient LStemplate :: addJSscript('click-to-dial_view.js'); + LSsession :: addJSscript('Picker.js',LS_LIB_DIR.'arian-mootools-datepicker/'); + devient LStemplate :: addLibJSscript('arian-mootools-datepicker/Picker.js'); + + + LSsession :: addJSconfigParam() devient + LStemplate :: addJSconfigParam(). + LSsession :: addCssFile() devient + LStemplate :: addCssFile(). + Par ailleurs le paramètre $path disparait et la méthode addLibCssFile + à été ajoutée pour permettre spécifiquement l'inclusion des fichiers CSS des librairies. Voici quelques exemples + d'utilisation et leur équivalent à présent: + + LSsession :: addCssFile('test.css', '../../local/css/'); + devient LStemplate :: addCssFile('test.css');. Doit donc être conservé, que + le nom du fichier CSS, pas de chemin vers celui-ci. + LSsession :: addCssFile('datepicker_vista.css',LS_LIB_DIR.'arian-mootools-datepicker/datepicker_vista/'); + devient LStemplate :: addLibCssFile('arian-mootools-datepicker/datepicker_vista/datepicker_vista.css'); + + + Pour identifier les fichiers concernés, vous pouvez utiliser les commandes suivantes : - grep -Er 'LSsession *:: *addJSscript\(.*local' /etc/ldapsaisie/local/ -grep -Er 'LSsession *:: *addJSscript\(.*\.\.\/' /etc/ldapsaisie/local/ + grep -Er 'LSsession *:: *(addJSscript|addLibJSscript|addJSconfigParam|addCssFile|addLibCssFile) *\(' /etc/ldapsaisie/local/ +grep -Er '(LSsession|LStemplate) *:: *addJSscript\(.*local' /etc/ldapsaisie/local/ +grep -Er '(LSsession|LStemplate) *:: *addJSscript\(.*\.\.\/' /etc/ldapsaisie/local/ +grep -Er '(LSsession|LStemplate) *:: *addCssFile\(.*local' /etc/ldapsaisie/local/ +grep -Er '(LSsession|LStemplate) *:: *addCssFile\(.*\.\.\/' /etc/ldapsaisie/local/ - Les inclusions de fichiers CSS via LSsession :: addCssFile() doivent - être adaptées : le nom du fichier CSS uniquememnt doit être conservé (pas de chemin vers le fichier). - Pour identifier les fichiers concernés, vous pouvez utiliser les commandes suivantes : - grep -Er 'LSsession *:: *addCssFile\(.*local' /etc/ldapsaisie/local/ -grep -Er 'LSsession *:: *addCssFile\(.*\.\.\/' /etc/ldapsaisie/local/ - LSlog vs LSdebug : L’utilisation de LSdebug est dépriorisée en faveur de LSlog. Ce dernier ajoute désormais la notion de