dolibarr 21.0.0-alpha
expedition.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2003-2008 Rodolphe Quiedeville <rodolphe@quiedeville.org>
3 * Copyright (C) 2004-2011 Laurent Destailleur <eldy@users.sourceforge.net>
4 * Copyright (C) 2004 Sebastien Di Cintio <sdicintio@ressource-toi.org>
5 * Copyright (C) 2004 Benoit Mortier <benoit.mortier@opensides.be>
6 * Copyright (C) 2004 Eric Seigne <eric.seigne@ryxeo.com>
7 * Copyright (C) 2005-2012 Regis Houssin <regis.houssin@inodbox.com>
8 * Copyright (C) 2011-2012 Juanjo Menent <jmenent@2byte.es>
9 * Copyright (C) 2011-2018 Philippe Grand <philippe.grand@atoo-net.com>
10 * Copyright (C) 2024 MDW <mdeweerd@users.noreply.github.com>
11 * Copyright (C) 2024 Frédéric France <frederic.france@free.fr>
12 *
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 3 of the License, or
16 * (at your option) any later version.
17 *
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License
24 * along with this program. If not, see <https://www.gnu.org/licenses/>.
25 */
26
33// Load Dolibarr environment
34require '../main.inc.php';
35require_once DOL_DOCUMENT_ROOT.'/core/lib/admin.lib.php';
36require_once DOL_DOCUMENT_ROOT.'/core/lib/pdf.lib.php';
37require_once DOL_DOCUMENT_ROOT.'/core/lib/expedition.lib.php';
38require_once DOL_DOCUMENT_ROOT.'/expedition/class/expedition.class.php';
39
40// Load translation files required by the page
41$langs->loadLangs(array("admin", "sendings", "deliveries", "other"));
42
43if (!$user->admin) {
45}
46
47$action = GETPOST('action', 'aZ09');
48$value = GETPOST('value', 'alpha');
49$modulepart = GETPOST('modulepart', 'aZ09'); // Used by actions_setmoduleoptions.inc.php
50
51$label = GETPOST('label', 'alpha');
52$scandir = GETPOST('scan_dir', 'alpha');
53$type = 'shipping';
54
55if (!getDolGlobalString('EXPEDITION_ADDON_NUMBER')) {
56 $conf->global->EXPEDITION_ADDON_NUMBER = 'mod_expedition_safor';
57}
58
59
60/*
61 * Actions
62 */
63
64include DOL_DOCUMENT_ROOT.'/core/actions_setmoduleoptions.inc.php';
65
66if ($action == 'updateMask') {
67 $maskconst = GETPOST('maskconstexpedition', 'aZ09');
68 $maskvalue = GETPOST('maskexpedition', 'alpha');
69 if (!empty($maskconst) && preg_match('/_MASK$/', $maskconst)) {
70 $res = dolibarr_set_const($db, $maskconst, $maskvalue, 'chaine', 0, '', $conf->entity);
71 }
72
73 if (isset($res)) {
74 if ($res > 0) {
75 setEventMessages($langs->trans("SetupSaved"), null, 'mesgs');
76 } else {
77 setEventMessages($langs->trans("Error"), null, 'errors');
78 }
79 }
80} elseif ($action == 'set_param') {
81 $freetext = GETPOST('SHIPPING_FREE_TEXT', 'restricthtml'); // No alpha here, we want exact string
82 $res = dolibarr_set_const($db, "SHIPPING_FREE_TEXT", $freetext, 'chaine', 0, '', $conf->entity);
83 if ($res <= 0) {
84 $error++;
85 setEventMessages($langs->trans("Error"), null, 'errors');
86 }
87
88 $draft = GETPOST('SHIPPING_DRAFT_WATERMARK', 'alpha');
89 $res = dolibarr_set_const($db, "SHIPPING_DRAFT_WATERMARK", trim($draft), 'chaine', 0, '', $conf->entity);
90 if ($res <= 0) {
91 $error++;
92 setEventMessages($langs->trans("Error"), null, 'errors');
93 }
94
95 if (!$error) {
96 setEventMessages($langs->trans("SetupSaved"), null, 'mesgs');
97 }
98} elseif ($action == 'specimen') {
99 $modele = GETPOST('module', 'alpha');
100
101 $exp = new Expedition($db);
102 $exp->initAsSpecimen();
103
104 // Search template files
105 $file = '';
106 $classname = '';
107 $dirmodels = array_merge(array('/'), (array) $conf->modules_parts['models']);
108 foreach ($dirmodels as $reldir) {
109 $file = dol_buildpath($reldir."core/modules/expedition/doc/pdf_".$modele.".modules.php", 0);
110 if (file_exists($file)) {
111 $classname = "pdf_".$modele;
112 break;
113 }
114 }
115
116 if ($classname !== '') {
117 require_once $file;
118
119 $module = new $classname($db);
120 '@phan-var-force ModelePdfExpedition $module';
121
122 if ($module->write_file($exp, $langs) > 0) {
123 header("Location: ".DOL_URL_ROOT."/document.php?modulepart=expedition&file=SPECIMEN.pdf");
124 return;
125 } else {
126 setEventMessages($module->error, $module->errors, 'errors');
127 dol_syslog($module->error, LOG_ERR);
128 }
129 } else {
130 setEventMessages($langs->trans("ErrorModuleNotFound"), null, 'errors');
131 dol_syslog($langs->trans("ErrorModuleNotFound"), LOG_ERR);
132 }
133} elseif ($action == 'set') {
134 // Activate a model
135 $ret = addDocumentModel($value, $type, $label, $scandir);
136} elseif ($action == 'del') {
137 $ret = delDocumentModel($value, $type);
138 if ($ret > 0) {
139 if (getDolGlobalString('EXPEDITION_ADDON_PDF') == "$value") {
140 dolibarr_del_const($db, 'EXPEDITION_ADDON_PDF', $conf->entity);
141 }
142 }
143} elseif ($action == 'setdoc') {
144 // Set default model
145 if (dolibarr_set_const($db, "EXPEDITION_ADDON_PDF", $value, 'chaine', 0, '', $conf->entity)) {
146 // La constante qui a ete lue en avant du nouveau set
147 // on passe donc par une variable pour avoir un affichage coherent
148 $conf->global->EXPEDITION_ADDON_PDF = $value;
149 }
150
151 // On active le modele
152 $ret = delDocumentModel($value, $type);
153 if ($ret > 0) {
154 $ret = addDocumentModel($value, $type, $label, $scandir);
155 }
156} elseif ($action == 'setmodel') {
157 dolibarr_set_const($db, "EXPEDITION_ADDON_NUMBER", $value, 'chaine', 0, '', $conf->entity);
158}
159
160
161/*
162 * View
163 */
164
165$dirmodels = array_merge(array('/'), (array) $conf->modules_parts['models']);
166
167$form = new Form($db);
168
169llxHeader("", $langs->trans("SendingsSetup"), '', '', 0, 0, '', '', '', 'mod-admin page-expedition');
170
171$linkback = '<a href="'.DOL_URL_ROOT.'/admin/modules.php?restore_lastsearch_values=1">'.$langs->trans("BackToModuleList").'</a>';
172print load_fiche_titre($langs->trans("SendingsSetup"), $linkback, 'title_setup');
173print '<br>';
175
176print dol_get_fiche_head($head, 'shipment', $langs->trans("Sendings"), -1, 'shipment');
177
178// Shipment numbering model
179
180print load_fiche_titre($langs->trans("SendingsNumberingModules"), '', '');
181
182print '<table class="noborder centpercent">';
183print '<tr class="liste_titre">';
184print '<td width="100">'.$langs->trans("Name").'</td>';
185print '<td>'.$langs->trans("Description").'</td>';
186print '<td>'.$langs->trans("Example").'</td>';
187print '<td class="center" width="60">'.$langs->trans("Status").'</td>';
188print '<td class="center" width="80">'.$langs->trans("ShortInfo").'</td>';
189print "</tr>\n";
190
191clearstatcache();
192
193foreach ($dirmodels as $reldir) {
194 $dir = dol_buildpath($reldir."core/modules/expedition/");
195
196 if (is_dir($dir)) {
197 $handle = opendir($dir);
198 if (is_resource($handle)) {
199 while (($file = readdir($handle)) !== false) {
200 if (preg_match('/^mod_expedition_([a-z0-9_]*)\.php$/', $file)) {
201 $file = substr($file, 0, dol_strlen($file) - 4);
202
203 require_once $dir.$file.'.php';
204
205 $module = new $file();
206 '@phan-var-force ModelNumRefExpedition $module';
207
208 if ($module->isEnabled()) {
209 // Show modules according to features level
210 if ($module->version == 'development' && getDolGlobalInt('MAIN_FEATURES_LEVEL') < 2) {
211 continue;
212 }
213 if ($module->version == 'experimental' && getDolGlobalInt('MAIN_FEATURES_LEVEL') < 1) {
214 continue;
215 }
216
217 print '<tr><td>'.$module->name."</td>\n";
218 print '<td>';
219 print $module->info($langs);
220 print '</td>';
221
222 // Show example of numbering module
223 print '<td class="nowrap">';
224 $tmp = $module->getExample();
225 if (preg_match('/^Error/', $tmp)) {
226 $langs->load("errors");
227 print '<div class="error">'.$langs->trans($tmp).'</div>';
228 } elseif ($tmp == 'NotConfigured') {
229 print '<span class="opacitymedium">'.$langs->trans($tmp).'</span>';
230 } else {
231 print $tmp;
232 }
233 print '</td>'."\n";
234
235 print '<td class="center">';
236 if ($conf->global->EXPEDITION_ADDON_NUMBER == "$file") {
237 print img_picto($langs->trans("Activated"), 'switch_on');
238 } else {
239 print '<a class="reposition" href="'.$_SERVER["PHP_SELF"].'?action=setmodel&token='.newToken().'&value='.urlencode($file).'&label='.urlencode($module->name).'">';
240 print img_picto($langs->trans("Disabled"), 'switch_off');
241 print '</a>';
242 }
243 print '</td>';
244
245 $expedition = new Expedition($db);
246 $expedition->initAsSpecimen();
247
248 // Info
249 $htmltooltip = '';
250 $htmltooltip .= ''.$langs->trans("Version").': <b>'.$module->getVersion().'</b><br>';
251 $nextval = $module->getNextValue($mysoc, $expedition);
252 if ("$nextval" != $langs->trans("NotAvailable")) { // Keep " on nextval
253 $htmltooltip .= ''.$langs->trans("NextValue").': ';
254 if ($nextval) {
255 if (preg_match('/^Error/', $nextval) || $nextval == 'NotConfigured') {
256 $nextval = $langs->trans($nextval);
257 }
258 $htmltooltip .= $nextval.'<br>';
259 } else {
260 $htmltooltip .= $langs->trans($module->error).'<br>';
261 }
262 }
263
264 print '<td class="center">';
265 print $form->textwithpicto('', $htmltooltip, 1, 0);
266 print '</td>';
267
268 print '</tr>';
269 }
270 }
271 }
272 closedir($handle);
273 }
274 }
275}
276
277print '</table><br>';
278
279
280/*
281 * Documents models for Sendings Receipt
282 */
283print load_fiche_titre($langs->trans("SendingsReceiptModel"), '', '');
284
285// Defini tableau def de modele invoice
286$type = "shipping";
287$def = array();
288
289$sql = "SELECT nom";
290$sql .= " FROM ".MAIN_DB_PREFIX."document_model";
291$sql .= " WHERE type = '".$db->escape($type)."'";
292$sql .= " AND entity = ".$conf->entity;
293
294$resql = $db->query($sql);
295if ($resql) {
296 $i = 0;
297 $num_rows = $db->num_rows($resql);
298 while ($i < $num_rows) {
299 $array = $db->fetch_array($resql);
300 if (is_array($array)) {
301 array_push($def, $array[0]);
302 }
303 $i++;
304 }
305} else {
306 dol_print_error($db);
307}
308
309print '<table class="noborder centpercent">';
310print '<tr class="liste_titre">';
311print '<td width="140">'.$langs->trans("Name").'</td>';
312print '<td>'.$langs->trans("Description").'</td>';
313print '<td class="center" width="60">'.$langs->trans("Status").'</td>';
314print '<td class="center" width="60">'.$langs->trans("Default").'</td>';
315print '<td class="nowrap center" width="80">'.$langs->trans("ShortInfo").'</td>';
316print '<td class="nowrap center" width="80" >'.$langs->trans("Preview").'</td>';
317print "</tr>\n";
318
319clearstatcache();
320
321foreach ($dirmodels as $reldir) {
322 foreach (array('', '/doc') as $valdir) {
323 $dir = dol_buildpath($reldir."core/modules/expedition".$valdir);
324
325 if (is_dir($dir)) {
326 $handle = opendir($dir);
327 if (is_resource($handle)) {
328 $filelist = array();
329 while (($file = readdir($handle)) !== false) {
330 $filelist[] = $file;
331 }
332 closedir($handle);
333 arsort($filelist);
334
335 foreach ($filelist as $file) {
336 if (preg_match('/\.modules\.php$/i', $file) && preg_match('/^(pdf_|doc_)/', $file)) {
337 if (file_exists($dir.'/'.$file)) {
338 $name = substr($file, 4, dol_strlen($file) - 16);
339 $classname = substr($file, 0, dol_strlen($file) - 12);
340
341 require_once $dir.'/'.$file;
342 $module = new $classname($db);
343
344 '@phan-var-force ModelePdfExpedition $module';
345
346 $modulequalified = 1;
347 if ($module->version == 'development' && getDolGlobalInt('MAIN_FEATURES_LEVEL') < 2) {
348 $modulequalified = 0;
349 }
350 if ($module->version == 'experimental' && getDolGlobalInt('MAIN_FEATURES_LEVEL') < 1) {
351 $modulequalified = 0;
352 }
353
354 if ($modulequalified) {
355 print '<tr><td width="100">';
356 print(empty($module->name) ? $name : $module->name);
357 print "</td><td>\n";
358 if (method_exists($module, 'info')) {
359 print $module->info($langs); // @phan-suppress-current-line PhanUndeclaredMethod
360 } else {
361 print $module->description;
362 }
363 print '</td>';
364
365 // Active
366 if (in_array($name, $def)) {
367 print '<td class="center">'."\n";
368 print '<a class="reposition" href="'.$_SERVER["PHP_SELF"].'?action=del&token='.newToken().'&value='.urlencode($name).'">';
369 print img_picto($langs->trans("Enabled"), 'switch_on');
370 print '</a>';
371 print '</td>';
372 } else {
373 print '<td class="center">'."\n";
374 print '<a class="reposition" href="'.$_SERVER["PHP_SELF"].'?action=set&token='.newToken().'&value='.urlencode($name).'&scan_dir='.urlencode($module->scandir).'&label='.urlencode($module->name).'">'.img_picto($langs->trans("Disabled"), 'switch_off').'</a>';
375 print "</td>";
376 }
377
378 // Default
379 print '<td class="center">';
380 if (getDolGlobalString('EXPEDITION_ADDON_PDF') == $name) {
381 print img_picto($langs->trans("Default"), 'on');
382 } else {
383 print '<a class="reposition" href="'.$_SERVER["PHP_SELF"].'?action=setdoc&token='.newToken().'&value='.urlencode($name).'&scan_dir='.urlencode($module->scandir).'&label='.urlencode($module->name).'" alt="'.$langs->trans("Default").'">'.img_picto($langs->trans("Disabled"), 'off').'</a>';
384 }
385 print '</td>';
386
387 // Info
388 $htmltooltip = ''.$langs->trans("Name").': '.$module->name;
389 $htmltooltip .= '<br>'.$langs->trans("Type").': '.($module->type ? $module->type : $langs->trans("Unknown"));
390 if ($module->type == 'pdf') {
391 $htmltooltip .= '<br>'.$langs->trans("Width").'/'.$langs->trans("Height").': '.$module->page_largeur.'/'.$module->page_hauteur;
392 }
393 $htmltooltip .= '<br><br><u>'.$langs->trans("FeaturesSupported").':</u>';
394 $htmltooltip .= '<br>'.$langs->trans("Logo").': '.yn($module->option_logo, 1, 1);
395 $htmltooltip .= '<br>'.$langs->trans("PaymentMode").': '.yn($module->option_modereg, 1, 1);
396 $htmltooltip .= '<br>'.$langs->trans("PaymentConditions").': '.yn($module->option_condreg, 1, 1);
397 $htmltooltip .= '<br>'.$langs->trans("MultiLanguage").': '.yn($module->option_multilang, 1, 1);
398 $htmltooltip .= '<br>'.$langs->trans("WatermarkOnDraftOrders").': '.yn($module->option_draft_watermark, 1, 1);
399
400 print '<td class="center">';
401 print $form->textwithpicto('', $htmltooltip, 1, 0);
402 print '</td>';
403
404 // Preview
405 print '<td class="center">';
406 if ($module->type == 'pdf') {
407 print '<a href="'.$_SERVER["PHP_SELF"].'?action=specimen&module='.$name.'&amp;scan_dir='.$module->scandir.'&amp;label='.urlencode($module->name).'">'.img_object($langs->trans("Preview"), 'pdf').'</a>';
408 } else {
409 print img_object($langs->trans("PreviewNotAvailable"), 'generic');
410 }
411 print '</td>';
412
413 print "</tr>\n";
414 }
415 }
416 }
417 }
418 }
419 }
420 }
421}
422
423print '</table>';
424
425
426/*
427 * Other options
428 */
429
430print load_fiche_titre($langs->trans("OtherOptions"), '', '');
431
432print '<form action="'.$_SERVER["PHP_SELF"].'" method="post">';
433print '<input type="hidden" name="token" value="'.newToken().'">';
434print '<input type="hidden" name="action" value="set_param">';
435
436print '<table class="noborder centpercent">';
437print '<tr class="liste_titre">';
438print "<td>".$langs->trans("Parameter")."</td>\n";
439print "<td></td>\n";
440print '</tr>';
441
442print '<tr class="oddeven">';
443print '<td>'.$langs->trans('SHIPPING_DISPLAY_STOCK_ENTRY_DATE');
444print '</td>';
445print '<td>';
446print ajax_constantonoff('SHIPPING_DISPLAY_STOCK_ENTRY_DATE');
447print '</td></tr>';
448
449$substitutionarray = pdf_getSubstitutionArray($langs, null, null, 2);
450$substitutionarray['__(AnyTranslationKey)__'] = $langs->trans("Translation");
451$htmltext = '<i>'.$langs->trans("AvailableVariables").':<br>';
452foreach ($substitutionarray as $key => $val) {
453 $htmltext .= $key.'<br>';
454}
455$htmltext .= '</i>';
456
457print '<tr><td colspan="2">';
458print $form->textwithpicto($langs->trans("FreeLegalTextOnShippings"), $langs->trans("AddCRIfTooLong").'<br><br>'.$htmltext, 1, 'help', '', 0, 2, 'freetexttooltip').'<br>';
459$variablename = 'SHIPPING_FREE_TEXT';
460if (!getDolGlobalString('PDF_ALLOW_HTML_FOR_FREE_TEXT')) {
461 print '<textarea name="'.$variablename.'" class="flat" cols="120">'.getDolGlobalString($variablename).'</textarea>';
462} else {
463 include_once DOL_DOCUMENT_ROOT.'/core/class/doleditor.class.php';
464 $doleditor = new DolEditor($variablename, getDolGlobalString($variablename), '', 80, 'dolibarr_notes');
465 print $doleditor->Create();
466}
467print "</td></tr>\n";
468
469print '<tr><td>';
470print $form->textwithpicto($langs->trans("WatermarkOnDraftContractCards"), $htmltext, 1, 'help', '', 0, 2, 'watermarktooltip');
471print '</td><td>';
472print '<input class="flat minwidth200" type="text" name="SHIPPING_DRAFT_WATERMARK" value="'.dol_escape_htmltag(getDolGlobalString('SHIPPING_DRAFT_WATERMARK')).'">';
473print "</td></tr>\n";
474
475// Allow OnLine Sign
476print '<tr class="oddeven">';
477print '<td>'.$langs->trans("AllowOnLineSign");
478print '</td>';
479print '<td>';
480print ajax_constantonoff('EXPEDITION_ALLOW_ONLINESIGN', array(), null, 0, 0, 0, 2, 0, 1);
481print '</td></tr>';
482
483print '</table>';
484
485print $form->buttonsSaveCancel("Modify", '');
486
487print '</form>';
488
489// End of page
490llxFooter();
491$db->close();
addDocumentModel($name, $type, $label='', $description='')
Add document model used by doc generator.
dolibarr_set_const($db, $name, $value, $type='chaine', $visible=0, $note='', $entity=1)
Insert a parameter (key,value) into database (delete old key then insert it again).
dolibarr_del_const($db, $name, $entity=1)
Delete a constant.
delDocumentModel($name, $type)
Delete document model used by doc generator.
if(!defined('NOREQUIRESOC')) if(!defined( 'NOREQUIRETRAN')) if(!defined('NOTOKENRENEWAL')) if(!defined( 'NOREQUIREMENU')) if(!defined('NOREQUIREHTML')) if(!defined( 'NOREQUIREAJAX')) llxHeader($head='', $title='', $help_url='', $target='', $disablejs=0, $disablehead=0, $arrayofjs='', $arrayofcss='', $morequerystring='', $morecssonbody='', $replacemainareaby='', $disablenofollow=0, $disablenoindex=0)
Empty header.
Definition wrapper.php:70
Class to manage a WYSIWYG editor.
Class to manage generation of HTML components Only common components must be here.
llxFooter()
Footer empty.
Definition document.php:107
expedition_admin_prepare_head()
Return array head with list of tabs to view object information.
load_fiche_titre($title, $morehtmlright='', $picto='generic', $pictoisfullpath=0, $id='', $morecssontable='', $morehtmlcenter='')
Load a title with picto.
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0)
Show a picto called object_picto (generic function)
setEventMessages($mesg, $mesgs, $style='mesgs', $messagekey='', $noduplicate=0, $attop=0)
Set event messages in dol_events session object.
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
dol_get_fiche_head($links=array(), $active='', $title='', $notab=0, $picto='', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limittoshow=0, $moretabssuffix='', $dragdropfile=0)
Show tabs of a record.
dol_strlen($string, $stringencoding='UTF-8')
Make a strlen call.
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
newToken()
Return the value of token currently saved into session with name 'newtoken'.
yn($yesno, $format=1, $color=0)
Return yes or no in current language.
GETPOST($paramname, $check='alphanohtml', $method=0, $filter=null, $options=null, $noreplace=0)
Return value of a param into GET or POST supervariable.
dol_buildpath($path, $type=0, $returnemptyifnotfound=0)
Return path of url or filesystem.
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.
pdf_getSubstitutionArray($outputlangs, $exclude=null, $object=null, $onlykey=0, $include=null)
Return array of possible substitutions for PDF content (without external module substitutions).
Definition pdf.lib.php:765
$conf db name
Only used if Module[ID]Name translation string is not found.
Definition repair.php:140
accessforbidden($message='', $printheader=1, $printfooter=1, $showonlymessage=0, $params=null)
Show a message to say access is forbidden and stop program.