Accueil | Exemples en ligne | Documentation | Forum | Page du projet | Téléchargement

Manuel TPLN

La fonction ShowRecords

RewriteUrl
SetNavColor
SetUrl
UrlAddVar
CreateFieldVars

 

La fonction ShowRecords

void ShowRecords(string query, int result_by_page=0)

La fonction ShowRecords() est une fonction qui permet de parser les données provenant de votre base données automatiquement, vous n'avez qu'à créer votre template et la fonction s'occupe de tout pour vous !

Votre template doit être configurer comme ceci :
  • <bloc::data>
  •     <bloc::loop></bloc::loop> contient le nom de vos champs en variable
  •     <bloc::norecord></bloc::norecord> contient le message s'il n'y a pas de résultats
  • </bloc::data>

Cette fonction possède ses variables propriétaires qui sont parsées automatiquement celles ci doivent être présentes dans le bloc <bloc::data></bloc::data> elles sont notées comme ceci {_Variable}.
  • _First indique le numéro du premier enregistrement de la page en cours
  • _Last indique le numéro du dernier enregistrement de la page en cours
  • _Count indique le nombre de résultats
  • _PageNumber indique la page actuelle
  • _PageCount indique le nombre de page total
Variables propriétaires entre les balises <bloc::loop></bloc::loop>
  • _Id indique le numéro d'enregistrement généré par TPLN
  • _NavColor remplace par l'une des deux couleurs spécifiées dans le fichier TPLN_Cfg.php ou par SetNavColor()

TPLN génère également pour vous les boutons de navigation (pagination incluse) , il faut les définir au sein de votre bloc <bloc::data> sous forme de bloc, ceci sont personalisables puis qu'il font parti du template :

  • Pager pour créer la pagination de résultats, ce bloc doit contenir deux sous blocs, <bloc::in> et <bloc::out>


  • <bloc::in> est généré pour personaliser la page en cours, ce bloc doit contenir la variable {_Page}
  • <bloc::out> est généré pour personaliser les pages differentes de la page en cours, ce bloc doit contenir la variable {_Url} et {_Page}
<bloc::pager>
  <bloc::in><font color="red">{_Page}</font></bloc::in>
  <bloc::out><a href="{_Url}">{_Page}</a></bloc::out>
</bloc::pager>
  • Début pour aller à la première page de résultats, ce bloc doit contenir la variable {_Url}
<bloc::start>
  <a href="{_Url}"><img src="bng.gif" border=0></a>
</bloc::start>
  • Précédent pour aller à la page des résultats précédente, ce bloc doit contenir la variable {_Url}
<bloc::previous>
  <a href="{_Url}"><img src="prev.gif" border=0></a>
</bloc::previous>
  • Suivant pour aller à la page des résultats suivante, ce bloc doit contenir la variable {_Url}
<bloc::next>
  <a href="{_Url}"><img src="suiv.gif" border=0></a>
</bloc::next>
  • Fin pour aller à la dernière page de résultats, ce bloc doit contenir la variable {_Url}
<bloc::end>
  <a href="{_Url}"><img src="suiv.gif" border=0></a>
</bloc::end>


<?php

include("TPLN/TPLN.php");

$TPLN = new TPLN;
$TPLN->Open("template.html");
$query = "SELECT * FROM my_table";

$TPLN->DbConnect();
$TPLN->ShowRecords($query,10); // 10 results by page
$TPLN->DbClose();

$TPLN->Write();

?>


Attention !
Depuis TPLN 1.5, cette fonction à changer dans son principe de pagination.
TopTop