dolibarr 18.0.6
doc_generic_asset_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
30dol_include_once('/asset/core/modules/asset/modules_asset.php');
31require_once DOL_DOCUMENT_ROOT.'/product/class/product.class.php';
32require_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
33require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
34require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
35require_once DOL_DOCUMENT_ROOT.'/core/lib/doc.lib.php';
36
37
42{
47 public $emetteur;
48
52 public $version = 'dolibarr';
53
59 public function __construct($db)
60 {
61 global $conf, $langs, $mysoc;
62
63 // Load translation files required by the page
64 $langs->loadLangs(array("main", "companies"));
65
66 $this->db = $db;
67 $this->name = "ODT templates";
68 $this->description = $langs->trans("DocumentModelOdt");
69 $this->scandir = 'ASSET_ASSET_ADDON_PDF_ODT_PATH'; // Name of constant that is used to save list of directories to scan
70
71 // Page size for A4 format
72 $this->type = 'odt';
73 $this->page_largeur = 0;
74 $this->page_hauteur = 0;
75 $this->format = array($this->page_largeur, $this->page_hauteur);
76 $this->marge_gauche = 0;
77 $this->marge_droite = 0;
78 $this->marge_haute = 0;
79 $this->marge_basse = 0;
80
81 $this->option_logo = 1; // Display logo
82 $this->option_tva = 0; // Manage the vat option FACTURE_TVAOPTION
83 $this->option_modereg = 0; // Display payment mode
84 $this->option_condreg = 0; // Display payment terms
85 $this->option_multilang = 1; // Available in several languages
86 $this->option_escompte = 0; // Displays if there has been a discount
87 $this->option_credit_note = 0; // Support credit notes
88 $this->option_freetext = 1; // Support add of a personalised text
89 $this->option_draft_watermark = 0; // Support add of a watermark on drafts
90
91 // Get source company
92 $this->emetteur = $mysoc;
93 if (!$this->emetteur->country_code) {
94 $this->emetteur->country_code = substr($langs->defaultlang, -2); // By default if not defined
95 }
96 }
97
98
105 public function info($langs)
106 {
107 global $conf, $langs;
108
109 // Load translation files required by the page
110 $langs->loadLangs(array("errors", "companies"));
111
112 $form = new Form($this->db);
113
114 $texte = $this->description.".<br>\n";
115 $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST">';
116 $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
117 $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
118 $texte .= '<input type="hidden" name="param1" value="ASSET_ASSET_ADDON_PDF_ODT_PATH">';
119 $texte .= '<table class="nobordernopadding" width="100%">';
120
121 // List of directories area
122 $texte .= '<tr><td>';
123 $texttitle = $langs->trans("ListOfDirectories");
124 $listofdir = explode(',', preg_replace('/[\r\n]+/', ',', trim($conf->global->ASSET_ASSET_ADDON_PDF_ODT_PATH)));
125 $listoffiles = array();
126 foreach ($listofdir as $key => $tmpdir) {
127 $tmpdir = trim($tmpdir);
128 $tmpdir = preg_replace('/DOL_DATA_ROOT/', DOL_DATA_ROOT, $tmpdir);
129 if (!$tmpdir) {
130 unset($listofdir[$key]);
131 continue;
132 }
133 if (!is_dir($tmpdir)) {
134 $texttitle .= img_warning($langs->trans("ErrorDirNotFound", $tmpdir), 0);
135 } else {
136 $tmpfiles = dol_dir_list($tmpdir, 'files', 0, '\.(ods|odt)');
137 if (count($tmpfiles)) {
138 $listoffiles = array_merge($listoffiles, $tmpfiles);
139 }
140 }
141 }
142 $texthelp = $langs->trans("ListOfDirectoriesForModelGenODT");
143 // Add list of substitution keys
144 $texthelp .= '<br>'.$langs->trans("FollowingSubstitutionKeysCanBeUsed").'<br>';
145 $texthelp .= $langs->transnoentitiesnoconv("FullListOnOnlineDocumentation"); // This contains an url, we don't modify it
146
147 $texte .= $form->textwithpicto($texttitle, $texthelp, 1, 'help', '', 1);
148 $texte .= '<div><div style="display: inline-block; min-width: 100px; vertical-align: middle;">';
149 $texte .= '<textarea class="flat" cols="60" name="value1">';
150 $texte .= $conf->global->ASSET_ASSET_ADDON_PDF_ODT_PATH;
151 $texte .= '</textarea>';
152 $texte .= '</div><div style="display: inline-block; vertical-align: middle;">';
153 $texte .= '<input type="submit" class="button small" name="Button"value="'.$langs->trans("Modify").'">';
154 $texte .= '<br></div></div>';
155
156 // Scan directories
157 $nbofiles = count($listoffiles);
158 if (!empty($conf->global->ASSET_ASSET_ADDON_PDF_ODT_PATH)) {
159 $texte .= $langs->trans("NumberOfModelFilesFound").': <b>';
160 //$texte.=$nbofiles?'<a id="a_'.get_class($this).'" href="#">':'';
161 $texte .= count($listoffiles);
162 //$texte.=$nbofiles?'</a>':'';
163 $texte .= '</b>';
164 }
165
166 if ($nbofiles) {
167 $texte .= '<div id="div_'.get_class($this).'" class="hidden">';
168 foreach ($listoffiles as $file) {
169 $texte .= '- '.$file['name'].' <a href="'.DOL_URL_ROOT.'/document.php?modulepart=doctemplates&file=asset_asset/'.urlencode(basename($file['name'])).'">'.img_picto('', 'listlight').'</a>';
170 $texte .= ' &nbsp; <a class="reposition" href="'.$_SERVER["PHP_SELF"].'?modulepart=doctemplates&keyforuploaddir=ASSET_ASSET_ADDON_PDF_ODT_PATH&action=deletefile&token='.newToken().'&file='.urlencode(basename($file['name'])).'">'.img_picto('', 'delete').'</a>';
171 $texte .= '<br>';
172 }
173 $texte .= '</div>';
174 }
175
176 $texte .= '</td>';
177
178 $texte .= '<td rowspan="2" class="tdtop hideonsmartphone">';
179 $texte .= $langs->trans("ExampleOfDirectoriesForModelGen");
180 $texte .= '</td>';
181 $texte .= '</tr>';
182
183 $texte .= '</table>';
184 $texte .= '</form>';
185
186 return $texte;
187 }
188
189 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
201 public function write_file($object, $outputlangs, $srctemplatepath, $hidedetails = 0, $hidedesc = 0, $hideref = 0)
202 {
203 // phpcs:enable
204 global $user, $langs, $conf, $mysoc, $hookmanager;
205
206 if (empty($srctemplatepath)) {
207 dol_syslog("doc_generic_odt::write_file parameter srctemplatepath empty", LOG_WARNING);
208 return -1;
209 }
210
211 // Add odtgeneration hook
212 if (!is_object($hookmanager)) {
213 include_once DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php';
214 $hookmanager = new HookManager($this->db);
215 }
216 $hookmanager->initHooks(array('odtgeneration'));
217 global $action;
218
219 if (!is_object($outputlangs)) {
220 $outputlangs = $langs;
221 }
222 $sav_charset_output = $outputlangs->charset_output;
223 $outputlangs->charset_output = 'UTF-8';
224
225 $outputlangs->loadLangs(array("main", "dict", "companies", "bills"));
226
227 if ($conf->asset->dir_output) {
228 // If $object is id instead of object
229 if (!is_object($object)) {
230 $id = $object;
231 $object = new Asset($this->db);
232 $result = $object->fetch($id);
233 if ($result < 0) {
234 dol_print_error($this->db, $object->error);
235 return -1;
236 }
237 }
238
239 $object->fetch_thirdparty();
240
241 $dir = $conf->asset->multidir_output[isset($object->entity) ? $object->entity : 1];
242 $objectref = dol_sanitizeFileName($object->ref);
243 if (!preg_match('/specimen/i', $objectref)) {
244 $dir .= "/".$objectref;
245 }
246 $file = $dir."/".$objectref.".odt";
247
248 if (!file_exists($dir)) {
249 if (dol_mkdir($dir) < 0) {
250 $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
251 return -1;
252 }
253 }
254
255 if (file_exists($dir)) {
256 //print "srctemplatepath=".$srctemplatepath; // Src filename
257 $newfile = basename($srctemplatepath);
258 $newfiletmp = preg_replace('/\.od[ts]/i', '', $newfile);
259 $newfiletmp = preg_replace('/template_/i', '', $newfiletmp);
260 $newfiletmp = preg_replace('/modele_/i', '', $newfiletmp);
261 $newfiletmp = $objectref.'_'.$newfiletmp;
262 //$file=$dir.'/'.$newfiletmp.'.'.dol_print_date(dol_now(),'%Y%m%d%H%M%S').'.odt';
263 // Get extension (ods or odt)
264 $newfileformat = substr($newfile, strrpos($newfile, '.') + 1);
265 if (getDolGlobalString('MAIN_DOC_USE_TIMING')) {
266 $format = getDolGlobalString('MAIN_DOC_USE_TIMING');
267 if ($format == '1') {
268 $format = '%Y%m%d%H%M%S';
269 }
270 $filename = $newfiletmp.'-'.dol_print_date(dol_now(), $format).'.'.$newfileformat;
271 } else {
272 $filename = $newfiletmp.'.'.$newfileformat;
273 }
274 $file = $dir.'/'.$filename;
275 //print "newdir=".$dir;
276 //print "newfile=".$newfile;
277 //print "file=".$file;
278 //print "conf->societe->dir_temp=".$conf->societe->dir_temp;
279
280 dol_mkdir($conf->asset->dir_temp);
281 if (!is_writable($conf->asset->dir_temp)) {
282 $this->error = $langs->transnoentities("ErrorFailedToWriteInTempDirectory", $conf->asset->dir_temp);
283 dol_syslog('Error in write_file: ' . $this->error, LOG_ERR);
284 return -1;
285 }
286
287 // If CUSTOMER contact defined on order, we use it
288 $usecontact = false;
289 $arrayidcontact = $object->getIdContact('external', 'CUSTOMER');
290 if (count($arrayidcontact) > 0) {
291 $usecontact = true;
292 $result = $object->fetch_contact($arrayidcontact[0]);
293 }
294
295 // Recipient name
296 $contactobject = null;
297 if (!empty($usecontact)) {
298 // We can use the company of contact instead of thirdparty company
299 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))) {
300 $object->contact->fetch_thirdparty();
301 $socobject = $object->contact->thirdparty;
302 $contactobject = $object->contact;
303 } else {
304 $socobject = $object->thirdparty;
305 // if we have a CUSTOMER contact and we dont use it as thirdparty recipient we store the contact object for later use
306 $contactobject = $object->contact;
307 }
308 } else {
309 $socobject = $object->thirdparty;
310 }
311
312 // Make substitution
313 $substitutionarray = array(
314 '__FROM_NAME__' => $this->emetteur->name,
315 '__FROM_EMAIL__' => $this->emetteur->email,
316 '__TOTAL_TTC__' => $object->total_ttc,
317 '__TOTAL_HT__' => $object->total_ht,
318 '__TOTAL_VAT__' => $object->total_tva
319 );
320 complete_substitutions_array($substitutionarray, $langs, $object);
321 // Call the ODTSubstitution hook
322 $parameters = array('file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$substitutionarray);
323 $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
324
325 // Line of free text
326 $newfreetext = '';
327 $paramfreetext = 'ORDER_FREE_TEXT';
328 if (!empty($conf->global->$paramfreetext)) {
329 $newfreetext = make_substitutions($conf->global->$paramfreetext, $substitutionarray);
330 }
331
332 // Open and load template
333 require_once ODTPHP_PATH.'odf.php';
334 try {
335 $odfHandler = new Odf(
336 $srctemplatepath,
337 array(
338 'PATH_TO_TMP' => $conf->asset->dir_temp,
339 'ZIP_PROXY' => 'PclZipProxy', // PhpZipProxy or PclZipProxy. Got "bad compression method" error when using PhpZipProxy.
340 'DELIMITER_LEFT' => '{',
341 'DELIMITER_RIGHT' => '}'
342 )
343 );
344 } catch (Exception $e) {
345 $this->error = $e->getMessage();
346 dol_syslog($e->getMessage(), LOG_INFO);
347 return -1;
348 }
349 // After construction $odfHandler->contentXml contains content and
350 // [!-- BEGIN row.lines --]*[!-- END row.lines --] has been replaced by
351 // [!-- BEGIN lines --]*[!-- END lines --]
352 //print html_entity_decode($odfHandler->__toString());
353 //print exit;
354
355
356 // Make substitutions into odt of freetext
357 try {
358 $odfHandler->setVars('free_text', $newfreetext, true, 'UTF-8');
359 } catch (OdfException $e) {
360 dol_syslog($e->getMessage(), LOG_INFO);
361 }
362
363 // Define substitution array
364 $substitutionarray = getCommonSubstitutionArray($outputlangs, 0, null, $object);
365 $array_object_from_properties = $this->get_substitutionarray_each_var_object($object, $outputlangs);
366 $array_objet = $this->get_substitutionarray_object($object, $outputlangs);
367 $array_user = $this->get_substitutionarray_user($user, $outputlangs);
368 $array_soc = $this->get_substitutionarray_mysoc($mysoc, $outputlangs);
369 $array_thirdparty = $this->get_substitutionarray_thirdparty($socobject, $outputlangs);
370 $array_other = $this->get_substitutionarray_other($outputlangs);
371 // retrieve contact information for use in object as contact_xxx tags
372 $array_thirdparty_contact = array();
373 if ($usecontact && is_object($contactobject)) {
374 $array_thirdparty_contact = $this->get_substitutionarray_contact($contactobject, $outputlangs, 'contact');
375 }
376
377 $tmparray = array_merge($substitutionarray, $array_object_from_properties, $array_user, $array_soc, $array_thirdparty, $array_objet, $array_other, $array_thirdparty_contact);
378 complete_substitutions_array($tmparray, $outputlangs, $object);
379
380 // Call the ODTSubstitution hook
381 $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
382 $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
383
384 foreach ($tmparray as $key => $value) {
385 try {
386 if (preg_match('/logo$/', $key)) {
387 // Image
388 if (file_exists($value)) {
389 $odfHandler->setImage($key, $value);
390 } else {
391 $odfHandler->setVars($key, 'ErrorFileNotFound', true, 'UTF-8');
392 }
393 } else {
394 // Text
395 $odfHandler->setVars($key, $value, true, 'UTF-8');
396 }
397 } catch (OdfException $e) {
398 dol_syslog($e->getMessage(), LOG_INFO);
399 }
400 }
401 // Replace tags of lines
402 try {
403 $foundtagforlines = 1;
404 try {
405 $listlines = $odfHandler->setSegment('lines');
406 } catch (OdfException $e) {
407 // We may arrive here if tags for lines not present into template
408 $foundtagforlines = 0;
409 dol_syslog($e->getMessage(), LOG_INFO);
410 }
411 if ($foundtagforlines) {
412 $linenumber = 0;
413 foreach ($object->lines as $line) {
414 $linenumber++;
415 $tmparray = $this->get_substitutionarray_lines($line, $outputlangs, $linenumber);
416 complete_substitutions_array($tmparray, $outputlangs, $object, $line, "completesubstitutionarray_lines");
417 // Call the ODTSubstitutionLine hook
418 $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray, 'line'=>$line);
419 $reshook = $hookmanager->executeHooks('ODTSubstitutionLine', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
420 foreach ($tmparray as $key => $val) {
421 try {
422 $listlines->setVars($key, $val, true, 'UTF-8');
423 } catch (OdfException $e) {
424 dol_syslog($e->getMessage(), LOG_INFO);
425 } catch (SegmentException $e) {
426 dol_syslog($e->getMessage(), LOG_INFO);
427 }
428 }
429 $listlines->merge();
430 }
431 $odfHandler->mergeSegment($listlines);
432 }
433 } catch (OdfException $e) {
434 $this->error = $e->getMessage();
435 dol_syslog($this->error, LOG_WARNING);
436 return -1;
437 }
438
439 // Replace labels translated
440 $tmparray = $outputlangs->get_translations_for_substitutions();
441 foreach ($tmparray as $key => $value) {
442 try {
443 $odfHandler->setVars($key, $value, true, 'UTF-8');
444 } catch (OdfException $e) {
445 dol_syslog($e->getMessage(), LOG_INFO);
446 }
447 }
448
449 // Call the beforeODTSave hook
450
451 $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
452 $reshook = $hookmanager->executeHooks('beforeODTSave', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
453
454 // Write new file
455 if (!empty($conf->global->MAIN_ODT_AS_PDF)) {
456 try {
457 $odfHandler->exportAsAttachedPDF($file);
458 } catch (Exception $e) {
459 $this->error = $e->getMessage();
460 dol_syslog($e->getMessage(), LOG_INFO);
461 return -1;
462 }
463 } else {
464 try {
465 $odfHandler->saveToDisk($file);
466 } catch (Exception $e) {
467 $this->error = $e->getMessage();
468 dol_syslog($e->getMessage(), LOG_INFO);
469 return -1;
470 }
471 }
472
473 $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
474 $reshook = $hookmanager->executeHooks('afterODTCreation', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
475
476 dolChmod($file);
477
478 $odfHandler = null; // Destroy object
479
480 $this->result = array('fullpath'=>$file);
481
482 return 1; // Success
483 } else {
484 $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
485 return -1;
486 }
487 }
488
489 return -1;
490 }
491}
Class for Asset.
get_substitutionarray_each_var_object(&$object, $outputlangs, $recursive=1)
Define array with couple substitution key => substitution value.
get_substitutionarray_object($object, $outputlangs, $array_key='object')
Define array with couple substitution key => substitution value Note that vars into substitutions arr...
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_lines($line, $outputlangs, $linenumber=0)
Define array with couple substitution key => substitution value Note that vars into substitutions arr...
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 for documents models.
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.
print $script_file $mode $langs defaultlang(is_numeric($duration_value) ? " delay=". $duration_value :"").(is_numeric($duration_value2) ? " after 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.
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
if(!function_exists( 'dol_getprefix')) dol_include_once($relpath, $classname='')
Make an include_once using default root and alternate root if it fails.
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.
getCommonSubstitutionArray($outputlangs, $onlykey=0, $exclude=null, $object=null, $include=null)
Return array of possible common substitutions.
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