job_card.php

Go to the documentation of this file.

<?php
/* Copyright (C) 2017 Laurent Destailleur  <eldy@users.sourceforge.net>
 * Copyright (C) 2021 Gauthier VERDOL <gauthier.verdol@atm-consulting.fr>
 * Copyright (C) 2021 Greg Rastklan <greg.rastklan@atm-consulting.fr>
 * Copyright (C) 2021 Jean-Pascal BOUDET <jean-pascal.boudet@atm-consulting.fr>
 * Copyright (C) 2021 Grégory BLEMAND <gregory.blemand@atm-consulting.fr>
 * Copyright (C) 2024   MDW           <mdeweerd@users.noreply.github.com>
 * Copyright (C) 2024-2025  Frédéric France         <frederic.france@free.fr>
 *
 * 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/>.
 */
 
// Load Dolibarr environment
require '../main.inc.php';
 
require_once DOL_DOCUMENT_ROOT . '/core/class/html.formcompany.class.php';
require_once DOL_DOCUMENT_ROOT . '/core/class/html.formfile.class.php';
require_once DOL_DOCUMENT_ROOT . '/core/class/html.formprojet.class.php';
require_once DOL_DOCUMENT_ROOT . '/hrm/class/job.class.php';
require_once DOL_DOCUMENT_ROOT . '/hrm/lib/hrm_job.lib.php';
require_once DOL_DOCUMENT_ROOT . '/hrm/class/skillrank.class.php';
 
// Load translation files required by the page
$langs->loadLangs(array('hrm', 'other', 'products'));   // why products?
 
// Get parameters
$id = GETPOSTINT('id');
$ref = GETPOST('ref', 'alpha');
$action = GETPOST('action', 'aZ09');
$confirm = GETPOST('confirm', 'alpha');
$cancel = GETPOST('cancel');
$contextpage = GETPOST('contextpage', 'aZ') ? GETPOST('contextpage', 'aZ') : 'jobcard'; // To manage different context of search
$backtopage = GETPOST('backtopage', 'alpha');
$backtopageforcancel = GETPOST('backtopageforcancel', 'alpha');
$lineid   = GETPOSTINT('lineid');
 
// Initialize a technical objects
$object = new Job($db);
$extrafields = new ExtraFields($db);
$diroutputmassaction = $conf->hrm->dir_output . '/temp/massgeneration/' . $user->id;
$hookmanager->initHooks(array('jobcard', 'globalcard')); // Note that conf->hooks_modules contains array
 
// Fetch optionals attributes and labels
$extrafields->fetch_name_optionals_label($object->table_element);
 
$search_array_options = $extrafields->getOptionalsFromPost($object->table_element, '', 'search_');
 
// Initialize array of search criteria
$search_all = GETPOST("search_all", 'alpha');
$search = array();
foreach ($object->fields as $key => $val) {
  if (GETPOST('search_' . $key, 'alpha')) {
    $search[$key] = GETPOST('search_' . $key, 'alpha');
  }
}
 
if (empty($action) && empty($id) && empty($ref)) {
  $action = 'view';
}
 
// Load object
include DOL_DOCUMENT_ROOT . '/core/actions_fetchobject.inc.php'; // Must be 'include', not 'include_once'.
 
// Permissions
$permissiontoread = $user->hasRight('hrm', 'all', 'read');
$permissiontoadd  = $user->hasRight('hrm', 'all', 'write'); // Used by the include of actions_addupdatedelete.inc.php and actions_lineupdown.inc.php
$permissiontodelete = $user->hasRight('hrm', 'all', 'delete');
$upload_dir = $conf->hrm->multidir_output[isset($object->entity) ? $object->entity : 1] . '/job';
 
// Security check (enable the most restrictive one)
//if ($user->socid > 0) accessforbidden();
//if ($user->socid > 0) $socid = $user->socid;
//$isdraft = (($object->status == $object::STATUS_DRAFT) ? 1 : 0);
//restrictedArea($user, $object->element, $object->id, $object->table_element, '', 'fk_soc', 'rowid', $isdraft);
if (empty($conf->hrm->enabled)) {
  accessforbidden();
}
if (!$permissiontoread || ($action === 'create' && !$permissiontoadd)) {
  accessforbidden();
}
 
 
/*
 * Actions
 */
 
