Fonctions de base |
SetHost(), SetLogin(), SetPassword(), SetBase() |
Les fonctions SetHost(), SetLogin(),
SetPassword(), SetBase() servent à initialiser les
variables pour la connection.
Il est préférable de les configurer à partir du fichier
TPLN_Cfg.php dans le répertoire TPLN pour éviter
d'appeler ces fonctions à chaque fois.
- SetHost( string
host )
- SetLogin( string
login )
- SetPassword( string
password )
- SetBase( string
base )
Exemple : |
SetBase :
$TPLN->SetBase("my_base");
// change la base par défaut
|
|
|
DbConnect() |
La fonction DbConnect() sert se connecter
à votre base de données MySQL.
DbConnect( )
Exemple : |
DbConnect() :
$TPLN->DbConnect();
|
|
|
DbClose() |
La fonction DbClose() sert se déconnecter
à votre base de données MySQL.
DbClose( )
Exemple : |
DbClose() :
$TPLN->DbClose();
|
|
|
DoQuery() |
La fonction DoQuery() sert effectuer
une requete.
DoQuery(string
query
)
Exemple : |
DoQuery() :
$TPLN->DoQuery("SELECT
* FROM my_table");
|
|
|
GetData() |
La fonction GetData() sert retourner
les résultats de la requete.
Si le paramètre COUNT est passé alors le résultats
retourné valable pour les requete de type count().
GetData( [COUNT]
)
Exemple : |
GetData() pour un requete normale:
$TPLN->DoQuery("SELECT
* FROM my_table");
$res
= $TPLN->GetData();
GetData() pour un requete avec count:
$TPLN->DoQuery("SELECT
COUNT(*) FROM my_table");
$count
= $TPLN->GetData(COUNT);
|
|
|
GetRowsCount() |
La fonction GetRowsCount() sert retourner
le nombre de résultats de la requête.
GetRowsCount(
)
Exemple : |
GetRowsCount() :
$TPLN->DoQuery("SELECT
* FROM my_table");
$nb_results
= $TPLN->GetRowsCount();
|
Cette fonction est similaire à DBNumRows() |
|
DBNumRows() |
La fonction DBNumRows() sert à
retourner le nombre de résultats de la requête.
C'est une alias de la fonction GetRowsCount()
DBNumRows(
)
Exemple : |
DBNumRows() :
$TPLN->DoQuery("SELECT
* FROM my_table");
$nb_results
= $TPLN->DBNumRows();
|
|
|
DBFetchArray() |
La fonction DBFetchArray() sert à
retourner une ligne de résultat sous la forme d'un tableau associatif.
Equivaut à la fonction Php mysql_fetch_array()
DBFetchArray(
)
Exemple : |
DBFetchArray() :
$TPLN->DoQuery("SELECT
* FROM my_table");
while($row
= $TPLN->DBFetchArray())
{echo $row["user_id"];}
|
Voir aussi: DBFetchAssoc() et ParseDBrows()
|
|
DBFetchAssoc() |
La fonction DBFetchAssoc() sert à
retourner une ligne de résultat sous la forme d'un tableau associatif.
Equivaut à la fonction Php mysql_fetch_assoc()
DBFetchAssoc(
)
Exemple : |
DBFetchAssoc() :
$TPLN->DoQuery("SELECT
* FROM my_table");
while($row
= $TPLN->DBFetchAssoc())
{...}
|
Voir aussi: DBFetchArray() et ParseDBrows()
|
|
DBFreeResult() |
La fonction DBFreeResult() n'est à
appeler que si vous avez peur d'utiliser trop de mémoire durant
l'exécution de votre script. Toute la mémoire associée
à l'identifiant de résultat sera automatiquement libérée.
Equivaut à la fonction Php mysql_free_result()
DBFreeResult(
)
Voir aussi: DBFetchArray() et ParseDBrows()
|
|
ParseDBRow() |
La fonction ParseDBRow() sert à
parser toutes les variables d'un bloc par les valeurs retournées
par row de votre requête.
ParseDBRow(string
bloc)
Exemple : |
$TPLN->DoQuery("SELECT
* FROM my_table");
$TPLN->ParseDbRow("bloc1");
|
|
|
|
La fonction ShowRecords() |
ShowRecords() |
La fonction ShowRecords() est une
fonction qui permet de parser les données provenant de MySQL, 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>
Exemple : |
<html>
<body>
<bloc::data>
Données <br><br>
<bloc::loop> {champs_nom} <br> </bloc::loop>
<bloc::norecord>Pas de résultas</bloc::norecord>
</bloc::data>
</body>
</html> |
ShowRecords(
string query ,
int resultsbypage
)
Exemple : |
ShowRecords() :
$query
= "SELECT * FROM
my_table";
$TPLN->ShowRecords($query,10);
|
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 la position du
première enregistrement
- _Last indique la position du dernier
enregistrement
- _Count indique le nombre de résultats
- _PageNumber indique la page actuelle
- _PageCount indique le nombre de
page total
- _UrlBng url de la première
page (texte défini dans TPLN_Cfg.php ou par
SetNavLabels() )
- _UrlPrev url de la page précédente
( texte défini dans TPLN_Cfg.php ou par SetNavLabels()
)
- _UrlNext url de la page suivante
( texte défini dans TPLN_Cfg.php ou par SetNavLabels()
)
- _UrlEnd url de la dernière
page ( texte défini dans TPLN_Cfg.php ou par
SetNavLabels() )
- _UrlPageNav sert à la pagination
de vos résultats
- _ NavColor remplace par l'un des
deux couleurs spécifiés dans le fichier TPLN_Cfg.php
ou par SetNavColor()
|
|
SetNavLabels() |
La fonction SetNavLabels() permet
de remplacer le texte présent dans _UrlBng,
_UrlPrev, _UrlNext,
_UrlEnd.
SetNavLabels(string
bngtxt , string
prevtxt , string
nexttxt , string
endtxt )
Exemple : |
SetNavLabels() :
$TPLN->SetNavLabels("[<<]","[<]","[>]","[>>]");
|
|
|
SetNavColor() |
La fonction SetNavColor() permet d'alterner
les couleurs pour pour l'item {_NavColor}
SetNavColor(string
color1 , string
color2 )
Exemple : |
SetNavColor() :
$TPLN->SetNavColor("#CCCCCC","#FFFFFF");
|
|
|
AddUrlVar() |
La fonction AddUrlVar() permet d'ajouter
une variable dans l'url de_UrlBng,
_UrlPrev, _UrlNext,
_UrlEnd, _UrlPageNav.
AddUrlVar(string
var )
Exemple : |
SetNavLabels() :
$TPLN->AddUrlVar("var=my_var");
|
|
AddHtmlUrl() |
La fonction AddHtmlUrl() permet d'ajouter
des attributs Html entre les balises
<a [ajout]></a> de_UrlBng,
_UrlPrev, _UrlNext,
_UrlEnd, _UrlPageNav.
AddHtmlUrl(string
string )
Exemple : |
SetNavLabels() :
$TPLN->AddHtmlUrl("class=title");//
va ajouter un style title au lien
|
|
|
SetUrl() |
La fonction SetUrl() permet de changer
le lien de_UrlBng, _UrlPrev,
_UrlNext, _UrlEnd,
_UrlPageNav.
SetUrl(string
url )
Si cette fonction n'est pas utilisée TPLN choisi le fichier appelé
par defaut. |
|
|