* Copyright (C) 2004-2008 Laurent Destailleur * Copyright (C) 2005-2009 Regis Houssin * Copyright (C) 2008 Raphael Bertrand (Resultic) * Copyright (C) 2013 Juanjo Menent * Copyright (C) 2020 Open-DSI * Copyright (C) 2024 Frédéric France * Copyright (C) 2024 MDW * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * or see https://www.gnu.org/ */ /** * \file htdocs/core/modules/takepos/mod_takepos_ref_universal.php * \ingroup takepos * \brief File with Universal ref numbering module for takepos */ dol_include_once('/core/modules/takepos/modules_takepos.php'); /** * Class to manage ref numbering of takepos cards with rule universal. */ class mod_takepos_ref_universal extends ModeleNumRefTakepos { /** * Dolibarr version of the loaded document 'development', 'experimental', 'dolibarr' * @var string Version, possible values are: 'development', 'experimental', 'dolibarr', 'dolibarr_deprecated' or a version string like 'x.y.z'''|'development'|'dolibarr'|'experimental' */ public $version = 'dolibarr'; /** * @var string Error code (or message) */ public $error = ''; /** * Name * @var string */ public $nom = 'Universal'; /** * return description of the numbering model * * @param Translate $langs Lang object to use for output * @return string Descriptive text */ public function info($langs) { global $db, $langs; $langs->load('cashdesk@cashdesk'); $form = new Form($db); $texte = $langs->trans('GenericNumRefModelDesc')."
\n"; $texte .= '

'; $texte .= ''; $texte .= ''; $texte .= ''; $texte .= ''; $tooltip = $langs->trans('GenericMaskCodes', $langs->transnoentities('CashDesk'), $langs->transnoentities('CashDesk')); $tooltip .= $langs->trans('GenericMaskCodes2'); $tooltip .= $langs->trans('GenericMaskCodes3'); $tooltip .= $langs->trans('GenericMaskCodes4a', $langs->transnoentities('CashDesk'), $langs->transnoentities('CashDesk')); $tooltip .= $langs->trans('GenericMaskCodes5'); //$tooltip .= '
'.$langs->trans("GenericMaskCodes5b"); $tooltip .= $langs->trans('CashDeskGenericMaskCodes6'); // Setting up the prefix $texte .= ''; $texte .= ''; $texte .= ''; $texte .= ''; $texte .= '

'.$langs->trans("Mask").':

'.$form->textwithpicto('', $tooltip, 1, 'help', 'valignmiddle', 0, 3, $this->name).'

'; $texte .= '

'; return $texte; } /** * Return an example of numbering * * @return string Example */ public function getExample() { global $langs, $mysoc; $old_code_client = $mysoc->code_client; $mysoc->code_client = 'CCCCCCCCCC'; $numExample = $this->getNextValue($mysoc, null); $mysoc->code_client = $old_code_client; if (!$numExample) { $numExample = $langs->trans('NotConfigured'); } return $numExample; } /** * Return next free value * * @param ?Societe $objsoc Object third party * @param ?Facture $invoice Object invoice * @param string $mode 'next' for next value or 'last' for last value * @return string|int<-1,0> Next ref value or last ref if $mode is 'last' */ public function getNextValue($objsoc = null, $invoice = null, $mode = 'next') { global $db; require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php'; // We define search criteria counter $mask = getDolGlobalString('TAKEPOS_REF_UNIVERSAL_MASK'); if (!$mask) { $this->error = 'NotConfigured'; return 0; } // Get entities $entity = getEntity('invoicenumber', 1, $invoice); $date = (empty($invoice->date) ? dol_now() : $invoice->date); $pos_source = is_object($invoice) && $invoice->pos_source > 0 ? $invoice->pos_source : 0; $mask = str_replace('{TN}', (string) $pos_source, $mask); $numFinal = get_next_value($db, $mask, 'facture', 'ref', '', $objsoc, $date, $mode, false, null, $entity); return $numFinal; } /** * Return next free value * * @param Societe $objsoc Object third party * @param Facture $objforref Object for number to search * @return string Next free value * @deprecated see getNextValue */ public function getNumRef($objsoc, $objforref) { return $this->getNextValue($objsoc, $objforref); } }