ChefSolver Embeds — extension WordPress
ChefSolver Embeds est une extension WordPress qui vous permet de placer les convertisseurs ChefSolver sur votre propre site via un shortcode, un bloc Gutenberg ou une iframe manuelle. Elle est pilotée par le manifeste : elle affiche les intégrations actuellement publiées dans le catalogue public à l'adresse https://chefsolver.com/embed/manifest.json.
Obtenir l'extension
L'extension est distribuée sous forme de paquet d'extension WordPress (ZIP) à installer manuellement : dans wp-admin → Extensions → Ajouter → Téléverser une extension, téléversez le ZIP et activez-le.
Une fiche sur WordPress.org est en cours de validation et n'y est pas encore publiée. En attendant, installez depuis le paquet ZIP. Cette page sera mise à jour si et quand une fiche du répertoire public sera disponible.
Ce que vous pouvez intégrer aujourd'hui
L'extension ne propose que les outils intégrables actuellement disponibles listés dans le manifeste — elle ne suppose pas que tous les outils du site sont intégrables. Aujourd'hui, il s'agit des convertisseurs d'unités génériques (par exemple mL → grammes), des convertisseurs par ingrédient (par exemple miel mL → grammes) et des calculateurs autonomes (calculateur de pâte à pizza, ajusteur de recettes, convertisseur de recettes). Le catalogue s'enrichit au fil du temps à mesure que d'autres outils deviennent intégrables ; l'extension prend automatiquement en compte les nouvelles entrées, sans mise à jour nécessaire.
Consultez la documentation d'intégration pour la liste complète des paramètres, ou le catalogue lisible par machine à l'adresse https://chefsolver.com/embed/manifest.json.
Exemples de shortcode
Utilisez le shortcode [chefsolver_embed], ou l'alias [chefsolver_converter] qui définit type sur converter par défaut :
[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"]Les attributs pris en charge incluent type, slug, lang, theme (light/dark/auto), accent (couleur hexadécimale), compact, radius et height. Pour les convertisseurs par ingrédient, utilisez un slug composé ingrédient/conversion, par ex. honey/ml-to-grams.
Exemples d'iframe manuelle
Vous pouvez aussi intégrer sans l'extension, avec une simple iframe pointant vers /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>Pourquoi intégrer les outils ChefSolver
- Blogs culinaires — placez un convertisseur précis tasses/grammes/mL à côté d'une recette pour que les lecteurs convertissent sans quitter l'article.
- Sites de recettes — proposez des mesures localisées (US ↔ métrique) directement sur chaque page de recette.
- Meal prep & cuisine en lots — permettez aux lecteurs d'ajuster les poids des ingrédients rapidement et de façon fiable.
- Contenu nutrition — associez les conversions volume↔poids par ingrédient à vos articles nutrition.
- Guides et références de cuisine — intégrez un convertisseur cohérent et maintenu au lieu d'en reconstruire un par page.
Sources des données et attribution
Chaque widget s'affiche dans une iframe ChefSolver. Le lien vers la page d'origine de l'outil ChefSolver, la note sur les sources de données et les éventuels avertissements d'approximation sont affichés dans cette iframe par ChefSolver — l'extension WordPress n'injecte ni n'impose aucun crédit, lien retour ou suivi propre. Le balisage de l'extension n'est qu'un conteneur et l'iframe.
Limites
- Les résultats masse ↔ volume dépendent de la densité de l'ingrédient. Les convertisseurs génériques utilisent une approximation basée sur la densité de l'eau ; les convertisseurs par ingrédient utilisent la densité mesurée de chaque ingrédient pour plus de précision.
- Seuls les outils présents dans le manifeste sont intégrables. Le manifeste s'enrichira à mesure que d'autres outils deviendront intégrables ; la disponibilité actuelle n'est donc pas une promesse concernant tous les outils ChefSolver.
- Les intégrations sont servies depuis
chefsolver.com; l'extension restreint les iframes à cet hôte.