Skip to main content
GenToonGenToon

Incorporare un webtoon

Inserisci un webtoon di GenToon nel tuo blog o sito e i lettori potranno scorrere tutte le vignette direttamente lì, senza uscire dalla tua pagina.

Ecco come appare

Questo è il vero player di incorporamento. Prova a scorrere le vignette.

Come incorporarlo

  1. Tocca «Incorpora» nel post

    Lo trovi sotto il post del webtoon, proprio accanto al pulsante di condivisione.

  2. Scegli una dimensione

    Scegli tra Piccola, Standard e Grande. Se la colonna della pagina è stretta, attiva «Codice responsive». L’anteprima mostra subito la tua scelta.

    In «Modalità di lettura» puoi scegliere tra «Vignetta per vignetta» (predefinita) e «Scorri verso il basso». Scorrendo verso il basso si parte sempre dalla prima vignetta.

  3. Tocca «Copia codice» e incollalo

    Incollalo nell’editor HTML del tuo blog o sito, ed è fatta.

Nell’app, tocca il pulsante di condivisione del post e scegli «Incorpora» per copiare il codice.

Dove incollarlo

WordPress self-hosted
Basta incollare il link del post e il player compare da solo. Usa «Copia link» nella finestra di incorporamento.
Blog e siti che accettano HTML
Incolla il codice ottenuto con «Copia codice» nell’editor HTML.
Campi che accettano solo un indirizzo
Se un campo accetta solo un indirizzo, usa l’indirizzo del player. Ha la forma della riga qui sotto, e l’ID finale corrisponde all’ultima parte dell’indirizzo del post.
https://www.gentoon.ai/embed/post/<id-post>
Tocca «Copia link di incorporamento» nella finestra di incorporamento per copiare questo indirizzo.

Altrove dipende dal fatto che il sito consenta HTML esterno o un iframe. Se non lo consente, condividi il link con «Copia link».

Buono a sapersi

  • Il player non usa cookie e non chiede mai a nessuno di accedere.
  • Se l’autore elimina il post o lo rende privato, non sarà più visibile nei siti in cui è stato incorporato.
  • Le etichette dei pulsanti del player seguono la lingua di ogni lettore.
  • Nella finestra di incorporamento, in «Risultati degli incorporamenti», gli autori possono vedere quante volte il loro webtoon è stato letto su altri siti.

Per sviluppatori

Se il tuo servizio supporta oEmbed, basta il link di un post per mostrare il player.

Endpoint oEmbed

Passa l’indirizzo del post come url. I formati sono json e xml, e maxwidth e maxheight riducono il player mantenendone le proporzioni. Le pagine dei post contengono tag link per il rilevamento oEmbed.

https://www.gentoon.ai/api/oembed

GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=json
GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=xml

Codici di risposta: 200 OK · 404 il post non esiste o l’indirizzo non è quello di un post di GenToon · 401 il post esiste ma non può essere incorporato (ad esempio post privati o disponibili solo nell’app) · 501 un formato diverso da json o xml.

<iframe src="https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315" width="400" height="644" title="Incorporare un webtoon · GenToon" frameborder="0" scrolling="no" loading="lazy" allow="clipboard-write; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen style="border:0;max-width:100%"></iframe>

Indirizzo del player e parametri

https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315?hl=en&theme=dark&start=2&layout=scroll
hl
Fissa la lingua (ad esempio en o ja). Senza questo parametro, il player segue la lingua del browser di chi legge.
theme
Usa dark per un player scuro.
start
Parte dalla vignetta N (contando da 1).
layout
Usa scroll per leggere le vignette una sotto l’altra. Senza questo parametro, chi legge sfoglia una vignetta alla volta. I codici di incorporamento oEmbed mostrano sempre una vignetta alla volta.

Il pulsante a schermo intero compare solo se l’iframe ha allowfullscreen (il nostro codice di incorporamento lo include). WordPress rimuove questo attributo e Safari su iPhone non supporta lo schermo intero, quindi lì il pulsante non c’è. Il pulsante dei sottotitoli (CC) compare solo se la lingua di chi legge è diversa da quella dei dialoghi e, quando lo tocchi, carica la traduzione una sola volta.

Messaggi sull’altezza (postMessage)

Il player avvisa la finestra padre quando la sua altezza cambia. Ascolta i messaggi qui sotto e ridimensiona l’iframe.

Formato predefinito

{"type":"gentoon:embed:resize","postId":"9fa0016a-1192-4a72-afa8-d0ffad90c315","height":644}

Formato Embedly e Iframely

JSON.stringify({"src":"https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315","context":"iframe.resize","height":644,"domains":"all"})

Formato WordPress (quando l’indirizzo termina con #?secret=)

{"message":"height","value":644,"secret":"<secret>"}

Le risposte del player non impostano cookie e sono contrassegnate come noindex, quindi i motori di ricerca non le indicizzano.

Domande

Se l’incorporamento non funziona o vuoi collaborare con noi, scrivi a service@gentoon.ai.

Torna alla Guida