$parameters = array();
$reshook = $hookmanager->executeHooks('doActions', $parameters, $object, $action); // Note that $action and $object may have been modified by some hooks
if ($reshook < 0) {
  setEventMessages($hookmanager->error, $hookmanager->errors, 'errors');
}
 
if (empty($reshook)) {
  $error = 0;
 
  $backurlforlist = dol_buildpath('/hrm/job_list.php', 1);
 
  if (empty($backtopage) || ($cancel && empty($id))) {
    if (empty($backtopage) || ($cancel && strpos($backtopage, '__ID__'))) {
      if (empty($id) && (($action != 'add' && $action != 'create') || $cancel)) {   // Test on permission not required
        $backtopage = $backurlforlist;
      } else {
        $backtopage = dol_buildpath('/hrm/job_card.php', 1) . '?id=' . ($id > 0 ? $id : '__ID__');
      }
    }
  }
 
  $triggermodname = 'HRM_JOB_MODIFY'; // Name of trigger action code to execute when we modify record
 
 
  // Actions cancel, add, update, update_extras, confirm_validate, confirm_delete, confirm_deleteline, confirm_clone, confirm_close, confirm_setdraft, confirm_reopen
  if ($action != 'confirm_clone') {
    include DOL_DOCUMENT_ROOT . '/core/actions_addupdatedelete.inc.php';
  }
 
  // Actions when linking object each other
  include DOL_DOCUMENT_ROOT . '/core/actions_dellink.inc.php';
 
  // Actions when printing a doc from card
  include DOL_DOCUMENT_ROOT . '/core/actions_printing.inc.php';
 
  // Action to move up and down lines of object
  //include DOL_DOCUMENT_ROOT.'/core/actions_lineupdown.inc.php';
 
  // Action to build doc
  include DOL_DOCUMENT_ROOT . '/core/actions_builddoc.inc.php';
 
  if ($action == 'set_thirdparty' && $permissiontoadd) {
    $object->setValueFrom('fk_soc', GETPOSTINT('fk_soc'), '', null, 'date', '', $user, $triggermodname);
  }
  if ($action == 'classin' && $permissiontoadd) {
    $object->setProject(GETPOSTINT('projectid'));
  }
 
  // Actions to send emails
  $triggersendname = 'HRM_JOB_SENTBYMAIL';
  $autocopy = 'MAIN_MAIL_AUTOCOPY_JOB_TO';
  $trackid = 'job' . $object->id;
  include DOL_DOCUMENT_ROOT . '/core/actions_sendmails.inc.php';
 
  if ($action == 'confirm_clone' && $confirm != 'yes') {  // Test on permission not required
    $action = '';
  }
 
  if ($action == 'confirm_clone' && $confirm == 'yes' && ($user->hasRight('salaries', 'write'))) {
    $db->begin();
 
    $originalId = $id;
 
    $object->fetch($id);
    $skillRequire = $object->getSkillRankForJob($originalId);
    if ($object->id > 0) {
      $object->id = 0;
      $object->ref = '';
 
      if (GETPOST('clone_label', 'alphanohtml')) {
        $object->label = GETPOST('clone_label', 'alphanohtml');
      } else {
        $object->label = $langs->trans("CopyOf").' '.$object->label;
      }
      if (GETPOST('clone_skills_required')) {
        $cloneSkillRequired = GETPOST('clone_skills_required');
      }
 
      $id = $object->create($user);
      if ($id > 0) {
        if (!empty($cloneSkillRequired)) {
          $i = 0;
          while ($i < count($skillRequire)) {
            $skillrank = new SkillRank($db);
            $skillrank->createFromClone($user, $skillRequire[$i], $id);
            $i++;
          }
        }
        $db->commit();
        $db->close();
 
        header("Location: ".$_SERVER["PHP_SELF"]."?id=".$id);
        exit;
      } else {
        $id = $originalId;
        $db->rollback();
 
        setEventMessages($object->error, $object->errors, 'errors');
      }
    } else {
      $db->rollback();
      dol_print_error($db, $object->error);
    }
  }
}
 
 
/*
 * View
 *
 * Put here all code to build page
 */
 
$form = new Form($db);
$formfile = new FormFile($db);
$formproject = new FormProjets($db);
 
