dolibarr  19.0.0-dev
doc_generic_user_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) 2018-2021 Frédéric France <frederic.france@netlogic.fr>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 3 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <https://www.gnu.org/licenses/>.
18 * or see https://www.gnu.org/
19 */
20 
27 require_once DOL_DOCUMENT_ROOT.'/core/modules/user/modules_user.class.php';
28 require_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
29 require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
30 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
31 require_once DOL_DOCUMENT_ROOT.'/core/lib/doc.lib.php';
32 
33 
38 {
42  public $emetteur;
43 
48  public $version = 'dolibarr';
49 
50 
56  public function __construct($db)
57  {
58  global $conf, $langs, $mysoc;
59 
60  // Load translation files required by the page
61  $langs->loadLangs(array("main", "companies"));
62 
63  $this->db = $db;
64  $this->name = "ODT templates";
65  $this->description = $langs->trans("DocumentModelOdt");
66  $this->scandir = 'USER_ADDON_PDF_ODT_PATH'; // Name of constant that is used to save list of directories to scan
67 
68  // Page size for A4 format
69  $this->type = 'odt';
70  $this->page_largeur = 0;
71  $this->page_hauteur = 0;
72  $this->format = array($this->page_largeur, $this->page_hauteur);
73  $this->marge_gauche = 0;
74  $this->marge_droite = 0;
75  $this->marge_haute = 0;
76  $this->marge_basse = 0;
77 
78  $this->option_logo = 1; // Display logo
79  $this->option_tva = 0; // Manage the vat option USER_TVAOPTION
80  $this->option_modereg = 0; // Display payment mode
81  $this->option_condreg = 0; // Display payment terms
82  $this->option_multilang = 1; // Available in several languages
83  $this->option_escompte = 0; // Displays if there has been a discount
84  $this->option_credit_note = 0; // Support credit notes
85  $this->option_freetext = 1; // Support add of a personalised text
86  $this->option_draft_watermark = 0; // Support add of a watermark on drafts
87 
88  // Get source company
89  $this->emetteur = $mysoc;
90  if (!$this->emetteur->country_code) {
91  $this->emetteur->country_code = substr($langs->defaultlang, -2); // By default if not defined
92  }
93  }
94 
95 
102  public function info($langs)
103  {
104  global $conf, $langs;
105 
106  // Load translation files required by the page
107  $langs->loadLangs(array('companies', 'errors'));
108 
109  $form = new Form($this->db);
110 
111  $odtChosen = getDolGlobalInt('MAIN_PROPAL_CHOOSE_ODT_DOCUMENT') > 0;
112  $odtPath = trim(getDolGlobalString('USER_ADDON_PDF_ODT_PATH'));
113 
114  $texte = $this->description.".<br>\n";
115  $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST" enctype="multipart/form-data">';
116  $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
117  $texte .= '<input type="hidden" name="page_y" value="">';
118  $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
119  $texte .= '<input type="hidden" name="param1" value="USER_ADDON_PDF_ODT_PATH">';
120  if ($odtChosen) {
121  $texte .= '<input type="hidden" name="param2" value="USER_ADDON_PDF_ODT_DEFAULT">';
122  $texte .= '<input type="hidden" name="param3" value="USER_ADDON_PDF_ODT_TOBILL">';
123  $texte .= '<input type="hidden" name="param4" value="USER_ADDON_PDF_ODT_CLOSED">';
124  }
125  $texte .= '<table class="nobordernopadding" width="100%">';
126 
127  // List of directories area
128  $texte .= '<tr><td>';
129  $texttitle = $langs->trans("ListOfDirectories");
130  $listofdir = explode(',', preg_replace('/[\r\n]+/', ',', $odtPath));
131  $listoffiles = array();
132  foreach ($listofdir as $key => $tmpdir) {
133  $tmpdir = trim($tmpdir);
134  $tmpdir = preg_replace('/DOL_DATA_ROOT/', DOL_DATA_ROOT, $tmpdir);
135  if (!$tmpdir) {
136  unset($listofdir[$key]);
137  continue;
138  }
139  if (!is_dir($tmpdir)) {
140  $texttitle .= img_warning($langs->trans("ErrorDirNotFound", $tmpdir), 0);
141  } else {
142  $tmpfiles = dol_dir_list($tmpdir, 'files', 0, '\.(ods|odt)');
143  if (count($tmpfiles)) {
144  $listoffiles = array_merge($listoffiles, $tmpfiles);
145  }
146  }
147  }
148  $texthelp = $langs->trans("ListOfDirectoriesForModelGenODT");
149  // Add list of substitution keys
150  $texthelp .= '<br>'.$langs->trans("FollowingSubstitutionKeysCanBeUsed").'<br>';
151  $texthelp .= $langs->transnoentitiesnoconv("FullListOnOnlineDocumentation"); // This contains an url, we don't modify it
152 
153  $texte .= $form->textwithpicto($texttitle, $texthelp, 1, 'help', '', 1);
154  $texte .= '<div><div style="display: inline-block; min-width: 100px; vertical-align: middle;">';
155  $texte .= '<textarea class="flat" cols="60" name="value1">';
156  $texte .= $odtPath;
157  $texte .= '</textarea>';
158  $texte .= '</div><div style="display: inline-block; vertical-align: middle;">';
159  $texte .= '<input type="submit" class="button small reposition" name="modify" value="'.$langs->trans("Modify").'">';
160  $texte .= '<br></div></div>';
161 
162  // Scan directories
163  if (count($listofdir)) {
164  $texte .= $langs->trans("NumberOfModelFilesFound").': <b>'.count($listoffiles).'</b>';
165 
166  if ($odtChosen) {
167  // Model for creation
168  $list = ModelePDFUser::liste_modeles($this->db);
169  $texte .= '<table width="50%;">';
170  $texte .= '<tr>';
171  $texte .= '<td width="60%;">'.$langs->trans("DefaultModelPropalCreate").'</td>';
172  $texte .= '<td colspan="">';
173  $texte .= $form->selectarray('value2', $list, getDolGlobalString('USER_ADDON_PDF_ODT_DEFAULT'));
174  $texte .= "</td></tr>";
175 
176  $texte .= '<tr>';
177  $texte .= '<td width="60%;">'.$langs->trans("DefaultModelPropalToBill").'</td>';
178  $texte .= '<td colspan="">';
179  $texte .= $form->selectarray('value3', $list, getDolGlobalString('USER_ADDON_PDF_ODT_TOBILL'));
180  $texte .= "</td></tr>";
181  $texte .= '<tr>';
182 
183  $texte .= '<td width="60%;">'.$langs->trans("DefaultModelPropalClosed").'</td>';
184  $texte .= '<td colspan="">';
185  $texte .= $form->selectarray('value4', $list, getDolGlobalString('USER_ADDON_PDF_ODT_CLOSED'));
186  $texte .= "</td></tr>";
187  $texte .= '</table>';
188  }
189  $texte .= '<div id="div_'.get_class($this).'" class="hiddenx">';
190  // Show list of found files
191  foreach ($listoffiles as $file) {
192  $texte .= '- '.$file['name'].' <a href="'.DOL_URL_ROOT.'/document.php?modulepart=doctemplates&file=users/'.urlencode(basename($file['name'])).'">'.img_picto('', 'listlight').'</a>';
193  $texte .= ' &nbsp; <a class="reposition" href="'.$_SERVER["PHP_SELF"].'?modulepart=doctemplates&keyforuploaddir=USER_ADDON_PDF_ODT_PATH&action=deletefile&token='.newToken().'&file='.urlencode(basename($file['name'])).'">'.img_picto('', 'delete').'</a>';
194  $texte .= '<br>';
195  }
196  $texte .= '</div>';
197  }
198  // Add input to upload a new template file.
199  $texte .= '<div>'.$langs->trans("UploadNewTemplate");
200  $maxfilesizearray = getMaxFileSizeArray();
201  $maxmin = $maxfilesizearray['maxmin'];
202  if ($maxmin > 0) {
203  $texte .= '<input type="hidden" name="MAX_FILE_SIZE" value="'.($maxmin * 1024).'">'; // MAX_FILE_SIZE must precede the field type=file
204  }
205  $texte .= ' <input type="file" name="uploadfile">';
206  $texte .= '<input type="hidden" value="USER_ADDON_PDF_ODT_PATH" name="keyforuploaddir">';
207  $texte .= '<input type="submit" class="button small reposition" value="'.dol_escape_htmltag($langs->trans("Upload")).'" name="upload">';
208  $texte .= '</div>';
209 
210  $texte .= '</td>';
211 
212  $texte .= '<td rowspan="2" class="tdtop hideonsmartphone">';
213  $texte .= '<span class="opacitymedium">';
214  $texte .= $langs->trans("ExampleOfDirectoriesForModelGen");
215  $texte .= '</span>';
216  $texte .= '</td>';
217  $texte .= '</tr>';
218 
219  $texte .= '</table>';
220  $texte .= '</form>';
221 
222  return $texte;
223  }
224 
225  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
237  public function write_file($object, $outputlangs, $srctemplatepath, $hidedetails = 0, $hidedesc = 0, $hideref = 0)
238  {
239  // phpcs:enable
240  global $user, $langs, $conf, $mysoc, $hookmanager;
241 
242  if (empty($srctemplatepath)) {
243  dol_syslog("doc_generic_odt::write_file parameter srctemplatepath empty", LOG_WARNING);
244  return -1;
245  }
246 
247  // Add odtgeneration hook
248  if (!is_object($hookmanager)) {
249  include_once DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php';
250  $hookmanager = new HookManager($this->db);
251  }
252  $hookmanager->initHooks(array('odtgeneration'));
253  global $action;
254 
255  if (!is_object($outputlangs)) {
256  $outputlangs = $langs;
257  }
258  $sav_charset_output = $outputlangs->charset_output;
259  $outputlangs->charset_output = 'UTF-8';
260 
261  // Load translation files required by the page
262  $outputlangs->loadLangs(array("main", "companies", "bills", "dict"));
263 
264  if ($conf->user->dir_output) {
265  // If $object is id instead of object
266  if (!is_object($object)) {
267  $id = $object;
268  $object = new User($this->db);
269  $result = $object->fetch($id);
270  if ($result < 0) {
271  dol_print_error($this->db, $object->error);
272  return -1;
273  }
274  }
275 
276  $object->fetch_thirdparty();
277 
278  $dir = $conf->user->dir_output;
279  $objectref = dol_sanitizeFileName($object->ref);
280  if (!preg_match('/specimen/i', $objectref)) {
281  $dir .= "/".$objectref;
282  }
283  $file = $dir."/".$objectref.".odt";
284 
285  if (!file_exists($dir)) {
286  if (dol_mkdir($dir) < 0) {
287  $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
288  return -1;
289  }
290  }
291 
292  if (file_exists($dir)) {
293  //print "srctemplatepath=".$srctemplatepath; // Src filename
294  $newfile = basename($srctemplatepath);
295  $newfiletmp = preg_replace('/\.od[ts]/i', '', $newfile);
296  $newfiletmp = preg_replace('/template_/i', '', $newfiletmp);
297  $newfiletmp = preg_replace('/modele_/i', '', $newfiletmp);
298 
299  $newfiletmp = $objectref . '_' . $newfiletmp;
300 
301  // Get extension (ods or odt)
302  $newfileformat = substr($newfile, strrpos($newfile, '.') + 1);
303  if (getDolGlobalInt('MAIN_DOC_USE_TIMING')) {
304  $format = getDolGlobalInt('MAIN_DOC_USE_TIMING');
305  if ($format == '1') {
306  $format = '%Y%m%d%H%M%S';
307  }
308  $filename = $newfiletmp . '-' . dol_print_date(dol_now(), $format) . '.' . $newfileformat;
309  } else {
310  $filename = $newfiletmp . '.' . $newfileformat;
311  }
312  $file = $dir . '/' . $filename;
313  //print "newdir=".$dir;
314  //print "newfile=".$newfile;
315  //print "file=".$file;
316  //print "conf->user->dir_temp=".$conf->user->dir_temp;
317 
318  dol_mkdir($conf->user->dir_temp);
319  if (!is_writable($conf->user->dir_temp)) {
320  $this->error = $langs->transnoentities("ErrorFailedToWriteInTempDirectory", $conf->user->dir_temp);
321  dol_syslog('Error in write_file: ' . $this->error, LOG_ERR);
322  return -1;
323  }
324 
325  // If CUSTOMER contact defined on user, we use it
326  $usecontact = false;
327  $arrayidcontact = $object->getIdContact('external', 'CUSTOMER');
328  if (count($arrayidcontact) > 0) {
329  $usecontact = true;
330  $result = $object->fetch_contact($arrayidcontact[0]);
331  }
332 
333  // Recipient name
334  if (!empty($usecontact)) {
335  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))) {
336  $socobject = $object->contact;
337  } else {
338  $socobject = $object->thirdparty;
339  // if we have a CUSTOMER contact and we dont use it as recipient we store the contact object for later use
340  $contactobject = $object->contact;
341  }
342  } else {
343  $socobject = $object->thirdparty;
344  }
345 
346  // Open and load template
347  require_once ODTPHP_PATH.'odf.php';
348  try {
349  $odfHandler = new Odf(
350  $srctemplatepath,
351  array(
352  'PATH_TO_TMP' => $conf->user->dir_temp,
353  'ZIP_PROXY' => 'PclZipProxy', // PhpZipProxy or PclZipProxy. Got "bad compression method" error when using PhpZipProxy.
354  'DELIMITER_LEFT' => '{',
355  'DELIMITER_RIGHT' => '}'
356  )
357  );
358  } catch (Exception $e) {
359  $this->error = $e->getMessage();
360  dol_syslog($e->getMessage(), LOG_WARNING);
361  return -1;
362  }
363 
364  // Make substitutions into odt
365  $array_user = $this->get_substitutionarray_user($object, $outputlangs);
366  $array_soc = $this->get_substitutionarray_mysoc($mysoc, $outputlangs);
367  $array_thirdparty = $this->get_substitutionarray_thirdparty($socobject, $outputlangs);
368  $array_other = $this->get_substitutionarray_other($outputlangs);
369  // retrieve contact information for use in object as contact_xxx tags
370  $array_thirdparty_contact = array();
371  if ($usecontact && is_object($contactobject)) {
372  $array_thirdparty_contact = $this->get_substitutionarray_contact($contactobject, $outputlangs, 'contact');
373  }
374 
375  $tmparray = array_merge($array_user, $array_soc, $array_thirdparty, $array_other, $array_thirdparty_contact);
376  complete_substitutions_array($tmparray, $outputlangs, $object);
377  $object->fetch_optionals();
378  // Call the ODTSubstitution hook
379  $parameters = array('file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
380  $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
381  foreach ($tmparray as $key => $value) {
382  try {
383  if (preg_match('/logo$/', $key)) { // Image
384  if (file_exists($value)) {
385  $odfHandler->setImage($key, $value);
386  } else {
387  $odfHandler->setVars($key, 'ErrorFileNotFound', true, 'UTF-8');
388  }
389  } else // Text
390  {
391  $odfHandler->setVars($key, $value, true, 'UTF-8');
392  }
393  } catch (OdfException $e) {
394  dol_syslog($e->getMessage(), LOG_WARNING);
395  }
396  }
397 
398  // Replace labels translated
399  $tmparray = $outputlangs->get_translations_for_substitutions();
400  foreach ($tmparray as $key => $value) {
401  try {
402  $odfHandler->setVars($key, $value, true, 'UTF-8');
403  } catch (OdfException $e) {
404  dol_syslog($e->getMessage(), LOG_WARNING);
405  }
406  }
407 
408  // Call the beforeODTSave hook
409  $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs);
410  $reshook = $hookmanager->executeHooks('beforeODTSave', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
411 
412  // Write new file
413  if (!empty($conf->global->MAIN_ODT_AS_PDF)) {
414  try {
415  $odfHandler->exportAsAttachedPDF($file);
416  } catch (Exception $e) {
417  $this->error = $e->getMessage();
418  dol_syslog($e->getMessage(), LOG_WARNING);
419  return -1;
420  }
421  } else {
422  try {
423  $odfHandler->saveToDisk($file);
424  } catch (Exception $e) {
425  $this->error = $e->getMessage();
426  dol_syslog($e->getMessage(), LOG_WARNING);
427  return -1;
428  }
429  }
430 
431  $reshook = $hookmanager->executeHooks('afterODTCreation', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
432 
433  dolChmod($file);
434 
435  $odfHandler = null; // Destroy object
436 
437  $this->result = array('fullpath'=>$file);
438 
439  return 1; // Success
440  } else {
441  $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
442  return -1;
443  }
444  }
445 
446  return -1;
447  }
448 
449  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
458  public function get_substitutionarray_object($object, $outputlangs, $array_key = 'object')
459  {
460  // phpcs:enable
461  $array_other = array();
462  foreach ($object as $key => $value) {
463  if (!is_array($value) && !is_object($value)) {
464  $array_other[$array_key.'_'.$key] = $value;
465  }
466  }
467  return $array_other;
468  }
469 }
get_substitutionarray_mysoc($mysoc, $outputlangs)
Define array with couple substitution key => substitution value.
get_substitutionarray_contact($object, $outputlangs, $array_key='object')
Define array with couple substitution key => substitution value.
get_substitutionarray_other($outputlangs)
Define array with couple substitution key => substitution value.
get_substitutionarray_thirdparty($object, $outputlangs, $array_key='company')
Define array with couple substitution key => substitution value For example {company_name},...
get_substitutionarray_user($user, $outputlangs)
Define array with couple substitution key => substitution value.
Class to manage generation of HTML components Only common components must be here.
Class to manage hooks.
Parent class to manage intervention document templates.
static liste_modeles($db, $maxfilenamelength=0)
Return list of active generation modules.
Class to manage Dolibarr users.
Definition: user.class.php:48
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.
get_substitutionarray_object($object, $outputlangs, $array_key='object')
get substitution array for object
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:62
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).
dolChmod($filepath, $newmask='')
Change mod of a file.
dol_now($mode='auto')
Return date for now.
getDolGlobalInt($key, $default=0)
Return dolibarr global constant int value.
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...
dol_sanitizeFileName($str, $newstr='_', $unaccent=1)
Clean a string to use it as a file name.
getDolGlobalString($key, $default='')
Return dolibarr global constant string value.
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:120
$conf db name
Only used if Module[ID]Name translation string is not found.
Definition: repair.php:123
getMaxFileSizeArray()
Return the max allowed for file upload.