Útmutatók

A phpBB3 megjelenések fájljai

phpBB3 megjelenések fájljainak listája
Cikk eredeti azonosítója: 515
Írta: TheIlluminative
Kelt: 2008. November 4-én, kedden, 01:16-kor
Magyarra fordította: HoremWeb
Fordítás kelte: 2008. december 13. 22:47-kor
Leírás: A phpBB3 (Olympus) megjelenéseiben használt összes fájl listája.
Link az eredeti cikkre:
Knowledge Base - phpBB3 Styles' files list

phpBB3 megjelenések fájljainak listája

Ahogyan a phpBB2-ben, úgy a phpBB3-ban is van fejrész (header), törzs (body) és lábrész (footer), amelyek közül az overall_header.html és a simple_header.html a fejrész kinézetét határozza meg, az overall_footer.html és a simple_footer.html a lábrészét. Minden mást a további sablonfájlok írnak le (amelyeket a cikk további részében ismertetni fogunk). Az általában használt oldalak a fentiek közül az overall_header.html-t és az overall_footer.html-t használják (ilyenek az index, viewforum, viewtopic, azaz a kezdőoldalt, fórumokat és témákat megjelenítő oldalak), míg a felugró ablakok, áttekintő oldalak a simple_header.html-t és a simple_footer.html-t alkalmazzák. A legérdekesebb számunkra az, hogy most már a fejrészek és lábrészek teljes egészükben csak a sablonfájlokhoz kapcsolódnak, nem a PHP fájlokhoz, így szabadon eldöntheted, hogy a megjelenésedben az eredeti fájlok valamelyikét használod-e, vagy esetleg teljesen újat írsz (más fájlnévvel).

A phpBB3-t két megjelenéssel bocsátották útjára, a prosilverrel és a subsilver2-vel, és mindkettőnek saját, eltérő tervezési és kódolási rendszere van:

subsilver2
TABLE táblázatok alkotják, mint a régimódi subsilvert a phpBB2-ben, és CSS határozza meg a színeket, háttereket, egyebeket.
prosilver
Teljes mértékben a CSS alakítja ki a kinézetet, és a szerkezet DIV-ekre és listákra alapul.

A fájlok kiterjesztése is megváltozott a phpBB3-ban a phpBB2-höz képest: TPL helyett HTML lett. Egyetlen egyszerű oka van a változtatásnak: könnyebbé tenni azoknak az életét, akik a fájlok szerkesztéséhez kódkiemelős szerkesztőt stb. használnak.

Az Olympusban a megjelenések mappájában van egy style.cfg fájl és három másik könyvtár. A style.cfg a megjelenésre vonatkozó információkat tartalmazza (a megjelenés nevét, szerzőjét, változat számát stb.), míg a könyvtárak a következők:

imageset – a megjelenésben használt képeket tartalmazza és az imageset.cfg fájlt, ami a megjelenés számára definiálja a képeket.
template – a fő HTML fájlokat tartalmazza, amelyek a megjelenés vázát adják meg, az oldalakat, mi hova kerüljön stb. Tartalmaz még egy template.cfg fájlt is, ami a sablonra vonatkozó információkat hordozza.
theme – A kinézetre vonatkozó CSS fájlokat tartalmazza, amelyek azt írják le, hogyan kell megjelennie a dolgoknak: a színeket, háttereket, linkeket, hasonlókat. Tartalmaz még egy theme.cfg fájlt is, ami a kinézetre vonatkozó információkat rejti.

És akkor itt van az összes fájl listája, amit a megjelenések könyvtárában találhatsz (akár prosilverről vagy subsilver2-ről legyen szó), és röviden az is, hogy milyen feladatokat látnak el (ábécé sorrendben).
A phpBB3-nak két megjelenése van, eltérő felépítéssel, így először azokat a fájlokat mutatom be, amelyek közösek mindkét megjelenésnél, és hasonló a feladatuk. Ezek után jönnek majd azok a fájlok, amelyek eltérőek a két megjelenésnél, vagy más a szerepük egyik vagy másik megjelenésben.

