Guide d’installation

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