BuddyPress France

[version 5 - janvier 2010]

Préambule

Cet article est écrit à l’attention de celles et ceux qui souhaitent installer BuddyPress 1.X Nous vous rappelons ici que buddyPress n’est ni un CMS, ni un outil, mais un ensemble d’extensions adaptées à WordPress . Cette collection de widgets est présentée de manière uniforme à l’aide d’un gabarit spécialement étudié. Le point commun de ces extensions est d’être utilisables dans ce qu’on nomme cummunément un réseau social. 

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 pour une installation neuve. Elle est opérationnelle  telle quelle sur WordPress ou sur une base WordPress MU paramétrée avec une utilisation de blogs en sous-domaines, type “http//monblog.mondomaine.com”. Cette option d’installation nécessite l’activation d’une wildcard au niveau de votre serveur. Elle est parfaitement adaptée à un usage multiblogs et s’avère particulièrement efficace sur des serveurs dédiés.

Si vous comptez utiliser buddyPress sur un serveur mutualisé, ce qui n’est pas recommandé, c’est l’option “blog en sous-répertoire” de type “http://www.mondomaine.com/monblog” qu’il faudra choisir. Vous devrez certainement aussi lire très soigneusement la documentation officielle de votre hébergeur avant de procéder. Nous tenons aussi à vous signaler que de nombreux hébergeurs mutualisés n’autorisent pas le multiblog et que de manière générale, vous serez limité sur les fonctionnalités de PHP qui vous priveront d’une partie non négligeable de la puissance de WPMU et de certaines options de buddyPress.

Etape 1 – Installer WordPress

Depuis le 3 janvier 2010, il est possible d’installer indifféremment BuddyPress avec WordPress ou WordPress MU. Les 2 logiciels seront fondus en un seul aux alentours du mois de juin 2010 sous la dénomination WordPress 3.0.La version 1.2 de BuddyPress est prévue fin janvier 2010.

Je ne vais pas vous décrire ici la façon d’installer Wordpress. Sachez simplement que WP a la réputation de s’installer en 5 minutes. Les dernières versions des guides d’installation de WP et WPMU (en anglais) sont disponibles à ces adresses:
wordpress: http://core.trac.wordpress.org/browser/trunk/readme.html

wordpress MU:http://trac.mu.wordpress.org/browser/trunk/README.txt
Remarque: lorsque vous installez WordPress, 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 installant WordPress MU.

Etape 2 РT̩l̩chargez BuddyPress

Vous pouvez téléchargez buddyPress de plusieurs manières.

- la version courante: http://buddypress.org/download/
- la version de développement: http://trac.buddypress.org/browser/trunk. Attention: cette version est quelquefois très instable, elle ne doit donc pas être utilisée sur un site de production.

Etape 3 РD̩compressez le composant

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

Etape 4 – Installez BuddyPress

Voici venu le moment d’ajouter buddyPress à votre site ! Téléchargez via FTP tout le dossier buddypress dans le répertoire wp-content/plugins de votre site. Comptez entre 5 et 10 minutes selon l’état votre connexion.

Etape 5 – Activez BuddyPress

Allez au tableau d’administration de votre site. Dans le menu “Extensions” (plugin en anglais), activez buddyPress. Vous pouvez cliquer indifféremment sur “activer” ou “activer pour l’ensemble du site”, cela fonctionne dans les 2 cas.

Etape 6 РInstallez les th̬mes

A partir de la version 1.2, il n’est plus nécessaire de déplacer les fichiers de thème. WordPress reconnait automatiquement les thèmes de BuddyPress.

La procédure décrite ci-dessous concerne les versions stables 1.1 à 1.1.3

A l’aide de votre logiciel FTP, rendez-vous à la racine de votre site et déplacez les dossiers “/wp-content/plugins/buddypress/bp-themes/bp-sn-parent” et “/wp-content/plugins/buddypress/bp-themes/bp-default” vers “/wp-content/themes/”. Connectez-vous à votre interface d’administration de WordPress MU et rendez-vous dans la gestion des thèmes. Sélectionnez le thème par défaut de buddyPress intitulé bp-default. Enregistrez vos changements. Allez à présent dans le menu “Apparence” pour activer le thème par défaut du site principal. Cliquez sur le nom du thème. Cliquez sur “activer” dans le coin supérieur droit de l’animation qui va s’afficher.

Félicitations! BuddyPress est installé.

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. Pour WP MU cela suffit. Mais vous avez choisi BuddyPress. Et pour cela, vous devez valider son activation. 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.

Je n’arrive pas à créer de blog supplémentaire

Si vous êtes sur un hébergement mutualisé, ne cherchez pas plus loin, le problème vient de là. Votre hébergeur n’autorise pas la création d’un sous-domaine depuis votre compte. Il ne vous autorise pas non plus à utiliser plus d’un site à partir du même compte. Il se peut aussi que vous excédiez les limites de mémoire allouées à PHP, ce qui empêche certaines fonctions de se déclencher. Beaucoup d’hébergeurs fixent encore cette limite à 8 mo. Idéalement, WPMU/buddyPress en nécessitent 64, 32 mo étant un minimum acceptable. Quoiqu’il en soit, si vous bloquez à cette étape, prenez contact avec votre hébergeur ou cassez votre tirelire pour vous installer sur un serveur dédié.

Combien de blogs peut-on créer ?

Ce n’est pas une question qui concerne directement buddyPress, mais WPMU. Théoriquement, il n’y a pas de limite. Cela dépend de votre serveur… et de vos moyens ! Un site sous buddyPress sur un serveur mutualisé (prestation assez rare) vous laissera tout au plus créer quelques centaines de blogs. Sur un serveur dédié, vous pourrez monter à plusieurs milliers sans difficultés. Au-delà, il faudra songer à employer un administrateur serveur à plein temps et à des moyens de maintenances accrus. A vous de mesurer dès maintenant la taille de votre communauté et aux moyens nécessaires à la faire vivre et évoluer.

Je ne veux pas utiliser une partie des plugins

Pour activer/désactiver n’importe lequel des plugins faisant partie de la suite buddyPress, allez dans l’admin du site, menu buddyPress, option paramétrage du composant et cochez/décochez l’option qui vous intéresse puis enregistrez les changements.

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

Ce message 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…