Wayfinder - helyszíni létrehozás a modx forradalomban
A Wayfinder fő feladata olyan navigációs menü létrehozása, amely automatikusan frissül a dokumentumfájl módosításakor, de más célokra is sikeresen használható.
Mivel a Wayfinder egy oldalra többször is felhívható, és minden hívás a dokumentumfájl különböző szintjeire mutathat, egy oldalon különféle navigációs menüket vagy dokumentumlistákat hozhat létre. Például a navigációs menüt az oldal tetején készítheti el, majd oldalról további menüket készíthet a termékek, szolgáltatások, parancsok stb. Számára. amely a dokumentumfa különböző részeihez kapcsolódik.
Felhívjuk a figyelmet arra, hogy a forradalom kiadása óta kétféle Wayfinder kivonat létezik: az Evolution és a Forradalom. Általánosságban elmondható, hogy mindkét verzió funkcionálisan azonos, mint azok paraméterei. A Forradalomban a kódrészletet a. [[! Wayfinder? . ]]. de az evolúcióban, mint [! Wayfinder? . ].
A Wayfinder a MODx fórumokon beszélhet. További Wayfinder 2.0 dokumentáció itt található.
A Wayfinder teljesen áttervezték az eredeti DropMenu verziót, hogy megkönnyítse a szükséges menü létrehozását darabok és kimeneti sablonok segítségével. Ha sablonokat használ a rugalmas menü kimenet számára, több paraméter, például táblázatok, felsorolt és nem jelölt listák használata már nem szükséges.
Telepítés a forradalomhoz
A MODx Revolution programban a Wayfinder betölthető a vezérlőpanel csomagkezelő menüjéből. Menjen a "Rendszer -> csomagkezelés" menübe, kattintson a "Download add-on" lehetőségre és töltse le a Wayfinder programot. Ezt követően szabványos eljárással kell telepítenie.
[[! Wayfinder? startId = `0` szint = `1`]]
Ennek eredményeképpen egy többszintű rendezetlen lista jelenik meg, amely a MODX webhely összes dokumentumának fáit képviseli, és mindegyik elem egy hivatkozás a megfelelő dokumentumhoz.
Általános beállítások
Alapértelmezett értékek
A kimeneti dokumentumokat tartalmazó menü kezdőpontja (dokumentum azonosítója). Adja meg a 0-t, hogy elindítsa a menüt a webhely gyökeréből.
az aktuális dokumentum id
0 | dokumentum id | [[* parent *]] | [[* id *]]
Ha a displayStart = 1, ez okozza a Wayfinder számára, hogy egy linket adjon ki a dokumentumként használt dokumentumhoz startId, a sablon szerint startItemTpl. A paraméter akkor működik, ha a startId nem 0.
Sablonbeállítások
Ezek a paraméterek jelölik azokat a darabokat, amelyek sablonokat tartalmaznak a Wayfinder kimenet kezeléséhez.
A WayFinder For Revolution létező változatában a tv-paraméterek a wf előtag nélkül érhetők el. például [[+ my_TV]].
Jelenleg a tv paraméterhez tartozó feldolgozatlan érték visszaküldik, nem formázódik. Például, ha tv-paramétere egy kép, ha normális esetben a sablonon belül egy tv-paramétert használ, kap egy teljes képet tartalmazó címkét, és ha a WayFinder sablont használja, csak a kép elérési útját kapja meg.
A külsőTpl a darab, amely tartalmazza a létrehozott WayFinder adatok külső tárolóját. Minden dokumentumot és mappát feldolgozni és beilleszteni a [[+ wf.wrapper]] helyőrzőbe. Ha a externalTpl nincs megadva, akkor feltételezzük, hogy egyenlő a "
- [[+ wf.wrapper]]
- [[+ wf.classes]] - a megadott osztály be van helyezve itt (beleértve a class = ""
- [[+ wf.classnames]] - itt csak a megadott osztály neve szerepel (class = "" nélkül)
- [[+ wf.wrapper]] - az a hely, ahol a menü összes tartalma megjelenik. Ez a helyőrző kötelező.
rowTpl - a menüelem sablonjának darabja
- [[+ wf.classes]] - a megadott osztály be van helyezve itt (beleértve a class = ""
- [[+ wf.classnames]] - itt csak a megadott osztály neve szerepel (class = "" nélkül)
- [[+ wf.link]] - a referencia href értéke
- [[+ wf.title]] - a címben szereplő attribútum szövege a paraméterben megadott mezőből titleOfLinks
- [[+ wf.linktext]] - a tényleges hivatkozás szövege a paraméterben megadott mezőből titleOfLinks
- [[+ wf.wrapper]] - az almenü beillesztésének helye
- [[+ wf.id]] - egy egyedi azonosító beillesztésének helye. Meg kell adnia a rowIdPrefix, hogy ez a helyőrző megkapja az értéket. a prefix + dokumentum id
- [[+ wf.attributes]] - a link tulajdonságainak beillesztésének helye
- [[+ wf.docid]] - az aktuális dokumentum azonosítójának beillesztési helye
- [[wf.description]] - adja ki az aktuális dokumentum leírási mezőjét
- [[szélesség]] - az aktuális elem mélysége
példák rowTpl vagy a vele társított darab:
Ezután az alábbi táblázat bemutatja azokat a paramétereket, amelyeket ugyanazok a helyőrzők használják rowTpl.
Az aktuális dokumentumhoz tartozó sablon nevét tartalmazó címke neve, ha ez egy tároló, és gyermektartalmú. Használja a helyőrzőt gyermekdokumentumok kiadására.
A sablon neve, amely tartalmazza a sablont minden dokumentumhoz, ha ez egy tároló, és rendelkezik gyermektartalommal. Használja a helyőrzőt gyermekdokumentumok kiadására.
Az aktuális dokumentumhoz tartozó sablon neve.
Az egyes almenük sablonját tartalmazó csomó neve. Ha a paraméter internalTpl nincs megadva, hanem helyette használják outerTpl.
Az almenü elemek sablonját tartalmazó csomó neve.
Az aktuális dokumentum sablonját tartalmazó csomó neve, ha almenüben van.
A konténerekhez tartozó dokumentumok sablonját tartalmazó csonk neve gyermektartalmú, és jelenleg aktív.
A CSS osztálynév paraméterei
A CSS segítségével a kimenet különböző részeinek nézete (és egyes esetekben a művelet) vezérelhető. Azonban meg kell adnia a Wayfinder-t, amelyik a CSS osztályneveket használja, és a kimeneti adatok mely részeit kell összekapcsolni.