. * * @category Controllers * @package Galette * * @author Johan Cwiklinski * @copyright 2020-2021 The Galette Team * @license http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or (at your option) any later version * @link http://galette.tuxfamily.org * @since Available since 0.9.4dev - 2020-05-08 */ namespace Galette\Controllers\Crud; use Throwable; use Analog\Analog; use Galette\Controllers\CrudController; use Slim\Http\Request; use Slim\Http\Response; use Galette\Entity\Adherent; use Galette\Entity\Contribution; use Galette\Entity\Transaction; use Galette\Repository\Members; use Galette\Entity\ContributionsTypes; use Galette\Repository\PaymentTypes; /** * Galette contributions controller * * @category Controllers * @name ContributionsController * @package Galette * @author Johan Cwiklinski * @copyright 2020-2021 The Galette Team * @license http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or (at your option) any later version * @link http://galette.tuxfamily.org * @since Available since 0.9.4dev - 2020-05-02 */ class ContributionsController extends CrudController { // CRUD - Create /** * Add/Edit page * * Only a few things changes in add and edit pages, * boths methods will use this common one. * * @param Request $request PSR Request * @param Response $response PSR Response * @param string $type Contribution type * @param Contribution $contrib Contribution instance * * @return Response */ public function addEditPage( Request $request, Response $response, string $type, Contribution $contrib ): Response { // contribution types $ct = new ContributionsTypes($this->zdb); $contributions_types = $ct->getList($type === Contribution::TYPE_FEE); // template variable declaration $title = null; if ($type === Contribution::TYPE_FEE) { $title = _T("Membership fee"); } else { $title = _T("Donation"); } if ($contrib->id != '') { $title .= ' (' . _T("modification") . ')'; } else { $title .= ' (' . _T("creation") . ')'; } $params = [ 'page_title' => $title, 'required' => $contrib->getRequired(), 'contribution' => $contrib, 'adh_selected' => $contrib->member, 'type' => $type ]; // contribution types $params['type_cotis_options'] = $contributions_types; // members $m = new Members(); $members = $m->getSelectizedMembers( $this->zdb, $contrib->member > 0 ? $contrib->member : null ); $params['members'] = [ 'filters' => $m->getFilters(), 'count' => $m->getCount() ]; if (count($members)) { $params['members']['list'] = $members; } $ext_membership = ''; if ($contrib->isFee() || !isset($contrib) && $type === Contribution::TYPE_FEE) { $ext_membership = $this->preferences->pref_membership_ext; } $params['pref_membership_ext'] = $ext_membership; $params['autocomplete'] = true; // display page $this->view->render( $response, 'ajouter_contribution.tpl', $params ); return $response; } /** * Add page * * @param Request $request PSR Request * @param Response $response PSR Response * @param string|null $type Contribution type * * @return Response */ public function add(Request $request, Response $response, string $type = null): Response { if ($this->session->contribution !== null) { $contrib = $this->session->contribution; $this->session->contribution = null; } else { $get = $request->getQueryParams(); $ct = new ContributionsTypes($this->zdb); $contributions_types = $ct->getList($type === Contribution::TYPE_FEE); $cparams = ['type' => array_keys($contributions_types)[0]]; //member id if (isset($get[Adherent::PK]) && $get[Adherent::PK] > 0) { $cparams['adh'] = (int)$get[Adherent::PK]; } //transaction id if (isset($get[Transaction::PK]) && $get[Transaction::PK] > 0) { $cparams['trans'] = $get[Transaction::PK]; } $contrib = new Contribution( $this->zdb, $this->login, (count($cparams) > 0 ? $cparams : null) ); if (isset($cparams['adh'])) { $contrib->member = $cparams['adh']; } if (isset($get['montant_cotis']) && $get['montant_cotis'] > 0) { $contrib->amount = $get['montant_cotis']; } } return $this->addEditPage($request, $response, $type, $contrib); } /** * Add action * * @param Request $request PSR Request * @param Response $response PSR Response * @param string|null $type Contribution type * * @return Response */ public function doAdd(Request $request, Response $response, string $type = null): Response { return $this->store($request, $response, 'add', $type); } /** * Choose contribution type to mass add contribution * * @param Request $request PSR Request * @param Response $response PSR Response * * @return Response */ public function massAddChooseType(Request $request, Response $response): Response { $filters = $this->session->filter_members; $data = [ 'id' => $filters->selected, 'redirect_uri' => $this->router->pathFor('members') ]; // display page $this->view->render( $response, 'mass_choose_type.tpl', array( 'mode' => $request->isXhr() ? 'ajax' : '', 'page_title' => str_replace( '%count', count($data['id']), _T('Mass add contribution on %count members') ), 'data' => $data, 'form_url' => $this->router->pathFor('massAddContributions'), 'cancel_uri' => $this->router->pathFor('members') ) ); return $response; } /** * Massive change page * * @param Request $request PSR Request * @param Response $response PSR Response * * @return Response */ public function massAddContributions(Request $request, Response $response): Response { $post = $request->getParsedBody(); $filters = $this->session->filter_members; $contribution = new Contribution($this->zdb, $this->login); $type = $post['type']; $data = [ 'id' => $filters->selected, 'redirect_uri' => $this->router->pathFor('members'), 'type' => $type ]; // contribution types $ct = new ContributionsTypes($this->zdb); $contributions_types = $ct->getList($type === Contribution::TYPE_FEE); // display page $this->view->render( $response, 'mass_add_contribution.tpl', array( 'mode' => $request->isXhr() ? 'ajax' : '', 'page_title' => str_replace( '%count', count($data['id']), _T('Mass add contribution on %count members') ), 'form_url' => $this->router->pathFor('doMassAddContributions'), 'cancel_uri' => $this->router->pathFor('members'), 'data' => $data, 'contribution' => $contribution, 'type' => $type, 'require_mass' => true, 'required' => $contribution->getRequired(), 'type_cotis_options' => $contributions_types ) ); return $response; } /** * Do massive contribution add * * @param Request $request PSR Request * @param Response $response PSR Response * * @return Response */ public function doMassAddContributions(Request $request, Response $response): Response { $post = $request->getParsedBody(); $members_ids = $post['id']; unset($post['id']); $error_detected = []; // flagging required fields for first step only $disabled = []; $success = 0; $errors = 0; foreach ($members_ids as $member_id) { $post[Adherent::PK] = (int)$member_id; $contrib = new Contribution($this->zdb, $this->login); // regular fields $valid = $contrib->check($post, $contrib->getRequired(), $disabled); if ($valid !== true) { $error_detected = array_merge($error_detected, $valid); } //all goes well, we can proceed if (count($error_detected) == 0) { $store = $contrib->store(); if ($store === true) { ++$success; $files_res = $contrib->handleFiles($_FILES); if (is_array($files_res)) { $error_detected = array_merge($error_detected, $files_res); } } else { ++$errors; } } } if (count($error_detected) == 0) { $redirect_url = $this->router->pathFor('members'); } else { //something went wrong. //store entity in session $redirect_url = $this->router->pathFor('massAddContributions'); //report errors foreach ($error_detected as $error) { $this->flash->addMessage( 'error_detected', $error ); } } //redirect to calling action return $response ->withStatus(301) ->withHeader('Location', $redirect_url); } // /CRUD - Create // CRUD - Read /** * List page * * @param Request $request PSR Request * @param Response $response PSR Response * @param string $option One of 'page' or 'order' * @param string|integer $value Value of the option * @param string $type One of 'transactions' or 'contributions' * * @return Response */ public function list(Request $request, Response $response, $option = null, $value = null, $type = null): Response { $ajax = false; $get = $request->getQueryParams(); if ( $request->isXhr() || isset($get['ajax']) && $get['ajax'] == 'true' ) { $ajax = true; } switch ($type) { case 'transactions': $raw_type = 'transactions'; break; case 'contributions': $raw_type = 'contributions'; break; default: Analog::log( 'Trying to load unknown contribution type ' . $type, Analog::WARNING ); return $response ->withStatus(301) ->withHeader( 'Location', $this->router->pathFor('me') ); } $filter_name = 'filter_' . $raw_type; if (isset($this->session->$filter_name) && $ajax === false) { $filters = $this->session->$filter_name; } else { $filter_class = '\\Galette\\Filters\\' . ucwords($raw_type . 'List'); $filters = new $filter_class(); } //member id if (isset($get[Adherent::PK]) && $get[Adherent::PK] > 0) { $filters->filtre_cotis_adh = (int)$get[Adherent::PK]; } $filters->filtre_transactions = false; if (isset($request->getQueryParams()['max_amount'])) { $filters->filtre_transactions = true; $filters->max_amount = (int)$request->getQueryParams()['max_amount']; } if ($option !== null) { switch ($option) { case 'page': $filters->current_page = (int)$value; break; case 'order': $filters->orderby = $value; break; case 'member': $filters->filtre_cotis_adh = ($value === 'all' ? null : $value); break; } } if (!$this->login->isAdmin() && !$this->login->isStaff() && $value != $this->login->id) { if ($value === 'all' || empty($value)) { $value = $this->login->id; } else { $member = new Adherent( $this->zdb, (int)$value, [ 'picture' => false, 'groups' => false, 'dues' => false, 'parent' => true ] ); if ( !$member->hasParent() || $member->hasParent() && $member->parent->id != $this->login->id ) { $value = $this->login->id; Analog::log( 'Trying to display contributions for member #' . $value . ' without appropriate ACLs', Analog::WARNING ); } } $filters->filtre_cotis_children = $value; } $class = '\\Galette\\Entity\\' . ucwords(trim($raw_type, 's')); $contrib = new $class($this->zdb, $this->login); if (!$contrib->canShow($this->login)) { Analog::log( 'Trying to display contributions without appropriate ACLs', Analog::WARNING ); return $response ->withStatus(301) ->withHeader( 'Location', $this->router->pathFor('me') ); } $class = '\\Galette\\Repository\\' . ucwords($raw_type); $contrib = new $class($this->zdb, $this->login, $filters); $contribs_list = $contrib->getList(true); //store filters into session if ($ajax === false) { $this->session->$filter_name = $filters; } //assign pagination variables to the template and add pagination links $filters->setSmartyPagination($this->router, $this->view->getSmarty()); $tpl_vars = [ 'page_title' => $raw_type === 'contributions' ? _T("Contributions management") : _T("Transactions management"), 'contribs' => $contrib, 'list' => $contribs_list, 'nb' => $contrib->getCount(), 'filters' => $filters, 'mode' => ($ajax === true ? 'ajax' : 'std') ]; if ($filters->filtre_cotis_adh != null) { $member = new Adherent($this->zdb); $member->load($filters->filtre_cotis_adh); $tpl_vars['member'] = $member; } if ($filters->filtre_cotis_children != false) { $member = new Adherent( $this->zdb, $filters->filtre_cotis_children, [ 'picture' => false, 'groups' => false, 'dues' => false, 'parent' => true ] ); $tpl_vars['pmember'] = $member; } // display page $this->view->render( $response, 'gestion_' . $raw_type . '.tpl', $tpl_vars ); return $response; } /** * Filtering * * @param Request $request PSR Request * @param Response $response PSR Response * @param string|null $type Contribution type * * @return Response */ public function filter(Request $request, Response $response, string $type = null): Response { $raw_type = null; switch ($type) { case 'transactions': $raw_type = 'transactions'; break; case 'contributions': $raw_type = 'contributions'; break; } $type = 'filter_' . $raw_type; $post = $request->getParsedBody(); $error_detected = []; if ($this->session->$type !== null) { $filters = $this->session->$type; } else { $filter_class = '\\Galette\\Filters\\' . ucwords($raw_type) . 'List'; $filters = new $filter_class(); } if (isset($post['clear_filter'])) { $filters->reinit(); } else { if (isset($post['max_amount'])) { $filters->max_amount = null; } if ( (isset($post['nbshow']) && is_numeric($post['nbshow'])) ) { $filters->show = $post['nbshow']; } if (isset($post['end_date_filter']) || isset($post['start_date_filter'])) { try { if (isset($post['start_date_filter'])) { $filters->start_date_filter = $post['start_date_filter']; } if (isset($post['end_date_filter'])) { $filters->end_date_filter = $post['end_date_filter']; } } catch (Throwable $e) { $error_detected[] = $e->getMessage(); } } if (isset($post['payment_type_filter'])) { $ptf = (int)$post['payment_type_filter']; $ptypes = new PaymentTypes( $this->zdb, $this->preferences, $this->login ); $ptlist = $ptypes->getList(); if (isset($ptlist[$ptf])) { $filters->payment_type_filter = $ptf; } elseif ($ptf == -1) { $filters->payment_type_filter = null; } else { $error_detected[] = _T("- Unknown payment type!"); } } } $this->session->$type = $filters; if (count($error_detected) > 0) { //report errors foreach ($error_detected as $error) { $this->flash->addMessage( 'error_detected', $error ); } } return $response ->withStatus(301) ->withHeader('Location', $this->router->pathFor('contributions', ['type' => $raw_type])); } // /CRUD - Read // CRUD - Update /** * Edit page * * @param Request $request PSR Request * @param Response $response PSR Response * @param int $id Contribution id * @param string|null $type Contribution type * * @return Response */ public function edit(Request $request, Response $response, int $id, string $type = null): Response { if ($this->session->contribution !== null) { $contrib = $this->session->contribution; $this->session->contribution = null; } else { $contrib = new Contribution($this->zdb, $this->login, $id); if ($contrib->id == '') { //not possible to load contribution, exit $this->flash->addMessage( 'error_detected', str_replace( '%id', $id, _T("Unable to load contribution #%id!") ) ); return $response ->withStatus(301) ->withHeader('Location', $this->router->pathFor( 'contributions', ['type' => 'contributions'] )); } } return $this->addEditPage($request, $response, $type, $contrib); } /** * Edit action * * @param Request $request PSR Request * @param Response $response PSR Response * @param integer $id Contribution id * @param string|null $type Contribution type * * @return Response */ public function doEdit(Request $request, Response $response, int $id, string $type = null): Response { return $this->store($request, $response, 'edit', $type, $id); } /** * Store contribution (new or existing) * * @param Request $request PSR Request * @param Response $response PSR Response * @param string $action Action ('edit' or 'add') * @param string $type Contribution type * @param integer $id Contribution id * * @return Response */ public function store(Request $request, Response $response, $action, string $type, $id = null): Response { $post = $request->getParsedBody(); $args = [ 'action' => $action, 'type' => $type ]; if ($id !== null) { $args['id'] = $id; } if ($action == 'edit' && isset($post['btnreload'])) { $redirect_url = $this->router->pathFor($action . 'Contribution', $args); $redirect_url .= '?' . Adherent::PK . '=' . $post[Adherent::PK] . '&' . ContributionsTypes::PK . '=' . $post[ContributionsTypes::PK] . '&' . 'montant_cotis=' . $post['montant_cotis']; return $response ->withStatus(301) ->withHeader('Location', $redirect_url); } $error_detected = []; if ($this->session->contribution !== null) { $contrib = $this->session->contribution; $this->session->contribution = null; } else { if ($id === null) { $contrib = new Contribution($this->zdb, $this->login); } else { $contrib = new Contribution($this->zdb, $this->login, $id); } } $disabled = []; // regular fields $valid = $contrib->check($post, $contrib->getRequired(), $disabled); if ($valid !== true) { $error_detected = array_merge($error_detected, $valid); } //all goes well, we can proceed if (count($error_detected) == 0) { // send email to member if (isset($post['mail_confirm']) && $post['mail_confirm'] == '1') { $contrib->setSendmail(); //flag to send creation email } $store = $contrib->store(); if ($store === true) { $this->flash->addMessage( 'success_detected', _T('Contribution has been successfully stored') ); } else { //something went wrong :'( $error_detected[] = _T("An error occurred while storing the contribution."); } } if (count($error_detected) === 0) { $files_res = $contrib->handleFiles($_FILES); if (is_array($files_res)) { $error_detected = array_merge($error_detected, $files_res); } } if (count($error_detected) == 0) { $this->session->contribution = null; if ($contrib->isTransactionPart() && $contrib->transaction->getMissingAmount() > 0) { //new contribution $redirect_url = $this->router->pathFor( 'addContribution', [ 'type' => $post['contrib_type'] ] ) . '?' . Transaction::PK . '=' . $contrib->transaction->id . '&' . Adherent::PK . '=' . $contrib->member; } else { //contributions list for member $redirect_url = $this->router->pathFor( 'contributions', [ 'type' => 'contributions' ] ) . '?' . Adherent::PK . '=' . $contrib->member; } } else { //something went wrong. //store entity in session $this->session->contribution = $contrib; $redirect_url = $this->router->pathFor($action . 'Contribution', $args); //report errors foreach ($error_detected as $error) { $this->flash->addMessage( 'error_detected', $error ); } } //redirect to calling action return $response ->withStatus(301) ->withHeader('Location', $redirect_url); } // /CRUD - Update // CRUD - Delete /** * Get redirection URI * * @param array $args Route arguments * * @return string */ public function redirectUri(array $args) { return $this->router->pathFor('contributions', ['type' => $args['type']]); } /** * Get form URI * * @param array $args Route arguments * * @return string */ public function formUri(array $args) { return $this->router->pathFor( 'doRemoveContribution', $args ); } /** * Get confirmation removal page title * * @param array $args Route arguments * * @return string */ public function confirmRemoveTitle(array $args) { $raw_type = null; switch ($args['type']) { case 'transactions': $raw_type = 'transactions'; break; case 'contributions': $raw_type = 'contributions'; break; } if (isset($args['ids'])) { return sprintf( _T('Remove %1$s %2$s'), count($args['ids']), ($raw_type === 'contributions') ? _T('contributions') : _T('transactions') ); } else { return sprintf( _T('Remove %1$s #%2$s'), ($raw_type === 'contributions') ? _T('contribution') : _T('transaction'), $args['id'] ); } } /** * Remove object * * @param array $args Route arguments * @param array $post POST values * * @return boolean */ protected function doDelete(array $args, array $post) { $raw_type = null; switch ($args['type']) { case 'transactions': $raw_type = 'transactions'; break; case 'contributions': $raw_type = 'contributions'; break; } $class = '\\Galette\Repository\\' . ucwords($raw_type); $contribs = new $class($this->zdb, $this->login); $rm = $contribs->remove($args['ids'] ?? $args['id'], $this->history); return $rm; } // /CRUD - Delete // /CRUD }