La mise en page principale de votre page se trouve dans le fichier de template main.tpl. C'est ce fichier que DataLife Engine utilise comme mise en page principale du site, et tous les autres composants du moteur y sont raccordés. Examinons les principaux. {AJAX}, {info}, {content}, {custom} Ces balises sont responsables de l'affichage correct des publications.
La balise {AJAX} affiche les scripts JavaScript système nécessaires au fonctionnement normal du moteur en général et de la technologie AJAX en particulier. Il est recommandé de placer cette balise tout au début du template après la balise <body>.
La balise {info} affiche les informations système et les erreurs relatives aux actions effectuées (par exemple « Échec de la connexion, mot de passe incorrect » ou « Tous les champs doivent être remplis »). Il est recommandé de placer cette balise avant la balise {content}.
La balise {content} est la balise principale et permet l'affichage direct des publications ainsi que des autres modules intégrés du moteur, tels que l'inscription, les pages statiques et plus encore.
La balise {tags} sert à afficher le nuage de tags (mots-clés spéciaux attribués à la publication).
Les balises [sort] {sort} [/sort] permettent d'afficher le choix de l'ordre de tri des publications par l'utilisateur, si cela est autorisé dans les paramètres du script.
Balises globales de template qui peuvent être utilisées dans tous les templates :
Balise {custom ...}, permet d'afficher des articles dans un format personnalisé et prend en charge les paramètres suivants :
{custom name="X" id="1,2,5-8" category="2,3,5-8" author="x" days="x" template="custom" available="global" navigation="no" from="0" limit="10" fixed="yes" unique="yes" order="date" sort="desc" cache="yes"}Les paramètres signifient :
name est le nom du bloc, qui peut ensuite être utilisé pour déterminer s'il faut afficher ou masquer un contenu quelconque en dehors de ce bloc si ce bloc contient du contenu ou non. Par exemple, l'écriture {custom name="block1" category="6"} affichera les publications de la catégorie dont l'ID est 6, et le bloc lui-même recevra le nom « block1 ». Pour utiliser ce nom, on emploie les balises [custom=X] Texte [/custom], où X est le nom du bloc, qui affichent le texte qu'elles contiennent si le bloc portant ce nom contient des informations. On peut aussi utiliser les balises opposées [not-custom=X] Texte [/not-custom], qui affichent le texte qu'elles contiennent si le bloc portant ce nom ne contient aucune information.
[custom=block1] Title {custom name="block1" category="6"} [/custom]Le bloc lui-même peut se trouver n'importe où sur la page et pas forcément à l'intérieur de ces balises. Ainsi, vous pouvez adapter et modifier la mise en forme du modèle sur la base de ces balises. Vous pouvez également indiquer plusieurs blocs simultanément dans le paramètre et définir selon quelle condition leur présence doit être vérifiée. Vous pouvez vérifier soit la présence obligatoire de tous les blocs, soit seulement d'un des blocs indiqués. Si les blocs sont énumérés par des virgules, comme dans [custom=block1,block2,block3] Texte [/custom], la présence des trois blocs sera vérifiée et le texte ne sera affiché que si les trois blocs existent. Si les blocs sont énumérés avec le symbole |, comme dans [custom=block1|block2|block3] Texte [/custom], il suffit qu'un seul des blocs listés existe pour que le texte soit affiché.
id est la liste des ID des publications que vous souhaitez afficher, séparés par des virgules sans espaces. Vous pouvez également indiquer des plages d'ID à l'aide d'un tiret. Par exemple, 1,4-8,11 affichera la publication avec l'ID 1, les publications ayant des ID de 4 à 8, ainsi que celle ayant l'ID 11.
idexclude est complètement opposé au paramètre id="liste des ID des publications" et permet d'afficher les publications qui n'appartiennent pas aux ID indiqués dans ce paramètre. Par exemple, {custom idexclude="5-10"} affichera toutes les publications dont l'ID ne fait pas partie de la plage allant de cinq à dix.
category est la liste des ID des catégories à partir desquelles les publications doivent être sélectionnées, séparés par des virgules sans espaces. Vous pouvez également indiquer une plage de catégories à l'aide d'un tiret. Par exemple, 1,4-8,11 affichera les publications de la catégorie 1, des catégories ayant des ID de 4 à 8, ainsi que de la catégorie 11.
categoryexclude est complètement opposé au paramètre category="liste des catégories" et permet d'afficher les publications qui n'appartiennent pas aux catégories indiquées dans ce paramètre. Par exemple, {custom categoryexclude="2,7"} affichera toutes les publications qui n'appartiennent pas aux catégories d'ID 2 et 7.
subcat indique s'il faut inclure ou non dans la sélection les publications situées dans les sous-catégories. Ce paramètre peut prendre les valeurs suivantes : subcat="yes", qui indique qu'il faut également sélectionner toutes les publications situées dans les sous-catégories de la catégorie indiquée, et subcat="only", qui indique qu'il faut sélectionner uniquement les publications des sous-catégories, sans tenir compte de la catégorie indiquée. Par exemple, si votre site contient des catégories ayant les ID 1, 2 et 3, où les catégories 2 et 3 sont des sous-catégories de la première, alors l'utilisation de {custom category="1" subcat="yes"} sélectionnera toutes les publications des catégories 1, 2 et 3, tandis que {custom category="1" subcat="only"} ne sélectionnera que les publications des catégories 2 et 3.
tags est la liste des mots-clés du nuage de balises attribués aux publications. Par exemple, la balise {custom tags="actualités,modèles"} affichera toutes les publications qui contiennent les mots-clés « actualités » et « modèles » du nuage de balises.
template est le fichier de modèle qui sera utilisé pour afficher les publications ; dans ce cas, il s'agit de custom.tpl. Si vous utilisez plusieurs modèles sur le site, ce fichier doit être présent dans chacun d'eux. Ce modèle utilise des balises analogues à celles de la version courte.
available Définit la section du site dans laquelle les publications demandées seront affichées et peut prendre les valeurs suivantes:
main - lors de la consultation de la page d'accueil
date - lors de la consultation des publications pour des dates spécifiques
cat - lors de la consultation des catégories
showfull - lors de la consultation d'une publication
search - lors de la consultation des résultats de recherche
userinfo - lorsque lors de l'affichage a utilisateur profil
register - lors de l'inscription
stats - lors de la consultation des statistiques
pm - lors de la consultation messages privés
feedback - lors de la consultation de la page contact
favorites - lors de la consultation des favoris
newposts - lors de la consultation des nouvelles publications
addnews - lors de l'ajout d'une publication
lastnews - lors de la consultation des dernières actualités du site
lastcommentaires - lors de la consultation des derniers commentaires
lostpassword - lorsque vous consultez la page récupération d'un mot de passe
static - lors de la consultation des pages statiques
catalog - lors de la consultation d'un catalogue de pages
alltags - lorsque vous consultez le nuage de mots-clés
tags - lorsque vous consultez les publication à partir du nuage de mots-clés
allnews - lorsque l'on affiche toutes les publications du site ou toutes les publication d'un utilisateur spécifique
Vous pouvez combiner des sections à l'aide du caractère |. Par exemple, available="userinfo|register|main" affichera vos publications sur la page principale, lors de l'inscription et lors de la consultation du profil utilisateur. Si l'affichage doit se faire dans toutes les sections du site, ce paramètre n'est pas indiqué.
from est le numéro de la publication à partir duquel l'affichage commencera.
limit nombre de publication à afficher
order le critère de tri des actualités, qui peut prendre les valeurs suivantes:
editdate - trier par date de modification
rating - trier les actualités par notation
reads - trier les actualités par vues
comments - trier les actualités par nombre de commentaires
title - trier les actualités par titres d'articles
rand - ordre de tri aléatoire pour les actualités
id_as_list - trie les publications telles qu'elles apparaissent dans la liste des identifiants. Par exemple, la balise {custom id = "3,4,1,2" ; order = "id_as_list"} affichera d'abord les articles ayant l'ID 3, puis 4, puis 1, et 2.
lastviewed - afficher les derniers messages consultés de l'utilisateur
sort définit l'ordre de tri des publications. Lorsque l'on utilise la valeur desc, les publications sont triées par ordre décroissant, et lorsque l'on utilise asc, elles sont triées par ordre croissant.
sort indique l'ordre de tri des publications. Avec la valeur desc, les publications sont triées par ordre décroissant, et avec asc, par ordre croissant.
author est le login de l'auteur de la publication ; si ce paramètre est indiqué, seules les publications de l'auteur indiqué seront affichées. Il est possible de lister plusieurs auteurs séparés par des virgules. Par exemple, la balise {custom author="admin" limit="5"} affichera 5 publications de l'auteur dont le login est « admin ».
authorexclude indique les logins des auteurs qu'il faut exclure de l'affichage. Les logins des auteurs peuvent également être énumérés dans ce paramètre, séparés par des virgules. Par exemple, avec {custom authorexclude="admin,test"}, seront affichées les publications de tous les auteurs sauf ceux ayant le login « admin » et « test ».
catalog affiche toutes les publications contenant le code symbolique indiqué dans le paramètre. Il est également possible d'énumérer plusieurs codes symboliques dans ce paramètre, séparés par des virgules. Par exemple, avec {custom catalog="a,b"}, seront affichées les publications contenant les codes symboliques « a » ou « b ».
catalogexclude affiche toutes les publications qui ne contiennent pas le code symbolique indiqué dans le paramètre. Il est également possible d'énumérer plusieurs codes symboliques dans ce paramètre, séparés par des virgules. Par exemple, avec {custom catalogexclude="a,b"}, seront affichées les publications qui ne contiennent pas les codes symboliques « a » et « b ».
xfields affiche toutes les publications contenant la valeur indiquée dans le paramètre pour les champs supplémentaires. Il est également possible de lister plusieurs valeurs dans ce paramètre, séparées par des virgules. Par exemple, avec {custom xfields="valeur 1,valeur 2"}, seront affichées les publications dont les champs supplémentaires contiennent « valeur 1 » ou « valeur 2 ».
xfieldsexclude affiche toutes les publications ne contenant pas la valeur indiquée dans le paramètre pour les champs supplémentaires. Il est également possible de lister plusieurs valeurs dans ce paramètre, séparées par des virgules. Par exemple, avec {custom xfieldsexclude="valeur 1,valeur 2"}, seront affichées les publications dont les champs supplémentaires ne contiennent ni « valeur 1 » ni « valeur 2 ».
days indique la période de temps ; la valeur contient le nombre de jours pour lesquels les publications doivent être affichées. Par exemple, la balise {custom days="2" limit="5"} affichera 5 publications des 2 derniers jours.
banners accepte les valeurs yes ou no. Ce paramètre active ou désactive l'affichage des supports publicitaires affectés à l'affichage entre les publications. Par défaut, si ce paramètre est absent de la balise, l'affichage des supports publicitaires entre les publications sera désactivé.
futureannounce accepte les valeurs yes ou no. Ce paramètre fonctionne conjointement avec le paramètre days="X" et indique que les publications doivent être prises dans des dates futures. Par exemple, la balise {custom futureannounce="yes" days="1"} signifie qu'il faut afficher les publications dont la date est fixée à demain, c'est-à-dire dans +1 jour, tandis que {custom futureannounce="yes" days="2"} affiche les publications prévues pour demain et après-demain.
cache accepte les valeurs yes ou no et définit s'il faut mettre l'affichage en cache ou non. Il est recommandé d'activer le cache pour réduire la charge. Vous pouvez également indiquer une durée en minutes, heures ou jours. Pour cela, on utilise les suffixes m, h et d. Par exemple, {custom cache="30m" ...} forcera la mise en cache du bloc pendant 30 minutes, {custom cache="2h" ...} pendant 2 heures, et {custom cache="1d" ...} pendant un jour.
navigation accepte les valeurs yes ou no et indique s'il faut utiliser ou non la navigation par pages. La navigation n'est affichée que pour les pages du site qui prennent en charge la navigation pour la balise {content}, par exemple la page principale, les pages de catégories, etc. Si la page ne prend pas en charge la navigation, par exemple lors de l'affichage d'une publication complète ou d'une page statique, alors pour cette balise la navigation sera automatiquement désactivée, quelle que soit la valeur indiquée.
fixed accepte les valeurs yes, no, only ou without et indique s'il faut tenir compte du fait que les publications ont été fixées ou non. Si la valeur yes est indiquée, les publications fixées seront affichées en premier ; avec no, elles seront affichées dans la liste générale sans tenir compte de ce paramètre ; avec only, seules les publications fixées seront affichées avec without, les publications fixées ne seront pas affichées du tout.
sortbyuser="yes" n'accepte qu'une seule valeur et permet d'utiliser le tri personnalisé [sort]{sort}[/sort] pour ce bloc de publications.
favorites="yes"
Cette balise n'accepte qu'une seule valeur et affichera les publications présentes dans les favoris du visiteur. Par exemple, la balise {custom favorites="yes" order="id_as_list"} elle affichera les publications des favoris de l'utilisateur dans le même ordre de tri que celui dans lequel elles ont été ajoutées.
Veuillez noter que tous les paramètres de la balise {custom ...} sont facultatifs. Il suffit d'indiquer au moins un paramètre. Tous les autres paramètres, s'ils ne sont pas définis, seront repris à partir des paramètres généraux du script.
Par exemple:
{custom id="1,2" order="date"} - affichera les publications portant les identifiants 1 et 2 et les triera par date
{custom category="2,7" from="5" cache="yes"} - affichera les publications des catégories 2 et 7; le nombre de publications sera tiré des paramètres du script, et la sélection débutera après la 5ème publication répondant à la condition
{custom order="date" from="9" limit="5"} - affichera les 5 dernières publications à partir de la 10e
N'oubliez pas que chaque utilisation de cette balise crée une charge supplémentaire sur la base de données car elle effectue une requête supplémentaire ; utilisez-la donc judicieusement si vous devez économiser des ressources.
Balise globale [available=section] text [/available], affiche le texte contenu dans les balises si la section indiquée du site est en cours d'affichage :
La balise accepte tous les paramètres similaires à ceux indiqués pour le paramètre disponible de la balise {custom}. Vous pouvez également combiner des sections à l'aide du caractère "|", par exempleuserinfo|register|main
La balise accepte tous les paramètres analogiques à ceux indiqués pour le paramètre available de la balise {custom}. Vous pouvez combiner des sections à l'aide du caractère "|", par exemple userinfo|register|main.
[available=userinfo|register|main]Un bloc qui s'affichera sur la page d'accueil, lors de l'inscription et lors de la consultation du profil de l'utilisateur
[/available]cette balise affichera le texte contenu dans les balises sur la page principale, lors de l'inscription et lors de la consultation du profil utilisateur.
Vous pouvez également utiliser la balise [not-available=userinfo|register|main]text [/not-available] ce qui est tout le contraire de la balise [available=...] et affiche le texte partout sauf dans les sections indiquées.
La balise [category=X]text[/category], affiche le texte contenu dans les balises si la catégorie indiquée est en cours d'affichage :
La balise accepte comme paramètre ID l'identifiant de la catégorie et permet de lister plusieurs catégories séparées par des virgules, ainsi que de spécifier une plage à l'aide d'un tiret:
[category=1,2,3,7-10]
text
[/category]affichera le texte contenu dans les balises si le visiteur consulte des catégories dont l'ID est 1, 2 ou 3, ainsi que les catégories de 7 à 10.
Vous pouvez également utiliser la balise [not-category=1,2,3,7-10] texte [/not-category] ce qui est tout le contraire de la balise [category=...] et afficher le texte partout sauf dans les catégories indiquées.
Vous pouvez également utiliser la balise [not-category=1,2,3,7-10] texte [/not-category], qui est totalement opposée à la balise [category=...], et afficher le texte partout sauf dans les catégories indiquées.
The balise accepts as a parameter ID the groupe ID, and allows listing several groupes
[group=1,2,3]
text
[/group]affichera le texte contenu dans les balises si le visiteur est administrateur, rédacteur en chef ou journaliste.
Vous pouvez également utiliser la balise [not-group=1,2,3] texte [/not-group], qui est exactement l'inverse de la balise [group=...] et affiche le texte pour tous les utilisateurs à l'exception des groupes mentionnés.
Vous pouvez également utiliser la balise [not-group=1,2,3] texte [/not-group], qui est totalement opposée à la balise [group=...] et affiche le texte pour tous sauf les groupes indiqués.
display the text qu'elles contiennent if the visitor is located in the indiqué X countries, où X is a list of ISO country codes. Countries can be listed separated by commas. Par exemple, the balises [country=RU, BY, KZ] text [/country] will display the text if the visitor is from Russia, Belarus, or Kazakhstan.
[not-country=X] text [/not-country]
display the text qu'elles contiennent if the visitor is located outside the indiqué X countries, où X is a list of ISO country codes. Par exemple, [not-country=RU, BY, KZ] text [/not-country] will display the text if the visitor is not from Russia, Belarus, or Kazakhstan, but from any other country.
{country}
affichera le code ISO du pays dans lequel se trouve le visiteur du site. Par exemple, la balise affichera RU si le visiteur se trouve en Russie, ou US s'il se trouve aux États-Unis.
[page-count=1,2,3] text [/page-count]
Affichera le texte contenu dans les balises si l'utilisateur se trouve sur un numéro de page précis dans la navigation des actualités, quel que soit le secteur du site, où 1,2,3 sont des numéros de pages dans la navigation. Cette balise permet de configurer avec une grande souplesse l'affichage de telle ou telle information sur une page précise et elle est utile pour les blocs d'information et la publicité. Vous pouvez utiliser cette balise avec d'autres balises qui définissent les sections du site et les catégories.
Par exemple, combinaison de balises :
[aviable=cat]
[category=1]
[page-count=1]
text
[/page-count]
[/category]
[/aviable]afficheront le texte uniquement si l'utilisateur consulte la première page de la catégorie avec l'ID 1 et qu'il consulte précisément les actualités courtes en passant à une autre page de cette catégorie, il ne verra plus ce texte.
[not-page-count=1,2,3] text [/not-page-count]
Affiche le texte publié dans les balises sur tous les numéros de page, sauf ceux indiqués dans la balise.
{banner_name} cette balise est destinée à afficher des informations publicitaires sur le site. Le nom de la bannière est défini dans un module spécial du panneau d'administration.
[banner_name]texte [/banner_name] s'affiche si la bannière spécifiée est affichée sur la page du site web.
{inform_name} cette balise est destinée à afficher des informeurs RSS et des actualités provenant d'autres sites. Le nom et tous les paramètres de cette balise sont définis dans le panneau d'administration du script.
[static=page_name] texte[/static]
affichera le texte contenu dans les balises si le visiteur consulte une page statique portant le nom indiqué. Il est également possible d'énumérer plusieurs pages dans la balise, séparées par des virgules. Par exemple, [static=test1,test2,test3]text [/static] affichera le texte sur les pages test1, test2 et test3.
[not-static=page_name] text [/not-static]
affichera le texte contenu dans les balises si le visiteur ne consulte pas une page statique portant le nom indiqué. Il est également possible d'énumérer plusieurs pages dans la balise, séparées par des virgules.
[smartphone] text [/smartphone]
affichera le texte contenu dans les balises si le visiteur consulte votre site depuis un téléphone mobile.
[not-smartphone] text [/not-smartphone]
affichera le texte contenu dans les balises si le visiteur ne consulte pas votre site depuis un téléphone mobile.
[tablet] text [/tablet]
affichera le texte contenu dans les balises si le visiteur consulte votre site depuis une tablette.
[not-tablet] text [/not-tablet]
affichera le texte contenu dans les balises si le visiteur ne consulte pas votre site depuis une tablette.
[desktop] text [/desktop]
affichera le texte contenu dans les balises si le visiteur consulte votre site depuis un ordinateur de bureau ou un ordinateur portable.
[not-desktop] text [/not-desktop]
affichera le texte contenu dans les balises si le visiteur ne consulte pas votre site depuis un ordinateur de bureau ou un ordinateur portable.
[ios] text [/ios]
affichera le texte contenu si l'appareil du visiteur du site utilise le système Apple iOS opennote
[not-ios] text [/not-ios]
affichera le texte contenu si l'appareil du visiteur du site n'utilise pas le système iOS opennote
[android] text [/android]
affichera le texte contenu si l'appareil du visiteur du site utilise le système d'exploitation Google Android openote system
[not-android] text [/not-android]
affichera le texte contenu si l'appareil du visiteur du site n'utilise pas le système Android OpenNote
Vous pouvez également inclure un modèle dans un autre à l'aide de la balise {include file="my_block.tpl"}. Cette balise permet d'inclure le fichier my_block.tpl indiqué dans le modèle. Elle vise à simplifier la structure du modèle lorsqu'une mise en page complexe comportant de nombreuses balises est utilisée.
{customcomments name="X" id="1,2,5-8" category="2,3,5-8" author="x" days="x" template="custom" available="global" from="0" limit="10" order="date" sort="desc" cache="yes"}Affiche les commentaires publiés sur le site dans un format personnalisé. Cette balise est un affichage auxiliaire supplémentaire des commentaires et peut être utilisée, par exemple, pour afficher les derniers commentaires dans un bloc sur la page d'accueil du site.
Cette balise peut accepter les paramètres suivants:
name - nom du bloc qui pourra ensuite être utilisé pour déterminer s'il faut afficher ou masquer un contenu en dehors de ce bloc selon qu'il contient ou non des informations. Par exemple, l'écriture de {customcomments name="block1" category="6"} affichera les commentaires de la catégorie ID 6, et le bloc lui-même recevra le nom « block1 ». Pour travailler avec ce nom, on utilise les balises [customcomments=X] Texte [/customcomments] où X est le nom du bloc elles affichent le texte qu'elles contiennent si le bloc portant ce nom contient des informations. Les balises inverses [not-customcomments=X] Texte [/not-customcomments] ont également été ajoutées, elles affichent le texte qu'elles contiennent si le bloc portant ce nom ne contient aucune information et qu'il n'y a pas de commentaires. Ainsi, vous pouvez créer un habillage externe supplémentaire pour les blocs ou, au contraire, le masquer selon qu'il y a ou non des publications dans le bloc. Par exemple, [customcomments=block1] Titre {customcomments name="block1" category="6"} [/customcomments]. Le bloc lui-même peut se trouver n'importe où sur la page et pas nécessairement à l'intérieur de ces balises. Vous pouvez ainsi adapter et modifier l'apparence d'autres éléments du modèle à l'aide de ces balises. Vous pouvez également indiquer plusieurs blocs à la fois dans le paramètre et définir selon quelle condition leur présence doit être vérifiée. Vous pouvez vérifier soit la présence obligatoire de tous les blocs, soit seulement celle de l'un quelconque parmi ceux listés. Si les blocs sont séparés par des virgules dans [customcomments=block1,block2,block3] Texte [/customcomments], la présence des trois blocs custom sera vérifiée et la balise n'affichera le texte que si les trois blocs existent. Si les blocs sont séparés par le symbole | dans [customcomments=block1|block2|block3] Texte [/customcomments], il suffit qu'un seul des trois blocs listés existe pour afficher le texte contenu dans les balises.
id - la liste des identifiants de commentaires que vous souhaitez afficher, séparés par des virgules sans espaces. Vous pouvez également indiquer des plages d'identifiants de commentaires à l'aide d'un tiret. Par exemple, 1,4-8,11 affichera le commentaire portant l'identifiant 1, les commentaires dont les identifiants vont de 4 à 8, et le commentaire portant l'identifiant 11.
newsid - la liste des identifiants d'articles pour lesquels vous souhaitez afficher les commentaires, séparés par des virgules sans espaces. Vous pouvez également indiquer des plages d'identifiants d'articles en utilisant un tiret. Par exemple, 1,4-8,11 affichera les commentaires des articles portant l'identifiant 1, ceux dont les identifiants vont de 4 à 8, et ceux portant l'identifiant 11.
newsidexclude - la liste des identifiants de publication pour lesquels vous ne souhaitez pas afficher les commentaires, séparés par des virgules sans espaces. Vous pouvez également indiquer des plages d'identifiants à l'aide d'un tiret. Par exemple, 1,4-8,11 affichera les commentaires de toutes les publications, à l'exception de l'identifiant 1, des identifiants compris entre 4 et 8, et de l'identifiant 11.
category - la liste des identifiants des catégories d'actualités parmi lesquelles sélectionner les commentaires, séparés par des virgules sans espaces. Vous pouvez également indiquer des plages de catégories à l'aide d'un tiret. Par exemple, 1,4-8,11 affichera les commentaires de la catégorie 1, des catégories dont les identifiants vont de 4 à 8, et de la catégorie 11.
categoryexclude - est totalement l'opposé du paramètre category="liste des catégories" et permet d'afficher les commentaires dont les actualités n'appartiennent pas aux catégories indiquées dans le paramètre. Par exemple, {customcomments categoryexclude="2,7"} affichera tous les commentaires des actualités qui n'appartiennent pas aux catégories d'ID 2 et 7.
author - indique le login de l'auteur du commentaire. Si ce paramètre est défini, seuls les commentaires de l'auteur indiqué seront affichés. Il est possible d'indiquer plusieurs auteurs, séparés par des virgules. Par exemple, la balise {customcomments author="admin" limit="5"} affichera 5 commentaires de l'auteur dont le login est « admin ».
authorexclude - indique les logins des auteurs qui doivent être exclus de l'affichage. Les logins des auteurs peuvent également être listés dans ce paramètre, séparés par des virgules. Par exemple, lors de l'utilisation de {customcomments authorexclude="admin,test"}, les commentaires de tous les auteurs seront affichés, sauf ceux des auteurs ayant les logins « admin » et « test ».
days - définit la période, où x correspond au nombre de jours pour lesquels les commentaires doivent être affichés. Par exemple, la balise {customcommentaires days="2" limit="5"} affichera 5 commentaires datant des 2 derniers jours.
template - le fichier de modèle utilisé pour afficher les commentaires. Dans ce cas, il s'agit de custom.tpl. Si vous utilisez plusieurs modèles sur le site, ce fichier doit être présent dans chacun d'entre eux. Ce modèle utilise des balises similaires à celles utilisées dans le modèle d'affichage des commentaires (comments.tpl).
available section dans laquelle les commentaires demandés seront affichés. Peut prendre toutes les valeurs analogues à celles indiquées pour le même paramètre de la balise {custom ...}. Vous pouvez combiner des sections à l'aide du symbole « | ». Par exemple, available="userinfo|register|main" affichera vos actualités sur la page principale, lors de l'inscription et lors de la consultation du profil utilisateur.
available est la section dans laquelle les commentaires demandés seront affichés. Il peut accepter toutes les valeurs analogues indiquées pour le même paramètre de la balise {custom ...}. Vous pouvez combiner des sections à l'aide du caractère |, par exemple available="userinfo|register|main", ce qui affichera vos publications sur la page principale, lors de l'inscription et lors de la consultation du profil utilisateur.
limit - indique le nombre de commentaires qui seront affichés.
order - définit le critère de tri des commentaires et peut prendre les valeurs suivantes:
date - Trier les commentaires par date : par exemple, la balise {customcomments order="date" limit="5"} affichera les cinq derniers commentaires.
rating - Trier les commentaires par note. Par exemple, la balise {customcomments order="rating" limit="5"} affichera les cinq commentaires les mieux notés.
rand - Trier les commentaires dans un ordre aléatoire. Par exemple, la balise {customcomments order="rand" limit="5"} affichera cinq commentaires dans un ordre aléatoire.
id_as_list - trie les publications dans l'ordre où elles sont indiquées dans la liste des ID. Par exemple, la balise {custom id="3,4,1,2" order="id_as_list"} affichera d'abord l'actualité avec l'ID 3, puis 4, puis 1, puis 2.
sort - définit l'ordre de tri des commentaires. Lorsque l'on utilise la valeur desc, les publications sont triées par ordre décroissant, et lorsque l'on utilise asc, par ordre croissant.
cache - indiquer la durée en minutes, en heures ou en jours. Les suffixes « m », « h » et « d » sont utilisés pour spécifier la durée de mise en cache. Par exemple, si vous spécifiez {customcomments cache="30m" ....}, le bloc de commentaires sera mis en cache de manière forcée pendant 30 minutes ; si vous spécifiez {customcomments cache="2h" ....}, le bloc de commentaires sera mis en cache pendant 2 heures ; si vous spécifiez {customcomments cache="1d" ....}, le bloc de commentaires sera mis en cache pendant un jour.
Tous les paramètres de cette balise sont facultatifs. Il suffit d'indiquer un seul paramètre. Vous pouvez également combiner différents paramètres de cette balise comme vous le souhaitez.
{* Code commenté *}
Cette balise sert à commenter le code. Tout ce qui se trouve entre « {* » et « *} » sera supprimé du modèle et n'apparaîtra pas dans le rendu du site. Ces balises sont utiles aux développeurs de modèles pour déboguer des fonctionnalités et commenter temporairement certaines parties. Cette balise est globale et peut être utilisée dans tous les modèles.
{lang text="LANG_PARAMETER"}
Cette balise sert à afficher des informations issues du fichier de langue site.tpl actuellement utilisé, où LANG_PARAMETER correspond à la valeur du paramètre à afficher. Par exemple, la balise {lang text="attach_images"} affichera le libellé « Attach Images » du pack de langue lorsque le russe est utilisé, et « "Attach Images" » si l'anglais est utilisé.
La balise utilisée pour afficher le menu des catégories est {catmenu}. Vous pouvez utiliser cette balise dans n'importe quel fichier de modèle ; elle est globale. À son tour, cette balise utilise et inclut le fichier de modèle categorymenu.tpl.
{catmenu id="1,2,3-5" idexclude="1,2,3-5" subcat="yes" template="custom" cache="yes"}Affiche le menu des catégories dans un format personnalisé, où:
id="1,2,3-5" - la liste des identifiants de catégorie à afficher dans le menu. Vous pouvez indiquer plusieurs catégories séparées par des virgules ou spécifier une plage d'identifiants à l'aide d'un tiret.
idexclude="1,2,3-5" - Liste des identifiants de catégories à exclure. Toutes les catégories, sauf celles indiquées, seront affichées. Vous pouvez indiquer plusieurs catégories séparées par des virgules ou spécifier une plage d'identifiants avec un tiret.
subcat="yes" - Ce paramètre accepte les valeurs « yes », « no » ou « only » et s'utilise conjointement avec le paramètre id de cette balise. Il permet de spécifier si les sous-catégories des catégories répertoriées doivent être incluses automatiquement. Par exemple, s'il existe une catégorie avec l'ID 1 et qu'elle comporte des sous-catégories avec les ID 2 et 3, l'utilisation de la balise {catmenu id="1" subcat="yes"} affichera la catégorie 1 et ses sous-catégories 2 et 3, tandis que l'utilisation de la balise {catmenu id="1" subcat="no"} n'affichera que la catégorie ID 1. La valeur « only » signifie que seules les sous-catégories de la catégorie indiquée doivent être affichées. Par exemple, lorsque vous utilisez la balise {catmenu id="1" subcat="only"}, seules les sous-catégories appartenant à la catégorie ID « 1 » seront affichées. De même, par exemple, en utilisant la construction simple [available=cat] {catmenu id="{category-id}" subcat="only"} [/available], vous pouvez afficher automatiquement la liste des sous-catégories de la catégorie actuellement consultée sur le site.
template="custom" - indique le nom du modèle qui sera utilisé pour générer le menu à la place du modèle standard categorymenu.tpl
cache="yes" - Ce paramètre accepte les valeurs « yes » ou « no » et permet de déterminer si ce bloc doit être mis en cache. Lorsque la mise en cache est activée, il est possible de contrôler la mise en évidence de la catégorie active affichée à l'aide des balises [active] texte [/active] dans le modèle.
{catnewscount id="X"}
Affiche le nombre de publications pour la catégorie indiquée, où X est l'ID de la catégorie souhaitée. Cette balise est utile pour afficher le nombre de publications dans des menus déjà créés manuellement dans les modèles du site.
Affiche le nombre de publications pour la catégorie indiquée, où X est l'ID de la catégorie souhaitée. Cette balise est utile pour afficher le nombre de publications dans des menus déjà créés manuellement dans les modèles du site.
Affiche l'ID de la catégorie actuellement consultée par le visiteur du site. Cette balise est utile lors de la création de menus de site et lorsque vous avez besoin de réattribuer rapidement des classes CSS ou des noms de fichiers de modèle tout en stylisant les modèles de sortie des publications.
{category-title}
Affiche le nom de la catégorie actuellement consultée par le visiteur du site. Cette balise est utile lorsque vous souhaitez afficher séparément le nom de la catégorie consultée.
{category-description}
Affiche la description de la catégorie attribuée lorsque l'utilisateur consulte cette catégorie. Cette information est également disponible lors de l'affichage des publications complètes.
[category-description] text [/category-description]
Affiche le texte qu'elles contiennent si la catégorie actuellement affichée comporte une description
[not-category-description] text [/not-category-description]
Affiche le texte qu'elles contiennent si la catégorie n'a pas de description.
{category-icon}
Affiche l'icône de la catégorie actuellement consultée par l'utilisateur, ou celle de la publication si l'article complet est affiché
{category-url}
Affiche l'URL de la catégorie consultée
{page-title}
Affiche le titre de la page que vous avez indiqué dans la section « Titres, descriptions, métabalises ».
{page-description}
Affiche la description de la page que vous avez indiquée dans la section « Titres, descriptions, métabalises ».
{page-count}
Affiche le numéro de la page sur laquelle se trouve actuellement l'utilisateur
[script] code [/script] balises globales qui vous permettent d'insérer du code JavaScript exécutable. Ce code sera placé directement dans le bloc d'exécution des autres scripts JS de DataLife Engine et s'exécutera immédiatement après le chargement des autres scripts JS utilisés lors de l'inclusion. Cela vous permet d'organiser l'ensemble du code JS dans le modèle, d'uniformiser son ordre d'exécution et d'éviter tout conflit à l'avenir. Exemple d'utilisation:
[script]
$.get("{THEME}/images/sprite.svg", function(data) {
var div = document.createElement("div");
div.innerHTML = new XMLSerializer().serializeToString(data.documentElement);
document.body.insertBefore(div, document.body.childNodes[0]);
});
[/script][script] code [/script] sont des balises globales qui permettent de placer du code JavaScript exécutable. Ce code sera inséré directement dans le bloc exécutable des autres scripts JS de DataLife Engine et sera exécuté immédiatement après le chargement des autres scripts JS utilisés. Ainsi, vous pouvez organiser tout le code JS du modèle, standardiser l'ordre d'exécution et éviter à l'avenir d'éventuels conflits.
Affiche l'identifiant du cache actuellement actif
[active-plugins=X] Text [/active-plugins]
Affiche le texte qu'elle contient si le plugin indiqué est activé et utilisé sur le site. X correspond à l'ID du plugin ou à son nom. Par exemple, vous pouvez indiquer [active-plugins=1] Texte [/active-plugins] ou [active-plugins=My Plugin] Texte [/active-plugins] et, si le plugin ayant l'ID 1 ou le nom « My Plugin » est activé dans le système, le texte indiqué dans la balise sera affiché. Vous pouvez également énumérer plusieurs paramètres dans la balise, séparés par des virgules, par exemple [active-plugins=1,2,5] Texte [/active-plugins].
Affiche le texte qu'elles contiennent si le plugin indiqué est activé et utilisé sur le site. X est l'ID du plugin ou son nom. Par exemple, vous pouvez indiquer [active-plugins=1] Texte [/active-plugins] ou [active-plugins=Mon plugin] Texte [/active-plugins], et si le plugin avec l'ID 1 ou le nom « Mon plugin » est activé dans le système, le texte indiqué dans la balise sera affiché. Vous pouvez également énumérer plusieurs paramètres dans la balise, séparés par des virgules, par exemple [active-plugins=1,2,5] Texte [/active-plugins].
Affiche le texte qu'elle contient si le plugin indiqué est désactivé et n'est pas utilisé sur le site. X correspond à l'ID du plugin ou à son nom. Par exemple, vous pouvez indiquer [not-active-plugins=1] Texte [/not-active-plugins] ou [not-active-plugins=My Plugin] Texte [/not-active-plugins] et, si le plugin ayant l'ID 1 ou le nom « My Plugin » est désactivé dans le système et n'est pas utilisé, le texte indiqué dans la balise sera affiché. Vous pouvez également énumérer plusieurs paramètres dans la balise, séparés par des virgules, par exemple [not-active-plugins=1,2,5] Texte [/not-active-plugins].
Affichage des données du profil utilisateur dans le modèle main.tpl:
{profile-link} - Affiche un lien vers le profil de l'utilisateur
{profile-login} - Affiche le login de l'utilisateur
{ip} - Affiche le utilisateur IP
{foto} - Affiche un lien to the utilisateur avatar
{fullname} - Affiche le utilisateur nom complet
[fullname] text [/fullname] - Affiche le texte contenu dans les balises si le nom complet est indiqué dans le profil de l'utilisateur
{land} - Affiche le pays de l'utlisateur
[land] text [/land] - Affiche le texte contenu dans les balises si le pays est indiqué dans le profil de l'utilisateur
{mail} - Affiche l'adresse email de l'utilisateur
{group} - Affiche le groupe de l'utilisateur
{registration} - Affiche la date d'inscription de l'utilisateur
{lastdate} - Affiche la date de la dernière visite de l'utilisateur
{group-icon} - Affiche l'icône du groupe de l'utilisateur
{time_limit} - Affiche la date jusqu'à laquelle l'utilisateur reste dans le groupe si celui-ci est temporaire
[time_limit] text [/time_limit] - Affiche le texte entre les balises si l'utilisateur appartient à un groupe temporaire
{comm-num} - Affiche le nombre de commentaires de l'utilisateur
{comments} - Affiche l'URL du lien vers les commentaires de l'utilisateur
[comm-num] text [/comm-num] - Affiche le texte entre les balises si l'utilisateur a laissé des commentaires sur le site
[not-comm-num] text [/not-comm-num] - Affiche le texte entre les balises si l'utilisateur n'a laissé aucun commentaire sur le site
{news} - Affiche l'URL du lien vers les publications de l'utilisateur
{rss} - Affiche l'URL du flux RSS des publications de l'utilisateur
{news-num} - Affiche le nombre de publications de l'utilisateur
[news-num] text [/news-num] - Affiche le texte entre les balises si l'utilisateur a publié des articles sur le site.
[not-news-num] text [/not-news-num] - Affiche le texte entre les balises si l'utilisateur n'a aucune publication sur le site.
{new-pm} - Affiche le nombre de messages personnels non lus de l'utilisateur.
{all-pm} - Affiche le nombre total de messages privés de l'utilisateur
{favorite-count} - Affiche le nombre total de publications dans les favoris de l'utilisateur
[profile_xfvalue_X] - Affiche la valeur du champ supplémentaire nommé "X" dans le profil de l'utilisateur
[profile_xfgiven_X] text [/profile_xfgiven_X] - Affiche le texte contenu dans les balises si le champ supplémentaire nommé "X" est indiqué dans son profil
[profile_xfnotgiven_X] text [/profile_xfnotgiven_X] - Affiche le texte contenu dans les balises si le champ supplémentaire nommé "X" n'est pas indiqué dans son profil
{admin-link} - Affiche un lien vers le panneau d'administration si l'utilisateur y a accès
[admin-link] text [/admin-link] - Affiche le texte entre les balises si l'utilisateur a accès au panneau d'administration