Notez aussi qu’en raison des importantes modifications apportées à WP 3.0, qu’il n’y a aucune raison de mettre à jour un wpmu/bp qui fonctionne correctement. Considérez cela comme un conseil et consolez-vous en vous disant que vous utilisez une version d’avant la 3.0 ….

Annonce officielle en anglais: http://wordpress.org/development/2010/06/thelonious/

BP est une suite de plugins préformatés en termes d’affichage pour s’adapter au thème par défaut. BP 1.2.x utilise un affichage sur deux colonnes.

Dans certaines conditions, on peut vouloir modifier cet aspect et donc ajouter ou supprimer une colonne, ce qui oblige à reconfigurer le template d’origine. En clair, il s’agit de modifier la position de certaines fonctions afin de les faire coïncider avec une maquette.

Première partie

Pour créer un widget, il faut utiliser le fichier “functions.php” qui se trouve dans la plupart des thèmes WP. S’il n’existe pas, il faut le créer et le mettre à la racine du template.

Supposons que vous voulez créer un nouveau widget dans la colonne de droite. BP fournit en natif  la structure d’affichage de celui-ci. C’est à dire les appels à une fonction quelconque, ainsi que l’affichage sous forme de titre, contenu, texte additionnel, le tout entouré des balises HTML nécessaires.

On va donc mettre le code suivant dans le fichier “functions.php”

if ( function_exists('register_sidebar') )
register_sidebar(array(
 'name' => 'nom_du_widget',
 'before_widget' => '<div id="XYZ">',
 'after_widget' => '</div>',
 'before_title' => '<h3>',
 'after_title' => '</h3>'
 )
);

Cette fonction génère l’affichage du widget sur la page d’administration des widgets.

Vous lui attribuez un nom unique à la ligne ‘name’ – ce que vous voulez, en majuscule ou minuscule . C’est ce nom qui s’affichera dans l’admin.

Vous devez aussi nommer le ID, par exemple  ‘XYZ’,  que vous intègrerez à la feuille de style. Si vous préférez utiliser une classe, vous pouvez le faire aussi. Il suffit alors de remplacer div id=’XYZ’ par div class=’XYZ’.

Une fois ces modifs enregistrées, votre widget est potentiellement opérationnel. Si vous voulez en créer d’autres, il vous suffit de recopier autant de fois que nécessaire la  fonction ci-dessus et de l’ajouter dans le fichier functions.php, avec un nom unique pour chacun d’eux.

Vos widgets sont à présent visibles dans l’admin des widgets et vous pouvez les positionner depuis cet emplacement sur votre template.

Reste à implémenter le widget dans le template.

Pour cela vous devez ouvrir le fichier concerné dans le répertoire de votre thème.  Il y en a plusieurs et c’est là ou il ne faut pas se tromper. Supposons que vous voulez ajouter un de vos widgets personnels  sur la page d’activité de votre site.

Vous ouvrez le fichier “activity/index.php” et vous collez le code suivant à l’endroit souhaité:

<?php if ( !function_exists('dynamic_sidebar') || !dynamic_sidebar('nom_du_widget') ) : ?>
/* ici vous mettez tout ce qui vous convient en terme de php, html, javascript,... Mais vous pouvez très bien ne rien mettre aussi... */
<?php endif; ?>

Ne vous laissez pas abuser par le terme sidebar: c’est à usage interne et BP ne vous fera pas la gueule si vous collez un widget à un endroit qui n’est pas une sidebar, mais carrément à l’emplacement de votre contenu principal ou dans le footer ou quoi que ce soit d’autre. En fait un widget est d’abord un bout de code qui vous permet de contrôler une position dans un template.

Bien entendu ce n’est là que le principe général de l’implémentation. Vous devrez encore adapter ce bout de code à votre template à l’aide de la feuille de style. Vous pourrez appliquer tout ce qui vous chante pour avoir un affichage correct, à condition de respecter votre code de nommage des ID et des CLASS précités.

Deuxième partie

