event-message.php

<?php
/*
 * Copyright (C) 2024 Anthony Damhet <a.damhet@progiseize.fr>
 *
 * This program and files/directory inner it is free software: you can
 * redistribute it and/or modify it under the terms of the
 * GNU Affero General Public License (AGPL) 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 AGPL for more details.
 *
 * You should have received a copy of the GNU AGPL
 * along with this program. If not, see <https://www.gnu.org/licenses/agpl-3.0.html>.
 */
 
$res=0;
if (! $res && file_exists("../../main.inc.php")) : $res=@include '../../main.inc.php';
endif;
if (! $res && file_exists("../../../main.inc.php")) : $res=@include '../../../main.inc.php';
endif;
if (! $res && file_exists("../../../../main.inc.php")) : $res=@include '../../../../main.inc.php';
endif;
 
 
// Protection if external user
if ($user->socid > 0) : accessforbidden();
endif;
 
// Includes
dol_include_once('admin/tools/ui/class/documentation.class.php');
 
// Load documentation translations
$langs->load('uxdocumentation');
 
$action = GETPOST('action', 'alpha');
 
if ($action == 'displayeventmessage') {
  setEventMessages($langs->trans('DocSetEventMessageUnique'), null);
} elseif ($action == 'displayeventmessages') {
  $messageArray = [$langs->trans('DocSetEventMessage', '1'),
          $langs->trans('DocSetEventMessage', '2'),
          $langs->trans('DocSetEventMessage', '3')];
  setEventMessages(null, $messageArray);
} elseif ($action == 'displayeventmessageok') {
  setEventMessages($langs->trans('DocSetEventMessageOK'), null);
} elseif ($action == 'displayeventmessagewarning') {
  setEventMessages($langs->trans('DocSetEventMessageWarning'), null, 'warnings');
} elseif ($action == 'displayeventmessageerror') {
  setEventMessages($langs->trans('DocSetEventMessageError'), null, 'errors');
}
 
//
$documentation = new Documentation($db);
 
// Output html head + body - Param is Title
$documentation->docHeader('SetEventMessages');
 
// Set view for menu and breadcrumb
// Menu must be set in constructor of documentation class
$documentation->view = array('Components','Event Message');
 
// Output sidebar
$documentation->showSidebar(); ?>
 
<div class="doc-wrapper">
 
  <?php $documentation->showBreadCrumb(); ?>
 
  <div class="doc-content-wrapper">
 
    <h1 class="documentation-title"><?php echo $langs->trans('DocSetEventMessageTitle'); ?></h1>
    <p class="documentation-text"><?php echo $langs->trans('DocSetEventMessageMainDescription'); ?></p>
 
    <!-- Summary -->
    <?php $documentation->showSummary(); ?>
 
    <!-- Basic usage -->
    <div class="documentation-section" id="seteventmessagesection-basicusage">
      <h2 class="documentation-title"><?php echo $langs->trans('DocBasicUsage'); ?></h2>
      <p class="documentation-text"><?php echo $langs->trans('DocSetEventMessageDescription'); ?></p>
      <div class="documentation-example">
        <?php
          $label = 'My action label used for accessibility visually for impaired people';
          $user_right = 1;
 
          $html = '<span class="fa fa-comment paddingright"></span>'.$langs->trans('DocSetEventMessageDisplayMessage');
          $action_type = 'displayeventmessage';
          $url = $_SERVER["PHP_SELF"].'?action=displayeventmessage';
          print dolGetButtonAction($label, $html, $action_type, $url, '', $user_right);
 
          $label = 'My action label used for accessibility visually for impaired people';
          $user_right = 1;
 
          $html = '<span class="fa fa-comments paddingright"></span>'.$langs->trans('DocSetEventMessageDisplayMessages');;
          $action_type = 'displayeventmessages';
          $url = $_SERVER["PHP_SELF"].'?action=displayeventmessages';
          print dolGetButtonAction($label, $html, $action_type, $url, '', $user_right); ?>
      </div>
      <?php
      $lines = array(
          '<?php',
          '
',
          '',
          'setEventMessages("message", null);',
          'setEventMessages(null, messages[]);',
      );
      echo $documentation->showCode($lines); ?>
    </div>
 
    <!-- Contextual variations -->
    <div class="documentation-section" id="seteventmessagesection-contextvariations">
      <h2 class="documentation-title"><?php echo $langs->trans('DocSetEventMessageContextualVariations'); ?></h2>
      <p class="documentation-text"><?php echo $langs->trans('DocSetEventMessageContextualVariationsDescription'); ?></p>
      <div class="documentation-example">
        <?php
        $label = 'My action label used for accessibility visually for impaired people';
        $user_right = 1;
        $html = '<span class="fa fa-comment paddingright"></span>'.$langs->trans('DocSetEventMessageDisplayOKMessage');;
        $action_type = 'displayeventmessageok';
        $url = $_SERVER["PHP_SELF"].'?action=displayeventmessageok#seteventmessagesection-contextvariations';
        $params['attr']['style'] = 'background: #446548';
        print dolGetButtonAction('', $html, $action_type, $url, '', $user_right, $params);
 
        $label = 'My action label used for accessibility visually for impaired people';
        $user_right = 1;
        $html = '<span class="fa fa-comment paddingright"></span>'.$langs->trans('DocSetEventMessageDisplayWarningMessage');;
        $action_type = 'displayeventmessagewarning';
        $url = $_SERVER["PHP_SELF"].'?action=displayeventmessagewarning#seteventmessagesection-contextvariations';
        $params['attr']['style'] = 'background: #a28918';
        print dolGetButtonAction($label, $html, $action_type, $url, '', $user_right, $params);
 
        $label = 'My action label used for accessibility visually for impaired people';
        $user_right = 1;
        $html = '<span class="fa fa-comment paddingright"></span>'.$langs->trans('DocSetEventMessageDisplayErrorMessage');;
        $action_type = 'displayeventmessageerror';
        $url = $_SERVER["PHP_SELF"].'?action=displayeventmessageerror#seteventmessagesection-contextvariations';
        $params['attr']['style'] = 'background: #a72947';
        print dolGetButtonAction($label, $html, $action_type, $url, '', $user_right, $params); ?>
      </div>
      <?php
      $lines = array(
        'setEventMessages("message", null)',
        'setEventMessages("message", null, "warnings")',
        'setEventMessages("message", null, "errors")'
      );
      echo $documentation->showCode($lines); ?>
    </div>
    <!--  -->
  </div>
 
</div>
 
<?php
// Output close body + html
$documentation->docFooter();
 
?>