QuickFormQuery.php 34.1 KB
Newer Older
1
2
3
4
5
6
7
8
<?php
/**
 * Created by PhpStorm.
 * User: ep
 * Date: 12/23/15
 * Time: 6:33 PM
 */

Carsten  Rose's avatar
Carsten Rose committed
9

10
11
namespace qfq;

Carsten  Rose's avatar
Carsten Rose committed
12
use qfq;
13
14
15
16
17
18
19
20
21

//use qfq\Report;

//use qfq\BuildFormPlain;
//use qfq\BuildFormTable;
//use qfq\BuildFormBootstrap;
//use qfq\UserException;
//use qfq\CodeException;
//use qfq\DbException;
22
//use qfq\helper;
23
//use qfq\Store;
Carsten  Rose's avatar
Carsten Rose committed
24

Carsten  Rose's avatar
Carsten Rose committed
25

26
27
28
29
30
31
32
33
34
35
36
require_once(__DIR__ . '/store/Store.php');
require_once(__DIR__ . '/store/FillStoreForm.php');
require_once(__DIR__ . '/store/Session.php');
require_once(__DIR__ . '/Constants.php');
require_once(__DIR__ . '/Save.php');
require_once(__DIR__ . '/helper/KeyValueStringParser.php');
require_once(__DIR__ . '/helper/HelperFormElement.php');
require_once(__DIR__ . '/exceptions/UserFormException.php');
require_once(__DIR__ . '/exceptions/CodeException.php');
require_once(__DIR__ . '/exceptions/DbException.php');
require_once(__DIR__ . '/exceptions/ErrorHandler.php');
37
38
require_once(__DIR__ . '/database/Database.php');
require_once(__DIR__ . '/database/DatabaseUpdate.php');
39
40
41
42
43
44
45
require_once(__DIR__ . '/Evaluate.php');
require_once(__DIR__ . '/BuildFormPlain.php');
require_once(__DIR__ . '/BuildFormTable.php');
require_once(__DIR__ . '/BuildFormBootstrap.php');
require_once(__DIR__ . '/report/Report.php');
require_once(__DIR__ . '/BodytextParser.php');
require_once(__DIR__ . '/Delete.php');
46
require_once(__DIR__ . '/form/FormAction.php');
47

48
49
50
51
52
53
54
55
56
57
58
59
/*
 * Form will be called
 * a) with a SIP identifier, or
 * b) without a SIP identifier (form setting has to allow this) and will create on the fly a new SIP.
 *
 * The SIP-Store stores:
 *  form=<formname>
 *  r=<record id>  (table.id for a single record form)
 *  keySemId,keySemIduser
 *  <further individual variables>
 */

Carsten  Rose's avatar
Carsten Rose committed
60
/**
61
 * Class Qfq
Carsten  Rose's avatar
Carsten Rose committed
62
63
 * @package qfq
 */
