dolibarr 19.0.3
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
27require_once DOL_DOCUMENT_ROOT.'/core/modules/user/modules_user.class.php';
28require_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
29require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
30require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
31require_once DOL_DOCUMENT_ROOT.'/core/lib/doc.lib.php';
32
33
38{
43 public $version = 'dolibarr';
44
45
51 public function __construct($db)
52 {
53 global $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 = 'USER_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 USER_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('companies', 'errors'));
103
104 $form = new Form($this->db);
105
106 $odtChosen = getDolGlobalInt('MAIN_PROPAL_CHOOSE_ODT_DOCUMENT') > 0;
107 $odtPath = trim(getDolGlobalString('USER_ADDON_PDF_ODT_PATH'));
108
109 $texte = $this->description.".<br>\n";
110 $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST" enctype="multipart/form-data">';
111 $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
112 $texte .= '<input type="hidden" name="page_y" value="">';
113 $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
114 $texte .= '<input type="hidden" name="param1" value="USER_ADDON_PDF_ODT_PATH">';
115 if ($odtChosen) {
116 $texte .= '<input type="hidden" name="param2" value="USER_ADDON_PDF_ODT_DEFAULT">';
117 $texte .= '<input type="hidden" name="param3" value="USER_ADDON_PDF_ODT_TOBILL">';
118 $texte .= '<input type="hidden" name="param4" value="USER_ADDON_PDF_ODT_CLOSED">';
119 }
120 $texte .= '<table class="nobordernopadding" width="100%">';
121
122 // List of directories area
123 $texte .= '<tr><td>';
124 $texttitle = $langs->trans("ListOfDirectories");
125 $listofdir = explode(',', preg_replace('/[\r\n]+/', ',', $odtPath));
126 $listoffiles = array();
127 foreach ($listofdir as $key => $tmpdir) {
128 $tmpdir = trim($tmpdir);
129 $tmpdir = preg_replace('/DOL_DATA_ROOT/', DOL_DATA_ROOT, $tmpdir);
130 if (!$tmpdir) {
131 unset($listofdir[$key]);
132 continue;
133 }
134 if (!is_dir($tmpdir)) {
135 $texttitle .= img_warning($langs->trans("ErrorDirNotFound", $tmpdir), 0);
136 } else {
137 $tmpfiles = dol_dir_list($tmpdir, 'files', 0, '\.(ods|odt)');
138 if (count($tmpfiles)) {
139 $listoffiles = array_merge($listoffiles, $tmpfiles);
140 }
141 }
142 }
143 $texthelp = $langs->trans("ListOfDirectoriesForModelGenODT");
144 $texthelp .= '<br><br><span class="opacitymedium">'.$langs->trans("ExampleOfDirectoriesForModelGen").'</span>';
145 // Add list of substitution keys
146 $texthelp .= '<br>'.$langs->trans("FollowingSubstitutionKeysCanBeUsed").'<br>';
147 $texthelp .= $langs->transnoentitiesnoconv("FullListOnOnlineDocumentation"); // This contains an url, we don't modify it
148
149 $texte .= $form->textwithpicto($texttitle, $texthelp, 1, 'help', '', 1, 3, $this->name);
150 $texte .= '<div><div style="display: inline-block; min-width: 100px; vertical-align: middle;">';
151 $texte .= '<textarea class="flat" cols="60" name="value1">';
152 $texte .= $odtPath;
153 $texte .= '</textarea>';
154 $texte .= '</div><div style="display: inline-block; vertical-align: middle;">';
155 $texte .= '<input type="submit" class="button button-edit reposition smallpaddingimp" name="modify" value="'.dol_escape_htmltag($langs->trans("Modify")).'">';
156 $texte .= '<br></div></div>';
157
158 // Scan directories
159 if (count($listofdir)) {
160 $texte .= $langs->trans("NumberOfModelFilesFound").': <b>'.count($listoffiles).'</b>';
161
162 if ($odtChosen) {
163 // Model for creation
164 $list = ModelePDFUser::liste_modeles($this->db);
165 $texte .= '<table width="50%;">';
166 $texte .= '<tr>';
167 $texte .= '<td width="60%;">'.$langs->trans("DefaultModelPropalCreate").'</td>';
168 $texte .= '<td colspan="">';
169 $texte .= $form->selectarray('value2', $list, getDolGlobalString('USER_ADDON_PDF_ODT_DEFAULT'));
170 $texte .= "</td></tr>";
171
172 $texte .= '<tr>';
173 $texte .= '<td width="60%;">'.$langs->trans("DefaultModelPropalToBill").'</td>';
174 $texte .= '<td colspan="">';
175 $texte .= $form->selectarray('value3', $list, getDolGlobalString('USER_ADDON_PDF_ODT_TOBILL'));
176 $texte .= "</td></tr>";
177 $texte .= '<tr>';
178
179 $texte .= '<td width="60%;">'.$langs->trans("DefaultModelPropalClosed").'</td>';
180 $texte .= '<td colspan="">';
181 $texte .= $form->selectarray('value4', $list, getDolGlobalString('USER_ADDON_PDF_ODT_CLOSED'));
182 $texte .= "</td></tr>";
183 $texte .= '</table>';
184 }
185 $texte .= '<div id="div_'.get_class($this).'" class="hiddenx">';
186 // Show list of found files
187 foreach ($listoffiles as $file) {
188 $texte .= '- '.$file['name'].' <a href="'.DOL_URL_ROOT.'/document.php?modulepart=doctemplates&file=users/'.urlencode(basename($file['name'])).'">'.img_picto('', 'listlight').'</a>';
189 $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>';
190 $texte .= '<br>';
191 }
192 $texte .= '</div>';
193 }
194 // Add input to upload a new template file.
195 $texte .= '<div>'.$langs->trans("UploadNewTemplate");
196 $maxfilesizearray = getMaxFileSizeArray();
197 $maxmin = $maxfilesizearray['maxmin'];
198 if ($maxmin > 0) {
199 $texte .= '<input type="hidden" name="MAX_FILE_SIZE" value="'.($maxmin * 1024).'">'; // MAX_FILE_SIZE must precede the field type=file
200 }
201 $texte .= ' <input type="file" name="uploadfile">';
202 $texte .= '<input type="hidden" value="USER_ADDON_PDF_ODT_PATH" name="keyforuploaddir">';
203 $texte .= '<input type="submit" class="button smallpaddingimp reposition" value="'.dol_escape_htmltag($langs->trans("Upload")).'" name="upload">';
204 $texte .= '</div>';
205
206 $texte .= '</td>';
207
208 $texte .= '</tr>';
209
210 $texte .= '</table>';
211 $texte .= '</form>';
212
213 return $texte;
214 }
215
216 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
228 public function write_file($object, $outputlangs, $srctemplatepath, $hidedetails = 0, $hidedesc = 0, $hideref = 0)
229 {
230 // phpcs:enable
231 global $user, $langs, $conf, $mysoc, $hookmanager;
232
233 if (empty($srctemplatepath)) {
234 dol_syslog("doc_generic_odt::write_file parameter srctemplatepath empty", LOG_WARNING);
235 return -1;
236 }
237
238 // Add odtgeneration hook
239 if (!is_object($hookmanager)) {
240 include_once DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php';
241 $hookmanager = new HookManager($this->db);
242 }
243 $hookmanager->initHooks(array('odtgeneration'));
244 global $action;
245
246 if (!is_object($outputlangs)) {
247 $outputlangs = $langs;
248 }
249 $sav_charset_output = $outputlangs->charset_output;
250 $outputlangs->charset_output = 'UTF-8';
251
252 // Load translation files required by the page
253 $outputlangs->loadLangs(array("main", "companies", "bills", "dict"));
254
255 if ($conf->user->dir_output) {
256 // If $object is id instead of object
257 if (!is_object($object)) {
258 $id = $object;
259 $object = new User($this->db);
260 $result = $object->fetch($id);
261 if ($result < 0) {
262 dol_print_error($this->db, $object->error);
263 return -1;
264 }
265 }
266
267 $object->fetch_thirdparty();
268
269 $dir = $conf->user->dir_output;
270 $objectref = dol_sanitizeFileName($object->ref);
271 if (!preg_match('/specimen/i', $objectref)) {
272 $dir .= "/".$objectref;
273 }
274 $file = $dir."/".$objectref.".odt";
275
276 if (!file_exists($dir)) {
277 if (dol_mkdir($dir) < 0) {
278 $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
279 return -1;
280 }
281 }
282
283 if (file_exists($dir)) {
284 //print "srctemplatepath=".$srctemplatepath; // Src filename
285 $newfile = basename($srctemplatepath);
286 $newfiletmp = preg_replace('/\.od[ts]/i', '', $newfile);
287 $newfiletmp = preg_replace('/template_/i', '', $newfiletmp);
288 $newfiletmp = preg_replace('/modele_/i', '', $newfiletmp);
289
290 $newfiletmp = $objectref . '_' . $newfiletmp;
291
292 // Get extension (ods or odt)
293 $newfileformat = substr($newfile, strrpos($newfile, '.') + 1);
294 if (getDolGlobalString('MAIN_DOC_USE_TIMING')) {
295 $format = getDolGlobalString('MAIN_DOC_USE_TIMING');
296 if ($format == '1') {
297 $format = '%Y%m%d%H%M%S';
298 }
299 $filename = $newfiletmp . '-' . dol_print_date(dol_now(), $format) . '.' . $newfileformat;
300 } else {
301 $filename = $newfiletmp . '.' . $newfileformat;
302 }
303 $file = $dir . '/' . $filename;
304 //print "newdir=".$dir;
305 //print "newfile=".$newfile;
306 //print "file=".$file;
307 //print "conf->user->dir_temp=".$conf->user->dir_temp;
308
309 dol_mkdir($conf->user->dir_temp);
310 if (!is_writable($conf->user->dir_temp)) {
311 $this->error = $langs->transnoentities("ErrorFailedToWriteInTempDirectory", $conf->user->dir_temp);
312 dol_syslog('Error in write_file: ' . $this->error, LOG_ERR);
313 return -1;
314 }
315
316 // If CUSTOMER contact defined on user, we use it
317 $usecontact = false;
318 $arrayidcontact = $object->getIdContact('external', 'CUSTOMER');
319 if (count($arrayidcontact) > 0) {
320 $usecontact = true;
321 $result = $object->fetch_contact($arrayidcontact[0]);
322 }
323
324 // Recipient name
325 if (!empty($usecontact)) {
326 if ($object->contact->socid != $object->thirdparty->id && (!isset($conf->global->MAIN_USE_COMPANY_NAME_OF_CONTACT) || getDolGlobalString('MAIN_USE_COMPANY_NAME_OF_CONTACT'))) {
327 $socobject = $object->contact;
328 } else {
329 $socobject = $object->thirdparty;
330 // if we have a CUSTOMER contact and we dont use it as recipient we store the contact object for later use
331 $contactobject = $object->contact;
332 }
333 } else {
334 $socobject = $object->thirdparty;
335 }
336
337 // Open and load template
338 require_once ODTPHP_PATH.'odf.php';
339 try {
340 $odfHandler = new Odf(
341 $srctemplatepath,
342 array(
343 'PATH_TO_TMP' => $conf->user->dir_temp,
344 'ZIP_PROXY' => 'PclZipProxy', // PhpZipProxy or PclZipProxy. Got "bad compression method" error when using PhpZipProxy.
345 'DELIMITER_LEFT' => '{',
346 'DELIMITER_RIGHT' => '}'
347 )
348 );
349 } catch (Exception $e) {
350 $this->error = $e->getMessage();
351 dol_syslog($e->getMessage(), LOG_WARNING);
352 return -1;
353 }
354
355 // Make substitutions into odt
356 $array_user = $this->get_substitutionarray_user($object, $outputlangs);
357 $array_soc = $this->get_substitutionarray_mysoc($mysoc, $outputlangs);
358 $array_thirdparty = $this->get_substitutionarray_thirdparty($socobject, $outputlangs);
359 $array_other = $this->get_substitutionarray_other($outputlangs);
360 // retrieve contact information for use in object as contact_xxx tags
361 $array_thirdparty_contact = array();
362 if ($usecontact && is_object($contactobject)) {
363 $array_thirdparty_contact = $this->get_substitutionarray_contact($contactobject, $outputlangs, 'contact');
364 }
365
366 $tmparray = array_merge($array_user, $array_soc, $array_thirdparty, $array_other, $array_thirdparty_contact);
367 complete_substitutions_array($tmparray, $outputlangs, $object);
368 $object->fetch_optionals();
369 // Call the ODTSubstitution hook
370 $parameters = array('file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs, 'substitutionarray'=>&$tmparray);
371 $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
372 foreach ($tmparray as $key => $value) {
373 try {
374 if (preg_match('/logo$/', $key)) { // Image
375 if (file_exists($value)) {
376 $odfHandler->setImage($key, $value);
377 } else {
378 $odfHandler->setVars($key, 'ErrorFileNotFound', true, 'UTF-8');
379 }
380 } else { // Text
381 $odfHandler->setVars($key, $value, true, 'UTF-8');
382 }
383 } catch (OdfException $e) {
384 dol_syslog($e->getMessage(), LOG_WARNING);
385 }
386 }
387
388 // Replace labels translated
389 $tmparray = $outputlangs->get_translations_for_substitutions();
390 foreach ($tmparray as $key => $value) {
391 try {
392 $odfHandler->setVars($key, $value, true, 'UTF-8');
393 } catch (OdfException $e) {
394 dol_syslog($e->getMessage(), LOG_WARNING);
395 }
396 }
397
398 // Call the beforeODTSave hook
399 $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs);
400 $reshook = $hookmanager->executeHooks('beforeODTSave', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
401
402 // Write new file
403 if (getDolGlobalString('MAIN_ODT_AS_PDF')) {
404 try {
405 $odfHandler->exportAsAttachedPDF($file);
406 } catch (Exception $e) {
407 $this->error = $e->getMessage();
408 dol_syslog($e->getMessage(), LOG_WARNING);
409 return -1;
410 }
411 } else {
412 try {
413 $odfHandler->saveToDisk($file);
414 } catch (Exception $e) {
415 $this->error = $e->getMessage();
416 dol_syslog($e->getMessage(), LOG_WARNING);
417 return -1;
418 }
419 }
420
421 $reshook = $hookmanager->executeHooks('afterODTCreation', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
422
423 dolChmod($file);
424
425 $odfHandler = null; // Destroy object
426
427 $this->result = array('fullpath'=>$file);
428
429 return 1; // Success
430 } else {
431 $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
432 return -1;
433 }
434 }
435
436 return -1;
437 }
438
439 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
448 public function get_substitutionarray_object($object, $outputlangs, $array_key = 'object')
449 {
450 // phpcs:enable
451 $array_other = array();
452 foreach ($object as $key => $value) {
453 if (!is_array($value) && !is_object($value)) {
454 $array_other[$array_key.'_'.$key] = $value;
455 }
456 }
457 return $array_other;
458 }
459}
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.
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.
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.
getDolGlobalInt($key, $default=0)
Return a 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)
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:121
$conf db name
Only used if Module[ID]Name translation string is not found.
Definition repair.php:124
getMaxFileSizeArray()
Return the max allowed for file upload.