Theme könyvtár

stylesheet.css - Ez a fájl felelős a CSS kódolásért, és ez határoz meg minden osztályt, amit a megjelenés használ.

A prosilver subsilver2-höz képest eltérő fájljai

bidi.css – Ez a fájl felel az RTL beállításokért, ahol a jobbról balra írás szükséges (Fordítói megjegyzés: RTL = Right To Left = Jobbról Balra).
buttons.css – A gombok megjelenítéséért felel (Új téma, Válasz stb.).
colours.css – Ebben a fájlban vannak a színek a fórum felületekhez, szövegekhez, hátterekhez stb.
common.css – Általános célú formázások, például a fejrészhez, tartalomhoz, lábrészhez stb.
content.css – A tartalmi elemek és a belső oldalak formázása, mint a viewforum_body.html-é, a viewtopic_body.html-é stb.
cp.css – A felhasználói vezérlőpult (FVP) kinézetét alakítja (fülek, privát üzenetek, oldala stb.).
forms.css – Űrlapok formázása, például: bejelentkező űrlap, üzenetküldés, szövegdobozok stb.
large.css – Megjeleníti a nagyobb szövegméretet, amikor az "vA^" gomra kattint a látogató.
links.css – A linkek formázása, színe, háttere, egér alatti viselkedése stb. (a színeket a colours.css-ből veszi, ez a formázási beállításokat adja meg, szövegméretet, stílust stb.).
medium.css – Megjeleníti a közepes szövegméretet, amikor az "vA^" gomra kattint a látogató.
normal.css – Megjeleníti a nagyobb szövegméretet, amikor az "vA^" gomra kattint a látogató, és visszatér a kezdeti állapothoz...
print.css – Ez határozza meg a nyomtatáshoz használt formátumot, amikor a látogató a "Nyomtatás" gombra kattint.
tweaks.css – Böngészőre szabott beállítások, például az IE használatánál.

Mindezeket a fájlokat a stylesheet.css fogja össze az "import" tulajdonsággal:

Kód:

@import url("filename.css");

A theme könyvtár tartalmazza az images könyvtárat, ahol a megjelenés képei, hátterei, ikonjai stb. találhatók.

Template könyvtár

