Vous êtes sur la page 1sur 78

Document non officiel

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 !

Système de Gestion de Contenu


(CMS)
Open Source
http://www.mamboserver.com
Mambo pour les Nuls 16/01/2005

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 !

mambopourlesnulsV11.doc Page 2 sur 78


Mambo pour les Nuls 16/01/2005

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

Historique des versions du document :


Date Version Commentaire
13/11/04 0.1 Création du document
06/12/04 0.2 Sortie de la première version complète
18/12/04 1.0 Corrections diverses, ajout du chapitre 7. Transfert d’une installation locale
16/01/05 1.1 Chapitres 5.4 Choix de de l’éditeur WYSYWIG, 7. Transfert d’une installation locale et 8.
Conclusion complétés/modifiés

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.

mambopourlesnulsV11.doc Page 3 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 4 sur 78


Mambo pour les Nuls 16/01/2005

5.6.3 - Ordre des modules............................................................................................................................................................... 46


5.6.4 - Désactivation des modules inutiles...................................................................................................................................... 46
5.6.5 - Création d’un nouveau menu et du module associé............................................................................................................. 47
5.6.6 - Publication et positionnement des nouveaux modules menu ............................................................................................... 49
5.6.7 - Ajout de liens dans les modules de menu............................................................................................................................. 50
5.7 - INSTALLATION D’UN COMPOSANT MAMBO .................................................................................................................................. 51
5.7.1 - Installation........................................................................................................................................................................... 52
5.7.2 - Ajout d’un lien vers ce composant ....................................................................................................................................... 54
5.8 - INSTALLATION D’UN MODULE MAMBO ........................................................................................................................................ 56
5.8.1 - Installation........................................................................................................................................................................... 56
5.8.2 - Publication........................................................................................................................................................................... 57
6- PERSONNALISATION DU DESIGN D’UN SITE MAMBO .............................................................................................. 58
6.1 - INTRODUCTION ............................................................................................................................................................................ 58
6.2 - DE QUOI EST FAIT UN TEMPLATE ? ............................................................................................................................................... 58
6.3 - INSTALLATION D’UN TEMPLATE ................................................................................................................................................... 58
6.4 - DEFINIR UN TEMPLATE PAR DEFAUT ............................................................................................................................................ 60
6.5 - QUE PEUT-ON MODIFIER DANS LE TEMPLATE ? ............................................................................................................................ 61
6.5.1 - Le fichier index.php ............................................................................................................................................................. 61
6.5.2 - Le fichier template_css.css .................................................................................................................................................. 61
6.5.3 - Les images ........................................................................................................................................................................... 63
7- INSTALLATION DISTANTE DE MAMBO ......................................................................................................................... 65
7.1 - INTRODUCTION ............................................................................................................................................................................ 65
7.2 - HEBERGEURS GRATUITS VS HEBERGEURS PAYANTS ..................................................................................................................... 65
7.2.1 - Quels sont les pré requis imposés par Mambo ? ................................................................................................................. 65
7.2.2 - Quels sont les critères de choix ? ........................................................................................................................................ 65
7.3 - LES INFORMATIONS A COLLECTER AVANT DE COMMENCER ......................................................................................................... 65
7.3.1 - Informations de configuration du client FTP ...................................................................................................................... 65
7.3.2 - Transfert des sources d’installation vers votre serveur FTP............................................................................................... 67
7.3.3 - Informations d’accès à votre base de données MySQL ....................................................................................................... 67
7.4 - INSTALLATION DE MAMBO .......................................................................................................................................................... 68
7.5 - TRANSFERT D’UNE INSTALLATION LOCALE .................................................................................................................................. 69
7.5.1 - Export de la base de données Mambo locale....................................................................................................................... 69
7.5.2 - Import de la base sur le serveur de votre hébergeur ........................................................................................................... 73
7.5.3 - Transfert des fichiers de votre installation locale................................................................................................................ 75
7.5.4 - Modification du fichier configuration.php........................................................................................................................... 76
8- POUR CONCLURE ................................................................................................................................................................. 78

mambopourlesnulsV11.doc Page 5 sur 78


Mambo pour les Nuls 16/01/2005

1 - POUR BIEN COMMENCER


1.1 - Introduction
Risquons d’abord la métaphore suivante : vous souhaitez acquérir une nouvelle maison mais vous ne savez trop
comment vous y prendre. Vous n’avez pas de connaissances en gros œuvre, en électricité ou encore en décoration,
mais vous en avez tellement envie de cette nouvelle maison ! Vous pourriez tout apprendre vous-même, enfiler le bleu de
travail… et vous tuez à la tâche ! Bon, certains y arrivent, c’est vrai.
Vous avez donc pris contact avec plusieurs maîtres d’oeuvre et l’un d’eux a particulièrement retenu votre attention : il
s’occupe du gros œuvre et vous livre une maison modulable où vous pourrez choisir vous-même l’emplacement des
cloisons (pour faire autant de pièces que vous voulez), et la décoration. Il ne vous reste plus qu’à meubler.
La maison c’est votre site web, le maître d’œuvre c’est Mambo (et c’est un bon !), le gros œuvre c’est l’environnement de
travail PHP/MySQL, les cloisons c’est précisément la modularité de mambo (qui vous permettra notamment d’ajouter des
composants et des modules à la structure de l’édifice), la décoration c’est le template (le design de votre site), quant
aux meubles, vous l’aurez deviné, il s’agit du contenu même de votre site.
Et décidément, non content de vous offrir gratuitement une toute nouvelle maison, ce Mambo vous livre en plus un rez-
de-chaussée habitable ! En clair, un ensemble de composants, de modules et de templates pré installés qui rendent le
site fonctionnel immédiatement. Pour l’aménagement des étages, c’est à vous de jouer !
Dans cette première partie nous allons donc présenter quelques concepts de base qui aideront à mieux comprendre où
nous allons mettre les pieds. Ensuite, nous rassemblons nos outils, nous préparons le terrain, et on y va !

1.2 - Que peut faire Mambo pour moi ?


Il peut vous aider à créer à votre site web, et c’est bien parce que vous vous voulez savoir comment que vous allez vous
esquinter la vue et vous faire des nœuds au cerveau en lisant ce document ;-)
Mambo vous permettra de créer ou de convertir un site web existant le plus simplement du monde, en y ajoutant des
fonctionnalités très faciles à implémenter : forums, galleries d’image, boutique en ligne, llivre d’or… Bon si vous en
doutez encore c’est que vous êtes encore dans la peau d’un débutant. Alors profitez ce ces derniers moments
d’innocence car vous n’en serez plus un dans quelques heures !
Et la question que vous vous poserez logiquement après avoir fait vos premiers pas sous Mambo sera : « Que puis-je
faire pour Mambo ? Qui m’a tant donné et sans qui je ne serai rien !! »… le début de la mambomanie !!
Pour une présentation plus « officielle » de Mambo et de ses principales fonctionnalités, nous vous invitons à lire le flyer
disponible sur http://mamboforge.net.

