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