Version 1.1
Mambo 4.5.1a
Décembre 2004
mambo
pour les nuls
ou comment faire quand on n’y connaît rien
mais qu’on voudrait bien créer son site web à soi !
Avertissements :
Ce document a pour but de donner à tous les moyens de bien commencer avec Mambo, en se plaçant
toujours du point de vue du débutant. Nous utiliserons donc volontairement un vocabulaire et une méthode
de travail accessibles à un public de non informaticiens, le tout abondamment illustré par des captures
d’écran.
Ce document ne se substitue en aucune manière aux documents officiels Mambo, mais se veut plutôt
comme un document de synthèse des questions de base que se posent les nouveaux venus dans l’univers
Mambo.
Les auteurs du présent document ne sauraient être tenus pour responsables des erreurs ou
dysfonctionnements constatés lors des phases de tests ou de mise en production d’un site Mambo
consécutifs à la lecture de ce document.
Les auteurs se réservent le droit de mettre à jour le présent document ou d’en modifier le contenu à tout
moment. Vous trouverez la version la plus à jour de ce document sur http://www.mambonewbies.com.
Vous êtes par ailleurs invités à signaler tous les problèmes liés au fond ou la forme de ce document sur le
forum de http://www.mambonewbies.com.
Vous avez un peu de temps devant vous, vous êtes motivé, vous avez un solide sens de l’humour (disons
jusqu’au deuxième degré), alors allons-y !
Contributeurs :
Concepteur : Ivan GAUTREAU – http://www.lapatagonie.com
Rédacteurs : Ivan GAUTREAU – http://www.lapatagonie.com
Correcteurs : Elcarribou, Papounet
Credits : Stefan – http://www.mamboportal.de - CSS Guide
Arthur Konze – http://www.mamboportal.com – Template akoblueportal_451
Arthur Konze – http://www.mamboportal.com – Composant AkoBook 3.42
Dolmenhir - http://mambo.dolmenhir.com – Template pause_cafe
Remerciements :
Aux initiateurs du projet Mambo, pour leur initiative !
Aux équipes de développeurs et de designers qui de par le monde contribuent à rendre Mambo toujours
plus convivial, simple, performant et évolutif.
A la communauté des utilisateurs de Mambo.
Aux débutants qui inondent les forums de support Mambo de posts désespérés, car ils sont intimement
convaincus d’avoir fait le bon choix avec Mambo (et ils ont raison !) mais ne savent pas par où commencer.
Ce sont ces personnes qui ont suscités la création de ce document.
Sommaire
1- POUR BIEN COMMENCER .................................................................................................................................................... 6
1.1 - INTRODUCTION .............................................................................................................................................................................. 6
1.2 - QUE PEUT FAIRE MAMBO POUR MOI ?............................................................................................................................................ 6
1.3 - QUELQUES CONCEPTS DE BASE ...................................................................................................................................................... 6
1.3.1 - PHP/MySQL .......................................................................................................................................................................... 6
1.3.2 - HTML / CSS........................................................................................................................................................................... 7
1.3.3 - Installation locale vs installation distante ............................................................................................................................. 7
1.4 - LA BOITE A OUTILS MAMBO........................................................................................................................................................... 8
1.4.1 - Les softs ................................................................................................................................................................................. 8
1.4.2 - Les ressources Mambo sur le web ......................................................................................................................................... 8
1.5 - ORGANISER SON UNIVERS MAMBO ................................................................................................................................................ 8
1.5.1 - Quelle version de Mambo choisir ? ....................................................................................................................................... 9
1.5.2 - Téléchargement du package d’installation Mambo............................................................................................................... 9
2- MON PREMIER SERVEUR WEB......................................................................................................................................... 11
2.1 - INTRODUCTION ............................................................................................................................................................................ 11
2.2 - INSTALLATION D’EASYPHP 1.7................................................................................................................................................... 11
2.2.1 - Démarrage d’EasyPHP ....................................................................................................................................................... 11
2.2.2 - Paramétrages EasyPHP ...................................................................................................................................................... 12
2.2.3 - Création d’une base de données .......................................................................................................................................... 13
2.2.4 - Création d’un utilisateur de la base de données.................................................................................................................. 14
2.3 - TRANSFERT DES SOURCES D’INSTALLATION MAMBO VERS LE SERVEUR WEB .............................................................................. 14
3- INSTALLATION LOCALE DE MAMBO............................................................................................................................. 17
3.1 - INTRODUCTION ............................................................................................................................................................................ 17
3.2 - LANCEMENT DE L’INSTALLATION DE MAMBO ............................................................................................................................. 17
3.3 - CONCLUSION ............................................................................................................................................................................... 25
4- LES BASES DE L’ADMINISTRATION DUN SITE MAMBO ........................................................................................... 27
4.1 - INTRODUCTION ............................................................................................................................................................................ 27
4.2 - UN PEU DE THEORIE ..................................................................................................................................................................... 27
4.2.1 - La terminologie Mambo....................................................................................................................................................... 27
4.2.2 - Méthodologie pour la création de votre site Mambo........................................................................................................... 28
4.3 - LA CONSOLE D’ADMINISTRATION ................................................................................................................................................ 29
4.3.1 - Accès à la console d’administration .................................................................................................................................... 29
4.3.2 - La page d’accueil de la console d’administration............................................................................................................... 29
4.3.3 - Description du menu « Site » de la console d’administration ............................................................................................. 30
4.3.4 - Les autres menus de la console d’administration ................................................................................................................ 31
5- L’ADMINISTRATION PAR LA PRATIQUE....................................................................................................................... 32
5.1 - INTRODUCTION ............................................................................................................................................................................ 32
5.2 - D’ABORD UN PEU DE SECURITE .................................................................................................................................................... 32
5.3 - GESTION DE LA LANGUE .............................................................................................................................................................. 32
5.3.1 - Sélection de la langue par défaut ........................................................................................................................................ 33
5.3.2 - Installation d’un fichier de langue pour le frontend............................................................................................................ 34
5.3.3 - Gestion d’un site multilingue............................................................................................................................................... 36
5.4 - CHOIX DE L’EDITEUR WYSYWIG............................................................................................................................................... 36
5.4.1 - Configuration du Mambot éditeur TinyMCE....................................................................................................................... 36
5.4.2 - Désignation de TinyMCE en tant qu’éditeur par défaut...................................................................................................... 37
5.5 - CREATION D’UNE PAGE DE CONTENU (ARTICLE) .......................................................................................................................... 39
5.5.1 - Création d’une section......................................................................................................................................................... 39
5.5.2 - Création d’une catégorie ..................................................................................................................................................... 41
5.5.3 - Création d’un article ........................................................................................................................................................... 42
5.6 - ORGANISATION DES MODULES DE MENU ...................................................................................................................................... 43
5.6.1 - Personnalisation des titres de module ................................................................................................................................. 43
5.6.2 - Positionnement des modules................................................................................................................................................ 45
Vous connaissiez peut-être Oracle ou encore Microsoft SQL, et bien MySQL fonctionne sur le même principe à cette
différence près qu’il est gratuit, et qu’il est le plus souvent utilisé en environnement Web.
Et PHP dans tout ça ? Et bien PHP va nous permettre d’aller interroger cette table (on dit aussi effectuer une requête) ou
modifier (en ajout, édition ou suppression) son contenu, via des morceaux de scripts intégrés à des pages web. Toute
cette cuisine se fait directement sur le serveur qui héberge votre site.
Et comment on fait ça quand on n’y connaît rien ? On ne fait rien ! Mambo s’occupe de tout (ou presque), de la création
des tables lors de l’installation, jusqu’au moindre bout de code qui va par exemple permettre d’afficher sur une page web
la liste de articles que vous aurez écrits.
Mambo utilise seulement 2 fichiers pour gérer le design d’un site (rappelez vous la décoration de votre maison) :
un fichier qui contient entre autres choses du code HTML afin de structurer les éléments de la page web à
afficher, par exemple 1 colonne de gauche pour afficher les menus de gauche, 1 colonne centrale pour
afficher le corps de la page et une colonne de droite pour éventuellement afficher d’autres menus.
une feuille de style unique pour tout votre site !
A priori, si vous avez réussi à vous procurer ce document c’est que vous êtes déjà équipé d’un PC et d’une connexion
Internet, c’est un bon début !
Nous nous orienterons donc d’abord vers une installation de Mambo en local, histoire de se mettre en jambe et de
maîtriser la bête !
En fin de document nous expliquerons comment réaliser une installation distante de Mambo afin de mettre votre site en
ligne sur Internet, puisque c’est certainement votre objectif.
Dossier components : permettra de stocker tous les composants Mambo (cf. définition plus loin dans le
document) que vous téléchargerez.
Dossier core : core signifie cœur ou noyau, c’est ainsi que l’on désigne les fichiers sources de Mambo.
Dossier doc : pour stocker les documents et tutoriaux que vous jugerez utiles de conserver.
Dossier languages : pour stocker les fichiers de langue additionnels.
Dossier mambots : consulter la définition plus loin dans le document.
Dossier patches : permettra de stocker des fichiers qui apportent des corrections ou des améliorations
aux fichiers d’origine du core, ou encore aux fichiers d’origine d’un composant Mambo.
Dossier templates : pour stocker tous les templates (modèles de design ; cf. définition plus loin dans le
document) que vous voudrez tester ou installer sur votre site.
Exécutez le fichier easyphp1-7_setup.exe et réalisez une installation par défaut en conservant toutes les
options qui vous sont proposées.
Si le point ne clignote pas, ou s’il clignote faiblement, double-cliquez sur l’icône afin d’identifier le service qui
n’est pas démarré et redémarrez le :
Bon, ça clignote ? Alors testons le bon fonctionnement de notre serveur en ouvrant la page par défaut (clic
droit sur l’icône EasyPHP) :
Ce qui donne ça :
Saisissez mambo dans le champ « Créer une base de données » puis cliquez sur le bouton Créer
Ouvrir ensuite le dossier racine de votre serveur Web en effectuant un clic droit / Explorer sur l'icône
EasyPHP :
Puis coller les sources d’installation Mambo dans la fenêtre qui vient de s’ouvrir :
Nous voici sur la première page d'installation, non vous ne vous êtes pas trompé, vous avez bien téléchargé
Mambo en français. L'assistant d'installation est en anglais, après ça ira mieux. A cette étape est effectué un
contrôle de la configuration du serveur web. Tout est vert, c'est très bon signe! Nous pouvons continuer en
cliquant sur le bouton Next
1
Localhost signifie « hôte local », c'est-à-dire la machine sur laquelle vous êtes en train de travailler, celle qui fait office
de serveur Web et/ou de serveur de base de données MySQL, en l’occurrence il s’agit de votre PC.
Vous lisez les termes de la license publique générale GNU (du premier au dernier mot!), vous acceptez les
termes de la license GPL en cochant la case qui va bien puis vous cliquez sur le bouton Next
Renseignez les champs comme indiqué ci-dessous (ne pas renseigner le champ MySQL Password) puis
vous cliquez sur le bouton Next
Confirmez que les données que vous avez saisies sont correctes en cliquant sur OK
Si vous voyez la fenêtre ci-dessous, c'est que toutes les tables ont été créées dans la base de données
mambo, vous devez maintenant donner un nom à votre site Mambo puis cliquer sur le bouton Next
Renseignez les champs comme indiqué ci-dessous puis cliquez sur le bouton Next. Nous vous conseillons
de remplacer le mot de passe Admin Password généré par l'assistant de l'installation; attention il s'agit
du mot de passe d'accès à la console d'administration de Mambo donc pensez à la sécurité et évitez les
mots de passe trop simples à deviner, ce sera d'autant plus vrai quand vous mettrez votre site Mambo sur
Internet:
Voilà, vous l'avez fait! Un site Mambo à la maison! Et comme vous mourez d'impatience de voir la tête qu'il a
ce site... vous cliquez sur le bouton View Site
Et là... et bien non ce n'est pas tout à fait fini, une page web nous indique qu'il faut supprimer le répertoire
d'installation, qu’il en soit ainsi !
Supprimons donc ce répertoire d'installation en ouvrant le dossier racine de notre site web et en supprimant
le fameux répertoire installation
Vous retournez sur la page d'accueil de votre site (celle où il vous est indiqué que vous devez supprimer
le répertoire d'installation), vous appuyez sur la touche F5 et là vous tombez sur un site qui a vraiment une
belle allure, c'est le vôtre!
Merci à dolmenhir pour le design. Pause café pour tout le monde !
3.3 - Conclusion
Voilà, finalement ce n’était pas plus compliqué que ça ! Et comme vous êtes curieux, vous aimeriez bien savoir ce qu’il
s’est passé dans votre base de données mambo. Qu’à cela ne tienne !
Ouvrez l'interface phpMyAdmin
Vous remarquez que l'assistant d'installation de mambo a créé un certain nombre de tables, toutes ces
tables sont préfixées en mos_ (mos pour Mambo Open Source) afin de rendre le contenu de votre base plus
lisible au cas où vous souhaiteriez y ajouter des tables liées à une d’autres applications que Mambo. Le gros
oeuvre est maintenant terminé!
A retenir :
Pour pouvoir travailler sur votre site en local, assurez-vous qu’EasyPHP est bien démarré
Adresse de la page d’accueil de votre site : http://localhost/ , vous pouvez y accéder en cliquant sur
l’icône d’EasyPHP puis sur Web Local, ou en démarrant votre navigateur et en saisissant l’adresse dans la
barre d’adresse
Adresse de la console d’administration : http://localhost/administrator/
Backend / Frontend : le backend est l’arrière-boutique de votre site (la console d’administration), le frontend
c’est la boutique, ce que voient les visiteurs.
Mammifères Danses
après il faudra organiser l’accès aux ressources de votre site (liens vers les pages de contenu, les
composants) via des modules de menu ; vous pourrez aussi ajouter des modules, par exemple des modules
liés aux composants que vous aurez installés.
enfin, il y a le template, qui est un élément capital puisque c’est la vitrine de votre site, mais bon, une belle
vitrine avec une boutique vide… Installez un template qui se rapproche à peu près de ce que vous
recherchez (charte graphique et structure du frontend), vous pourrez vous concentrez sur le contenu de
votre site et enfin terminer par la personnalisation du template.
enfin, y a plus qu’à !!
Gestionnaire de médias : il vous permet de gérer (uploader/supprimer) les images que vous souhaitez
afficher sur votre site, par exemple pour illustrer un article.
Aperçu : il vous permet de visualiser le frontend de votre site ; vous pouvez faire des modifications dans la
console d’administration (ajout de module, de lien dans un menu, modification du CSS…), et ouvrir l’aperçu
dans une nouvelle fenêtre afin de visualiser les modifications apportées au frontend.
Statistiques : comme son nom l’indique, cette fonctionnalité permet d’afficher des statistiques basiques de
fréquentation (fréquentation par page, types de navigateurs de vos visiteurs et les principaux mots
recherchés sur votre site). Par défaut cette fonctionnalité n’est pas activée.
Gestionnaire de template : permet d’installer de nouveaux templates, permet d’assigner un template
particulier à une partie de votre site, permet aussi de modifier en ligne les 2 fichiers principaux d’un
template : le fichier index.php qui structure l’affichage des différents éléments dans vos pages web et le
fichier template_css.css qui lui gère les styles et les couleurs utilisés sur votre site
Gestionnaire de corbeille : avant de supprimer définitivement un objet il passe par votre corbeille ! Si vous
avez supprimé par accident un article qui devait révéler au monde la vraie recette des pâtes au beurre, vous
pourrez toujours le restaurer depuis la corbeille. Ouf !
Gestionnaire des utilisateurs : vous permet de créer/supprimer des utilisateurs, de gérer les utilisateurs qui
se sont enregistrés sur le site, de les affecter à des groupes particuliers.
Menu Menu (!) : comme son nom l’indique, il vous permet de créer autant de menus que vous le souhaitez
et de les gérer en y ajoutant des liens vers des composants que vous aurez installé (livre d’or, forum…), des
liens vers des sections de contenu, des catégories, des pages extérieurs à votre site. Notez bien qu’à
chaque fois que vous créerez un nouveau menu, le module associé sera automatiquement créé.
Menu Contenu : il vous permet de gérer toute la partie « contenu » de votre site. C’est là que vous créerez
la section mammifère, la catégorie terrestre et ce fameux article sur les cochons. Vous pourrez aussi y gérer
les éléments qui devront figurer en frontpage, ainsi que les articles archivés. Le gestionnaire de contenu
statique permet de créer des articles « isolés », c'est-à-dire non rattachés à une catégorie de contenu…
pauvre cochon !
Menu Composants : de là vous pouvez installer/désinstaller vos composants (les mini applications
intégrées à Mambo), c’est également là que vous pourrez les configurer.
Menu modules : c’est de là que vous pourrez installer/désinstaller vos modules, c’est de là aussi que vous
pourrez gérer les modules du site visibles par les visiteur (les publier ou pas, les afficher dans la colonne de
gauche ou dans la colonne de droite, les ordonner les uns par rapport aux autres…) et les modules
administrateur dont nous avons parlé plus haut dans la description de la page d’accueil de la console
d’administration.
Menu Mambots : il permet de d’installer/désinstaller et de publier/dépublier les mambots.
Menu Messages : système de messagerie privée de la console d’administration, utile pour communiquer si
vous êtes plusieurs à administrer un site.
Menu Système : vous permet d’afficher les informations de configuration du serveur qui héberge votre site.
Menu Aide : comme son nom l’indique ! Attention elle est en anglais.
Déconnexion : tout au bout à droite de la ligne de menu vous trouvez un lien « déconnexion » sur lequel
vous devrez cliquer pour fermer votre session administrateur ; c’est plus « propre » et plus « sécurisé » que
de fermer la fenêtre de votre navigateur, même si la session se ferme automatiquement après 15 minutes
d’inactivité.
Modifier les champs Nom et Utilisateur à votre convenance ; dans l’exemple ci-dessous, le nouvel
identifiant de connexion à la console d’administration est adminjdoe. N’oubliez pas de sauvegarder les
modifications que vous venez d’effectuer.
1 fichier de langue pour le frontend, lui aussi se trouve dans le dossier /language de votre installation
Mambo, il se nomme french.php et il éditable en ligne (directement depuis la console d’administration de
votre site), vous pourrez éventuellement corriger les quelques coquilles qui se seraient glissées dans la
traduction ou tout simplement le personnaliser à votre convenance :
Et pour les composants, qui sont le plus souvent livrés en anglais ? Et bien en général le fichier d’archive du
composant contient un dossier /language dans lequel est stocké au minimum un fichier english.php.
Parfois il arrive même qu’il y ait un fichier french.php, chouette !! Si ce n’est pas le cas vous pouvez tout à
fait copier le fichier english.php, le renommer en french.php, et vous farcir la traduction ! Ou plus simplement
récupérer le fichier de langue déjà traduit par un gentil membre de la communauté.
Et ensuite comment ça se passe ? Le composant détecte la langue par défaut du frontend, s’il s’agit du
français, il interrogera le fichier french.php, trop fort non ?
Mais vous pouvez sélectionner l’anglais (ou toute autre langue dès lors qu’elle est installée) pour le backend et/ou le
frontend.
Ouvrir la page de Configuration Globale du site
Positionner vous sur l’onglet Local, sélectionner la langue de votre choix et sauvegardez la modification
Localisez le fichier de langue (nous avons choisi l’hébreu) que vous venez de télécharger (bouton Parcourir)
et cliquez sur le bouton Envoi de fichiers & Installer :
Ce qui donne ça :
Comme vous êtes chaud vous allez maintenant définir l’hébreu comme langue par défaut pour le frontend!!
Sélectionner le bouton radio Hebrew Fixed et cliquez ensuite sur le bouton Publier. Allez faire un tour sur le
frontend de votre site (Menu Site > Aperçu > Dans une nouvelle fenêtre).
Mais bon, chaque chose en son temps; « L'hébreu pour les nuls » sur du « Mambo pour les nuls », ça risque
de faire un peu beaucoup donc revenons au français. Retourner dans le gestionnaire de langue et re-publiez
le français. Vous pouvez également effectuer cette opération via la Configuration générale du site, comme
nous l'avons vu plus haut.
Sélectionner l’éditeur TinyMCE, vous pouvez également en profitez pour changer les messages
d’informations visibles par l’utilisateur lorsque le site est en maintenance… N’oubliez pas de sauvegarder les
modifications !
Assurer vous que la valeur $mosConfig_live_site correspond au nom de votre PC et pas à localhost ou
127.0.0.1 (Note : vous pourrez indifféremment utiliser ces valeurs dans la barre d’adresse de votre site, mais
pour TinyMce, c’est important). Si c’est déjà le cas vous pouvez fermer le fichier, sinon, faites la modification
et sauvegardez le fichier avant de le fermer.
Il se peut également que vous rencontriiez ce problème si vous travaillez sur un site hébergé, si votre site
est accessible indifféremment par http://monsite.com ou http://www.monsite.com (faites le test !), il faut alors
s’assurer que la valeur $mosConfig_live_site du fichier configuration.php est renseignée comme suit :
$mosConfig_live_site = 'http://www.monsite.com';
Pour éventuellement effectuer cette opération, downloadez le fichier configuration.php avec votre client FTP,
faites la modification et uploadez le fichier en écrasant l’ancien.
Bien commencer
Section
Concepts Outils
Catégorie
- PHP/MySQL - EasyPHP
Articles
- HTML/CSS - Context
- Type d’install - Top Style
- FileZilla
Administration de Mambo
Nous allons dans un premier temps créer la section Bien commencer, puis la catégorie Concepts et enfin l’article
PHP/MySQL. Vous pourrez ensuite continuer avec la section Administration de Mambo, les catégories Contenu,
Menus…,
Cliquez sur le bouton nouveau (vous remarquez qu’il existe déjà 2 sections)
Saisissez un titre et un nom pour la section, puis éventuellement une description, enfin, sauvegardez les
modifications.
Voilà, la section Bien commencer est maintenant créée. Notez que les Sections sont triées par ordre de
création, de la plus récente à la plus ancienne.
Cliquez sur le bouton nouveau (vous remarquez qu’il existe déjà 2 catégories)
Saisissez un titre et un nom pour la catégorie, puis éventuellement une description, enfin, veillez à ce qu’elle
soit bien rattachée à la section Bien commencer et sauvegardez.
Le résultat :
Donner un titre et un alias de titre à votre article, sélectionner la section puis la catégorie à laquelle il sera
rattaché, enfin, rédigez votre article dans la zone de texte Texte Intro (requis) et sauvegardez
D’abord Main Menu, ça ne va pas du tout ! Première étape, la traduction du titre du module. Dans la console
d’administration ouvrez les modules du site :
Changez le titre de module. Remarquez le bouton radio qui vous permet d’afficher ou pas le titre du module.
Sauvegardez les modifications. Tant que vous y serez, vous pourrez en profiter pour traduire les autres titres
de modules.
Par défaut Mambo n’affiche que 10 lignes, vous pouvez modifier cette valeur dans le menu déroulant en bas
de page, ou carrément changer la valeur par défaut en allant dans la Configuration générale du site / Onglet
Site / Menu déroulant Longueur de liste
Ce qui donne ça :
Renseignez les champs comme suit (Attention, veillez à ce que le type de menu ne comporte ni accents ni
espaces) :
Ce qui donne ça :
Voilà les modules sont maintenant sur votre site, mais ils sont vides. Vous remarquez que les 2 modules se
sont automatiquement positionnés en haut ; vous savez maintenant comment les repositionner, par exemple
en dessous du module Menu Principal.
Vous remarquez également que le titre du module Administration de Mambo subit un inesthétique retour à
la ligne parce qu’il est trop long ; la solution ? le raccourcir !! Plutôt que qu’Administration de Mambo, nous
conserverons Administration. Là aussi vous savez comment faire.
Pourquoi voit-on encore les liens MamboServer, MamboForge et Administrator ? Simplement parce qu’ils
sont dans le module Autre menu, dont le titre n’est pas affiché ! Solution ? Dépublier le module Autre Menu.
Là vous avez l’embarras du choix sur le type de lien à ajouter, nous ajouterons un lien pour la catégorie
Concepts, que nous avons déjà créée ; en cliquant sur ce lien nous afficherons sous forme de tableau la
liste des articles de la Catégorie. Vous pourrez de la même manière ajouter un lien direct vers un article en
sélectionnant Lien – Contenu Article.
Donnez un nom au lien. Vous remarquez que toutes les catégories existantes sont listées, sélectionnez celle
qui vous convient
décrire l’installation du composant et l’ajout d’un lien vers ce composant dans un module menu. Nous n’aborderons pas
ce qui touche à la configuration du composant, qui est somme toute assez simple ;-)
Un composant se présente sous forme d’archive ZIP. En général vous n’aurez rien à dézipper, le fichier archive du
composant est prêt à l’emploi. Par acquis de conscience vous pourrez quand même ouvrir l’archive et vous assurer
qu’elle contient bien un fichier qui en général porte le nom du composant et a une extension XML, par exemple, pour le
composant Akobook 3.42, vous trouverez un fichier akobook.xml. Vous remarquez aussi que ce composant comprend un
dossier languages qui contient lui-même un fichier de langue pour le français (french.php), magnifique !!
5.7.1 - Installation
Ouvrir la page d’installation/désinstallation des composants
Localisez l’archive com_akobook342.zip que vous venez de télécharger sur votre disque local puis cliquez
sur le bouton Envoi & Installation :
Important : cliquez sur le lien Continuer, pas sur le bouton précédent de votre navigateur
Voilà vous pouvez maintenant voir le composant Akobook dans la liste des composants installés, vous
voyez également quelques informations concernant l’auteur du composant :
Sélectionnez le type de lien que vous allez ajouter dans votre menu ; il s’agit d’un lien vers un composant :
Vous voyez listés tous les composants installés sur votre site. Sélectionnez le composant akobook, donner
un nom au lien que vous allez ajouter et sauvegardez
Vous pouvez ensuite repositionner vers le haut le lien Livre d’or dans le Menu Principal. Remarquez
également que sur cette même page vous pouvez dépublier (rendre invisible sur le frontpage) ou carrément
supprimer mettre à la corbeille les liens du menu. Voyez enfin sur le frontend ce que cela donne. Simple,
non ?
5.8.1 - Installation
Ouvrir la page d’installation/désinstallation des modules
Localisez l’archive mod_anaclock2.zip que vous venez de télécharger sur votre disque local puis cliquez
sur le bouton Envoi & Installation :
Important : cliquez sur le lien Continuer, pas sur le bouton précédent de votre navigateur
Voilà vous pouvez maintenant voir le composant anaclock dans la liste des modules installés, vous voyez
également quelques informations concernant l’auteur du module :
5.8.2 - Publication
Il ne vous reste plus qu’à publier le module, à en modifier ou cacher le titre, éventuellement à le
repositionner, au-dessus ou en dessous d’un autre module, sur la colonne de gauche ou sur la colonne de
droite… vous savez maintenant comment faire.
Mais damned !! il est où ce module !! Il n’est pas dans la liste des 10 premiers modules ; affichez une liste de
20 ou cliquez sur le lien suivant en bas de la liste des modules et vous le retrouverez. Vous pourrez ensuite
aller sur le frontend admirer le travail.
Ce qui donne une arborescence de ce type, commune à tous les templates Mambo :
Localisez l’archive ZIP du template que vous venez de télécharger et cliquer sur le bouton Envoi de fichiers
& Installer
Voilà vous pouvez maintenant voir le template aAkoBluePortal dans la liste des templates installés, vous
voyez également quelques informations concernant l’auteur du module :
Une fois installé, votre template se trouve dans un dossier de votre installation Mambo qui se nomme
\Templates :
Vous démarrez ensuite le gestionnaire de sites de FileZilla et renseignez les champs comme suit :
Votre fenêtre est composée entre autres de deux volets d'exploration: le volet site Local (c'est votre PC) et le volet site
distant (c'est le serveur FTP de votre hébergeur), dans lequel vous trouverez un répertoire qui s'appelle www (ou
public_html selon l'hébergeur), qui est le répertoire racine de votre site, celui ou vous allez transférer les fichiers sources
d'installation de Mambo.
Voilà c'est parti! Le transfert va prendre quelques minutes et à l’arrivée, l’arborescence du site distant devra
être identique à celle du site local.
Pour les étapes suivantes, maintenant vous savez faire ! La démarche est identique à celle que nous avons
entreprise lors de l’installation en local, à ceci près que cette fois-ci vous devrez saisir les informations de
connexion à votre base de données fournies par votre hébergeur.
Vient ensuite le moment crucial. Vous allez maintenant sélectionner toutes les tables de la base de données
Mambo et cocher quelques options d’exportation. Cliquez sur le bouton Exécuter pour procéder à l’export
de la base, on parle aussi de dump d’une base.
Voilà c’est presque fait, il ne reste plus qu’à sélectionner tout le contenu de la fenêtre de droite et à le
copier :
Ouvrez maintenant votre éditeur de texte favori (notepad ou Context par exemple) et coller le texte que vous
venez de sélectionner et de copier. IMPORTANT : supprimer la 1ère ligne (Base de données mambo sur le
serveur localhost) ou commentez la en ajoutant le caractère # en début de ligne, car elle ne sera pas
interprétable par le serveur de base de données lorsque vous effectuerez l’import.
Enregistrez le fichier sur votre disque local en lui attribuant l’extension .sql
Localisez ensuite le fichier au format .sql que vous sauvegardé précédemment et cliquez sur le bouton Go
(ou Exécuter selon la langue de l’interface) :
Après quelques secondes, vous verrez une fenêtre vous indiquant que votre requête SQL a été exécutée
avec succès. Vous noterez également que toutes les tables de votre base de données apparaissent dans le
volet de gauche.
Voilà, l’opération va prendre quelques minutes. Vous avez le temps d’aller prendre un café, ou d’aller brûler
un cierge !! Mais non, pas de soucis, tout va bien se passer.
Les information de connexion à la base de données doivent également être mises à jour :
$mosConfig_host = Nom du serveur de base de données
$mosConfig_user = Nom de l'utilisateur de la base de données
$mosConfig_password = Mot de passe de l'utilisateur de la base de données
$mosConfig_db = Nom de la base de données
Bon, pour la ligne correspondant à l’URL de votre site, à priori pas de problèmes, remplacez
$mosConfig_live_site = 'http://mambopc';
par
$mosConfig_live_site = 'http://www.monsite.com;
Pour les lignes correspondant au chemin absolu vers votre site web sur le serveur de votre hébergeur
$mosConfig_absolute_path = 'c://program files//easyphp1-7//www';
et
$mosConfig_cachepath = 'c://program files//easyphp1-7//www/cache';
à priori c’est plus compliqué…, mais non !! Vous vous souvenez que le fichier archive contenant les fichiers
sources d’installation de Mambo (MamboV4.5.1a-Stable.zip) contenait également un fichier archive
WhereAmI.zip. Décompressez l’archive WhereAmI.zip et, à l’aide de votre client FTP, uploadez le fichier
whereami.php à la racine de votre site. Tapez ensuite dans votre navigateur l’adresse suivante :
http://www.monsite.com/whereami.php, vous savez maintenant par quoi remplacer ces 2 lignes !
Une fois ces 7 lignes modifiées, sauvegardez le fichier configuration.php et, à l’aide de votre client FTP,
uploadez le fichier à la racine de votre site. Ce fichier existe déjà sur votre site distant puisque vous l’avez
uploadé précédemment; écrasez le par fichier que vous venez de modifier !
Et c’est tout !! Testez et faites tester votre nouveau site ; vous aurez peut-être à modifier le chemin vers les
images affichées dans vos articles, mais bon, c’est un moindre mal non ?
Notez enfin que vous pouvez utilisez cette même méthode pour transférer votre site web Mambo en
local, ou encore pour le sauvegarder.
8 - POUR CONCLURE
C’était rigolo non !
Maintenant que vous n’êtes plus tout à fait un newbie, rendez-vous sur les sites de support habituels :
En français : http://forum.mamboportail.net
En anglais : http://forum.mamboserver.com
En anglais : http://www.mambers.com
En allemand : http://www.mamboportal.de
En espagnol : http://www.mambohispano.org/foros