title ?? 'Evento'); ?>
description)) : ?>description, 20)); ?>
Data: ' . $date->format('d/m/Y H:i') . '
'; } } } ``` ### 2. Eventi in un Intervallo di Date ```php $eventi_gennaio = entourance_get_paginated_items(array( 'type' => 'event', 'date_start' => '2024-01-01T00:00:00Z', 'date_end' => '2024-01-31T23:59:59Z', 'city' => 'Milano', 'items_per_page' => 50 )); ``` ### 3. Experience di Tipo Specifico ```php $tour = entourance_get_paginated_items(array( 'type' => 'experience', 'experience_type' => 'tour', 'category' => 'cultural', 'items_per_page' => 15 )); ``` ### 4. Paginazione Completa ```php $current_page = isset($_GET['paged']) ? max(1, intval($_GET['paged'])) : 1; $result = entourance_get_paginated_items(array( 'type' => 'experience', 'items_per_page' => 12, 'page' => $current_page )); // Mostra risultati foreach ($result['data'] as $item) { // ... output ... } // Navigazione if ($current_page > 1) { echo '« Precedente'; } if ($result['pagination']['has_more']) { echo 'Successiva »'; } ``` ### 5. Uso in Template WordPress ```php 'event', 'date_start' => date('Y-m-d\T00:00:00\Z'), 'items_per_page' => 6 )); ?>description, 20)); ?>
Nessun evento disponibile
'; } ob_start(); foreach ($result['data'] as $evento) { echo 'Si è verificato un errore. Riprova più tardi.
'; return; } // Verifica successo chiamata if (!$result['success']) { echo 'Nessun risultato disponibile
'; return; } // Verifica se ci sono dati if (empty($result['data'])) { echo 'Nessun elemento trovato
'; return; } // Procedi con l'elaborazione foreach ($result['data'] as $item) { // ... } ``` --- ## Debug Per vedere quali filtri sono stati applicati e l'URL API chiamato: ```php $result = entourance_get_paginated_items(array( 'type' => 'event', 'date_start' => '2024-01-01T00:00:00Z', 'city' => 'Milano' )); // Mostra info debug echo ''; print_r($result['filters_applied']); echo "\n\nURL: " . $result['api_url']; echo ''; ``` --- ## Note Importanti 1. **Formato Date**: Usa sempre il formato ISO 8601 per le date: `YYYY-MM-DDTHH:MM:SSZ` ```php $data = date('Y-m-d\T00:00:00\Z'); // Oggi $data = '2024-12-25T10:30:00Z'; // Data specifica ``` 2. **Paginazione**: Il numero massimo di elementi per pagina è 100 3. **Performance**: Usa la cache se fai molte richieste: ```php $cache_key = 'entourance_events_' . md5(serialize($args)); $result = get_transient($cache_key); if (false === $result) { $result = entourance_get_paginated_items($args); set_transient($cache_key, $result, HOUR_IN_SECONDS); } ``` 4. **Sicurezza**: Sanifica sempre i dati in output: ```php echo esc_html($item->title); echo esc_url($item->url); echo esc_attr($item->id); ``` --- ## Campi Validi per l'Ordinamento L'ordinamento viene passato all'API come JSON array: `[{"field":"title","direction":"asc"}]` ### Campi comuni: | Campo | Descrizione | Valido per | |-------|-------------|-----------| | `title` | Titolo | experience, event, article | | `name` | Nome | poi, itinerary, host, eatery | | `price` | Prezzo | Tutti i tipi | | `created_at` | Data di creazione | Tutti i tipi | **Note importanti:** - La funzione converte automaticamente `name` ↔ `title` in base al tipo di contenuto - Per experience e event, usa `title` (la funzione converte automaticamente `name` in `title`) - Per poi e itinerary, usa `name` (la funzione converte automaticamente `title` in `name`) - **Non usare** `start_date` per l'ordinamento ma `date` - Per filtrare per date usa i parametri `date_start` e `date_end` ### Esempio: ```php // Corretto - ordina per titolo $result = entourance_get_paginated_items(array( 'type' => 'event', 'order_field' => 'title', 'order_direction' => 'asc' )); // Corretto - anche 'name' funziona (viene convertito automaticamente in 'title') $result = entourance_get_paginated_items(array( 'type' => 'event', 'order_field' => 'name', // Convertito in 'title' 'order_direction' => 'desc' )); ``` --- ## Supporto Per domande o problemi, consulta la documentazione completa del plugin Entourance o contatta il supporto tecnico.