Jethro v2.37.0

Enhancements

• #1199 and #1202 - reports can now filter on custom field dates much more powerfully
• #1271 - ability to copy ad hoc items from previous service run sheets
• #1131 - contact remarks field now shown when creating a family
• #1168 - slightly more flexible date format allowed in importer
• #1130 - mobile numbers now show links to send whatsapp message
• #1219 - global flag to enable/disable 2FA
• #1270 - extra keywords available in service component templates
• #1276 - allow searching for songs by CCLI number
• #1278 - extra explanation of when it's necessary to create more services
• #1290 - service component library now shows when components have been used, and has quick link to delete or disable a component
• #1282 - when importing service components, can now match existing components based on title
• #1315 - improved documentation of keywords available in service component titles and personnel
• #1332 - can search for service components by CCLI number
• #884 - enhanced navigation between services in run sheet editor
• Run sheet editor now has a cancel button

Bugfixes

• #1087 - creator of a person now always visible
• #1120 - ensure there is always an 'archived' status
• #1198 - fixed problem with auto-update of roster assignment timestamps
• #1206 - fixed error during DOCX export
• #1213 - Corrected SMS max length
• #1151 - archived persons now shown in grey in global search results
• #1173 - fix family editing in members interface when some family members are hidden
• #1241 - fix problems recording attendance if a selected congregation has no persons to show
• #1243 - prevent data being wiped if the members area edit-family form is submitted after a session timeout
• #1247 - fix error when trying to create a document without HTML extension
• #1230 - improve handling of certain errors
• #1256 - fix problem where input validation errors were hidden in certain system configs
• #1235 - fix errors after session timeout in some circumstances
• #1252 - prevent action plan failures if a group no longer exists to remove people from
• #1232 - layout fix with long field names
• #1267 - better handling of imperfectly formed CSV import files
• #1197 - csv importer's status column now case insensitive
• #1272 - ensure the existence of a run sheet is visible in all circumstances
• #1259 - better handle situation where the exif php extension is missing
• #1221 - fix problem sending sms in PHP8
• #1239 - fix problems recording attendance in PHP8
• #1215 - prevent PHP warnings
• #1237, #1250 - avoid PHP8 deprecation warmings in the browser
• Library upgrades for PHP8 compatibility
• Layout fixes on home page
• Don't show 'add to home screen' prompt on desktop safari
• #1334 - ensure only relevant folders shown in members area documents page
• Fixed sample service component import
• #1302 - showing song list in a roster failed in some circumstances
• #1316 - better handling of malformed keywords in run sheet personnel
• #1227 - fixed link to CCLI website
• #1326 - ensure the rename-folder function can't create folders in unauthorised places
• #1292 - (bug during RC process) searching for song by title fixed
• #1298 - ensure the enter button doesn't do the wrong thing in service schedule page
• #1291 - fixed JS error in component library page
• #1272 - ensure the service schedule correctly indicates whether a service has a run sheet
• #1265 - better handle invalid numeric values in service component importer

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2025-upgrade-to-2.37.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
7. Log in and test.

Jethro v2.37.0-RC3

Enhancements

• #1199 and #1202 - reports can now filter on custom field dates much more powerfully
• #1271 - ability to copy ad hoc items from previous service run sheets
• #1131 - contact remarks field now shown when creating a family
• #1168 - slightly more flexible date format allowed in importer
• #1130 - mobile numbers now show links to send whatsapp message
• #1219 - global flag to enable/disable 2FA
• #1270 - extra keywords available in service component templates
• #1276 - allow searching for songs by CCLI number
• #1278 - extra explanation of when it's necessary to create more services
• #1290 - service component library now shows when components have been used, and has quick link to delete or disable a component
• #1282 - when importing service components, can now match existing components based on title
• #1315 - improved documentation of keywords available in service component titles and personnel
• #1332 - can search for service components by CCLI number
• #884 - enhanced navigation between services in run sheet editor
• Run sheet editor now has a cancel button

Bugfixes

