html_cerfafr.modules.php

Go to the documentation of this file.

<?php
/* Copyright (C) 2003   Rodolphe Quiedeville  <rodolphe@quiedeville.org>
 * Copyright (C) 2005-2006  Laurent Destailleur   <eldy@users.sourceforge.net>
 * Copyright (C) 2012   Regis Houssin     <regis.houssin@inodbox.com>
 * Copyright (C) 2012       Marcos García           <marcosgdf@gmail.com>
 * Copyright (C) 2014-2020  Alexandre Spangaro    <aspangaro@open-dsi.fr>
 * Copyright (C) 2015     Benoit Bruchard     <benoitb21@gmail.com>
 * Copyright (C) 2024-2026  MDW           <mdeweerd@users.noreply.github.com>
 * Copyright (C) 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/>.
 */
 
require_once DOL_DOCUMENT_ROOT.'/core/modules/dons/modules_don.php';
require_once DOL_DOCUMENT_ROOT.'/don/class/don.class.php';
require_once DOL_DOCUMENT_ROOT.'/societe/class/societe.class.php';
require_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
 
 
class html_cerfafr extends ModeleDon
{
  public function __construct($db)
  {
    global $langs;
 
    $this->db = $db;
    $this->name = "cerfafr";
    $this->description = $langs->trans('DonationsReceiptModel').' - fr_FR - Cerfa 11580*04';
 
    // Dimension page for size A4
    $this->type = 'html';
  }
 
 
  public function isEnabled()
  {
    return true;
  }
 
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function write_file($don, $outputlangs, $currency = '')
  {
    // phpcs:enable
    global $user, $conf, $langs, $mysoc;
 
    $now = dol_now();
    $id = (!is_object($don) ? $don : '');
 
    if (!is_object($outputlangs)) {
      $outputlangs = $langs;
    }
 
    // Load traductions files required by page
    $outputlangs->loadLangs(array("main", "dict", "companies", "bills", "products", "donations"));
 
    $currency = !empty($currency) ? $currency : $conf->currency;
 
    if (!empty($conf->don->dir_output)) {
      // Definition of the object don (for upward compatibility)
      if (!is_object($don)) {
        $don = new Don($this->db);
        $ret = $don->fetch($id);
        $id = $don->id;
      }
 
      // Definition of $dir and $file
      if (!empty($don->specimen)) {
        $dir = $conf->don->dir_output;
        $file = $dir."/SPECIMEN.html";
      } else {
        $donref = dol_sanitizeFileName((string) $don->ref);
        $dir = $conf->don->dir_output."/".$donref;
        $file = $dir."/".$donref.".html";
      }
 
      if (!file_exists($dir)) {
        if (dol_mkdir($dir) < 0) {
          $this->error = $langs->trans("ErrorCanNotCreateDir", $dir);
          return -1;
        }
      }
 
      if (file_exists($dir)) {
        $formclass = new Form($this->db);
 
        // This is not the proper way to do it but $formclass->form_modes_reglement
        // prints the translation instead of returning it
        $formclass->load_cache_types_paiements();
        // Don::fetch() stores the payment mode into mode_reglement_id. The modepaymentid property is only
        // set by the create/update forms, so it is always empty when the document is built from a fetched
        // donation and no payment mode checkbox was ever ticked on the receipt.
        $modepaymentid = !empty($don->mode_reglement_id) ? $don->mode_reglement_id : $don->modepaymentid;
        if ($modepaymentid) {
          $paymentmode = !empty($formclass->cache_types_paiements[(int) $modepaymentid]['label']) ? $formclass->cache_types_paiements[$modepaymentid]['label'] : '';
        } else {
          $paymentmode = '';
        }
        $modepaymentcode = !empty($formclass->cache_types_paiements[(int) $modepaymentid]['code']) ? $formclass->cache_types_paiements[(int) $modepaymentid]['code'] : "";
        if ($modepaymentcode == 'CHQ') {
          $ModePaiement = '<td width="25%"><input type="checkbox"> Remise d\'espèces</td><td width="25%"><input type="checkbox" disabled="true" checked="checked"> Chèque</td><td width="50%"><input type="checkbox"> Virement, prélèvement, carte bancaire</td>';
        } elseif ($modepaymentcode == 'LIQ') {
          $ModePaiement = '<td width="25%"><input type="checkbox" checked="checked"> Remise d\'espèces</td><td width="25%"><input type="checkbox"> Chèque</td><td width="50%"><input type="checkbox"> Virement, prélèvement, carte bancaire</td>';
        } elseif ($modepaymentcode == 'VIR' || $modepaymentcode == 'PRE' || $modepaymentcode == 'CB') {
          $ModePaiement = '<td width="25%"><input type="checkbox"> Remise d\'espèces</td><td width="25%"><input type="checkbox"> Chèque</td><td width="50%"><input type="checkbox" checked="checked"> Virement, prélèvement, carte bancaire</td>';
        } else {
          $ModePaiement = '<td width="25%"><input type="checkbox"> Remise d\'espèces</td><td width="25%"><input type="checkbox"> Chèque</td><td width="50%"><input type="checkbox"> Virement, prélèvement, carte bancaire</td>';
        }
 
        /*
        if (empty($don->societe))
        {
          $CodeDon = '<td width="33%"><input type="checkbox" disabled="true" checked="checked" > 200 du CGI</td><td width="33%"><input type="checkbox" disabled="true" > 238 bis du CGI</td><td width="33%"><input type="checkbox" disabled="true" > 978 du CGI</td>';
        }
        else
        {
          $CodeDon = '<td width="33%"><input type="checkbox" disabled="true" > 200 du CGI</td><td width="33%"><input type="checkbox" disabled="true" checked="checked" > 238 bis du CGI</td><td width="33%"><input type="checkbox" disabled="true" > 978 du CGI</td>';
        }
        */
        // Donator identity.
        // When option DONATION_USE_THIRDPARTIES is on, the donation form does not show the name/address
        // inputs at all, so llx_don only holds fk_soc and every donator field stays empty. The receipt
        // would then be issued without the mandatory identity of the donator, so fall back on the linked
        // third party for each field left empty.
        $donatorsociete = (string) $don->societe;
        $donatorlastname = (string) $don->lastname;
        $donatorfirstname = (string) $don->firstname;
        $donatoraddress = (string) $don->address;
        $donatorzip = (string) $don->zip;
        $donatortown = (string) $don->town;
 
        if (!empty($don->socid) && $don->socid > 0) {
          $donatorthirdparty = new Societe($this->db);
          if ($donatorthirdparty->fetch($don->socid) > 0) {
            if (dol_strlen(trim($donatorsociete.$donatorlastname.$donatorfirstname)) == 0) {
              // A third party holds a single name field, even for a private individual, so it goes
              // to the "Name" cell of the form and the "Firstname" cell is left empty.
              $donatorsociete = (string) $donatorthirdparty->name;
            }
            if (dol_strlen(trim($donatoraddress)) == 0) {
              $donatoraddress = (string) $donatorthirdparty->address;
            }
            if (dol_strlen(trim($donatorzip)) == 0) {
              $donatorzip = (string) $donatorthirdparty->zip;
            }
            if (dol_strlen(trim($donatortown)) == 0) {
              $donatortown = (string) $donatorthirdparty->town;
            }
          } else {
            dol_syslog("html_cerfafr::write_file Failed to load thirdparty ".$don->socid." linked to donation ".$don->id.", donator block will remain empty - ".$donatorthirdparty->error, LOG_ERR);
          }
        }
 
        if (dol_strlen(trim($donatorsociete.$donatorlastname.$donatorfirstname)) == 0) {
          dol_syslog("html_cerfafr::write_file No name found for the donator of donation ".$don->id.", the receipt will not be compliant", LOG_WARNING);
        }
 
        // Define contents
        $donmodel = DOL_DOCUMENT_ROOT."/core/modules/dons/html_cerfafr.html";
 
        $form = file_get_contents($donmodel);
 
        $form = str_replace('__REF__', (string) $don->id, $form);
        $form = str_replace('__DATE__', dol_print_date($don->date, 'day', false, $outputlangs), $form);
        //$form = str_replace('__IP__',$user->ip,$form); // TODO $user->ip not exist
        $form = str_replace('__AMOUNT__', price($don->amount), $form);
        $form = str_replace('__AMOUNTLETTERS__', $this->amountToLetters($don->amount), $form);
        $form = str_replace('__CURRENCY__', $outputlangs->transnoentitiesnoconv("Currency".$currency), $form);
        $form = str_replace('__CURRENCYCODE__', $conf->currency, $form);
        $form = str_replace('__MAIN_INFO_SOCIETE_NOM__', (string) $mysoc->name, $form);
        $form = str_replace('__MAIN_INFO_SOCIETE_ADDRESS__', (string) $mysoc->address, $form);
        $form = str_replace('__MAIN_INFO_SOCIETE_ZIP__', (string) $mysoc->zip, $form);
        $form = str_replace('__MAIN_INFO_SOCIETE_TOWN__', (string) $mysoc->town, $form);
 
        $form = str_replace('__MAIN_INFO_SOCIETE_OBJECT__', (string) $mysoc->socialobject, $form);
 
        $form = str_replace('__DONATOR_FIRSTNAME__', dol_escape_htmltag($donatorfirstname), $form);
        // The template concatenates __DONATOR_SOCIETE__ and __DONATOR_LASTNAME__ with no separator,
        // so add a line break when both are filled in.
        $donatorlastnameprefix = (dol_strlen(trim($donatorsociete)) > 0 && dol_strlen(trim($donatorlastname)) > 0) ? '<br>' : '';
        $form = str_replace('__DONATOR_LASTNAME__', $donatorlastnameprefix.dol_escape_htmltag($donatorlastname), $form);
        $form = str_replace('__DONATOR_SOCIETE__', dol_escape_htmltag($donatorsociete), $form);
 
        $form = str_replace('__DONATOR_STATUT__', (string) $don->statut, $form);
        $form = str_replace('__DONATOR_ADDRESS__', dol_nl2br(dol_escape_htmltag($donatoraddress, 0, 1)), $form);
        $form = str_replace('__DONATOR_ZIP__', dol_escape_htmltag($donatorzip), $form);
        $form = str_replace('__DONATOR_TOWN__', dol_escape_htmltag($donatortown), $form);
 
        $form = str_replace('__PAYMENTMODE_LIB__ ', (string) $paymentmode, $form);
        $form = str_replace('__NOW__', dol_print_date($now, 'day', false, $outputlangs), $form);
        $form = str_replace('__DONATION_PAYMENT_MODE__', $ModePaiement, $form);
        $form = str_replace('__DONATION_MESSAGE__', getDolGlobalString('DONATION_MESSAGE'), $form);
 
        // Replace with a generic replacement feature '__(XXX)__' must become $outputlangs->trans('XXX')
        $form = make_substitutions($form, array(), $outputlangs);
 
        $frencharticle = '';
        if (preg_match('/fr/i', $outputlangs->defaultlang)) {
          $frencharticle = '<font size="+1">Article 200, 238 bis et 978 du code général des impôts (CGI)</font>';
        }
        $form = str_replace('__FrenchArticle__', $frencharticle, $form);
 
        $frencheligibility = '';
        if (preg_match('/fr/i', $outputlangs->defaultlang)) {
          $frencheligibility = 'Le bénéficiaire certifie sur l\'honneur que les dons et versements qu\'il reçoit ouvrent droit à la réduction d\'impôt prévue à l\'article :';
        }
        $form = str_replace('__FrenchEligibility__', $frencheligibility, $form);
 
        $art200 = '';
        if ($mysoc->country_code == 'FR') {
          if (getDolGlobalInt('DONATION_ART200') >= 1) {
            $art200 = '<input type="checkbox" disabled="true" checked="checked" >200 du CGI';
          } else {
            $art200 = '<input type="checkbox" disabled="true">200 du CGI';
          }
        }
        $form = str_replace('__ARTICLE200__', $art200, $form);
 
        $art238 = '';
        if ($mysoc->country_code == 'FR') {
          if (getDolGlobalInt('DONATION_ART238') >= 1) {
            $art238 = '<input type="checkbox" disabled="true" checked="checked" >238 bis du CGI';
          } else {
            $art238 = '<input type="checkbox" disabled="true">238 bis du CGI';
          }
        }
        $form = str_replace('__ARTICLE238__', $art238, $form);
 
        $art978 = '';
        if ($mysoc->country_code == 'FR') {
          if (getDolGlobalInt('DONATION_ART978') >= 1) {
            $art978 = '<input type="checkbox" disabled="true" checked="checked" >978 du CGI';
          } else {
            $art978 = '<input type="checkbox" disabled="true">978 du CGI';
          }
        }
        $form = str_replace('__ARTICLE978__', $art978, $form);
 
        // Save file on disk
        dol_syslog("html_cerfafr::write_file $file");
        $handle = fopen($file, "w");
        fwrite($handle, $form);
        fclose($handle);
        dolChmod($file);
 
        $this->result = array('fullpath' => $file);
 
        return 1;
      } else {
        $this->error = $langs->trans("ErrorCanNotCreateDir", $dir);
        return 0;
      }
    } else {
      $this->error = $langs->trans("ErrorConstantNotDefined", "DON_OUTPUTDIR");
      return 0;
    }
  }
 