$title = $langs->trans("Job");
$help_url = '';
llxHeader('', $title, $help_url);
 
 
// Part to create
if ($action == 'create') {
  print load_fiche_titre($langs->trans("NewJobProfile", $langs->transnoentities('Job')), '', 'object_' . $object->picto);
 
  print '<form method="POST" action="' . $_SERVER["PHP_SELF"] . '">';
  print '<input type="hidden" name="token" value="' . newToken() . '">';
  print '<input type="hidden" name="action" value="add">';
  if ($backtopage) {
    print '<input type="hidden" name="backtopage" value="' . $backtopage . '">';
  }
  if ($backtopageforcancel) {
    print '<input type="hidden" name="backtopageforcancel" value="' . $backtopageforcancel . '">';
  }
 
  print dol_get_fiche_head(array(), '');
 
  print '<table class="border centpercent tableforfieldcreate">' . "\n";
 
  // Common attributes
  include DOL_DOCUMENT_ROOT . '/core/tpl/commonfields_add.tpl.php';
 
  // Other attributes
  include DOL_DOCUMENT_ROOT . '/core/tpl/extrafields_add.tpl.php';
 
  print '</table>' . "\n";
 
  print dol_get_fiche_end();
 
  print '<div class="center">';
  print '<input type="submit" class="button" name="add" value="' . dol_escape_htmltag($langs->trans("Create")) . '">';
  print '&nbsp; ';
  print '<input type="' . ($backtopage ? "submit" : "button") . '" class="button button-cancel" name="cancel" value="' . dol_escape_htmltag($langs->trans("Cancel")) . '"' . ($backtopage ? '' : ' onclick="history.go(-1)"') . '>'; // Cancel for create does not post form if we don't know the backtopage
  print '</div>';
 
  print '</form>';
 
  //dol_set_focus('input[name="ref"]');
}
 
// Part to edit record
if (($id || $ref) && $action == 'edit') {
  print load_fiche_titre($langs->trans("JobProfile"), '', 'object_' . $object->picto);
 
  print '<form method="POST" action="' . $_SERVER["PHP_SELF"] . '">';
  print '<input type="hidden" name="token" value="' . newToken() . '">';
  print '<input type="hidden" name="action" value="update">';
  print '<input type="hidden" name="id" value="' . $object->id . '">';
  if ($backtopage) {
    print '<input type="hidden" name="backtopage" value="' . $backtopage . '">';
  }
  if ($backtopageforcancel) {
    print '<input type="hidden" name="backtopageforcancel" value="' . $backtopageforcancel . '">';
  }
 
  print dol_get_fiche_head();
 
  print '<table class="border centpercent tableforfieldedit">' . "\n";
 
  // Common attributes
  include DOL_DOCUMENT_ROOT . '/core/tpl/commonfields_edit.tpl.php';
 
  // Other attributes
  include DOL_DOCUMENT_ROOT . '/core/tpl/extrafields_edit.tpl.php';
 
  print '</table>';
 
  print dol_get_fiche_end();
 
  print '<div class="center"><input type="submit" class="button button-save" name="save" value="' . $langs->trans("Save") . '">';
  print ' &nbsp; <input type="submit" class="button button-cancel" name="cancel" value="' . $langs->trans("Cancel") . '">';
  print '</div>';
 
  print '</form>';
}
 
