Bejelentkezés

AI-Kit rövidkód WordPress AI-funkciókhoz

Az AI‑Kit Feature felülete (Pro) rövidkóddal a Gutenbergen kívül is beágyazható.

Ez hasznos:

  • a Klasszikus szerkesztő tartalmában,
  • oldalkészítőkben, például az Elementorban,
  • rövidkódokat támogató sablonokban és tématerületeken.
Pro-funkció

A [smartcloud-ai-kit-feature] a Pro látogatói funkciók része. Ha a Pro nem aktív, előfordulhat, hogy a rövidkód nem jelenik meg.

Alapvető használat​

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

Megnyitás párbeszédablakban:

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

Gyakori paraméterek​

A rövidkód az AI‑Kit Feature blokk konfigurációját tükrözi. A leggyakrabban használt paraméterek:

  • mode — summarize | write | rewrite | translate | proofread
  • variation — default | modal
  • title — a fejlécben (modális) vagy panelen (alapértelmezett) megjelenő felületi cím
  • language — felületi nyelv, például en, de, hu
  • direction — ltr | rtl | auto
  • colorMode — light | dark | auto
  • primaryColor — a felületi paletta témázási kulcsa/neve
  • primaryShade — szám (0–9) vagy { light, dark }
  • themeOverrides — a komponenstémára alkalmazott CSS-karakterlánc
  • autoRun — megnyitáskor azonnal fut, jellemző példája az „oldal összefoglalása”
  • editable — a látogató az onAccept lefutása előtt élő előnézettel szerkesztheti a létrehozott kimenetet
  • acceptButtonTitle — az „Alkalmazás/Beszúrás” gomb feliratának testreszabása, ha az onAccept be van kötve
  • onDeviceTimeout — felülírja az eszközön futás alapértelmezett időkorlátját: fordításnál 5, más módoknál 45 másodperc. Csak akkor érvényes, ha a webhely nincs „Csak háttérrendszer” módra állítva.

Alapértelmezett bemenet és kimenet​

A legtöbb mód „default” adattartalmat fogad, például:

  • default.text — feldolgozandó kezdőszöveg
  • default.instructions — további útmutatás
  • default.outputLanguage
  • default.tone, default.length
  • default.type (summarizer), default.outputFormat (plain-text | markdown | html)

Mivel a WordPress rövidkódattribútumai karakterláncok, az összetett értékeket rendszerint JSON-ként kell átadni, ha az integráció támogatja:

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

Tipp: a tisztább formázásért, JSON-escape-elés nélkül, helyezze ezeket az attribútumokat a YAML-törzsbe a következő szakasz szerint.

YAML-törzskonfiguráció (összetett értékekhez ajánlott)​

A rövidkódattribútumokon felül bármely tulajdonságot megadhatja YAML formában a rövidkód törzsében.

Ez különösen hasznos, ha szüksége van:

  • Többsoros értékekre, például themeOverrides
  • attribútumban körülményes karaktereket tartalmazó értékekre, például [] jeleket használó kijelölőkre
  • beágyazott objektumokra, például default.*, allowOverride.*

Példa: többsoros CSS és [] jeleket tartalmazó kijelölők​

[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]
megjegyzés

Ha ugyanazt a tulajdonságot attribútumként és YAML-ban is megadja, a YAML-törzs az attribútumokra rétegződik.

Gyakorlati minták​

„Oldal összefoglalása”​

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

„Fordítás magyarra”​

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

Hibaelhárítás​

  • Ha semmi nem jelenik meg, ellenőrizze a képességdöntéseket (eszköz és/vagy háttérrendszer), és győződjön meg róla, hogy a felhasználó böngészője támogatja a kért funkciót.
  • Engedélyezett háttérrendszeri tartaléknál ellenőrizze a háttérrendszer URL-jét és a látogatói útvonalak biztonsági szabályzatát.
  • Fejlesztői szintű vezérléshez rövidkódok helyett fontolja meg a WpSuite.plugins.aiKit.features.renderFeature() használatát.

Az AI‑Kit Doc Search felülete (Pro) rövidkóddal a Gutenbergen kívül is beágyazható.

Jellemző felhasználás:

  • a Klasszikus szerkesztő tartalmában,
  • oldalkészítőkben, például az Elementorban,
  • rövidkódokat támogató sablonokban és tématerületeken.
Pro-funkció

A [smartcloud-ai-kit-doc-search] a Pro látogatói funkciók része. Ha a Pro nem aktív, előfordulhat, hogy a rövidkód nem jelenik meg.

Alapvető használat​

[smartcloud-ai-kit-doc-search]

Megnyitás modális jellegű felületen, ha az összeállítás támogatja:

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

Gyakori paraméterek​

  • variation — default (gyakori) vagy más összeállítás-specifikus érték.
  • autoRun — betöltéskor azonnal fut, alapértéke true.
  • title — a beviteli mező fölött megjelenő választható cím.
  • inputSelector — a lekérdezés olvasása az oldal egy meglévő beviteli vagy szövegmezőjéből.
  • topK — az eredmények legnagyobb száma, alapértéke 10.
  • snippetMaxChars — részletenkénti legnagyobb hossz, alapértéke 160.
  • searchButtonIcon — a keresőikon base64 adat-URL-je (SVG/PNG).
  • showSearchButtonTitle / showSearchButtonIcon — a gombfelirat és ikon egymástól független megjelenítése/elrejtése.
  • language — felületi nyelv (system, en, hu, …).
  • direction — ltr | rtl | auto.
  • colorMode — light | dark | auto.
  • primaryColor — a téma elsődleges színkulcsa vagy -neve.
  • themeOverrides — a komponenstémára alkalmazott CSS-karakterlánc.

YAML-törzskonfiguráció (összetett értékekhez ajánlott)​

A Feature rövidkódhoz hasonlóan bármely tulajdonságot átadhat YAML formában a rövidkód törzsében, ami például többsoros themeOverrides esetén kényelmes.

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

Ha ugyanazt a tulajdonságot attribútumként és YAML-ban is megadja, a YAML-törzs az attribútumokra rétegződik.