dolibarr 19.0.3
mod_barcode_product_standard.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2004 Rodolphe Quiedeville <rodolphe@quiedeville.org>
3 * Copyright (C) 2006-2014 Laurent Destailleur <eldy@users.sourceforge.net>
4 * Copyright (C) 2007-2012 Regis Houssin <regis.houssin@inodbox.com>
5 * Copyright (C) 2011 Juanjo Menent <jmenent@2byte.es>
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/barcode/modules_barcode.class.php';
29
30
35{
36 public $name = 'Standard'; // Model Name
37
38 public $code_modifiable; // Editable code
39
40 public $code_modifiable_invalide; // Modified code if it is invalid
41
42 public $code_modifiable_null; // Modified code if it is null
43
44 public $code_null; // Optional code
45
50 public $version = 'dolibarr'; // 'development', 'experimental', 'dolibarr'
51
55 public $code_auto;
56
57 public $searchcode; // Search string
58
59 public $numbitcounter; // Number of digits the counter
60
61 public $prefixIsRequired; // The prefix field of third party must be filled when using {pre}
62
63
67 public function __construct()
68 {
69 $this->code_null = 0;
70 $this->code_modifiable = 1;
71 $this->code_modifiable_invalide = 1;
72 $this->code_modifiable_null = 1;
73 $this->code_auto = 1;
74 $this->prefixIsRequired = 0;
75 }
76
77
83 public function info($langs)
84 {
85 global $conf, $mc;
86 global $form;
87
88 $langs->load("products");
89
90 $disabled = ((!empty($mc->sharings['referent']) && $mc->sharings['referent'] != $conf->entity) ? ' disabled' : '');
91
92 $texte = $langs->trans('GenericNumRefModelDesc')."<br>\n";
93 $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST">';
94 $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
95 $texte .= '<input type="hidden" name="page_y" value="">';
96 $texte .= '<input type="hidden" name="action" value="setModuleOptions">';
97 $texte .= '<input type="hidden" name="param1" value="BARCODE_STANDARD_PRODUCT_MASK">';
98 $texte .= '<table class="nobordernopadding" width="100%">';
99
100 $tooltip = $langs->trans("GenericMaskCodes", $langs->transnoentities("BarCode"), $langs->transnoentities("BarCode"));
101 $tooltip .= $langs->trans("GenericMaskCodes3EAN");
102 $tooltip .= '<strong>'.$langs->trans("Example").':</strong><br>';
103 $tooltip .= '04{0000000000}? (for internal use)<br>';
104 $tooltip .= '9771234{00000}? (example of ISSN code with prefix 1234)<br>';
105 $tooltip .= '9791234{00000}? (example of ISMN code with prefix 1234)<br>';
106 //$tooltip.=$langs->trans("GenericMaskCodes5");
107
108 // Mask parameter
109 //$texte.= '<tr><td>'.$langs->trans("Mask").' ('.$langs->trans("BarCodeModel").'):</td>';
110 $texte .= '<tr><td>'.$langs->trans("Mask").':</td>';
111 $texte .= '<td class="right">'.$form->textwithpicto('<input type="text" class="flat minwidth175" name="value1" value="'.(getDolGlobalString('BARCODE_STANDARD_PRODUCT_MASK') ? $conf->global->BARCODE_STANDARD_PRODUCT_MASK : '').'"'.$disabled.'>', $tooltip, 1, 1).'</td>';
112 $texte .= '<td class="left" rowspan="2">&nbsp; <input type="submit" class="button button-edit reposition smallpaddingimp" name="modify" value="'.$langs->trans("Modify").'"'.$disabled.'></td>';
113 $texte .= '</tr>';
114
115 $texte .= '</table>';
116 $texte .= '</form>';
117
118 return $texte;
119 }
120
121
129 public function getExample($langs, $objproduct = 0)
130 {
131 $examplebarcode = $this->getNextValue($objproduct, '');
132 if (!$examplebarcode) {
133 $examplebarcode = $langs->trans('NotConfigured');
134 }
135 if ($examplebarcode == "ErrorBadMask") {
136 $langs->load("errors");
137 $examplebarcode = $langs->trans($examplebarcode);
138 }
139
140 return $examplebarcode;
141 }
149 public function literalBarcodeType($db, $type = '')
150 {
151 global $conf;
152 $out = '';
153
154 $sql = "SELECT rowid, code, libelle as label";
155 $sql .= " FROM ".MAIN_DB_PREFIX."c_barcode_type";
156 $sql .= " WHERE rowid = '".$db->escape($type)."'";
157 $sql .= " AND entity = ".((int) $conf->entity);
158 $result = $db->query($sql);
159 if ($result) {
160 $num = $db->num_rows($result);
161
162 if ($num > 0) {
163 $obj = $db->fetch_object($result);
164 $out .= $obj->label; //take the label corresponding to the type rowid in the database
165 }
166 } else {
167 dol_print_error($db);
168 }
169
170 return $out;
171 }
179 public function getNextValue($objproduct, $type = '')
180 {
181 global $db, $conf;
182
183 require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
184 require_once DOL_DOCUMENT_ROOT.'/core/lib/barcode.lib.php'; // to be able to call function barcode_gen_ean_sum($ean)
185
186 // Get barcode type configuration for products if $type not set
187 if (empty($type)) {
188 $type = getDolGlobalString('PRODUIT_DEFAULT_BARCODE_TYPE');
189 }
190
191 // TODO
192
193 // Get Mask value
194 $mask = '';
195 if (getDolGlobalString('BARCODE_STANDARD_PRODUCT_MASK')) {
196 $mask = $conf->global->BARCODE_STANDARD_PRODUCT_MASK;
197 }
198
199 if (empty($mask)) {
200 $this->error = 'NotConfigured';
201 return '';
202 }
203
204 $field = 'barcode';
205 $where = '';
206
207 $now = dol_now();
208
209 $numFinal = get_next_value($db, $mask, 'product', $field, $where, '', $now);
210 //Begin barcode with key: for barcode with key (EAN13...) calculate and substitute the last character (* or ?) used in the mask by the key
211 if ((substr($numFinal, -1)=='*') or (substr($numFinal, -1)=='?')) { // if last mask character is * or ? a joker, probably we have to calculate a key as last character (EAN13...)
212 $literaltype = '';
213 $literaltype = $this->literalBarcodeType($db, $type);//get literal_Barcode_Type
214 switch ($literaltype) {
215 case 'EAN13': //EAN13 rowid = 2
216 if (strlen($numFinal)==13) {// be sure that the mask length is correct for EAN13
217 $ean = substr($numFinal, 0, 12); //take first 12 digits
218 $eansum = barcode_gen_ean_sum($ean);
219 $ean .= $eansum; //substitute the las character by the key
220 $numFinal = $ean;
221 }
222 break;
223 // Other barcode cases with key could be written here
224 default:
225 break;
226 }
227 }
228 //End barcode with key
229 return $numFinal;
230 }
231
232
247 public function verif($db, &$code, $product, $thirdparty_type, $type)
248 {
249 global $conf;
250
251 //var_dump($code.' '.$product->ref.' '.$thirdparty_type);exit;
252
253 require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
254
255 $result = 0;
256 $code = strtoupper(trim($code));
257
258 if (empty($code) && $this->code_null && !getDolGlobalString('BARCODE_STANDARD_PRODUCT_MASK')) {
259 $result = 0;
260 } elseif (empty($code) && (!$this->code_null || getDolGlobalString('BARCODE_STANDARD_PRODUCT_MASK'))) {
261 $result = -2;
262 } else {
263 if ($this->verif_syntax($code, $type) >= 0) {
264 $is_dispo = $this->verif_dispo($db, $code, $product);
265 if ($is_dispo != 0) {
266 $result = -3;
267 } else {
268 $result = 0;
269 }
270 } else {
271 if (dol_strlen($code) == 0) {
272 $result = -2;
273 } else {
274 $result = -1;
275 }
276 }
277 }
278
279 dol_syslog(get_class($this)."::verif type=".$thirdparty_type." result=".$result);
280 return $result;
281 }
282
283
284 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
293 public function verif_dispo($db, $code, $product)
294 {
295 // phpcs:enable
296 $sql = "SELECT barcode FROM ".MAIN_DB_PREFIX."product";
297 $sql .= " WHERE barcode = '".$db->escape($code)."'";
298 $sql .= " AND entity IN (".getEntity('product').")";
299
300 if ($product->id > 0) {
301 $sql .= " AND rowid <> ".$product->id;
302 }
303
304 $resql = $db->query($sql);
305 if ($resql) {
306 if ($db->num_rows($resql) == 0) {
307 return 0;
308 } else {
309 return -1;
310 }
311 } else {
312 return -2;
313 }
314 }
315
316 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
324 public function verif_syntax($codefortest, $typefortest)
325 {
326 // phpcs:enable
327 global $conf;
328
329 $result = 0;
330
331 // Get Mask value
332 $mask = !getDolGlobalString('BARCODE_STANDARD_PRODUCT_MASK') ? '' : $conf->global->BARCODE_STANDARD_PRODUCT_MASK;
333 if (!$mask) {
334 $this->error = 'NotConfigured';
335 return -1;
336 }
337
338 dol_syslog(get_class($this).'::verif_syntax codefortest='.$codefortest." typefortest=".$typefortest);
339
340 $newcodefortest = $codefortest;
341
342 // Special case, if mask is on 12 digits instead of 13, we remove last char into code to test
343 if (in_array($typefortest, array('EAN13', 'ISBN'))) { // We remove the CRC char not included into mask
344 if (preg_match('/\{(0+)([@\+][0-9]+)?([@\+][0-9]+)?\}/i', $mask, $reg)) {
345 if (strlen($reg[1]) == 12) {
346 $newcodefortest = substr($newcodefortest, 0, 12);
347 }
348 dol_syslog(get_class($this).'::verif_syntax newcodefortest='.$newcodefortest);
349 }
350 }
351
352 $result = check_value($mask, $newcodefortest);
353 if (is_string($result)) {
354 $this->error = $result;
355 return -1;
356 }
357
358 return $result;
359 }
360}
barcode_gen_ean_sum($ean)
Calculate EAN sum.
Parent class for barcode numbering models.
Class to manage barcode with standard rule.
verif_dispo($db, $code, $product)
Return if a code is used (by other element)
literalBarcodeType($db, $type='')
Return literal barcode type code from numerical rowid type of barcode.
verif($db, &$code, $product, $thirdparty_type, $type)
Check validity of code according to its rules.
getExample($langs, $objproduct=0)
Return an example of result returned by getNextValue.
verif_syntax($codefortest, $typefortest)
Return if a barcode value match syntax.
getNextValue($objproduct, $type='')
Return next value.
info($langs)
Return description of module.
check_value($mask, $value)
Check value.
get_next_value($db, $mask, $table, $field, $where='', $objsoc='', $date='', $mode='next', $bentityon=true, $objuser=null, $forceentity=null)
Return last or next value for a mask (according to area we should not reset)
dol_print_error($db='', $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
dol_strlen($string, $stringencoding='UTF-8')
Make a strlen call.
dol_now($mode='auto')
Return date for now.
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.