attachment.html – Ez a fájl jeleníti meg a csatolt állományokat a hozzászólásokban és privát üzenetekben.
bbcode.html – A BBCode gombokat meghatározó fájl, ez tartalmazza a gombokat, és hogy mi a feladatuk.
confirm_body.html – Visszaigazoló oldal. Ez jelenik meg, amikor valamit vissza kell igazolni (péládul azt, hogy tényleg törölni akarod a témat stb.)
custom_profile_fields.html – Egyedi profil mezők fájlja, ez jelenik meg, amikor a profilt szerkeszti a látogató, vagy amikor a regisztrációkor a mezők kitöltése kötelező.
editor.js – Szövegszerkesztő JavaScript fájl, akkor használatos, amikor egy témába ír a felhasználó, válaszol, privát üzenetet küld. Ez fejti ki a BBCode gombok és más, íráshoz használt eszközök hatását.
faq_body.html – A gyakran ismételt kérdések és a BBCode útmutató oldalait jeleníti meg.
forumlist_body.html – Ez a fájl jeleníti meg a fórumkategóriákat a fórumok és a fórum kezdőlap oldalán, a viewforum és az alfórumok oldalain.
index_body.html – A fórum kezdőlapot megjelenítő oldal.
jumpbox.html - Megjeleníti a gyors navigálás (ugrás egy fórumra) legördülő menüjét.
login_body.html – Bejelentkező oldal, a fórumra vagy az adminisztrátori vezérlőpultra (AVP) bejelentkezéskor jelenik meg.
login_forum.html – Bejelentkező oldal a jelszóval védett fórumokhoz.
mcp_approve.html – A témák és hozzászólások elfogadását lehetővé tévő oldal megjelenítése az elfogadásra váró hozzászólások felsorolásával. Ez az oldal jeleníti meg a várólistát.
mcp_ban.html – Kitiltások kezelő oldala, akkor jelenik meg, ha a moderátornak jogában áll felhasználókat kitiltani.
mcp_footer.html – A moderátori vezérlőpult (MVP) lábrésze, ez tartalmazza az oldalszámokat, témákat, hozzászólásokat stb.
mcp_forum.html – Fórum moderálása a MVP-n.
mcp_front.html – A MVP kezdőlapja, ez tartalmazza a legutóbbi műveleteket, mint például az 5 legutóbbi jelentést, öt utolsó naplózást stb.
mcp_header.html – Az MVP fejrésze, ez tartalmazza a füleket vagy a blokkokat, az éppen moderált elem címét stb.
mcp_logs.html – A moderátori napló oldala, ahol a moderátorok ellenőrizhetik a saját és más moderátorok ténykedését.
mcp_message.html – Az üzenet, ami megjelenik a moderátori tevékenységek végrehajtása, például egy téma típusának megváltoztatása után.
mcp_move.html – Téma áthelyezés oldala moderátorok számára, ahol kiválasztható a téma új helye, és visszaigazolható a művelet.
mcp_notes_front.html – A felhasználói feljegyzések kezdőoldala, itt lehet kiválasztani a felhasználót, és megjeleníteni a hozzá fűződő feljegyzéseket.
mcp_notes_user.html – A felhasználói feljegyzések tulajdonképpeni tartalma, itt olvashatók az előzetesen kiválasztott felhasználóhoz kapcsolódó feljegyzések, és itt írható hozzá új feljegyzés is.
mcp_post.html – A hozzászólások moderálására szolgáló oldal az MVP-n, ez mutatja a különféle lehetőségeket a moderátornak, például a hozzászólás lezárására, a hozzászólás szerzőjének megváltoztatására stb.
mcp_queue.html – Ez az oldal jeleníti meg a témákat és a hozzászólásokat a moderátori sorban.
mcp_reports.html – Ez az oldal mutatja a jelentéseket az MVP-n.
mcp_topic.html – Ez a témák moderálására szolgáló oldal az MVP-n, itt lehet szerkeszteni, lezárni egy témát, kiemeltté vagy közleménnyé tenni stb.
mcp_viewlogs.html – A megadott téma naplóját mutató oldal.
mcp_warn_front.html – A figyelmeztetések kezdőoldala, ahol megtekinthető, hogy kik a legtöbbször figyelmeztetett felhasználók, mi volt az öt legutóbbi figyelmeztetés, valamint ki lehet választani a figyelmeztetéshez egy felhasználót.
mcp_warn_list.html – Az összes figyelmeztetett felhasználót felsoroló oldal.
mcp_warn_post.html – Egy adott hozzászólásért itt lehet figyelmeztetni a felhasználót. Akkor jelenik meg ez az oldal, amikor a hozzászólás melletti Figyelmeztetés ikonra kattint a moderátor.
mcp_warn_user.html – A figyelmeztetések felhasználókat kezelő oldala. Akkor jelenik meg, amikor a Figyelmeztetések kezdőoldalán rákeresel egy felhasználóra, vagy ha a felhasználó profilján a Figyelmeztetés linkre kattintasz.
mcp_whois.html – Ez az oldal mutatja meg az IP-adatokat, amikor a hozzászólásnál lévő Hozzászólás adatai ikonra kattintasz.
memberlist_body.html – A taglista oldala. Akkor jelenik meg, ha a Taglista linkre kattintasz.
memberlist_email.html – Az e-mail küldése oldal, ha a felhasználó profilján az E-mail gombra, vagy egy témánál a Barát értesítése e-mailben linkre kattintasz, feltéve, hogy engedélyezve van a fórumon keresztüli e-mail küldés.
memberlist_im.html – Az azonnali üzenetküldés felugró ablak akkor jelenik meg, ha a felhasználó profiljában vagy a hozzászólása alján valamelyik azonnali üzenetküldő szolgáltatás linkjére kattintasz.
memberlist_leaders.html – Az adminisztrátorok és moderátorok listája, amit a lábrészben található, A csapat linkre kattintva lehet megjeleníttetni.
memberlist_search.html – Keresés a taglistában. Kattints a Felhasználó keresése linkre a taglistán, és ez az oldal jelenik meg.
memberlist_view.html – Ez az oldal a felhasználó profilját mutatja meg. Kattints egy felhasználó nevére, ha ezt az oldalt akarod látni.
message_body.html – Egy általános üzenet, ez jelenik meg, amikor valamilyen műveletet hajtasz végre, például új témát nyitsz, és kiírja a fórum, hogy "Az üzenet sikeresen elküldve" stb., azért ez a fájl felel.
overall_footer.html – A fórumrendszer lábrésze, amit a főbb oldalakon használ a rendszer, mint a fórum kezdőlap, viewforum, keresés stb. Ez tartalmazza a szerzői jogi információt, fordítási információkat stb. (Fordítói megjegyzés: ezeket nem etikus eltávolítani!)
overall_header.html – A fórumrendszer fejrésze, amit a főbb oldalakon használ a rendszer. Ez tartalmazza a fórum logóját, címét, linkjét stb.
posting_attach_body.html – Ha fájlt akarsz csatolni egy hozzászóláshoz, ezt az oldalat hívja meg a fórum.
posting_body.html – A hozzászólásküldő fájl, ez használatos a hozzászólások, privát üzenetek, új témák stb. írására.
posting_buttons.html – Ez a fájl felel a BBCode-ok gombjainak megjelenítéséért, amikor hozzászólást, privát üzenetet stb. küldesz.
posting_poll_body.html – Ez az oldal felel a szavazás hozzáadásáért, amikor új témát nyitsz.
posting_preview.html – Ha elküldés előtt meg akarsz nézni egy új témát, hozzászólást, privát üzenetet, és az Előnézet gombra kattintasz, ez a fájl jeleníti meg, amit látni fogsz.
posting_review.html – Amikor egy hozzászólásra választ írsz, és közben beérkezik rá egy másik válasz is, ez az oldal fogja neked megmutatni, hogy érkezett ilyen, és lehetővé tenni, hogy az új hozzászólás fényében megváltoztasd a válaszodat.
posting_smilies.html – Az emotikonok oldala, ez jelenik meg, amikor hozzászólást vagy személyes üzenetet írsz.
posting_topic_review.html – A téma áttekintő oldal, ezt látod akkor, amikor válaszolsz egy témában, és alul átnézed, hogy az előző hozzászólások mit tartalmaztak.
search_body.html - A kereső kezdőoldala, akkor látod ezt a fájlt, amikor a Keresés linkre kattintasz.
search_results.html – A kereső találati oldala. Bármire is keresel, ezt a fájlt fogod látni, amikor a keresés eredménye megjelenik.
simple_footer.html – Ez a fájl a felugró ablakok, téma áttekintők stb. lábrésze.
simple_header.html – Ez a fájl a felugró ablakok, téma áttekintők stb. fejrésze.
template.cfg – Ez a fáj tartalmazza a sablonokra vonatkozó információkat, és ez határozza meg a sablon adatait a fórumrendszer számára.
ucp_agreement.html – A feltételek elfogadásának oldala, ami a regisztráció során jelenik meg.
ucp_attachments.html – Ez a fájl listázza a kiválasztott felhasználó által feltöltött csatolmányokat, amikor a felhasználói vezérlőpulton (FVP) a Csatolmányok kezelése linkre kattintasz.
ucp_footer.html – Az FVP lábrésze.
ucp_groups_manage.html – A csoportok kezeléséhez, ha valamelyik csoport vezetője vagy, ezt a fájlt hívod meg.
ucp_groups_membership.html – A csoporttagság oldala, kattits a Csoportok linkre, ha ezt a fájlt akarod látni.
ucp_header.html – A FVP fejrésze, ez tartalmazza a linkek blokkjait stb.
ucp_main_bookmarks.html – Kedvencek oldala, ez jeleníti meg a kedvencként jelölt témákat. Kattints a FVP-n a Kedvencek kezelése linkre, hogy ezt az oldalt lásd.
ucp_main_drafts.html – A piszkozatok kezelésére szolgáló oldal, a FVP-n a Piszkozatok kezelése linkre kattintva jeleníthető meg.
ucp_main_front.html – A FVP kezdőoldala, kattints a Felhasználói vezérlőpult linkre, ha meg akarod tekinteni.
ucp_main_subscribed.html – Ez az oldal listázza a témákat, amikre feliratkoztál. Ha a feliratkozás engedélyezett a fórumon, a FVP-n kattints a Feliratkozások kezelése linkre, hogy ez a fájl nyíljon meg.
ucp_pm_history.html – A privát üzenetek előzményei, ez listázza ki az adott felhasználónak küldött és tőle kapott üzeneteket, amikor privát üzenetben válaszolsz valakinek.
ucp_pm_message_footer.html – A privát üzenetek lábrésze, akkor jelenik meg, amikor egy privát üzenetet tekintesz meg.
ucp_pm_message_header.html – A privát üzenetek fejrésze, akkor jelenik meg, amikor egy privát üzenetet tekintesz meg.
ucp_pm_options.html – Privát üzenet beállítások, kattints a privát üzenetek oldalon a Szűrők, mappák és beállítások linkre, hogy ez a fájl jelenjen meg.
ucp_pm_popup.html – Az új privát üzenetek felugró ablaka, akkor jelenik meg, ha a Fórum beállításoknál engedélyezett a Felugró ablak új üzenet érkezésekor szolgáltatás, és új privát üzeneted érkezik.
ucp_pm_viewfolder.html – A privát üzenet mappák oldala, ez mutatja meg egy mappa (Bejövő, Kimenő, Elküldött, Elmentett üzenetek) tartalmát.
ucp_pm_viewmessage.html – Az üzenetet megjelenítő oldal, akkor jelenik meg, amikor egy privát üzenetet olvasol.
ucp_pm_viewmessage_print.html – Ezt a fájlt használod, amikor kinyomtatsz egy privát üzenetet. Kattints a nyomtatót ábrázoló ikonra vagy a Nyomtatóbarát verzió linkre egy üzenet olvasásakor, és ezt a fájlt fogod látni.
ucp_prefs_personal.html – Általános beállítások oldala, a FVP-n kattints a Fórum beállítások linkre, és ez jelenik meg.
ucp_prefs_post.html – A felhasználó alapértelmezett hozzászólás beállításainak oldala, a FVP-n a Fórum beállításoknál kattints a Hozzászólás beállítások linkre, és ez a fájl jelenik meg.
ucp_prefs_view.html – Megjelenítési beállítások oldala, a FVP-n a Fórum beállításoknál kattints a Megjelenítési beállítások szerkesztése linkre és ezt a fájlt látod.
ucp_profile_avatar.html – Az avatar beállító oldal, a FVP-n a Profil részen kattints az Avatar szerkesztése linkre, és ez a fájl jelenik meg.
ucp_profile_profile_info.html – A személyes adatok oldala, a FVP-n a profil részen kattints a Profil szerkesztése linkre, és ez jön elő.
ucp_profile_reg_details.html – Az azonosító beállítások oldala, a FVP-n a profil részen kattints az Azonosító beállítások szerkesztése linkre, és ez jelenik meg.
ucp_profile_signature.html – Az aláírásszerkesztő oldala, a FVP-n a profil részen kattints az Aláírás szerkesztése linkre, és ez a fájl jelenik meg.
ucp_register.html – Az új regisztrációt lehetővé tévő oldal, kattints a Regisztráció linkre a fejrészen, és ez a fájl jelenik meg.
ucp_remind.html – A jelszóemlékeztető oldala, ha az Elfelejtettem a jelszavam linkre kattintasz a belépéskor, ezt a fájlt fogod látni.
ucp_resend.html – Az aktiváló e-mail újraküldését végző oldal, ha nem kaptad meg az aktiváló e-mailt, kattints az Aktiváló e-mail újraküldése linkre, és ez az oldal jelenik meg.
ucp_zebra_foes.html – A haragosok kezelését lehetővé tévő oldal, kilistázza a haragosokat, és lehetővé teszi, hogy kezeld a haragosok listáját. A FVP-n a Barátok és haragosok részen kattints a Haragosok kezelése linkre, ha ezt a fájlt akarod látni.
ucp_zebra_friends.html – A barátok kezelését lehetővé tévő oldal, kilistázza a barátaidat, és lehetővé teszi, hogy kezeld a barátok listáját. A FVP-n a Barátok és haragosok részen kattints a Barátok kezelése linkre, ha ezt a fájlt akarod látni.
viewforum_body.html – Ez az oldal jeleníti meg a fórumok tartalmát, kattints egy fórum címére a fórum kezdőlapon, ha ezt a fájlt akarod látni.
viewonline_body.html – Ez az oldal jelzi, hogy kik vannak jelen az adott pillanatban a fórumon. Kattints a Ki van itt linkre a fórum kezdőlapon, és ez a fájl listázza ki az eredményt.
viewonline_whois.html – Ez az oldal írja ki az IP-adatokat, amikor a Jelenlévő felhasználók oldalán az Adatok linkre kattintasz.
viewtopic_body.html – A témák és hozzászólások megjelenítését végző fájl, ha látni szeretnéd, kattints egy téma címére.
viewtopic_print.html – A téma nyomtatási előnézetét megjelenítő fájl, kattints a nyomtató ikonra vagy a Nyomtatóbarát verzió linkre a fejlécen, ha ezt az oldalt akarod látni.

