Shortcode AI-Kit pour les fonctionnalités d'IA WordPress

L'interface AI‑Kit Feature (Pro) peut être intégrée hors de Gutenberg à l'aide d'un shortcode.

C'est utile pour :

• le contenu de Classic Editor
• les constructeurs de pages (Elementor, etc.)
• les modèles / zones de thème qui prennent en charge les shortcodes

Utilisation de base​

[smartcloud-ai-kit-feature mode="summarize"]

Ouverture dans une fenêtre modale :

[smartcloud-ai-kit-feature mode="rewrite" variation="modal" title="Rewrite this section"]

Paramètres courants​

Le shortcode est conçu pour reproduire la configuration du bloc AI‑Kit Feature. Les paramètres les plus couramment utilisés sont :

• mode — summarize | write | rewrite | translate | proofread
• variation — default | modal
• title — titre de l'interface affiché dans l'en-tête (modal) ou le panneau (par défaut)
• language — langue de l'interface (par exemple en, de, hu)
• direction — ltr | rtl | auto
• colorMode — light | dark | auto
• primaryColor — clé/nom de thème pour votre palette d'interface
• primaryShade — nombre (0–9) ou { light, dark }
• themeOverrides — chaîne CSS appliquée au thème du composant
• autoRun — exécution immédiate à l'ouverture (typique pour « résumer cette page »)
• editable — permet aux visiteurs de modifier la sortie générée (avec un aperçu en direct) avant le déclenchement de onAccept
• acceptButtonTitle — personnalise le libellé du bouton « Appliquer/Insérer » (lorsque onAccept est branché)
• onDeviceTimeout — remplace le délai d'attente par défaut sur l'appareil (5 s traduction / 45 s autres modes). S'applique uniquement lorsque le site n'est pas configuré en « Backend only ».

Entrée / sortie par défaut​

La plupart des modes acceptent une charge utile « default », par exemple :

• default.text — texte initial à traiter
• default.instructions — consignes supplémentaires
• default.outputLanguage
• default.tone, default.length
• default.type (résumeur), default.outputFormat (plain-text | markdown | html)

Comme les attributs de shortcode WordPress sont des chaînes, les valeurs complexes sont généralement transmises en JSON (lorsque votre intégration le prend en charge) :

[ai-kit-feature
  mode="summarize"
  variation="modal"
  default='{"type":"tldr","outputFormat":"markdown"}'
]

Conseil : pour un formatage plus propre (sans échappement JSON), déplacez ces attributs dans le corps YAML comme indiqué dans la section suivante.

Configuration du corps YAML (recommandée pour les valeurs complexes)​

En plus des attributs du shortcode, vous pouvez fournir n'importe quelle propriété dans le corps du shortcode au format YAML.

C'est particulièrement utile lorsque vous avez besoin de :

• Valeurs multilignes (par exemple themeOverrides)
• Valeurs contenant des caractères pénibles dans les attributs (par exemple des sélecteurs avec [])
• Objets imbriqués (par exemple default.*, allowOverride.*)

Exemple : CSS multilignes et sélecteurs avec []​

[smartcloud-ai-kit-feature mode="summarize" variation="modal"]
 # Mount the UI next to a specific element (selector can contain [] safely)
 target: "[data-widget_type=\"theme-post-content.default\"]"

themeOverrides: |
  :host {
    --ai-kit-modal-max-width: 760px;
  }

default:
  text: "Summarize the content of the current page"
  outputFormat: markdown

allowOverride:
  outputLanguage: true
[/smartcloud-ai-kit-feature]

Modèles pratiques​

« Résumer cette page »​

[smartcloud-ai-kit-feature mode="summarize" variation="modal"]
autoRun: true
[/smartcloud-ai-kit-feature]

« Traduire en hongrois »​

[smartcloud-ai-kit-feature mode="translate" variation="modal"]
default:
  outputLanguage: hu
[/smartcloud-ai-kit-feature]

Dépannage​

• Si rien ne s'affiche, vérifiez les décisions de capacité (sur l'appareil et/ou backend) et confirmez que le navigateur de l'utilisateur prend en charge la fonctionnalité demandée.
• Si le repli backend est activé, confirmez l'URL backend et la politique de sécurité pour vos chemins front-end.
• Pour un contrôle de niveau développeur, envisagez d'utiliser WpSuite.plugins.aiKit.features.renderFeature() à la place des shortcodes.

Shortcode : [smartcloud-ai-kit-doc-search]​

L'interface AI-Kit Doc Search (Pro) peut être intégrée hors de Gutenberg à l'aide d'un shortcode.

Utilisations typiques :

• le contenu de Classic Editor
• les constructeurs de pages (Elementor, etc.)
• les modèles / zones de thème qui prennent en charge les shortcodes

Utilisation de base​

[smartcloud-ai-kit-doc-search]

Ouverture dans une interface de type fenêtre modale (si votre build le prend en charge) :

[smartcloud-ai-kit-doc-search variation="modal" title="Search our docs"]

Paramètres courants​

• variation — default (courant) ou d'autres valeurs spécifiques au build.
• autoRun — exécution immédiate au chargement (par défaut : true).
• title — titre facultatif affiché au-dessus du champ.
• inputSelector — lit la requête à partir d'un champ de saisie/textarea existant sur la page.
• topK — nombre maximal de résultats (par défaut : 10).
• snippetMaxChars — longueur maximale de l'extrait par résultat (par défaut : 160).
• searchButtonIcon — Data URL base64 pour l'icône de recherche (SVG/PNG).
• showSearchButtonTitle / showSearchButtonIcon — afficher/masquer indépendamment le libellé et l'icône du bouton.
• language — langue de l'interface (system, en, hu, …).
• direction — ltr | rtl | auto.
• colorMode — light | dark | auto.
• primaryColor — clé/nom de la couleur principale du thème.
• themeOverrides — chaîne CSS appliquée au thème du composant.

Configuration du corps YAML (recommandée pour les valeurs complexes)​

Comme pour le shortcode Feature, vous pouvez transmettre n'importe quelle propriété dans le corps du shortcode au format YAML (pratique pour les themeOverrides multilignes).

[smartcloud-ai-kit-doc-search title="Search the docs"]
themeOverrides: |
  :host {
    --ai-kit-modal-max-width: 820px;
  }
[/smartcloud-ai-kit-doc-search]