Mulți știu că MODX are deja un set de substituenți de sistem - # 91; # ++ site_url # 93; # 93 ;. # 91; # ++ assets_url # 93; # 93 ;. # 91; + modx.user.id # 93; # 93; și așa mai departe. Dar, de cele mai multe ori, este nevoie de informații suplimentare pe site. În acest caz, trebuie să ne definim propriile ploschodere și, pentru aceasta, există mai multe metode în MODX.
Permiteți-mi să vă reamintesc că substituenții reprezintă unul dintre elementele de bază ale MODX. Ele sunt folosite, de regulă, pentru a afișa informațiile stocate în ele în bucăți și șabloane și au următoarea sintaxă # 91; # 91; + Placeholder # 93; # 93;.
Toți substituenții sunt în matricea $ modx-> placeholders. În ea se adaugă substituenții noștri și se citesc atunci când se analizează pagina.
Să ne uităm la toate metodele de lucru cu ei.
1. setPlaceholder ()
Această metodă salvează substituentul cu tasta specificată și atribuie valoarea transferată acestuia. El nu returnează nimic.
După aceea, substituentul devine disponibil pentru dvs. # 91; # 91; + numele # 93; # 93 ;. Poate fi inserat în șablon, în conținutul paginii sau în bucată.
2. setPlaceholders ()
În această metodă, pot fi definiți simultan mai multe opțiuni de substituție, care pot fi transferate într-o matrice asociativă simplă sau într-un obiect. Rețineți că această metodă are un al doilea parametru $ namespace. care este folosit ca prefix. Această metodă nu întoarce nimic.
Available placeholders - # 91; # + my.name # 93; # 93; și # 91; + my.email # 93; # 93; .
3. toPlaceholder ()
Această metodă este similară cu setPlaceholder (). dar are parametri suplimentari pentru prefix și delimitator, care se adaugă între prefix și cheie. Și el are și al cincilea parametru $ restore. care, dacă îl specificați adevărat. Returnează vechea valoare a clipboard-ului la tasta "restore" din matrice. Metoda setPlaceholder () returnează o matrice cu substituenți în tasta "chei".
În parametrul $ value, puteți trece un tablou. Cheile acestei matrice vor fi adăugate la cheie prin intermediul delimitatorului.
4. toPlaceholders ()
Această metodă extinde metoda la Platitorii (). În subiectul $, puteți trece o matrice pe mai multe niveluri. Acesta va fi procesat recursiv. Cheia fiecărui nivel al matricei va fi adăugată la cheia substituentului prin separator
Avem # 91; # my.foo # 93; # 93; și # 91; # 91; + my.document.pagetitle # 93; # 93; .
5. getPlaceholder ()
Această metodă vă permite să obțineți un substituent deja stabilit.
6. unsetPlaceholder ()
Șterge substituentul instalat.
7. unsetPlaceholders ()
Ștergeți mai mulți substituenți.
Sper că acum utilizarea acestor metode nu va provoca dificultăți.
Articole similare
Trimiteți-le prietenilor: