Variables et tags xanthia
Auteur Sujet

Post 
  1. General: 
  2. <!--[pnml name="_TEXTDEFINE"]--> = Defined language / Diplays text 
  3. <!--[$imagepath]--> = path to image folder (defined in theme.php) 
  4. <!--[$themepath]--> = path to theme (defined in theme.php) 
  5. <!--[sitename]--> 
  6. <!--[slogan]--> 
  7. <!--[opentable]--> = Starts a table, 100% width <table><tr><td> 
  8. <!--[closetable]--> = Closes the table</td></tr></table> 
  9. <!--[opentable2]--> = Starts a table, width sized to contents <table><tr><td> 
  10. <!--[closetable2]--> = Closes the table</td></tr></table> 
  11. <!--[$color1]--> = theme colors.. 1-10 as defined in the xaninit.php 
  12.  
  13. Master & module templates: 
  14. <!--[strip]-->- content -<!--[/strip]--> = strip white-space between tags. 
  15. <!--[$leftblocks]--> = left blocks 
  16. <!--[$centerblocks]--> = center blocks 
  17. <!--[$maincontent]--> = module content 
  18. <!--[$rightblocks]--> = right blocks 
  19. <!--[footmsg]--> = footer message as defined in admin settings 
  20. <!--[pagerendertime]--> = page render time (must set debug in config.php) 
  21. <!--[nocache]--><!--[pagerendertime]--><!--[/nocache]--> = don't cache captioned content 
  22. <!--[typetoolv80]--> = typetool 
  23. <!--[datetime]--> = date and time 
  24. <!--[displaygreeting]--> = hello $username 
  25. <!--[modulestylesheet]--> = get module style sheet if exists 
  26. <!--[pnbannerdisplay id=""]--> = display banner 
  27. ---- 
  28. <!--[pnml name="_SEARCH" assign="search_label"]--> = assign _SEARCH as the $search_label 
  29. <!--[search active="faqs, stories" label=$search_label class="pn-normal"]--> 
  30. ---- 
  31. <!--[search]--> = general search of all core modules 
  32. ---- 
  33. <!--[userlogin]--> = Displays a horizontal user login consisting of Username, Password, Remember me checkbox and submit button 
  34. <!--[userlinks]--> = Displays links for logged-in user (My Account | Logout) and anonymous user (Register | Login) 
  35.  
  36.  
  37.  
  38. Blocks: 
  39. <!--[$title]--> = block title 
  40. <!--[$content]--> = block content 
  41.  
  42.  
  43. News-article / News-index: 
  44. <!--[$preformat.searchtopic]--> = topic image 
  45. <!--[$preformat.catandtitle]--> = cat and title 
  46. <!--[$preformat.fulltext]--> = full text used for News-article template 
  47. <!--[$preformat.bodytext]--> = full text minus home text 
  48. <!--[$preformat.readmore]--> = displays "read more.." if applicable 
  49. <!--[$preformat.notes|default:" "]--> Show notes (not needed if full text used) 
  50. <!--[$preformat.reads]--> = displays read count 
  51. <!--[$preformat.send]--> = adds send to a friend option 
  52. <!--[$preformat.print]--> = adds print option 
  53. <!--[$preformat.comment]--> = shows comment amount 
  54. <!--[$info.topicname]--> = topic title 
  55. <!--[$info.title]--> = article title 
  56. <!--[$info.counter]--> = shows amount of reads 
  57. <!--[$info.hometext]--> = shows short text.. used for News-index template 
  58. <!--[$info.fulltext|count_words]--> = a "words more" count (ie: 37 more words) 
  59. <!--[$info.informant]--> = author 
  60. <!--[$info.longdatetime]--> = long version of date and time 
  61. <!--[$info.briefdatetime]--> 
  62. <!--[$info.longdate]--> 
  63. <!--[$info.briefdate]--> 
  64. <!--[$info.sid]--> = story ID 
  65. <!--[$links.searchtopic]--> = link to topic (ie: <a href="<!--[$links.searchtopic]-->">) 
  66. <!--[articleadminlinks sid=$info.sid]--> = shows edit and delete to admin 
  67.  
  68. --------- shows a "read more" image ----------- 
  69. <!--[if $info.bodytext|count_words gt 0]--> 
  70. <a href="modules.php?op=modload&name=News&file=article&sid=<!--[$info.sid]-->&mode=thread&order=0&thold=0"> 
  71. <img border="0" src="<!--[$imagepath]-->/readmore.gif" alt="Read the rest of the story..." /> 
  72. </a> 
  73. <!--[else]--> 
  74.   
  75. <!--[/if]--> 
  76. ------------------------------------------------ 
  77.  
  78.  
  79. Table1 & Table2: 
  80. <!--[$tablecontent]--> = shows table content  


Voici un lien vers la documentation de xanthia pour les développeurs: phpdoc xanthia

Co-webmestre de PostNuke-France.

Avant toutes questions, veuillez lire les régles à suivre.
Données personnelles Accueil

Post 
Quelques explications

Des tags contenant un $ sont généralement des variables contenant une valeur.. les tags ne contenant pas de $ sont généralement des plugins. Ces plugins appellent des fonctions qui retournent une valeur.

  1. // Variables 
  2. <!--[$imagepath]--> = path to image folder (defined in theme.php) 
  3. <!--[$themepath]--> = path to image folder (defined in theme.php) 
  4.  
  5. // Plugins 
  6. <!--[sitename]--> 
  7. <!--[slogan]--> 


Le plugin sitename appelle une fonction qui va chercher le nom du site dans la base de données tel qu'il a été spécifié dans les préférences du site. Le plugin slogan fera la même chose pour le slogan.

Ces deux plugins retourneront la valeur trouvée.

Exemple concret, dans le titre de la fenêtre de votre navigateur vous devriez voir : PostNuke-France.org :: Site francophone officiel PostNuke
Ce titre a été placé dans la balise title du template de thème :

Code: [Cacher]
  1. <title><!--[title]--></title> 


Le plugin title est un plugin qui fusionne le nom du site et le slogan.

Les plugins peuvent avoir des paramêtres. Par exemple, le plugin pnml. Le plugin pnml traduit une constante de langue en langage clair et dans la langue de l'utilisateur.

Pour le plugin pnml:
  • name: Constante
  • html: la constante contient du html et doit donc être traitée comme du html
  • assign: Assigne le résultat retourné à une variable


Considérons le code suivant :

Code: [Cacher]
  1. <!--[pnml name='_YOURUSERNAME']--> 


Le résultat retourné sera : Pseudo

Code: [Cacher]
  1. <!--[pnml name='_YOURUSERNAME' assign='mavariable']--> 


Le mot pseudo ne sera pas affiché... il a été assigné à une variable qu'on peut utiliser plus tard en utilisant :

Code: [Cacher]
  1. <!--[$mavariable]--> 


$mavariable affichera "Pseudo".

Il y a beaucoup de plugins disponibles, certains sont accessibles partout (modules/pnRender/pnplugins), d'autres ne le sont que via le thèmes (modules/Xanthia/pnplugins).

A noter que les plugins du module pnRender sont aussi accessibles dans les templates d'un thème.

Tous les modules (pnAPI-pnRender) peuvent avoir leurs propres plugins pour leurs templates. (modules/LEMODULES/pntemplates/plugins). Ces plugins ne sont accessibles que par le module en question.

Les thèmes Xanthia peuvent aussi avoir leurs propres plugins (themes/LETHEME/plugins)...

Pratiquement tous les plugins disponibles (fournis par PN dans les pnRender et Xanthia) ont des explications sur ce qu'ils font :