1.3 - Quelques concepts de base


1.3.1 - PHP/MySQL
Prenons une simple tableau ; en première ligne on trouve ce qu’on appelle des champs (Nom, Prénom, E-mail…), les
lignes suivantes s’appellent des enregistrements, le tout formant une table. Une base de données MySQL est une table
ou plus souvent un ensemble de tables qui permettent de stocker des informations (ici une liste d’utilisateurs mais il peut
s’agir de n’importe quel autre type d’information).

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.

mambopourlesnulsV11.doc Page 6 sur 78


Mambo pour les Nuls 16/01/2005

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.

1.3.2 - HTML / CSS


Autant vous pourrez très bien vous en sortir dans l’univers de mambo sans connaissances en PHP/MySQL, autant les
connaissances en HTML et CSS s’avèreront très vite indispensables si vous souhaitez personnaliser l’apparence de
votre site (le template). Rien d’insurmontable toutefois, vous trouverez en librairie et essentiellement sur le web toutes les
ressources nécessaires (tutoriaux, documentation, exemples) pour acquérir les rudiments du HTML et du CSS.
Le HTML n’est pas à proprement parler un langage qui nécessiterait un apprentissage long (et fastidieux !),
il s’agit plutôt d’un ensemble de balises permettant de mettre en forme des informations sur une page web.
Vous souhaitez par exemple afficher un mot en gras sur une page web, pour ce faire vous devrez insérer ce
mot entre les balises <b></b>. Vous souhaitez par ailleurs structurer l’affichage de votre page sous forme de
tableau, le HTML vous permettra de le faire à l’aide des balises <table><tr><td></td></tr></table>.
Le CSS est une fonctionnalité qui vient s’ajouter au HTML et qui permet de définir et de contrôler des styles
d’affichage de toutes les pages web d’un site depuis un seul fichier : la feuille de style.
Sans feuille de style il faudrait par exemple définir pour chaque page d’un site que je souhaite que les liens
hypertextes passent en couleur jaune et en souligné lorsqu’ils sont survolés… Que se passe t-il si le
lendemain vous décidez finalement que les liens survolés doivent désormais passer au vert caca d'oie ? Eh
bien il faut rééditer toutes les pages web de votre site.., pas très pratique. Tandis que si nous précisons pour
chaque page web du site l’emplacement et le nom de la feuille de style qui sera utilisée, nous faisons la
modification dans la feuille de style et elle s’applique automatiquement à toutes les pages web du site.

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 !

1.3.3 - Installation locale vs installation distante


Une installation locale vous permettra :
d’installer Mambo sur votre PC, eh oui c’est possible ! Comment ? c’est justement ce que nous allons
détailler dans la suite du document
de vous faire la main en toute tranquillité, à la maison, sans nécessité d’être connecté à Internet
de gérer un environnement de travail que vous maîtrisez complètement ; vous ne dépendez pas d’un
hébergeur, c’est vous le patron ! Vous pouvez bricoler, tester et même torturer votre site en toute impunité !
Si plus rien ne marche, ce n’est pas grave, on efface tout et on recommence.

Une installation distante vous permettra :


de mettre votre site en ligne, sur Internet ; pour cela il vous faudra un hébergeur
de le rendre visible par des millions d’internautes ; ça donne des frissons non ?
enfin de frimer auprès des collègues de bureau, et cela sera tout à fait légitime au vu des heures que vous
aurez passées à créer 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.

mambopourlesnulsV11.doc Page 7 sur 78


Mambo pour les Nuls 16/01/2005

1.4 - La boîte à outils Mambo


1.4.1 - Les softs
EasyPHP 1.7 : package d’installation pour Windows qui comprend un serveur Web Apache, un serveur
de base de données MySQL et un moteur de script PHP, exactement ce qu’il nous faut pour installer Mambo
(et bien d’autres choses d’ailleurs) à la maison !
TopStyle Lite 3.10 (Free) : éditeur de CSS. Nous verrons plus loin dans le document ce qu’est un CSS et
en quoi cet éditeur sera utile.
Context 0.97.5 : un éditeur de texte (qui ne vous quittera plus !). Installation par défaut ensuite aller dans
le menu Options/Environment options… pour sélectionner la langue de l’interface, dans l’onglet Editor de la
même fenêtre cocher la case Line numbers. Fermer et relancer Context.
FileZilla 2.2.9 : un logiciel Client FTP qui vous servira à uploader (transférer) les fichiers sources
d’installation de Mambo vers le serveur de votre hébergeur, dans le cadre d’une installation distante.
Tous ces outils sont gratuits et disponibles dans la section téléchargements de http://www.mambonewbies.com.

1.4.2 - Les ressources Mambo sur le web


http://www.mamboportail.net : site de la communauté francophone mambo
http://www.mambofrance.org : l’autre site de la communauté francophone mambo
http://www.mamboportal.com : site qui dispose d’une impressionnante base de téléchargements
http://www.mamboserver.com : le site officiel mambo
http://mamboforge.net/ : le site de développement et de distribution des ressources mambo
http://www.mambohut.com : un site où on trouve des templates pour tous les goûts
http://www.mambonewbies.com : le site de Mambo pour les Nuls.
... et encore beaucoup d’autres

1.5 - Organiser son univers Mambo


Pour rationaliser votre espace de travail et pouvoir rapidement retrouver vos petits, nous vous conseillons de créer une
arborescence de ce type pour organiser toutes les archives (fichiers ZIP) Mambo que vous serez amené à télécharger :

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.

mambopourlesnulsV11.doc Page 8 sur 78


Mambo pour les Nuls 16/01/2005

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.

1.5.1 - Quelle version de Mambo choisir ?


La plus récente évidemment, et en français si possible… oui c’est possible ! Il s’agit de la version 4.5.1a, sortie le 30
Septembre 2004 dernier, la même version intégrant les packs de langue en français (langue du site et langue de la
console d’administration) est sortie quelques semaines plus tard, c’est celle que nous utiliserons dans ce document.

1.5.2 - Téléchargement du package d’installation Mambo


Rendez-vous sur le site http://www.mambofrance.org, créez un compte et identifiez vous afin de pouvoir accéder à la
section téléchargement.
Dans la section téléchargement, procédez comme suit :

Téléchargez l’archive et décompressez la dans le dossier \Source\Mambo451a\core

Sélectionnez ensuite l’archive MamboV4.5.1a-Stable.zip et décompressez la, toujours dans le même


dossier (on ne s’occupe pas du fichier readme.txt et de l’archive WhereAmI.zip)

mambopourlesnulsV11.doc Page 9 sur 78


Mambo pour les Nuls 16/01/2005

Nous avons maintenant un dossier \sources\Mambo451a\core\MamboV4.5.1a-Stable qui contient les


