Skip to content

Jethro v2.14.1

Compare
Choose a tag to compare
@tbar0970 tbar0970 released this 14 Feb 23:59
· 1441 commits to master since this release

Version 2.14 is a major new release of Jethro, with a bunch of new features sponsored by the Anglican Diocese of Sydney Professional Standards Unit, Christ Church Inner West, Coast Evangelical church and Easy Jethro.

2.14.1 fixes some problems with the upgrade process, and one bug (Issue #127)

New Features

Custom Fields

  • These replace the previous "date fields". Pre-existing date fields are converted into custom fields, along with their data.
  • Administrators can configure text, option and date fields (see Admin > Custom Fields)
  • Users can view/edit custom field values when viewing/editing a person
  • Custom fields can be set in bulk by action plans or the bulk-action tool
  • Can displayed in reports and used in report filters
  • This feature is useful for storing extra details such as dates of birth, allergies, certifications etc.

Note Templates

  • Administrators can configure "note templates" containing certain fields (see Admin > Note Templates)
  • The fields in a note template can be custom fields for a person (see above), or standalone fields within the note template.
  • When a user is adding a note to a person, they can select a template and will be prompted to fill in that template's fields
  • The field values are saved into the note along with any freeform text entered by the user.
  • If the template refers to custom fields, the new custom field values are saved against the person record.
  • This feature is useful for incident reports, training reports etc - any time when you want to make sure a note contains certain information.

Other Enhancements

Attendance

  • The attendance statistics page now breaks down attendance by age bracket as well as status.
  • When recording or displaying attendance, you can now filter by multiple statuses (person status or group membership status) as well as multiple age brackets
  • The config file setting for attendance order (ATTENDANCE_LIST_ORDER) can now be set to sort by group membership status when group attendance is being recorded. See the sample config file for details.
  • The headcount field now has an increment button to aid on-the-spot counting.

Reports

  • Reports that involve groups can now sort the results by group membership status.
  • Saving a report now works slightly differently, so it's possible to change the name of a report when saving it.
  • Reports can now be saved "for me only" rather than for all users.

Services

  • Service Program:
    • The service program page, now labelled Services > List All, has been improved, and is now the entry point for everything related to services.
    • When editing the service program, a "bulk populate" tool now allows you to quickly fill in the "topic" of every service displayed.
  • Service Documents:
    • Service documents are now generated via the service program page. Click the arrow next to the applicable row in the service program and select the applicable option.
    • A service's handout content (based on the run sheet) can now be included in the service document using the keyword %SERVICE_CONTENT%
  • Service Run Sheets
    • To view or edit a run sheet, you now simply click the relevant cell in the service program. (There is no longer the need to choose the exact date and congregation.)
    • When editing a run sheet it is now possible to add "ad hoc" items which are not based on a component from the library. Click the arrow next to any item in the run sheet and select "Add ad-hoc item below".
    • Some properties of items in run sheets can now be altered on the fly. Click the arrow next to the item in the run sheet and select "Edit item details".
    • When editing a run sheet, the service's details (topic, bible readings etc) are now displayed in compact form at the top of the page for reference.
    • It is now possible to have a roster view displayed at the top of run sheets. Edit the relevant roster view and set "show on run sheet" to "Yes". The roster assignments in this roster view will then show at the top of run sheets for the applicable congregation(s).
    • Service run sheets now have a "comments" field at the bottom
    • Service run sheets now have a "Personnel" column. You can type into this column manually and/or it can be automatically populated with a keyword from the service component.
      Service Components:
    • Service components' "show in handout" field now has three options, which allow you to show the title and content, title only, or nothing.
    • Service components' "is numbered" field has been removed - everything that's shown on the handout is now numbered.
    • Service and roster keywords, used in service documents and service components, can now show just firstnames - eg "%SERVICE_LEADER_FIRSTNAME%.

Members Interface

  • The members interface homepage now includes a persons searchbox
  • If photos are enabled in the system, members can now upload their own photo and view other people's photos.

Other

  • Action plans can now set persons' status, age bracket and congregation as well as custom fields.
  • Home phone number is now shown in the family list, when there is room on the screen.
  • A config file setting now allows congregation-restricted users to still add persons and families. (RESTRICTED_USERS_CAN_ADD)
  • Error messages no longer show technical details unless a config file setting is enabled (SHOW_ERROR_BACKTRACES)
  • All locks held by a user are now released when they log out.

Bugfixes

  • Issue #121 - Attendance 'extras' were sometimes calculated wrongly
  • Issue #61 Problem with zend guard loader and autoload and static calls fixed
  • Issue #101 - Editing the service program, services that had bible readings but no topic sometimes didn't save. Now fixed.
  • Issue #100 - The "bible texts to preach" column in a roster view was showing all bible readings. Now fixed.
  • Adding an additional value for a date field from an action plan used to wipe out old values. Now fixed.
  • Non-public rosters could be viewed by non-logged in users via URL hacking. Now fixed.
  • Misaligned footers in some attendance displays are now fixed.

Upgrade Procedure

  1. Log out of Jethro (otherwise your user session won't match the new code)
  2. Take a backup of your mysql database
  3. Move away your old Jethro files (eg rename your jethro folder to jethro_old)
  4. Unzip the new files into the right place (don't just overwrite the old files)
  5. If upgrading from a version older than 2.13, apply any applicable upgrade SQL files from the upgrades folder to your mysql database
  6. Apply upgrades/2015_upgrade_to_2.14.sql to your mysql database
  7. Log in and test. In particular, if you use date fields, make sure they have been converted into custom fields correctly. If there are any problems with the field configuration or field values, roll back to the old version and lodge an issue on github.

Troubleshooting

If you need assistance with upgrading or have found a bug, please open an issue on github: https://github.com/tbar0970/jethro-pmm/issues/new