mod_project_universal.php

Go to the documentation of this file.

<?php
/* Copyright (C) 2010       Regis Houssin               <regis.houssin@inodbox.com>
 * Copyright (C) 2024-2025  Frédéric France             <frederic.france@free.fr>
 * Copyright (C) 2024   MDW             <mdeweerd@users.noreply.github.com>
 *
 * 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 <https://www.gnu.org/licenses/>.
 * or see https://www.gnu.org/
 */
 
require_once DOL_DOCUMENT_ROOT.'/core/modules/project/modules_project.php';
 
 
class mod_project_universal extends ModeleNumRefProjects
{
  public $db;
 
  public $version = 'dolibarr'; // 'development', 'experimental', 'dolibarr'
 
  public $error = '';
 
  public $position = 20;
 
  public $name = 'Universal';
 
 
  public function info($langs)
  {
    global $langs;
 
    // Load translation files required by the page
    $langs->loadLangs(array("projects", "admin"));
 
    $form = new Form($this->db);
 
    $texte = $langs->trans('GenericNumRefModelDesc')."<br>\n";
    $texte .= '<form action="'.$_SERVER["PHP_SELF"].'" method="POST">';
    $texte .= '<input type="hidden" name="token" value="'.newToken().'">';
    $texte .= '<input type="hidden" name="action" value="updateMask">';
    $texte .= '<input type="hidden" name="maskconstproject" value="PROJECT_UNIVERSAL_MASK">';
    $texte .= '<input type="hidden" name="page_y" value="">';
 
    $texte .= '<table class="nobordernopadding centpercent">';
 
    $tooltip = $langs->trans("GenericMaskCodes", $langs->transnoentities("Project"), $langs->transnoentities("Project"));
    $tooltip .= $langs->trans("GenericMaskCodes1");
    $tooltip .= $langs->trans("GenericMaskCodes2");
    $tooltip .= $langs->trans("GenericMaskCodes3");
    $tooltip .= $langs->trans("GenericMaskCodes4a", $langs->transnoentities("Project"), $langs->transnoentities("Project"));
    $tooltip .= $langs->trans("GenericMaskCodes5");
    $tooltip .= '<br>'.$langs->trans("GenericMaskCodes5b");
 
    // Prefix settings
    $texte .= '<tr><td>'.$langs->trans("Mask").':</td>';
    $texte .= '<td class="right">'.$form->textwithpicto('<input type="text" class="flat minwidth175" name="maskproject" value="'.getDolGlobalString('PROJECT_UNIVERSAL_MASK').'">', $tooltip, 1, 'help', 'valignmiddle', 0, 3, $this->name).'</td>';
 
    $texte .= '<td class="left" rowspan="2">&nbsp; <input type="submit" class="button button-edit reposition smallpaddingimp" name="Button" value="'.$langs->trans("Save").'"></td>';
 
    $texte .= '</tr>';
 
    $texte .= '</table>';
    $texte .= '</form>';
 
    return $texte;
  }
 
  public function getExample()
  {
    global $db, $langs;
 
    require_once DOL_DOCUMENT_ROOT . '/projet/class/project.class.php';
    require_once DOL_DOCUMENT_ROOT . '/societe/class/societe.class.php';
 
    $project = new Project($db);
    $project->initAsSpecimen();
    $thirdparty = new Societe($db);
    $thirdparty->initAsSpecimen();
 
    $numExample = $this->getNextValue($thirdparty, $project);
 
    if (!$numExample) {
      $numExample = $langs->trans('NotConfigured');
    }
 
    return $numExample;
  }
 
  public function getNextValue($objsoc, $project)
  {
    global $db, $langs;
 
    require_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
 
    // We define criterion search counter
    $mask = getDolGlobalString('PROJECT_UNIVERSAL_MASK');
 
    if (!$mask) {
      $this->error = $langs->trans('NotConfigured');
      return 0;
    }
 
    // Get entities
    $entity = getEntity('projectnumber', 1, $project);
 
    $date = (empty($project->date_c) ? dol_now() : $project->date_c);
    $numFinal = get_next_value($db, $mask, 'projet', 'ref', '', (is_object($objsoc) ? $objsoc : ''), $date, 'next', false, null, $entity);
 
    return  $numFinal;
  }
}