imath

Les mises en ligne successives de WordPress 3.1 et BuddyPress 1.2.8 ont quelque peu bousculé le développement de la version 1.2 de BP My Home.

En effet lorsque j’ai testé le plugin sur cette configuration, je me suis aperçu qu’en apparence il fonctionnait toujours comme auparavant. Cependant lorsque je suis passé en mode multisite, je me suis rendu compte qu’avec l’arrivée de l’environnement « network_admin », l’accès au menu d’administration BPMH Manager n’était plus disponible.

J’ai immédiatement patché, et sur ma lancée, je me suis dit autant terminer ce que j’étais en train d’améliorer pour le mettre à disposition quitte à remettre à plus tard d’autres fonctionnalités (comme par exemple la possibilité d’enregistrer des activités suite à la mise en favori – en passant @tom_plays : merci pour la classe, ça sera dans la prochaine version) .

Ainsi, cette nouvelle version de BP My Home fonctionnera à la fois sur WP 3.0 & BP 1.2.5+ et WP 3.1 & BP 1.2.8

!important : le changement majeur.

Avant d’upgrader, veiller à faire un backup des widgets persos que vous avez éventuellement développés et qui de fait ne seront pas inclus dans cette version. Lorsqu’on upgrade le plugin, WordPress utilise une classe pour unzipper le package et du coup ça supprime le contenu du répertoire widgets pour le recréer avec les éléments du plugin.

Or ça fait un moment que je me dis que cette situation n’est pas top.. Aussi pour y remédier, le grand changement introduit par cette version est que les widgets ne seront plus dans un sous répertoire du plugin. Ils seront désormais dans le dossier /wp-content/uploads/bpmh-widgets.

Je suis donc heureux de vous annoncer, que c’est la dernière fois que vous aurez à faire ce backup pour vos widgets persos !!

Voyons désormais les différents cas de figure qui vont se présenter suite à cette mise en ligne sur le WordPress repository

Cas de l’upgrade d’une précédente version de BP My Home

Une fois upgradé, il s’agira de se précipiter sur l’environnement BPMH Manager de l’administration WordPress (sous-menu de BuddyPress) afin d’installer les widgets ou autrement dit de les dézipper dans le répertoire /wp-content/uploads/bpmh-widgets que le plugin aura automatiquement créé.

Pour cela, il suffit de cliquer sur les liens Installer ce widget. Pour ne pas oublier d’installer ceux que vous aviez activé, une mention en gras vous indique que précisémment ils étaients actifs avant l’upgrade. Une fois que vous aurez cliqué sur les liens, vous découvrirez que ceux qui étaient actifs le sont restés, il n’y a donc plus qu’à uploader vos éventuels widgets persos 😉

Pour cela, juste en dessous de la liste des widgets et comme illustré ci-dessus, vous pouvez simplement envoyer un zip contenant votre widget perso (donc un zip par widget). Vous pouvez aussi directement copier vos répertoires (donc non zippés) dans le dossier /wp-content/uploads/bpmh-widgets.

Cas d’une première installation

La liste des widgets est sensiblement identique à celle de l’upgrade sauf qu’évidemment, comme il s’agit d’une première installation, il n’y a pas le message qui vous indique que le widget était activé.

Il s’agit donc de cliquer sur les liens Installer ce widget des widgets que vous souhaitez intégrer.

Ensuite, il s’agira de cliquer sur les liens Activer ce widget pour les rendre disponibles pour vos membres.

Pour les futures versions de BP My Home

Lorsqu’une nouvelle version de BP My Home sera de nouveau disponible, suite à son installation, comme les widgets seront toujours présents dans le répertoire /wp-content/uploads/bpmh-widgets, une mention vous indiquera qu’il est possible de les mettre à jour.

What’s new ?

Intégration d’un nouveau widget : « Derniers articles ».

J’embarque donc le widget développé par @Georglob (merci à lui pour ce petit bijou), tout en l’enrichissant d’une fonctionnalité multisite pour ceux qui jouent avec un réseau de blogs. Comme expliqué sur son site, ce widget permet d’afficher les derniers articles postés sur le blog ou le réseau de blogs.

Possibilité d’intégrer des traductions aux widgets.

Vous vous apercevrez que les language files sont désormais dans les dossiers des widgets. J’ai donc rajouté un hook à BP My Home pour charger les traductions éventuelles de widgets :

add_action( 'load_widget_language_files' , 'votre_fonction_get_locale' );

Pour les concepteurs de widgets qui souhaitent découvrir comment ça marche, je vous invite à osculter le widget exemple fourni avec le plugin

Possibilité d’utiliser un tag pour l’ajout du lien « Ajouter aux favoris » plutôt que le filtre automatique

Par défaut, j’utilise un add_filter(‘the_content’) afin d’ajouter ce lien au dessus du contenu de l’article ou de la page, désormais depuis le BPMH Manager, vous pourrez choisir d’utiliser le tag suivant dans vos templates single.php et page.php afin de mieux maîtriser son positionnement.

<?php if ( function_exists( ‘the_bpmh_bkmks_tag’ ) ) the_bpmh_bkmks_tag() ; ?>

Possibilité d’ajouter du contenu aux templates my-home et my-settings

J’ai ajouté des hooks pour vous permettre depuis le fichier functions.php de votre thème actif de plus facilement ajouter du contenu au dessus et en dessous de la page des widgets des membres et au dessus et en dessous de leur page de réglages :

//Au dessus des widgets
add_action( 'bp_my_home_before_widgets' , 'votre_fonction_au_dessus');
//Au dessous des widgets
add_action( 'bp_my_home_after_widgets' , 'votre_fonction_dessous');
//Au dessus des réglages utilisateur
add_action( 'bp_my_home_before_widgets_setting' , 'votre_fonction_au_dessus_settings');
//Au dessous des réglages utilisateur
add_action( 'bp_my_home_after_widgets_setting' , 'votre_fonction_dessous_settings');

Voilà, il ne vous reste plus qu’à..