Tuote-JSON-LD · WooCommerce
Lisää tuote-JSON-LD WooCommerceiin (devaajalle ja tekoälyagentillesi)
Tarkka, varmennettu tapa saada AI-haun JSON-LD WooCommerce-tuotesivulle — server-side ja monikielinen. Tee itse alla olevilla askeleilla, anna runbook tekoälyagentillesi, tai anna Store Operatorsin hoitaa se puolestasi.
JSON-LD:n on renderöidyttävä PALVELINPUOLELLA. WordPress/WooCommerce REST ei voi muokata teeman PHP:tä, joten käytä YHTÄ näistä: (a) snippet-plugin (Code Snippets tai WPCode) + PHP-snippet; (b) child-teeman functions.php SFTP/SSH:lla; tai (c) kevyt Store Operators -helper-plugin jos haluat sen ylläpidettynä koko katalogille.
Lisää PHP-snippet joka koukkaa `wp_head` (tai `woocommerce_before_single_product`) ja tulostaa JSON-LD-`<script type="application/ld+json">`:n VAIN tälle tuotteelle: ehto `if (is_product() && get_the_ID() === <tuote-id>)`. Löydät <tuote-id>:n WooCommerce-administa (Products → tuote → post-ID URL:ssa).
Monikielisyys (WPML / Polylang): haarauta nykyisen kielen mukaan (`get_locale()` / `ICL_LANGUAGE_CODE` / `pll_current_language()`) ja tulosta SEN kielen JSON-LD, jotta jokainen tuotteen kieliversio tarjoilee omansa (yksikielinen kauppa — ei haaraa).
Vältä tuotekuvaus-kenttää `<script>`:lle: WordPress voi poistaa sen (`wp_kses`) käyttäjän oikeuksista riippuen (`unfiltered_html`), joten se on epäluotettava. Tulosta se `wp_head`-koukun kautta.
- Verifiointi
- Katso tuote-URLin (kunkin kielen) lähdekoodi: `application/ld+json` läsnä ja validi.
- Monikielisyys
- Monikielisyys = haarauta snippetissä nykyisen kielen mukaan (WPML/Polylang) TAI anna Store Operators -pluginin tarjoilla per-locale automaattisesti. Jokaisen kieliversion pitää tulostaa oman kielensä JSON-LD.

Anna tämä omalle agentillesi
Tämä runbook lisää tuote-JSON-LD:n yhteen tuotteeseen kerrallaan. Se varmuuskopioi ensin, työskentelee julkaisemattomalla kopiolla, verifioi tuloksen eikä julkaise mitään ilman sinua.
You are helping me add AI-search JSON-LD to ONE product on my WooCommerce (WordPress) store, safely.
SAFETY (follow exactly, in order):
1. Back up first: duplicate the current theme (or export it) BEFORE any write. No exceptions.
2. Work on an UNPUBLISHED copy / preview — never edit the live theme directly.
3. Use a least-privilege token: only the scopes the task needs.
4. After each change, VERIFY (fetch the page, confirm the JSON-LD renders and is valid).
5. Do NOT publish. Show the human the preview and the verification, and let the human approve the publish.
6. Keep the rollback ready: if anything looks wrong, restore the backed-up theme.
ACCESS:
- I will give you either WP-CLI/SSH access, or admin + a code-snippets plugin (Code Snippets/WPCode). Code injection needs one of these — the WooCommerce REST key alone CANNOT add theme code.
TASK:
- Product URL: https://your-store.com/product/your-product. Store locales: your primary language.
1. Back up first: export the active/child theme (or the current snippets).
2. Add a PHP snippet (via the snippets plugin, or a child-theme mu-plugin via WP-CLI/SSH) that hooks `wp_head` and echoes the JSON-LD `<script type="application/ld+json">` ONLY on this product (`is_product() && get_the_ID() === <product-id>`). Avoid the product-description field (WordPress may strip scripts via wp_kses depending on user capability).
3. If the store uses WPML/Polylang, branch on the current language and echo that language's JSON-LD (ask me for each language's JSON-LD — Outcite generates one per language).
4. VERIFY: fetch the product URL (each language) and confirm `application/ld+json` is present and valid.
5. STOP and show me the result. I activate/publish the snippet myself.
JSON-LD to inject:
{}Runbook on englanniksi tarkoituksella — agenttipromptit toimivat englanniksi luotettavimmin. Voit silti keskustella agentin kanssa suomeksi.
Onko sinulla jo valmis JSON-LD?
Outcite tulostaa valmiin, kielikohtaisen JSON-LD:n. Silloin agentin ei tarvitse keksiä kenttiä vaan ainoastaan asentaa lohkot oikein. Kerro montako kieliversiota sinulla on, niin prompt mukautuu.
Minulla on valmis tuote-JSON-LD Outcitesta. ÄLÄ generoi uutta äläkä muuta sen sisältöä. Alusta: WooCommerce. Kielet: Minulla on yksi JSON-LD-lohko. Tee näin: 1. Asenna se niin, että se renderöityy tuotesivulla server-side. 2. Älä muuta yhtäkään kentän arvoa. 3. Verifioi renderöity sivu ja näytä minulle mitä JSON-LD:tä se tulostaa. TURVA: varmuuskopio ennen kirjoitusta, työskentele julkaisemattomalla kopiolla, älä julkaise mitään ilman hyväksyntääni, ja kerro paluutie. Liitä Outcitesta saamasi lohkot tämän rivin alle: ---
Et vielä tarvitse omaa JSON-LD:tä? Generoi se Outcitella — se tulostaa kielikohtaisen lohkon jokaiselle kieliversiolle.
Näe missä kauppasi ei näy tekoälylle.
Etkö halua tehdä itse?Generoi JSON-LD nyt (Outcite)Valmis, siteerattava tuotesivu + schema per ajo.
Etkö halua tehdä itse?Tehdään puolestasi: AI Visibility FixRakennamme ja ylläpidämme koko datalayerin.
Etkö halua tehdä itse?Agenttinen kauppaAsiakkaan oma tekoäly ostaa suoraan kaupastasi.
Etkö halua tehdä itse?Opi koko systeemi (kirja + kurssi)Käytä tämän sivun runbookia — liitä se Claudeen. Se yhdistää WooCommerce-kauppaasi omilla tunnuksillasi ja lisää schema.org-JSON-LD:n, varmuuskopiolla, esikatselulla, verifioinnilla ja sinun hyväksynnälläsi ennen julkaisua.
Sama runbook toimii ChatGPT:llä (tai millä tahansa kyvykkäällä agentilla): se kirjautuu kauppaasi ja injektoi JSON-LD:n server-side, turvallisesti, ja pysähtyy hyväksyntääsi ennen julkaisua.
Kyllä — server-side (pelkkää client-side-JavaScriptiä AI-crawlerit eivät luotettavasti näe). Tee se tämän sivun agentti-runbookilla, anna devaajalle, tai anna Store Operatorsin hoitaa se.
Miltä kauppasi näyttää tekoälylle?
Ilmainen auditointi. Ei kirjautumista, toimii kaikilla alustoilla.