BuddyPress France

Petit guide d’installation de BuddyPress à partir de la version r795 (16/12/2008) + WPMU 2.6.5

Préambule

Cet article est écrit à l’attention de ceux et celles qui aimeraient installer BuddyPress sur une installation WordPress déjà existante.
Il est librement inspiré d’un article en anglais paru sur Webdevstudios le 20 novembre 2008.

http://webdevstudios.com/blog/how-to-install-buddypress-and-common-troubleshooting-tips/

La procédure d’installation décrite plus bas fait référence aux réglages par défauts préconisés par les concepteurs de BuddyPress sur une installation out of the box/sortie de la boîte. Elle est utilisable sur une base WorPress MU paramétrée pour une utilisation de blogs en sous-domaine, type http//monblog.mondomaine.moi
Si vous avez paramétré votre WP MU avec des blogs en sous-répertoire type http://www.mondomaine.moi/monblog, vous devrez certainement consulter la documentation officielle disponible sur le site de buddypress.org et lire soigneusement les fichier ReadMe.txt présent dans les dossiers de BuddyPress.
Enfin, il est possible que la portée de ce guide soit limitée dans le temps, dans la mesure où BuddyPress est encore en phase de développement et que bien des chose peuvent changer d’ici la sortie de la version finale 1.0 stable, annoncée pour la fin 2008.

Attention: WordPress et WordPress MU sont deux CMS distincts et légèrement différents, avec des numéros de versions différents. Notez aussi que BuddyPress ne peut être installé qu’avec WordPRESS MU.

Etape 1 Installer Wordpress MU

Je ne vais pas vous décrire ici la façon d’installer Wordpress MU. Sachez simplement que WPMU s’installe aussi facilement que Wordpress, qui a la réputation de s’installer en 5 minutes. Le guide d’installation de WPMU (en anglais) est disponible à cette adresse.

http://trac.mu.wordpress.org/browser/trunk/README.txt

Remarque: lorsque vous installez WordPress MU, n’éditez pas et ne renommez pas le fichier wp-config-sample.php. C’est l’une des erreurs les plus fréquentes commise par les utilisateurs néophytes avec WordPress.

Etape 2 : visitez la page officielle d’installation sur le site de BuddyPress (en anglais)

http://trac.buddypress.org/wiki/installing-buddypress

Ici vous trouverez la dernière version en date de BuddyPress et le fichier d’aide (en anglais).

http://trac.buddypress.org/browser/trunk/README.txt

Ce fichier contient plusieurs informations importantes, mais il en manque quelques-unes.

Etape 3: Téléchargez BuddyPress

Tant que BuddyPress en pré-version, vous pouvez téléchargez le pack d’installation depuis le trunk de BuddyPress situé à cette adresse:

http://trac.buddypress.org/browser/trunk

Au bas de cette page, qui liste la totalité des fichiers de BuddyPress avec la date de leur dernière mise à jour, figure un tout petit texte qui affiche ZIP Archive. Cliquez dessus pour télécharger la toute dernière version de BuddyPress.

Etape 4 Décompressez le composant

Enregistrez le zip sur votre ordinateur.
Décompressez son contenu dans un dossier de votre choix. Une fois décompressé, vous verrez un dossier nommé trunk. Celui-ci contient tous les dossiers et fichiers nécessaires à l’installation de BuddyPress.

Etape 5 Installez le plugin BuddyPress

Voici venu le moment d’ajouter BuddyPress à votre site sous WordPress MU ! Téléchargez via FTP tout le contenu, à l’exception du dossier buddypress-theme, du dossier trunk (dossiers et fichiers, pas le dossier trunk lui-même), dans le répertoire wp-content/mu-plugins de votre site. Comptez entre 5 et 10 minutes selon votre connexion.

Pendant ce temps, lisez les fichiers readme.txt (en anglais) qui se trouvent dans chacun des dossiers contenus dans buddypress-theme.

Etape 6 Installez les thèmes

Une fois ce premier téléchargement terminé, ouvrez le dossier buddypress-theme. A l’intérieur vous trouvez 2 dossiers nommés buddypress-member et buddypress-home. Téléchargez le dossier buddypress-member directement dans le dossier wp-content et installez le dossier buddypress-home dans le répertoire wp-content/themes/. Ce dossier va remplacer, si vous choisissez d’ajouter BuddyPress à votre WordPress MU, le dossier home d’origine. Si tel est votre choix, vous pouvez effacer le dossier home ou plus prudemment, le renommer. On ne sait jamais, des fois que vous changiez d’avis, plus tard…

Etape 7 Activez BuddyPress dans WordPress MU

Connectez-vous à votre interface d’administration de WordPress MU. Si vous avez correctement suivi les étapes précédentes, vous devriez remarquer quelques petits changements dans votre back-office. dans l’administration du site figurent à présent de nouveaux boutons: BuddyPress, Groupes et Profil

Si à ce stade vous voyez apparaître un avertissement indiquant “Registration has been disabled” ou “Les enregistrements sont désactivés”, pas de panique. Allez simplement dans la section Admin > Options et activez l’option “Autoriser de nouvelles inscriptions” ou “Allow new registrations”, sans oublier d’enregistrer votre modification…

Il vous faut à présent activer le thème de la page d’accueil de BuddyPress. Pour cela, rendez-vous dans Admin > Themes et activez BuddyPress Home dans la liste, puis cliquez sur sauvegarder en bas de la liste. Allez ensuite dans Design > Themes. Une page contenant le thème de BuddyPress va alors s’afficher en superposition avec une barre de progression indiquant l’état d’avancement de l’installation du thème. Dans le coin supérieur droit de cette page, vous cliquez sur “activate” ou “activer”. Cette fois, le thème est définitivement installé. Vous pouvez retourner sur votre site et admirer le résultat.

Félicitations ! Vous avez réussi à installer BuddyPRESS.

Quelques erreurs communes pouvant survenir lors d’une installation

Page blanche sur le site à l’issue de l’installation

L’installation s’est bien déroulée. Vous avez activé votre thème dans WP MU et le résultat de tout ce travail est une page blanche désespérement vide sur votre site. Rien de rien, pas même un message d’erreur ! Calmez-vous et vérifiez juste une chose: avez-vous vraiment validé le thème ? Il se peut tout à fait que vous ayez sélectionné le thème, c’est à dire indiqué à WP MU que vous vouliez utiliser BuddyPress Home. Pour WP MU cela suffit. Mais vous avez choisi BuddyPress. Et pour cela, vous devez valider votre choix. Allez donc dans Design > Themes, admirez la lightbox qui va s’ouvrir et cliquez sur “valider” en haut à droite pour terminer l’installation. Il se pourrait bien que vous retrouviez le sourire sans autre forme de discussion.

Message d’erreur: Please make sure your BuddyPress enabled theme includes a header.php and footer.php file

Ce message vous indique une erreur d’emplacement de vos fichiers. Vous seriez-vous trompé de répertoire lors du téléchargement initial de BuddyPress ? Revoyez les étapes ci-dessus et rangez vos fichiers et dossiers au bon endroit.

Message d’erreur: Registration has been disabled

Vous devez activer l’enregistrement de nouveaux membres dans WordPress MU. Allez dans Admin > Options et activez cette option en cliquant dans le bouton radio à côté de “Allow new registrations”, sans oublier d’enregistrer votre modification…