Plugin Buddypress: TDLC Birthdays
English below
J’administre un site communautaire basé sur WordPress MU et Buddypress. Jusqu’à aujourd’hui j’ai toujours pu me procurer des plugins pour mettre en place les fonctionnalités dont j’avais besoin. Mais cette fois je cherchais à afficher les anniversaires des membres du site sur la page d’accueil, et à mon grand étonnement je n’ai rien trouvé.
J’ai donc décidé de développer mon premier Widget pour cette plate-forme : TDLC Birthdays
Le plugin est en français et en anglais, c’est pourquoi la suite du post, qui est est basée sur le readme du plugin, est en anglais…
Description
WARNING: Since version 0.2, the plugin is designed for Buddypress 1.2. If you use an earlier version of Buddypress, please use version 0.1.7
This is a Plugin that creates a ‘Birthdays’ Widget that you can use in your Buddypress pages. Once you’ve created a datebox field in the Buddypress profiles and referenced it in the TLDC Birthdays widget settings, the widget will display the list of either all BP users or just the connected user’s friends whose birthday is today and also, if you like, the list of upcoming birthdays within the next n days. Plugin now supports Andy Peatling’s Buddypress Followers plugin when installed, so that you can also track the birthdays of people you follow.
So to sum up, in order to get things to work, you’ll need :
- A birthday field in the Buddypress extended profile settings
- Users to fill it out in their profiles
- The TDLC Birthdays widget properly installed and set up (see Installation)
Remarks :
- This is my very first plugin, use it at your own risk ! Although it’s very (very) unlikely to happen, I cant’t be held responsible for messing up you BP install!
- Localized! Currently English, French, German, Hungarian, Italian, Polish, Russian and Spanish languages are included. Many thanks to the translators!
- Sounds obvious but in « display friends only » mode, as you only see your friend’s birthdays, you wont see your own birthday in the widget. This does not mean that your friends don’t see it either!
Installation
This section describes how to install the plugin and get it working.
- Download the archive on the WordPress Plugin Directory and expand it.
- Upload the tdlc-birthdays folder into your wp-content/plugins/ directory
- In your WordPress Administration Area, go to the Plugins page and click Activate for TDLC Birthdays
- In the Widgets page, you can now add the Birthday plugin wherver you like. Please note that the widget requires compulsory settings.
Settings
- In order to get the widget working, you need to fill out the Birthday field Name (or ID). The Birthday field must have been previously created in the Buddypress profile page (and it should be a datebox type field). Of course, the users must also fill it out on their profile pages…
- The other settings are self-explanatory (or at least I hope so).
Hi Tom, what a great plugin thank you so much i just installed it today, everything works fine, just small work with css and thats it. But i need a date showing not like now ( month-day-year) i need it like that first (day-month-year) ie. today 13.1.2012
Can you please tell me how i can fix that
-Petri
Ps. im translating plugin to Finnish so if you need i can send it to you
Thanks
Hi Petri,
Thanks for your feedback
Regarding the date format, I guess you mean in the widget. You’ll be able to set it properly (ie DD/MM) when translating the English strings. If you mean the date box in the Profile page, I’m afraid it’s managed by Buddypress itself. Maybe a translation could fix it as well.
Hope this helps!
Tom
PS : you’re more than welcome to send me your Finnish translation, I’d be glad to include it in the next release of the plugin