sources d’installation de Mambo 4.5.1a en français

mambopourlesnulsV11.doc Page 10 sur 78


Mambo pour les Nuls 16/01/2005

2 - MON PREMIER SERVEUR WEB


2.1 - Introduction
Dans cette partie nous allons tout simplement créer un serveur Web à la maison ! Nous créerons ensuite une base de
données MySQL via l’interface d’administration PHPMyAdmin afin de préparer le terrain pour l’installation de Mambo.

2.2 - Installation d’EasyPHP 1.7


Téléchargez la source d’installation sur le site officiel (http://www.easyphp.org) puis sauvegardez la dans le
dossier \sources\EasyPHP. La version 1.7 commence à dater un peu mais elle a l’ avantage d’être stable,
et parfaitement adaptée pour l’utilisation de Mambo :

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.

2.2.1 - Démarrage d’EasyPHP


Cliquez sur Démarrer / Programmes / EasyPHP 1.7 / EasyPHP, une icône en forme de E (en bas à droite de
l’écran, près de l’horloge) vous indique l'état du serveur, si le point rouge clignote, c’est tout bon !

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 :

mambopourlesnulsV11.doc Page 11 sur 78


Mambo pour les Nuls 16/01/2005

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 :

2.2.2 - Paramétrages EasyPHP


Sans entrer dans les détails techniques, nous allons effectuer 2 petites retouches sur l’installation d’EasyPHP, ce afin
d’optimiser l’environnement de travail pour l’utilisation de Mambo. Mambo fonctionnera très bien sans ces paramétrages
additionnels, qui ne sont donc pas obligatoires !!
Activation de la librairie GD2 (pour le traitement des images), effectuer un clic droit sur l’icône EasyPHP :

mambopourlesnulsV11.doc Page 12 sur 78


Mambo pour les Nuls 16/01/2005

Activation de magic_quotes_gpc (pour le traitement des guillemets simples et doubles et de l’antislash),


ouvrir le fichier C:\Program Files\EasyPHP1-7\apache\php.ini, rechercher la chaîne de caractère
magic_quotes_gpc = Off et la remplacer par magic_quotes_gpc = On, sauvegardez et fermez le fichier.
Redémarrez EasyPHP (clic droit sur l’icône EasyPHP):

2.2.3 - Création d’une base de données


Nous lançons phpMyAdmin, l’interface d’administration du serveur MySQL, afin de créer la base de
données qui va accueillir les tables Mambo.

Saisissez mambo dans le champ « Créer une base de données » puis cliquez sur le bouton Créer

La base de données a bien été créée.

mambopourlesnulsV11.doc Page 13 sur 78


Mambo pour les Nuls 16/01/2005

Vous pouvez maintenant fermer la fenêtre phpMyAdmin

2.2.4 - Création d’un utilisateur de la base de données


Nous n’en créerons pas ! Nous sommes tranquillement installé à la maison, nous utiliserons donc le compte root (sans
mot de passe). Le compte root est un compte prédéfini (déjà créé sur le serveur MySQL) qui a tous les pouvoirs sur le
serveur.

2.3 - Transfert des sources d’installation Mambo vers le serveur web


Notre serveur web est opérationnel, la base de données qui va recevoir les tables Mambo est prête, il reste donc à
transférer les fichiers d’installation de Mambo vers notre serveur web.
Copier le contenu du dossier \sources\Mambo451a\core\MamboV4.5.1a-Stable

mambopourlesnulsV11.doc Page 14 sur 78


Mambo pour les Nuls 16/01/2005

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 :

Confirmez le remplacement du fichier index.php d’EasyPHP par celui de Mambo

mambopourlesnulsV11.doc Page 15 sur 78


Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 16 sur 78


Mambo pour les Nuls 16/01/2005

3 - INSTALLATION LOCALE DE MAMBO


3.1 - Introduction
Nous voilà arrivé au premier moment de vérité, ou comment les mystères de l’installation de Mambo vont vous être
révélés ! En fait il n’y a aucun mystère ! Les développeurs de Mambo ont tout fait pour que l’installation soit à la fois
simple (elle s’effectue via un assistant d’installation) et rapide. Si vous avez correctement configuré votre serveur web, et
c’est le cas si vous avez suivi les instructions ci-dessus, l’installation ne vous prendra guère plus d’1 minute, un peu plus
si vous voulez lire toutes les pages de l’assistant d’installation.
Avant de commencer vous devez rassembler les informations suivantes :
Nom du serveur de base de données : localhost1
Nom de l’utilisateur de la base de données : root
Mot de passe de l’utilisateur de la base de données (aucun) :
Nom de la base de données : mambo

3.2 - Lancement de l’installation de Mambo


C’est parti ! Nous allons lancer l’assistant d’installation de Mambo en ouvrant tout simplement la page d’accueil de notre
serveur web, là même où nous avons transféré les sources d’installation de Mambo.
ATTENTION: le processus d'installation s'effectue sur plusieurs pages, une fois que vous avez cliquez sur le bouton Next
pour passer à l'étape suivante, ne revenez pas en arrière! Vous risqueriez de rencontrer des problèmes qui obligeraient à
reprendre toute la procédure d'installation depuis la création de la base de données.
Effectuez un clic droit / Web local sur l’icône EasyPHP

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.

mambopourlesnulsV11.doc Page 17 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 18 sur 78


Mambo pour les Nuls 16/01/2005

Renseignez les champs comme indiqué ci-dessous (ne pas renseigner le champ MySQL Password) puis
vous cliquez sur le bouton Next

mambopourlesnulsV11.doc Page 19 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 20 sur 78


Mambo pour les Nuls 16/01/2005

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:

mambopourlesnulsV11.doc Page 21 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 22 sur 78


Mambo pour les Nuls 16/01/2005

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 !

mambopourlesnulsV11.doc Page 23 sur 78


Mambo pour les Nuls 16/01/2005

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 !

mambopourlesnulsV11.doc Page 24 sur 78


Mambo pour les Nuls 16/01/2005

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

Ouvrez le menu déroulant Base de données et sélectionnez mambo

mambopourlesnulsV11.doc Page 25 sur 78


Mambo pour les Nuls 16/01/2005

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/

mambopourlesnulsV11.doc Page 26 sur 78


Mambo pour les Nuls 16/01/2005

4 - LES BASES DE L’ADMINISTRATION DUN SITE MAMBO


4.1 - Introduction
Nous n’allons pas ici passer en revue toutes les fonctionnalités que Mambo met à votre disposition pour administrer votre
site Web, un guide d’administration ayant été rédigé à cet effet est disponible sur http://mamboportail.net/wacko/Acceuil.
Nous allons simplement aborder les principes de base de l’administration d’un site Mambo, après il vous appartiendra
d’approfondir en partant à l’aventure, seul ou accompagné du guide de l’administrateur !

4.2 - Un peu de théorie


4.2.1 - La terminologie Mambo
Composant : c’est une mini application intégrée à votre site Mambo, qui dispose de sa propre interface de
configuration dans la console d’administration Mambo. Certains composants sont pré installés, c’est le cas
par exemple du gestionnaire de vote, du gestionnaire de bandeaux publicitaires ou encore du gestionnaire
de liens. D’autres peuvent être facilement installés par la suite (forums, livre d’or, galerie d’images,
gestionnaire de mailinglist, gestionnaire de formulaires… et bien d’autres encore).
Module : pour faire simple, un module est un bloc que l’on trouvera généralement dans la colonne de
gauche ou la colonne de droite de notre site. Certains modules sont pré installés (module de menu principal,
module de menu d’identification…), d’autres, le plus souvent associés à des composants (par exemple
module affichant une photo aléatoire tiré d’un composant galerie d’images) peuvent être installés
ultérieurement. Vous aurez remarqué dans la capture ci-dessous que les titres des modules (Main Menu,
Login Form) sont en anglais (encore !?), nous verrons plus loin dans le document comment les traduire en
français, ou en tagalog, mais là c’est vous qui voyez !

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.

mambopourlesnulsV11.doc Page 27 sur 78


Mambo pour les Nuls 16/01/2005

Frontpage : c’est la page d’accueil publique de votre site.


Section / Catégorie / Article (ou contenu) : hyperonymie et hyponymie, ou comment Mambo s’inscrit dans
la pensée de la linguistique structuraliste… Ouh la !! Vous n’avez pas révisé !!
En fait ces notions sont capitales pour la prise en main de Mambo, plus précisément pour la gestion du
contenu de votre site et comme un schéma vaut mieux qu’une longue explication :

Mammifères Danses

Terrestres Marin Latino Salon

- homme - baleine - mambo - valse


- chimpanzé - lamantin - salsa - mazurka
- éléphant - dauphin - tango - polka
- cochon - orque - merengue - fox-trot

Nous avons 2 sections (Mammifères et Danses) ; la section « mammifères » comprend 2 catégories


(terrestres et marins) et la catégorie « terrestres » contient les articles « homme », « chimpanzé »,
« éléphant » et « cochon »… Avant de rédiger et de publier un article sur le cochon, sa vie, son œuvre, il
faudra donc créer une section mammifères, dans laquelle nous créerons une catégorie terrestres, laquelle
servira à stocker tous les articles liés aux mammifères terrestres.
Editeur WYSIWYG : comme son nom l’indique, il s’agit d’un éditeur qui va permettre de rédiger et de mettre
en forme du texte comme vous le feriez avec un traitement de texte (What You See Is What You Get), sans
vous soucier du code html qu’il y a derrière.
Mambot : ce sont des morceaux de scripts qui permettent d’automatiser certaines tâches sur votre site
Mambo. Par exemple, le mambot de recherche est un script qui permet d’effectuer une recherche sur tout
votre site. Autre exemple, le mambot TinyMCE WYSIWYG Editor permettra lui de convertir le texte que
vous saisissez dans l’éditeur WYSIWYG en code HTML interprétable par votre navigateur. Dernier exemple,
le {mospagebreak} qui insère automatiquement un saut de page à l’endroit où vous le positionnez.
Publier / dépublier : encore un notion importante à intégrer. Il s’agit de rendre visible ou pas sur le frontend
un lien dans un menu, un module entier, une section, une catégorie, un article…. Dans la version 4.5.1a,
celle que nous utilisons, l’état par défaut est Publié. Il est par ailleurs possible de définir un calendrier de
publication, date à partir de laquelle ou jusqu’à laquelle un article sera publié.
Sauvegarder / Annuler : vous effectuez une modification sur votre site (modification de la configuration
générale, de la configuration d’un composant, création d’une catégorie, d’un article…), vous êtes sûr de
votre affaire… alors vous cliquez sur le bouton sauvegarder, vous n’êtes pas sûr de ce que vous avez fait ou
alors vous êtes perdu, vous cliquer sur le bouton annuler, mais pas sur le bouton Page Précédente de
votre navigateur !
Template : nous avons déjà évoqué ce terme plus haut dans le document. Un template gère toute la partie
design de votre site, c’est un peu la vitrine de votre site. Il en existe des centaines, disponibles gratuitement
sur des sites qui se sont spécialisés dans cette activité. Nous verrons plus loin comment installer et
personnaliser un template.

4.2.2 - Méthodologie pour la création de votre site Mambo


Mambo est un outil très bien conçu, qui répondra à la plupart de vos besoins (et plus !). Le problème sera justement de
définir ces besoins, en clair, ce que voulez vous mettre sur votre site. D’ailleurs, la question se pose quel que soit le type
d’outil que vous utiliserez pour développer votre site web. Si vous ne savez pas trop dans quelle direction aller :
prenez un papier, un crayon et esquissez le plan de votre site, cela vous permettra entre autres choses de
structurer le contenu de votre site ; vous pouvez d’ores et déjà penser en termes de section/catégorie/article
(souvenez vous, Mammifères/Terrestres/Cochon !)
certaines parties de votre site devront certainement s’appuyer sur des composants, faites en l’inventaire et
voyez ce qui existe sur les différents sites de la communauté Mambo.

mambopourlesnulsV11.doc Page 28 sur 78


Mambo pour les Nuls 16/01/2005

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’à !!

4.3 - La console d’administration


4.3.1 - Accès à la console d’administration
Vous y accédez en tapant http://localhost/administrator dans la barre d’adresse de votre navigateur
Vous arrivez sur cette page d’identification, où vous devrez vous authentifier avec le compte admin et le mot
de passe que vous avez choisi durant l’installation de Mambo :

4.3.2 - La page d’accueil de la console d’administration


Tous les éléments qui composent la page d’accueil de la console d’administration sont des modules administrateur que
vous pourrez choisir de dépublier (sauf la barre de menu !) si vous ne souhaitez pas qu’ils soient affichés.
La barre de menu vous permettra de naviguer facilement dans la console d’administration
La barre d’info vous indique l’endroit où vous vous trouvez dans la console d’administration
La barre d’outils regroupe les boutons qui vous permettront d’effectuer des actions différentes (publier,
dépublier, effacer, créer, sauvegarder…) en fonction de la page sur laquelle vous vous trouvez.
Le panneau de contrôle affiche des raccourcis vers les différentes parties de la console d’administration.
La vue par onglets affiche des statistiques sur votre site Mambo (composants installés, derniers articles
rédigés…)

mambopourlesnulsV11.doc Page 29 sur 78


Mambo pour les Nuls 16/01/2005

4.3.3 - Description du menu « Site » de la console d’administration

La Configuration globale du site permet entre autres choses de :


- définir la façon dont les visiteurs peuvent s’inscrire sur votre site
- sélectionner l’éditeur WYSYWIG par défaut
- mettre votre site en mode maintenance
- de définir le fuseau horaire de votre site
- sélectionner parmi les langues installées la langue du site et celle de la console d’administration
- d’afficher des informations concernant votre installation de Mambo
-…
Langages : permet d’installer des langues additionnelles et d’éditer directement le fichier de langue du site,
afin par exemple de corriger les quelques coquilles qui se seraient glissées dans le fichier.

mambopourlesnulsV11.doc Page 30 sur 78


Mambo pour les Nuls 16/01/2005

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.

4.3.4 - Les autres menus de la console d’administration

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é.

mambopourlesnulsV11.doc Page 31 sur 78


Mambo pour les Nuls 16/01/2005

5 - L’ADMINISTRATION PAR LA PRATIQUE


5.1 - Introduction
Pour illustrer de manière concrète cette partie, nous allons mambo-iser une partie du contenu de ce document ! Aux
sections correspondront les chapitres de premier niveau, aux catégories les chapitres de deuxième ou troisième niveau
et enfin, aux articles (ou pages de contenu) correspondra le corps de texte des chapitres.
Nous verrons aussi comment ajuster ou corriger la langue du site, ou ajouter des fichiers langues si vous souhaitez gérer
un site multilingue.
Enfin nous verrons comment installer un composant et un module Mambo.
Rendez-vous dans la console d’administration de votre site : http://localhost/administrator

5.2 - D’abord un peu de sécurité


Nous avons vu lors de l’installation que Mambo nous laissait le choix du mot de passe du compte Administrateur mais
pas de l’identifiant de ce même compte (c’est le compte admin par défaut). Nous allons donc dans un premier temps
modifier le nom et surtout l’identifiant de connexion du compte Administrateur afin de sécuriser l’accès à la console
d’administration.
Accédez aux propriétés de l’utilisateur Administrator

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.

5.3 - Gestion de la langue


La gestion des langues sous Mambo est on ne peut plus simple :
1 fichier de langue pour le backend (l’interface de la console d’administration). Le fichier se nomme
admin_french.php et il se trouve dans le dossier /language de votre installation Mambo.

mambopourlesnulsV11.doc Page 32 sur 78


Mambo pour les Nuls 16/01/2005

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 ?

5.3.1 - Sélection de la langue par défaut


La version de Mambo (4.5.1a) que nous avons installée est pré-modée, c'est-à-dire qu’elle intègre entre autres choses la
langue française pour le backend et le frontend, en plus de l’anglais. Et c’est le français qui est sélectionné par défaut !

mambopourlesnulsV11.doc Page 33 sur 78


Mambo pour les Nuls 16/01/2005

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

5.3.2 - Installation d’un fichier de langue pour le frontend


ATTENTION, procurez vous le fichier de langue correspondant à la version de Mambo que vous utilisez !!
Téléchargez le sur http://www.mamboportal.com ou http://mamboforge.net et stockez le dans le dossier
\sources\Mambo451a\languages de votre disque local. Le fichier de langue est un fichier archive ZIP ; inutile de le
dézipper, laissez le en l’état.
Cliquez sur le sous-menu Installer

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 :

mambopourlesnulsV11.doc Page 34 sur 78


Mambo pour les Nuls 16/01/2005

Cliquez sur le bouton Continuer

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).

