dolibarr 21.0.0-beta
doc_generic_member_odt.class.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-2024 Frédéric France <frederic.france@free.fr>
5 * Copyright (C) 2024 MDW <mdeweerd@users.noreply.github.com>
6*
7* This program is free software; you can redistribute it and/or modify
8* it under the terms of the GNU General Public License as published by
9* the Free Software Foundation; either version 3 of the License, or
10* (at your option) any later version.
11*
12* This program is distributed in the hope that it will be useful,
13* but WITHOUT ANY WARRANTY; without even the implied warranty of
14* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15* GNU General Public License for more details.
16*
17* You should have received a copy of the GNU General Public License
18* along with this program. If not, see <https://www.gnu.org/licenses/>.
19* or see https://www.gnu.org/
20*/
21
28require_once DOL_DOCUMENT_ROOT.'/core/modules/member/modules_member.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{
44 public $version = 'dolibarr';
45
46
52 public function __construct($db)
53 {
54 global $langs, $mysoc;
55
56 // Load translation files required by the page
57 $langs->loadLangs(array("main", "companies"));
58
59 $this->db = $db;
60 $this->name = "ODT templates";
61 $this->description = $langs->trans("DocumentModelOdt");
62 $this->scandir = 'MEMBER_ADDON_PDF_ODT_PATH'; // Name of constant that is used to save list of directories to scan
63
64 // Page size for A4 format
65 $this->type = 'odt';
66 $this->page_largeur = 0;
67 $this->page_hauteur = 0;
68 $this->format = array($this->page_largeur, $this->page_hauteur);
69 $this->marge_gauche = 0;
70 $this->marge_droite = 0;
71 $this->marge_haute = 0;
72 $this->marge_basse = 0;
73
74 $this->option_logo = 1; // Display logo
75 $this->option_tva = 0; // Manage the vat option FACTURE_TVAOPTION
76 $this->option_modereg = 0; // Display payment mode
77 $this->option_condreg = 0; // Display payment terms
78 $this->option_multilang = 1; // Available in several languages
79 $this->option_escompte = 0; // Displays if there has been a discount
80 $this->option_credit_note = 0; // Support credit notes
81 $this->option_freetext = 1; // Support add of a personalised text
82 $this->option_draft_watermark = 0; // Support add of a watermark on drafts
83
84 if ($mysoc === null) {
85 dol_syslog(get_class($this).'::__construct() Global $mysoc should not be null.'. getCallerInfoString(), LOG_ERR);
86 return;
87 }
88
89 // Retrieves issuer
90 $this->emetteur = $mysoc;
91 if (!$this->emetteur->country_code) {
92 $this->emetteur->country_code = substr($langs->defaultlang, -2); // By default if not defined
93 }
94 }
95
96
103 public function info($langs)
104 {
105 global $langs;
106
107 // Load translation files required by the page
108 $langs->loadLangs(array('companies', 'errors'));
109
110 $form = new Form($this->db);
111
112 $texte = $this->description.".<br>\n";
113 $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST" enctype="multipart/form-data">';
114 $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
115 $texte .= '<input type="hidden" name="page_y" value="">';
116 $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
117 $texte .= '<input type="hidden" name="param1" value="MEMBER_ADDON_PDF_ODT_PATH">';
118 $texte .= '<table class="nobordernopadding" width="100%">';
119
120 // List of directories area
121 $texte .= '<tr><td>';
122 $texttitle = $langs->trans("ListOfDirectories");
123 $listofdir = explode(',', preg_replace('/[\r\n]+/', ',', trim(getDolGlobalString('MEMBER_ADDON_PDF_ODT_PATH'))));
124 $listoffiles = array();
125 foreach ($listofdir as $key => $tmpdir) {
126 $tmpdir = trim($tmpdir);
127 $tmpdir = preg_replace('/DOL_DATA_ROOT/', DOL_DATA_ROOT, $tmpdir);
128 if (!$tmpdir) {
129 unset($listofdir[$key]);
130 continue;
131 }
132 if (!is_dir($tmpdir)) {
133 $texttitle .= img_warning($langs->trans("ErrorDirNotFound", $tmpdir), '');
134 } else {
135 $tmpfiles = dol_dir_list($tmpdir, 'files', 0, '\.(ods|odt)');
136 if (count($tmpfiles)) {
137 $listoffiles = array_merge($listoffiles, $tmpfiles);
138 }
139 }
140 }
141 $texthelp = $langs->trans("ListOfDirectoriesForModelGenODT");
142 $texthelp .= '<br><br><span class="opacitymedium">'.$langs->trans("ExampleOfDirectoriesForModelGen").'</span>';
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, 3, $this->name);
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 .= getDolGlobalString('MEMBER_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 button-edit reposition smallpaddingimp" name="modify" value="'.dol_escape_htmltag($langs->trans("Modify")).'">';
154 $texte .= '<br></div></div>';
155
156 // Scan directories
157 if (count($listofdir)) {
158 $texte .= $langs->trans("NumberOfModelFilesFound").': <b>'.count($listoffiles).'</b>';
159
160 $texte .= '<div id="div_'.get_class($this).'" class="hiddenx">';
161 // Show list of found files
162 foreach ($listoffiles as $file) {
163 $texte .= '- '.$file['name'].' <a href="'.DOL_URL_ROOT.'/document.php?modulepart=doctemplates&file=members/'.urlencode(basename($file['name'])).'">'.img_picto('', 'listlight').'</a>';
164 $texte .= ' &nbsp; <a class="reposition" href="'.$_SERVER["PHP_SELF"].'?modulepart=doctemplates&keyforuploaddir=MEMBER_ADDON_PDF_ODT_PATH&action=deletefile&token='.newToken().'&file='.urlencode(basename($file['name'])).'">'.img_picto('', 'delete').'</a>';
165 $texte .= '<br>';
166 }
167 $texte .= '</div>';
168 }
169 // Add input to upload a new template file.
170 $texte .= '<div>'.$langs->trans("UploadNewTemplate");
171 $maxfilesizearray = getMaxFileSizeArray();
172 $maxmin = $maxfilesizearray['maxmin'];
173 if ($maxmin > 0) {
174 $texte .= '<input type="hidden" name="MAX_FILE_SIZE" value="'.($maxmin * 1024).'">'; // MAX_FILE_SIZE must precede the field type=file
175 }
176 $texte .= ' <input type="file" name="uploadfile">';
177 $texte .= '<input type="hidden" value="MEMBER_ADDON_PDF_ODT_PATH" name="keyforuploaddir">';
178 $texte .= '<input type="submit" class="button smallpaddingimp reposition" value="'.dol_escape_htmltag($langs->trans("Upload")).'" name="upload">';
179 $texte .= '</div>';
180 $texte .= '</td>';
181
182 $texte .= '</tr>';
183
184 $texte .= '</table>';
185 $texte .= '</form>';
186
187 return $texte;
188 }
189
190 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
202 public function write_file($object, $outputlangs, $srctemplatepath = '', $mode = 'member', $nooutput = 0, $filename = 'tmp_cards')
203 {
204 // phpcs:enable
205 global $user, $langs, $conf, $mysoc, $hookmanager;
206
207 if (empty($srctemplatepath)) {
208 dol_syslog("doc_generic_odt::write_file parameter srctemplatepath empty", LOG_WARNING);
209 return -1;
210 }
211
212 // Add odtgeneration hook
213 if (!is_object($hookmanager)) {
214 include_once DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php';
215 $hookmanager = new HookManager($this->db);
216 }
217 $hookmanager->initHooks(array('odtgeneration'));
218 global $action;
219
220 if (!is_object($outputlangs)) {
221 $outputlangs = $langs;
222 }
223 $sav_charset_output = $outputlangs->charset_output;
224 $outputlangs->charset_output = 'UTF-8';
225
226 // Load translation files required by the page
227 $outputlangs->loadLangs(array("main", "companies", "bills", "dict"));
228
229 if ($conf->adherent->dir_output) {
230 // If $object is id instead of object
231 if (!is_object($object)) {
232 $id = $object;
233 $object = new User($this->db);
234 $result = $object->fetch($id);
235 if ($result < 0) {
236 dol_print_error($this->db, $object->error);
237 return -1;
238 }
239 }
240
241 $object->fetch_thirdparty();
242
243 $dir = $conf->adherent->dir_output;
244 $objectref = dol_sanitizeFileName($object->ref);
245 if (!preg_match('/specimen/i', $objectref)) {
246 $dir .= "/".$objectref;
247 }
248 $file = $dir."/".$objectref.".odt";
249
250 if (!file_exists($dir)) {
251 if (dol_mkdir($dir) < 0) {
252 $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
253 return -1;
254 }
255 }
256
257 if (file_exists($dir)) {
258 //print "srctemplatepath=".$srctemplatepath; // Src filename
259 $newfile = basename($srctemplatepath);
260 $newfiletmp = preg_replace('/\.od[ts]/i', '', $newfile);
261 $newfiletmp = preg_replace('/template_/i', '', $newfiletmp);
262 $newfiletmp = preg_replace('/modele_/i', '', $newfiletmp);
263
264 $newfiletmp = $objectref . '_' . $newfiletmp;
265
266 // Get extension (ods or odt)
267 $newfileformat = substr($newfile, strrpos($newfile, '.') + 1);
268 if (getDolGlobalString('MAIN_DOC_USE_TIMING')) {
269 $format = getDolGlobalString('MAIN_DOC_USE_TIMING');
270 if ($format == '1') {
271 $format = '%Y%m%d%H%M%S';
272 }
273 $filename = $newfiletmp . '-' . dol_print_date(dol_now(), $format) . '.' . $newfileformat;
274 } else {
275 $filename = $newfiletmp . '.' . $newfileformat;
276 }
277 $file = $dir . '/' . $filename;
278 //print "newdir=".$dir;
279 //print "newfile=".$newfile;
280 //print "file=".$file;
281 //print "conf->adherent->dir_temp=".$conf->adherent->dir_temp;
282
283 dol_mkdir($conf->adherent->dir_temp);
284 if (!is_writable($conf->adherent->dir_temp)) {
285 $this->error = $langs->transnoentities("ErrorFailedToWriteInTempDirectory", $conf->adherent->dir_temp);
286 dol_syslog('Error in write_file: ' . $this->error, LOG_ERR);
287 return -1;
288 }
289
290 // If CUSTOMER contact defined on member, 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 $contactobject = null;
299 // Recipient name
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
315 // Open and load template
316 require_once ODTPHP_PATH.'odf.php';
317 try {
318 $odfHandler = new Odf(
319 $srctemplatepath,
320 array(
321 'PATH_TO_TMP' => $conf->adherent->dir_temp,
322 'ZIP_PROXY' => getDolGlobalString('MAIN_ODF_ZIP_PROXY', 'PclZipProxy'), // PhpZipProxy or PclZipProxy. Got "bad compression method" error when using PhpZipProxy.
323 'DELIMITER_LEFT' => '{',
324 'DELIMITER_RIGHT' => '}'
325 )
326 );
327 } catch (Exception $e) {
328 $this->error = $e->getMessage();
329 dol_syslog($e->getMessage(), LOG_WARNING);
330 return -1;
331 }
332
333 // Make substitutions into odt
334 $array_member = $this->getSubstitutionarrayMember($object, $outputlangs);
335 $array_soc = $this->get_substitutionarray_mysoc($mysoc, $outputlangs);
336 $array_thirdparty = $this->get_substitutionarray_thirdparty($socobject, $outputlangs);
337 $array_other = $this->get_substitutionarray_other($outputlangs);
338 // retrieve contact information for use in object as contact_xxx tags
339 $array_thirdparty_contact = array();
340 if ($usecontact && is_object($contactobject)) {
341 $array_thirdparty_contact = $this->get_substitutionarray_contact($contactobject, $outputlangs, 'contact');
342 }
343
344 $tmparray = array_merge($array_member, $array_soc, $array_thirdparty, $array_other, $array_thirdparty_contact);
345 complete_substitutions_array($tmparray, $outputlangs, $object);
346 // Call the ODTSubstitution hook
347 $parameters = array(
348 'file' => $file,
349 'object' => $object,
350 'outputlangs' => $outputlangs,
351 'substitutionarray' => &$tmparray
352 );
353 $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
354 foreach ($tmparray as $key => $value) {
355 try {
356 if (preg_match('/logo$/', $key)) {
357 // Image
358 if (file_exists($value)) {
359 $odfHandler->setImage($key, $value);
360 } else {
361 $odfHandler->setVars($key, 'ErrorFileNotFound', true, 'UTF-8');
362 }
363 } else {
364 // Text
365 $odfHandler->setVars($key, $value, true, 'UTF-8');
366 }
367 } catch (OdfException $e) {
368 dol_syslog($e->getMessage(), LOG_WARNING);
369 }
370 }
371
372 // Replace labels translated
373 $tmparray = $outputlangs->get_translations_for_substitutions();
374 foreach ($tmparray as $key => $value) {
375 try {
376 $odfHandler->setVars($key, $value, true, 'UTF-8');
377 } catch (OdfException $e) {
378 dol_syslog($e->getMessage(), LOG_WARNING);
379 }
380 }
381
382 // Call the beforeODTSave hook
383 $parameters = array('odfHandler' => &$odfHandler, 'file' => $file, 'object' => $object, 'outputlangs' => $outputlangs);
384 $reshook = $hookmanager->executeHooks('beforeODTSave', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
385
386 // Write new file
387 if (getDolGlobalString('MAIN_ODT_AS_PDF')) {
388 try {
389 $odfHandler->exportAsAttachedPDF($file);
390 } catch (Exception $e) {
391 $this->error = $e->getMessage();
392 dol_syslog($e->getMessage(), LOG_WARNING);
393 return -1;
394 }
395 } else {
396 try {
397 $odfHandler->saveToDisk($file);
398 } catch (Exception $e) {
399 $this->error = $e->getMessage();
400 dol_syslog($e->getMessage(), LOG_WARNING);
401 return -1;
402 }
403 }
404
405 $reshook = $hookmanager->executeHooks('afterODTCreation', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
406
407 dolChmod($file);
408
409 $odfHandler = null; // Destroy object
410
411 $this->result = array('fullpath' => $file);
412
413 return 1; // Success
414 } else {
415 $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
416 return -1;
417 }
418 }
419
420 return -1;
421 }
422
423 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
432 public function get_substitutionarray_object($object, $outputlangs, $array_key = 'object')
433 {
434 // phpcs:enable
435 if (!$object instanceof Adherent) {
436 dol_syslog("Expected Adherent object, got ".gettype($object), LOG_ERR);
437 return array();
438 }
439
440 $array_other = array();
441 foreach ($object as $key => $value) {
442 if (!is_array($value) && !is_object($value)) {
443 $array_other[$array_key.'_'.$key] = $value;
444 }
445 }
446 return $array_other;
447 }
448}
$id
Definition account.php:48
if( $user->socid > 0) if(! $user->hasRight('accounting', 'chartofaccount')) $object
Definition card.php:66
Class to manage members of a foundation.
getSubstitutionarrayMember($member, $outputlangs)
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}...
Class to manage generation of HTML components Only common components must be here.
Class to manage hooks.
Parent class to manage intervention document templates.
Class to manage Dolibarr users.
Class to build documents using ODF templates generator.
info($langs)
Return description of a module.
write_file($object, $outputlangs, $srctemplatepath='', $mode='member', $nooutput=0, $filename='tmp_cards')
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
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)
getCallerInfoString()
Get caller info as a string that can be appended to a log message.
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...
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...
getDolGlobalString($key, $default='')
Return a 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)
global $conf
The following vars must be defined: $type2label $form $conf, $lang, The following vars may also be de...
Definition member.php:79
if(preg_match('/crypted:/i', $dolibarr_main_db_pass)||!empty($dolibarr_main_db_encrypted_pass)) $conf db type
Definition repair.php:149
$conf db name
Only used if Module[ID]Name translation string is not found.
Definition repair.php:152
getMaxFileSizeArray()
Return the max allowed for file upload.