3 /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
10 * Copyright © 2020-2021 The Galette Team
12 * This file is part of Galette (http://galette.tuxfamily.org).
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.
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.
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/>.
30 * @author Johan Cwiklinski <johan@x-tnd.be>
31 * @copyright 2020-2021 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.eu
37 namespace Galette\Features
;
40 use Galette\Core\Login
;
41 use Galette\Core\Logo
;
42 use Galette\Core\Preferences
;
43 use Galette\DynamicFields\Choice
;
44 use Galette\Entity\Adherent
;
45 use Galette\Entity\Contribution
;
46 use Galette\Entity\PdfModel
;
47 use Galette\Repository\DynamicFieldsSet
;
48 use Galette\DynamicFields\DynamicField
;
54 * Replacements feature
59 * @author Johan Cwiklinski <johan@x-tnd.be>
60 * @copyright 2020-2021 The Galette Team
61 * @license http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or (at your option) any later version
62 * @link http://galette.eu
68 private $patterns = [];
69 private $replaces = [];
70 private $dynamic_patterns = [];
85 * @Inject("preferences")
88 protected $preferences;
97 * Get dynamic patterns
99 * @param string $form_name Dynamic form name
103 public function getDynamicPatterns(string $form_name): array
105 if (isset($this->dynamic_patterns
[$form_name])) {
106 return $this->dynamic_patterns
[$form_name];
109 $fields = new DynamicFieldsSet($this->zdb
, $this->login
);
110 $dynamic_fields = $fields->getList($form_name);
112 $dynamic_patterns = [];
113 foreach ($dynamic_fields as $dynamic_field) {
114 $key = strtoupper('DYNFIELD_' . $dynamic_field->getId() . '_' . $form_name);
119 if ($dynamic_field instanceof Choice
) {
120 $capabilities[] = 'INPUT';
122 foreach ($capabilities as $capability) {
123 if (empty($capability)) {
126 $skey = sprintf('%s_%s', $capability, $key);
128 $dynamic_patterns[strtolower($skey)] = [
130 ($capability == 'LABEL' ?
_T('Label for dynamic field "%s"')
131 : ($capability == 'INPUT' ?
_T('Form entry for dynamic field "%s"') :
132 _T('Value for dynamic field "%s"'))
134 $dynamic_field->getName()
136 'pattern' => sprintf('{%s}', $skey)
141 $this->dynamic_patterns
[$form_name] = $dynamic_patterns;
142 return $this->dynamic_patterns
[$form_name];
148 * @param array $patterns Patterns to add
152 protected function setPatterns(array $patterns): self
155 foreach ($patterns as $key => $info) {
156 if (is_array($info)) {
157 $toset[$key] = $info['pattern'];
159 $toset[$key] = $info;
163 $this->patterns
= array_merge(
174 * @param array $replaces Replacements to add
178 public function setReplacements(array $replaces): void
180 $this->replaces
= array_merge(
191 protected function getMainPatterns(): array
195 'title' => _T('Your organisation name'),
196 'pattern' => '/{ASSO_NAME}/'
199 'title' => _T('Your organisation slogan'),
200 'pattern' => '/{ASSO_SLOGAN}/'
203 'title' => _T('Your organisation address'),
204 'pattern' => '/{ASSO_ADDRESS}/',
206 'asso_address_multi' => [
207 'title' => sprintf('%s (%s)', _T('Your organisation address'), _T('with break lines')),
208 'pattern' => '/{ASSO_ADDRESS_MULTI}/',
211 'title' => _T('Your organisation website'),
212 'pattern' => '/{ASSO_WEBSITE}/',
215 'title' => _T('Your organisation logo'),
216 'pattern' => '/{ASSO_LOGO}/',
219 'title' => _T('Current date (Y-m-d)'),
220 'pattern' => '/{DATE_NOW}/'
223 'title' => _T("Galette's login URI"),
224 'pattern' => '/{LOGIN_URI}/'
230 * Get patterns for a member
232 * @param boolean $legacy Whether to load legacy patterns
236 protected function getMemberPatterns(bool $legacy = true): array
238 $dynamic_patterns = $this->getDynamicPatterns('adh');
241 'title' => _('Title'),
242 'pattern' => '/{TITLE_ADH}/',
245 'title' => _T("Member's ID"),
246 'pattern' => '/{ID_ADH}/',
249 'title' => _T("Name"),
250 'pattern' => '/{NAME_ADH}/',
253 'title' => _T('Last name'),
254 'pattern' => '/{LAST_NAME_ADH}/',
256 'adh_first_name' => [
257 'title' => _T('First name'),
258 'pattern' => '/{FIRST_NAME_ADH}/',
261 'title' => _T('Nickname'),
262 'pattern' => '/{NICKNAME_ADH}/',
265 'title' => _T('Gender'),
266 'pattern' => '/{GENDER_ADH}/',
268 'adh_birth_date' => [
269 'title' => _T('Birth date'),
270 'pattern' => '/{ADH_BIRTH_DATE}/',
272 'adh_birth_place' => [
273 'title' => _T('Birth place'),
274 'pattern' => '/{ADH_BIRTH_PLACE}/',
276 'adh_profession' => [
277 'title' => _T('Profession'),
278 'pattern' => '/{PROFESSION_ADH}/',
281 'title' => _T("Company name"),
282 'pattern' => '/{COMPANY_ADH}/',
285 'title' => _T("Address"),
286 'pattern' => '/{ADDRESS_ADH}/',
289 'title' => _T("Zipcode"),
290 'pattern' => '/{ZIP_ADH}/',
293 'title' => _T("Town"),
294 'pattern' => '/{TOWN_ADH}/',
297 'title' => _T('Country'),
298 'pattern' => '/{COUNTRY_ADH}/',
301 'title' => _T('Phone'),
302 'pattern' => '/{PHONE_ADH}/',
305 'title' => _T('GSM'),
306 'pattern' => '/{MOBILE_ADH}/',
309 'title' => _T('Email'),
310 'pattern' => '/{EMAIL_ADH}/',
313 'title' => _T('Login'),
314 'pattern' => '/{LOGIN_ADH}/',
316 'adh_main_group' => [
317 'title' => _T("Member's main group"),
318 'pattern' => '/{GROUP_ADH}/',
321 'title' => _T("Member's groups (as list)"),
322 'pattern' => '/{GROUPS_ADH}/'
325 'title' => _T('Member state of dues'),
326 'pattern' => '/{ADH_DUES}/'
328 'days_remaining' => [
329 'title' => _T('Membership remaining days'),
330 'pattern' => '/{DAYS_REMAINING}/',
333 'title' => _T('Membership expired since'),
334 'pattern' => '/{DAYS_EXPIRED}/',
338 if ($legacy === true) {
341 'title' => _T("Company name"),
342 'pattern' => '/{COMPANY_NAME_ADH}/',
344 '_adh_last_name' => [
345 'title' => _T('Last name'),
346 'pattern' => '/{LASTNAME_ADH}/',
348 '_adh_first_name' => [
349 'title' => _T('First name'),
350 'pattern' => '/{FIRSTNAME_ADH}/',
353 'title' => _T('Login'),
354 'pattern' => '/{LOGIN}/',
357 'title' => _T('Email'),
358 'pattern' => '/{MAIL_ADH}/',
363 return $m_patterns +
$dynamic_patterns;
367 * Get patterns for a contribution
369 * @param boolean $legacy Whether to load legacy patterns
373 protected function getContributionPatterns($legacy = true): array
375 $dynamic_patterns = $this->getDynamicPatterns('contrib');
379 'title' => _T('Contribution label'),
380 'pattern' => '/{CONTRIB_LABEL}/',
382 'contrib_amount' => [
383 'title' => _T('Amount'),
384 'pattern' => '/{CONTRIB_AMOUNT}/',
386 'contrib_amount_letters' => [
387 'title' => _T('Amount (in letters)'),
388 'pattern' => '/{CONTRIB_AMOUNT_LETTERS}/',
391 'title' => _T('Full date'),
392 'pattern' => '/{CONTRIB_DATE}/',
395 'title' => _T('Contribution year'),
396 'pattern' => '/{CONTRIB_YEAR}/',
398 'contrib_comment' => [
399 'title' => _T('Comment'),
400 'pattern' => '/{CONTRIB_COMMENT}/',
403 'title' => _T('Begin date'),
404 'pattern' => '/{CONTRIB_BEGIN_DATE}/',
407 'title' => _T('End date'),
408 'pattern' => '/{CONTRIB_END_DATE}/',
411 'title' => _T('Contribution id'),
412 'pattern' => '/{CONTRIB_ID}/',
414 'contrib_payment' => [
415 'title' => _T('Payment type'),
416 'pattern' => '/{CONTRIB_PAYMENT_TYPE}/'
419 'title' => _T('Contribution information'),
420 'pattern' => '/{CONTRIB_INFO}/'
424 if ($legacy === true) {
425 foreach ($c_patterns as $key => $pattern) {
427 $pattern['pattern'] = str_replace(
432 $c_patterns[$nkey] = $pattern;
435 $c_patterns['__contrib_label'] = [
436 'title' => $c_patterns['contrib_label'],
437 'pattern' => '/{CONTRIB_TYPE}/'
441 //handle DEADLINE alias
443 return $c_patterns +
$dynamic_patterns;
447 * Set main replacements
451 public function setMain(): self
453 $address = $this->preferences
->getPostalAddress();
454 $address_multi = preg_replace("/\n/", "<br>", $address);
457 if ($this->preferences
->pref_website
!== '') {
458 $website = '<a href="' . $this->preferences
->pref_website
. '">' .
459 $this->preferences
->pref_website
. '</a>';
464 ' src="' . $this->preferences
->getURL() . $this->router
->pathFor('logo') . '"' .
465 ' width="' . $logo->getOptimalWidth() . '"' .
466 ' height="' . $logo->getOptimalHeight() . '"' .
469 $this->setReplacements(
471 'asso_name' => $this->preferences
->pref_nom
,
472 'asso_slogan' => $this->preferences
->pref_slogan
,
473 'asso_address' => $address,
474 'asso_address_multi' => $address_multi,
475 'asso_website' => $website,
476 'asso_logo' => $logo_elt,
477 'date_now' => date(_T('Y-m-d')),
478 'login_uri' => $this->preferences
->getURL() . $this->router
->pathFor('login'),
486 * Set contribution and proceed related replacements
490 public function setNoContribution(): self
495 'contrib_label' => null,
496 'contrib_amount' => null,
497 'contrib_amount_letters' => null,
498 'contrib_date' => null,
499 'contrib_year' => null,
500 'contrib_comment' => null,
501 'contrib_bdate' => null,
502 'contrib_edate' => null,
503 'contrib_id' => null,
504 'contrib_payment' => null,
505 'contrib_info' => null
508 foreach ($c_replacements as $key => $replacement) {
510 $c_replacements[$nkey] = $replacement;
512 $c_replacements['__contrib_label'] = $c_replacements['contrib_label'];
514 //handle DEADLINE alias
516 $this->setReplacements($c_replacements);
518 /** the list of all dynamic fields */
519 $fields = new DynamicFieldsSet($this->zdb
, $login);
520 $dynamic_fields = $fields->getList('contrib');
521 $this->setDynamicFields('contrib', $dynamic_fields, null);
527 * Set contribution and proceed related replacements
529 * @param Contribution $contrib Contribution
533 public function setContribution(Contribution
$contrib): self
535 global $login, $i18n;
537 $formatter = new NumberFormatter($i18n->getID(), NumberFormatter
::SPELLOUT
);
540 'contrib_label' => $contrib->type
->libelle
,
541 'contrib_amount' => $contrib->amount
,
542 'contrib_amount_letters' => $formatter->format($contrib->amount
),
543 'contrib_date' => $contrib->date
,
544 'contrib_year' => $contrib->raw_date
->format('Y'),
545 'contrib_comment' => $contrib->info
,
546 'contrib_bdate' => $contrib->begin_date
,
547 'contrib_edate' => $contrib->end_date
,
548 'contrib_id' => $contrib->id
,
549 'contrib_payment' => $contrib->spayment_type
,
550 'contrib_info' => $contrib->info
553 foreach ($c_replacements as $key => $replacement) {
555 $c_replacements[$nkey] = $replacement;
557 $c_replacements['__contrib_label'] = $c_replacements['contrib_label'];
559 //handle DEADLINE alias
561 $this->setReplacements($c_replacements);
563 /** the list of all dynamic fields */
564 $fields = new DynamicFieldsSet($this->zdb
, $login);
565 $dynamic_fields = $fields->getList('contrib');
566 $this->setDynamicFields('contrib', $dynamic_fields, $contrib);
572 * Set member and proceed related replacements
574 * @param Adherent $member Member
578 public function setMember(Adherent
$member): self
582 $address = $member->address
;
583 if ($member->address_continuation
!== '') {
584 $address .= '<br/>' . $member->address_continuation
;
587 if ($member->isMan()) {
589 } elseif ($member->isWoman()) {
590 $gender = _T("Woman");
592 $gender = _T("Unspecified");
595 $member_groups = $member->groups
;
596 $main_group = _T("None");
597 $group_list = _T("None");
598 if (is_array($member_groups) && count($member_groups) > 0) {
599 $main_group = $member_groups[0]->getName();
600 $group_list = '<ul>';
601 foreach ($member_groups as $group) {
602 $group_list .= '<li>' . $group->getName() . '</li>';
604 $group_list .= '</ul>';
607 $this->setReplacements(
609 'adh_title' => $member->stitle
,
610 'adh_id' => $member->id
,
611 'adh_name' => $member->sfullname
,
612 'adh_last_name' => $member->name
,
613 'adh_first_name' => $member->surname
,
614 'adh_nickname' => $member->nickname
,
615 'adh_gender' => $gender,
616 'adh_birth_date' => $member->birthdate
,
617 'adh_birth_place' => $member->birth_place
,
618 'adh_profession' => $member->job
,
619 'adh_company' => $member->company_name
,
620 'adh_address' => $address,
621 'adh_zip' => $member->zipcode
,
622 'adh_town' => $member->town
,
623 'adh_country' => $member->country
,
624 'adh_phone' => $member->phone
,
625 'adh_mobile' => $member->gsm
,
626 'adh_email' => $member->email
,
627 'adh_login' => $member->login
,
628 'adh_main_group' => $main_group,
629 'adh_groups' => $group_list,
630 'adh_dues' => $member->getDues(),
631 'days_remaining' => $member->days_remaining
,
632 'days_expired' => ($member->days_remaining
* -1),
633 //Handle COMPANY_NAME_ADH... https://bugs.galette.eu/issues/1530
634 '_adh_company' => $member->company_name
,
635 //Handle old names for variables ... https://bugs.galette.eu/issues/1393
636 '_adh_last_name' => $member->name
,
637 '_adh_first_name' => $member->surname
,
638 '_adh_login' => $member->login
,
639 '_adh_email' => $member->email
643 /** the list of all dynamic fields */
644 $fields = new DynamicFieldsSet($this->zdb
, $login);
645 $dynamic_fields = $fields->getList('adh');
646 $this->setDynamicFields('adh', $dynamic_fields, $member);
652 * Set dynamic fields and proceed related replacements
654 * @param string $form_name Form name
655 * @param array $dynamic_fields Dynamic fields
656 * @param mixed $object Related object (Adherent, Contribution, ...)
660 public function setDynamicFields(string $form_name, array $dynamic_fields, $object): self
662 $uform_name = strtoupper($form_name);
664 $dynamic_patterns = $this->getDynamicPatterns($form_name);
665 foreach ($dynamic_patterns as $dynamic_pattern) {
666 $pattern = trim($dynamic_pattern['pattern'], '/');
667 $key = strtolower(rtrim(ltrim($pattern, '{'), '}'));
670 if (preg_match("/^{LABEL_DYNFIELD_([0-9]+)_$uform_name}$/", $pattern, $match)) {
671 /** dynamic field label */
672 $field_id = $match[1];
673 $value = $dynamic_fields[$field_id]->getName();
675 if (preg_match("/^{(INPUT_|VALUE_)?DYNFIELD_([0-9]+)_$uform_name}$/", $pattern, $match)) {
676 /** dynamic field value */
677 $capacity = $match[1];
678 $field_id = $match[2];
679 $field_name = $dynamic_fields[$field_id]->getName();
680 $field_type = $dynamic_fields[$field_id]->getType();
682 if ($object !== null) {
683 $all_values = $object->getDynamicFields()->getValues($field_id);
684 foreach ($all_values as $field_value) {
685 $field_values[$field_value['field_val']] = $field_value['text_val'] ??
$field_value['field_val'];
691 switch ($field_type) {
692 case DynamicField
::CHOICE
:
693 if ($capacity == 'INPUT_') {
694 $choice_values = $dynamic_fields[$field_id]->getValues();
695 foreach ($choice_values as $choice_idx => $choice_value) {
696 $value .= '<input type="radio" class="box" name="' . $field_name . '" value="' . $field_id . '"';
697 if (isset($field_values[$choice_idx])) {
698 $value .= ' checked="checked"';
700 $value .= ' disabled="disabled">' . $choice_value . ' ';
703 $value .= implode(' ', $field_values);
706 case DynamicField
::FILE
:
708 case DynamicField
::TEXT
:
709 case DynamicField
::LINE
:
710 case DynamicField
::DATE
:
711 //TODO: ensure display
712 case DynamicField
::BOOLEAN
:
713 //TODO: ensure display
714 $value .= implode('<br/>', $field_values);
719 $this->setReplacements(array($key => $value));
720 Analog
::log("adding dynamic replacement $key => $value", Analog
::DEBUG
);
731 public function getLegend(): array
736 'title' => _T('Main information'),
737 'patterns' => $this->getMainPatterns()
740 $legend['member'] = [
741 'title' => _T('Member information'),
742 'patterns' => $this->getMemberPatterns(false)
749 * Get configured replacements
753 public function getReplacements(): array
755 return $this->replaces
;
761 * @param Db $db Db instance
765 public function setDb(Db
$db): self
772 * Set Login dependency
774 * @param Login $login Login instance
778 public function setLogin(Login
$login): self
780 $this->login
= $login;
785 * Set Preferences dependency
787 * @param Preferences $preferences Preferences instance
791 public function setPreferences(Preferences
$preferences): self
793 $this->preferences
= $preferences;
798 * Set Router dependency
800 * @param Router $router Router instance
804 public function setRouter(Router
$router): self
806 $this->router
= $router;
811 * Proceed replacement on given entry
813 * @param string $source Source string
817 protected function proceedReplacements(string $source): string
821 //handle translations
822 $callback = static function ($matches) {
823 return _T($matches[1]);
825 $replaced = preg_replace_callback(
826 '/_T\("([^\"]+)"\)/',
832 ksort($this->patterns
, SORT_NATURAL
);
833 ksort($this->replaces
, SORT_NATURAL
);
835 if (array_keys($this->patterns
) !== array_keys($this->replaces
)) {
836 throw new \
RuntimeException('Patterns and replacements does not match!');
839 //handle replacements
840 $replaced = preg_replace(
846 //handle translations with replacements
847 $repl_callback = static function ($matches) {
854 $replaced = preg_replace_callback(
855 '/str_replace\(\'([^,]+)\', ?\'([^,]+)\', ?\'(.*)\'\)/',
868 public function getPatterns(): array
870 return $this->patterns
;