BirthdayList

This plugin creates birthday or anniversary lists. Based on the date of birth or the date of joining the organization, lists can be generated for milestone birthdays (e.g., 40th, 50th, or 60th birthday) or anniversaries (e.g., 25th, 40th, or 60th anniversary).

Older versions:
geburtstagsliste_3.4.1.zip - (Admidio 4.3)
geburtstagsliste_3.3.0.zip - (Admidio 4.2)
geburtstagsliste_3.1.0.zip - (Admidio 4.0)
geburtstagsliste_2.3.3.zip - (Admidio 3.3)
geburtstagsliste_2.2.2.zip - (Admidio 3.2)
geburtstagsliste_2.1.1.zip - (Admidio 3.1)
geburtstagsliste_2.0.2.zip - (Admidio 3.0)
geburtstagsliste_1.3.5.zip - (Admidio 2.4)

Managed by: rmb

Plugin version: 4.0.0

Required Adminidio version: 5.0

Supported databases: MySQL, PostgreSQL (from Admidio 4.3.14 onwards)

Supported languages: German, English, French

License: GPL 2

Source code: GitHub

• Unpack the file geburtstagsliste_x.x.x into the folder adm_plugins
• Log in to Admidio
• Installing a plugin version < 4.0.0
  • Create a menu item for the birthday list via the Admidio module menu with the following URL:
    /adm_plugins/birthday_list/birthday_list.php
  • The installation routine is executed the first time the plugin is started.
• Installing a plugin version >= 4.0.0
  • To install, run the following PHP file:
    <your-admidio-page>/adm_plugins/BirthdayList/system/install.php

• Update from plugin version 3.x to plugin version 3.y
  • Replace all files in the existing plugin folder with the files of the new version.
• Update from a plugin version < 3.0.0 to a plugin version >= 4.0.0
  • Important Note: Updates for plugin versions lower than v3 are not supported.
• Update from plugin version 3.x to plugin version >= 4.0.0
  • Delete the existing menu item via the Adminidio module menu
  • To install, run the following PHP file:
    <your-admidio-site>/adm_plugins/BirthdayList/system/install.php

4.0.0 (16.11.2025)

• All changes to this version on GitHub

3.4.1 (13.02.2025)

• All changes to this version on GitHub

3.4.0 (14.01.2024)

• All changes to this version on GitHub

3.3.0 (18.01.2023)

• All changes to this version on GitHub
  
• Important Note: With this update, the main script “geburtstagsliste.php” has been renamed to “birthday_list.php”. The menu entry in Admidio must be adjusted accordingly.

3.2.0 (05.01.2022)

• All changes to this version on GitHub

3.1.0 (12.12.2020)

• All changes to this version on GitHub

3.0.0 (28.10.2020)

• Compatible only with Admidio 4 Beta 1
• All changes to this version on GitHub

2.3.3 (10.05.2020)

• All changes to this version on GitHub

2.3.2 (11.10.2018)

• All changes to this version on GitHub

2.3.1 (23.04.2018)

• All changes to this version on GitHub

2.3.0 (16.04.2018)

• Compatibility with Admidio 3.3
• All changes to this version on GitHub

2.2.2 (04.12.2017)

• All changes to this version on GitHub

2.2.1 (05.05.2017)

• All changes to this version on GitHub

2.2.0 (19.12.2016)

• Compatibility with Admidio 3.2
• All further changes of this version on GitHub

2.1.1 (08.06.2016)

• All changes to this version on GitHub

For changes before version 2.1.1 please look at the german page

This plugin generates birthday and anniversary lists for members. Any number of different configurations can be created via the menu item Settings-Configurations.

In a configuration

• the columns to be displayed (=profile fields),
• the reference date for which this configuration is displayed (the current day or January 1st),
• Date filters (round birthdays or anniversaries)
• or filters based on role affiliations

determined.

Sample birthday list:

The “Configuration selection…” option determines a previously defined configuration as the basis for the display.

After selecting the configuration, you choose how many days (preview days) should be displayed.

Notice: Preview dates are always viewed in relation to a reference date. The reference date can be either the current date or January 1st of any given year.

To ensure that future and past birthdays and anniversaries can be displayed, the following decision was made:

• If birthdays and anniversaries should only be displayed on the reference date (current day or January 1st), then “0” should be selected as the preview date.
• If future birthdays and anniversaries are to be displayed, the number of additional days must be selected as the preview days (e.g. “1” for the current day plus one additional day, ⇒ today and tomorrow).
• If past birthdays and anniversaries are to be displayed, a negative number of days should be selected as the preview days (e.g. “-1” for the current day minus one day in the past, ⇒ yesterday and today).

In addition to preview days, a specific month can be selected.

This is a further filtering of the existing list.

The Preferences menu can be accessed via the button of the same name, which is only visible to administrators.

Here you can create any number of configurations for the birthday list. In the list view, one of these configurations is used as the basis for the display via “Select configuration…”.

After a fresh installation, a sample configuration is pre-configured and populated with default values.

Configuration	Display

The label entered here will appear in the screen display under the selection menu “Select configuration…”. A configuration can be deleted by deleting the contents of the Label field and then clicking the Save button.

Here you select the profile fields that should be displayed as columns in the list view in this configuration.

The test date is the date field used for the calculations (either a profile field of type “date” or, if a role is selected, the start of the role membership).

The display can be filtered by specific values. For example, 30, 40, 50 means that only 30th, 40th, or 50th birthdays or anniversaries will be displayed. If no filtering is desired, the field should be left blank.

The specified text will be appended to the year of birth or anniversary.

The additional text “30th birthday on #Day#.#Month#” could, for example, be displayed as “30th birthday on 10.02.”.

Placeholder

• #Day# = Day
• #Month# = Month
• #Year# = year

Notice:

• To start the supplementary text with a space, this must be specified as a non-breaking space with the code &nbsp; (e.g. &nbsp;ster Geburtstag am #Day#.#Month#).

By selecting roles and categories, a configuration can be restricted to members of the selected roles or to members of roles in the selected categories.

If no restriction is to be applied, both fields (role selection and category selection) should be left blank.

Here you can customize and add to the text of an email. The text is divided into two sections (subject & body) and is identified by the strings #subject# and #content#. The content for each section then follows. Placeholders can be used in each email, which will then be replaced with the corresponding content at runtime.

IMPORTANT: To send emails, the profile field “Email” must be displayed in a column.

Placeholder:

• #user_first_name# = Member's first name
• #user_last_name# = Member's last name
• #organization_long_name# = Organization name
• #config# = Text of the last column (configuration column)

This setting determines the reference date for the display. By default, it starts from the current date. If the display should start from January 1st of the current year, check the box.

This allows the display to be moved forward or backward by x years (0 corresponds to no offset).

Information about the version and status of the plugin is displayed here.

General settings for the plugin can be defined via the options.

Here, the default setting for the preview days is defined.

Enter the dates here that will later be available for selection in the birthday list. Separate multiple entries with commas (e.g., -14,2,5,10,20,30,60,365,1000).

This determines which configuration is displayed when the plugin starts.

Uninstalling the plugin will delete all configuration data created by it.

In addition to the “Administrator” role, other roles can be authorized to access the “Settings” module.

All configuration data is stored in a table named adm_plugin_preferences in the Admidio database. If this table does not exist, it will be created.

The table entries of the BirthdayList plugin all begin with the letters “PGL”.