';
+ foreach ($options as $option) {
+ $id = $escapedName . '_' . $option['value'];
+ $checked = $currentValue === (string)$option['value'] ? ' checked' : '';
+ $optionLabel = htmlspecialchars($option['label']);
+ $inputHtml .= <<
+
+
+
+ HTML;
+ }
+ $inputHtml .= '';
+
+ return (new ElixFormsElement($labelHtml, $inputHtml))->render();
+ }
+
+ /**
+ * Crea un campo checkbox con opzioni multiple.
+ * I valori selezionati vengono inviati come stringa separata da virgola in un input hidden.
+ *
+ * @param string $paramName Nome/ID del campo (usato per l'hidden input)
+ * @param string $label Etichetta del campo
+ * @param array';
+ foreach ($options as $entryIndex => $entry) {
+ $id = $escapedName . '_' . $entryIndex;
+ $isChecked = in_array($entryIndex, $checkedValues) ? ' checked' : '';
+ $optionLabel = htmlspecialchars($entry['label']);
+ $inputHtml .= <<
+
+
+
+ HTML;
+ }
+ $inputHtml .= '';
+ // Hidden input che contiene il valore aggregato (aggiornato via JS client-side)
+ $inputHtml .= '';
+
+ return (new ElixFormsElement($labelHtml, $inputHtml))->render();
+ }
+
+ /**
+ * Crea un campo dropdown (select).
+ *
+ * @param string $paramName Nome/ID del campo
+ * @param string $label Etichetta del campo
+ * @param array
+
+
+
+
+
+
+
+ renderCheckboxScript() ?>
+
+
+ con il codice JS
+ */
+ private function renderCheckboxScript(): string
+ {
+ return <<<'SCRIPT'
+
+SCRIPT;
+ }
+}
diff --git a/php/common/ElixFormsElement.php b/php/common/ElixFormsElement.php
new file mode 100644
index 0000000..4fa8052
--- /dev/null
+++ b/php/common/ElixFormsElement.php
@@ -0,0 +1,59 @@
+labelHtml = $labelHtml;
+ $this->inputHtml = $inputHtml;
+ $this->separator = $separator;
+ }
+
+ /**
+ * Genera l'HTML del campo form con layout a due colonne.
+ *
+ * @return string HTML renderizzato
+ */
+ public function render(): string
+ {
+ $sep = $this->separator !== '' ? htmlspecialchars($this->separator) : '';
+
+ return <<
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+
+  ?>)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Accesso non autorizzato!
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {$this->labelHtml}{$sep}
+
+
+ {$this->inputHtml}
+
+
+ HTML;
+ }
+}
diff --git a/php/common/HttpClient.php b/php/common/HttpClient.php
new file mode 100644
index 0000000..cf8b022
--- /dev/null
+++ b/php/common/HttpClient.php
@@ -0,0 +1,153 @@
+defaultHeaders = $defaultHeaders;
+ }
+
+ /**
+ * Imposta le credenziali per l'autenticazione Basic.
+ */
+ public function setBasicAuth(string $username, string $password): self
+ {
+ $this->username = $username;
+ $this->password = $password;
+ return $this;
+ }
+
+ /**
+ * Imposta il timeout massimo per la connessione e l'esecuzione.
+ */
+ public function setTimeout(int $seconds): self
+ {
+ $this->timeout = $seconds;
+ return $this;
+ }
+
+ /**
+ * Esegue una richiesta HTTP GET.
+ *
+ * @param string $url URL della richiesta
+ * @param array $queryParams Parametri query aggiuntivi
+ * @param array $headers Header specifici per questa richiesta
+ * @return string Risposta in formato testuale
+ * @throws \RuntimeException In caso di errore curl o codice di stato non 2xx
+ */
+ public function get(string $url, array $queryParams = [], array $headers = []): string
+ {
+ if (!empty($queryParams)) {
+ $separator = (strpos($url, '?') === false) ? '?' : '&';
+ $url .= $separator . http_build_query($queryParams);
+ }
+
+ return $this->request($url, 'GET', null, $headers);
+ }
+
+ /**
+ * Esegue una richiesta HTTP POST.
+ *
+ * @param string $url URL della richiesta
+ * @param mixed $data Dati da inviare nel body (array, stringa o JSON)
+ * @param array $headers Header specifici per questa richiesta
+ * @return string Risposta in formato testuale
+ * @throws \RuntimeException In caso di errore curl o codice di stato non 2xx
+ */
+ public function post(string $url, $data, array $headers = []): string
+ {
+ return $this->request($url, 'POST', $data, $headers);
+ }
+
+ /**
+ * Metodo interno per eseguire la richiesta tramite cURL.
+ */
+ private function request(string $url, string $method, $data = null, array $headers = []): string
+ {
+ $ch = curl_init();
+ if ($ch === false) {
+ throw new \RuntimeException('Impossibile inizializzare cURL.');
+ }
+
+ // Configura le opzioni cURL di base
+ curl_setopt($ch, CURLOPT_URL, $url);
+ curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+ curl_setopt($ch, CURLOPT_TIMEOUT, $this->timeout);
+ curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $this->timeout);
+ curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+ curl_setopt($ch, CURLOPT_MAXREDIRS, 3);
+
+ // Disabilita la verifica SSL in ambiente di sviluppo locale se necessario,
+ // ma di default è attiva per sicurezza.
+ curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
+ curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
+
+ // Gestione metodo HTTP
+ $method = strtoupper($method);
+ if ($method === 'POST') {
+ curl_setopt($ch, CURLOPT_POST, true);
+ if ($data !== null) {
+ if (is_array($data)) {
+ $postData = http_build_query($data);
+ } else {
+ $postData = $data;
+ }
+ curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
+ }
+ } elseif ($method !== 'GET') {
+ curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
+ }
+
+ // Costruisci gli header
+ $mergedHeaders = array_merge($this->defaultHeaders, $headers);
+ $formattedHeaders = [];
+ foreach ($mergedHeaders as $name => $value) {
+ $formattedHeaders[] = "{$name}: {$value}";
+ }
+
+ if (!empty($formattedHeaders)) {
+ curl_setopt($ch, CURLOPT_HTTPHEADER, $formattedHeaders);
+ }
+
+ // Autenticazione Basic
+ if ($this->username !== null && $this->password !== null) {
+ curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
+ curl_setopt($ch, CURLOPT_USERPWD, "{$this->username}:{$this->password}");
+ }
+
+ // Esegui la richiesta
+ $response = curl_exec($ch);
+ $error = curl_error($ch);
+ $errno = curl_errno($ch);
+ $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+
+ // curl_close non è più necessario in PHP 8.0+ ed è deprecato in PHP 8.5+
+
+ if ($errno !== 0) {
+ throw new \RuntimeException("Errore cURL durante la chiamata a {$url}: [{$errno}] {$error}");
+ }
+
+ if ($statusCode < 200 || $statusCode >= 300) {
+ throw new \RuntimeException("Richiesta fallita con codice di stato HTTP {$statusCode}.");
+ }
+
+ return (string)$response;
+ }
+}
diff --git a/php/common/QueryParamHelper.php b/php/common/QueryParamHelper.php
new file mode 100644
index 0000000..49770c1
--- /dev/null
+++ b/php/common/QueryParamHelper.php
@@ -0,0 +1,91 @@
+fieldKeys = $fieldKeys;
+ $this->minCharsForSearch = $minCharsForSearch;
+
+ // Recupera il codice fiscale dalla query string
+ $this->codiceFiscale = QueryParamHelper::getDecodedTextFromQuery($fieldKeys['codiceFiscale']) ?? '';
+ }
+
+ /**
+ * Genera l'HTML e CSS del componente Autocomplete e i relativi campi nascosti.
+ */
+ protected function createCustomFormFields(): string
+ {
+ $escapedCodFis = htmlspecialchars($this->codiceFiscale, ENT_QUOTES, 'UTF-8');
+ $minChars = $this->minCharsForSearch;
+
+ // Campi di output definiti nella configurazione
+ $outCodiceContratto = htmlspecialchars($this->fieldKeys['codiceContratto']);
+ $outTitoloContratto = htmlspecialchars($this->fieldKeys['titoloContratto']);
+ $outIdDomanda = htmlspecialchars($this->fieldKeys['idDomanda']);
+ $outIdRicevuta = htmlspecialchars($this->fieldKeys['idRicevuta']);
+
+ // Recupero di eventuali valori correnti dal GET per precompilazione iniziale
+ $currCodice = htmlspecialchars(QueryParamHelper::getDecodedTextFromQuery($this->fieldKeys['codiceContratto']) ?? '', ENT_QUOTES, 'UTF-8');
+ $currTitolo = htmlspecialchars(QueryParamHelper::getDecodedTextFromQuery($this->fieldKeys['titoloContratto']) ?? '', ENT_QUOTES, 'UTF-8');
+ $currDomanda = htmlspecialchars(QueryParamHelper::getDecodedTextFromQuery($this->fieldKeys['idDomanda']) ?? '', ENT_QUOTES, 'UTF-8');
+ $currRicevuta = htmlspecialchars(QueryParamHelper::getDecodedTextFromQuery($this->fieldKeys['idRicevuta']) ?? '', ENT_QUOTES, 'UTF-8');
+
+ $initialSearchText = '';
+ if ($currCodice !== '' && $currTitolo !== '') {
+ $initialSearchText = "[{$currCodice}] {$currTitolo}";
+ }
+
+ // Layout del campo di ricerca
+ $autocompleteInputHtml = <<
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HTML;
+
+ $labelHtml = '';
+
+ return (new \ElixForms\Common\ElixFormsElement($labelHtml, $autocompleteInputHtml))->render();
+ }
+
+ /**
+ * Inietta i CSS specifici per l'autocomplete e la card.
+ */
+ protected function renderExtraContentPre(): string
+ {
+ ob_start();
+ ?>
+
+ codiceFiscale, ENT_QUOTES, 'UTF-8');
+ $minChars = $this->minCharsForSearch;
+
+ ob_start();
+ ?>
+
+ $config['elixForms']['inputs']['codiceFiscale'],
+ 'idDomanda' => $config['elixForms']['outputs']['idDomanda'],
+ 'idRicevuta' => $config['elixForms']['outputs']['idRicevuta'],
+ 'codiceContratto'=> $config['elixForms']['outputs']['codiceContratto'],
+ 'titoloContratto'=> $config['elixForms']['outputs']['titoloContratto'],
+ ],
+ $config['component']['minCharsForSearch'] ?? 3
+);
+
+echo $page->render();
diff --git a/php/recupero-proposta-cct-da-contratti/search-contratti.php b/php/recupero-proposta-cct-da-contratti/search-contratti.php
new file mode 100644
index 0000000..c292ec3
--- /dev/null
+++ b/php/recupero-proposta-cct-da-contratti/search-contratti.php
@@ -0,0 +1,76 @@
+ 'Il parametro di ricerca "term" deve contenere almeno 3 caratteri.'], JSON_UNESCAPED_UNICODE);
+ exit;
+ }
+
+ if (empty($codFis)) {
+ http_response_code(400);
+ echo json_encode(['error' => 'Il parametro "cod_fis" (Codice Fiscale) è obbligatorio.'], JSON_UNESCAPED_UNICODE);
+ exit;
+ }
+
+ // 2. Caricamento configurazione
+ $configFile = __DIR__ . '/config.json';
+ if (!file_exists($configFile)) {
+ throw new \RuntimeException('File di configurazione config.json non trovato.');
+ }
+
+ $configJson = file_get_contents($configFile);
+ $config = json_decode($configJson, true);
+ if (json_last_error() !== JSON_ERROR_NONE || !isset($config['contrattiWS'])) {
+ throw new \RuntimeException('Configurazione del Web Service "contrattiWS" mancante o non valida.');
+ }
+
+ $wsConfig = $config['contrattiWS'];
+ $apiUrl = $wsConfig['apiUrl'] ?? '';
+ $apiUsername = $wsConfig['apiUsername'] ?? '';
+ $apiPassword = $wsConfig['apiPassword'] ?? '';
+ $apiKey = $wsConfig['apiKey'] ?? '';
+
+ // 3. Inizializzazione ed esecuzione della chiamata HTTP con HttpClient
+ $client = new HttpClient([
+ 'X-Api-Key' => $apiKey,
+ 'Accept' => 'application/json'
+ ]);
+
+ // Configura autenticazione basic
+ $client->setBasicAuth($apiUsername, $apiPassword);
+
+ // Esegui la richiesta GET
+ $responseBody = $client->get($apiUrl, [
+ 'cod_fis' => $codFis,
+ 'term' => $term
+ ]);
+
+ // Valida che la risposta sia in formato JSON corretto
+ json_decode($responseBody);
+ if (json_last_error() !== JSON_ERROR_NONE) {
+ throw new \RuntimeException('Il servizio contratti ha restituito una risposta in un formato non valido (non JSON).');
+ }
+
+ // Ritorna la risposta del WS direttamente
+ echo $responseBody;
+
+} catch (\Throwable $e) {
+ http_response_code(500);
+ echo json_encode([
+ 'error' => 'Errore durante la ricerca dei contratti.',
+ 'message' => 'Servizio temporaneamente non disponibile o risposta non valida.'
+ ], JSON_UNESCAPED_UNICODE);
+}
diff --git a/php/scelta-carriera/index.php b/php/scelta-carriera/index.php
new file mode 100644
index 0000000..80bccca
--- /dev/null
+++ b/php/scelta-carriera/index.php
@@ -0,0 +1,91 @@
+createDropdownInput('COL0015', 'COL0015 Goals', [
+ ['value' => 0, 'label' => 'Not applicable'],
+ ['value' => 1, 'label' => 'Goal 1: No poverty'],
+ ['value' => 2, 'label' => 'Goal 2: Zero hunger'],
+ ['value' => 3, 'label' => 'Goal 3: Good health and well-being'],
+ ['value' => 4, 'label' => 'Goal 4: Quality education'],
+ ['value' => 5, 'label' => 'Goal 5: Gender equality'],
+ ['value' => 6, 'label' => 'Goal 6: Clean water and sanitation'],
+ ['value' => 7, 'label' => 'Goal 7: Affordable and clean energy'],
+ ['value' => 8, 'label' => 'Goal 8: Decent work and economic growth'],
+ ['value' => 9, 'label' => 'Goal 9: Industry, Innovation, and Infrastructure'],
+ ['value' => 10, 'label' => 'Goal 10: Reduced inequalities'],
+ ['value' => 11, 'label' => 'Goal 11: Sustainable cities and communities'],
+ ['value' => 12, 'label' => 'Goal 12: Responsible consumption and production'],
+ ['value' => 13, 'label' => 'Goal 13: Climate action'],
+ ['value' => 14, 'label' => 'Goal 14: Life below water'],
+ ['value' => 15, 'label' => 'Goal 15: Life on land'],
+ ['value' => 16, 'label' => 'Goal 16: Peace, justice and strong institutions'],
+ ['value' => 17, 'label' => 'Goal 17: Partnerships for the goals'],
+ ], true);
+
+ // Text input: COL0002
+ $html .= $this->createTextInput('COL0002', 'Campo STRING', true);
+
+ // Textarea: COL0003
+ $html .= $this->createTextAreaInput('COL0003', 'Campo TEXTAREA', true);
+
+ // Boolean: COL0004
+ $html .= $this->createBooleanInput('COL0004', 'Campo BOOLEAN', true);
+
+ // Radio: COL0005
+ $html .= $this->createRadioInput('COL0005', 'Campo RADIO', [
+ ['value' => 1, 'label' => 'Opzione 1'],
+ ['value' => 2, 'label' => 'Opzione 2'],
+ ['value' => 3, 'label' => 'Altra opzione'],
+ ], true);
+
+ // Checkbox: COL0006
+ $html .= $this->createCheckboxInput('COL0006', 'Campo CHECKBOX', [
+ ['value' => 4, 'label' => 'Check 1'],
+ ['value' => 5, 'label' => 'Check 2'],
+ ['value' => 6, 'label' => 'Altro check'],
+ ]);
+
+ return $html;
+ }
+
+ protected function renderExtraContentPost(): string
+ {
+ return '
+
+
+
+ ID Contratto:
+ Titolo:
+ ID Domanda:
+ ID Ricevuta:
+ Questa pagina è la versione PHP della custom page Scelta Carriera.
';
+ }
+}
+
+// =============================================================================
+// Entry point — Istanziazione e rendering della pagina
+// =============================================================================
+
+$page = new SceltaCarrieraPage([
+ 'moduleName' => '',
+ 'alertInfoMessage' => '',
+ 'userDisplayName' => 'John Doe',
+ 'headerTitle' => 'Modulo A/13 - Richiesta di Certificato',
+ 'cardTitle' => 'Scelta Carriera',
+ 'cardDescription' => 'Benvenuto nella piattaforma di scelta carriera! Esplora le tue opzioni e trova la strada giusta per te.',
+ 'headerHeroImageSrc' => '',
+]);
+
+echo $page->render();
diff --git a/react/AGENTS.md b/react/AGENTS.md
new file mode 100644
index 0000000..5574c74
--- /dev/null
+++ b/react/AGENTS.md
@@ -0,0 +1,36 @@
+# Agente React — Regole e Convenzioni
+
+Questo file definisce le istruzioni specifiche, le regole e le convenzioni per lo sviluppo e la manutenzione delle pagine custom e dei componenti scritti in **React e TypeScript** nel monorepo `react/`.
+
+## Gestione ID dei Form Element
+Gli ID dei campi del form (es. nel Dropdown, Checkbox, TextField) creati tramite i metodi `create...` in [ElixFormsComponentAbstract.tsx](file:///c:/__Git/_UniPR/elixforms-custom-pages/react/common/src/ElixFormsComponentAbstract.tsx) **non devono mai essere cambiati o manipolati** (ad es. aggiungendo suffissi come `_dropdown`), in quanto la piattaforma elixForms si basa sul loro nome ed ID esatto.
+In caso di conflitti di ID (ad esempio con input `hidden`), applicare il suffisso `_hidden` all'input hidden e mantenere l'ID originale senza suffissi sull'elemento principale visibile.
+
+## Convenzioni di Codice e Framework
+1. **Libreria Common (`react/common/`)**:
+ - Scritta in **TypeScript** (`.tsx` o `.ts`).
+ - Usa **React Class Components** (non hooks/functional components) ereditando da `React.Component`.
+ - Lo stato è gestito in modo immutabile tramite `this.setState`.
+ - I checkbox mantengono uno stato locale tramite un `Map