64
class QuickFormQuery {
65

66
    /**
67
     * @var \qfq\Store instantiated class
68
     */
Carsten  Rose's avatar
Carsten Rose committed
69
    protected $store = null;
70

71
72
73
    /**
     * @var Database instantiated class
     */
74
    protected $db = null;
75

76
77
78
79
    /**
     * @var Evaluate instantiated class
     */
    protected $eval = null;
80
81
82
    protected $formSpec = array();
    protected $feSpecAction = array();  // Form Definition: copy of the loaded form
    protected $feSpecNative = array(); // FormEelement Definition: all formElement.class='action' of the loaded form
83

84
85
86
87
    /**
     * @var array
     */
    private $t3data = array(); // FormEelement Definition: all formElement.class='native' of the loaded form
88

89
90
91
    /**
     * @var bool
     */
92
93
    private $phpUnit = false;

94
95
96
97
98
    /**
     * @var Session
     */
    private $session = null;

99
100
101
102
103
104
105
106
107
108
109
    /*
     * TODO:
     *  Preparation: setup logging, database access, record locking
     *  fill stores
     *  Check permission_create / permission_update
     *  Multi: iterate over all records, Single: activate record
     *      Check mode: Load | Save
     *      doActions 'Before'
     *      Do all FormElements
     *      doActions 'After'
     */
110

111
112
113
114
115
    /**
     * Construct the Form Class and Store too. This is the base initialization moment.
     *
     * As a result of instantiating of Form, the class Store will initially called the first time and therefore instantiated automatically.
     * Store might throw an exception, in case the URL-passed SIP is invalid.
116
     *
117
118
119
120
     * @param array $t3data
     * @param bool $phpUnit
     * @throws CodeException
     * @throws UserFormException
121
     */
122
123
    public function __construct(array $t3data = array(), $phpUnit = false) {

124
125
        $this->phpUnit = $phpUnit;

126
        mb_internal_encoding("UTF-8");
127

128
129
        $this->session = Session::getInstance($phpUnit);

130
        // Refresh the session even if no new data saved.
131
        Session::set('LAST_ACTIVITY', time());
132

133
        set_error_handler("\\qfq\\ErrorHandler::exception_error_handler");
134

135
136
137
138
139
140
141
        if (!isset($t3data[T3DATA_BODYTEXT])) {
            $t3data[T3DATA_BODYTEXT] = '';
        }

        if (!isset($t3data[T3DATA_UID])) {
            $t3data[T3DATA_UID] = 0;
        }
142

143
        $btp = new BodytextParser();
144
        $t3data[T3DATA_BODYTEXT] = $btp->process($t3data[T3DATA_BODYTEXT]);
145

146
147
        $this->t3data = $t3data;

148
        $bodytext = $this->t3data[T3DATA_BODYTEXT];
149
150

        $this->store = Store::getInstance($bodytext, $phpUnit);
151
        $this->store->setVar(TYPO3_TT_CONTENT_UID, $t3data[T3DATA_UID], STORE_TYPO3);
152
        $this->db = new Database();
153

154
        $this->eval = new Evaluate($this->store, $this->db);
155
156
157
158
159
160

        $config = $this->store->getStore(STORE_SYSTEM);

        $updateDb = new DatabaseUpdate($this->db);
        $updateDb->checkNupdate($config[SYSTEM_DB_SERVER], $config[SYSTEM_DB_USER], $config[SYSTEM_DB_PASSWORD], $config[SYSTEM_DB_NAME]);

Carsten  Rose's avatar
Carsten Rose committed
161
162
    }

163
    /**
Carsten  Rose's avatar
Carsten Rose committed
164
     * Returns the defined forwardMode and set $forwardPage (call be reference)
165
     *
166
167
168
169
170
171
172
173
     * @param $forwardPage
     * @return mixed
     */
    public function getForwardMode(&$forwardPage) {
        $forwardPage = $this->formSpec['forwardPage'];
        return $this->formSpec['forwardMode'];
    }

174
    /**
Carsten  Rose's avatar
Carsten Rose committed
175
     * Main entrypoint for display content: a) form and/or b) report
176
     *
177
     * @return string
Carsten  Rose's avatar
Carsten Rose committed
178
     */
179
    public function process() {
180
        $html = '';
181

182
        if ($this->store->getVar(TYPO3_DEBUG_SHOW_BODY_TEXT, STORE_TYPO3) === 'yes') {
183
184
            $htmlId = HelperFormElement::buildFormElementId($this->formSpec[F_ID], 0, 0, 0);
            $html .= Support::doTooltip($htmlId . HTML_ID_EXTENSION_TOOLTIP, $this->t3data['bodytext']);
185
186
187
        }

        $html .= $this->doForm(FORM_LOAD);
188
        $html .= $this->doReport();
Carsten  Rose's avatar
Carsten Rose committed
189

190
        // Only needed if there are potential 'download'-links, which shall show a popup during processing of the download.
Carsten  Rose's avatar
Carsten Rose committed
191
192
193
194
        if ($this->store->getVar(SYSTEM_DOWNLOAD_POPUP, STORE_SYSTEM) == DOWNLOAD_POPUP_REQUEST) {
            $html .= $this->getModalCode();
        }

195
        $class = $this->store->getVar(SYSTEM_CSS_CLASS_QFQ_CONTAINER, STORE_SYSTEM);
Carsten  Rose's avatar
Carsten Rose committed
196
        if ($class) {
197
            $html = Support::wrapTag("<div class='$class'>", $html);
Carsten  Rose's avatar
Carsten Rose committed
198
199
        }

200
        return $html;
201
202
    }

203
    /**
204
     * Process form.
205
206
207
208
209
     * $mode=
     *   FORM_LOAD: The whole form will be rendered as HTML Code, including the values of all form elements
     *   FORM_UPDATE: States and values of all form elements will be returned as JSON.
     *   FORM_SAVE: The submitted form will be saved. Return Failure or Success as JSON.
     *   FORM_DELETE:
210
     *
211
     * @param string $formMode FORM_LOAD | FORM_UPDATE | FORM_SAVE | FORM_DELETE
212
     * @return array|string
213
     * @throws CodeException
214
     * @throws UserFormException
215
     */
216
    private function doForm($formMode) {
Carsten  Rose's avatar
Carsten Rose committed
217
        $data = '';
Carsten  Rose's avatar
Carsten Rose committed
218
        $foundInStore = '';
219

Carsten  Rose's avatar
Carsten Rose committed
220
        // Fill STORE_FORM
221
        if ($formMode === FORM_UPDATE || $formMode === FORM_SAVE) {
Carsten  Rose's avatar
Carsten Rose committed
222
223
224
            $fillStoreForm = new FillStoreForm();
            $fillStoreForm->process();
        }
225

226
227
228
        $recordId = $this->store->getVar(SIP_RECORD_ID, STORE_SIP . STORE_TYPO3 . STORE_CLIENT);

        $formName = $this->loadFormSpecification($formMode, $recordId, $foundInStore);
229
        if ($formName === false && $formMode !== FORM_DELETE) {
230
            // No form found: do nothing
231
            return '';
232
        }
233

234
235
        if ($formName !== false) {
            // Validate only if there is a 'real' form (not a FORM_DELETE with only a tablename).
236
            $sipFound = $this->validateForm($foundInStore, $formMode);
237
238

        } else {
239
            // FORM_DELETE without a form definition: Fake the form with only a tableName.
240
241
            $table = $this->store->getVar(SIP_TABLE, STORE_SIP);
            if ($table === false) {
242
                throw new UserFormException("No 'form' and no 'table' definition found.", ERROR_MISSING_VALUE);
243
244
245
246
247
248
            }
            $sipFound = true;
            $this->formSpec[F_NAME] = '';
            $this->formSpec[F_TABLE_NAME] = $table;
        }

249
250
        // For 'new' record always create a new Browser TAB-uniq (for this current form, nowhere else used) SIP.
        // With such a Browser TAB-uniq SIP, multiple Browser TABs and following repeated NEWs are easily implemented.
251
        if (!$sipFound || ($formMode == FORM_LOAD && $recordId == 0)) {
252
253
            $this->store->createSipAfterFormLoad($formName);
        }
254

255
256
257
258
        if ($this->store->getVar('id', STORE_BEFORE) === false) {
            $this->fillStoreWithRecord($this->formSpec[F_TABLE_NAME], $recordId, STORE_BEFORE);
        }

259
        if ($formMode === FORM_DELETE) {
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278

            $build = new Delete();

        } else {
            $this->store->fillStoreTableDefaultColumnType($this->formSpec[F_TABLE_NAME]);

            switch ($this->formSpec['render']) {
                case 'plain':
                    $build = new BuildFormPlain($this->formSpec, $this->feSpecAction, $this->feSpecNative);
                    break;
                case 'table':
                    $build = new BuildFormTable($this->formSpec, $this->feSpecAction, $this->feSpecNative);
                    break;
                case 'bootstrap':
                    $build = new BuildFormBootstrap($this->formSpec, $this->feSpecAction, $this->feSpecNative);
                    break;
                default:
                    throw new CodeException("This statement should never be reached", ERROR_CODE_SHOULD_NOT_HAPPEN);
            }
279
280
        }

Carsten  Rose's avatar
#2067    
Carsten Rose committed
281
        $formAction = new FormAction($this->formSpec, $this->db, $this->phpUnit);
282
        switch ($formMode) {
283
            case FORM_LOAD:
284
285
286
287
288
289
290
291
                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_BEFORE_LOAD);
                $data = $build->process($formMode);
                $data = Support::wrapTag("<div class='" . 'col-md-' . $this->formSpec[F_BS_COLUMNS] . "'>", $data);
                $data = Support::wrapTag("<div class='row'>", $data);

                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_AFTER_LOAD);
                break;

Carsten  Rose's avatar
Carsten Rose committed
292
            case FORM_UPDATE:
293

294
                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_BEFORE_LOAD);
