mambo 4.5.1a décembre 2004 mambo · 2010-12-30 · mambo pour les nuls 16/01/2005...

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

Upload: others

Post on 08-Jun-2020

3 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

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

Page 2: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 2 sur 78

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 !

Page 3: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 3 sur 78

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.

Page 4: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 4 sur 78

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

Page 5: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 5 sur 78

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

Page 6: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 6 sur 78

11 -- PPOOUURR BBIIEENN CCOOMMMMEENNCCEERR 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.

Page 7: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 7 sur 78

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.

Page 8: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 8 sur 78

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 ur rationaliser votre espace de travail et pouvoir rapidement retrPo ouver 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 co sants Mambo (cf. définition plus loin dans le

document) que vous téléchargerez. mpo

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.

Page 9: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 9 sur 78

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)

Page 10: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 10 sur 78

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

Page 11: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 11 sur 78

22 -- MMOONN PPRREEMMIIEERR SSEERRVVEEUURR WWEEBB 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 :

Page 12: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 12 sur 78

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 :

Page 13: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 13 sur 78

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.

Page 14: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 14 sur 78

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

Page 15: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 15 sur 78

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

Page 16: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 16 sur 78

Page 17: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 17 sur 78

33 -- IINNSSTTAALLLLAATTIIOONN LLOOCCAALLEE DDEE MMAAMMBBOO 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.

Page 18: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 18 sur 78

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

Page 19: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 19 sur 78

Renseignez les champs comme indiqué ci-dessous (ne pas renseigner le champ MySQL Password) puis

vous cliquez sur le bouton Next

Page 20: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 20 sur 78

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

Page 21: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 21 sur 78

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:

Page 22: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 22 sur 78

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

Page 23: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 23 sur 78

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 !

Page 24: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 24 sur 78

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 !

Page 25: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 25 sur 78

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

Page 26: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 26 sur 78

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/

Page 27: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 27 sur 78

44 -- LLEESS BBAASSEESS DDEE LL’’AADDMMIINNIISSTTRRAATTIIOONN DDUUNN SSIITTEE MMAAMMBBOO 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.

Page 28: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 28 sur 78

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 :

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.

Mammifères Danses

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.

- baleine - lamantin - dauphin - orque

Marin - homme - chimpanzé - éléphant - cochon

Terrestres - valse - mazurka - polka - fox-trot

Salon

Latino

- mambo - salsa - tango - merengue

Page 29: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 29 sur 78

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

Page 30: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 30 sur 78

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.

Page 31: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 31 sur 78

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

Page 32: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 32 sur 78

55 -- LL’’AADDMMIINNIISSTTRRAATTIIOONN PPAARR LLAA PPRRAATTIIQQUUEE 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.

Page 33: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 33 sur 78

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 !

Page 34: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 34 sur 78

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 :

Page 35: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 35 sur 78

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

Page 36: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 36 sur 78

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 :

Page 37: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 37 sur 78

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 !

Page 38: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 38 sur 78

**/ 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.

Page 39: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 39 sur 78

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

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)

- EasyPHP - Context - Top Style - FileZilla

Outils - PHP/MySQL - HTML/CSS - Type d’install

Concepts Catégorie

Articles

Administration de Mambo

- Le Main Menu - Création d’un menu - Ajout d’une entrée

Les menus - Création d’une section - Création d’une catégorie - Création d’un article

Le contenu Le template - Définition - Installation - Modification - Création

Page 40: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 40 sur 78

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.

Page 41: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 41 sur 78

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.

Page 42: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 42 sur 78

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

Page 43: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 43 sur 78

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

Page 44: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 44 sur 78

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 :

Page 45: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 45 sur 78

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 :

Page 46: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 46 sur 78

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 :

Page 47: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 47 sur 78

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 :

Page 48: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 48 sur 78

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

espaces) :

Ce qui donne ça :

Page 49: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 49 sur 78

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.

Page 50: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 50 sur 78

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.

Page 51: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 51 sur 78

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

Page 52: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 52 sur 78

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

Page 53: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 53 sur 78

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 :

Page 54: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 54 sur 78

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 :

Page 55: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 55 sur 78

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 ?

Page 56: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 56 sur 78

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

Page 57: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 57 sur 78

Voilà vous po s installés, vous voyez uvez maintenant voir le composant anaclock dans la liste des module

é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

olonne de repositionner, au-dessus ou en dessous d’un autre module, sur la colonne de gauche ou sur la cdroite… vous savez maintenant comment faire.

Mais damned modules ; affichez une liste de

!! il est où ce module !! Il n’est pas dans la liste des 10 premiers20 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.

Page 58: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 58 sur 78

66 -- PPEERRSSOONNNNAALLIISSAATTIIOONN DDUU DDEESSIIGGNN DD’’UUNN SSIITTEE MMAAMMBBOO 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

Page 59: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 59 sur 78

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 :

Page 60: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 60 sur 78

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 :

Page 61: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 61 sur 78

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.

Page 62: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 62 sur 78

Page 63: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 63 sur 78

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 !

Page 64: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 64 sur 78

Page 65: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 65 sur 78

77 -- IINNSSTTAALLLLAATTIIOONN DDIISSTTAANNTTEE DDEE MMAAMMBBOO 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 :

Page 66: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 66 sur 78

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.

Page 67: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 67 sur 78

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

Page 68: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 68 sur 78

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.

Page 69: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 69 sur 78

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 :

Page 70: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 70 sur 78

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 :

Page 71: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 71 sur 78

Page 72: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 72 sur 78

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

Page 73: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 73 sur 78

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

Page 74: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 74 sur 78

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

Page 75: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 75 sur 78

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.

Page 76: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 76 sur 78

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;

Page 77: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 77 sur 78

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.

Page 78: Mambo 4.5.1a Décembre 2004 mambo · 2010-12-30 · Mambo pour les Nuls 16/01/2005 mambopourlesnulsV11.doc Page 2 sur 78 Avertissements: Ce document a pour but de donner à tous les

Mambo pour les Nuls 16/01/2005

mambopourlesnulsV11.doc Page 78 sur 78

88 -- PPOOUURR CCOONNCCLLUURREE 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.netEn anglais : http://forum.mamboserver.comEn anglais : http://www.mambers.comEn allemand : http://www.mamboportal.deEn espagnol : http://www.mambohispano.org/foros