CRM/Event/Badge.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.6                                                |
   5  +--------------------------------------------------------------------+
   6  | This file is a part of CiviCRM.                                    |
   7  |                                                                    |
   8  | CiviCRM is free software; you can copy, modify, and distribute it  |
   9  | under the terms of the GNU Affero General Public License           |
  10  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  11  |                                                                    |
  12  | CiviCRM is distributed in the hope that it will be useful, but     |
  13  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  14  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  15  | See the GNU Affero General Public License for more details.        |
  16  |                                                                    |
  17  | You should have received a copy of the GNU Affero General Public   |
  18  | License and the CiviCRM Licensing Exception along                  |
  19  | with this program; if not, contact CiviCRM LLC                     |
  20  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  21  | GNU Affero General Public License or the licensing of CiviCRM,     |
  22  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  23  +--------------------------------------------------------------------+
  24  */
  25
  26 /*
  27  * Copyright (C) 2010 Tech To The People
  28  * Licensed to CiviCRM under the Academic Free License version 3.0.
  29  *
  30  */
  31
  32 /**
  33  *
  34  * @package CRM
  35  * @copyright CiviCRM LLC (c) 2004-2015
  36  * $Id$
  37  *
  38  */
  39
  40 /**
  41  * This class print the name badges for the participants
  42  * It isn't supposed to be called directly, but is the parent class of the classes in CRM/Event/Badges/XXX.php
  43  *
  44  */
  45 class CRM_Event_Badge {
  46   /**
  47    */
  48   public function __construct() {
  49     $this->style = array(
  50       'width' => 0.1,
  51       'cap' => 'round',
  52       'join' => 'round',
  53       'dash' => '2,2',
  54       'color' => array(0, 0, 200),
  55     );
  56     $this->format = '5160';
  57     $this->imgExtension = 'png';
  58     $this->imgRes = 300;
  59     $this->event = NULL;
  60     $this->setDebug(FALSE);
  61   }
  62
  63   /**
  64    * @param bool $debug
  65    */
  66   public function setDebug($debug = TRUE) {
  67     if (!$debug) {
  68       $this->debug = FALSE;
  69       $this->border = 0;
  70     }
  71     else {
  72       $this->debug = TRUE;
  73       $this->border = "LTRB";
  74     }
  75   }
  76
  77   /**
  78    * Create the labels (pdf)
  79    * It assumes the participants are from the same event
  80    *
  81    * @param array $participants
  82    *
  83    * @return;
  84    */
  85   public function run(&$participants) {
  86     // fetch the 1st participant, and take her event to retrieve its attributes
  87     $participant = reset($participants);
  88     $eventID = $participant['event_id'];
  89     $this->event = self::retrieveEvent($eventID);
  90     //call function to create labels
  91     self::createLabels($participants);
  92     CRM_Utils_System::civiExit(1);
  93   }
  94
  95   /**
  96    * @param int $eventID
  97    *
  98    * @return CRM_Event_BAO_Event|null
  99    */
 100   protected function retrieveEvent($eventID) {
 101     $bao = new CRM_Event_BAO_Event();
 102     if ($bao->get('id', $eventID)) {
 103       return $bao;
 104     }
 105     return NULL;
 106   }
 107
 108   /**
 109    * @param int $eventID
 110    * @param bool $img
 111    *
 112    * @return string
 113    */
 114   public function getImageFileName($eventID, $img = FALSE) {
 115     global $civicrm_root;
 116     $path = "CRM/Event/Badge";
 117     if ($img == FALSE) {
 118       return FALSE;
 119     }
 120     if ($img == TRUE) {
 121       $img = get_class($this) . "." . $this->imgExtension;
 122     }
 123
 124     // CRM-13235 - leverage the Smarty path to get all templates directories
 125     $template = CRM_Core_Smarty::singleton();
 126     if (isset($template->template_dir) && $template->template_dir) {
 127       $dirs = is_array($template->template_dir) ? $template->template_dir : array($template->template_dir);
 128       foreach ($dirs as $dir) {
 129         foreach (array("$dir/$path/$eventID/$img", "$dir/$path/$img") as $imgFile) {
 130           if (file_exists($imgFile)) {
 131             return $imgFile;
 132           }
 133         }
 134       }
 135     }
 136     else {
 137       $imgFile = 'No template directories defined anywhere??';
 138     }
 139
 140     // not sure it exists, but at least will display a meaniful fatal error in debug mode
 141     return $imgFile;
 142   }
 143
 144   /**
 145    * @param bool $img
 146    */
 147   public function printBackground($img = FALSE) {
 148     $x = $this->pdf->GetAbsX();
 149     $y = $this->pdf->GetY();
 150     if ($this->debug) {
 151       $this->pdf->Rect($x, $y, $this->pdf->width, $this->pdf->height, 'D', array(
 152           'all' => array(
 153             'width' => 1,
 154             'cap' => 'round',
 155             'join' => 'round',
 156             'dash' => '2,10',
 157             'color' => array(255, 0, 0),
 158           ),
 159         ));
 160     }
 161     $img = $this->getImageFileName($this->event->id, $img);
 162     if ($img) {
 163       $imgsize = getimagesize($img);
 164       // mm
 165       $f = $this->imgRes / 25.4;
 166       $w = $imgsize[0] / $f;
 167       $h = $imgsize[1] / $f;
 168       $this->pdf->Image($img, $this->pdf->GetAbsX(), $this->pdf->GetY(), $w, $h, strtoupper($this->imgExtension), '', '', FALSE, 72, '', FALSE, FALSE, $this->debug, FALSE, FALSE, FALSE);
 169     }
 170     $this->pdf->SetXY($x, $y);
 171   }
 172
 173   /**
 174    * This is supposed to be overrided.
 175    */
 176   public function generateLabel($participant) {
 177     $txt = "{$this->event['title']}
 178 {$participant['display_name']}
 179 {$participant['current_employer']}";
 180
 181     $this->pdf->MultiCell($this->pdf->width, $this->pdf->lineHeight, $txt);
 182   }
 183
 184   public function pdfExtraFormat() {
 185   }
 186
 187   /**
 188    * Create labels (pdf)
 189    *
 190    * @param array $participants
 191    *
 192    * @return;
 193    */
 194   public function createLabels(&$participants) {
 195
 196     $this->pdf = new CRM_Utils_PDF_Label($this->format, 'mm');
 197     $this->pdfExtraFormat();
 198     $this->pdf->Open();
 199     $this->pdf->setPrintHeader(FALSE);
 200     $this->pdf->setPrintFooter(FALSE);
 201     $this->pdf->AddPage();
 202     $this->pdf->AddFont('DejaVu Sans', '', 'DejaVuSans.php');
 203     $this->pdf->SetFont('DejaVu Sans');
 204     $this->pdf->SetGenerator($this, "generateLabel");
 205
 206     foreach ($participants as $participant) {
 207       $this->pdf->AddPdfLabel($participant);
 208     }
 209     $this->pdf->Output($this->event->title . '.pdf', 'D');
 210   }
 211
 212 }