295
296
                // data['form-update']=....
                $data = $build->process($formMode);
297
                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_AFTER_LOAD);
298
                break;
Carsten  Rose's avatar
Carsten Rose committed
299

300
301
302
303
304
305
306
307
            case FORM_DELETE:
                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_BEFORE_DELETE);

                $build->process($this->formSpec[F_TABLE_NAME], $recordId);

                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_AFTER_DELETE);
                break;

308
            case FORM_SAVE:
309
310
                $recordId = $this->store->getVar(SIP_RECORD_ID, STORE_SIP);

311
                // Action: Before
312
313
                $formAction->elements($recordId, $this->feSpecAction, FE_TYPE_BEFORE_INSERT . ',' . FE_TYPE_BEFORE_UPDATE . ',' . FE_TYPE_BEFORE_SAVE);

314
                // If an old record exist: load it. Necessary to delete uploaded files which should be overwritten.
315
                $this->fillStoreWithRecord($this->formSpec[F_TABLE_NAME], $recordId, STORE_RECORD);
316

317
                // SAVE
318
                $save = new Save($this->formSpec, $this->feSpecAction, $this->feSpecNative);
319
320
                $rc = $save->process();

321
                // Reload fresh saved record and fill STORE_RECORD with it.
322
                $this->fillStoreWithRecord($this->formSpec[F_TABLE_NAME], $rc, STORE_RECORD);
323

Carsten  Rose's avatar
Upload:    
Carsten Rose committed
324
325
                $save->processAllUploads($rc);

326
                // Action: After
327
328
329
                $modified = $formAction->elements($rc, $this->feSpecAction, FE_TYPE_AFTER_INSERT . ',' . FE_TYPE_AFTER_UPDATE . ',' . FE_TYPE_AFTER_SAVE);
                if ($modified) {
                    // Reload fresh saved record and fill STORE_RECORD with it.
330
                    $this->fillStoreWithRecord($this->formSpec[F_TABLE_NAME], $rc, STORE_RECORD);
331
                }
332

333
334
335
336
                $htmlElementNameIdZero = false;
                // Retrieve current STORE_SIP.
                $sipArray = $this->store->getStore(STORE_SIP);
                if ($sipArray[SIP_RECORD_ID] == 0) {
337
                    // After insert: a new SIP for the new record id is required.
Carsten  Rose's avatar
#2067    
Carsten Rose committed
338
                    $this->newRecordUpdateSip($rc);
339
340
                    $htmlElementNameIdZero = true;
                }
341

342
                // Action: Sendmail
343
                $formAction->elements($rc, $this->feSpecAction, FE_TYPE_SENDMAIL);
344

345
                // Retrieve FE Values as JSON
346
                // $data['form-update']=...
347
                $data = $build->process($formMode, $htmlElementNameIdZero);
348
                break;
Carsten  Rose's avatar
Carsten Rose committed
349

350
351
352
353
            default:
                throw new CodeException("This statement should never be reached", ERROR_CODE_SHOULD_NOT_HAPPEN);
        }

354
        if (is_array($data)) {
355
            // $data['element-update']=...
356
357
            $data = $this->groupElementUpdateEntries($data);
        }
Carsten  Rose's avatar
Carsten Rose committed
358
        return $data;
359
360
    }

361
    /**
362
     * Load form. Evaluates form. Load FormElements.
363
     *
Carsten  Rose's avatar
Carsten Rose committed
364
     * After processing:
365
366
367
368
     * Loaded Form is in  $this->formSpec
     * Loaded 'action' FormElements are in $this->feSpecAction
     * Loaded 'native' FormElements are in $this->feSpecNative
     *
Carsten  Rose's avatar
Carsten Rose committed
369
     * @param string $mode FORM_LOAD|FORM_SAVE|FORM_UPDATE
370
     * @param int $recordId
Carsten  Rose's avatar
Carsten Rose committed
371
372
373
     * @param string $foundInStore
     * @return bool|string if found the formName, else 'false'.
     * @throws CodeException
374
     * @throws DbException
375
     * @throws UserFormException
376
     */
