![[BANNER]](/templates/iceage/images/banniere.jpg)
![[NEWS]](templates/iceage/images/icon-news.png){kind=icon}
Envoyé par unreal
Ce petit guide devrait vous permettre d'exploiter rapidement la classe BBCode.
1. Les préliminaires
Avant toute utilisation de la classe, il vous faut insérer le fichier et créer un nouvel objet (comme pour toute classe php) :
2. Le filtre HTML
La fonction html_filter() offre plusieurs fonctionnalités interessantes, telles que le filtrage html (htmlentities), la conversion des \n en sauts de ligne (nl2br) et la détection automatique des liens et smileys.
Par défaut, les 4 options sont activées, mais il est possible d'en désactiver certaines et d'en laisser d'autres en positionnant l'array $html_filter_prefs avant d'appeler la fonction html_filter() :
Quand la détection des smileys est active, il est possible de configurer le path vers le dossier contenant les smileys :
Passons maintenant au convertisseur BBCode.
3. Le convertisseur BBCode <-> HTML
Le convertisseur se compose de 2 fonctions : bbcode_to_html() et html_to_bbcode(), qui permettent de convertir dans un sens ou l'autre.
Le paragraphe suivant vous donnera un apperçu des possibilités de cette classe.
Note : dans les exemples, des espaces sont rajoutés pour que les balises ne soient pas interprétées.
4. Exemple d'utilisation
Si le reste n'était pas totalement clair, essayez cet exemple !
bbcode_test.php
5. Conclusion
N'hésitez pas à tester tout ça et de faire part de vos remarques !
- 1. Les préliminaires
- 2. Le filtre HTML
- 3. Le convertisseur BBCode <-> HTML
- 4. Exemple d'utilisation
- 5. Conclusion
1. Les préliminaires
Avant toute utilisation de la classe, il vous faut insérer le fichier et créer un nouvel objet (comme pour toute classe php) :
require_once ('inc/inc_cg_filter.php');
$filter = new cg_filter;
$filter = new cg_filter;
2. Le filtre HTML
La fonction html_filter() offre plusieurs fonctionnalités interessantes, telles que le filtrage html (htmlentities), la conversion des \n en sauts de ligne (nl2br) et la détection automatique des liens et smileys.
Par défaut, les 4 options sont activées, mais il est possible d'en désactiver certaines et d'en laisser d'autres en positionnant l'array $html_filter_prefs avant d'appeler la fonction html_filter() :
$filter->html_filter_prefs['entities'] = 0; // Désactive le filtrage HTML.
$filter->html_filter_prefs['smileys'] = 0; // Désactive la détection des smileys.
$filter->html_filter_prefs['smileys'] = 0; // Désactive la détection des smileys.
Quand la détection des smileys est active, il est possible de configurer le path vers le dossier contenant les smileys :
$filter->smiley_path = 'smileys/'; // Il ne faut pas oublier le / final !
Passons maintenant au convertisseur BBCode.
3. Le convertisseur BBCode <-> HTML
Le convertisseur se compose de 2 fonctions : bbcode_to_html() et html_to_bbcode(), qui permettent de convertir dans un sens ou l'autre.
Le paragraphe suivant vous donnera un apperçu des possibilités de cette classe.
Note : dans les exemples, des espaces sont rajoutés pour que les balises ne soient pas interprétées.
- [b ]texte[/b ], [i ]texte[/i ] et [u ]texte[/u ] : permet d'afficher du texte en gras, italique ou surligné.
- [align=center ]texte[/align ] et [align=right ]texte[/align ] : permet de postionner le texte.
- [img ]http://site.com/image.jpg[/img ] : permet d'insérer une image
- [url=http://site.com ][/url ] ou [url=http://site.com ]Site[/url ] : permet d'insérer un lien.
- [list ]
[* ] élément 1
[* ] élément 2
[/list ] : permet de réaliser une liste sans ordre.
- [quote ]texte[/quote ] : rajoute un style pour faire apparaître le texte (très utile pour citer).
- [anchor ]paragraphe1[/anchor ] : insère une ancre nommée
4. Exemple d'utilisation
Si le reste n'était pas totalement clair, essayez cet exemple !
bbcode_test.php
<?php
require_once ('inc/inc_cg_filter.php');
$filter = new cg_filter;
$filter->html_filter_prefs['url_parsing'] = 0; // On désactive la détection automatique des liens
// Enlevez les espaces dans les balises !
$filter->string = "[b ]En gras ![/b ]\n[i ]En italique ![/i ]\n[u ]En surligné ![/u ]\n[b ][i ][u ]En gras, italique et surligné ![/u ][/i ][/b ]\n\n";
$filter->html_filter(); // Filtrage HTML
$filter->bbcode_to_html(); // Conversion BBCode en HTML;
echo ($filter->string); // Affichage HTML
$filter->html_to_bbcode(); // Conversion HTML en BBCode
echo ($filter->string); // Affichage BBCode
?>
require_once ('inc/inc_cg_filter.php');
$filter = new cg_filter;
$filter->html_filter_prefs['url_parsing'] = 0; // On désactive la détection automatique des liens
// Enlevez les espaces dans les balises !
$filter->string = "[b ]En gras ![/b ]\n[i ]En italique ![/i ]\n[u ]En surligné ![/u ]\n[b ][i ][u ]En gras, italique et surligné ![/u ][/i ][/b ]\n\n";
$filter->html_filter(); // Filtrage HTML
$filter->bbcode_to_html(); // Conversion BBCode en HTML;
echo ($filter->string); // Affichage HTML
$filter->html_to_bbcode(); // Conversion HTML en BBCode
echo ($filter->string); // Affichage BBCode
?>
5. Conclusion
N'hésitez pas à tester tout ça et de faire part de vos remarques !
Posté le 30/03/05 à 01:13 - 7 Commentaires...