Shortcode de AI-Kit para funciones de IA en WordPress

La interfaz AI‑Kit Feature (Pro) puede insertarse fuera de Gutenberg mediante un shortcode.

Esto resulta útil para:

• Contenido del Editor clásico
• Maquetadores de páginas (Elementor, etc.)
• Plantillas o zonas del tema que admiten shortcodes

Uso básico​

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

Abrir en un cuadro de diálogo:

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

Parámetros habituales​

El shortcode está diseñado para reflejar la configuración del bloque AI‑Kit Feature. Los parámetros más utilizados son:

• mode — summarize | write | rewrite | translate | proofread
• variation — default | modal
• title — título de la interfaz que aparece en la cabecera (modal) o el panel (predeterminado)
• language — idioma de la interfaz (por ejemplo, en, de, hu)
• direction — ltr | rtl | auto
• colorMode — light | dark | auto
• primaryColor — nombre o clave del tema para la paleta de la interfaz
• primaryShade — número (0–9) o { light, dark }
• themeOverrides — cadena CSS aplicada al tema del componente
• autoRun — ejecuta la acción inmediatamente al abrirse (habitual para «resumir esta página»)
• editable — permite a los visitantes editar el resultado generado (con una vista previa en directo) antes de que se active onAccept
• acceptButtonTitle — personaliza la etiqueta del botón «Aplicar/Insertar» (cuando onAccept está conectado)
• onDeviceTimeout — sustituye el tiempo límite predeterminado en el dispositivo (5 s para la traducción y 45 s para los demás modos). Solo se aplica cuando el sitio no está configurado como «Solo backend».

Entrada y salida predeterminadas​

La mayoría de los modos aceptan una carga útil «default»; por ejemplo:

• default.text — texto inicial que se procesará
• default.instructions — indicaciones adicionales
• default.outputLanguage
• default.tone, default.length
• default.type (generador de resúmenes), default.outputFormat (plain-text | markdown | html)

Como los atributos de los shortcodes de WordPress son cadenas, los valores complejos suelen pasarse como JSON (si la integración lo admite):

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

Consejo: para conseguir un formato más limpio (sin escapar JSON), mueve estos atributos al cuerpo YAML como se muestra en la sección siguiente.

Configuración mediante cuerpo YAML (recomendada para valores complejos)​

Además de los atributos del shortcode, puede proporcionar cualquier propiedad en el cuerpo del shortcode mediante YAML.

Resulta especialmente útil cuando necesita:

• Valores de varias líneas (por ejemplo, themeOverrides)
• Valores que contienen caracteres incómodos en los atributos (por ejemplo, selectores con [])
• Objetos anidados (por ejemplo, default.*, allowOverride.*)

Ejemplo: CSS de varias líneas y selectores con []​

[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]

Patrones prácticos​

«Resumir esta página»​

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

«Traducir al húngaro»​

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

Solución de problemas​

• Si no se representa nada, comprueba las decisiones de capacidad (en el dispositivo o en el backend) y confirme que el navegador del usuario admite la función solicitada.
• Si la alternativa del backend está activada, confirme la URL del backend y la política de seguridad de las rutas del frontend.
• Para obtener un control a nivel de desarrollo, considera usar WpSuite.plugins.aiKit.features.renderFeature() en lugar de shortcodes.

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

La interfaz AI‑Kit Doc Search (Pro) puede insertarse fuera de Gutenberg mediante un shortcode.

Usos habituales:

• Contenido del Editor clásico
• Maquetadores de páginas (Elementor, etc.)
• Plantillas o zonas del tema que admiten shortcodes

Uso básico​

[smartcloud-ai-kit-doc-search]

Abrir en una interfaz de tipo modal (si la compilación lo admite):

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

Parámetros habituales​

• variation — default (habitual) u otros valores específicos de la compilación.
• autoRun — ejecuta la acción inmediatamente al cargar (predeterminado: true).
• title — título opcional que aparece sobre la entrada.
• inputSelector — lee la consulta de una entrada o área de texto existente en la página.
• topK — número máximo de resultados (predeterminado: 10).
• snippetMaxChars — longitud máxima del fragmento por resultado (predeterminado: 160).
• searchButtonIcon — URL de datos base64 para el icono de búsqueda (SVG/PNG).
• showSearchButtonTitle / showSearchButtonIcon — muestra u oculta por separado la etiqueta y el icono del botón.
• language — idioma de la interfaz (system, en, hu, …).
• direction — ltr | rtl | auto.
• colorMode — light | dark | auto.
• primaryColor — nombre o clave del color principal del tema.
• themeOverrides — cadena CSS aplicada al tema del componente.

Configuración mediante cuerpo YAML (recomendada para valores complejos)​

Al igual que con el shortcode Feature, puede pasar cualquier propiedad en el cuerpo del shortcode como YAML, lo que resulta práctico para valores de themeOverrides de varias líneas.

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