dolibarr  16.0.5
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-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/member/modules_member.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 $phpmin = array(5, 6);
49 
54  public $version = 'dolibarr';
55 
56 
62  public function __construct($db)
63  {
64  global $conf, $langs, $mysoc;
65 
66  // Load translation files required by the page
67  $langs->loadLangs(array("main", "companies"));
68 
69  $this->db = $db;
70  $this->name = "ODT templates";
71  $this->description = $langs->trans("DocumentModelOdt");
72  $this->scandir = 'MEMBER_ADDON_PDF_ODT_PATH'; // Name of constant that is used to save list of directories to scan
73 
74  // Page size for A4 format
75  $this->type = 'odt';
76  $this->page_largeur = 0;
77  $this->page_hauteur = 0;
78  $this->format = array($this->page_largeur, $this->page_hauteur);
79  $this->marge_gauche = 0;
80  $this->marge_droite = 0;
81  $this->marge_haute = 0;
82  $this->marge_basse = 0;
83 
84  $this->option_logo = 1; // Display logo
85  $this->option_tva = 0; // Manage the vat option FACTURE_TVAOPTION
86  $this->option_modereg = 0; // Display payment mode
87  $this->option_condreg = 0; // Display payment terms
88  $this->option_multilang = 1; // Available in several languages
89  $this->option_escompte = 0; // Displays if there has been a discount
90  $this->option_credit_note = 0; // Support credit notes
91  $this->option_freetext = 1; // Support add of a personalised text
92  $this->option_draft_watermark = 0; // Support add of a watermark on drafts
93 
94  // Recupere emetteur
95  $this->emetteur = $mysoc;
96  if (!$this->emetteur->country_code) {
97  $this->emetteur->country_code = substr($langs->defaultlang, -2); // By default if not defined
98  }
99  }
100 
101 
108  public function info($langs)
109  {
110  global $conf, $langs;
111 
112  // Load translation files required by the page
113  $langs->loadLangs(array('companies', 'errors'));
114 
115  $form = new Form($this->db);
116 
117  $texte = $this->description.".<br>\n";
118  $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST" enctype="multipart/form-data">';
119  $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
120  $texte .= '<input type="hidden" name="page_y" value="">';
121  $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
122  $texte .= '<input type="hidden" name="param1" value="MEMBER_ADDON_PDF_ODT_PATH">';
123  $texte .= '<table class="nobordernopadding" width="100%">';
124 
125  // List of directories area
126  $texte .= '<tr><td>';
127  $texttitle = $langs->trans("ListOfDirectories");
128  $listofdir = explode(',', preg_replace('/[\r\n]+/', ',', trim(getDolGlobalString('MEMBER_ADDON_PDF_ODT_PATH'))));
129  $listoffiles = array();
130  foreach ($listofdir as $key => $tmpdir) {
131  $tmpdir = trim($tmpdir);
132  $tmpdir = preg_replace('/DOL_DATA_ROOT/', DOL_DATA_ROOT, $tmpdir);
133  if (!$tmpdir) {
134  unset($listofdir[$key]);
135  continue;
136  }
137  if (!is_dir($tmpdir)) {
138  $texttitle .= img_warning($langs->trans("ErrorDirNotFound", $tmpdir), 0);
139  } else {
140  $tmpfiles = dol_dir_list($tmpdir, 'files', 0, '\.(ods|odt)');
141  if (count($tmpfiles)) {
142  $listoffiles = array_merge($listoffiles, $tmpfiles);
143  }
144  }
145  }
146  $texthelp = $langs->trans("ListOfDirectoriesForModelGenODT");
147  // Add list of substitution keys
148  $texthelp .= '<br>'.$langs->trans("FollowingSubstitutionKeysCanBeUsed").'<br>';
149  $texthelp .= $langs->transnoentitiesnoconv("FullListOnOnlineDocumentation"); // This contains an url, we don't modify it
150 
151  $texte .= $form->textwithpicto($texttitle, $texthelp, 1, 'help', '', 1);
152  $texte .= '<div><div style="display: inline-block; min-width: 100px; vertical-align: middle;">';
153  $texte .= '<textarea class="flat" cols="60" name="value1">';
154  $texte .= getDolGlobalString('MEMBER_ADDON_PDF_ODT_PATH');
155  $texte .= '</textarea>';
156  $texte .= '</div><div style="display: inline-block; vertical-align: middle;">';
157  $texte .= '<input type="submit" class="button small reposition" name="modify" value="'.$langs->trans("Modify").'">';
158  $texte .= '<br></div></div>';
159 
160  // Scan directories
161  if (count($listofdir)) {
162  $texte .= $langs->trans("NumberOfModelFilesFound").': <b>'.count($listoffiles).'</b>';
163 
164  $texte .= '<div id="div_'.get_class($this).'" class="hiddenx">';
165  // Show list of found files
166  foreach ($listoffiles as $file) {
167  $texte .= '- '.$file['name'].' <a href="'.DOL_URL_ROOT.'/document.php?modulepart=doctemplates&file=members/'.urlencode(basename($file['name'])).'">'.img_picto('', 'listlight').'</a><br>';
168  }
169  $texte .= '</div>';
170  }
171  // Add input to upload a new template file.
172  $texte .= '<div>'.$langs->trans("UploadNewTemplate");
173  $maxfilesizearray = getMaxFileSizeArray();
174  $maxmin = $maxfilesizearray['maxmin'];
175  if ($maxmin > 0) {
176  $texte .= '<input type="hidden" name="MAX_FILE_SIZE" value="'.($maxmin * 1024).'">'; // MAX_FILE_SIZE must precede the field type=file
177  }
178  $texte .= ' <input type="file" name="uploadfile">';
179  $texte .= '<input type="hidden" value="MEMBER_ADDON_PDF_ODT_PATH" name="keyforuploaddir">';
180  $texte .= '<input type="submit" class="button small reposition" value="'.dol_escape_htmltag($langs->trans("Upload")).'" name="upload">';
181  $texte .= '</div>';
182  $texte .= '</td>';
183 
184  $texte .= '<td rowspan="2" class="tdtop hideonsmartphone">';
185  $texte .= '<span class="opacitymedium">';
186  $texte .= $langs->trans("ExampleOfDirectoriesForModelGen");
187  $texte .= '</span>';
188  $texte .= '</td>';
189  $texte .= '</tr>';
190 
191  $texte .= '</table>';
192  $texte .= '</form>';
193 
194  return $texte;
195  }
196 
197  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
209  public function write_file($object, $outputlangs, $srctemplatepath, $mode = 'member', $nooutput = 0, $filename = 'tmp_cards')
210  {
211  // phpcs:enable
212  global $user, $langs, $conf, $mysoc, $hookmanager;
213 
214  if (empty($srctemplatepath)) {
215  dol_syslog("doc_generic_odt::write_file parameter srctemplatepath empty", LOG_WARNING);
216  return -1;
217  }
218 
219  // Add odtgeneration hook
220  if (!is_object($hookmanager)) {
221  include_once DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php';
222  $hookmanager = new HookManager($this->db);
223  }
224  $hookmanager->initHooks(array('odtgeneration'));
225  global $action;
226 
227  if (!is_object($outputlangs)) {
228  $outputlangs = $langs;
229  }
230  $sav_charset_output = $outputlangs->charset_output;
231  $outputlangs->charset_output = 'UTF-8';
232 
233  // Load translation files required by the page
234  $outputlangs->loadLangs(array("main", "companies", "bills", "dict"));
235 
236  if ($conf->adherent->dir_output) {
237  // If $object is id instead of object
238  if (!is_object($object)) {
239  $id = $object;
240  $object = new User($this->db);
241  $result = $object->fetch($id);
242  if ($result < 0) {
243  dol_print_error($this->db, $object->error);
244  return -1;
245  }
246  }
247 
248  $object->fetch_thirdparty();
249 
250  $dir = $conf->adherent->dir_output;
251  $objectref = dol_sanitizeFileName($object->ref);
252  if (!preg_match('/specimen/i', $objectref)) {
253  $dir .= "/".$objectref;
254  }
255  $file = $dir."/".$objectref.".odt";
256 
257  if (!file_exists($dir)) {
258  if (dol_mkdir($dir) < 0) {
259  $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
260  return -1;
261  }
262  }
263 
264  if (file_exists($dir)) {
265  //print "srctemplatepath=".$srctemplatepath; // Src filename
266  $newfile = basename($srctemplatepath);
267  $newfiletmp = preg_replace('/\.od(t|s)/i', '', $newfile);
268  $newfiletmp = preg_replace('/template_/i', '', $newfiletmp);
269  $newfiletmp = preg_replace('/modele_/i', '', $newfiletmp);
270 
271  $newfiletmp = $objectref.'_'.$newfiletmp;
272 
273  // Get extension (ods or odt)
274  $newfileformat = substr($newfile, strrpos($newfile, '.') + 1);
275  if (!empty($conf->global->MAIN_DOC_USE_TIMING)) {
276  $format = $conf->global->MAIN_DOC_USE_TIMING;
277  if ($format == '1') {
278  $format = '%Y%m%d%H%M%S';
279  }
280  $filename = $newfiletmp.'-'.dol_print_date(dol_now(), $format).'.'.$newfileformat;
281  } else {
282  $filename = $newfiletmp.'.'.$newfileformat;
283  }
284  $file = $dir.'/'.$filename;
285  //print "newdir=".$dir;
286  //print "newfile=".$newfile;
287  //print "file=".$file;
288  //print "conf->adherent->dir_temp=".$conf->adherent->dir_temp;
289 
290  dol_mkdir($conf->adherent->dir_temp);
291  if (!is_writable($conf->adherent->dir_temp)) {
292  $this->error = "Failed to write in temp directory ".$conf->adherent->dir_temp;
293  dol_syslog('Error in write_file: '.$this->error, LOG_ERR);
294  return -1;
295  }
296 
297  // If CUSTOMER contact defined on member, we use it
298  $usecontact = false;
299  $arrayidcontact = $object->getIdContact('external', 'CUSTOMER');
300  if (count($arrayidcontact) > 0) {
301  $usecontact = true;
302  $result = $object->fetch_contact($arrayidcontact[0]);
303  }
304 
305  // Recipient name
306  if (!empty($usecontact)) {
307  // We can use the company of contact instead of thirdparty company
308  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))) {
309  $object->contact->fetch_thirdparty();
310  $socobject = $object->contact->thirdparty;
311  $contactobject = $object->contact;
312  } else {
313  $socobject = $object->thirdparty;
314  // if we have a CUSTOMER contact and we dont use it as thirdparty recipient we store the contact object for later use
315  $contactobject = $object->contact;
316  }
317  } else {
318  $socobject = $object->thirdparty;
319  }
320 
321  // Open and load template
322  require_once ODTPHP_PATH.'odf.php';
323  try {
324  $odfHandler = new odf(
325  $srctemplatepath,
326  array(
327  'PATH_TO_TMP' => $conf->adherent->dir_temp,
328  'ZIP_PROXY' => 'PclZipProxy', // PhpZipProxy or PclZipProxy. Got "bad compression method" error when using PhpZipProxy.
329  'DELIMITER_LEFT' => '{',
330  'DELIMITER_RIGHT' => '}'
331  )
332  );
333  } catch (Exception $e) {
334  $this->error = $e->getMessage();
335  dol_syslog($e->getMessage(), LOG_WARNING);
336  return -1;
337  }
338 
339  // Make substitutions into odt
340  $array_member = $this->getSubstitutionarrayMember($object, $outputlangs);
341  $array_soc = $this->get_substitutionarray_mysoc($mysoc, $outputlangs);
342  $array_thirdparty = $this->get_substitutionarray_thirdparty($socobject, $outputlangs);
343  $array_other = $this->get_substitutionarray_other($outputlangs);
344  // retrieve contact information for use in object as contact_xxx tags
345  $array_thirdparty_contact = array();
346  if ($usecontact && is_object($contactobject)) {
347  $array_thirdparty_contact = $this->get_substitutionarray_contact($contactobject, $outputlangs, 'contact');
348  }
349 
350  $tmparray = array_merge($array_member, $array_soc, $array_thirdparty, $array_other, $array_thirdparty_contact);
351  complete_substitutions_array($tmparray, $outputlangs, $object);
352  // Call the ODTSubstitution hook
353  $parameters = array(
354  'file'=>$file,
355  'object'=>$object,
356  'outputlangs'=>$outputlangs,
357  'substitutionarray'=>&$tmparray
358  );
359  $reshook = $hookmanager->executeHooks('ODTSubstitution', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
360  foreach ($tmparray as $key => $value) {
361  try {
362  if (preg_match('/logo$/', $key)) {
363  // Image
364  if (file_exists($value)) {
365  $odfHandler->setImage($key, $value);
366  } else {
367  $odfHandler->setVars($key, 'ErrorFileNotFound', true, 'UTF-8');
368  }
369  } else {
370  // Text
371  $odfHandler->setVars($key, $value, true, 'UTF-8');
372  }
373  } catch (OdfException $e) {
374  dol_syslog($e->getMessage(), LOG_WARNING);
375  }
376  }
377 
378  // Replace labels translated
379  $tmparray = $outputlangs->get_translations_for_substitutions();
380  foreach ($tmparray as $key => $value) {
381  try {
382  $odfHandler->setVars($key, $value, true, 'UTF-8');
383  } catch (OdfException $e) {
384  dol_syslog($e->getMessage(), LOG_WARNING);
385  }
386  }
387 
388  // Call the beforeODTSave hook
389  $parameters = array('odfHandler'=>&$odfHandler, 'file'=>$file, 'object'=>$object, 'outputlangs'=>$outputlangs);
390  $reshook = $hookmanager->executeHooks('beforeODTSave', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
391 
392  // Write new file
393  if (!empty($conf->global->MAIN_ODT_AS_PDF)) {
394  try {
395  $odfHandler->exportAsAttachedPDF($file);
396  } catch (Exception $e) {
397  $this->error = $e->getMessage();
398  dol_syslog($e->getMessage(), LOG_WARNING);
399  return -1;
400  }
401  } else {
402  try {
403  $odfHandler->saveToDisk($file);
404  } catch (Exception $e) {
405  $this->error = $e->getMessage();
406  dol_syslog($e->getMessage(), LOG_WARNING);
407  return -1;
408  }
409  }
410 
411  $reshook = $hookmanager->executeHooks('afterODTCreation', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
412 
413  if (!empty($conf->global->MAIN_UMASK)) {
414  @chmod($file, octdec($conf->global->MAIN_UMASK));
415  }
416 
417  $odfHandler = null; // Destroy object
418 
419  $this->result = array('fullpath'=>$file);
420 
421  return 1; // Success
422  } else {
423  $this->error = $langs->transnoentities("ErrorCanNotCreateDir", $dir);
424  return -1;
425  }
426  }
427 
428  return -1;
429  }
430 
431  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
440  public function get_substitutionarray_object($object, $outputlangs, $array_key = 'object')
441  {
442  // phpcs:enable
443  $array_other = array();
444  foreach ($object as $key => $value) {
445  if (!is_array($value) && !is_object($value)) {
446  $array_other[$array_key.'_'.$key] = $value;
447  }
448  }
449  return $array_other;
450  }
451 }
doc_generic_member_odt\write_file
write_file($object, $outputlangs, $srctemplatepath, $mode='member', $nooutput=0, $filename='tmp_cards')
Function to build a document on disk using the generic odt module.
Definition: doc_generic_member_odt.class.php:209
db
$conf db
API class for accounts.
Definition: inc.php:41
dol_sanitizeFileName
dol_sanitizeFileName($str, $newstr='_', $unaccent=1)
Clean a string to use it as a file name.
Definition: functions.lib.php:1226
description
print *****$script_file(".$version.") pid cd cd cd description as description
Definition: email_expire_services_to_customers.php:83
doc_generic_member_odt\info
info($langs)
Return description of a module.
Definition: doc_generic_member_odt.class.php:108
dol_print_error
dol_print_error($db='', $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
Definition: functions.lib.php:4844
CommonDocGenerator\getSubstitutionarrayMember
getSubstitutionarrayMember($member, $outputlangs)
Define array with couple substitution key => substitution value.
Definition: commondocgenerator.class.php:150
img_warning
img_warning($titlealt='default', $moreatt='', $morecss='pictowarning')
Show warning logo.
Definition: functions.lib.php:4521
doc_generic_member_odt
Class to build documents using ODF templates generator.
Definition: doc_generic_member_odt.class.php:37
$form
if($cancel &&! $id) if($action=='add' &&! $cancel) if($action=='delete') if($id) $form
Actions.
Definition: card.php:142
dol_dir_list
dol_dir_list($path, $types="all", $recursive=0, $filter="", $excludefilter=null, $sortcriteria="name", $sortorder=SORT_ASC, $mode=0, $nohook=0, $relativename="", $donotfollowsymlinks=0)
Scan a directory and return a list of files/directories.
Definition: files.lib.php:60
name
$conf db name
Definition: repair.php:122
ModelePDFMember
Parent class to manage intervention document templates.
Definition: modules_member.class.php:35
dol_print_date
dol_print_date($time, $format='', $tzoutput='auto', $outputlangs='', $encodetooutput=false)
Output date in a string format according to outputlangs (or langs if not defined).
Definition: functions.lib.php:2514
CommonDocGenerator\get_substitutionarray_contact
get_substitutionarray_contact($object, $outputlangs, $array_key='object')
Define array with couple substitution key => substitution value.
Definition: commondocgenerator.class.php:321
img_picto
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
Definition: functions.lib.php:3880
getMaxFileSizeArray
getMaxFileSizeArray()
Return the max allowed for file upload.
Definition: security.lib.php:993
Exception
CommonDocGenerator\get_substitutionarray_thirdparty
get_substitutionarray_thirdparty($object, $outputlangs, $array_key='company')
Define array with couple substitution key => substitution value For example {company_name},...
Definition: commondocgenerator.class.php:256
dol_syslog
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.
Definition: functions.lib.php:1603
CommonDocGenerator\get_substitutionarray_mysoc
get_substitutionarray_mysoc($mysoc, $outputlangs)
Define array with couple substitution key => substitution value.
Definition: commondocgenerator.class.php:197
getDolGlobalString
if(!function_exists('utf8_encode')) if(!function_exists('utf8_decode')) getDolGlobalString($key, $default='')
Return dolibarr global constant string value.
Definition: functions.lib.php:80
doc_generic_member_odt\__construct
__construct($db)
Constructor.
Definition: doc_generic_member_odt.class.php:62
User
Class to manage Dolibarr users.
Definition: user.class.php:44
Form
Class to manage generation of HTML components Only common components must be here.
Definition: html.form.class.php:52
dol_now
dol_now($mode='auto')
Return date for now.
Definition: functions.lib.php:2845
doc_generic_member_odt\get_substitutionarray_object
get_substitutionarray_object($object, $outputlangs, $array_key='object')
get substitution array for object
Definition: doc_generic_member_odt.class.php:440
dol_mkdir
dol_mkdir($dir, $dataroot='', $newmask='')
Creation of a directory (this can create recursive subdir)
Definition: functions.lib.php:6603
type
if(preg_match('/crypted:/i', $dolibarr_main_db_pass)||!empty($dolibarr_main_db_encrypted_pass)) $conf db type
Definition: repair.php:119
HookManager
Class to manage hooks.
Definition: hookmanager.class.php:30
complete_substitutions_array
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...
Definition: functions.lib.php:7961
CommonDocGenerator\get_substitutionarray_other
get_substitutionarray_other($outputlangs)
Define array with couple substitution key => substitution value.
Definition: commondocgenerator.class.php:379