Plugin pnml :
  1. /** 
  2.  * Smarty function to read a PostNuke language constant. 
  3.  * 
  4.  * This function takes a identifier and returns the corresponding language constant. 
  5.  * 
  6.  * Available parameters: 
  7.  *   - name:     Name of the language constant to return 
  8.  *   - html:     Treat the language define as HTML 
  9.  *   - assign:   If set, the results are assigned to the corresponding variable instead of printed out 
  10.  *   - *         All remaining parameters are used as string replacements 
  11.  * 
  12.  * Example 
  13.  * _EXAMPLESTRING = 'Hello World' 
  14.  * <!--[pnml name="_EXAMPLESTRING"]--> returns Hello World 
  15.  * 
  16.  * _EXAMPLESTRING = 'There are %u% users online'; 
  17.  *  $usersonline = 10 
  18.  * <!--[pnml name=_EXAMPLESTRING u=$usersonline]--> returns There are 10 users online 
  19.  * 
  20.  * ;@author       Mark West 
  21.  * ;@since        08/08/2003 
  22.  * ;@param        array       $params      All attributes passed to this function from the template 
  23.  * ;@param        object      &$smarty     Reference to the Smarty object 
  24.  * ;@return       string      the language constant 
  25.  */ 


...





Chestnut !
Administrateur
Aucun Support par message privé...
Même en cas de pensée suicidaire !
Règles à suivre
Données personnelles Accueil

Post 
Salut c'est vraiment tres informatif,

je voulais savoir si il existe meme en anglais un totor qui explique tout depuis le commencement, de la genese a l'apocalypse sous Xanthia. J'ai envie de faire le saut mais ma derniere rencontre avec cet engin m'a traumatisé et la bette me fait peur, il faut que je sois préparé donc si il existe des ressources pour des débutants, je suis tres intéréssé et peut être meme compiler le tout et en faire une traduction pour les francos...

En tout plus il ya de lien mieux c'est...

merci d'avance

Mo-Ex

Thuram, Vierra, Makelele = Trium Virra de l'EDF
Données personnelles

Post 
doc... et doc...

http://www.postnuke-france.org/modu...ideXanthia.html

la traduction est finie, il me semble. Si tu découvre des erreurs, des améliorations que l'on pourrais apporter, fais nous signe !

a+


Gilles  ><>°
Données personnelles Accueil

Post 
Ok

je vais regarder ca et effectivement si il ya quelque chose de pas claire, je vais faire de susggestions, a qui je m'addresse pour les faire? Quel Foprum6 Quelle E-mail Addresse?

Si d'aventure je tombe sur une doc Pn plus ou moins interessante en anglais que je suis capable de traduire a qui dois je l'adresser une fois finie?

Est ce que le Wikki ici marche exactement comme wikkipedia?

modifié par : motionex, 05 Déc 2005 - 18:42

Thuram, Vierra, Makelele = Trium Virra de l'EDF
Données personnelles

Post 
motionex a écrit :
si il ya quelque chose de pas claire, je vais faire de susggestions, a qui je m'addresse pour les faire? Quel Foprum6 Quelle E-mail Addresse?

tu peux les faire soit à Anupthra ou à moi-même. tu peux nous envoyer un mail, ou créer un thread dans le forum, nous ferons les modifications dès que possible.

idem si tu trouve de la doc. La doc dont je t'ai donné le lien est la traduction de la doc officielle de Xanthia fournie par postnuke.com

Ce wiki ne marche pas exactement comme wikipedia bien que je ne connaisse pas trop wikipedia. Il est différent dans le sens ou tout un chacun ne peux pas le modifier à sa guise. Le groupe pnDocs à les droits de modification du wiki http://www.postnuke-france.org/module-pnGroups.html si tu désire faire partie de ce groupe, demande à t'inscrire, ca sera avec joie que nous t'accueillerons icon_smile icon_smile

a bientôt !


modifié par : Gilles, 05 Déc 2005 - 18:52


Gilles  ><>°
Données personnelles Accueil
Post 
Tres bien Merci,

je vais en faire la demande



Thuram, Vierra, Makelele = Trium Virra de l'EDF
Données personnelles