Vereins-Geburtstage
| 开发者 | hagenkoeckritz |
|---|---|
| 更新时间 | 2026年7月30日 13:00 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Vereins-Geburtstage manages your members' birthdays and sends personal birthday greetings by email, automatically or at the push of a button. It is designed for clubs and associations and is fully bilingual (English and German).
Members are imported from a CSV file or added manually. On re-import, an existing entry with the same email address is updated, so no duplicates are created. Every morning at 9:00 a.m. the plugin checks whether anyone has a birthday and, only then, sends a summary email to the configured address with the names and a link to the admin area. There you can see today's birthdays, a preview of the upcoming birthdays in the next seven days, and send the greetings with one click. Optionally, the plugin sends them fully automatically.
For the texts you can define any number of templates with the placeholders
{vorname} (first name), {nachname} (last name), {absender} (sender) and {alter} (age). One template is chosen at random per person so the greetings stay varied. You can also define separate templates for special birthdays: enter an age (for example 50, 60 or 75) and, when a person reaches exactly that age, a matching template is used instead. Special birthdays are marked with a star in the overview, the preview and the morning summary – even for people without an email address.
Both the overview and the people list show for whom a greeting has already been sent in the current year. The people list can be sorted by first name, last name, birthday or email by clicking the column headers.
Before relying on a template, you can send yourself a test email with sample data at the push of a button. Every send – manual, automatic or test – is recorded in a sending log, and the people list can be exported back to CSV at any time.
The plugin is privacy-friendly: only the imported data is stored in your own database, and no external services are used.
Features
- CSV import (first name, last name, birthday, email) with automatic delimiter and date detection
- Manual adding of individual people
- Daily summary at 9:00 a.m. – only when at least one birthday is due
- Sending manually by button or fully automatic
- Any number of templates with placeholders, chosen at random per person
- Special-birthday templates for milestone ages (e.g. 50, 60, 75), marked with a star
- Configurable closing/signature appended automatically to every email
- Import and export of all templates as a JSON file
- Test-email button per template, sent to a chosen address with sample data
- Sending log (last 500 entries) with timestamp, recipient, template and result
- CSV export of the people list, re-importable in the same format
- Configurable advance warning (in days) for milestone birthdays, shown in the overview and as a one-time note in the daily summary
- Marking of greetings already sent
- Preview of birthdays in the next 7 days
- Sortable people list
- Whole list deletable (with confirmation)
- Built-in help, bilingual EN/DE
安装:
- Upload the plugin ZIP under "Plugins -> Add New -> Upload Plugin" and activate it.
- In the "Geburtstage" (Birthdays) menu, import a CSV file.
- Add your own texts under "Templates".
- Configure the sender and, if desired, fully automatic sending under "Settings".
- The built-in guide is available at any time on the "Help" tab.
屏幕截图:
常见问题:
What format does the CSV need?
Four columns: first name, last name, birthday, email. Separator semicolon or comma. Date as DD.MM.YYYY or YYYY-MM-DD. The email column is optional and may be left empty or omitted.
Can I import contacts without an email address?
Yes. Contacts without an email are stored and listed on the "Without email" tab. They receive no birthday email but appear in the morning summary for information.
Are existing members duplicated on import?
No. An existing entry is matched by email address, or by first name, last name and birth date if no email is present. Adding an email later merges the existing entry.
Are emails really only sent when there is a birthday?
Yes. The summary is sent only when at least one person has a birthday.
Can sending be automated?
Yes, fully automatic sending at 9:00 a.m. can be enabled in the settings.
Can I send a test email before saving a template?
Yes. Each template (normal and special) has a "Send test email" button on the Templates tab. It sends the currently entered subject and text, filled with sample data, to an address you choose (defaults to the admin address). It never marks a real contact as "sent".
Where can I see which emails were actually sent?
On the "Log" tab, showing the last 500 entries (newest first) with timestamp, recipient, template, whether it was a manual, automatic, or test send, and the result.
Can I export the people list?
Yes. The "People" and "Without email" tabs have an export button that produces a CSV file in the same format as the import, so it can be re-imported directly (e.g. after editing it).
Can I get advance notice before a milestone birthday?
Yes. Set an "advance warning" in days in the settings (default 14). Once a milestone birthday (one with a matching special template) is within that many days, it shows up in the overview ahead of the regular 7-day preview, and you get a one-time, dedicated warning email – even if nobody else has a birthday that day. If the daily task happens to miss the exact day, the warning is caught up on the next run instead of being lost. You can optionally set a second recipient address for this warning email, e.g. for someone in charge of gifts or a small celebration.
Is this plugin GDPR-compliant?
The plugin only stores the data you import (name, birthday, optional email) in your own site's database and never sends it to third parties or external services. Having a legal basis for processing this data (e.g. your club's statutes, membership agreement, or consent), and deleting a member's entry when they leave, remains your responsibility as the data controller. The "Help" tab has a dedicated "Privacy" section with more detail. This is general information, not legal advice.
更新日志:
1.9.4
- New: the overview and the 7-day preview now show the age every person is turning, not just those with a matching special template — handy for occasions like an upcoming 18th birthday that doesn't (yet) have its own template.
- New: a dedicated "Privacy" section in the Help tab, plus short notices on the CSV import and export screens, summarizing what personal data is processed, where it's stored, and what stays the club's responsibility (this is general information, not legal advice).
- Changed: wording around the milestone-birthday advance warning updated to reflect that it catches up on the next run instead of only firing on the exact day.
- Fixed: birthdays on February 29 are now recognized correctly in non-leap years (celebrated on February 28) instead of being skipped in the daily check, the 7-day preview, and the milestone-birthday warning.
- Fixed: the milestone-birthday advance warning no longer relies on the daily task running on the exact matching day; it now catches up on the next run if a day was missed (e.g. due to low site traffic), and is logged in the sending log.
- Fixed: an invalid email address entered in the settings is no longer silently discarded; a warning is shown and the field is left empty.
- Hardened: values in the CSV export that start with =, +, -, or @ are now neutralized to prevent formula injection when opened in a spreadsheet application.
- Changed: the milestone-birthday advance warning is now sent as its own, separate email (instead of being folded into the daily summary), so it no longer needs an actual birthday that day to be delivered.
- New: optional second recipient address for the advance-warning email, configurable in the settings.
- New: configurable advance warning (in days, default 14) for milestone birthdays. Once within the warning window, they appear in the overview ahead of the regular 7-day preview, and trigger a one-time note in the daily summary email on the day the warning period begins – even on days with no other birthdays.
- New: "Send test email" button per template (normal and special) — sends the rendered email with sample data and the configured closing/signature to a chosen address, without affecting the "already sent" status.
- New: sending log on a new "Log" tab, recording every manual, automatic and test send with timestamp, recipient, template, type and result; the log can be cleared.
- New: CSV export of the people list (with and without email) in the same format as the import, so it can be re-imported directly.
- Fixed: HTML entities (e.g. ") appeared in the email subject and body when the site name or sender name contained quotes or ampersands. All text is now decoded properly for plain-text emails.
- Fixed: the daily 9:00 a.m. job could stop being scheduled after a plugin update; it is now re-scheduled automatically if missing.
- Scheduling now uses the WordPress time zone correctly (previously it could be off on servers not running in UTC).
- New status panel on the overview tab showing the next scheduled run, the last run, whether WP-Cron is disabled, and the site time zone.
- New button to run the daily job manually (useful for testing or if the cron did not fire).
- Fixed: only a single contact without an email address could be stored. A UNIQUE index on the email column left over from earlier versions rejected every further row with an empty email. The index is now reliably detected and removed on update.
- Failed database writes during import are no longer counted as successful.
- Import and export of all templates (standard and special) as a JSON file – for backups or to load new templates as a block.
- New configurable closing/signature in the settings that is automatically appended to every birthday email.
- {alter} (age) placeholder can be used in templates and in the signature.
- Automatic migration of templates and settings stored under earlier option names, so data is no longer lost after updating from older versions.
- Templates for special birthdays: define your own subject and text for specific ages (e.g. 50, 60, 75).
- When a person reaches a defined age on their birthday, a template for that age is chosen at random; otherwise a standard template is used. People without a known birth year always receive a standard template.
- Special birthdays are marked with a ★ in the overview, the 7-day preview and the morning summary – including for people without an email address.
- New placeholder {alter} (age) available in templates.
- Contacts without an email address can now be imported and added manually (email is no longer required).
- People without an email are listed on a separate "Without email" tab.
- The morning summary now lists people with an email first (who receive a mail), followed by people without an email (for information only, including age).
- Automatic and manual sending still only send to people with an email address.
- Duplicate detection improved: matched by email, otherwise by first name, last name and birth date; adding an email later merges the existing entry.
- Loading of translations is now handled automatically (removed the manual textdomain call).
- Inline admin script is now registered through the WordPress script API.
- readme fully translated to English.
- No changes to features or behaviour.
- Code quality and security hardening for the WordPress.org Plugin Directory.
- All output is now properly escaped; database queries reviewed and secured.
- CSV import now uses the WordPress filesystem API instead of direct file functions.
- Date handling switched to timezone-safe functions.
- Added translator comments for all strings with placeholders.
- No changes to features or behaviour.
- Marking in the overview and people list of whether a greeting was already sent this year.
- Preview of upcoming birthdays in the next 7 days.
- People list sortable by first name, last name, birthday or email (click the column header); default sort is by birthday.
- People can be added manually in the people list.
- "Delete entire list" button with confirmation.
- Optional fully automatic sending at 9:00 a.m.
- Built-in help in the admin area.
- Bilingual: German and English.
- First release.