dolibarr  17.0.4
doc_generic_mo_odt.modules.php
Go to the documentation of this file.
1 <?php
2 /* Copyright (C) 2010-2012 Laurent Destailleur <eldy@users.sourceforge.net>
3  * Copyright (C) 2012 Juanjo Menent <jmenent@2byte.es>
4  * Copyright (C) 2014 Marcos García <marcosgdf@gmail.com>
5  * Copyright (C) 2016 Charlie Benke <charlie@patas-monkey.com>
6  * Copyright (C) 2018-2021 Philippe Grand <philippe.grand@atoo-net.com>
7  * Copyright (C) 2018 Frédéric France <frederic.france@netlogic.fr>
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  * or see https://www.gnu.org/
22  */
23 
30 require_once DOL_DOCUMENT_ROOT.'/core/modules/mrp/modules_mo.php';
31 require_once DOL_DOCUMENT_ROOT.'/product/class/product.class.php';
32 require_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
33 require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
34 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
35 require_once DOL_DOCUMENT_ROOT.'/core/lib/doc.lib.php';
36 
37 
42 {
47  public $emetteur;
48 
53  public $phpmin = array(7, 0);
54 
58  public $version = 'dolibarr';
59 
60 
66  public function __construct($db)
67  {
68  global $conf, $langs, $mysoc;
69 
70  // Load translation files required by the page
71  $langs->loadLangs(array("main", "companies"));
72 
73  $this->db = $db;
74  $this->name = "ODT templates";
75  $this->description = $langs->trans("DocumentModelOdt");
76  $this->scandir = 'MRP_MO_ADDON_PDF_ODT_PATH'; // Name of constant that is used to save list of directories to scan
77 
78  // Page size for A4 format
79  $this->type = 'odt';
80  $this->page_largeur = 0;
81  $this->page_hauteur = 0;
82  $this->format = array($this->page_largeur, $this->page_hauteur);
83  $this->marge_gauche = 0;
84  $this->marge_droite = 0;
85  $this->marge_haute = 0;
86  $this->marge_basse = 0;
87 
88  $this->option_logo = 1; // Display logo
89  $this->option_tva = 0; // Manage the vat option
90  $this->option_modereg = 0; // Display payment mode
91  $this->option_condreg = 0; // Display payment terms
92  $this->option_multilang = 1; // Available in several languages
93  $this->option_escompte = 0; // Displays if there has been a discount
94  $this->option_credit_note = 0; // Support credit notes
95  $this->option_freetext = 1; // Support add of a personalised text
96  $this->option_draft_watermark = 0; // Support add of a watermark on drafts
97 
98  // Get source company
99  $this->emetteur = $mysoc;
100  if (!$this->emetteur->country_code) {
101  $this->emetteur->country_code = substr($langs->defaultlang, -2); // By default if not defined
102  }
103  }
104 
105 
112  public function info($langs)
113  {
114  global $conf, $langs;
115 
116  // Load translation files required by the page
117  $langs->loadLangs(array("errors", "companies"));
118 
119  $form = new Form($this->db);
120 
121  $texte = $this->description.".<br>\n";
122  $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST">';
123  $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
124  $texte .= '<input type="hidden" name="page_y" value="">';
125  $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
126  $texte .= '<input type="hidden" name="param1" value="MRP_MO_ADDON_PDF_ODT_PATH">';
127  $texte .= '<table class="nobordernopadding" width="100%">';
128 
129  // List of directories area
130  $texte .= '<tr><td>';
131  $texttitle = $langs->trans("ListOfDirectories");
132  $listofdir = explode(',', preg_replace('/[\r\n]+/', ',', trim($conf->global->MRP_MO_ADDON_PDF_ODT_PATH)));
133  $listoffiles = array();
134  foreach ($listofdir as $key => $tmpdir) {
135  $tmpdir = trim($tmpdir);
136  $tmpdir = preg_replace('/DOL_DATA_ROOT/', DOL_DATA_ROOT, $tmpdir);
137  if (!$tmpdir) {
138  unset($listofdir[$key]);
139  continue;
140  }
141  if (!is_dir($tmpdir)) {
142  $texttitle .= img_warning($langs->trans("ErrorDirNotFound", $tmpdir), 0);
143  } else {
144  $tmpfiles = dol_dir_list($tmpdir, 'files', 0, '\.(ods|odt)');
145  if (count($tmpfiles)) {
146  $listoffiles = array_merge($listoffiles, $tmpfiles);
147  }
148  }
149  }
150  $texthelp = $langs->trans("ListOfDirectoriesForModelGenODT");
151  // Add list of substitution keys
152  $texthelp .= '<br>'.$langs->trans("FollowingSubstitutionKeysCanBeUsed").'<br>';
153  $texthelp .= $langs->transnoentitiesnoconv("FullListOnOnlineDocumentation"); // This contains an url, we don't modify it
154 
155  $texte .= $form->textwithpicto($texttitle, $texthelp, 1, 'help', '', 1);
156  $texte .= '<div><div style="display: inline-block; min-width: 100px; vertical-align: middle;">';
157  $texte .= '<textarea class="flat" cols="60" name="value1">';
158  $texte .= $conf->global->MRP_MO_ADDON_PDF_ODT_PATH;
159  $texte .= '</textarea>';
160  $texte .= '</div><div style="display: inline-block; vertical-align: middle;">';
161  $texte .= '<input type="submit" class="button small reposition" name="modify" value="'.$langs->trans("Modify").'">';
162  $texte .= '<br></div></div>';
163 
164  // Scan directories
165  $nbofiles = count($listoffiles);
166  if (!empty($conf->global->MRP_MO_ADDON_PDF_ODT_PATH)) {
167  $texte .= $langs->trans("NumberOfModelFilesFound").': <b>';
168  //$texte.=$nbofiles?'<a id="a_'.get_class($this).'" href="#">':'';
169  $texte .= count($listoffiles);
170  //$texte.=$nbofiles?'</a>':'';
171  $texte .= '</b>';
172  }
173 
174  if ($nbofiles) {
175  $texte .= '<div id="div_'.get_class($this).'" class="hiddenx">';
176  // Show list of found files
177  foreach ($listoffiles as $file) {
178  $texte .= '- '.$file['name'].' <a href="'.DOL_URL_ROOT.'/document.php?modulepart=doctemplates&file=mrps/'.urlencode(basename($file['name'])).'">'.img_picto('', 'listlight').'</a>';
179  $texte .= ' &nbsp; <a class="reposition" href="'.$_SERVER["PHP_SELF"].'?modulepart=doctemplates&keyforuploaddir=MRP_MO_ADDON_PDF_ODT_PATH&action=deletefile&token='.newToken().'&file='.urlencode(basename($file['name'])).'">'.img_picto('', 'delete').'</a>';
180  $texte .= '<br>';
181  }
182  $texte .= '</div>';
183  }
184 
185  $texte .= '</td>';
186 
187  $texte .= '<td rowspan="2" class="tdtop hideonsmartphone">';
188  $texte .= '<span class="opacitymedium">';
189  $texte .= $langs->trans("ExampleOfDirectoriesForModelGen");
190  $texte .= '</span>';
191  $texte .= '</td>';
192  $texte .= '</tr>';
193 
194  $texte .= '</table>';
195  $texte .= '</form>';
196 
197  return $texte;
198  }
199 
200  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
212  public function write_file($object, $outputlangs, $srctemplatepath, $hidedetails = 0, $hidedesc = 0, $hideref = 0)
213  {
214  // phpcs:enable
215  global $user, $langs, $conf, $mysoc, $hookmanager;
216 
217  if (empty($srctemplatepath)) {
218  dol_syslog("doc_generic_odt::write_file parameter srctemplatepath empty", LOG_WARNING);
219  return -1;
220  }
221 
222  // Add odtgeneration hook
223  if (!is_object($hookmanager)) {
224  include_once DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php';
225  $hookmanager = new HookManager($this->db);
226  }
227  $hookmanager->initHooks(array('odtgeneration'));
228  global $action;
229 
230  if (!is_object($outputlangs)) {
231  $outputlangs = $langs;
232  }
233  $sav_charset_output = $outputlangs->charset_output;
234  $outputlangs->charset_output = 'UTF-8';
235 
236  $outputlangs->loadLangs(array("main", "dict", "companies", "bills"));
237 
238  if ($conf->mrp->dir_output) {
239  // If $object is id instead of object
240  if (!is_object($object)) {
241  $id = $object;
242  $object = new MO($this->db);
243  $result = $object->fetch($id);
244  if ($result < 0) {
245  dol_print_error($this->db, $object->error);
246  return -1;
247  }
248  }
249 
250  $object->fetch_thirdparty();
251 
252  $dir = $conf->mrp->multidir_output[isset($object->entity) ? $object->entity : 1];
253  $objectref = dol_sanitizeFileName($object->ref);
254  if (!preg_match('/specimen/i', $objectref)) {
255  $dir .= "/".$objectref;
256  }
257  $file = $dir."/".$objectref.".odt";
258 
259  if (!file_exists($dir)) {
260  if (dol_mkdir($dir) < 0) {
261  $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
262  return -1;
263  }
264  }
265 
266  if (file_exists($dir)) {
267  //print "srctemplatepath=".$srctemplatepath; // Src filename
268  $newfile = basename($srctemplatepath);
269  $newfiletmp = preg_replace('/\.od(t|s)/i', '', $newfile);
270  $newfiletmp = preg_replace('/template_/i', '', $newfiletmp);
271  $newfiletmp = preg_replace('/modele_/i', '', $newfiletmp);
272  $newfiletmp = $objectref . '_' . $newfiletmp;
273  //$file=$dir.'/'.$newfiletmp.'.'.dol_print_date(dol_now(),'%Y%m%d%H%M%S').'.odt';
274  // Get extension (ods or odt)
275  $newfileformat = substr($newfile, strrpos($newfile, '.') + 1);
276  if (!empty($conf->global->MAIN_DOC_USE_TIMING)) {
277  $format = $conf->global->MAIN_DOC_USE_TIMING;
278  if ($format == '1') {
279  $format = '%Y%m%d%H%M%S';
280  }
281  $filename = $newfiletmp . '-' . dol_print_date(dol_now(), $format) . '.' . $newfileformat;
282  } else {
283  $filename = $newfiletmp . '.' . $newfileformat;
284  }
285  $file = $dir . '/' . $filename;
286  //print "newdir=".$dir;
287  //print "newfile=".$newfile;
288  //print "file=".$file;
289  //print "conf->societe->dir_temp=".$conf->societe->dir_temp;
290 
291  dol_mkdir($conf->mrp->dir_temp);
292  if (!is_writable($conf->mrp->dir_temp)) {
293  $this->error = $langs->transnoentities("ErrorFailedToWriteInTempDirectory", $conf->mrp->dir_temp);
294  dol_syslog('Error in write_file: ' . $this->error, LOG_ERR);
295  return -1;
296  }
297 
298  // If CUSTOMER contact defined on order, we use it
299  $usecontact = false;
300  $arrayidcontact = $object->getIdContact('external', 'CUSTOMER');
301  if (count($arrayidcontact) > 0) {
302  $usecontact = true;
303  $result = $object->fetch_contact($arrayidcontact[0]);
304  }
305 
306  // Recipient name
307  $contactobject = null;
308  if (!empty($usecontact)) {
309  // We can use the company of contact instead of thirdparty company
310  if ($object->contact->socid != $object->thirdparty->id && (!isset($conf->global->MAIN_USE_COMPANY_NAME_OF_CONTACT) || !empty($conf->global->MAIN_USE_COMPANY_NAME_OF_CONTACT))) {
311  $object->contact->fetch_thirdparty();
312  $socobject = $object->contact->thirdparty;
313  $contactobject = $object->contact;
314  } else {
315  $socobject = $object->thirdparty;
316  // if we have a CUSTOMER contact and we dont use it as thirdparty recipient we store the contact object for later use
317  $contactobject = $object->contact;
318  }
319  } else {
320  $socobject = $object->thirdparty;
321  }
322 
323  // Make substitution
324  $substitutionarray = array(
325  '__QTY_TO_PRODUCE__' => $object->qty,
326  );
327  complete_substitutions_array($substitutionarray, $langs, $object);
328  // Call the ODTSubstitution hook
329  $parameters = array('file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$substitutionarray);
330  $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
331 
332  // Line of free text
333  $newfreetext = '';
334  $paramfreetext = 'MRP_MO_FREE_TEXT';
335  if (!empty($conf->global->$paramfreetext)) {
336  $newfreetext = make_substitutions($conf->global->$paramfreetext, $substitutionarray);
337  }
338 
339  // Open and load template
340  require_once ODTPHP_PATH.'odf.php';
341  try {
342  $odfHandler = new odf(
343  $srctemplatepath,
344  array(
345  'PATH_TO_TMP' => $conf->mrp->dir_temp,
346  'ZIP_PROXY' => 'PclZipProxy', // PhpZipProxy or PclZipProxy. Got "bad compression method" error when using PhpZipProxy.
347  'DELIMITER_LEFT' => '{',
348  'DELIMITER_RIGHT' => '}'
349  )
350  );
351  } catch (Exception $e) {
352  $this->error = $e->getMessage();
353  dol_syslog($e->getMessage(), LOG_INFO);
354  return -1;
355  }
356 
357  // After construction $odfHandler->contentXml contains content and
358  // [!-- BEGIN row.lines --]*[!-- END row.lines --] has been replaced by
359  // [!-- BEGIN lines --]*[!-- END lines --]
360  //print html_entity_decode($odfHandler->__toString());
361  //print exit;
362  /*
363 
364 
365  // Make substitutions into odt of freetext
366  try {
367  $odfHandler->setVars('free_text', $newfreetext, true, 'UTF-8');
368  } catch (OdfException $e) {
369  dol_syslog($e->getMessage(), LOG_INFO);
370  }
371 
372  // Define substitution array
373  $substitutionarray = getCommonSubstitutionArray($outputlangs, 0, null, $object);
374  $array_object_from_properties = $this->get_substitutionarray_each_var_object($object, $outputlangs);
375  $array_objet = $this->get_substitutionarray_object($object, $outputlangs);
376  $array_user = $this->get_substitutionarray_user($user, $outputlangs);
377  $array_soc = $this->get_substitutionarray_mysoc($mysoc, $outputlangs);
378  $array_thirdparty = $this->get_substitutionarray_thirdparty($socobject, $outputlangs);
379  $array_other = $this->get_substitutionarray_other($outputlangs);
380  // retrieve contact information for use in object as contact_xxx tags
381  $array_thirdparty_contact = array();
382  if ($usecontact && is_object($contactobject)) {
383  $array_thirdparty_contact = $this->get_substitutionarray_contact($contactobject, $outputlangs, 'contact');
384  }
385 
386  $tmparray = array_merge($substitutionarray, $array_object_from_properties, $array_user, $array_soc, $array_thirdparty, $array_objet, $array_other, $array_thirdparty_contact);
387  complete_substitutions_array($tmparray, $outputlangs, $object);
388 
389  // Call the ODTSubstitution hook
390  $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
391  $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
392 
393  foreach ($tmparray as $key => $value) {
394  try {
395  if (preg_match('/logo$/', $key)) {
396  // Image
397  if (file_exists($value)) {
398  $odfHandler->setImage($key, $value);
399  } else {
400  $odfHandler->setVars($key, 'ErrorFileNotFound', true, 'UTF-8');
401  }
402  } else {
403  // Text
404  $odfHandler->setVars($key, $value, true, 'UTF-8');
405  }
406  } catch (OdfException $e) {
407  dol_syslog($e->getMessage(), LOG_INFO);
408  }
409  }
410 
411  // Replace tags of lines
412  try {
413  $foundtagforlines = 1;
414  try {
415  $listlines = $odfHandler->setSegment('lines');
416  } catch (OdfException $e) {
417  // We may arrive here if tags for lines not present into template
418  $foundtagforlines = 0;
419  dol_syslog($e->getMessage(), LOG_INFO);
420  }
421 
422  if ($foundtagforlines) {
423  $linenumber = 0;
424  foreach ($object->lines as $line) {
425  $linenumber++;
426  $tmparray = $this->get_substitutionarray_lines($line, $outputlangs, $linenumber);
427  complete_substitutions_array($tmparray, $outputlangs, $object, $line, "completesubstitutionarray_lines");
428  // Call the ODTSubstitutionLine hook
429  $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray, 'line'=>$line);
430  $reshook = $hookmanager->executeHooks('ODTSubstitutionLine', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
431  foreach ($tmparray as $key => $val) {
432  try {
433  $listlines->setVars($key, $val, true, 'UTF-8');
434  } catch (OdfException $e) {
435  dol_syslog($e->getMessage(), LOG_INFO);
436  } catch (SegmentException $e) {
437  dol_syslog($e->getMessage(), LOG_INFO);
438  }
439  }
440  $listlines->merge();
441  }
442  $odfHandler->mergeSegment($listlines);
443  }
444  } catch (OdfException $e) {
445  $this->error = $e->getMessage();
446  dol_syslog($this->error, LOG_WARNING);
447  return -1;
448  }
449 
450  // Replace labels translated
451  $tmparray = $outputlangs->get_translations_for_substitutions();
452  foreach ($tmparray as $key => $value) {
453  try {
454  $odfHandler->setVars($key, $value, true, 'UTF-8');
455  } catch (OdfException $e) {
456  dol_syslog($e->getMessage(), LOG_INFO);
457  }
458  }
459 
460  // Call the beforeODTSave hook
461 
462  $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
463  $reshook = $hookmanager->executeHooks('beforeODTSave', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
464  */
465  // Write new file
466  if (!empty($conf->global->MAIN_ODT_AS_PDF)) {
467  try {
468  $odfHandler->exportAsAttachedPDF($file);
469  } catch (Exception $e) {
470  $this->error = $e->getMessage();
471  dol_syslog('Error in exportAsAttachedPDF: '.$e->getMessage(), LOG_INFO);
472  return -1;
473  }
474  } else {
475  try {
476  $odfHandler->saveToDisk($file);
477  } catch (Exception $e) {
478  $this->error = $e->getMessage();
479  dol_syslog('Error in saveToDisk: '.$e->getMessage(), LOG_INFO);
480  return -1;
481  }
482  }
483 
484  $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
485  $reshook = $hookmanager->executeHooks('afterODTCreation', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
486 
487  if (!empty($conf->global->MAIN_UMASK)) {
488  @chmod($file, octdec($conf->global->MAIN_UMASK));
489  }
490 
491  $odfHandler = null; // Destroy object
492 
493  $this->result = array('fullpath'=>$file);
494 
495  return 1; // Success
496  } else {
497  $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
498  return -1;
499  }
500  }
501 
502  return -1;
503  }
504 }
Class to manage generation of HTML components Only common components must be here.
Class to manage hooks.
Parent class for mos models.
Definition: modules_mo.php:40
Class to build documents using ODF templates generator.
write_file($object, $outputlangs, $srctemplatepath, $hidedetails=0, $hidedesc=0, $hideref=0)
Function to build a document on disk using the generic odt module.
info($langs)
Return description of a module.
if($cancel &&! $id) if($action=='add' &&! $cancel) if($action=='delete') if($id) $form
Actions.
Definition: card.php:143
print *****$script_file(".$version.") pid cd cd cd description as description
Only used if Module[ID]Desc translation string is not found.
dol_dir_list($path, $types="all", $recursive=0, $filter="", $excludefilter=null, $sortcriteria="name", $sortorder=SORT_ASC, $mode=0, $nohook=0, $relativename="", $donotfollowsymlinks=0, $nbsecondsold=0)
Scan a directory and return a list of files/directories.
Definition: files.lib.php:61
img_warning($titlealt='default', $moreatt='', $morecss='pictowarning')
Show warning logo.
dol_print_error($db='', $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
dol_print_date($time, $format='', $tzoutput='auto', $outputlangs='', $encodetooutput=false)
Output date in a string format according to outputlangs (or langs if not defined).
dol_now($mode='auto')
Return date for now.
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
newToken()
Return the value of token currently saved into session with name 'newtoken'.
complete_substitutions_array(&$substitutionarray, $outputlangs, $object=null, $parameters=null, $callfunc="completesubstitutionarray")
Complete the $substitutionarray with more entries coming from external module that had set the "subst...
make_substitutions($text, $substitutionarray, $outputlangs=null, $converttextinhtmlifnecessary=0)
Make substitution into a text string, replacing keys with vals from $substitutionarray (oldval=>newva...
dol_sanitizeFileName($str, $newstr='_', $unaccent=1)
Clean a string to use it as a file name.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.
dol_mkdir($dir, $dataroot='', $newmask='')
Creation of a directory (this can create recursive subdir)
if(preg_match('/crypted:/i', $dolibarr_main_db_pass)||!empty($dolibarr_main_db_encrypted_pass)) $conf db type
Definition: repair.php:119
$conf db name
Only used if Module[ID]Name translation string is not found.
Definition: repair.php:122
$conf db
API class for accounts.
Definition: inc.php:41