Ne felejtsük el, hogy zsetont

Ne felejtsük el, hogy zsetont

Sokszor a legfontosabb része a weboldal teszi a felhasználók számára. Ők - egyedi személyiségek, hogy az alapját képezik virágzó közösségeket. Mivel rendkívül fontos, hogy a felhasználók támogatása, és a webhely tartalmát kiszámítható és személyre szabott.

Az egyik legnagyobb nehézség, hogy ebben a csatában, - így a felhasználók személyre szabott információk behelyezése nélkül kettős kód az egész halom. Fontos az is, hogy képes legyen könnyen kimenet külön adatsort megjeleníthető további felhasználók számára.

Szerencsére, Drupal egy kényelmes módszert behelyezése a változók a tartalom a Token modul. Ezzel szemben az egyszerű csere húrok, Token modul segítségével a fejlesztők közös munkamódszer húrok, amelyek felhasználhatók a különböző részein a rendszer. Ez könnyen integrálható más modulokat és csökkenti a teljes tartalom mennyisége a fejlesztő kell festeni, hogy hozzon létre egy egyéni weboldal.

Lefordítani ezt!

Mielőtt fejest a Token modul, fontos, hogy megértsük a szerepe az ökoszisztéma Drupal. A Drupal több módszer string csere, ami jól jöhet, a helyzettől függően. A leggyakoribb közülük - a beépített Drupal fordítási rendszer.

transzlációs rendszer nagyon egyszerű, és használata szinte teljesen át az t () függvény. Például, ha azt akarjuk, hogy a felhasználó fordította az üdvözlő üzenetet, akkor tegye a következőket:

Amint létrehozni a helyes fordítás fájlokat a felhasználó nyelvén, a sor kerül át. Azonban van egy probléma. Eltekintve a nyelvet, nincs személyre szabott. Szerencsére, az átviteli függvény maga képes elvégezni a csere a sorokat!

Itt látjuk először token (@user). Ez a vonal utóbb ki kell cserélni egy felhasználói nevet. Symbol egy korait token szűrési módszer egy sor kerül beillesztésre (ez segít, hogy írjon biztonsági kódot).

  • !változó - a sor kerül beillesztésre ahogy van;
  • @variable - vonal áthalad check_plain (), a HTML szöveggé alakítja;
  • % Változó - vonal áthalad check_plain () és theme_placeholder (), a HTML szöveggé alakítja, az összes zárt.
Figyelmes fejlesztő észre egy másik korlátozás ebben az eljárásban az, hogy nem tud belépni a vonal egyszerre egyes és többes számban. De Drupal olyan eljárás, amely megkönnyíti a format string többes keresztül format_plural () függvényt. A funkció format_plural () @count - speciális változó, mindig használjuk a helyettesítés szám által továbbított az első érv.

Érdemes megjegyezni, hogy ezek a funkciók csak akkor kell használni a fordítási interfész. Fordítható húrok statikusnak kell lennie (azaz nem a felhasználó által megadott). Különben is, ezek a tulajdonságok teszik lehetővé, hogy írjon lefordítható más nyelveken modulok párhuzamosan egyéni szálakat.

API Token modul

Modul API Token - egy nagyszerű eszköz a dinamikus helyettesítések a szövegben. Ez lehetővé teszi a fejlesztők számára, hogy cserélje ki a sorban (az úgynevezett token) változó adatok a szövegben. Sokan már jól ismerik az egyik típusú jelzőt látható a felhasználói modul szerepel a standard eloszlása ​​Drupal. Felhasználói modul széles körben használja a zsetont a generációs személyre e-maileket a felhasználóknak. Például:

Sajnos, mivel a token modul nem szerepel a Drupal core (legfeljebb Drupal 7), felhasználói modul nem tudja kihasználni az összes előnyeit. Nos, úgy néz ki, mint egy kis szöveggel, ha a token?
Ugyanazt a példát a modul felhasználói:

Akkor miért (amellett a kód hatékonyságát az ötlet), hogy külön API valami látszólag jelentéktelen? A végén, a PHP, akkor már van egy beépített függvény karakterlánc csere, és mindig meg kell illeszteni a string változó. A válasz az, hogy a csere a vonalak Drupal - sokkal fejlettebb, mint egy egyszerű változó helyettesítés. Ezzel a módszerrel, akkor kap néhány fontos előnye van:

  • Szabványügyi - token modul szabványos módon, hogy hozzon létre tokeneket, könnyen érthető végfelhasználó.
  • A hordozhatóság - token modul API lehetővé teszi a fejlesztők, hogy meghatározza saját tokenek, amely alkalmas lehet más modulok, valamint kihasználják mások modulok zsetont.
  • Segítség - API token modul egy listát az összes zsetont, hogy rendelkezésre állnak a helyszínen. Ez csökkenti annak szükségességét, hogy párhuzamos kódot és a teremtés azonos zsetonok különböző helyeken.
Segítségével jelzőt kód

Elég a beszédből, az idő, hogy utasítsa el a kezét. Mint sok más API, jó okunk van, hogy használja az API tokenek: rendkívül könnyű. Tegyük fel, hogy ki akarja cserélni a szöveget csomópont értékeket egy tárgyat:
vagy abban az esetben, mi üzenetet a felhasználó

És ennyi az egész! Modul token jó a tény, hogy minden zsetont is, amelyek a globális (például a webhely URL-jét), elérhető lesz, függetlenül attól, hogy milyen tárgyat helyettesíti zsetont.

Saját token

Mi van, ha a modulnak saját adatok és szeretne tenni értük zsetont?
Ez is nagyon egyszerű. Tegyük fel, hogy van egy modul, amely használja a token pótalkatrészek e-mail üzeneteket. Csak használja hook_token_values.

Most néhány új egységeket a felhasználók számára. Adj nekik tippeket is nagyon egyszerű - segítségével hook_token_list.

Ez minden, emberek

Ez minden. Mint látható, akkor token cseréje nagyon egyszerű és gyors. Ha azt szeretnénk, hogy mélyebbre hatolnak, van néhány további dolog, hogy vizsgálja meg (például a módosításra a tokenek létre más modulok) és az API dokumentációt csatolták az eredeti hang (nincs semmi, a token modul README.txt jobb leírást - a sáv ..).

token modul része a magja Drupal 7. Ez azt jelenti, hogy támogatja a zsetonok ki a dobozból. Yohoho! Mint látható, mindannyian izgatott a közelgő megjelenése :)

Egy sor „20 API 20 napig,” nem lesz több jegyzeteket. Ne menj el!

Kapcsolódó cikkek