377
    private function loadFormSpecification($mode, $recordId, &$foundInStore = '') {
Carsten  Rose's avatar
Carsten Rose committed
378

379
        // formName
Carsten  Rose's avatar
Carsten Rose committed
380
        if (false === ($formName = $this->getFormName($mode, $foundInStore))) {
381
382
            return false;
        }
383

384
385
386
387
        if (!$this->db->existTable('Form')) {
            throw new UserFormException("Table 'Form' not found", ERROR_MISSING_TABLE);
        }

388
        // Preparation for Log, Debug
389
        $this->store->setVar(SYSTEM_FORM, $formName, STORE_SYSTEM);
Carsten  Rose's avatar
Carsten Rose committed
390

391
392
393
394
395
396
397
        // Check if there is a recordId specified in Bodytext - as variable or query.
        $rTmp = $this->store->getVar(CLIENT_RECORD_ID, STORE_TYPO3, SANITIZE_ALLOW_ALL);
        if (false !== $rTmp && !is_int($rTmp)) {
            $rTmp = $this->eval->parse($rTmp);
            $this->store->setVar(CLIENT_RECORD_ID, $rTmp, STORE_TYPO3);
        }

398
        // Load form
399
        $form = $this->db->sql("SELECT * FROM Form AS f WHERE f." . F_NAME . " LIKE ? AND f.deleted='no'", ROW_EXPECT_1,
400
            [$formName], 'Form not found or multiple forms with the same name.');
401

402
        $form = $this->modeCleanFormConfig($mode, $form);
403

404
        $formSpec = $this->eval->parseArray($form);
405
        HelperFormElement::explodeParameter($formSpec, F_PARAMETER);
406

407
408
        $formSpec = $this->syncSystemFormConfig($formSpec);
        $formSpec = $this->initForm($formSpec);
409
410

        // Set F_FINAL_DELETE_FORM
411
        $formSpec[F_FINAL_DELETE_FORM] = ($formSpec[F_EXTRA_DELETE_FORM] != '') ? $formSpec[F_EXTRA_DELETE_FORM] : $formSpec[F_NAME];
412

413
        $this->formSpec = $formSpec;
414

415
416
417
        // this is needed for filling templateGroup records with their default values
        $this->fillStoreWithRecord($this->formSpec[F_TABLE_NAME], $recordId, STORE_RECORD);

Carsten  Rose's avatar
Carsten Rose committed
418
        // Clear
419
420
        $this->store->setVar(SYSTEM_FORM_ELEMENT, '', STORE_SYSTEM);

421
        // FE: Action
422
        $this->feSpecAction = $this->db->sql(SQL_FORM_ELEMENT_ALL_CONTAINER, ROW_REGULAR, ['no', $this->formSpec["id"], 'action']);
423
        HelperFormElement::explodeParameterInArrayElements($this->feSpecAction, FE_PARAMETER);
424
425

        // FE: Native & Container
426
427
428
        // "SELECT *, ? AS 'nestedInFieldSet' FROM FormElement AS fe WHERE fe.formId = ? AND fe.deleted = 'no' AND FIND_IN_SET(fe.class, ? ) AND fe.feIdContainer = ? AND fe.enabled='yes' ORDER BY fe.ord, fe.id";
        switch ($mode) {
            case FORM_LOAD:
429
                // Select all Native elements (native, pill, fieldset, templateGroup) which are NOT nested = Root level.
430
                $this->feSpecNative = $this->db->getNativeFormElements(SQL_FORM_ELEMENT_SPECIFIC_CONTAINER, ['no', $this->formSpec["id"], 'native,container', 0], $this->formSpec);
431
432
433
                break;

            case FORM_SAVE:
Carsten  Rose's avatar
Carsten Rose committed
434
            case FORM_UPDATE:
435
//                $this->feSpecNative = $this->db->getNativeFormElements(SQL_FORM_ELEMENT_ALL_CONTAINER, ['no', $this->formSpec["id"], 'native'], $this->formSpec);
436
437

            $this->feSpecNative = $this->getNativeFormElements(SQL_FORM_ELEMENT_NATIVE_TG_COUNT, [$this->formSpec["id"]], $this->formSpec);
438
439
                break;

440
441
442
443
            case FORM_DELETE:
                $this->feSpecNative = array();
                break;

444
            default:
445
                break;
446
447
        }

448
        return $formName;
Carsten  Rose's avatar
Carsten Rose committed
449
450
    }

451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
    /**
     * Depending on $sql reads FormElements to a specific container or all. Preprocess all FormElements.
     * This code is dirty: the nearly same function exists in class 'Database' - the difference is only 'explodeTemplateGroupElements()'.
     *
     * @param string $sql SQL_FORM_ELEMENT_SPECIFIC_CONTAINER | SQL_FORM_ELEMENT_ALL_CONTAINER
     * @param array $param Parameter which matches the prepared statement in $sql
     * @param array $formSpec Main FormSpec to copy generic parameter to FormElements
     * @return array|int
     * @throws \qfq\CodeException
     * @throws \qfq\DbException
     */
    public function getNativeFormElements($sql, array $param, $formSpec) {

        $feSpecNative = $this->db->sql($sql, ROW_REGULAR, $param);

        // Explode and Do $FormElement.parameter
        HelperFormElement::explodeParameterInArrayElements($feSpecNative, FE_PARAMETER);

        // Check for retype FormElements which have to duplicated.
        $feSpecNative = HelperFormElement::duplicateRetypeElements($feSpecNative);

        // Check for templateGroup Elements to explode them
        $feSpecNative = $this->explodeTemplateGroupElements($feSpecNative);

        // Copy Attributes to FormElements
        $feSpecNative = HelperFormElement::copyAttributesToFormElements($formSpec, $feSpecNative);

        return $feSpecNative;
    }

    /**
     * Iterate over all FormElements in $elements. If a row has a column NAME_TG_COPIES, copy those elements NAME_TG_COPIES-times.
     * Adjust FE_TEMPLATE_GROUP_NAME_PATTERN (='%d') with current count on column FE_NAME and FE_LABEL.
     *
     * This code is dirty: only to get JSON value, we have to initialize the STORE_RECORD (done earlier) to be capable to
     *  parse fe[FE_VALUE], which probably contains as string like '{{!SELECT value FROM table WHERE xId={{id}} ORDER BY id}}' -
     *  the {{id}} needs to be replaced by the current recordId (primary record).
     *
     * Attention: The resulting order of the FormElements, is not the same as on the Form during FormLoad!
     *
     * @param array $elements
     * @return array
     */
    private function explodeTemplateGroupElements(array $elements) {
        $new = array();

        // No FormElements or no NAME_TG_COPIES column: nothing to do, return.
        if ($elements == array() || count($elements) == 0 || !isset($elements[0][NAME_TG_COPIES])) {
            return $elements;
        }

        // Iterate over all
        foreach ($elements as $row) {
            if (isset($row[NAME_TG_COPIES]) && $row[NAME_TG_COPIES] > 0) {
                $row[FE_VALUE] = $this->eval->parse($row[FE_VALUE]);
                for ($ii = 1; $ii <= $row[NAME_TG_COPIES]; $ii++) {
                    $tmpRow = $row;
                    if (is_array($row[FE_VALUE])) {
                        $tmpRow[FE_VALUE] = ($ii <= count($row[FE_VALUE])) ? current($row[FE_VALUE][$ii - 1]) : '';
                    }
                    unset($tmpRow[NAME_TG_COPIES]);
                    $tmpRow[FE_NAME] = str_replace(FE_TEMPLATE_GROUP_NAME_PATTERN, $ii, $tmpRow[FE_NAME]);
                    $tmpRow[FE_LABEL] = str_replace(FE_TEMPLATE_GROUP_NAME_PATTERN, $ii, $tmpRow[FE_LABEL]);
                    $new[] = $tmpRow;
                }
            } else {
                $new[] = $row;
            }
        }
        return $new;
    }


Carsten  Rose's avatar
Carsten Rose committed
524
    /**
525
526
     * Get the formName from STORE_TYPO3 (bodytext), STORE_SIP or by STORE_CLIENT (URL).
     *
527
528
529
530
531
532
533
534
535
536
537
538
     * FORM_LOAD:
     *   Specified in T3 body text with form=<formname>            Returned Store:Typo3
     *   Specified in T3 body text with form={{form}} ':FSRD'      Returned Store:SIP
     *   Specified in T3 body text with form={{form:C:ALNUMX}}     Returned Store:Client
     *   Specified in T3 body text with form={{SELECT registrationFormName FROM Conference WHERE id={{conferenceId:S0}} }}
     *   Specified in T3 body text with form={{SELECT registrationFormName FROM Conference WHERE id={{conferenceId:C0:DIGIT}} }}
     *   Specified in SIP
     *
     * FORM_SAVE:
     *   Specified in SIP
     *
     *
Carsten  Rose's avatar
Carsten Rose committed
539
     * @param string $mode FORM_LOAD|FORM_SAVE|FORM_UPDATE
Carsten  Rose's avatar
Carsten Rose committed
540
     * @param string $foundInStore
541
     * @return bool|string  Formname (Form.name) or FALSE (if no formname found)
Carsten  Rose's avatar
Carsten Rose committed
542
     * @throws CodeException
543
     * @throws UserFormException
Carsten  Rose's avatar
Carsten Rose committed
544
     */
545
    public function getFormName($mode, &$foundInStore = '') {
546
        $dummy = array();
Carsten  Rose's avatar
Carsten Rose committed
547

Carsten  Rose's avatar
Carsten Rose committed
548
549
550
551
552
553
        switch ($mode) {
            case FORM_LOAD:
                $store = STORE_TYPO3;
                break;
            case FORM_SAVE:
            case FORM_UPDATE:
554
555
            case FORM_DELETE:
                $store = STORE_SIP;
Carsten  Rose's avatar
Carsten Rose committed
556
557
558
559
560
                break;
            default:
                throw new CodeException("Unknown mode: $mode.", ERROR_UNKNOWN_MODE);
        }

561
562
        $storeFormName = $this->store->getVar(SIP_FORM, $store, '', $foundInStore);
        $formName = $this->eval->parse($storeFormName, 0, $dummy, $foundInStore);
Carsten  Rose's avatar
Carsten Rose committed
563

564
565
566
567
//        if($mode===FORM_DELETE && $formName===false) {
//            return "";
//        }

568
        // If the formname is '': no formname name.
569
        if ($formName === '' || $foundInStore === '')
570
571
572
573
574
575
            return false;

        // If the formname is surrounded by single ticks: the token (typically 'form') has not been replaced by a value.
        if ($formName[0] === "'" && $formName[strlen($formName) - 1] === "'") {
            return false;
        }
576

577
        return $formName;
578
    }
Carsten  Rose's avatar
Carsten Rose committed
579

