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