Comme vous allez modifier des fichiers natifs et que ces modifs seront perdues à la prochaine mise à jour, WP a prévu ce cas de figure et vous offre la possibilité de créer un thème enfant.  En travaillant les fichiers du thème enfant plutôt que ceux du thème parent d’origine, vous ne perdrez jamais vos modifs. L’autre avantage est que vous n’avez pas à dupliquer la totalité du thème, mais juste les parties qui vous intéressent.

Dans l’exemple ci-dessus, vous allez créer un thème enfant auquel vous allez attribuer un nom unique., disont Toto

Allez dans wp-content/themes et créez un dossier “Toto”

Dans ce répertoire, vous allez créer un fichier nommé “style.css”

En en-tête de fichier vous mettez obligatoirement ce commentaire:

/*
Theme Name: Toto
Theme URL: http://www.monsite.com/themes/Toto
Description:  a 2-column theme created for WordPress.
Author:  vous
Author URI:  l'url de votre site
Version: 1.0
Template: bp-default
Tags:  buddypress, two-columns

The CSS, XHTML and design is released under GPL:

http://www.opensource.org/licenses/gpl-license.php

*/

Les lignes vraiment importantes sont theme name: “le nom de VOTRE thème enfant” et Template: “le nom de votre thème principal” qui est le parent associé à votre enfant. Ainsi WP associera les deux thèmes automatiquement, en allant voir si un enfant existe. Si c’est oui, il le lira en premier. Si c’est non, il enverra le thème parent.

Après le commentaire ci-dessus vous allez ajouter ces 2 lignes:

@import url( ../../plugins/buddypress/bp-themes/bp-default/_inc/css/adminbar.css );
@import url( ../../plugins/buddypress/bp-themes/bp-default/_inc/css/default.css );

La première ligne contrôle l’affichage de la buddybar (la barre d’administration de BP…)
La seconde appelle tous les styles prévus d’origine pour buddypress.
Vous avez maintenant une copie conforme du thème original pour votre thème enfant.

Vous enregistrez le tout et vous activez ce thème pour votre site en lieu et place du thème BP par défaut.
Vous ne verrez aucun changement, mais si vous prenez pas exemple le style par défaut de la balise H1 présent dans style.css qui se trouve dans le thème BP-Default et que vous lui attribuez vos propres paramètres, vous verrez ce changement.

Il faut bien entendu écrire cela dans le nouveau fichier style.css que vous venez de créer.

Par exemple ceci qui affichera tous les titres h1 en rouge:

h1 {
color: red;
}

Le thème enfant étant prioritaire, c’est lui qui sera pris en compte à l’affichage. Votre modif est bien interprétée depuis le thème enfant. Vous n’avez rien touché au fichier original qui sera écrasé à la prochaine mise à jour et votre style à vous est préservé, puisque BP n’écrase pas les thèmes qui ne font pas partie de sa distribution.

Vous procédez de la même manière pour toutes les autres modifs de styles, en copiant le nom originel de l’id ou de la classe à changer et en les collant dans le style.css de votre enfant.

Concernant les fichiers de template que vous voudriez modifier, vous procédez de la même façon. Vous faites d’abord une copie conforme du fichier que vous voulez modifier, et le cas échéant de son chemin, comme ci-dessus “activity/index.php” que vous collez dans votre thème enfant.

Résumé de ce que vous devez voir après les manips décrites ci-dessus.

wp-content/themes/Toto
wp-content/themes/Toto/style.css
wp-content/themes/Toto/functions.php
wp-content/themes/Toto/activity/index.php

Fonctionnement général de BuddyPress

http://codex.buddypress.org/

Les premières concernent des accents qui ne passaient pas dans le fil RSS à cause d’une mauvaise interprétation du php dans le fichier bp-activity-templatetags.php

Les suivantes concernent l’affichage des décomptes de posts au bas des articles et  autour des posts dans les forums qui restaient désespérement en anglais depuis un bon moment. Pour ce dernier point c’est la quasi totalité du fichier bp-forums-templatetags qui n’était pas(plus) pris en compte dans le fichier pot et par conséquent dans sa traduction. Le retrait un peu trop violent de la traduction de bbPress à l’occasion de la sortie de BP 1.2.3 y est pour beaucoup.

Plusieurs tickets relatant ces rectifications ont été ouverts par mes soins.

http://trac.buddypress.org/ticket/2194

