====== WvdS.DokuWiki.OpenGraph Vticnik ====== **Vticnik:** wvdsopengraph\\ **Verzija:** 1.0.0\\ **Imenski prostor:** ''lib/plugins/wvdsopengraph/''\\ **Avtor:** Wolfgang van der Stille \\ **Licenca:** GPL 2 ---- ===== Definicija ===== Vticnik **wvdsopengraph** generira Open Graph in Twitter Card meta oznake za optimalen prikaz pri deljenju na druzabnih omrezjih. Podpira vecjezicne vsebine in strani-specificne preglasitve. ===== Primeri uporabe ===== * **Deljenje na druzabnih omrezjih** - Optimiziran predogled na Facebook, LinkedIn, Twitter * **SEO izboljsave** - Strukturirani meta podatki za iskalnike * **Vecjezicni wikiji** - Samodejno zaznavanje jezika za meta oznake * **Znamcenje** - Enakomeren videz pri povezovanju ---- ===== Sintaksa ===== title = Naslov strani description = Opis image = :wiki:logo.png type = article ==== Parametri ==== ^ Parameter ^ Tip ^ Privzeto ^ Opis ^ | ''title'' | string | //(naslov strani)// | Naslov za druzabna omrezja | | ''description'' | string | //(slogan)// | Opis (maks. 160 znakov) | | ''image'' | string | //(privzeta slika)// | DokuWiki media pot | | ''type'' | string | article | Open Graph tip | ---- ===== Vecjezicne vrednosti ===== Vse vrednosti podpirajo format s crtami: title = de:Kryptographie|en:Cryptography|sl:Kriptografija description = de:Einführung|en:Introduction|sl:Uvod Vticnik samodejno zazna jezik iz poti imenskega prostora. ---- ===== Samodejne oznake ===== Brez '''' bloka vticnik samodejno generira: ^ Oznaka ^ Vir ^ | ''og:title'' | Naslov strani (H1) | | ''og:description'' | Wiki slogan ali defaultDescription | | ''og:url'' | URL trenutne strani | | ''og:site_name'' | Naslov wikija | | ''og:type'' | article | | ''og:image'' | defaultImage iz konfiguracije | ---- ===== Primeri ===== ==== Primer 1: Enostavna preglasitev ==== title = Moj projekt description = Obsezna opisnica projekta image = :projekti:banner.jpg ====== Moj projekt ====== Vsebina strani... ==== Primer 2: Vecjezicno ==== title = de:OpenSSL Dokumentation|en:OpenSSL Documentation|sl:OpenSSL dokumentacija description = de:Umfassende Anleitung|en:Comprehensive guide|sl:Obsezen vodic image = :crypto:openssl-banner.png ---- ===== Generirane HTML oznake ===== ---- ===== Konfiguracija ===== ==== Skrbniške nastavitve ==== Preko **Skrbnik → Konfiguracija → wvdsopengraph**: ^ Nastavitev ^ Tip ^ Privzeto ^ Opis ^ | ''defaultDescription'' | Besedilo | //(slogan)// | Privzeti opis (vecjezicen) | | ''defaultImage'' | Besedilo | //(prazno)// | Privzeta slika media ID | | ''twitterSite'' | Besedilo | //(prazno)// | Twitter @uporabnisko_ime za twitter:site | | ''enableTwitterCards'' | Vklop/Izklop | Vklop | Generiraj Twitter Card oznake | ---- ===== Kako deluje ===== ==== Procesni cevovod ==== 1. Razclenitvanje strani └── Išce ... blok na zacetku strani 2. Ekstrakcija parametrov └── Razcleni pare kljuc = vrednost └── Zazna de:X|en:Y format 3. Zaznava jezika └── Doloci jezik iz imenskega prostora └── Izvlece ujemajoco vrednost 4. Generiranje meta oznak └── Ustvari og:* in twitter:* oznake └── Vstavi v ---- ===== Obravnava napak ===== ^ Scenarij ^ Vedenje ^ | Brez bloka | Uporabi samodejne vrednosti | | Slika ni najdena | Uporabi defaultImage | | Neveljaven jezik | Nadomestna vrednost na prvo vrednost | | Prazna vrednost | Oznaka se ne generira | ---- ===== Dobre prakse ===== * **Opis:** Najvec 160 znakov * **Naslov:** Najvec 60 znakov * **Slika:** Najmanj 1200×630 pikslov za optimalen prikaz * **Format:** JPEG ali PNG za slike ---- ===== Zgodovina verzij ===== ^ Verzija ^ Datum ^ Spremembe ^ | 1.0.0 | 2025-01-06 | Zacetna izdaja | ---- ===== Glej tudi ===== * [[wvdslang]] - Vecjezicni prevodi * [[wvdsimage]] - Optimizacija slik * [[https://ogp.me/|Open Graph Protocol]] * [[https://developer.twitter.com/en/docs/twitter-for-websites/cards|Twitter Cards]] ---- ===== Tehnicna referenca ===== ==== Razred: syntax_plugin_wvdsopengraph ==== **Datoteka:** ''lib/plugins/wvdsopengraph/syntax.php'' ^ Metoda ^ Opis ^ | ''getType()'' | Vrne ''substition'' | | ''getSort()'' | Vrne ''50'' (zgodaj) | | ''handle($match, ...)'' | Razcleni blok | | ''render($mode, ...)'' | Brez izhoda (samo meta oznake) | ==== Razred: action_plugin_wvdsopengraph ==== **Datoteka:** ''lib/plugins/wvdsopengraph/action.php'' ^ Metoda ^ Opis ^ | ''register()'' | Registrira TPL_METAHEADER_OUTPUT dogodek | | ''addMetaTags()'' | Vstavi meta oznake v glavo | ---- {{wvds:snippet>wvds_audit_badge}} ~~DISCUSSION~~