ChefSolver Embeds — plugin WordPress
ChefSolver Embeds è un plugin WordPress che ti permette di inserire i convertitori ChefSolver nel tuo sito con uno shortcode, un blocco Gutenberg o un iframe manuale. È guidato dal manifest: mostra gli embed attualmente pubblicati nel catalogo pubblico su https://chefsolver.com/embed/manifest.json.
Ottenere il plugin
Il plugin è distribuito come pacchetto plugin WordPress (ZIP) da installare manualmente: in wp-admin → Plugin → Aggiungi nuovo → Carica plugin, carica lo ZIP e attivalo.
Una scheda su WordPress.org è in fase di revisione e non è ancora pubblicata lì. Fino ad allora, installa dal pacchetto ZIP. Questa pagina verrà aggiornata se e quando sarà disponibile una scheda nella directory pubblica.
Cosa puoi incorporare oggi
Il plugin offre solo gli strumenti incorporabili attualmente disponibili elencati nel manifest — non presuppone che ogni strumento del sito sia incorporabile. Oggi si tratta dei convertitori di unità generici (per esempio mL → grammi), dei convertitori per ingrediente (per esempio miele mL → grammi) e dei calcolatori autonomi (calcolatore impasto pizza, ridimensiona ricette, convertitore di ricette). Il catalogo cresce nel tempo man mano che altri strumenti diventano incorporabili; il plugin recepisce automaticamente le nuove voci, senza bisogno di aggiornarlo.
Consulta la documentazione embed per l'elenco completo dei parametri, oppure il catalogo leggibile dalle macchine su https://chefsolver.com/embed/manifest.json.
Esempi di shortcode
Usa lo shortcode [chefsolver_embed], oppure l'alias [chefsolver_converter] che imposta type su converter per impostazione predefinita:
[chefsolver_embed type="converter" slug="ml-to-grams" lang="en"]
[chefsolver_converter slug="cups-to-ml" lang="en"]
[chefsolver_embed type="converter" slug="grams-to-cups" lang="en" theme="dark" accent="#0aa" compact="1"]
[chefsolver_embed type="ingredient-converter" slug="honey/ml-to-grams" lang="en"]Gli attributi supportati includono type, slug, lang, theme (light/dark/auto), accent (colore esadecimale), compact, radius e height. Per i convertitori per ingrediente usa uno slug composto ingrediente/conversione, ad es. honey/ml-to-grams.
Esempi di iframe manuale
Puoi incorporare anche senza il plugin, usando un semplice iframe che punta a /embed/{lang}/converters/{slug}/:
<iframe
src="https://chefsolver.com/embed/en/converters/ml-to-grams/?theme=auto"
width="100%" height="320"
style="border:0;max-width:520px" loading="lazy"
title="ChefSolver mL to grams converter"></iframe><iframe
src="https://chefsolver.com/embed/it/converters/cups-to-ml/?theme=light&compact=1"
width="100%" height="320"
style="border:0;max-width:520px" loading="lazy"
title="ChefSolver cups to mL converter"></iframe>Perché incorporare gli strumenti ChefSolver
- Food blog — inserisci un convertitore preciso tazze/grammi/mL accanto a una ricetta, così i lettori convertono senza lasciare l'articolo.
- Siti di ricette — offri misure localizzate (US ↔ metrico) direttamente in ogni pagina ricetta.
- Meal prep & cucina in batch — permetti ai lettori di scalare i pesi degli ingredienti in modo rapido e affidabile.
- Contenuti di nutrizione — abbina le conversioni volume↔peso per ingrediente ai tuoi contenuti nutrizionali.
- Guide e riferimenti di cucina — incorpora un convertitore coerente e mantenuto invece di ricostruirne uno per pagina.
Fonti dei dati e attribuzione
Ogni widget viene reso all'interno di un iframe ChefSolver. Il link alla pagina originale dello strumento ChefSolver, la nota sulle fonti dei dati ed eventuali avvisi sulle approssimazioni sono mostrati dentro quell'iframe da ChefSolver — il plugin WordPress non inietta né impone alcun credito, backlink o tracciamento proprio. Il markup del plugin è solo un contenitore e l'iframe.
Limitazioni
- I risultati massa ↔ volume dipendono dalla densità dell'ingrediente. I convertitori generici usano un'approssimazione basata sulla densità dell'acqua; i convertitori per ingrediente usano la densità misurata di ciascun ingrediente per maggiore precisione.
- Sono incorporabili solo gli strumenti presenti nel manifest. Il manifest crescerà man mano che altri strumenti diventeranno incorporabili, quindi la disponibilità odierna non è una promessa su ogni strumento ChefSolver.
- Gli embed sono serviti da
chefsolver.com; il plugin limita gli iframe a quell'host.