• #1087 - creator of a person now always visible
• #1120 - ensure there is always an 'archived' status
• #1198 - fixed problem with auto-update of roster assignment timestamps
• #1206 - fixed error during DOCX export
• #1213 - Corrected SMS max length
• #1151 - archived persons now shown in grey in global search results
• #1173 - fix family editing in members interface when some family members are hidden
• #1241 - fix problems recording attendance if a selected congregation has no persons to show
• #1243 - prevent data being wiped if the members area edit-family form is submitted after a session timeout
• #1247 - fix error when trying to create a document without HTML extension
• #1230 - improve handling of certain errors
• #1256 - fix problem where input validation errors were hidden in certain system configs
• #1235 - fix errors after session timeout in some circumstances
• #1252 - prevent action plan failures if a group no longer exists to remove people from
• #1232 - layout fix with long field names
• #1267 - better handling of imperfectly formed CSV import files
• #1197 - csv importer's status column now case insensitive
• #1272 - ensure the existence of a run sheet is visible in all circumstances
• #1259 - better handle situation where the exif php extension is missing
• #1221 - fix problem sending sms in PHP8
• #1239 - fix problems recording attendance in PHP8
• #1215 - prevent PHP warnings
• #1237, #1250 - avoid PHP8 deprecation warmings in the browser
• Library upgrades for PHP8 compatibility
• Layout fixes on home page
• Don't show 'add to home screen' prompt on desktop safari
• #1334 - ensure only relevant folders shown in members area documents page
• Fixed sample service component import
• #1302 - showing song list in a roster failed in some circumstances
• #1316 - better handling of malformed keywords in run sheet personnel
• #1227 - fixed link to CCLI website
• #1326 - ensure the rename-folder function can't create folders in unauthorised places
• #1292 - (bug during RC process) searching for song by title fixed
• #1298 - ensure the enter button doesn't do the wrong thing in service schedule page
• #1291 - fixed JS error in component library page
• #1272 - ensure the service schedule correctly indicates whether a service has a run sheet
• #1265 - better handle invalid numeric values in service component importer

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2025-upgrade-to-2.37.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
   1 Compare your old conf.php to a new conf.php.sample.* file and add any new settings to your conf.php
7. Log in and test.

v2.37.0-RC1

Enhancements

• #1199 and #1202 - reports can now filter on custom field dates much more powerfully
• #1271 - ability to copy ad hoc items from previous service run sheets
• #1131 - contact remarks field now shown when creating a family
• #1168 - slightly more flexible date format allowed in importer
• #1130 - mobile numbers now show links to send whatsapp message
• #1219 - global flag to enable/disable 2FA
• #1270 - extra keywords available in service component templates
• #1276 - allow searching for songs by CCLI number
• #1278 - extra explanation of when it's necessary to create more services

Bugfixes

• #1087 - creator of a person now always visible
• #1120 - ensure there is always an 'archived' status
• #1198 - fixed problem with auto-update of roster assignment timestamps
• #1206 - fixed error during DOCX export
• #1213 - Corrected SMS max length
• #1151 - archived persons now shown in grey in global search results
• #1173 - fix family editing in members interface when some family members are hidden
• #1241 - fix problems recording attendance if a selected congregation has no persons to show
• #1243 - prevent data being wiped if the members area edit-family form is submitted after a session timeout
• #1247 - fix error when trying to create a document without HTML extension
• #1230 - improve handling of certain errors
• #1256 - fix problem where input validation errors were hidden in certain system configs
• #1235 - fix errors after session timeout in some circumstances
• #1252 - prevent action plan failures if a group no longer exists to remove people from
• #1232 - layout fix with long field names
• #1267 - better handling of imperfectly formed CSV import files
• #1197 - csv importer's status column now case insensitive
• #1272 - ensure the existence of a run sheet is visible in all circumstances
• #1259 - better handle situation where the exif php extension is missing
• #1221 - fix problem sending sms in PHP8
• #1239 - fix problems recording attendance in PHP8
• #1215 - prevent PHP warnings
• #1237, #1250 - avoid PHP8 deprecation warmings in the browser
• Library upgrades for PHP8 compatibility
• Layout fixes on home page
• Don't show 'add to home screen' prompt on desktop safari

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2025-upgrade-to-2.37.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
   1 Compare your old conf.php to a new conf.php.sample.* file and add any new settings to your conf.php