http://trac.buddypress.org/ticket/2303

http://trac.buddypress.org/ticket/2304

N’hésitez pas à me signaler les oublis et autres erreurs de traductions que vous pourriez rencontrer dans buddypress.

Un nouveau plugin ”Album+” est apparu. Rien à voir avec l’ancien, plus puissant, mieux écrit et surtout adapté à la 1.2 de BP. Album+ permet à chaque membre de posséder un albums photo et à le gérer comme un article ou un message. Seul reproche, qui n’en est pas un: il n’y a pas encore d’interface d’admin. Tout se passe donc en frontend et dans le fichier wp-config pour le moment. Lisez bien le readme qui est livré avec pour savoir quoi faire. A surveiller de près, car l’outil évolue très vite:
Version initiale hier à 14h: 0.1
Version ce matin 8h: 0.1.2

Le site de l’auteur:
http://flweb.it/buddypress-album-plus/

Télécharger le plugin (traduction française incluse)
http://wordpress.org/extend/plugins/bp-album/

Plusieurs nouveautés sont été implémentées. La plus visible est l’arrivée d’icônes d’identification en fonction de l’extension du document. Elles sont sympas bien que fades à mon goût. En tous cas certaines sont presque invisible sur le template extra blanc par défaut de BP tant elles sont blafardes. Vous pouvez les remplacer, gardez simplement le nom du fichier identique – je n’ai pas regardé si on pouvait en ajouter en plus, ni comment cet affichage est géré.

Autre implémentation, en admin cette fois: la possibilité de déplacer un ou plusieurs fichiers d’un groupe à un autre. Pour cela les fichiers en question doivent être entreposés dans le répertoire “upload” du plugin. Nouveau dossier qui n’existait pas dans les versions précédentes. Notez qu’à l’install ou après la mise à jour vous ne verrez rien. Normal puisque le dossier “upload” est vide. Mettez-y un doc et retournez en admin pour constater les changements.

C’est encore un peu  conceptuel (ne fonctionne pas vraiment)  mais ça promet pour la suite.

Si vous mettez à jour, faites le manuellement pour cette version car elle risque fort d’écraser le dossier “documents”. Faites-en une sauvegarde si vous y avez des fichiers, on ne sait jamais.

Traduction disponible ici

Si vous installez pour la première fois, vous prenez les fichiers ici.

Pour ceux qui mettent à jour, le bouton magique fonctionne comme d’hab’, mais cette fois la recommandation officielle est de désactiver d’abord tous les plugins et le thème, de faire la mise à jour, puis de tout réactiver. Allez juste cette fois, vous verrez c’est amusant.  Au fait, il est d’usage de faire une sauvegarde de la base et des fichiers AVANT. Mais bon en vieux routier de la mise à jour,  vous savez cela bien sûr. J’enfonce une porte ouverte, que dis-je, je prêche dans le désert.

Mauvaises nouvelles en revanche pour les utilisateurs de WP single sur un hébergement mutualisé qui voudraient installer BP: ce ne sera guère possible dans la majorité des cas, c’est à dire pour tous ceux dont le php.ini est inaccessible ou limité à 8,12 ou 16 mo. Il semble en effet (ça reste à confirmer) que la limite indispensable au bon fonctionnement de cette config soit de 32 mo minimum. Ce qui revient à dire qu’il en faudra au moins autant pour WordPress 3.0

Voici ce que j’obtiens pour l’affichage des liens externes dans un WP 2.9+BP 1.2rc2  sur un mutu, avec pourtant 25 mo de mémoire php. Sans autres plugins que BP pour le moment.

Fatal error: Allowed memory size of 26214400 bytes exhausted (tried to allocate 311296 bytes) in /xxx/xxx/xxx/www/wp-includes/class-simplepie.php on line 9906

Avec 20 mo j’obtenais la même chose, mais de plus je ne pouvais plus activer les traductions de WP et BP.

Vous pouvez le voir en démo sur le site de l’auteur ou le télécharger depuis le catalogue des plugins de WP

Ce thème est en téléchargement ici:
http://diesellaws.com/unplugged-a-dark-and-sleek-child-theme-for-buddypress/