580
581
582
583
584
585
586
587
    /**
     * Depending on $mode various formSpec fields might be adjusted.
     * E.g.: the form title is not important during a delete.
     *
     * @param $mode
     * @param array $form
     * @return array
     */
588
    private function modeCleanFormConfig($mode, array $form) {
589
590
591
592
593
594
595
596
597
598
599
600

        switch ($mode) {
            case FORM_DELETE:
                $form[F_TITLE] = '';
                break;
            default:
                break;
        }

        return $form;
    }

601
    /**
602
603
604
605
606
607
     * The named $keys will be synced between STORE_SYSTEM and $formSpec (both directions).
     * The per form definition has precedence over STORE_SYSTEM.
     * STORE_SYSTEM if filled with the default values (config.qfq.ini or if note exist than QFQ hardcoded)
     * Copying the 'Form' definition back to the system store helps to access the values
     * by '{{ ...:Y}}' (system store). E.g. the value of bs-*-columns might be displayed as placeholder in the
     * corresponding inputfield.
608
     *
609
610
611
     * @param array $formSpec
     * @return array
     */
612
613
    private function syncSystemFormConfig(array $formSpec) {

614
615
        $keys = [F_BS_COLUMNS,
            F_BS_LABEL_COLUMNS,
616
617
618
619
620
621
622
623
624
            F_BS_INPUT_COLUMNS,
            F_BS_NOTE_COLUMNS,
            F_FE_DATA_PATTERN_ERROR,
            F_FE_DATA_REQUIRED_ERROR,
            F_FE_DATA_MATCH_ERROR,
            F_FE_DATA_ERROR,
            F_CLASS,
            F_CLASS_PILL,
            F_CLASS_BODY,
625
            F_BUTTON_ON_CHANGE_CLASS,
626
            F_ESCAPE_TYPE_DEFAULT,
627
628
629
630
        ];

        // By definition: existing vars which are empty, means: EMPTY - do not use any default!
        // But: if these variables are table columns, they always exist. For those: empty value means 'not set' - unset those.
631
        foreach ([F_BS_LABEL_COLUMNS, F_BS_INPUT_COLUMNS, F_BS_NOTE_COLUMNS, F_ESCAPE_TYPE_DEFAULT] as $key) {
632
633
634
635
            if ($formSpec[$key] == '') {
                unset ($formSpec[$key]);
            }
        }
636

637
        foreach ($keys as $key) {
638

639
640
641
642
643
644
645
            if (isset($formSpec[$key])) {
                $this->store->setVar($key, $formSpec[$key], STORE_SYSTEM);
            } else {
                // if not found set ''
                $formSpec[$key] = $this->store->getVar($key, STORE_SYSTEM . STORE_EMPTY);
            }
        }
646

647
648
        return $formSpec;
    }
649

650
651
652
    /**
     * Set form parameter which are expected to exist.
     *
Carsten  Rose's avatar
Carsten Rose committed
653
     * @param array $formSpec
654
655
     * @return array
     */
Carsten  Rose's avatar
Carsten Rose committed
656
657
658
659
660
661
662
663
664
665
666
    private function initForm(array $formSpec) {
        Support::setIfNotSet($formSpec, F_EXTRA_DELETE_FORM, '');
        Support::setIfNotSet($formSpec, F_SUBMIT_BUTTON_TEXT, '');
        Support::setIfNotSet($formSpec, F_BUTTON_ON_CHANGE_CLASS, '');
        Support::setIfNotSet($formSpec, F_LDAP_USE_BIND_CREDENTIALS, '');
        Support::setIfNotSet($formSpec, F_MODE, '');

        if ($formSpec[F_MODE] == F_MODE_READONLY) {
            $formSpec[F_SHOW_BUTTON] = FORM_BUTTON_CLOSE;
            $formSpec[F_SUBMIT_BUTTON_TEXT] = '';
        }
667

668
669
670
671
        if ($formSpec[F_ESCAPE_TYPE_DEFAULT] == '') {
            $formSpec[F_ESCAPE_TYPE_DEFAULT] = $this->store->getVar(F_ESCAPE_TYPE_DEFAULT, STORE_SYSTEM);
        }

Carsten  Rose's avatar
Carsten Rose committed
672
        return $formSpec;
673
674
    }

675
    /**
Carsten  Rose's avatar
Carsten Rose committed
676
     * Check if loading of the given form is permitted. If not, throw an exception.
677
     *
Carsten  Rose's avatar
Carsten Rose committed
678
679
     * @param $formNameFoundInStore
     * @return bool 'true' if SIP exists, else 'false'
680
     * @throws CodeException
681
     * @throws UserFormException
Carsten  Rose's avatar
Carsten Rose committed
682
     * @internal param $foundInStore
683
     */
