Cikktípusok készítése a Xarayában A Xaraya legfontosabb tulajdonsága az egyedi cikktípusok egyszerű készítésének lehetősége. Ezzel kiküszöbölhető egyedi modulok készítése, hiszen néhány kattintással tetszőleges mezőkből álló, és tetszőleges megjelenésű adathalmazt hozhatunk létre. Kiváltja a Postnuke-ban közismert: Hírek, Cikkek, Gyakori Kérdések, Hivatkozások, Idézetek modulokat, és még nagyon sok, külső fejlesztők által készített modult! A Cikktípusokhoz tetszőleges adatok hozzáadásának előfeltétele, hogy a Dinamikus Adatok modul hurokként a Cikkek modulra kapcsolódjon. Ezt a Modulok beállításainál ellenőrizhetjük, illetve adhatjuk meg. Ezt a leírást a Xaraya fordítási oldalon látható Fordítások cikktípus készítésére alapozzuk. Cikktípus létrehozása a cikkek alapadataiból A Cikkek modulban kattintsunk a Cikktípusok menüre. Itt láthatóak a telepítéskor létrejött Hírek, Dokumentumok, stb. típusok, kattintsunk az Új gombra. Ábra 1. Új cikktípus létrehozása A megjelenő képernyőn a cikkekhez kapcsolható úgynevezett alapadatokat láthatjuk. Típusnak adjunk meg egy egyszerű nevet, amelyet később fájlnevekben is használhatunk (az oldalsablonokhoz), Leírásnak pedig a weblapon megjelenő teljes nevét az új típusnak. Az egyes alapadatokat névvel láthatjuk el (Címke), illetve ezt az értéket törölhetjük, a mező kikapcsolásához. A formátum választási lehetőségek nagy része egyértelmű, külön említést talán csak az Állapot érdemel, ami a beküldött híreknél, linkeknél szokásos: beküldött, jóváhagyott, főoldali, stb. értékek kezelésének bekapcsolását jelenti.
A Bevitel oszlopban megadhatjuk, hogy az adott mező megjelenik e a típusba tartozó cikkek felvételekor illetve beküldésekor. A Fordítások cikktípus alapadatainak meghatározása a következő képen látható: Ábra 2. A Fordítások cikktípus alapadatai Ennek mentésekor máris létrehozhatunk cikkeket amelyek az itt meghatározott 2 adat bevitelét fogja igényelni. Akinek jelenleg elegendő lehetőséget nyújtanak ezek az alapadatok, a Dinamikus Adatokról szóló, következő fejezetet a átugorhatja, és máris meghatározhatja az új cikktípus milyen elrendezésben jelenjen meg a weblapján! További mezők hozzáadása a Dinamikus Adatok modul segítségével A cikktípus mentése után, kattintsunk a Cikkek modul Beállítások menüpontjára. A felső füleken válasszuk ki az újonnan létrehozott cikktípusunkat, jelen példában a Fordítások -at. Ha a bevezetőben említettnek megfelelően, a Cikkek modulhoz hurokként kapcsolódik a Dinamikus Adatok, akkor a képernyő alján elérhetőek a beállításai. (Dynamic Data Fields [modify]). Kattintsunk a módosítás gombra, majd egyszerűen egyesével adjuk hozzá a szükséges mezőket (3. ábra). Lehetőség van többféle szövegmező (egysoros, kicsi, nagy), szám, naptár, fájl feltöltés, országlista, időzóna választó és még nagyon sok másfajta mező hozzáadására. Érdemes az adatokat előre átgondolni, mert a sorrend jelenleg (0.9.9) nehezen szerkeszthető (sorrendezési számérték megadásával). A Fordítások cikktípus adatait a következőképpen állítottuk össze:
Ábra 3. A Fordítások cikktípus Dinamikus Adatai A Dropdown list típusú mezőkhöz pontosvesszővel elválasztva megadhatóak a benne felsorolt értékek. Az alapértelmezetten kiválasztott, vagy más mezőknél alapértelmezetten kitöltött érték szintén megadható (Default). Mivel a Dinamikus Adat Címkéjét a későbbiekben változónévként fogjuk használni, érdemes először egy tömör, angol karakteres nevet megadni (ilyenkor a rendszerszintű és a megjelenített neve is ez lesz a mezőnek), majd a mező adatainak szerkesztésével átnevezni (kattintás az ID számra). Így lett a Fordítások -ban például a Legutóbbi frissítés rendszerszintű neve frissites, amelyet a későbbiekben tárgyalt oldalsablonokban is könnyebben felhasználunk: Ábra 4. A Dinamikus Adatok rendszerszintű és látható megnevezése Az adatok meghatározásának befejezésekor a cikktípusba tartozó cikkeknél már láthatjuk is az új mezőket és kedvünkre feltölthetjük információkkal. Az új cikktípus megjelenése a weblapon A Xaraya minden megjelenített oldalt a BlockLayout motor által feldolgozott sablonokból épít
fel. Mint ahogy a cikktípus létrehozásakor az oldal alján a rendszer figyelmeztetett is (1. ábra), létre kell hoznunk a megjelenítéshez szükséges fájlokat. Ezek a sablonok egyszerű (X)HTML fájlok, BlockLayout parancsokkal kiegészítve. Cikktípusonként két fájlt használunk, egyet a cikkek listázásához (pl. Postnuke oldalon a hírekkel teli főoldal), a másikat pedig a teljes cikk megjelenítéséhez. Kipróbáláshoz mindenképpen vigyünk fel néhány cikket az új típusból. A Xaraya oldal főmenüjében az Articles modul alatt megjelent az új típus, erre kattintva figyelmeztető üzenetet kapunk a hiányzó sablonról! A cikktípus sablonokat a modules/articles/xartemplates, vagy a themes/modules/articles könyvtárban helyezhetjük el. Az első esetben.xd kiterjesztéssel (rendszersablon), a grafika könyvárában pedig.xt kiterjesztéssel, sablon felüldefiniálásként. Sablonfájljaink neve, a fent említett figyelmeztető üzenet alapján: user-summary-trasnlators.xd (.xt) A listázáshoz user-display-translators.xd (.xt) A teljes cikk megjelenítéséhez Ábra 5. A user-summary-translators.xd sablonfájl
A sablonfájl nevében szereplő translators rész a cikktípus létrehozásánál megadott névből adódik. Mindkettőt érdemes a user-*-news.xd fájlokra alapozni, így a kategória böngésző és egyéb fontos linkek már adottak lesznek. Csak a cikk adataira vonatkozó részeket kell átszerkesztenünk, úgy hogy a mi adatainkat jelenítse meg. Az adatokra a sablonfájlokban #$valtozoneve# formában hivatkozhatunk, az alapvető BlockLayout parancsokat megtanulhatjuk a meglévő user-summary és user-display fájlokból. A cikktípusunk alapadataira az 1. ábrán látható nevekkel (#$title#, #$summary#, stb.) hivatkozhatunk, a Dinamikus Adatokra pedig a hozzájuk megadott rendszerszintű névvel (A 4. ábrán látható adat pl.: #$frissites#.) A teljes user-summary-translators.xd (theme könyvtárban.xt!) fájl a 5. ábrán látható. Az első 5-6 sor a user-summary-news.xd-ből átvett kategória böngésző. Ez alatt jelenik meg egyszerűen a #$title# (jelen esetben ez a lefordított modul eredeti megnevezése) és a #$notes# (a modul honosított neve). Ezek alatti bonyolultabb HTML szerkezet a kis színes folyamatjelző csík, alatta pedig egy egyszerű táblázatban a fentebb meghatározott dinamikus adatok. Ez a sablon a cikkek felsorolásában minden egyes elemre kirajzolódik az adatok behelyettesítésével. Ábra 6. A user-summary-trasnslators.xd sablonnal megjelenő oldal Hasonló sablonfájlt kell készíteni a cikk teljes megjelenítéséhez is, és máris egy eddig elképzelhetetlen új modullal bővítettük a honlapunkat! Sok sikert! Lion/Kempelen Veres Ferenc lion@netngine.hu 2004/06/17