2020-05-11 17:29:51 +02:00
|
|
|
|
<?xml version="1.0" encoding="UTF-8" ?>
|
|
|
|
|
<chapter>
|
|
|
|
|
|
|
|
|
|
<title>Mise à jour</title>
|
|
|
|
|
|
|
|
|
|
<para>Cette section de la documentation détaille la procédure de mise à jour d'une installation existante
|
|
|
|
|
et regroupe des informations pratiques et utiles pour des montées de versions spécifiques entrainant par
|
|
|
|
|
exemple une perte de rétrocompatibilité de la configuration.</para>
|
|
|
|
|
|
|
|
|
|
<sect1>
|
|
|
|
|
<title>Procédure de mise à jour</title>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Installation via paquet Debian</title>
|
|
|
|
|
<para>Lors d’une installation par paquet Debian, la mise à jour est grandement facilité par le packaging:
|
|
|
|
|
Il vous suffit de mettre à jour le paquet <literal>ldapsaisie</literal> :
|
|
|
|
|
<programlisting>apt update
|
|
|
|
|
apt install ldapsaisie</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>Une fois l’application mise à jour, prêté attention aux nouveautés et point de vigilances décrite dans
|
|
|
|
|
la section suivante.</para>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Installation à partir des sources</title>
|
|
|
|
|
<para>Lors d’une installation par à partir des sources, le script <literal>upgradeFromGit.sh</literal> permet
|
|
|
|
|
d’automatiser la mise à jour, à condition que vous ayez suivi la procédure d’installation à ce sujet.</para>
|
|
|
|
|
|
|
|
|
|
<para>Ce script s’occupera alors de :
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara>Nettoyer <literal>working-tree</literal> Git des liens symboliques des fichiers locaux
|
|
|
|
|
(et éventuellement du thème) mis en place lors d’une précédente exécution ;</simpara></listitem>
|
|
|
|
|
<listitem><simpara>Vider le cache des templates ;</simpara></listitem>
|
|
|
|
|
<listitem><simpara>Mettre à jour le <literal>working-tree</literal> Git via un <literal>git pull</literal>
|
|
|
|
|
de la mise à jour ;</simpara></listitem>
|
|
|
|
|
<listitem><simpara>Installer des liens symboliques pour les fichiers locaux. En cas de fichier remplacant
|
|
|
|
|
un fichier livré avec l’application, le script vous notifiera en cas de changement intervenu dans le fichier
|
|
|
|
|
fourni avec l’application et vous permettra de le mettre à jour simplement votre fichier local (via un
|
|
|
|
|
<literal>vim -d</literal>) ;</simpara></listitem>
|
|
|
|
|
<listitem><simpara>Détecter des changements dans les fichiers <literal>MO</literal> (traduction) et de
|
|
|
|
|
déclencher dans ce cas un rechargement du serveur web pour prise en compte ;</simpara></listitem>
|
|
|
|
|
<listitem><simpara>Option : de compiler une version locale à jour de la documentation ;</simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>Une fois l’application mise à jour, prêté attention aux nouveautés et point de vigilances décrite dans
|
|
|
|
|
la section suivante.</para>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
<sect1>
|
|
|
|
|
<title>Mise à jour 2.4.1 -> 3.0.0</title>
|
|
|
|
|
|
|
|
|
|
<para>Cette mise à jour majeure apporte de nombreuses nouveautés auxquelles il est important de prêter attention.
|
|
|
|
|
Cette section ne parlera pas particulièrement de ces nouveautés, mais vous pouvez consulter le fichier <ulink
|
|
|
|
|
url="&GIT_RAW_ROOT_URL;/debian/ldapsaisie.NEWS">debian/ldapsaisie.NEWS
|
|
|
|
|
</ulink> pour cela. Cette section listera en outre les points de vigilances à avoir et les adaptations à apporter
|
|
|
|
|
sur votre configuration et votre code personnalisé.</para>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Fichier config.inc.php</title>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara>ajout du paramètre <literal>ConsoleTable</literal> avec pour valeur par défaut sous
|
|
|
|
|
<application>Debian</application> <literal>/usr/share/php/Console/Table.php</literal></simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem><simpara>ajout du paramètre <literal>public_root_url</literal> avec pour valeur par défaut sous
|
|
|
|
|
<application>Debian</application> <literal>/ldapsaisie</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara>paramètre <literal>$GLOBALS['defaultCSSfiles']</literal> : il est nécessaire de modifier les
|
|
|
|
|
URLs des fichiers listés : seul le nom du fichier doit rester, sa localisation sera détectée automatiquement. Par
|
|
|
|
|
exemple, <literal>$GLOBALS['defaultCSSfiles']=array('../light-blue.css');</literal> devient <literal>
|
|
|
|
|
$GLOBALS['defaultCSSfiles']=array('light-blue.css');</literal>.
|
|
|
|
|
</simpara></listitem>
|
2020-05-12 19:41:42 +02:00
|
|
|
|
<listitem><para>les paramètres <literal>authObjectType</literal>, <literal>authObjectFilter</literal> et
|
|
|
|
|
<literal>authObjectTypeAttrPwd</literal> sont remplacés par le tablau <literal>LSobjects</literal> dans le
|
|
|
|
|
paramètre <literal>LSauth</literal>.</para>
|
|
|
|
|
<para>Par exemple:
|
|
|
|
|
<programlisting>'authObjectType' => 'LSpeople',
|
|
|
|
|
'authObjectFilter' => '(|(uid=%{user})(mail=%{user}))',
|
|
|
|
|
'authObjectTypeAttrPwd' => 'userPassword',</programlisting>
|
|
|
|
|
Devient:
|
|
|
|
|
<programlisting>'LSauth' => array (
|
|
|
|
|
'LSobjects' => array(
|
|
|
|
|
'LSpeople' => array(
|
|
|
|
|
'filter' => '(|(uid=%{user})(mail=%{user}))',
|
|
|
|
|
'password_attribute' => 'userPassword',
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
[...]
|
|
|
|
|
),</programlisting>
|
|
|
|
|
</para></listitem>
|
2020-05-28 20:32:18 +02:00
|
|
|
|
<listitem><simpara>Une erreur de frappe historique a été corrigé dans le nom de la variable
|
|
|
|
|
<literal>$GLOBALS['defaultJSscripts']</literal>, à savoir un <emphasis>"R"</emphasis> manquant.</simpara>
|
|
|
|
|
</listitem>
|
2020-05-28 20:06:45 +02:00
|
|
|
|
<listitem><simpara>Les fichiers Javascript utilisés par défaut par l'application ne sont désormais plus
|
2020-05-28 20:32:18 +02:00
|
|
|
|
listés dans la variable <literal>$GLOBALS['defaultJSscripts']</literal>. Seul doit y demeurer vos propres
|
2020-05-28 20:06:45 +02:00
|
|
|
|
fichiers. Voici la liste des fichiers concernés et qui n'ont plus à être inclus via ce paramètre :</simpara>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara><literal>mootools-core.js</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>mootools-more.js</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>functions.js</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>LSdefault.js</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>LSinfosBox.js</literal></simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</listitem>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</itemizedlist>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Fichiers CSS</title>
|
2020-05-28 19:39:58 +02:00
|
|
|
|
<note><para>Les fichiers <literal>light-*.css</literal> ont été retravaillés pour tous <emphasis>hériter
|
|
|
|
|
</emphasis> du fichier <literal>light-blue.css</literal> 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 <literal>light-*.css</literal>.</para>
|
|
|
|
|
<para>Au passage, ce thème a été retravaillé pour prendre en compte la mise en forme d'un maximum de
|
2020-06-02 20:06:13 +02:00
|
|
|
|
composants de l'application tout en profitant du côté responsive de l'interface apporter par cette
|
|
|
|
|
mise à jour. Si vous avez un thème personnalisé, il est conseillé de regarder si celui-ci ne pourrait pas
|
|
|
|
|
tirer partie du fichier <literal>light-blue.css</literal> en le surchargeant. À minima, vous pouvez analyser
|
|
|
|
|
les évolutions de ce fichier pour identifier les modifications intéressantes à reporter sur votre thème
|
|
|
|
|
personnel.</para>
|
2020-05-28 19:39:58 +02:00
|
|
|
|
</note>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<itemizedlist>
|
2020-05-28 19:39:58 +02:00
|
|
|
|
<listitem><simpara>Si vous utilisez un des fichiers <literal>light-*.css</literal> autre que le fichier
|
|
|
|
|
<literal>light-blue.css</literal>, vous devez désormais également charger ce dernier en premier.</simpara>
|
|
|
|
|
</listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<listitem><para>corriger les URL des images : <literal>url(../../images/default/find.png)</literal> devient
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<literal>url(../image/find)</literal>. Pour identifier les fichiers CSS concernés, vous pouvez utiliser les
|
|
|
|
|
commandes suivantes :<programlisting>grep -Er 'url\(.*images' /etc/ldapsaisie/local/css
|
2020-05-11 17:38:27 +02:00
|
|
|
|
grep -Er 'url\(.*\.(png|gif|jpg)' /etc/ldapsaisie/local/css</programlisting></para></listitem>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<listitem><simpara>modification CSS page <literal>fatal_error</literal> (fichier base.css) : <literal>
|
|
|
|
|
#fatal_error</literal> devient <literal>#error</literal></simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Fichiers PHP</title>
|
|
|
|
|
<itemizedlist>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<listitem><para><literal>LSsession :: redirect()</literal> devient <literal>LSurl :: redirect()</literal>.
|
2020-05-11 17:29:51 +02:00
|
|
|
|
Pour identifier les fichiers CSS concernés, vous pouvez utiliser la commande suivante :
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<programlisting>grep -Er 'LSsession *:: *redirect *\(' /etc/ldapsaisie/local/</programlisting></para></listitem>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<listitem>
|
2020-05-28 19:39:58 +02:00
|
|
|
|
<para>Les méthodes de gestion des Javascript et CSS additionels ont été migrées de la classe <literal>LSsession
|
|
|
|
|
</literal> vers la classe <literal>LStemplate</literal> :
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<itemizedlist>
|
2020-05-28 19:39:58 +02:00
|
|
|
|
<listitem><para><literal>LSsession :: addJSscript()</literal> devient <literal>LStemplate :: addJSscript()</literal>.
|
|
|
|
|
</para>
|
|
|
|
|
<para>Par ailleurs le paramètre <literal>$path</literal> disparait et la méthode <literal>addLibJSscript</literal>
|
|
|
|
|
à été ajoutée pour permettre spécifiquement l'inclusion des fichiers Javascript des librairies. Voici quelques
|
|
|
|
|
exemples d'utilisation et leur équivalent à présent:</para>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js');</literal>
|
|
|
|
|
devient <literal>LStemplate :: addJSscript('LSformElement_eetelephone.js');</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js');</literal>
|
|
|
|
|
devient <literal>LStemplate :: addJSscript('LSformElement_eetelephone.js');</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addJSscript('click-to-dial_view.js', 'local/includes/js/');</literal>
|
|
|
|
|
devient <literal>LStemplate :: addJSscript('click-to-dial_view.js');</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addJSscript('Picker.js',LS_LIB_DIR.'arian-mootools-datepicker/');</literal>
|
|
|
|
|
devient <literal>LStemplate :: addLibJSscript('arian-mootools-datepicker/Picker.js');</literal></simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addJSconfigParam()</literal> devient
|
|
|
|
|
<literal>LStemplate :: addJSconfigParam()</literal>.</simpara></listitem>
|
2020-06-04 19:04:48 +02:00
|
|
|
|
<listitem><simpara><literal>LSsession :: addHelpInfos()</literal> devient
|
|
|
|
|
<literal>LStemplate :: addHelpInfo()</literal>.</simpara></listitem>
|
2020-05-28 19:39:58 +02:00
|
|
|
|
<listitem><para><literal>LSsession :: addCssFile()</literal> devient
|
|
|
|
|
<literal>LStemplate :: addCssFile()</literal>.</para>
|
|
|
|
|
<para>Par ailleurs le paramètre <literal>$path</literal> disparait et la méthode <literal>addLibCssFile</literal>
|
|
|
|
|
à été ajoutée pour permettre spécifiquement l'inclusion des fichiers CSS des librairies. Voici quelques exemples
|
|
|
|
|
d'utilisation et leur équivalent à présent:</para>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addCssFile('test.css', '../../local/css/');</literal>
|
|
|
|
|
devient <literal>LStemplate :: addCssFile('test.css');</literal>. Doit donc être conservé, que
|
|
|
|
|
le nom du fichier CSS, pas de chemin vers celui-ci.</simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>LSsession :: addCssFile('datepicker_vista.css',LS_LIB_DIR.'arian-mootools-datepicker/datepicker_vista/');</literal>
|
|
|
|
|
devient <literal>LStemplate :: addLibCssFile('arian-mootools-datepicker/datepicker_vista/datepicker_vista.css');</literal>
|
|
|
|
|
</simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</listitem>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Pour identifier les fichiers concernés, vous pouvez utiliser les commandes suivantes :
|
2020-06-04 19:04:48 +02:00
|
|
|
|
<programlisting>grep -Er 'LSsession *:: *(addJSscript|addLibJSscript|addJSconfigParam|addHelpInfos|addCssFile|addLibCssFile) *\(' /etc/ldapsaisie/local/
|
2020-05-28 19:39:58 +02:00
|
|
|
|
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/</programlisting>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<para><literal>LSlog</literal> vs <literal>LSdebug</literal> : L’utilisation de <literal>LSdebug</literal>
|
|
|
|
|
est dépriorisée en faveur de <literal>LSlog</literal>. Ce dernier ajoute désormais la notion de
|
|
|
|
|
<emphasis>logger</emphasis>, permettant d’identifier la source des logs. Ce mécanisme permet la configuration
|
|
|
|
|
d’un niveau de log spécifique pour un <emphasis>logger</emphasis> donné, ainsi que la mise en place de filtres
|
|
|
|
|
au niveau des <emphasis>handers</emphasis> pour ne logger par exemple que certains <emphasis>loggers</emphasis>,
|
|
|
|
|
ou à l’inverse en exclure d’autres.</para>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>Pour vos classes personnalisées : si celles-ci héritent d’une classe standard, il est fort probable
|
|
|
|
|
qu’il soit possible d’utiliser des méthodes fournies par cette classe pour logguer au travers un
|
|
|
|
|
<emphasis>logger</emphasis> dédié (voir les méthodes <literal>log_debug</literal>, <literal>log_info</literal>,
|
|
|
|
|
…). À défaut, il est possible d’utiliser la classe <literal>LSlog_staticLoggerClass</literal> qui facilite
|
|
|
|
|
l’implémentation.</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<para>Pour vos &LSaddons; : il est conseillé d’utiliser un <emphasis>logger</emphasis>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<literal>LSaddon_[addon]</literal> dédié. Le <emphasis>logger</emphasis> peut facilement être récupéré de la
|
|
|
|
|
manière suivante : <programlisting>LSlog :: get_logger("LSaddon_[addon]")</programlisting>
|
|
|
|
|
Cette méthode retourne une référence au <emphasis>logger</emphasis> et il est possible d’appeler directement
|
|
|
|
|
une méthode de log, par exemple :
|
|
|
|
|
<programlisting>LSlog :: get_logger("LSaddon_[addon]") -> debug("message");</programlisting>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
</para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Fichiers templates :</title>
|
|
|
|
|
|
|
|
|
|
<sect3>
|
|
|
|
|
<title>Changement de l’inclusion des templates</title>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem>
|
|
|
|
|
<para>Le cas des fichiers <literal>top.tpl</literal> et <literal>bottom.tpl</literal>
|
|
|
|
|
<programlisting>{include file='ls:top.tpl'}
|
|
|
|
|
|
|
|
|
|
[...]
|
|
|
|
|
|
|
|
|
|
{include file='ls:bottom.tpl'}</programlisting>
|
|
|
|
|
devient :
|
|
|
|
|
<programlisting>{extends file='ls:base_connected.tpl'}
|
|
|
|
|
{block name="content"}
|
|
|
|
|
|
|
|
|
|
[...]
|
|
|
|
|
|
|
|
|
|
{/block}
|
|
|
|
|
</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
<note><simpara>Pages à l’état connecté uniquement (incluant le menu, l’entête…).</simpara></note>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<para>Fichiers avec entête HTML :
|
|
|
|
|
<programlisting><![CDATA[<html>
|
|
|
|
|
<head>
|
|
|
|
|
[...]
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
[...]
|
|
|
|
|
</body>
|
|
|
|
|
</html>]]></programlisting>
|
|
|
|
|
devient :
|
|
|
|
|
<programlisting>{extends file='ls:base.tpl'}
|
|
|
|
|
{block name="body"}
|
|
|
|
|
[...]
|
|
|
|
|
{/block}</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
<para>Au besoin, si vous avez besoin :
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<para>de remplacer les fichiers CSS chargés par défaut (<literal>base.css</literal> par exemple) : ajouter
|
|
|
|
|
le block <literal>css</literal> :
|
|
|
|
|
<programlisting><![CDATA[{block name="css"}
|
|
|
|
|
<link rel="stylesheet" type="text/css" href="{css name='custom.css'}" media="screen" title="Normal" />
|
2020-05-28 16:56:36 +02:00
|
|
|
|
{include file='ls:css.tpl'}
|
2020-05-11 17:29:51 +02:00
|
|
|
|
{/block}]]></programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
<note><simpara>Ce block contient tous les CSS, y compris ceux gérés par <literal>LSsession :: addCssFile()</literal>.
|
2020-05-28 16:56:36 +02:00
|
|
|
|
Pensez à ajouter <literal>{include file='ls:css.tpl'}</literal> pour conserver ces derniers.</simpara></note>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<para>d’ajouter des infos dans <literal><![CDATA[<head>]]></literal> : ajouter le block <literal>head</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
(vide par défaut) :
|
|
|
|
|
<programlisting>{block name="head"}
|
|
|
|
|
[...]
|
|
|
|
|
{/block}</programlisting>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
</para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<para>d’ajouter des fichiers Javascript personnalisés : ajouter le block <literal>js</literal> (vide par
|
2020-05-11 17:29:51 +02:00
|
|
|
|
défaut):
|
|
|
|
|
<programlisting>{block name="js"}
|
|
|
|
|
[...]
|
|
|
|
|
{/block}</programlisting>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
</para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<note><simpara>Ce block sera ajouté <emphasis>APRÈS</emphasis> les autres fichiers Javascript chargés (ceux par
|
|
|
|
|
défaut et ceux ajoutés via <literal>LSsession :: addJSscript()</literal>.</simpara></note>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
</listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<listitem><para>Autres fichiers remplacés :
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara><literal>blank.tpl</literal> remplacé par <literal>base.tpl</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>empty.tpl</literal> remplacé par <literal>base_connected.tpl</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara><literal>accueil.tpl</literal> remplacé par <literal>homepage.tpl</literal></simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
</para></listitem>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</itemizedlist>
|
|
|
|
|
<para>Pour identifier les fichiers concernés, vous pouvez utiliser la commande suivante :
|
|
|
|
|
<programlisting>grep -Er '(accueil|blank|empty|top|bottom)\.tpl' /etc/ldapsaisie/local/</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
<sect3>
|
|
|
|
|
<title>Fichiers templates fournis par defaut :</title>
|
|
|
|
|
<para>Vérifier les modifications des fichiers templates fourni avec l’application et que vous auriez personnalisé.
|
|
|
|
|
Pour cela, vous pouvez utiliser la commande suivante :<programlisting><![CDATA[for i in $( ls /etc/ldapsaisie/local/templates/* )
|
|
|
|
|
do
|
|
|
|
|
default_file="/usr/share/ldapsaisie/templates/default/$( basename "$i" )"
|
|
|
|
|
[ ! -e "$default_file" ] && continue
|
|
|
|
|
vi -d $default_file $i
|
|
|
|
|
done]]></programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
<note><simpara>Une attention particulière doit être porté aux fichiers <literal>login.tpl</literal> et <literal>
|
|
|
|
|
recoverpassword.tpl</literal> qui ont particulièrement changés.</simpara></note>
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
<sect3>
|
|
|
|
|
<title>Corriger les URL des images :</title>
|
|
|
|
|
<para><literal>../../images/default/find.png</literal> devient <literal>../image/find</literal></para>
|
|
|
|
|
|
|
|
|
|
<para>Pour identifier les fichiers concernés, vous pouvez utiliser les commandes suivantes :
|
|
|
|
|
<programlisting>grep -Er 'images' /etc/ldapsaisie/local/templates
|
|
|
|
|
grep -Er '\.(png|gif|jpg)' /etc/ldapsaisie/local/templates</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
<sect3>
|
|
|
|
|
<title>Le cas de variable de template <literal>{$LSsession_css}</literal> et <literal>{$LSsession_js}</literal> :</title>
|
|
|
|
|
<note><simpara>Ceci est déjà géré si vous étendez bien vos templates du fichier <literal>base.tpl</literal> (pour
|
|
|
|
|
les pages non-connectées) ou <literal>base_connected.tpl</literal> (pour les pages connectées).</simpara></note>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
2020-05-28 16:56:36 +02:00
|
|
|
|
<literal>{$LSsession_css}</literal> doit être remplacé par <literal>{include file='ls:css.tpl'}</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
2020-05-28 16:56:36 +02:00
|
|
|
|
<literal>{$LSsession_js}</literal> doit être remplacé par <literal>{include file='ls:js.tpl'}</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2>
|
|
|
|
|
<title>Tous les fichiers : Modification des URLs</title>
|
|
|
|
|
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<literal>view.php</literal> :
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><simpara>page recherche : <literal>view.php?LSobject=LSpeople</literal> devient
|
|
|
|
|
<literal>object/LSpeople</literal></simpara></listitem>
|
|
|
|
|
<listitem><simpara>page d'un objet : <literal>view.php?LSobject=LSpeople&dn=$dn</literal> devient
|
|
|
|
|
<literal>object/LSpeople/$dn</literal></simpara></listitem>
|
|
|
|
|
</itemizedlist>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
</para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>addon_view.php</literal> :
|
|
|
|
|
<literal>addon_view.php?LSaddon=ee&view=copyContract</literal> devient
|
|
|
|
|
<literal>addon/ee/copyContract</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
<para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
<literal>index_ajax.php</literal> :
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Pour les méthodes Ajax de classes :
|
|
|
|
|
<programlisting>var data = {
|
|
|
|
|
template: 'LSformElement_eetelephone',
|
|
|
|
|
action: 'make_call',
|
|
|
|
|
telephoneNumber: tel,
|
|
|
|
|
name: name,
|
|
|
|
|
};
|
|
|
|
|
new Request({url: 'index_ajax.php', data: data, onSuccess: ...});</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
<para>Devient :
|
|
|
|
|
<programlisting>var data = {
|
|
|
|
|
telephoneNumber: tel,
|
|
|
|
|
name: name,
|
|
|
|
|
};
|
|
|
|
|
new Request({url: 'ajax/class/LSformElement_eetelephone/make_call', data: data, onSuccess: ...});</programlisting>
|
|
|
|
|
</para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Pour les méthodes Ajax d'addon :
|
|
|
|
|
<programlisting>var data = {
|
|
|
|
|
addon: 'asterisk',
|
|
|
|
|
action: 'LSasterisk_make_call',
|
|
|
|
|
telephoneNumber: tel,
|
|
|
|
|
name: name,
|
|
|
|
|
nocache: new Date().getTime()
|
|
|
|
|
};
|
|
|
|
|
new Request({url: 'index_ajax.php', data: data, onSuccess: ...});</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
<para>Devient :
|
|
|
|
|
<programlisting>var data = {
|
|
|
|
|
telephoneNumber: tel,
|
|
|
|
|
name: name,
|
|
|
|
|
nocache: new Date().getTime()
|
|
|
|
|
};
|
|
|
|
|
new Request({url: 'ajax/addon/asterisk/LSasterisk_make_call', data: data, onSuccess: ...});</programlisting>
|
|
|
|
|
</para></listitem>
|
|
|
|
|
|
|
|
|
|
</itemizedlist>
|
2020-05-11 17:38:27 +02:00
|
|
|
|
</para>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>global_search.php</literal> :
|
|
|
|
|
<literal>global_search.php?refresh</literal> devient <literal>search?refresh</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>index.php</literal> :
|
|
|
|
|
<literal>index.php?LSsession_recoverPassword</literal> devient <literal>index?LSsession_recoverPassword</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>create.php</literal> :
|
|
|
|
|
<literal>create.php?LSobject=LSpeople</literal> devient <literal>object/LSpeople/create</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>modify.php</literal> :
|
|
|
|
|
<literal>modify.php?LSobject=LSpeople&dn=$dn</literal> devient <literal>object/LSpeople/$dn/modify</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>import.php</literal> :
|
|
|
|
|
<literal>import.php?LSobject=LSpeople</literal> devient <literal>object/LSpeople/import</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<para>
|
|
|
|
|
<literal>remove.php</literal> :
|
|
|
|
|
<literal>remove.php?LSobject=LSpeople&dn=$dn</literal> devient <literal>object/LSpeople/$dn/remove</literal>
|
|
|
|
|
</para>
|
|
|
|
|
<para>Avec validation :
|
|
|
|
|
<literal>remove.php?LSobject=LSpeople&dn=$dn&valid</literal> devient <literal>object/LSpeople/$dn/remove?valid</literal>
|
|
|
|
|
</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<literal>select.php</literal> :
|
|
|
|
|
<literal>select.php?LSobject=LSpeople</literal> devient <literal>object/LSpeople/select</literal>
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<para>
|
|
|
|
|
<literal>custom_action.php</literal> :
|
|
|
|
|
<literal>custom_action.php?LSobject=LSpeople&dn=$dn&customAction=$customAction</literal> devient
|
2020-05-13 15:04:08 +02:00
|
|
|
|
<literal>object/LSpeople/$dn/customAction/$customAction</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</para>
|
|
|
|
|
<para>Avec validation :
|
|
|
|
|
<literal>custom_action.php?LSobject=LSpeople&dn=$dn&customAction=$customAction&valid</literal> devient
|
2020-05-13 15:04:08 +02:00
|
|
|
|
<literal>object/LSpeople/$dn/customAction/$customAction?valid</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
|
<para>
|
|
|
|
|
<literal>custom_search_action.php</literal> :
|
|
|
|
|
<literal>custom_search_action.php?LSobject=LSpeople&customAction=$customAction</literal>
|
2020-05-13 15:04:08 +02:00
|
|
|
|
devient <literal>object/LSpeople/customAction/$customAction</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</para>
|
|
|
|
|
<para>Avec validation :
|
|
|
|
|
<literal>custom_search_action.php?LSobject=LSpeople&customAction=$customAction&valid</literal>
|
2020-05-13 15:04:08 +02:00
|
|
|
|
devient <literal>object/LSpeople/customAction/$customAction?valid</literal>
|
2020-05-11 17:29:51 +02:00
|
|
|
|
</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
|
|
|
|
|
<para>Pour identifier les fichiers concernés, vous pouvez utiliser la commande suivante :
|
|
|
|
|
<programlisting>grep -Er '(index|global_search|view|select|create|modify|import|remove|index_ajax|custom_action|custom_search_action|addon_view)\.php' /etc/ldapsaisie/local/</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
</chapter>
|