// Part to show record
if ($object->id > 0 && (empty($action) || ($action != 'edit' && $action != 'create'))) {
  $res = $object->fetch_optionals();
 
  $head = jobPrepareHead($object);
  $picto = 'company.png';
  print dol_get_fiche_head($head, 'job_card', $langs->trans("Workstation"), -1, $object->picto);
 
  $formconfirm = '';
 
  // Confirmation to delete
  if ($action == 'delete') {
    $formconfirm = $form->formconfirm(dolBuildUrl($_SERVER["PHP_SELF"], ['id' => $object->id]), $langs->trans('DeleteJob'), $langs->trans('ConfirmDeleteObject'), 'confirm_delete', '', 0, 1);
  }
  // Confirmation to delete line
  if ($action == 'deleteline') {
    $formconfirm = $form->formconfirm($_SERVER["PHP_SELF"] . '?id=' . $object->id . '&lineid=' . $lineid, $langs->trans('DeleteLine'), $langs->trans('ConfirmDeleteLine'), 'confirm_deleteline', '', 0, 1);
  }
  // Clone confirmation
  if ($action == 'clone') {
    // Create an array for form
    $formquestion = array(
      array('type' => 'text', 'name' => 'clone_label', 'label' => $langs->trans("Label"), 'value' => $langs->trans("CopyOf").' '.$object->label),
      array('type' => 'checkbox', 'name' => 'clone_skills_required', 'label' => $langs->trans("RequiredSkills"), 'value' => '',),
 
    );
    $formconfirm = $form->formconfirm($_SERVER["PHP_SELF"].'?id='.$object->id, $langs->trans('ToClone'), $langs->trans('ConfirmCloneAsk', $object->label), 'confirm_clone', $formquestion, 'yes', 1, 280);
  }
 
  // Call Hook formConfirm
  $parameters = array('formConfirm' => $formconfirm, 'lineid' => $lineid);
  $reshook = $hookmanager->executeHooks('formConfirm', $parameters, $object, $action); // Note that $action and $object may have been modified by hook
  if (empty($reshook)) {
    $formconfirm .= $hookmanager->resPrint;
  } elseif ($reshook > 0) {
    $formconfirm = $hookmanager->resPrint;
  }
 
  // Print form confirm
  print $formconfirm;
 
 
  // Object card
  // ------------------------------------------------------------
  $linkback = '<a href="' . dol_buildpath('/hrm/job_list.php', 1) . '?restore_lastsearch_values=1' . (!empty($socid) ? '&socid=' . $socid : '') . '">' . $langs->trans("BackToList") . '</a>';
 
  $morehtmlref = '<div class="refid">';
  $morehtmlref .= $object->label;
  $morehtmlref .= '</div>';
 
 
  dol_banner_tab($object, 'id', $linkback, 1, 'rowid', 'rowid', $morehtmlref);
 
 
  print '<div class="fichecenter">';
  print '<div class="fichehalfleft">';
  print '<div class="underbanner clearboth"></div>';
  print '<table class="border centpercent tableforfield">'."\n";
 
  // Common attributes
  //$keyforbreak='fieldkeytoswitchonsecondcolumn';  // We change column just before this field
  //unset($object->fields['fk_project']);       // Hide field already shown in banner
  //unset($object->fields['fk_soc']);         // Hide field already shown in banner
  $object->fields['label']['visible'] = 0; // Already in banner
  include DOL_DOCUMENT_ROOT . '/core/tpl/commonfields_view.tpl.php';
 
  // Other attributes. Fields from hook formObjectOptions and Extrafields.
  include DOL_DOCUMENT_ROOT . '/core/tpl/extrafields_view.tpl.php';
 
  print '</table>';
  print '</div>';
  print '</div>';
 
  print '<div class="clearboth"></div>';
 
  print dol_get_fiche_end();
 
 
  /*
   * Lines
   */
 
  if (!empty($object->table_element_line)) {
    // Show object lines
    $result = $object->getLinesArray();
 
    print ' <form name="addproduct" id="addproduct" action="' . $_SERVER["PHP_SELF"] . '?id=' . $object->id . (($action != 'editline') ? '' : '#line_' . GETPOSTINT('lineid')) . '" method="POST">
    <input type="hidden" name="token" value="' . newToken() . '">
    <input type="hidden" name="action" value="' . (($action != 'editline') ? 'addline' : 'updateline') . '">
    <input type="hidden" name="mode" value="">
    <input type="hidden" name="page_y" value="">
    <input type="hidden" name="id" value="' . $object->id . '">
    ';
 
    if (!empty($conf->use_javascript_ajax) && $object->status == 0) {
      include DOL_DOCUMENT_ROOT . '/core/tpl/ajaxrow.tpl.php';
    }
 
    print '<div class="div-table-responsive-no-min">';
    if (!empty($object->lines) || ($object->status == $object::STATUS_DRAFT && $permissiontoadd && $action != 'selectlines' && $action != 'editline')) {
      print '<table id="tablelines" class="noborder noshadow" width="100%">';
    }
 
    if (!empty($object->lines)) {
      $object->printObjectLines($action, $mysoc, null, GETPOSTINT('lineid'), 1);
    }
 
    // Form to add new line
    if ($object->status == 0 && $permissiontoadd && $action != 'selectlines') {
      if ($action != 'editline') {
        // Add products/services form
 
        $parameters = array();
        $reshook = $hookmanager->executeHooks('formAddObjectLine', $parameters, $object, $action); // Note that $action and $object may have been modified by hook
        if ($reshook < 0) {
          setEventMessages($hookmanager->error, $hookmanager->errors, 'errors');
        }
        if (empty($reshook)) {
          $object->formAddObjectLine(1, $mysoc, $soc);
        }
      }
    }
 
    if (!empty($object->lines) || ($object->status == $object::STATUS_DRAFT && $permissiontoadd && $action != 'selectlines' && $action != 'editline')) {
      print '</table>';
    }
    print '</div>';
 
    print "</form>\n";
  }
 
 
  // Buttons for actions
 
  if ($action != 'presend' && $action != 'editline') {
    print '<div class="tabsAction">' . "\n";
    $parameters = array();
    $reshook = $hookmanager->executeHooks('addMoreActionsButtons', $parameters, $object, $action); // Note that $action and $object may have been modified by hook
    if ($reshook < 0) {
      setEventMessages($hookmanager->error, $hookmanager->errors, 'errors');
    }
 
    if (empty($reshook)) {
      // Back to draft
      if ($object->status == $object::STATUS_VALIDATED) {
        print dolGetButtonAction($langs->trans('SetToDraft'), '', 'default', $_SERVER["PHP_SELF"] . '?id=' . $object->id . '&action=confirm_setdraft&confirm=yes&token=' . newToken(), '', $permissiontoadd);
      }
 
      print dolGetButtonAction($langs->trans('Modify'), '', 'default', $_SERVER["PHP_SELF"] . '?id=' . $object->id . '&action=edit&token=' . newToken(), '', $permissiontoadd);
 
      print dolGetButtonAction($langs->trans('ToClone'), '', 'default', $_SERVER["PHP_SELF"] . '?id=' . $object->id . '&action=clone&token=' . newToken(), '', $permissiontoadd);
 
      // Delete (need delete permission, or if draft, just need create/modify permission)
      print dolGetButtonAction($langs->trans('Delete'), '', 'delete', $_SERVER['PHP_SELF'] . '?id=' . $object->id . '&action=delete&token=' . newToken(), '', $permissiontodelete);
    }
    print '</div>' . "\n";
  }
 
 
  // Select mail models is same action as presend
  if (GETPOST('modelselected')) {
    $action = 'presend';
  }
 
  if ($action != 'presend') {
    print '<div class="fichecenter"><div class="fichehalfleft">';
    print '<a name="builddoc"></a>'; // ancre
 
    $includedocgeneration = 0;
 
    // Documents
    if ($includedocgeneration) {
      $objref = dol_sanitizeFileName($object->ref);
      $relativepath = $objref . '/' . $objref . '.pdf';
      $filedir = $conf->hrm->dir_output . '/' . $object->element . '/' . $objref;
      $urlsource = $_SERVER["PHP_SELF"] . "?id=" . $object->id;
      $genallowed = $user->hasRight('hrm', 'job', 'read'); // If you can read, you can build the PDF to read content
      $delallowed = $user->hasRight('hrm', 'job', 'write'); // If you can create/edit, you can remove a file on card
      print $formfile->showdocuments('hrm:Job', $object->element . '/' . $objref, $filedir, $urlsource, $genallowed, $delallowed, $object->model_pdf, 1, 0, 0, 28, 0, '', '', '', $langs->defaultlang);
    }
 
    // Show links to link elements
    $tmparray = $form->showLinkToObjectBlock($object, array(), array('job'), 1);
    $linktoelem = $tmparray['linktoelem'];
    $htmltoenteralink = $tmparray['htmltoenteralink'];
    print $htmltoenteralink;
 
    $somethingshown = $form->showLinkedObjectBlock($object, $linktoelem);
 
    print '</div><div class="fichehalfright">';
 
    $MAXEVENT = 10;
 
    $morehtmlcenter = dolGetButtonTitle($langs->trans('SeeAll'), '', 'fa fa-bars imgforviewmode', DOL_URL_ROOT.'/hrm/job_agenda.php?id='.$object->id);
 
    // List of actions on element
    include_once DOL_DOCUMENT_ROOT . '/core/class/html.formactions.class.php';
    $formactions = new FormActions($db);
    $somethingshown = $formactions->showactions($object, $object->element . '@' . $object->module, (is_object($object->thirdparty) ? $object->thirdparty->id : 0), 1, '', $MAXEVENT, '', $morehtmlcenter);
 
    print '</div></div>';
  }
 
  // Presend form
  $modelmail = 'job';
  $defaulttopic = 'InformationMessage';
  $diroutput = $conf->hrm->dir_output;
  $trackid = 'job' . $object->id;
 
  include DOL_DOCUMENT_ROOT . '/core/tpl/card_presend.tpl.php';
}
 
// End of page
llxFooter();
$db->close();