Jövőképző — nyilvános profilok (WordPress bővítmény)

A tagok.jovokepzo.hu nyilvános profiljait jeleníti meg a honlapon: egy-egy embert vagy egy egész csoportot (pl. a közösségi mediátorokat).

[jk_nevsor cimke="kozossegi_mediator"]          egy csoport
[jk_nevsor cimke="mentor,szupervizor"]          több csoport egyben (unió)
[jk_nevsor cimke="kozossegi_mediator,mentor" mod="es"]   a metszetük
[jk_nevsor id="19,21,35"]                       kézzel válogatva, ebben a sorrendben
[jk_nevsor nev="Kozári Kata, Béke Gyula"]       ugyanaz, névvel
[jk_csoportok]                                  minden címke külön szakaszban, címmel
[jk_profil id="19"]                             egyetlen ember

Az azonosítókat nem kell fejből tudni: a Beállítások → JK profilok lapon ott a névsor, mindenkinél a kész shortcode-dal.

A lényegi döntés: helyi másolat, kézi szinkron

Az oldalletöltés soha nem hív API-t. A bővítmény a WordPress saját tárolójából dolgozik — a névsor az options táblában, a képek az uploads mappában. Ez azt jelenti, hogy az oldal sebessége nem függ a dashboardtól, és akkor is megjelenik, ha az épp nem elérhető.

A másolat akkor frissül, amikor te megnyomod a szinkront a Beállítások → JK profilok lapon. Nincs óránként futó háttérmunka: az láthatatlan, nem derül ki, ha elhasal, és olyankor is dolgozik, amikor semmi nem változott. A névsor havonta ha mozdul egyet.

A lap kiírja, mikor volt az utolsó szinkron, hány profil és hány kép van meg, és mi hibázott, ha hibázott.

Miért adagokban jönnek a képek

A kép 1024 px-es, adat-URI alakban ~300 KB, és tagonként egy kérés. Mind a huszonhét egyetlen HTTP-kérésben ~9 MB lenne, jó eséllyel max_execution_time-mal a végén. A szinkron ezért hármasával szedi le őket, a böngésző pedig közben mutatja, hol tart.

Telepítés

Bővítmények → Új hozzáadása → Bővítmény feltöltése → a kiadás zipje → Aktiválás. Utána Beállítások → JK profilok → Szinkronizálás most.

Frissítés

A bővítmény a repó kiadásait figyeli, és a WordPress szokásos frissítés-értesítőjében jelenik meg. A „Frissítés keresése" gomb a Beállítások lapon azonnal megnézi.

Shortcode-paraméterek

Kiket mutasson:

Paraméter	Hol	Mit tesz
cimke	jk_nevsor, jk_csoportok	egy vagy több címke vesszővel. jk_csoportok-nál egyszerre válogat és rendez; üresen minden nyilvános címke
mod	jk_nevsor	vagy (alap): aki bármelyik címkét viseli · es: aki mindet
id	jk_nevsor, jk_profil	kézzel válogatott emberek, a megadott sorrendben
nev	jk_nevsor, jk_profil	ugyanaz névvel. Ha a név többre illik, nem tippel — nem ad vissza semmit

Hogyan nézzen ki:

Paraméter	Alap	Mit tesz
oszlop	3	hasábszám asztali nézetben (48 rem alatt mindig egy)
kep	igen	nem esetén kép nélküli, tömör lista
limit	0	0 = mind; egyébként az első N (csoportonként, ha jk_csoportok)
szint	h2	csak jk_csoportok: a szakaszcímek szintje. A kártyanevek eggyel alá kerülnek
ures	nem	csak jk_csoportok: igen esetén az üres csoport címe is kiíródik

Az id és a nev erősebb a címkénél: ha kézzel felsoroltad az embereket, azt akartad.

Ami a másik oldalon dől el

Hogy ki szerepel a névsorban, azt a dashboard dönti el, és két hozzájárulás kell hozzá: az illető kimondta, hogy a profilja mehet a honlapra (member.is_public — alapból hamis), és maga a címke is kifelé szóló (tag.is_public). Aki visszavonja, a következő szinkronnal kikerül — és a fényképét is töröljük innen.

Ha valaki hiányzik: nem itt van a hiba, hanem nála hiányzik az opt-in vagy a bemutatkozás. A dashboard nyilvántartási lapján látszik.

A végpont leírása: NYILVANOS-API.md a JK-dashboard repóban.

Fájlok

wp-jk-profil.php        fejléc, konstansok, betöltés
inc/api.php             a dashboard felé menő HTTP (csak a szinkron használja)
inc/tarolo.php          a helyi másolat: option-ök és képfájlok
inc/szinkron.php        a szinkron lépései + az AJAX-végpont
inc/megjelenites.php    shortcode-ok, kártya, CSS (hálózat nélkül)
inc/beallitasok.php     Beállítások → JK profilok
inc/frissito.php        önfrissítés a Forgejo kiadásaiból
kiadas.sh               verzióemelés + címke + kiadás + zip feltöltése

Kiadás

./kiadas.sh 1.1.0

A szkript átírja a verziót a plugin fejlécében, commitol, címkét tesz rá, felnyomja, csomagol és létrehozza a kiadást a csatolt zippel. A WordPress ezután kínálja fel.