Allan
12/01/2006, 21h22
http://www.phylosophia.com/images/tuto/astucevB---modifications-et.gif
Ce qui va suivre n'a rien d'officiel, c'est ce que j'appelle de la "bidouille" :p
Alors commencons par savoir comment est géré la partie "boutons" de l'AdminCP, pour cela, on se dirige vers ce fichier: "includes/xml/cpnav_vbulletin.xml", c'est lui gère en grosse partie cette partie.
Vous l'avez peut être remarquer, quand vous ajouter un hack, on vous demande souvent d'ajouter un fichier du genre "cpnav_nom-de-votre-hack.xml", ce fichier ajoute simplement un bouton dans votre AdminCP afin d'accèder a certain option par exemple du hack concerné.
Il arrivera souvent qu'on vous demande d''ajouter aussi dans le dossier "includes/xml", des fichier du genre "bitfield_nom-de-ton-hack.xml", ce type de fichier ajoute des options SANS bouton dans les options de vBulletin ou bien des paramètre dans certaines partie de votre AdminCP come par exemple, des permissions du hack dans les groupes utilisateurs.
En bref, pour faire simple:
"cpnav_ton-hack.xml" => ajoute un bouton
"bitfield_ton-hack.xml" => ajoute des paramètres (sans bouton)Pour ma part, j'ai décider de travailler autrement, à savoir ne pas utiliser les fichiers "bitfield_ton-hack.xml", ni "cpnav_ton-hack.xml".
Pourquoi me dirait vous ?, tout simplement car je préfère récupérer les informations de ces fichiers pour les intégrer dans le fichier qui gère l'ensemble de ces informations: "cpnav_vbulletin.xml" (lui c'est votre copain ;))
Le fichier "cpnav_vbulletin.xml" est composé en gros de la facon suivante:
<?xml version="1.0" encoding="ISO-8859-1"?>
<navgroups product="vbulletin" master="true">
<navgroup phrase="vbulletin_options" permissions="canadminsettings" displayorder="10">
<navoption displayorder="10">
<phrase>vbulletin_options</phrase>
<link>options.php?null=0</link>
</navoption>
<navoption displayorder="20">
<phrase>search_type</phrase>
<link>options.php?do=searchtype</link>
</navoption>
<navoption debug="1" link="help.php?do=manage&script=NOSCRIPT" displayorder="30">
<phrase>admin_help_manager</phrase>
</navoption>
<navoption debug="1" displayorder="40">
<phrase>rebuild_bitfields</phrase>
<link>index.php?do=buildbitfields</link>
</navoption>
</navgroup>
</navgroups>
<!-- CVS: $RCSfile: cpnav_vbulletin.xml,v $ - $Revision: 1.16 $ -->
PS: A noter que le script interpretera
&
et le met sous la forum
&
donc, si vous avez une url a mettre dans votre fichier "cpnav_vbulletin.xml" du genre:
options.php?do=options&dogroup=vbrules
il vous faudrait l'écrire de la facon:
options.php?do=options&dogroup=vbrules
http://www.image-dream.com/up/1130787170-screen1.gif
___________________________________
---== Explication des éléments ==----
___________________________________
Alors dans le fichier "cpnav_vbulletin.xml", nous avons les éléments suivants:
<navgroups>
Cela signifie que le fichier contient des sous groupes, <navgroup>, sans le S
<navgroup>
C'est le nom du groupe (le nom du bouton en gros)
Il intègre 3 paramètres: Phrase/texte, permission, hr (hr = espace entre les boutons.)
Pour les phrases, vous devez rentrer le nom de la variable et pour du texte, simplement le texte (l'avantage de la variable permet de personnalisé les boutons via le système d'expression, a voir plus bas)
<navoption>
Contenu du menu, souvent les options du hack (sous le menu du bouton principal)
<phrase> ou <text>
Nom de la variable (utiliser par le système d'expression de vBulletin (modifiable via l'ACP de vB) ou du texte (en dur, cad non paramétrable depuis l'ACP, directement lu par vB depuis ce fichier (cpnav_vbulletin.xml)
<link>
Le lien de la phrase ou texte citer au dessus (relire le PS au sujet de l'interpretation du code au dessus)
___________________________________
---== Mise en pratique ==----
___________________________________
Alors dans ces menus, il vous arrivera de trouver également quelques petits truc comme cela:
displayorder="20" (situer dans <navgroup>)
Il s'agit de l'ordre d'affichage du bouton crée dans l'AdminCP en partant du haut, cela commence par 10 et marche par 5 ou même 10, j'ai pas encore essayer d'autre chiffres.Donc, par exemple, si vous souhaiter que votre bouton "Système de module ne soit plus en bas, il suffit d'aller dans votre fichier "cpnav_vbulletin", de trouver:
<navgroup phrase="plugin_system" permissions="canadminplugins" hr="true" displayorder="230">
et remplacer le chiffre d'ordre d'affichage (displayorder) par un plus petit, dans cet exemple "15", et votre bouton se retrouvera juste en dessous du bouton "Options vBulletin" qui lui contoent le chiffre "10"
hr="true"
Ceci crée un espace entre les boutons, en dessous de celui-ci !
permissions="......."
Pour cette partie, je ne suis pas assez renseigner pour en parler, donc je vais éviter ce sujet pour l'instant (pour la création des bouton, je n'ajoute pas personnellement ce paramètre)Bon, vous avez déja lu le plus gros, si vous avez compris tous ca, vous comprendrez le reste :D
Normalement, si vous avez bien suivis tous ces explications, vous êtes capable de crée des boutons avec leur liens leur ordres d'affichage dans l'admincp ;)
Si vous installer un hack qui crée des options supplémentaires dans les options de vBulletin et que vous souhaiter avoir un bouton direct pour ces options, il suffit de reprendre le contenu du fichier "bitfield_ton-hack.xml comme par exemple:
<navgroup test="blabla" displayorder="xx">
<navoption>
<text>titre de l'option</text>
<link>lien de l'option</link>
</navoption>
</navgroup>
Alors, vous me dirait, j'ai installer un hack mais je ne connais pas le lien pour aller dans les options de ce hack pour pouvoir ensuite le mettre dans ce menu juste au dessus.
C'es très simple :D, vous ouvrer votre ACP, vous dérouler "Options vBulletin" et vous faire un clique droit sur "Options vBulletin" et vous choississez "Ouvrir dans une nouvelle fenêtre ou dans un nouvel onglet", ensuite dans cette nouvelle fenêtre vous devriez avoir la page principale des "Options vBulletin", il vous suffit de faire un double clique sur le nouveau hack, et vous verrez apparaitre le lien dans la barre de navigation de votre navigateur tous en haut.
(ATTENTION: le lien a retenir est celui qui prolonge celui ci: "http://www.votre-site.com/forum/admincp/" sans le "/" à la fin !
Grace à cela, vous obtenez le lien vers votre paramètre de votre nouveau hack, il ne vous reste plus qu'a l'intégrer lors de la création du bouton dans la partie "<link>"
Voila, actuellement, vous devriez être capable de :
Réorganiser vos boutons
Ajouter des boutons
trouver le liens pour ajouter dans vos boutonsCe qui suit est ma touche perso :D
Je trouve le menu de vB un poil laid, j'ai donc décider de lui donner un peu de couleurs.
Exemple:
http://img429.imageshack.us/img429/2075/acp20zb.gif
Pour réaliser cela, on va se servir du système d'expression de vBulletin ;)
Comme je l'ai expliquer plus haut, pour le titre des options des nouveau boutons, vous avez la possibilité de mettre soit des variables, soit du texte, dans notre cas, nous allons utiliser des variables.
Quand vous aller crée le nouveau boutons, dans la partie:
"<navgroup phrase="nom de ta variable" displayorder="xx">"
Le nom de la variable peut être par exemple: "phrase="acp_titre du hack"[b]", ce qui nous donne en situation:
"[B]<navgroup phrase="acp_titre du hack" displayorder="xx">"
Ensuite, il ne vous reste plus qu'a ajouter l'expression via l'ACP (Langues et Expressions => Gestionnaire d'expressions => Ajouter une nouvelle expression)
[I]Produit: vBulletin
Nom de la variable: acp_titre du hack
Texte: <img src="http://www.votre-site.com/forum/images/acp/1.gif"> vB Titre du hack (titre du bouton)(pour l'occasion, j'ai crée un dossier "acp" dans le dossier "images" qui contiendrais la petite images devant le titre des boutons ce qui donnera tous son "look" a ces boutons ;))
Pour rajouter une image devant un bouton existant, faite une recherche du titre du bouton concerné dans le système d'expressions et avant le titre du bouton, rajouter le liens de l'image comme dans l'exemple ci dessus.
PS: J'ai crée 2 images différentes pour bien différencier certaines partie essentielle de l'ACP
Voila, ce petit tuto est fini, je vais surement le mettre à jour au fur et mesure du temps, je vous joint les 2 images ainsi que le .psd si vous voulez vous amusez un peu ;)
Amicalement, Allan :)
Ce qui va suivre n'a rien d'officiel, c'est ce que j'appelle de la "bidouille" :p
Alors commencons par savoir comment est géré la partie "boutons" de l'AdminCP, pour cela, on se dirige vers ce fichier: "includes/xml/cpnav_vbulletin.xml", c'est lui gère en grosse partie cette partie.
Vous l'avez peut être remarquer, quand vous ajouter un hack, on vous demande souvent d'ajouter un fichier du genre "cpnav_nom-de-votre-hack.xml", ce fichier ajoute simplement un bouton dans votre AdminCP afin d'accèder a certain option par exemple du hack concerné.
Il arrivera souvent qu'on vous demande d''ajouter aussi dans le dossier "includes/xml", des fichier du genre "bitfield_nom-de-ton-hack.xml", ce type de fichier ajoute des options SANS bouton dans les options de vBulletin ou bien des paramètre dans certaines partie de votre AdminCP come par exemple, des permissions du hack dans les groupes utilisateurs.
En bref, pour faire simple:
"cpnav_ton-hack.xml" => ajoute un bouton
"bitfield_ton-hack.xml" => ajoute des paramètres (sans bouton)Pour ma part, j'ai décider de travailler autrement, à savoir ne pas utiliser les fichiers "bitfield_ton-hack.xml", ni "cpnav_ton-hack.xml".
Pourquoi me dirait vous ?, tout simplement car je préfère récupérer les informations de ces fichiers pour les intégrer dans le fichier qui gère l'ensemble de ces informations: "cpnav_vbulletin.xml" (lui c'est votre copain ;))
Le fichier "cpnav_vbulletin.xml" est composé en gros de la facon suivante:
<?xml version="1.0" encoding="ISO-8859-1"?>
<navgroups product="vbulletin" master="true">
<navgroup phrase="vbulletin_options" permissions="canadminsettings" displayorder="10">
<navoption displayorder="10">
<phrase>vbulletin_options</phrase>
<link>options.php?null=0</link>
</navoption>
<navoption displayorder="20">
<phrase>search_type</phrase>
<link>options.php?do=searchtype</link>
</navoption>
<navoption debug="1" link="help.php?do=manage&script=NOSCRIPT" displayorder="30">
<phrase>admin_help_manager</phrase>
</navoption>
<navoption debug="1" displayorder="40">
<phrase>rebuild_bitfields</phrase>
<link>index.php?do=buildbitfields</link>
</navoption>
</navgroup>
</navgroups>
<!-- CVS: $RCSfile: cpnav_vbulletin.xml,v $ - $Revision: 1.16 $ -->
PS: A noter que le script interpretera
&
et le met sous la forum
&
donc, si vous avez une url a mettre dans votre fichier "cpnav_vbulletin.xml" du genre:
options.php?do=options&dogroup=vbrules
il vous faudrait l'écrire de la facon:
options.php?do=options&dogroup=vbrules
http://www.image-dream.com/up/1130787170-screen1.gif
___________________________________
---== Explication des éléments ==----
___________________________________
Alors dans le fichier "cpnav_vbulletin.xml", nous avons les éléments suivants:
<navgroups>
Cela signifie que le fichier contient des sous groupes, <navgroup>, sans le S
<navgroup>
C'est le nom du groupe (le nom du bouton en gros)
Il intègre 3 paramètres: Phrase/texte, permission, hr (hr = espace entre les boutons.)
Pour les phrases, vous devez rentrer le nom de la variable et pour du texte, simplement le texte (l'avantage de la variable permet de personnalisé les boutons via le système d'expression, a voir plus bas)
<navoption>
Contenu du menu, souvent les options du hack (sous le menu du bouton principal)
<phrase> ou <text>
Nom de la variable (utiliser par le système d'expression de vBulletin (modifiable via l'ACP de vB) ou du texte (en dur, cad non paramétrable depuis l'ACP, directement lu par vB depuis ce fichier (cpnav_vbulletin.xml)
<link>
Le lien de la phrase ou texte citer au dessus (relire le PS au sujet de l'interpretation du code au dessus)
___________________________________
---== Mise en pratique ==----
___________________________________
Alors dans ces menus, il vous arrivera de trouver également quelques petits truc comme cela:
displayorder="20" (situer dans <navgroup>)
Il s'agit de l'ordre d'affichage du bouton crée dans l'AdminCP en partant du haut, cela commence par 10 et marche par 5 ou même 10, j'ai pas encore essayer d'autre chiffres.Donc, par exemple, si vous souhaiter que votre bouton "Système de module ne soit plus en bas, il suffit d'aller dans votre fichier "cpnav_vbulletin", de trouver:
<navgroup phrase="plugin_system" permissions="canadminplugins" hr="true" displayorder="230">
et remplacer le chiffre d'ordre d'affichage (displayorder) par un plus petit, dans cet exemple "15", et votre bouton se retrouvera juste en dessous du bouton "Options vBulletin" qui lui contoent le chiffre "10"
hr="true"
Ceci crée un espace entre les boutons, en dessous de celui-ci !
permissions="......."
Pour cette partie, je ne suis pas assez renseigner pour en parler, donc je vais éviter ce sujet pour l'instant (pour la création des bouton, je n'ajoute pas personnellement ce paramètre)Bon, vous avez déja lu le plus gros, si vous avez compris tous ca, vous comprendrez le reste :D
Normalement, si vous avez bien suivis tous ces explications, vous êtes capable de crée des boutons avec leur liens leur ordres d'affichage dans l'admincp ;)
Si vous installer un hack qui crée des options supplémentaires dans les options de vBulletin et que vous souhaiter avoir un bouton direct pour ces options, il suffit de reprendre le contenu du fichier "bitfield_ton-hack.xml comme par exemple:
<navgroup test="blabla" displayorder="xx">
<navoption>
<text>titre de l'option</text>
<link>lien de l'option</link>
</navoption>
</navgroup>
Alors, vous me dirait, j'ai installer un hack mais je ne connais pas le lien pour aller dans les options de ce hack pour pouvoir ensuite le mettre dans ce menu juste au dessus.
C'es très simple :D, vous ouvrer votre ACP, vous dérouler "Options vBulletin" et vous faire un clique droit sur "Options vBulletin" et vous choississez "Ouvrir dans une nouvelle fenêtre ou dans un nouvel onglet", ensuite dans cette nouvelle fenêtre vous devriez avoir la page principale des "Options vBulletin", il vous suffit de faire un double clique sur le nouveau hack, et vous verrez apparaitre le lien dans la barre de navigation de votre navigateur tous en haut.
(ATTENTION: le lien a retenir est celui qui prolonge celui ci: "http://www.votre-site.com/forum/admincp/" sans le "/" à la fin !
Grace à cela, vous obtenez le lien vers votre paramètre de votre nouveau hack, il ne vous reste plus qu'a l'intégrer lors de la création du bouton dans la partie "<link>"
Voila, actuellement, vous devriez être capable de :
Réorganiser vos boutons
Ajouter des boutons
trouver le liens pour ajouter dans vos boutonsCe qui suit est ma touche perso :D
Je trouve le menu de vB un poil laid, j'ai donc décider de lui donner un peu de couleurs.
Exemple:
http://img429.imageshack.us/img429/2075/acp20zb.gif
Pour réaliser cela, on va se servir du système d'expression de vBulletin ;)
Comme je l'ai expliquer plus haut, pour le titre des options des nouveau boutons, vous avez la possibilité de mettre soit des variables, soit du texte, dans notre cas, nous allons utiliser des variables.
Quand vous aller crée le nouveau boutons, dans la partie:
"<navgroup phrase="nom de ta variable" displayorder="xx">"
Le nom de la variable peut être par exemple: "phrase="acp_titre du hack"[b]", ce qui nous donne en situation:
"[B]<navgroup phrase="acp_titre du hack" displayorder="xx">"
Ensuite, il ne vous reste plus qu'a ajouter l'expression via l'ACP (Langues et Expressions => Gestionnaire d'expressions => Ajouter une nouvelle expression)
[I]Produit: vBulletin
Nom de la variable: acp_titre du hack
Texte: <img src="http://www.votre-site.com/forum/images/acp/1.gif"> vB Titre du hack (titre du bouton)(pour l'occasion, j'ai crée un dossier "acp" dans le dossier "images" qui contiendrais la petite images devant le titre des boutons ce qui donnera tous son "look" a ces boutons ;))
Pour rajouter une image devant un bouton existant, faite une recherche du titre du bouton concerné dans le système d'expressions et avant le titre du bouton, rajouter le liens de l'image comme dans l'exemple ci dessus.
PS: J'ai crée 2 images différentes pour bien différencier certaines partie essentielle de l'ACP
Voila, ce petit tuto est fini, je vais surement le mettre à jour au fur et mesure du temps, je vous joint les 2 images ainsi que le .psd si vous voulez vous amusez un peu ;)
Amicalement, Allan :)