Eltérő oldalak az egyes megjelenésekben:

prosilver

drafts.html – A piszkozatokat betöltő oldal, hozzászólás küldésekor kattints a Betöltés gombra, ha ezt az oldalt akarod látni.
forum_fn.js - A fórum funkciók JavaScript fájlja, ez vezérli a felugró ablakokat, navigációt (jumpbox) stb.
posting_editor.html – A prosilver fő hozzászólásszerkesztőjének fájlja.
posting_layout.html – A hozzászólásküldő oldal, ez tartalmazza a szerkesztőt, emotikonokat, szavazás hozzáadását, csatolmányokat stb.
posting_pm_layout.html – A privát üzenet író főoldal, hasonló a posting_layout.html-hoz, de a privát üzenetekhez való.
Ez azt jelenti, hogy a posting_body.html önmagában semmit nem csinál, hanem a fenti fájlokra van felosztva, és azokat include-olja a használathoz.
styleswitcher.js – JavaScript fájl, ami a felhasználói sütiket, a betűnagyság megváltoztatása funkciót, aktív stíluslap beállításait és egyebeket tartalmazza.
ucp_avatar_options.html – A felhasználó avatar beállításai. Ez a fájl megegyező a hozzászólás beállítások állománnyal, az ucp_profile_avatar.html is ezt include-olja az avatar beállításokhoz.

subsilver2

breadcrumbs.html – Ez a fájl tartalmazza a navigációs útvonalat és az időt.
mcp_jumpbox.html – A MVP navigációs legördülő menüje (ez a fájl már nincs használatban!).
memberlist_group.html – Ez az oldal jeleníti meg a csoport információit, amikor egy csoport nevére kattintasz.
pagination.html – Ez a fájl jeleníti meg az oldalszámokat, amikor egy fórum, alfórum, téma több oldalból áll.
posting_progress_bar.html – A feltöltő oldal: amikor csatolmányt töltesz fel, egy felugró ablak jelenik meg a feltöltés állapotának jelzésére. Ez a fájl jeleníti azt meg.
searchbox.html - A keresőmező az egyes alfórumokhoz, témákhoz stb.

A fájlok más állományokba beillesztése (include-olása) az alábbi, egyszerű módon történik az INCLUDE utasítás segítségével: