Sarcina principală a Wayfinder este de a crea un meniu de navigare care va fi actualizat automat când schimbați arborele de documente, dar poate fi folosit și în alte scopuri.
Deoarece puteți să apelați Wayfinder pe o singură pagină de mai multe ori și fiecare apel poate indica diferite nivele ale arborelui de documente, puteți crea o varietate de meniuri de navigare sau liste de documente pe o singură pagină. De exemplu, puteți face meniul de navigare în partea de sus a paginii, apoi din lateral faceți meniuri suplimentare pentru produse, servicii, comenzi etc. legate de diferite secțiuni ale arborelui documentului.
Rețineți că de la lansarea Revoluției există două tipuri de fragmente Wayfinder, pentru Evolution and Revolution. În general, ambele versiuni sunt identice din punct de vedere funcțional, ca și parametrii lor. În Revoluție, fragmentul este denumit ca. [[! Wayfinder? . ]]. dar în Evolution ca [! Wayfinder? . ].
Puteți discuta despre Wayfinder în forumurile MODx. Documentația suplimentară Wayfinder 2.0 poate fi găsită aici.
Wayfinder a fost complet reproiectat din versiunea originală DropMenu pentru a facilita crearea oricăror meniuri necesare folosind bucăți și șabloane de ieșire. Atunci când se utilizează șabloane pentru ieșirea flexibilă a meniului, mulți parametri, cum ar fi tabele, liste cu marcatori și fără marcaj, nu mai sunt necesare.
Instalare pentru Revoluție
În MODx Revolution, Wayfinder poate fi încărcat din meniul de gestionare a pachetelor din panoul de control. Accesați meniul "System -> management pachet", faceți clic pe "Descărcați add-on" și descărcați Wayfinder. După aceasta, trebuie să o instalați folosind procedura standard.
[[! Wayfinder? startId = `0` nivel = `1`]]
Ca rezultat, va fi afișată o listă neordonată pe mai multe niveluri, reprezentând întregul arbore al documentelor din site-ul MODX, fiecare element fiind un link către documentul corespunzător.
Setări generale
Valorile implicite
Punctul de pornire (document ID) pentru meniul din care vor fi preluate documentele de ieșire. Specificați 0 pentru a porni meniul din rădăcina site-ului.
id al documentului curent
0 | document id [[* părinte *]] [[* id *]]
În cazul în care displayStart = 1, acest lucru va determina Wayfinder să trimită un link către documentul utilizat ca startId, conform șablonului startItemTpl. Parametrul funcționează dacă startId nu este 0.
Opțiuni șablon
Acești parametri indică fragmente care conțin șabloane pentru gestionarea ieșirii Wayfinder.
În versiunea existentă a WayFinder for Revolution, puteți accesa parametrii tv fără prefixul wf. de exemplu, [[+ my_TV]].
În acest moment, o valoare neprelucrată pentru parametrul TV este returnată, nu va fi formatată. De exemplu, dacă parametrul TV este o imagine, dacă utilizați în mod normal un parametru TV în interiorul șablonului dvs., veți primi o etichetă cu o imagine completă și dacă utilizați șablonul WayFinder, veți obține doar calea imaginii.
externalTpl este numele partii care conține containerul exterior pentru datele generate de WayFinder. Toate documentele și dosarele vor fi procesate și inserate în substituentul [[+ wf.wrapper]]. În cazul în care externalTpl nu este specificat, se presupune că este egal cu "
- [[+ wf.wrapper]]
- [[+ wf.classes]] - clasa specificată este inserată aici (inclusiv clasa = "")
- [[+ wf.classnames]] - numai aici se introduce numele clasei specificate (fără clasa = "")
- [[+ wf.wrapper]] - locul unde se afișează întregul conținut al meniului. Acest substituent este o necesitate.
rowTpl - numele piesei pentru șablonul de element de meniu
- [[+ wf.classes]] - clasa specificată este inserată aici (inclusiv clasa = "")
- [[+ wf.classnames]] - numai aici se introduce numele clasei specificate (fără clasa = "")
- [[+ wf.link]] - valoarea href pentru referința dvs.
- [[+ wf.title]] - textul atributului titlu pentru linkul din câmpul specificat în parametru titleOfLinks
- [[+ wf.linktext]] - text pentru link-ul real din câmpul specificat în parametru titleOfLinks
- [[+ wf.wrapper]] - locul inserării submeniului
- [[+ wf.id]] - locul inserării unui id unic. Va trebui să specificați rowIdPrefix, astfel încât acest substituent să obțină valoarea care va fi. prefixul dvs. + document id
- [[+ wf.attributes]] - locul inserării atributelor linkului
- [[+ wf.docid]] - locul inserării identificatorului documentului curent
- [[wf.description]] - scoateți câmpul de descriere al documentului curent
- [[wf.level]] - adâncimea elementului curent
exemple rowTpl sau piesa asociată cu aceasta:
În continuare, în tabelul de mai jos sunt prezentate parametrii utilizați de aceleași substituenți ca și rowTpl.
Numele piesei care conține șablonul pentru documentul curent, dacă acesta este un container și are resurse copil. Utilizați substituentul pentru a emite documente copil.
Numele pachetului care conține șablonul pentru orice document, dacă acesta este un container și are resurse copil. Utilizați substituentul pentru a emite documente copil.
Numele piesei care conține șablonul pentru documentul curent.
Numele piesei care conține șablonul pentru fiecare submeniu. Dacă parametrul innerTpl nu este specificat, este folosit în schimb outerTpl.
Numele piesei care conține șablonul pentru elementele de submeniu.
Numele piesei care conține șablonul pentru documentul curent, dacă se află într-un submeniu.
Numele piesei care conține șablonul pentru documente care sunt containere are resurse copil și sunt în prezent active.
Parametrii denumirii clasei CSS
CSS poate fi folosit pentru a controla vederea (și, în unele cazuri, acțiunea) diferitelor părți ale ieșirii. Cu toate acestea, trebuie să specificați Wayfinder, ce nume de clase CSS sunt utilizate și cu ce părți ale datelor de ieșire ar trebui să fie legate.