7. Log in and test.

Jethro v2.36.1

This version adds a bunch of bugfixes and a range of small enhancements.

Enhancements

• #1104 - Reports can now filter on "has a family member in group X"
• #1107 - Roster lock is now released when you change to view mode
• #1126 - Attendance sorting now allows for 'status then last name'
• #999 - Various import paramters are now sticky
• #158 - When entering bible readings, 'to preach' is now ticked by default
• #1140 - In person reports, age brackets and custom date/select fields no longer line-wrap
• #1032 - hint about using person reports to analyse attendance
• #1067 - system-wide statistics now shows per-congregation stats too.
• #574 - new link to quickly create a report showing members of a group
• #602 - you can now delete person/family photos.
• #1191 - linked url in a richtext field is now shown in full unless it's super long.
• "Lock is held by someone else" message now gives more details

Bugfixes

• #1114 - fixes to issues with the 2.36 upgrade for certain system configurations
• #1116 - fixes to issues with the 2.36 upgrade when action plans referred to statuses
• #1127 - sorting in reports and attendance is now consistent
• #1055 - Search form no longer visible when printing
• #1101 - New reports exclude archived persons by default
• #1123 etc - Various tweaks to comply with latest PHP version
• Notes for future action now sorted correctly
• #1042 - Can now remove the last attendance record for a date
• #1120 - Ensure there is at least one 'archived' status
• #1158 - No longer errors if a custom report has no results
• #1157 - No longer errors if a report tries to group by a custom field that no longer exists
• #1161 - Can now handle documents with square brackets in their filename
• #1170 - Can now handle documents with an ampersand in their filename
• #1174 - Fixed access vulnerability for member files
• #353 - Empty paragraphs are trimmed from service component content
• #1164 - Fixed MySQL errors in certain versions/configs where the 'rank' keyword is special
• Layout improvement on home page
• #1163 - No longer errors if you try to add a duplicate group membership status
• #1195 - No longer errors when you "archive and cleanse" a person
• #1196 - When asking to delete a person, the 'archive' button now works correctly
• #1194 - If there are no person reports saved, but there are custom reports configured, the custom reports are now shown correctly.

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database, especially if upgrading from a version older than 2.36.0
3. If upgrading from a version older than 2.36.0: Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2025-upgrade-to-2.36.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
   1 Compare your old conf.php to a new conf.php.sample.* file and add any new settings to your conf.php
7. Log in and test.

Credits

Thanks to @jefft and @radarhere for contributions to this release.

Jethro v2.36.0

Jethro v2.36.0 includes a few new features and lots of bugfixes.

Enhancements

• #1035 - Person status options are now much more flexible (see upgrade note)
• #890 - Configurable sort order for attendance recording
• #1040 - You can now hide the age bracket field in the members area
• #1075 - Ability to edit group membership is now determind by the "Groups" permission level.
• #1103 - improved import error messages
• #1045 - improved dimensions of printable run sheet

Bugfixes

• #1086 - fixed bulk update tool causing inadvertent changes to age bracket. (see upgrade note)
• #1036 - fixed run sheet component sorting
• #1046 - fixed family member edits
• #1050 - fixed errors in log when displaying 'date totals' attendance
• #1052 - improved robustness of report config for custom fields
• #1057 - fixed an issue where sometimes roster assignees couldn't be removed
• #1065 - removed ical feed 6-week limit
• #1072 - fixed error when sms log file does not exist
• #1078 - fixed situation where occasionally roster assignees did not show up
• #1064 - fixed unwanted line break in service summary
• #1056 - improved clarity for the roster summary
• #1048 - fixed errors in roster summary if no roster roles included
• #1088 - fixed premature session timeouts.
• #1085 - PHP8 compatibility
• #1054 - fixed contact list DOCX export
• #1091 - fixed error when deleting a congregation under some circumstances
• #1069 - fixed issue with notes for action attached to empty families
• #1090 - improved layout of run sheet notes