mambopourlesnulsV11.doc Page 35 sur 78


Mambo pour les Nuls 16/01/2005

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.

5.3.3 - Gestion d’un site multilingue


Nous ne vous expliquerons pas dans le détail comment faire, ce n’est pas l’objet de ce document. Sachez toutefois qu’il
existe un composant qui permet de gérer un site multinlingue. Le principe de base consiste à créer votre site avec une
langue de base (ben oui !!), à installer les différents fichiers de langue frontend que vous allez utiliser, puis à installer le
composant Mambelfish (c’est lui !) et enfin traduire tous les éléments de votre site (articles, titres de modules, liens dans
les modules de menu…). Pas mal non ?

5.4 - Choix de l’éditeur WYSYWIG


Avant d’attaquer la partie rédactionnelle du site nous allons d’abord choisir un éditeur WYSYWIG afin de mettre en forme
aisément les articles (choix de la police, couleur, insertion d’images…), à moins que vous ne vous sentiez de « coder »
vos articles en HTML ! Après tout, certains ont bien commencé comme ça ! Mais encore une fois, Mambo nous facilite
grandement la tâche. Nous allons donc utiliser l’éditeur TinyMCE, qui est inclus nativement dans le package d’installation
Mambo. Il existe des mambots éditeurs plus « évolués », HTMLArea et FCKEditor notamment, mais TinyMCE est tout à
fait suffisant pour démarrer.