  private function amountToLetters($amount, $devise1 = '', $devise2 = '')
  {
    $unite = array();
    $dix = array();
    $cent = array();
    if (empty($devise1)) {
      $dev1 = 'euros';
    } else {
      $dev1 = $devise1;
    }
    if (empty($devise2)) {
      $dev2 = 'centimes';
    } else {
      $dev2 = $devise2;
    }
    $integerAmount = intval($amount);
    $fractionalAmount = intval(round($amount - intval($amount), 2) * 100);
    $dix_c = intval($fractionalAmount % 100 / 10);
    $cent_c = intval($fractionalAmount % 1000 / 100);
    $unite[1] = $integerAmount % 10;
    $dix[1] = intval($integerAmount % 100 / 10);
    $cent[1] = intval($integerAmount % 1000 / 100);
    $unite[2] = intval($integerAmount % 10000 / 1000);
    $dix[2] = intval($integerAmount % 100000 / 10000);
    $cent[2] = intval($integerAmount % 1000000 / 100000);
    $unite[3] = intval($integerAmount % 10000000 / 1000000);
    $dix[3] = intval($integerAmount % 100000000 / 10000000);
    $cent[3] = intval($integerAmount % 1000000000 / 100000000);
    $chif = array('', 'un', 'deux', 'trois', 'quatre', 'cinq', 'six', 'sept', 'huit', 'neuf', 'dix', 'onze', 'douze', 'treize', 'quatorze', 'quinze', 'seize', 'dix sept', 'dix huit', 'dix neuf');
    $secon_c = '';
    $trio_c = '';
    $prim = array();
    $secon = array();
    $trio = array();
    // @phpstan-ignore-next-line
    '@phan-var string[] $prim
     @phan-var string[] $secon
     @phan-var string[] $trio
    ';
    for ($i = 1; $i <= 3; $i++) {
      $prim[$i] = '';
      $secon[$i] = '';
      $trio[$i] = '';
      if ($dix[$i] == 0) {
        $secon[$i] = '';
        $prim[$i] = $chif[$unite[$i]];
      } elseif ($dix[$i] == 1) {
        $secon[$i] = '';
        $prim[$i] = $chif[($unite[$i] + 10)];
      } elseif ($dix[$i] == 2) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'vingt et';
          $prim[$i] = $chif[$unite[$i]];
        } else {
          $secon[$i] = 'vingt';
          $prim[$i] = $chif[$unite[$i]];
        }
      } elseif ($dix[$i] == 3) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'trente et';
          $prim[$i] = $chif[$unite[$i]];
        } else {
          $secon[$i] = 'trente';
          $prim[$i] = $chif[$unite[$i]];
        }
      } elseif ($dix[$i] == 4) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'quarante et';
          $prim[$i] = $chif[$unite[$i]];
        } else {
          $secon[$i] = 'quarante';
          $prim[$i] = $chif[$unite[$i]];
        }
      } elseif ($dix[$i] == 5) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'cinquante et';
          $prim[$i] = $chif[$unite[$i]];
        } else {
          $secon[$i] = 'cinquante';
          $prim[$i] = $chif[$unite[$i]];
        }
      } elseif ($dix[$i] == 6) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'soixante et';
          $prim[$i] = $chif[$unite[$i]];
        } else {
          $secon[$i] = 'soixante';
          $prim[$i] = $chif[$unite[$i]];
        }
      } elseif ($dix[$i] == 7) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'soixante et';
          $prim[$i] = $chif[$unite[$i] + 10];
        } else {
          $secon[$i] = 'soixante';
          $prim[$i] = $chif[$unite[$i] + 10];
        }
      } elseif ($dix[$i] == 8) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'quatre-vingts et';
          $prim[$i] = $chif[$unite[$i]];
        } else {
          $secon[$i] = 'quatre-vingt';
          $prim[$i] = $chif[$unite[$i]];
        }
      } elseif ($dix[$i] == 9) {
        if ($unite[$i] == 1) {
          $secon[$i] = 'quatre-vingts et';
          $prim[$i] = $chif[$unite[$i] + 10];
        } else {
          $secon[$i] = 'quatre-vingts';
          $prim[$i] = $chif[$unite[$i] + 10];
        }
      }
      if ($cent[$i] == 1) {
        $trio[$i] = 'cent';
      } elseif ($cent[$i] != 0 || $cent[$i] != '') {
        $trio[$i] = $chif[$cent[$i]].' cents';
      }
    }
 
 
    $chif2 = array('', 'dix', 'vingt', 'trente', 'quarante', 'cinquante', 'soixante', 'soixante-dix', 'quatre-vingts', 'quatre-vingts dix');
    $secon_c = $chif2[$dix_c];
    if ($cent_c == 1) {
      $trio_c = 'cent';
    } elseif ($cent_c != 0 || $cent_c != '') {
      $trio_c = $chif[$cent_c].' cents';
    }
 
    if (($cent[3] == 0 || $cent[3] == '') && ($dix[3] == 0 || $dix[3] == '') && ($unite[3] == 1)) {
      $somme = $trio[3].'  '.$secon[3].' '.$prim[3].' million ';
    } elseif (($cent[3] != 0 && $cent[3] != '') || ($dix[3] != 0 && $dix[3] != '') || ($unite[3] != 0 && $unite[3] != '')) {
      $somme = $trio[3].' '.$secon[3].' '.$prim[3].' millions ';
    } else {
      $somme = $trio[3].' '.$secon[3].' '.$prim[3];
    }
 
    if (($cent[2] == 0 || $cent[2] == '') && ($dix[2] == 0 || $dix[2] == '') && ($unite[2] == 1)) {
      $somme .= ' mille ';
    } elseif (($cent[2] != 0 && $cent[2] != '') || ($dix[2] != 0 && $dix[2] != '') || ($unite[2] != 0 && $unite[2] != '')) {
      $somme .= $trio[2].' '.$secon[2].' '.$prim[2].' milles ';
    } else {
      $somme .= $trio[2].' '.$secon[2].' '.$prim[2];
    }
 
    $somme .= $trio[1].' '.$secon[1].' '.$prim[1];
 
    $somme .= ' '.$dev1.' ';
 
    if (($cent_c == '0' || $cent_c == '') && ($dix_c == '0' || $dix_c == '')) {
      return $somme.' et z&eacute;ro '.$dev2;
    } else {
      return $somme.$trio_c.' '.$secon_c.' '.$dev2;
    }
  }
}