Technical changes

• 2FA_ settings are hard-codable in conf.php
• Improvements to configuration of the roster reminder script
• Fix to premature session timeouts
• #745 - file permissions in release
• #1099 - PHP8 compatibility

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2024-upgrade-to-2.36.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
7. Optional: Run php upgrades/2024-upgrade-to-2.36-after.php from the command line. Jethro will run this upgrade automatically when you log in, but you may prefer to do it from the command line in advance.
8. Optional: Run php upgrades/upgradefixes/2024-2.36-check-age-brackets.php from the command line. This script checks for person records affected by Issue #1086. Jethro will run this check when a system administrator logs into the system, but you may prefer to do it from the command line in advance.
9. Log in and test.

Jethro v2.36.0-RC2

Further polishing of v2.36.0-RC1
Includes a packaging fix to resolve some malformed CSS that was produced by LESSC.

Jethro v2.36.0 RC1

This is a release candidate, not yet ready for widespread production use.

Enhancements

• #1035 - Person status options are now much more flexible (see upgrade note)
• #890 - Configurable sort order for attendance recording
• #1040 - You can now hide the age bracket field in the members area
• #1075 - Ability to edit group membership is now determind by the "Groups" permission level.

Bugfixes

• #1086 - fixed bulk update tool causing inadvertent changes to age bracket. (see upgrade note)

• #1036 - fixed run sheet component sorting

• #1046 - fixed family member edits

• #1050 - fixed errors in log when displaying 'date totals' attendance

• #1052 - improved robustness of report config for custom fields

• #1057 - fixed an issue where sometimes roster assignees couldn't be removed

• #1065 - removed ical feed 6-week limit

• #1072 - fixed error when sms log file does not exist

• #1078 - fixed situation where occasionally roster assignees did not show up

• #1064 - fixed unwanted line break in service summary

• #1056 - improved clarity for the roster summary

• #1048 - fixed errors in roster summary if no roster roles included

• #1088 - fixed premature session timeouts.

• #1085 - PHP8 compatibility

• #1054 - fixed contact list DOCX export

• #1091 - fixed error when deleting a congregation under some circumstances

• #1069 - fixed issue with notes for action attached to empty families

• #1090 - improved layout of run sheet notes

• Technical changes

• 2FA_ settings are hard-codable in conf.php

• Improvements to configuration of the roster reminder script

• Fix to premature session timeouts

• #745 - file permissions in release

• #1099 - PHP8 compatibility

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2024-upgrade-to-2.36.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
7. Optional: Run php upgrades/2024-upgrade-to-2.35-after.php from the command line. Jethro will run this upgrade automatically when you log in, but you may prefer to do it from the command line in advance.
8. Optional: Run php upgrades/upgradefixes/2024-2.36-check-age-brackets.php from the command line. This script checks for person records affected by Issue #1086. Jethro will run this check when a system administrator logs into the system, but you may prefer to do it from the command line in advance.
9. Log in and test.

Jethro v2.35.1

This minor release does some polishing to v2.35.0
See the 2.35.0 release notes for the major new features.

Enhancements

#1028 - better display of song details in rosters
#1029 - better page titles
#1020 - enhanced layout of service content

Bug Fixes

#1033 - archived system administrators are no longer sent 2FA-related notifications
#1030 - age-bracket groupings in reports are now ordered correctly
#466 - default age bracket is applied on add-family page
#1023 - Mail merge on grouped report fixed
#1021 - Better handling of situation where 2FA_SENDER_ID is not set

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. If upgrading from a version older than 2.35.0, apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2024-upgrade-to-2.35.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
7. Log in and test.

Jethro v2.35.0

New Features

