essario prima per i menu a cascata)? (tempo stimato: +2 giorni)
Dimmi quale output preferisci (Markdown pronto per il sito, HTML, o aggiunta diretta al plugin) e procedo.
You said: ELENCO SHORTCODE
ELENCO SHORTCODE
Copilot said: Ecco l’elenco completo e sintetico degli shortcode
Ecco l’elenco completo e sintetico degli shortcode disponibili nella build v1.0 e quelli previsti per le estensioni. Ti do per ciascuno: scopo, attributi principali, esempio d’uso rapido e note operative.
Shortcode inclusi nella v1.0
[damp_form_template]
Scopo: visualizza il form generato da un template creato in DAMP Admin e invia i dati al REST endpoint per creare il CPT “viaggio”.
Attributi:
slug (obbligatorio): slug univoco del template.
Esempio:
[damp_form_template slug=”viaggio-pilota”]
Note:
Il form viene renderizzato con i titoli colonne e l’ordine campi impostati in Admin.
L’invio usa POST -> /wp-json/damp/v1/submit (payload JSON).
Upload file non inviati via JSON: usare REST Media endpoint o multipart per immagini.
Shortcode pianificati / consigliati (non ancora attivi nella ZIP v1.0)
[damp_super_mappa]
Scopo: mostra la super-mappa (Leaflet/OSM) con tutti i viaggi attivi + posizioni realtime.
Attributi suggeriti: bbox, zoom, show_filters (true/false), role_filter.
Uso esempio: [damp_super_mappa zoom=”6″ show_filters=”true”]
[damp_mini_card_viaggio]
Scopo: card riassuntiva di un singolo viaggio (da usare in popup marker o liste).
Attributi:
id (post ID del viaggio) o slug.
Esempio: [damp_mini_card_viaggio id=”123″]
[damp_viaggi_lista]
Scopo: lista filtrabile di viaggi (ricerche, “i miei viaggi”, filtri per comune/categoria).
Attributi: user_id, role_filter, per_page, status.
Esempio: [damp_viaggi_lista per_page=”10″ role_filter=”pilota”]
[damp_form_utente]
Scopo: form per registrazione / modifica profilo utente (campi estesi: nickname, avatar, veicolo …).
Attributi: mode (new/edit), user_id.
Esempio: [damp_form_utente mode=”new”]
Endpoint REST correlati
POST /wp-json/damp/v1/submit
Payload atteso: { “template_slug”:”nome_slug”, “fields”: { “campo1″:”valore”, “campo2″:”valore” … } }
Risultato: crea CPT viaggio (post_id restituito). L’action hook damp_after_viaggio_created viene eseguita subito dopo la creazione.
Hook utili per integrazioni
do_action(‘damp_after_viaggio_created’, $post_id, $fields, $template_row)
Usalo per: creare/sincronizzare prodotto WooCommerce, inviare dati a Firestore, notifiche, log ecc.
Come ottengo lo shortcode corretto
In Admin → DAMP Forms la tabella dei template mostra la colonna “Shortcode” per ogni template (es. [damp_form_template slug=”nome-slug”]). Copialo e incollalo nella pagina/post desiderata.
Limitazioni e note pratiche (v1.0)
I select Regione/Provincia/Comune sono placeholder finché non importi e salvi i Comuni in una CPT o tabella; per il popolamento a cascata serve che l’import scriva i Comuni in DB + un endpoint per recuperarli.
REST endpoint in v1.0 ha permission_callback permissiva: in produzione proteggere con nonce o autenticazione.
File upload (avatar, immagini) richiede gestione via Media REST endpoint (non inviato automaticamente con il JSON di submit).
Vuoi che:
ti esporti questo elenco in Markdown pronto per pubblicazione sul sito?
per la prossima release implementi subito [damp_super_mappa] e [damp_viaggi_lista]? (stima +2–5 giorni)
Dimmi quale formato preferisci (Markdown/HTML) e se procedo subito con l’aggiunta di uno o più shortcode pianific