galette/lib/Galette/Filters/MembersList.php

   1 <?php
   2
   3 /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
   4
   5 /**
   6  * Members list filters and paginator
   7  *
   8  * PHP version 5
   9  *
  10  * Copyright © 2009-2014 The Galette Team
  11  *
  12  * This file is part of Galette (http://galette.tuxfamily.org).
  13  *
  14  * Galette is free software: you can redistribute it and/or modify
  15  * it under the terms of the GNU General Public License as published by
  16  * the Free Software Foundation, either version 3 of the License, or
  17  * (at your option) any later version.
  18  *
  19  * Galette is distributed in the hope that it will be useful,
  20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22  *  GNU General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU General Public License
  25  * along with Galette. If not, see <http://www.gnu.org/licenses/>.
  26  *
  27  * @category  Filters
  28  * @package   Galette
  29  *
  30  * @author    Johan Cwiklinski <johan@x-tnd.be>
  31  * @copyright 2009-2014 The Galette Team
  32  * @license   http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or (at your option) any later version
  33  * @link      http://galette.tuxfamily.org
  34  * @since     march, 3rd 2009
  35  */
  36
  37 namespace Galette\Filters;
  38
  39 use Analog\Analog;
  40 use Galette\Core\Pagination;
  41 use Galette\Entity\Group;
  42 use Galette\Repository\Members;
  43
  44 /**
  45  * Members list filters and paginator
  46  *
  47  * @name      MembersList
  48  * @category  Filters
  49  * @package   Galette
  50  *
  51  * @author    Johan Cwiklinski <johan@x-tnd.be>
  52  * @copyright 2009-2014 The Galette Team
  53  * @license   http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or (at your option) any later version
  54  * @link      http://galette.tuxfamily.org
  55  *
  56  * @property string $filter_str
  57  * @property string $field_filter
  58  * @property string $membership_filter
  59  * @property integer $filter_account
  60  * @property string $email_filter
  61  * @property integer $group_filter
  62  * @property array $selected
  63  * @property array $unreachable
  64  * @property string $query
  65  */
  66
  67 class MembersList extends Pagination
  68 {
  69     //filters
  70     private $_filter_str;
  71     private $_field_filter;
  72     private $_membership_filter;
  73     private $_filter_account;
  74     private $_email_filter;
  75     private $_group_filter;
  76
  77     private $_selected;
  78     private $_unreachable;
  79
  80     protected $query;
  81
  82     protected $memberslist_fields = array(
  83         'filter_str',
  84         'field_filter',
  85         'membership_filter',
  86         'filter_account',
  87         'email_filter',
  88         'group_filter',
  89         'selected',
  90         'unreachable',
  91         'query'
  92     );
  93
  94     /**
  95      * Default constructor
  96      */
  97     public function __construct()
  98     {
  99         $this->reinit();
 100     }
 101
 102     /**
 103      * Returns the field we want to default set order to
 104      *
 105      * @return string field name
 106      */
 107     protected function getDefaultOrder()
 108     {
 109         return 'nom_adh';
 110     }
 111
 112     /**
 113      * Reinit default parameters
 114      *
 115      * @return void
 116      */
 117     public function reinit()
 118     {
 119         global $preferences;
 120
 121         parent::reinit();
 122         $this->_filter_str = null;
 123         $this->_field_filter = null;
 124         $this->_membership_filter = null;
 125         $this->_filter_account = $preferences->pref_filter_account;
 126         $this->_email_filter = Members::FILTER_DC_EMAIL;
 127         $this->_group_filter = null;
 128         $this->_selected = array();
 129     }
 130
 131     /**
 132      * Global getter method
 133      *
 134      * @param string $name name of the property we want to retrive
 135      *
 136      * @return object the called property
 137      */
 138     public function __get($name)
 139     {
 140         if (in_array($name, $this->pagination_fields)) {
 141             return parent::__get($name);
 142         } else {
 143             if (in_array($name, $this->memberslist_fields)) {
 144                 if ($name === 'query') {
 145                     return $this->$name;
 146                 } else {
 147                     $name = '_' . $name;
 148                     return $this->$name;
 149                 }
 150             } else {
 151                 Analog::log(
 152                     '[MembersList] Unable to get proprety `' . $name . '`',
 153                     Analog::WARNING
 154                 );
 155             }
 156         }
 157     }
 158
 159     /**
 160      * Global setter method
 161      *
 162      * @param string $name  name of the property we want to assign a value to
 163      * @param object $value a relevant value for the property
 164      *
 165      * @return void
 166      */
 167     public function __set($name, $value)
 168     {
 169         if (in_array($name, $this->pagination_fields)) {
 170             parent::__set($name, $value);
 171         } else {
 172             Analog::log(
 173                 '[MembersList] Setting property `' . $name . '`',
 174                 Analog::DEBUG
 175             );
 176
 177             switch ($name) {
 178                 case 'selected':
 179                 case 'unreachable':
 180                     if (is_array($value)) {
 181                         $name = '_' . $name;
 182                         $this->$name = $value;
 183                     } elseif ($value !== null) {
 184                         Analog::log(
 185                             '[MembersList] Value for property `' . $name .
 186                             '` should be an array (' . gettype($value) . ' given)',
 187                             Analog::WARNING
 188                         );
 189                     }
 190                     break;
 191                 case 'filter_str':
 192                     $name = '_' . $name;
 193                     $this->$name = $value;
 194                     break;
 195                 case 'field_filter':
 196                 case 'membership_filter':
 197                 case 'filter_account':
 198                     if (is_numeric($value)) {
 199                         $name = '_' . $name;
 200                         $this->$name = $value;
 201                     } elseif ($value !== null) {
 202                         Analog::log(
 203                             '[MembersList] Value for property `' . $name .
 204                             '` should be an integer (' . gettype($value) . ' given)',
 205                             Analog::WARNING
 206                         );
 207                     }
 208                     break;
 209                 case 'email_filter':
 210                     switch ($value) {
 211                         case Members::FILTER_DC_EMAIL:
 212                         case Members::FILTER_W_EMAIL:
 213                         case Members::FILTER_WO_EMAIL:
 214                             $this->_email_filter = $value;
 215                             break;
 216                         default:
 217                             Analog::log(
 218                                 '[MembersList] Value for email filter should be either ' .
 219                                 Members::FILTER_DC_EMAIL . ', ' .
 220                                 Members::FILTER_W_EMAIL . ' or ' .
 221                                 Members::FILTER_WO_EMAIL . ' (' . $value . ' given)',
 222                                 Analog::WARNING
 223                             );
 224                             break;
 225                     }
 226                     break;
 227                 case 'group_filter':
 228                     if (is_numeric($value) && $value > 0) {
 229                         //check group existence
 230                         $g = new Group();
 231                         $res = $g->load($value);
 232                         if ($res === true) {
 233                             $this->_group_filter = $value;
 234                         } else {
 235                             Analog::log(
 236                                 'Group #' . $value . ' does not exists!',
 237                                 Analog::WARNING
 238                             );
 239                         }
 240                     } elseif ($value !== null && $value !== '0') {
 241                         Analog::log(
 242                             '[MembersList] Value for group filter should be an '
 243                             . 'integer (' . gettype($value) . ' given)',
 244                             Analog::WARNING
 245                         );
 246                     }
 247                     break;
 248                 case 'query':
 249                     $this->$name = $value;
 250                     break;
 251                 default:
 252                     Analog::log(
 253                         '[MembersList] Unable to set proprety `' . $name . '`',
 254                         Analog::WARNING
 255                     );
 256                     break;
 257             }
 258         }
 259     }
 260
 261     /**
 262      * Set commons filters for templates
 263      *
 264      * @param Preferences $prefs Preferences instance
 265      * @param Smarty      $view  Smarty template reference
 266      *
 267      * @return void
 268      */
 269     public function setViewCommonsFilters($prefs, \Smarty $view)
 270     {
 271         $filter_options = array(
 272             Members::FILTER_NAME            => _T("Name"),
 273             Members::FILTER_COMPANY_NAME    => _T("Company name"),
 274             Members::FILTER_ADDRESS         => _T("Address"),
 275             Members::FILTER_MAIL            => _T("Email,URL,IM"),
 276             Members::FILTER_JOB             => _T("Job"),
 277             Members::FILTER_INFOS           => _T("Infos")
 278         );
 279
 280         if ($prefs->pref_show_id) {
 281             $filter_options[Members::FILTER_NUMBER] = _T("Member number");
 282         }
 283
 284         $view->assign(
 285             'field_filter_options',
 286             $filter_options
 287         );
 288
 289         $view->assign(
 290             'membership_filter_options',
 291             array(
 292                 Members::MEMBERSHIP_ALL     => _T("All members"),
 293                 Members::MEMBERSHIP_UP2DATE => _T("Up to date members"),
 294                 Members::MEMBERSHIP_NEARLY  => _T("Close expiries"),
 295                 Members::MEMBERSHIP_LATE    => _T("Latecomers"),
 296                 Members::MEMBERSHIP_NEVER   => _T("Never contributed"),
 297                 Members::MEMBERSHIP_STAFF   => _T("Staff members"),
 298                 Members::MEMBERSHIP_ADMIN   => _T("Administrators"),
 299                 Members::MEMBERSHIP_NONE    => _T("Non members")
 300             )
 301         );
 302
 303         $view->assign(
 304             'filter_accounts_options',
 305             array(
 306                 Members::ALL_ACCOUNTS       => _T("All accounts"),
 307                 Members::ACTIVE_ACCOUNT     => _T("Active accounts"),
 308                 Members::INACTIVE_ACCOUNT   => _T("Inactive accounts")
 309             )
 310         );
 311     }
 312 }