• #925 - Configurable two-factor authentication for enhanced security
• #25 - Song usage report. You can now see how many times songs have been used in services and easily click through to report usage to CCLI.
• #889 - Jethro can now display the cost of sending out an SMS message based on its length and the number of recipients.
• #1011 - When Jethro sends out emails (eg for member rego, or various reminders), you can now apply a system-wide "from" address, to ensure DMARC compliance.
• #788 - Custom reports. You can save custom SQL queries on your server and view the results in Jethro.
• The bottom of a roster now shows a workload analysis - how many times each person has been allocated.

Bug Fixes

• #960 - Group names/membership status were sometimes repeated in report results
• #976 - Problem when pasting values into email address field
• #971 - "attendance days" field was hidden when editing/viewing a group
• #959 - Copy button in roster's "email all" modal was not working
• #955 - "Title" field was sometimes not shown when adding an ad-hoc run sheet item
• #956 - Service component were not visible whilst being dragged on to a run sheet
• #958 - Layout of personnel on printable run sheet was uneven
• #985 - Better handling of situation where user tries to create an HTML doc with the wrong extension
• #994 - yearless values in custom date fields were not working in recently-installed systems
• #1002 - Importer better handles situation where multiple import rows match the same existing person
• #1001 - In system config, age brackets, unticking 'is adult' did not save
• #992 - Cleaned up document download filenames
• #946 - Improved layout of attendance running total
• #1008 - Attendance headcount was not saving if nobody was marked present/absent
• #1009 - Fixed error when you ran document merge on some persons in a report
• #777 - issue with counting of sms characters
• #400 - issue with pasting rich text into sms box
• #1010 - when sms is saved as note, it had status=requires action.
• #937 - non-adult family members were wrongly able to edit other members' details; now they can't.
• #1014 - timestamp of roster assignments was being updated when they weren't changed.
• #1015 - list of reports looked funny on mobile
• #1016 - roster_reminder didn't work if USER_MOBILE was used in SMS config.
• Various page layout improvements in the members area and elsewhere.
• #1022 - error when adding family (in 2.35.0-RC)
• #1026 - errors sending automated emails (in 2.35.0-RC)

Behind-the-scenes improvements

• Version checker now checks for the latest release of Jethro.
• #936 - Improved php8 compatibility
• #947 - better handling of temp files
• #950 - Better warnings about too-large uploads
• #963 - improve mysql 8+ compatibility
• #982 - Fix handling of 'permanently deleted' people in Mailchimp audiences
• #979 - Fix error in log when viewing attendances
• #1006 - Error when sms.log first written
• #1000 - Improved error message if conf.php has wrong permissions

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. Apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2024-upgrade-to-2.35.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
7. Log in and test.

Jethro 2.34.1

This maintenance release resolves various issues in 2.34.0

Bugfixes

• #947 - better cleanup of temp files on server
• #960 - Reports showing group-related columns sometimes showed repeated values
• #976 - problem pasting into email fields
• #971 - 'attendance days' field was hidden when adding/editing a group
• #959 - 'copy' button in 'email-all' popup wasn't working
• #963 - database upgrade errored on some mysql versions due to 'rank' keyword
• #955 - when editing an ad-hoc run sheet item, 'title' field was sometimes not visible
• #956 - service components weren't visible whilst being dragged to a run sheet
• #958 - layout of personnel in columns on run sheet has been improved

Enhancements

• If an uploaded photo is too big, the user is now told what the limit is.

Upgrade Procedure

1. Log out of Jethro
2. Take a backup of your mysql database
3. If upgrading from a version older than 2.34.0, apply all applicable upgrade SQL files from the upgrades folder to your mysql database, including upgrades/2023-upgrade-to-2.34.sql
4. Move away your old Jethro files (eg. rename your jethro folder to jethro_old)
5. Unzip the new files into the right place (don't just overwrite the old files)
6. Move your old conf.php and files/ subdirectory (if not empty) back into your jethro folder.
7. Log in and test.