ILIAS  Release_4_0_x_branch Revision 61816
 All Data Structures Namespaces Files Functions Variables Groups Pages
class.ilObjLanguage.php
Go to the documentation of this file.
1 <?php
2 /* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */
3 
4 require_once "./classes/class.ilObject.php";
5 
14 class ilObjLanguage extends ilObject
15 {
23  var $separator;
24  var $comment_separator;
25  var $lang_default;
26  var $lang_user;
27  var $lang_path;
28 
29  var $key;
30  var $status;
31 
32 
40  function ilObjLanguage($a_id = 0, $a_call_by_reference = false)
41  {
42  global $lng;
43 
44  $this->type = "lng";
45  $this->ilObject($a_id,$a_call_by_reference);
46 
47  $this->type = "lng";
48  $this->key = $this->title;
49  $this->status = $this->desc;
50  $this->lang_default = $lng->lang_default;
51  $this->lang_user = $lng->lang_user;
52  $this->lang_path = $lng->lang_path;
53  $this->cust_lang_path = $lng->cust_lang_path;
54  $this->separator = $lng->separator;
55  $this->comment_separator = $lng->comment_separator;
56  }
57 
63  function getKey()
64  {
65  return $this->key;
66  }
67 
73  function getStatus()
74  {
75  return $this->status;
76  }
77 
81  function isSystemLanguage()
82  {
83  if ($this->key == $this->lang_default)
84  return true;
85  else
86  return false;
87  }
88 
92  function isUserLanguage()
93  {
94  if ($this->key == $this->lang_user)
95  {
96  return true;
97  }
98  else
99  {
100  return false;
101  }
102  }
103 
104 
110  function isInstalled()
111  {
112  if (substr($this->getStatus(), 0, 9) == "installed")
113  {
114  return true;
115  }
116  else
117  {
118  return false;
119  }
120  }
121 
128  function isLocal()
129  {
130  if (substr($this->getStatus(), 10) == "local")
131  {
132  return true;
133  }
134  else
135  {
136  return false;
137  }
138  }
139 
146  function install($scope = '')
147  {
148  if (!empty($scope))
149  {
150  if ($scope == 'global')
151  {
152  $scope = '';
153  }
154  else
155  {
156  $scopeExtension = '.' . $scope;
157  }
158  }
159 
160  if (($this->isInstalled() == false) ||
161  ($this->isInstalled() == true && $this->isLocal() == false && !empty($scope)))
162  {
163  if ($this->check($scope))
164  {
165  // lang-file is ok. Flush data in db and...
166  if (empty($scope))
167  {
168  $this->flush('keep_local');
169  }
170 
171  // ...re-insert data from lang-file
172  $this->insert($scope);
173 
174  // update information in db-table about available/installed languages
175  if (empty($scope))
176  {
177  $newDesc = 'installed';
178  }
179  else if ($scope == 'local')
180  {
181  $newDesc = 'installed_local';
182  }
183  $this->setDescription($newDesc);
184  $this->update();
185  $this->optimizeData();
186  return $this->getKey();
187  }
188  }
189  return "";
190  }
191 
192 
198  function uninstall()
199  {
200  if ((substr($this->status, 0, 9) == "installed") && ($this->key != $this->lang_default) && ($this->key != $this->lang_user))
201  {
202  $this->flush('all');
203  $this->setTitle($this->key);
204  $this->setDescription("not_installed");
205  $this->update();
206  $this->resetUserLanguage($this->key);
207 
208  return $this->key;
209  }
210  return "";
211  }
212 
216  static function refreshAll()
217  {
218  global $ilPluginAdmin;
219 
220  $languages = ilObject::_getObjectsByType("lng");
221 
222  foreach ($languages as $lang)
223  {
224  $langObj = new ilObjLanguage($lang["obj_id"],false);
225 
226  if ($langObj->isInstalled() == true)
227  {
228  if ($langObj->check())
229  {
230  $langObj->flush('keep_local');
231  $langObj->insert();
232  $langObj->setTitle($langObj->getKey());
233  $langObj->setDescription($langObj->getStatus());
234  $langObj->update();
235  $langObj->optimizeData();
236 
237  if ($langObj->isLocal() == true)
238  {
239  if ($langObj->check('local'))
240  {
241  $langObj->insert('local');
242  $langObj->setTitle($langObj->getKey());
243  $langObj->setDescription($langObj->getStatus());
244  $langObj->update();
245  $langObj->optimizeData();
246  }
247  }
248  }
249  }
250 
251  unset($langObj);
252  }
253 
254  // refresh languages of activated plugins
255  include_once("./Services/Component/classes/class.ilPluginSlot.php");
256  $slots = ilPluginSlot::getAllSlots();
257  foreach ($slots as $slot)
258  {
259  $act_plugins = $ilPluginAdmin->getActivePluginsForSlot($slot["component_type"],
260  $slot["component_name"], $slot["slot_id"]);
261  foreach ($act_plugins as $plugin)
262  {
263  include_once("./Services/Component/classes/class.ilPlugin.php");
264  $pl = ilPlugin::getPluginObject($slot["component_type"],
265  $slot["component_name"], $slot["slot_id"], $plugin);
266  if (is_object($pl))
267  {
268  $pl->updateLanguages();
269  }
270  }
271  }
272  }
273 
274 
280  static function _deleteLangData($a_lang_key, $a_keep_local_change)
281  {
282  global $ilDB;
283  if (!$a_keep_local_change)
284  {
285  $ilDB->manipulate("DELETE FROM lng_data WHERE lang_key = ".
286  $ilDB->quote($a_lang_key, "text"));
287  }
288  else
289  {
290  $ilDB->manipulate("DELETE FROM lng_data WHERE lang_key = ".
291  $ilDB->quote($a_lang_key, "text").
292  " AND local_change IS NULL");
293  }
294  }
295 
300  function flush($a_mode = 'all')
301  {
302  global $ilDB;
303 
304  ilObjLanguage::_deleteLangData($this->key, ($a_mode == 'keep_local'));
305 
306  if ($a_mode == 'all')
307  {
308  $ilDB->manipulate("DELETE FROM lng_modules WHERE lang_key = ".
309  $ilDB->quote($this->key, "text"));
310  }
311  }
312 
313 
320  function getLocalChanges($a_min_date = "", $a_max_date = "")
321  {
322  global $ilDB;
323 
324  if ($a_min_date == "")
325  {
326  $a_min_date = "1980-01-01 00:00:00";
327  }
328  if ($a_max_date == "")
329  {
330  $a_max_date = "2200-01-01 00:00:00";
331  }
332 
333  $q = sprintf("SELECT * FROM lng_data WHERE lang_key = %s ".
334  "AND local_change >= %s AND local_change <= %s",
335  $ilDB->quote($this->key, "text"), $ilDB->quote($a_min_date, "timestamp"),
336  $ilDB->quote($a_max_date, "timestamp"));
337  $result = $ilDB->query($q);
338 
339  $changes = array();
340  while ($row = $result->fetchRow(DB_FETCHMODE_ASSOC))
341  {
342  $changes[$row["module"]][$row["identifier"]] = $row["value"];
343  }
344  return $changes;
345  }
346 
347 
353  function _getLastLocalChange($a_key)
354  {
355  global $ilDB;
356 
357  $q = sprintf("SELECT MAX(local_change) last_change FROM lng_data ".
358  "WHERE lang_key = %s AND local_change IS NOT NULL",
359  $ilDB->quote($a_key, "text"));
360  $result = $ilDB->query($q);
361 
362  if ($row = $result->fetchRow(DB_FETCHMODE_ASSOC))
363  {
364  return $row['last_change'];
365  }
366  else
367  {
368  return "";
369  }
370  }
371 
372 
378  function insert($scope = '')
379  {
380  global $ilDB;
381 
382  if (!empty($scope))
383  {
384  if ($scope == 'global')
385  {
386  $scope = '';
387  }
388  else
389  {
390  $scopeExtension = '.' . $scope;
391  }
392  }
393 
394  $path = $this->lang_path;
395  if ($scope == "local")
396  {
397  $path = $this->cust_lang_path;
398  }
399 
400  $tmpPath = getcwd();
401  chdir($path);
402 
403  $lang_file = "ilias_" . $this->key . ".lang" . $scopeExtension;
404 
405  if ($lang_file)
406  {
407  // initialize the array for updating lng_modules below
408  $lang_array = array();
409  $lang_array["common"] = array();
410 
411  // remove header first
412  if ($content = $this->cut_header(file($lang_file)))
413  {
414  // get the local changes from the database
415  if (empty($scope))
416  {
417  $local_changes = $this->getLocalChanges();
418  }
419  else if ($scope == 'local')
420  {
421  $change_date = date("Y-m-d H:i:s",time());
422  $min_date = date("Y-m-d H:i:s", filemtime($lang_file));
423  $local_changes = $this->getLocalChanges($min_date);
424  }
425 
426  foreach ($content as $key => $val)
427  {
428  $separated = explode($this->separator,trim($val));
429 
430  //get position of the comment_separator
431  $pos = strpos($separated[2], $this->comment_separator);
432 
433  if ($pos !== false)
434  {
435  //cut comment of
436  $separated[2] = substr($separated[2] , 0 , $pos);
437  }
438 
439  // check if the value has a local change
440  $local_value = $local_changes[$separated[0]][$separated[1]];
441 
442  if (empty($scope))
443  {
444  if ($local_value != "" and $local_value != $separated[2])
445  {
446  // keep the locally changed value
447  $lang_array[$separated[0]][$separated[1]] = $local_value;
448  }
449  else
450  {
451  if ($double_checker[$separated[0]][$separated[1]][$this->key])
452  {
453  $this->ilias->raiseError("Duplicate Language Entry: ".
454  $separated[0]."-".$separated[1]."-".$this->key,
455  $this->ilias->error_obj->MESSAGE);
456  }
457 
458  $double_checker[$separated[0]][$separated[1]][$this->key] = true;
459 
460  // insert a new value if no local value exists
461  // reset local_change if the values are equal
462  ilObjLanguage::replaceLangEntry($separated[0], $separated[1],
463  $this->key, $separated[2]);
464 
465  $lang_array[$separated[0]][$separated[1]] = $separated[2];
466  }
467  }
468  else if ($scope == 'local')
469  {
470  if ($local_value != "")
471  {
472  // keep a locally changed value that is newer than the local file
473  $lang_array[$separated[0]][$separated[1]] = $local_value;
474  }
475  else
476  {
477  // UPDATE because the global values have already been INSERTed
478  ilObjLanguage::updateLangEntry($separated[0], $separated[1],
479  $this->key, $separated[2], $change_date);
480  $lang_array[$separated[0]][$separated[1]] = $separated[2];
481  }
482  }
483  }
484 
485  $ld = "";
486  if (empty($scope))
487  {
488  $ld = "installed";
489  }
490  else if ($scope == 'local')
491  {
492  $ld = "installed_local";
493  }
494  if ($ld)
495  {
496  $query = "UPDATE object_data SET " .
497  "description = ".$ilDB->quote($ld, "text").", " .
498  "last_update = ".$ilDB->now()." " .
499  "WHERE title = ".$ilDB->quote($this->key, "text")." " .
500  "AND type = 'lng'";
501  $ilDB->manipulate($query);
502  }
503  }
504 
505  foreach($lang_array as $module => $lang_arr)
506  {
507  if ($scope == "local")
508  {
509  $q = "SELECT * FROM lng_modules WHERE ".
510  " lang_key = ".$ilDB->quote($this->key, "text").
511  " AND module = ".$ilDB->quote($module, "text");
512  $set = $ilDB->query($q);
513  $row = $ilDB->fetchAssoc($set);
514  $arr2 = unserialize($row["lang_array"]);
515  if (is_array($arr2))
516  {
517  $lang_arr = array_merge($arr2, $lang_arr);
518  }
519  }
520  ilObjLanguage::replaceLangModule($this->key, $module, $lang_arr);
521  }
522  }
523 
524  chdir($tmpPath);
525  }
526 
530  static final function replaceLangModule($a_key, $a_module, $a_array)
531  {
532  global $ilDB;
533 
534  $ilDB->manipulate(sprintf("DELETE FROM lng_modules WHERE lang_key = %s AND module = %s",
535  $ilDB->quote($a_key, "text"), $ilDB->quote($a_module, "text")));
536 
537  /*$ilDB->manipulate(sprintf("INSERT INTO lng_modules (lang_key, module, lang_array) VALUES ".
538  "(%s,%s,%s)", $ilDB->quote($a_key, "text"),
539  $ilDB->quote($a_module, "text"),
540  $ilDB->quote(serialize($a_array), "clob")));*/
541  $ilDB->insert("lng_modules", array(
542  "lang_key" => array("text", $a_key),
543  "module" => array("text", $a_module),
544  "lang_array" => array("clob", serialize($a_array))
545  ));
546  }
547 
551  static final function replaceLangEntry($a_module, $a_identifier,
552  $a_lang_key, $a_value, $a_local_change = null)
553  {
554  global $ilDB;
555 
556  $ilDB->replace(
557  'lng_data',
558  array(
559  'module' => array('text',$a_module),
560  'identifier' => array('text',$a_identifier),
561  'lang_key' => array('text',$a_lang_key)
562  ),
563  array(
564  'value' => array('text',$a_value),
565  'local_change' => array('timestamp',$a_local_change)
566  )
567  );
568  return true;
569 
570  /*
571  $ilDB->manipulate(sprintf("DELETE FROM lng_data WHERE module = %s AND ".
572  "identifier = %s AND lang_key = %s",
573  $ilDB->quote($a_module, "text"), $ilDB->quote($a_identifier, "text"),
574  $ilDB->quote($a_lang_key, "text")));
575 
576 
577  $ilDB->manipulate(sprintf("INSERT INTO lng_data " .
578  "(module, identifier, lang_key, value, local_change) " .
579  "VALUES (%s,%s,%s,%s,%s)",
580  $ilDB->quote($a_module, "text"), $ilDB->quote($a_identifier, "text"),
581  $ilDB->quote($a_lang_key, "text"), $ilDB->quote($a_value, "text"),
582  $ilDB->quote($a_local_change, "timestamp")));
583  */
584  }
585 
589  static final function updateLangEntry($a_module, $a_identifier,
590  $a_lang_key, $a_value, $a_local_change = null)
591  {
592  global $ilDB;
593 
594  $ilDB->manipulate(sprintf("UPDATE lng_data " .
595  "SET value = %s, local_change = %s ".
596  "WHERE module = %s AND identifier = %s AND lang_key = %s ",
597  $ilDB->quote($a_value, "text"), $ilDB->quote($a_local_change, "timestamp"),
598  $ilDB->quote($a_module, "text"), $ilDB->quote($a_identifier, "text"),
599  $ilDB->quote($a_lang_key, "text")));
600  }
601 
608  function resetUserLanguage($lang_key)
609  {
610  global $ilDB;
611 
612  $query = "UPDATE usr_pref SET " .
613  "value = ".$ilDB->quote($this->lang_default, "text")." " .
614  "WHERE keyword = ".$ilDB->quote('language', "text")." ".
615  "AND value = ".$ilDB->quote($lang_key, "text");
616  $ilDB->manipulate($query);
617  }
618 
627  function cut_header($content)
628  {
629  foreach ($content as $key => $val)
630  {
631  if (trim($val) == "<!-- language file start -->")
632  {
633  return array_slice($content,$key +1);
634  }
635  }
636 
637  return false;
638  }
639 
645  function optimizeData()
646  {
647  global $ilDB;
648 
649  $ilDB->optimizeTable("lng_data");
650  return true;
651  }
652 
662  function check($scope = '')
663  {
664  include_once("./Services/Utilities/classes/class.ilStr.php");
665 
666  if (!empty($scope))
667  {
668  if ($scope == 'global')
669  {
670  $scope = '';
671  }
672  else
673  {
674  $scopeExtension = '.' . $scope;
675  }
676  }
677 
678  $path = $this->lang_path;
679  if ($scope == "local")
680  {
681  $path = $this->cust_lang_path;
682  }
683 
684  $tmpPath = getcwd();
685 
686  // dir check
687  if (!is_dir($path))
688  {
689  $this->ilias->raiseError("Directory not found: ".$path, $this->ilias->error_obj->MESSAGE);
690  }
691 
692  chdir($path);
693 
694  // compute lang-file name format
695  $lang_file = "ilias_" . $this->key . ".lang" . $scopeExtension;
696 
697  // file check
698  if (!is_file($lang_file))
699  {
700  $this->ilias->raiseError("File not found: ".$lang_file,$this->ilias->error_obj->MESSAGE);
701  }
702 
703  // header check
704  if (!$content = $this->cut_header(file($lang_file)))
705  {
706  $this->ilias->raiseError("Wrong Header in ".$lang_file,$this->ilias->error_obj->MESSAGE);
707  }
708 
709  // check (counting) elements of each lang-entry
710  $line = 0;
711  foreach ($content as $key => $val)
712  {
713  $separated = explode($this->separator, trim($val));
714  $num = count($separated);
715  ++$n;
716  if ($num != 3)
717  {
718  $line = $n + 36;
719  $this->ilias->raiseError("Wrong parameter count in ".$lang_file." in line $line (Value: $val)! Please check your language file!",$this->ilias->error_obj->MESSAGE);
720  }
721  if (!ilStr::isUtf8($separated[2]))
722  {
723  $this->ilias->raiseError("Non UTF8 character found in ".$lang_file." in line $line (Value: $val)! Please check your language file!",$this->ilias->error_obj->MESSAGE);
724  }
725  }
726 
727  chdir($tmpPath);
728 
729  // no error occured
730  return true;
731  }
732 
736  static function countUsers($a_lang)
737  {
738  global $ilDB, $lng;
739 
740  $set = $ilDB->query("SELECT COUNT(*) cnt FROM usr_data ud JOIN usr_pref up".
741  " ON ud.usr_id = up.usr_id ".
742  " WHERE up.value = ".$ilDB->quote($a_lang, "text").
743  " AND up.keyword = ".$ilDB->quote("language", "text"));
744  $rec = $ilDB->fetchAssoc($set);
745 
746  // add users with no usr_pref set to default language
747  if ($a_lang == $lng->lang_default)
748  {
749  $set2 = $ilDB->query("SELECT COUNT(*) cnt FROM usr_data ud LEFT JOIN usr_pref up".
750  " ON (ud.usr_id = up.usr_id AND up.keyword = ".$ilDB->quote("language", "text").")".
751  " WHERE up.value IS NULL ");
752  $rec2 = $ilDB->fetchAssoc($set2);
753  }
754 
755  return (int) $rec["cnt"] + (int) $rec2["cnt"];
756  }
757 
758 
759 } // END class.LanguageObject
760 ?>