684
    private function validateForm($formNameFoundInStore, $formMode) {
685
686

        // Retrieve record_id either from SIP (prefered) or via URL
687
        $r = $this->store->getVar(SIP_RECORD_ID, STORE_SIP . STORE_TYPO3 . STORE_CLIENT, '', $recordIdFoundInStore);
688

Carsten  Rose's avatar
Carsten Rose committed
689
        // Set missing 'r'.
690
        if ($r === false) {
691
692
693
            $r = 0;
            $this->store->setVar(TYPO3_RECORD_ID, $r, STORE_TYPO3);
            $recordIdFoundInStore = STORE_TYPO3;
694
695
        }

Carsten  Rose's avatar
Carsten Rose committed
696
        // If there is a record_id>0: EDIT else NEW: 'sip','logged_in','logged_out','always','never'
697
        $permitMode = ($r > 0) ? $this->formSpec['permitEdit'] : $this->formSpec['permitNew'];
698
699
700
701
702

        $feUserLoggedIn = isset($GLOBALS["TSFE"]->fe_user->user["uid"]) && $GLOBALS["TSFE"]->fe_user->user["uid"] > 0;

        $sipFound = $this->store->getVar(SIP_SIP, STORE_SIP) !== false;

Carsten  Rose's avatar
Carsten Rose committed
703
704
        if ($sipFound) {
            if (($formNameFoundInStore === STORE_CLIENT) || ($recordIdFoundInStore === STORE_CLIENT)) {
705
                throw new UserFormException("SIP exist but FORM or RECORD_ID are given by CLIENT.", ERROR_SIP_EXIST_BUT_OTHER_PARAM_GIVEN_BY_CLIENT);
Carsten  Rose's avatar
Carsten Rose committed
706
707
708
            }
        }

709
        switch ($permitMode) {
710
            case  FORM_PERMISSION_SIP:
Carsten  Rose's avatar
Carsten Rose committed
711
                if (!$sipFound || $formNameFoundInStore !== STORE_SIP || $recordIdFoundInStore !== STORE_SIP) {
712
                    throw new UserFormException("SIP Parameter needed for this form.", ERROR_SIP_NEEDED_FOR_THIS_FORM);
713
714
715
716
                }
                break;
            case  FORM_PERMISSION_LOGGED_IN:
                if (!$feUserLoggedIn) {
717
                    throw new UserFormException("User not logged in.", ERROR_USER_NOT_LOGGED_IN);
718
719
720
721
                }
                break;
            case FORM_PERMISSION_LOGGED_OUT:
                if ($feUserLoggedIn) {
722
                    throw new UserFormException("User logged in.", ERROR_USER_LOGGED_IN);
723
724
725
726
727
                }
                break;
            case FORM_PERMISSION_ALWAYS:
                break;
            case FORM_PERMISSION_NEVER:
728
                throw new UserFormException("Loading form forbidden.", ERROR_FORM_FORBIDDEN);
729
            default:
730
                throw new CodeException("Unknown permission mode: '" . $permitMode . "'", ERROR_FORM_UNKNOWN_PERMISSION_MODE);
731
        }
Carsten  Rose's avatar
Carsten Rose committed
732

Carsten  Rose's avatar
Carsten Rose committed
733
        // Form Definition valid?
734
        if ($this->formSpec['multiMode'] !== 'none' && $this->formSpec['multiSql'] === '') {
735
            throw new UserFormException("MultiMode selected, but MultiSQL missing", ERROR_MULTI_SQL_MISSING);
Carsten  Rose's avatar
Carsten Rose committed
736
737
        }

738
739
740
741
742
        if ($formMode !== FORM_DELETE) {
            $sipArray = $this->store->getStore(STORE_SIP);
            // Check: requiredParameter: '' or 'form' or 'form,grId' or 'form #formname for form,grId'
            $param = explode(',', $this->formSpec[F_REQUIRED_PARAMETER]);
            foreach ($param AS $name) {
743

744
745
                $name = explode('#', $name, 2);
                $name = trim($name[0]);
746

747
748
749
                if ($name === '') {
                    continue;
                }
750

751
752
753
                if (!isset($sipArray[$name])) {
                    throw new UserFormException("Missing required SIP parameter: $name", ERROR_MISSING_REQUIRED_PARAMETER);
                }
754
755
756
            }
        }

757
        return $sipFound;
758
    }
Carsten  Rose's avatar
Carsten Rose committed
759

760
    /**
761
     * Load record $id from $table and saves them in $store
Carsten  Rose's avatar
Carsten Rose committed
762
     *
763
764
765
     * @param string $table tablename from where to load record wiht $recordId
     * @param string $recordId record ID of current record
     * @param string $store name of store where to save the record
766
767
768
769
     * @throws CodeException
     * @throws DbException
     * @throws UserFormException
     */
770
    private function fillStoreWithRecord($table, $recordId, $store = STORE_RECORD) {
771
772
        if ($recordId !== false && $recordId > 0) {
            $record = $this->db->sql("SELECT * FROM $table WHERE id = ?", ROW_EXPECT_1, [$recordId]);
773
            $this->store->setStore($record, $store, true);
774
775
776
        }
    }

777
    /**
Carsten  Rose's avatar
Carsten Rose committed
778
779
     * Update current SIP Store with new $recordId and update SESSION store.
     *
780
     * @param $recordId
Carsten  Rose's avatar
Carsten Rose committed
781
782
     * @throws CodeException
     * @throws UserFormException
783
     */
Carsten  Rose's avatar
#2067    
Carsten Rose committed
784
785
786
    private function newRecordUpdateSip($recordId) {
        // Update current SIP store with new RecordID
        $sipArray = $this->store->getStore(STORE_SIP);
Carsten  Rose's avatar
Carsten Rose committed
787
788
789
790
791

        if (isset($sipArray[SIP_RECORD_ID]) && $sipArray[SIP_RECORD_ID] > 0) {
            throw new CodeException('Attemp to overwrite existing record id: SIP(otf)=' . $sipArray[SIP_SIP] . " existing_r=" . $sipArray[SIP_RECORD_ID] . " new_r=" . $recordId, ERROR_OVERWRITE_RECORD_ID);
        }

Carsten  Rose's avatar
#2067    
Carsten Rose committed
792
        $sipArray[SIP_RECORD_ID] = $recordId;
793
        $this->store->setStore($sipArray, STORE_SIP, true);
794

Carsten  Rose's avatar
#2067    
Carsten Rose committed
795
796
        // Update SIP urlparam
        store::getSipInstance()->updateSipToSession($sipArray);
797
798
799

    }

