dolibarr  x.y.z
ldap_contacts.php
Go to the documentation of this file.
1 <?php
2 /* Copyright (C) 2004 Rodolphe Quiedeville <rodolphe@quiedeville.org>
3  * Copyright (C) 2004 Sebastien Di Cintio <sdicintio@ressource-toi.org>
4  * Copyright (C) 2004 Benoit Mortier <benoit.mortier@opensides.be>
5  * Copyright (C) 2005 Regis Houssin <regis.houssin@inodbox.com>
6  * Copyright (C) 2006-2011 Laurent Destailleur <eldy@users.sourceforge.net>
7  * Copyright (C) 2011-2013 Juanjo Menent <jmenent@2byte.es>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 3 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program. If not, see <https://www.gnu.org/licenses/>.
21  */
22 
29 // Load Dolibarr environment
30 require '../main.inc.php';
31 require_once DOL_DOCUMENT_ROOT.'/core/lib/admin.lib.php';
32 require_once DOL_DOCUMENT_ROOT.'/core/class/ldap.class.php';
33 require_once DOL_DOCUMENT_ROOT.'/core/lib/ldap.lib.php';
34 require_once DOL_DOCUMENT_ROOT.'/contact/class/contact.class.php';
35 
36 // Load translation files required by the page
37 $langs->loadLangs(array("admin", "errors"));
38 
39 if (!$user->admin) {
40  accessforbidden();
41 }
42 
43 $action = GETPOST('action', 'aZ09');
44 
45 /*
46  * Actions
47  */
48 
49 if ($action == 'setvalue' && $user->admin) {
50  $error = 0;
51 
52  $db->begin();
53 
54  if (!dolibarr_set_const($db, 'LDAP_CONTACT_DN', GETPOST("contactdn"), 'chaine', 0, '', $conf->entity)) {
55  $error++;
56  }
57  if (!dolibarr_set_const($db, 'LDAP_CONTACT_OBJECT_CLASS', GETPOST("objectclass"), 'chaine', 0, '', $conf->entity)) {
58  $error++;
59  }
60 
61  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_FULLNAME', GETPOST("fieldfullname"), 'chaine', 0, '', $conf->entity)) {
62  $error++;
63  }
64  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_NAME', GETPOST("fieldname"), 'chaine', 0, '', $conf->entity)) {
65  $error++;
66  }
67  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_FIRSTNAME', GETPOST("fieldfirstname"), 'chaine', 0, '', $conf->entity)) {
68  $error++;
69  }
70  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_COMPANY', GETPOST("fieldcompany"), 'chaine', 0, '', $conf->entity)) {
71  $error++;
72  }
73  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_MAIL', GETPOST("fieldmail"), 'chaine', 0, '', $conf->entity)) {
74  $error++;
75  }
76  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_PHONE', GETPOST("fieldphone"), 'chaine', 0, '', $conf->entity)) {
77  $error++;
78  }
79  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_HOMEPHONE', GETPOST("fieldhomephone"), 'chaine', 0, '', $conf->entity)) {
80  $error++;
81  }
82  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_MOBILE', GETPOST("fieldmobile"), 'chaine', 0, '', $conf->entity)) {
83  $error++;
84  }
85  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_SKYPE', GETPOST("fieldskype"), 'chaine', 0, '', $conf->entity)) {
86  $error++;
87  }
88  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_FAX', GETPOST("fieldfax"), 'chaine', 0, '', $conf->entity)) {
89  $error++;
90  }
91  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_ADDRESS', GETPOST("fieldaddress"), 'chaine', 0, '', $conf->entity)) {
92  $error++;
93  }
94  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_ZIP', GETPOST("fieldzip"), 'chaine', 0, '', $conf->entity)) {
95  $error++;
96  }
97  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_TOWN', GETPOST("fieldtown"), 'chaine', 0, '', $conf->entity)) {
98  $error++;
99  }
100  if (!dolibarr_set_const($db, 'LDAP_CONTACT_FIELD_COUNTRY', GETPOST("fieldcountry"), 'chaine', 0, '', $conf->entity)) {
101  $error++;
102  }
103 
104  // This one must be after the others
105  $valkey = '';
106  $key = GETPOST("key");
107  if ($key) {
108  $valkey = $conf->global->$key;
109  }
110  if (!dolibarr_set_const($db, 'LDAP_KEY_CONTACTS', $valkey, 'chaine', 0, '', $conf->entity)) {
111  $error++;
112  }
113 
114  if (!$error) {
115  $db->commit();
116  setEventMessages($langs->trans("SetupSaved"), null, 'mesgs');
117  } else {
118  $db->rollback();
119  dol_print_error($db);
120  }
121 }
122 
123 
124 
125 /*
126  * View
127  */
128 
129 $form = new Form($db);
130 
131 llxHeader('', $langs->trans("LDAPSetup"), 'EN:Module_LDAP_En|FR:Module_LDAP|ES:M&oacute;dulo_LDAP');
132 $linkback = '<a href="'.DOL_URL_ROOT.'/admin/modules.php?restore_lastsearch_values=1">'.$langs->trans("BackToModuleList").'</a>';
133 
134 print load_fiche_titre($langs->trans("LDAPSetup"), $linkback, 'title_setup');
135 
136 $head = ldap_prepare_head();
137 
138 // Test si fonction LDAP actives
139 if (!function_exists("ldap_connect")) {
140  setEventMessages($langs->trans("LDAPFunctionsNotAvailableOnPHP"), null, 'errors');
141 }
142 
143 print dol_get_fiche_head($head, 'contacts', '', -1);
144 
145 
146 print '<span class="opacitymedium">'.$langs->trans("LDAPDescContact").'</span><br>';
147 print '<br>';
148 
149 print '<form method="post" action="'.$_SERVER["PHP_SELF"].'?action=setvalue&token='.newToken().'">';
150 print '<input type="hidden" name="token" value="'.newToken().'">';
151 
152 print '<table class="noborder centpercent">';
153 
154 print '<tr class="liste_titre">';
155 print '<td colspan="4">'.$langs->trans("LDAPSynchronizeContacts").'</td>';
156 print "</tr>\n";
157 
158 // DN Pour les contacts
159 print '<!-- LDAP_CONTACT_DN -->';
160 print '<tr class="oddeven"><td><span class="fieldrequired">'.$langs->trans("LDAPContactDn").'</span></td><td>';
161 print '<input size="48" type="text" name="contactdn" value="'.$conf->global->LDAP_CONTACT_DN.'">';
162 print '</td><td>'.$langs->trans("LDAPContactDnExample").'</td>';
163 print '<td>&nbsp;</td>';
164 print '</tr>';
165 
166 // List of object class used to define attributes in structure
167 print '<!-- LDAP_CONTACT_OBJECT_CLASS -->';
168 print '<tr class="oddeven"><td><span class="fieldrequired">'.$langs->trans("LDAPContactObjectClassList").'</span></td><td>';
169 print '<input size="48" type="text" name="objectclass" value="'.$conf->global->LDAP_CONTACT_OBJECT_CLASS.'">';
170 print '</td><td>'.$langs->trans("LDAPContactObjectClassListExample").'</td>';
171 print '<td>&nbsp;</td>';
172 print '</tr>';
173 
174 print '</table>';
175 print '<br>';
176 print '<table class="noborder centpercent">';
177 
178 print '<tr class="liste_titre">';
179 print '<td>'.$langs->trans("LDAPDolibarrMapping").'</td>';
180 print '<td colspan="2">'.$langs->trans("LDAPLdapMapping").'</td>';
181 print '<td class="right">'.$langs->trans("LDAPNamingAttribute").'</td>';
182 print "</tr>\n";
183 
184 // Common name
185 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldFullname").'</td><td>';
186 print '<input size="25" type="text" name="fieldfullname" value="'.$conf->global->LDAP_CONTACT_FIELD_FULLNAME.'">';
187 print '</td><td>'.$langs->trans("LDAPFieldFullnameExample").'</td>';
188 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_FULLNAME"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_FULLNAME ? ' checked' : '')."></td>";
189 print '</tr>';
190 
191 // Name
192 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldName").'</td><td>';
193 print '<input size="25" type="text" name="fieldname" value="'.$conf->global->LDAP_CONTACT_FIELD_NAME.'">';
194 print '</td><td>'.$langs->trans("LDAPFieldNameExample").'</td>';
195 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_NAME"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_NAME ? ' checked' : '')."></td>";
196 print '</tr>';
197 
198 // Firstname
199 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldFirstName").'</td><td>';
200 print '<input size="25" type="text" name="fieldfirstname" value="'.$conf->global->LDAP_CONTACT_FIELD_FIRSTNAME.'">';
201 print '</td><td>'.$langs->trans("LDAPFieldFirstNameExample").'</td>';
202 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_FIRSTNAME"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_FIRSTNAME ? ' checked' : '')."></td>";
203 print '</tr>';
204 
205 // Company
206 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldCompany").'</td><td>';
207 print '<input size="25" type="text" name="fieldcompany" value="'.$conf->global->LDAP_CONTACT_FIELD_COMPANY.'">';
208 print '</td><td>'.$langs->trans("LDAPFieldCompanyExample").'</td>';
209 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_COMPANY"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_COMPANY ? ' checked' : '')."></td>";
210 print '</tr>';
211 
212 // Mail
213 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldMail").'</td><td>';
214 print '<input size="25" type="text" name="fieldmail" value="'.$conf->global->LDAP_CONTACT_FIELD_MAIL.'">';
215 print '</td><td>'.$langs->trans("LDAPFieldMailExample").'</td>';
216 print '<td class="right"><input type="radio" name="key" value=">LDAP_CONTACT_FIELD_MAIL"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_MAIL ? ' checked' : '')."></td>";
217 print '</tr>';
218 
219 // Phone pro
220 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldPhone").'</td><td>';
221 print '<input size="25" type="text" name="fieldphone" value="'.$conf->global->LDAP_CONTACT_FIELD_PHONE.'">';
222 print '</td><td>'.$langs->trans("LDAPFieldPhoneExample").'</td>';
223 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_PHONE"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_PHONE ? ' checked' : '')."></td>";
224 print '</tr>';
225 
226 // Phone home
227 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldHomePhone").'</td><td>';
228 print '<input size="25" type="text" name="fieldhomephone" value="'.$conf->global->LDAP_CONTACT_FIELD_HOMEPHONE.'">';
229 print '</td><td>'.$langs->trans("LDAPFieldHomePhoneExample").'</td>';
230 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_HOMEPHONE"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_HOMEPHONE ? ' checked' : '')."></td>";
231 print '</tr>';
232 
233 // Mobile
234 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldMobile").'</td><td>';
235 print '<input size="25" type="text" name="fieldmobile" value="'.$conf->global->LDAP_CONTACT_FIELD_MOBILE.'">';
236 print '</td><td>'.$langs->trans("LDAPFieldMobileExample").'</td>';
237 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_MOBILE"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_MOBILE ? ' checked' : '')."></td>";
238 print '</tr>';
239 
240 // Skype
241 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldSkype").'</td><td>';
242 print '<input size="25" type="text" name="fieldskype" value="'.$conf->global->LDAP_CONTACT_FIELD_SKYPE.'">';
243 print '</td><td>'.$langs->trans("LDAPFieldSkypeExample").'</td>';
244 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_SKYPE"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_SKYPE ? ' checked' : '')."></td>";
245 print '</tr>';
246 
247 // Fax
248 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldFax").'</td><td>';
249 print '<input size="25" type="text" name="fieldfax" value="'.$conf->global->LDAP_CONTACT_FIELD_FAX.'">';
250 print '</td><td>'.$langs->trans("LDAPFieldFaxExample").'</td>';
251 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_FAX"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_FAX ? ' checked' : '')."></td>";
252 print '</tr>';
253 
254 // Address
255 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldAddress").'</td><td>';
256 print '<input size="25" type="text" name="fieldaddress" value="'.$conf->global->LDAP_CONTACT_FIELD_ADDRESS.'">';
257 print '</td><td>'.$langs->trans("LDAPFieldAddressExample").'</td>';
258 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_ADDRESS"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_ADDRESS ? ' checked' : '')."></td>";
259 print '</tr>';
260 
261 // ZIP
262 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldZip").'</td><td>';
263 print '<input size="25" type="text" name="fieldzip" value="'.$conf->global->LDAP_CONTACT_FIELD_ZIP.'">';
264 print '</td><td>'.$langs->trans("LDAPFieldZipExample").'</td>';
265 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_ZIP"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_ZIP ? ' checked' : '')."></td>";
266 print '</tr>';
267 
268 // TOWN
269 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldTown").'</td><td>';
270 print '<input size="25" type="text" name="fieldtown" value="'.$conf->global->LDAP_CONTACT_FIELD_TOWN.'">';
271 print '</td><td>'.$langs->trans("LDAPFieldTownExample").'</td>';
272 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_TOWN"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_TOWN ? ' checked' : '')."></td>";
273 print '</tr>';
274 
275 // COUNTRY
276 print '<tr class="oddeven"><td>'.$langs->trans("LDAPFieldCountry").'</td><td>';
277 print '<input size="25" type="text" name="fieldcountry" value="'.$conf->global->LDAP_CONTACT_FIELD_COUNTRY.'">';
278 print '</td><td>&nbsp;</td>';
279 print '<td class="right"><input type="radio" name="key" value="LDAP_CONTACT_FIELD_COUNTRY"'.($conf->global->LDAP_KEY_CONTACTS && $conf->global->LDAP_KEY_CONTACTS == $conf->global->LDAP_CONTACT_FIELD_COUNTRY ? ' checked' : '')."></td>";
280 print '</tr>';
281 
282 print '</table>';
283 
284 print info_admin($langs->trans("LDAPDescValues"));
285 
286 print dol_get_fiche_end();
287 
288 print $form->buttonsSaveCancel("Modify", '');
289 
290 print '</form>';
291 
292 
293 /*
294  * Test de la connexion
295  */
296 $butlabel = $langs->trans("LDAPTestSynchroContact");
297 $testlabel = 'test';
298 $key = $conf->global->LDAP_KEY_CONTACTS;
299 $dn = $conf->global->LDAP_CONTACT_DN;
300 $objectclass = $conf->global->LDAP_CONTACT_OBJECT_CLASS;
301 
302 show_ldap_test_button($butlabel, $testlabel, $key, $dn, $objectclass);
303 
304 
305 if (function_exists("ldap_connect")) {
306  if ($_GET["action"] == 'test') {
307  // Creation objet
308  $object = new Contact($db);
309  $object->initAsSpecimen();
310 
311  // Test synchro
312  $ldap = new Ldap();
313  $result = $ldap->connect_bind();
314 
315  if ($result > 0) {
316  $info = $object->_load_ldap_info();
317  $dn = $object->_load_ldap_dn($info);
318 
319  $result1 = $ldap->delete($dn); // To be sure to delete existing records
320  $result2 = $ldap->add($dn, $info, $user); // Now the test
321  $result3 = $ldap->delete($dn); // Clean what we did
322 
323  if ($result2 > 0) {
324  print img_picto('', 'info').' ';
325  print '<span class="ok">'.$langs->trans("LDAPSynchroOK").'</span><br>';
326  } else {
327  print img_picto('', 'error').' ';
328  print '<span class="error">'.$langs->trans("LDAPSynchroKOMayBePermissions");
329  print ': '.$ldap->error;
330  print '</span><br>';
331  print $langs->trans("ErrorLDAPMakeManualTest", $conf->ldap->dir_temp).'<br>';
332  }
333 
334  print "<br>\n";
335  print "LDAP input file used for test:<br><br>\n";
336  print nl2br($ldap->dump_content($dn, $info));
337  print "\n<br>";
338  } else {
339  print img_picto('', 'error').' ';
340  print '<span class="error">'.$langs->trans("LDAPSynchroKO");
341  print ': '.$ldap->error;
342  print '</span><br>';
343  print $langs->trans("ErrorLDAPMakeManualTest", $conf->ldap->dir_temp).'<br>';
344  }
345  }
346 }
347 
348 // End of page
349 llxFooter();
350 $db->close();
dolibarr_set_const
dolibarr_set_const($db, $name, $value, $type='chaine', $visible=0, $note='', $entity=1)
Insert a parameter (key,value) into database (delete old key then insert it again).
Definition: admin.lib.php:632
llxHeader
if(!defined('NOREQUIRESOC')) if(!defined('NOREQUIRETRAN')) if(!defined('NOTOKENRENEWAL')) if(!defined('NOREQUIREMENU')) if(!defined('NOREQUIREHTML')) if(!defined('NOREQUIREAJAX')) llxHeader()
Empty header.
Definition: wrapper.php:56
llxFooter
llxFooter()
Empty footer.
Definition: wrapper.php:70
Contact
Class to manage contact/addresses.
Definition: contact.class.php:41
Form
Class to manage generation of HTML components Only common components must be here.
Definition: html.form.class.php:53
Ldap
Class to manage LDAP features.
Definition: ldap.class.php:35
$form
if($cancel &&! $id) if($action=='add' &&! $cancel) if($action=='delete') if($id) $form
Actions.
Definition: card.php:143
load_fiche_titre
load_fiche_titre($titre, $morehtmlright='', $picto='generic', $pictoisfullpath=0, $id='', $morecssontable='', $morehtmlcenter='')
Load a title with picto.
Definition: functions.lib.php:5323
dol_get_fiche_head
dol_get_fiche_head($links=array(), $active='', $title='', $notab=0, $picto='', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limittoshow=0, $moretabssuffix='')
Show tabs of a record.
Definition: functions.lib.php:1841
dol_print_error
dol_print_error($db='', $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
Definition: functions.lib.php:4956
dol_get_fiche_end
dol_get_fiche_end($notab=0)
Return tab footer of a card.
Definition: functions.lib.php:2037
setEventMessages
setEventMessages($mesg, $mesgs, $style='mesgs', $messagekey='')
Set event messages in dol_events session object.
Definition: functions.lib.php:8418
img_picto
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
Definition: functions.lib.php:3989
newToken
newToken()
Return the value of token currently saved into session with name 'newtoken'.
Definition: functions.lib.php:11192
GETPOST
GETPOST($paramname, $check='alphanohtml', $method=0, $filter=null, $options=null, $noreplace=0)
Return value of a param into GET or POST supervariable.
Definition: functions.lib.php:517
info_admin
info_admin($text, $infoonimgalt=0, $nodiv=0, $admin='1', $morecss='hideonsmartphone', $textfordropdown='')
Show information for admin users or standard users.
Definition: functions.lib.php:4912
ldap_prepare_head
ldap_prepare_head()
Initialize the array of tabs for customer invoice.
Definition: ldap.lib.php:31
show_ldap_test_button
show_ldap_test_button($butlabel, $testlabel, $key, $dn, $objectclass)
Show button test LDAP synchro.
Definition: ldap.lib.php:102
accessforbidden
accessforbidden($message='', $printheader=1, $printfooter=1, $showonlymessage=0, $params=null)
Show a message to say access is forbidden and stop program.
Definition: security.lib.php:1084
Generated on Wed Jan 4 2023 18:05:12 for dolibarr by Doxygen 1.9.1