5.4.1 - Configuration du Mambot éditeur TinyMCE


Voici quelques petits trucs à savoir pour exploiter au mieux cet éditeur :
Nous allons passer TinyMCE en mode « Avancé » pour pouvoir bénéficier de plus d’options de formattage
de texte. Ouvrir le gestionnaire de Mambots :

Editer le Mambot TinyMCE en cliquant dessus :

mambopourlesnulsV11.doc Page 36 sur 78


Mambo pour les Nuls 16/01/2005

Dans le menu déroulant Functionality, sélectionner Advanced et sauvegarder :

5.4.2 - Désignation de TinyMCE en tant qu’éditeur par défaut


Ouvrir la page de configuration globale du site

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 !

mambopourlesnulsV11.doc Page 37 sur 78


Mambo pour les Nuls 16/01/2005

**/ Résolution de problème avec TinyMCE /**


Dans certaines circonstances, liées notamment à la configuration de la carte réseau de votre PC si vous travaillez en
local, il est impossible de saisir du texte dans la fenêtre d’édition de TinyMCE donc impossible de créer/éditer Sections /
Catégories / Articles, ce qui est quand même un peu gênant ! Pour y remédier il va falloir mettre les mains dans le
cambouis, mais en restant digne ! Pour ce faire nous allons éditer le fichier configuration.php de notre site Mambo
Si vous développez votre site en local, procéder comme suit :

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.

mambopourlesnulsV11.doc Page 38 sur 78


Mambo pour les Nuls 16/01/2005

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.

5.5 - Création d’une page de contenu (article)


Première étape dans la rédaction du contenu du site, la création des sections, dans lesquelles nous intègreront des
catégories qui elles-mêmes comprendront des articles. Voici un exemple d’organisation du contenu de notre site :

Bien commencer
Section
Concepts Outils
Catégorie
- PHP/MySQL - EasyPHP
Articles
- HTML/CSS - Context
- Type d’install - Top Style
- FileZilla

Administration de Mambo

Le contenu Les menus Le template

- Création d’une section - Le Main Menu - Définition


- Création d’une catégorie - Création d’un menu - Installation
- Création d’un article - Ajout d’une entrée - Modification
- Création

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…,

5.5.1 - Création d’une section


Dans la console d’administration ouvrez le gestionnaire de Sections

Cliquez sur le bouton nouveau (vous remarquez qu’il existe déjà 2 sections)

mambopourlesnulsV11.doc Page 39 sur 78


Mambo pour les Nuls 16/01/2005

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.

mambopourlesnulsV11.doc Page 40 sur 78


Mambo pour les Nuls 16/01/2005

5.5.2 - Création d’une catégorie


Dans la console d’administration ouvrez le gestionnaire de Catégories

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.

mambopourlesnulsV11.doc Page 41 sur 78


Mambo pour les Nuls 16/01/2005

Le résultat :

5.5.3 - Création d’un article


Dans la console d’administration ouvrez la liste de tous les articles :

Cliquez sur le bouton Nouveau

mambopourlesnulsV11.doc Page 42 sur 78


Mambo pour les Nuls 16/01/2005

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

5.6 - Organisation des modules de menu


Bon et bien voilà ! Les articles sont créés et rangés par catégories, elles-mêmes contenues dans des sections. Le
moment est venu de rendre visible tout cela sur votre site en plaçant des liens dans un ou plusieurs modules de menu.
Nous allons donc conserver le module Main Menu où ne seront conservés et ajoutés que des liens disons généraux.
Nous créerons ensuite 2 nouveaux modules menus, l’un pourra par exemple s’appeler Bien commencer et l’autre
Administration de Mambo… tiens des modules de menu qui portent des noms de sections !! Nous faisons ce choix par
souci de cohérence et simplicité mais rien ne vous empêche de procéder autrement.

5.6.1 - Personnalisation des titres de module

mambopourlesnulsV11.doc Page 43 sur 78


Mambo pour les Nuls 16/01/2005

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 :

Cliquer sur Main Menu

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

A la fin la page des modules du site doit à peu près ressembler à ça :

mambopourlesnulsV11.doc Page 44 sur 78


Mambo pour les Nuls 16/01/2005

5.6.2 - Positionnement des modules


A droite, à gauche, en haut ou ailleurs, tout est possible à condition que le template que vous utiliserez prennent en
charge ces positions. Notez par exemple que le template par défaut de votre nouveau site (la pause café selon
Dolmenhir) a une colonne à gauche, une large colonne centrale, mais pas de colonne de droite. Donc, si vous positionner
un module à droite (c’est le cas par exemple du module sondage) et bien vous ne le verrez jamais !
Pour voir quelles positions sont prises en charge par un template :

Ce qui donne ça :

mambopourlesnulsV11.doc Page 45 sur 78


Mambo pour les Nuls 16/01/2005

5.6.3 - Ordre des modules


En quelques clics vous avez la possibilité de déplacer les modules. En cliquant sur la flèche vers le bas, le module
Identification va passer sous le module Syndication

5.6.4 - Désactivation des modules inutiles


Par défaut, les modules désactivés sont affichés en fin de liste. Si vous voulez éclaircir votre espace de travail, vous
pouvez désactiver, ou plus précisément dépublier les modules que vous ne souhaitez pas utiliser :

mambopourlesnulsV11.doc Page 46 sur 78


Mambo pour les Nuls 16/01/2005

5.6.5 - Création d’un nouveau menu et du module associé


Mambo propose un certain nombre de menus, dont le fameux menu Main Menu. Mais vous vous sentez audacieux, la
confiance est là, alors allons-y !! Créons 2 menus d’un coup !
Ouvrez le Gestionnaire de menu. Vous remarquez que les noms des menus ont été traduits, magique ?
non, c'est logique car les menus sont associés à des modules. Quand vous créez un nouveau menu, le
module associé est automatiquement créé.

Cliquer sur le bouton Nouveau pour créer un nouveau menu :

mambopourlesnulsV11.doc Page 47 sur 78


Mambo pour les Nuls 16/01/2005

Renseignez les champs comme suit (Attention, veillez à ce que le type de menu ne comporte ni accents ni
espaces) :

Ce qui donne ça :

mambopourlesnulsV11.doc Page 48 sur 78


Mambo pour les Nuls 16/01/2005

5.6.6 - Publication et positionnement des nouveaux modules menu


Retournez dans les modules du site (menu Modules), cochez les 2 nouveaux modules menu et publiez les
afin de les rendre visibles :

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.

mambopourlesnulsV11.doc Page 49 sur 78


Mambo pour les Nuls 16/01/2005

5.6.7 - Ajout de liens dans les modules de menu


Sélectionner le menu dans lequel vous allez ajouter des liens

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.

mambopourlesnulsV11.doc Page 50 sur 78


Mambo pour les Nuls 16/01/2005

Donnez un nom au lien. Vous remarquez que toutes les catégories existantes sont listées, sélectionnez celle
qui vous convient

5.7 - Installation d’un composant Mambo


Première chose à retenir : n’installer que des composants compatibles avec la version de Mambo que vous
utilisez.
Pour illustrer cette partie vous allez installer un livre d’or sur votre site. Nous avons choisi le composant Akobook 3.42,
un livre d’or pour Mambo prêt à l’emploi et téléchargeable sur http://www.mamboportal.com. Nous nous contenterons de

mambopourlesnulsV11.doc Page 51 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 52 sur 78


Mambo pour les Nuls 16/01/2005

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 :

Votre composant est configurable ici :

mambopourlesnulsV11.doc Page 53 sur 78


Mambo pour les Nuls 16/01/2005

5.7.2 - Ajout d’un lien vers ce composant


Bon, votre livre d’or est installé, reste maintenant à ajouter un lien dans le module de votre choix afin de pouvoir y
accéder.
Ouvrez par exemple le Menu Principal

Cliquez sur le bouton Nouveau

Sélectionnez le type de lien que vous allez ajouter dans votre menu ; il s’agit d’un lien vers un composant :

mambopourlesnulsV11.doc Page 54 sur 78


Mambo pour les Nuls 16/01/2005

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 ?

mambopourlesnulsV11.doc Page 55 sur 78


Mambo pour les Nuls 16/01/2005

5.8 - Installation d’un module Mambo


Deuxième chose à retenir : n’installer que des modules compatibles avec la version de Mambo que vous utilisez.
Maintenant que vous savez installer un composant, l’installation d’un module ne devrait poser aucun problème. Le
principe est exactement le même. Vous allez installer le module Analog Clock 2, une horloge analogue bien
sympathique, toujours téléchargeable sur http://www.mamboportal.com.

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

mambopourlesnulsV11.doc Page 56 sur 78


Mambo pour les Nuls 16/01/2005

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.

mambopourlesnulsV11.doc Page 57 sur 78


Mambo pour les Nuls 16/01/2005

6 - PERSONNALISATION DU DESIGN D’UN SITE MAMBO


6.1 - Introduction
Des connaissances en HTML et en CSS, quelques notions en retouches d’images, c’est à peu près tout ce qu’il vous
faudra pour personnaliser un template… Ah oui, il vous faudra aussi de l’inspiration, de la créativité, de la persévérance
et du temps, beaucoup !!
Attention le webdesign est un métier à part entière et à moins que vous ne maîtrisiez déjà toutes ces technologies,
n’imaginez pas que vous allez créez un template Mambo en un claquement de doigts. Si vous avez des besoins
spécifiques, si vous n’avez pas de temps à perdre avec le design, ou encore si vous êtes un indécrottable fainéant, faites
appel à un spécialiste, ils sont nombreux à proposer leurs services. Sinon, et bien vous ferez comme beaucoup
d’utilisateurs ; vous chercherez un template qui se rapproche le plus de ce que vous souhaitez et vous le bricolerez sans
vergogne, quitte à le dénaturer complétement, mais en conservant en l’état les informations de licence GNU/GPL, par
respect pour l’auteur !

6.2 - De quoi est fait un template ?


D’un dossier portant le nom du template et dans lequel on trouve basiquement 3 éléments :
des images : le logo de votre site, les images d’arrière plan…. Les images sont stockées dans un sous-
dosier \images
un fichier index.php qui va présenter, le plus souvent sous forme de tableau, les éléments constitutifs de
votre site ; par exemple les modules à afficher dans la colonne de gauche, ceux à afficher dans la colonne
de droite…
un fichier template_css.css qui va gérer les styles d’affichage. Ce fichier est stocké dans un sous-dossier
\css

Ce qui donne une arborescence de ce type, commune à tous les templates Mambo :

6.3 - Installation d’un template


Troisième chose à retenir : n’installer que des templates compatibles avec la version de Mambo que vous
utilisez.
Comme les fichiers de langue, les composants et les modules, les templates sont disponibles sous forme
d’archive ZIP, l’archive ZIP porte généralement le nom du template. Vous les installerez donc de la même
manière en passant par le Gestionnaire de Templates

mambopourlesnulsV11.doc Page 58 sur 78


Mambo pour les Nuls 16/01/2005

Localisez l’archive ZIP du template que vous venez de télécharger et cliquer sur le bouton Envoi de fichiers
& Installer

Comme d’hab’, vous cliquez sur le lien Continuer

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 :

mambopourlesnulsV11.doc Page 59 sur 78


Mambo pour les Nuls 16/01/2005

Une fois installé, votre template se trouve dans un dossier de votre installation Mambo qui se nomme
\Templates :

6.4 - Définir un template par défaut


Vous avez remarqué que le template par défaut de votre site est pause_cafe (par Dolmenhir). Maintenant que vous avez
installé un nouveau template, vous pouvez le définir à son tour comme template par défaut pour tout votre site.
Sélectionner le nouveau template à utiliser par défaut pour votre site et cliquer sur le bouton Defaut :

mambopourlesnulsV11.doc Page 60 sur 78


Mambo pour les Nuls 16/01/2005

C’est tout ! Y a plus qu’à aller voir le résultat sur le frontend


Note : Mambo 4.5.1a offre la possibilité de définir un mode de template dynamique, en d’autres termes vous pouvez
assignez un template à une partie précise de votre site, et un template différent à une autre partie de votre site. Par
exemple vous pourrez définir AkoBluePortal comme template par défaut, et assigner le template pause_cafe à la page
qui affiche votre livre d’or. Cela implique de devoir gérer plusieurs templates en parallèle. Nous laisserons donc cette
fonctionnalité de côté, mais rien ne vous empêche de la tester !!

6.5 - Que peut-on modifier dans le template ?


6.5.1 - Le fichier index.php
Lorsque vous vous mettrez à la recherche, vous lirez certainement des choses comme « template à largeur fixe », ou
« template à largeur variable ». La différence ? Un template à largeur variable occupera toute la largeur de l’écran,
quelque soit la résolution utilisée, alors qu’un template à largeur fixe… a une largeur fixe !!
Qu’allez vous trouvez dans le fichier index.php ? Et bien du code PHP propre à Mambo, qui sert par exemple à charger
des modules à un endroit précis du tableau… Vous trouverez aussi des balises HTML et notamment beaucoup de
<table></table>, <tr></tr>, <td></td>…. les fameux tableaux. Si vous n’avez pas encore acheté HTML pour les nuls, il
est encore temps !!
Nous n’allons pas détailler toutes les possibilités qui s’offrent à vous pour personnaliser un template. Commencez par un
template simple et voyez comment vous pouvez le faire évoluer. Un petit truc à retenir toutefois, dans le fichier index.php
vous trouverez généralement non pas un tableau mais plusieurs tableaux, pour pouvoir les identifier facilement, passez la
valeur <table border=‘’0’’> à <table border=‘’1’’>.
A vos éditeurs !!

6.5.2 - Le fichier template_css.css


Comme des images valent mieux qu’un long discours, voici les classes standards d’un template Mambo. Ouvrez le fichier
template_css.css avec votre éditeur de CSS favori, localisez les classes présentées ci-dessous et modifiez les à votre
convenance.

mambopourlesnulsV11.doc Page 61 sur 78


Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 62 sur 78


Mambo pour les Nuls 16/01/2005

6.5.3 - Les images


Si elles ne vous conviennent pas, la technique la plus simple consiste à créer des images portant exactement les mêmes
noms, les mêmes extensions (GIF, JPEG, PNG…) et les mêmes dimensions que les images existantes, que vous
pourrez remplacer en toute transparence par les vôtres !

mambopourlesnulsV11.doc Page 63 sur 78


Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 64 sur 78


Mambo pour les Nuls 16/01/2005

7 - INSTALLATION DISTANTE DE MAMBO


7.1 - Introduction
Dans cette dernière partie nous allons voir comment mettre en ligne (visible sur Internet) votre site web, ce qu’il faut
savoir avant de commencer et comment s’y prendre.
Note : Si vous avez testé et développé votre site sur votre PC et que vous souhaitez transférer votre site Mambo local
vers le serveur de votre hébergeur c’est tout à fait possible. Pour cela rendez-vous directement au chapitre 7.5 un peu
plus bas dans le document.

7.2 - Hébergeurs gratuits vs hébergeurs payants


7.2.1 - Quels sont les pré requis imposés par Mambo ?
Votre hébergeur, qu’il soit gratuit ou pas, doit au moins répondre aux pré requis suivants :
vous donner accès à une base MySQL
supporter le moteur de script PHP

7.2.2 - Quels sont les critères de choix ?


Très peu d’hébergeurs gratuits vous offrent la possibilité d’utiliser une base de données MySQL, les rares qui le font
brident par ailleurs certaines fonctions PHP, dont certaines altèreront tôt ou tard le bon fonctionnement de votre site
Mambo.
Si vous en avez les moyens, préférez un hébergeur payant. Moyennant quelques dizaines d’euros par an vous pourrez
souscrire un plan d’hébergement qui répondra aux pré requis de Mambo. Fouillez, comparez, interrogez directement
l’hébergeur, ou plus efficace encore, RDV à cette adresse : http://forum.mamboportail.net/viewtopic.php?t=1482

7.3 - Les informations à collecter avant de commencer


7.3.1 - Informations de configuration du client FTP
Après avoir installé le client FTP FileZilla 2.2.9, vous devrez vous procurez les informations suivantes afin de pouvoir
connecter au serveur qui va héberger votre site web, elles vous sont fournies lorsque que vous souscrivez un plan
d’hébergement :
Nom d’hôte (le nom du serveur FTP de votre hébergeur), généralement : ftp.mondomaine.com
Nom d’utilisateur (ou login) loginftp
Mot de passe xxxxxxxxxxx

Vous démarrez ensuite le gestionnaire de sites de FileZilla et renseignez les champs comme suit :

mambopourlesnulsV11.doc Page 65 sur 78


Mambo pour les Nuls 16/01/2005

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.

mambopourlesnulsV11.doc Page 66 sur 78


Mambo pour les Nuls 16/01/2005

7.3.2 - Transfert des sources d’installation vers votre serveur FTP


Dans le volet Site Distant, double-cliquez sur le répertoire racine de votre site (www ou public_html), puis
dans le volet d'exploration Site Local déplacer vous dans le dossier où vous avez décompressé l'archive
contenant les sources d'installation de Mambo (\sources\Mambo451a\core\MamboV4.5.1a-Stable\),
sélectionner tout le contenu du dossier (les fichiers et dossiers sources d'installation de Mambo) puis
effectuez un clic doit / charger sur le serveur:

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.

7.3.3 - Informations d’accès à votre base de données MySQL


Comme pour les informations de configuration du client FTP, votre hébergeur doit vous fournir les informations de
connexion à votre base de données. La différence par rapport à l’installation locale que nous avons réalisée
précédemment, c’est que le plus souvent, toutes ces informations vous seront imposées par votre hébergeur (certains
hébergeurs laissent une certaine latitude).

mambopourlesnulsV11.doc Page 67 sur 78


Mambo pour les Nuls 16/01/2005

Nom du serveur de base de données (généralement): localhost


Nom de l’utilisateur de la base de données (par exemple): loginmysql
Mot de passe de l’utilisateur de la base de données : xxxxxxxx
Nom de la base de données (par exemple): mondomaine_db1

7.4 - Installation de Mambo


Ouvrez la page d'accueil de votre site afin de lancer l’assistant d'installation de Mambo : tapez
http://www.mondomaine.com dans votre navigateur
La vérification de la configuration PHP du serveur de votre hébergeur ainsi que la vérification des
permissions sur les dossiers et fichiers vous indiquent (en rouge) les problèmes que vous pourrez
rencontrer. Dans la capture ci-dessous, rien de bloquant ! Si vous avez pris un hébergeur normalement
constitué tout devrait bien se passer !

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.

mambopourlesnulsV11.doc Page 68 sur 78


Mambo pour les Nuls 16/01/2005

7.5 - Transfert d’une installation locale


Bah oui c’est possible !! Tout le temps que vous avez passé à installer, tester et fignoler votre site Mambo sur votre PC,
tout cela n’est pas perdu. Si vous souhaitez mettre votre site en ligne sur le web, vous n’êtes pas obligé de tout
recommencer à zéro. Ouf !! Nous allons maintenant voir comment transférer votre site Mambo local vers votre hébergeur.
Cette opération se déroule en 4 étapes :
- Export de la base de données Mambo de votre installation locale
- Import de cette même base de données sur le serveur de votre hébergeur
- Transfert des fichiers installation locale vers le serveur de votre hébergeur
- Modification du fichier configuration.php

7.5.1 - Export de la base de données Mambo locale


Ouvrez PhpMyAdmin et sélectionnez votre base de données Mambo :

Cliquez ensuite sur le lien Exporter :

mambopourlesnulsV11.doc Page 69 sur 78


Mambo pour les Nuls 16/01/2005

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 :

mambopourlesnulsV11.doc Page 70 sur 78


Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 71 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 72 sur 78


Mambo pour les Nuls 16/01/2005

7.5.2 - Import de la base sur le serveur de votre hébergeur


Vous connaissiez PhpMyAdmin avec EasyPHP sur votre PC, eh bien votre hébergeur doit également vous fournir l’accès
à cette interface d’administration. Les modalités d’accès varient d’un hébergeur à l’autre. Chez certains hébergeur ce
sera carrément à vous d’installer et de paramétrer PhpMyAdmin, mais le plus souvent votre hébergeur vous fournira une
URL, ou vous devrez passez par la console de gestion de votre plan d’hébergement pour lancer PhpMyadmin.
Assurez vous que votre base de données est sélectionnée dans le menu déroulant de gauche, puis cliquez
sur le lien 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) :

mambopourlesnulsV11.doc Page 73 sur 78


Mambo pour les Nuls 16/01/2005

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à, pour la base de données, c’est réglé !

mambopourlesnulsV11.doc Page 74 sur 78


Mambo pour les Nuls 16/01/2005

7.5.3 - Transfert des fichiers de votre installation locale


Attention, à cette étape vous n’allez pas transférer les fichiers sources d'installation de Mambo, mais les fichiers et
dossiers de l’installation que vous avez déjà réalisée avec EasyPHP, ceux qui normalement doivent ce trouver à cet
emplacement : C:\Program Files\EasyPHP1-7\www
Vous avez installé et configuré votre client FTP comme indiqué plus haut, il ne reste plus qu’à vous
connecter sur le serveur de votre hébergeur et à « uploader » tout le contenu de C:\Program
Files\EasyPHP1-7\www vers la racine de votre site distant (ou éventuellement un sous-répertoire si vous
avez déjà un site à la racine) :

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.

mambopourlesnulsV11.doc Page 75 sur 78


Mambo pour les Nuls 16/01/2005

7.5.4 - Modification du fichier configuration.php


Ce fichier est un peu la carte d’identité de votre site, il indique notamment le chemin d’installation de votre site Mambo et
l’URL pour y accéder, des informations qui vont varier selon qu’il s’agit d’une installation locale ou du installation distante.
Il se trouve à la racine de votre site Mambo.
Copiez le fichier configuration.php de votre installation locale (C:\Program Files\EasyPHP1-
7\www\Configuration.php) et collez le n’importe où sur votre disque local. Ouvrez le ensuite à l’aide votre
éditeur de texte. Les lignes à modifier sont les suivantes :

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;

mambopourlesnulsV11.doc Page 76 sur 78


Mambo pour les Nuls 16/01/2005

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.

mambopourlesnulsV11.doc Page 77 sur 78


Mambo pour les Nuls 16/01/2005

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

mambopourlesnulsV11.doc Page 78 sur 78

Vous aimerez peut-être aussi