Inhaltsverzeichnis
WvdS.DokuWiki.OpenGraph Vticnik
Vticnik: wvdsopengraph
Verzija: 1.0.0
Imenski prostor: lib/plugins/wvdsopengraph/
Avtor: Wolfgang van der Stille zeljko.petrusic@outlook.de
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
<og> title = Naslov strani description = Opis image = :wiki:logo.png type = article </og>
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:
<og> title = de:Kryptographie|en:Cryptography|sl:Kriptografija description = de:Einführung|en:Introduction|sl:Uvod </og>
Vticnik samodejno zazna jezik iz poti imenskega prostora.
Samodejne oznake
Brez
====== Moj projekt ====== Vsebina strani… </code> ==== Primer 2: Vecjezicno ==== <code>
</code>
—-
===== Generirane HTML oznake =====
<code html>
<!– Open Graph –>
<meta property=„og:title“ content=„OpenSSL dokumentacija“>
<meta property=„og:description“ content=„Obsezen vodic“>
<meta property=„og:image“ content=„https://example.com/lib/exe/fetch.php?media=crypto:openssl-banner.png“>
<meta property=„og:url“ content=„https://example.com/doku.php?id=sl:crypto:openssl“>
<meta property=„og:site_name“ content=„Baza znanja“>
<meta property=„og:type“ content=„article“>
<!– Twitter Card –>
<meta name=„twitter:card“ content=„summary_large_image“>
<meta name=„twitter:title“ content=„OpenSSL dokumentacija“>
<meta name=„twitter:description“ content=„Obsezen vodic“>
<meta name=„twitter:image“ content=„https://example.com/lib/exe/fetch.php?media=crypto:openssl-banner.png“>
</code>
—-
===== 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 ====
<code>
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 <head>
</code>
—-
===== Obravnava napak =====
^ Scenarij ^ Vedenje ^
| Brez <og> 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 =====
* WvdS.DokuWiki.Lang Vticnik - Vecjezicni prevodi
* WvdS.DokuWiki.Image Vticnik - Optimizacija slik
* Open Graph Protocol
* 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 <og> 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 |
Diskussion