800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
    /**
     * Searches the whole array $dataArray on the second level for API_ELEMENT_UPDATE.
     * All found elements collect under $collect[API_ELEMENT_UPDATE]... . Leave the rest unchanged.
     *
     * @param array $dataArray
     * @return array to build JSON
     */
    private function groupElementUpdateEntries(array $dataArray) {
        $collect = array();

        foreach ($dataArray as $data) {

            if (isset($data[API_ELEMENT_UPDATE])) {
                foreach ($data[API_ELEMENT_UPDATE] as $key => $item) {
                    $collect[API_ELEMENT_UPDATE][$key] = $item;
                }
                unset($data[API_ELEMENT_UPDATE]);
            }
            $collect[] = $data;
        }

        return $collect;
    }

824
    /**
825
826
     * Process the SQL Queries from bodytext. Return the output.
     *
827
828
     * @return string
     */
829
    private function doReport() {
830
        $report = new Report($this->t3data, $this->eval, $this->phpUnit);
831

832
        $html = $report->process($this->t3data['bodytext']);
833
834
835
836
837

        return $html;

    }

838
    /**
839
840
     * Save the current form.
     *
841
     * @return string
842
843
     * @throws CodeException
     * @throws UserFormException
844
845
846
     */
    public function saveForm() {

847
        $json = $this->doForm(FORM_SAVE);
848

849
        return $json;
850
851
    }

Carsten  Rose's avatar
Carsten Rose committed
852
853
854
855
856
857
858
859
860
861
862
863
864
    /**
     * Update FormElements and form values. Receives the current form values via POST.
     *
     * @return array
     * @throws CodeException
     */
    public function updateForm() {

        $json = $this->doForm(FORM_UPDATE);

        return $json;
    }

865
866
867
    /**
     * Delete a record (tablename and recordid are given) or process a 'delete form'
     *
868
     * @return bool
869
870
871
872
     * @throws CodeException
     */
    public function delete() {

873
        $this->doForm(FORM_DELETE);
874
875

        return true;
876
877
    }

Carsten  Rose's avatar
#2067    
Carsten Rose committed
878
    /**
Carsten  Rose's avatar
Carsten Rose committed
879
880
     * Based on the given SIP, create a new uniqe SIP by copying the relevant old params and taking the new recordId..
     *
Carsten  Rose's avatar
#2067    
Carsten Rose committed
881
882
883
884
885
886
887
888
889
890
891
892
     * @param $sipArray
     * @param $recordId
     */
    private function newRecordCreateSip($sipArray, $recordId) {

        $tmpParam = array();

        foreach ($sipArray as $key => $value) {
            switch ($key) {
                case SIP_SIP:
                case SIP_URLPARAM:
                case SIP_TABLE:
Carsten  Rose's avatar
Carsten Rose committed
893
                continue; // do not copy these params to the new SIP
Carsten  Rose's avatar
#2067    
Carsten Rose committed
894
895

                case SIP_RECORD_ID:
Carsten  Rose's avatar
Carsten Rose committed
896
                    // set the new recordId
Carsten  Rose's avatar
#2067    
Carsten Rose committed
897
898
899
                    $tmpParam[SIP_RECORD_ID] = $recordId;
                    break;
                default:
Carsten  Rose's avatar
Carsten Rose committed
900
                    // copy further vars stored in old SIP (form, maybe default values)
Carsten  Rose's avatar
#2067    
Carsten Rose committed
901
902
903
904
905
906
907
908
909
910
911
912
913
914
                    $tmpParam[$key] = $value;
                    break;
            }
        }

        // Construct fake urlparam
        $tmpUrlparam = OnArray::toString($tmpParam);

        // Create a SIP which has never been passed by URL - further processing might expect this to exist.
        $sip = store::getSipInstance()->queryStringToSip($tmpUrlparam, RETURN_SIP);
        $this->store->setVar(CLIENT_SIP, $sip, STORE_CLIENT);

        // Overwrite SIP Store
        $tmpParam[SIP_SIP] = $sip;
915
        $this->store->setStore($tmpParam, STORE_SIP, true);
Carsten  Rose's avatar
#2067    
Carsten Rose committed
916
917
    }

Carsten  Rose's avatar
Carsten Rose committed
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933

    /**
     * @return string
     */
    private function getModalCode() {

        $code = <<<EOF
    <!-- Modal -->
    <div class="modal fade" id="qfqModal101" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
        <div class="modal-dialog" role="document">
            <div class="modal-content">
                <div class="modal-header">
                    <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
                    <h4 class="modal-title" id="qfqModalTitle101">Loading Document</h4>
                </div>
                <div class="modal-body" style="text-align: center;">
934
                    <img class="qfq-icon-gear glyphicon-spin" src="typo3conf/ext/qfq/Resources/Public/icons/gear.svg">
935
                    <p id="qfqModalText101">Document is being generated. Please wait.</p>
Carsten  Rose's avatar
Carsten Rose committed
936
937
938
939
940
941
942
                </div>
                <div class="modal-footer">
                    <p>In progress..</p>
                </div>
            </div>
        </div>
    </div>
943
944
945
    <script type="application/javascript">
        window.onblur = function () { $("#qfqModal101").modal('hide'); }
    </script>
Carsten  Rose's avatar
Carsten Rose committed
946
947
948
949
950
951
EOF;

        return $code;
    }


952
}