Meta: retire old functions in functions.php

[yookoala]

Problem

There are roughly 4 types of functions in functions.php:

1. Old style database reading functions with old school $guid and/or $connection2 (\PDO) as parameter.
2. HTML element rendering.
3. Utility functions for formatting (e.g. email body sanitation) or other helper functions (e.g. resolving client IP address).
4. Shortcut for accessing core service feature (e.g. (), n(), __m()).

The first type of function cause usage of all the global $guid and $connection2, which is an anti-pattern when transiting to service container architecture.

Proposed Solution

1. The first type should be rewritten into Gateway service method (or, in some case, rewritten as service provider).
2. The second type should be rewritten into Form component or other Outputable class.
3. The thrid type can be rewritten as static methods of some utility classes.
4. The forth type can be left as-is for now.

In the rewrite, all obsoleted functions should not be removed for now. Instead, they are to be marked deprecated in their phpdocs doc-block. Modern IDE (e.g. VSCode) will identify the deprecated function calls and warn developers.

Alternatives

Leaving things as-is.

Additional Context

Functions to refactor:

• [ ] getIPAddress
• [x] emailBodyConvert (#1683)
• [x] __ (should be left alone)
• [x] __n (should be left alone)
• [x] __m (should be left alone)
• [ ] renderGradeScaleSelect
• [x] archiveNotification (#1662)
• [x] daysUntilNextBirthday (#1684)
• [x] is_leap_year (#1684)
• [x] doesPasswordMatchPolicy (#1685)
• [x] getPasswordPolicy (#1685)
• [ ] getFastFinder
• [x] getAlert (#1663)
• [ ] getSalt
• [ ] getUnit
• [ ] getWeekNumber
• [x] getEditor (#1648)
• [ ] getYearGroups
• [ ] getYearGroupsFromIDList
• [x] getTerms (#1664)
• [x] msort (#1752)
• [ ] getMaxUpload
• [ ] htmlPrep
• [x] getHighestMedicalRisk (#1667, #1690)
• [ ] getHighestGroupedAction (#1666)
• [x] getRoleCategory (#1682)
• [ ] isSchoolOpen
• [ ] getAlertBar
• [ ] getSystemSettings
• [ ] setLanguageSession
• [ ] isActionAccessible
• [x] isModuleAccessible (77cb3ed)
• [ ] getModuleName
• [ ] getActionName
• [ ] checkModuleReady
• [ ] getModuleCategory
• [x] setCurrentSchoolYear (#1669, #1688)
• [x] nl2brr (#1696)
• [x] getPreviousSchoolYearID (#1669)
• [x] geteNextSchoolYearID (#1669)
• [x] getNextYearGroupID (#1670)
• [x] getNextFormGroupID (#1671)
• [x] getLastYearGroupID (#1670)
• [x] randomPassword (#1700)
• [ ] getModuleID
• [ ] getModuleIDFromName
• [ ] isCommandLineInterface
• [x] returnProcess (#1243)

[SKuipers]

Amazing, thanks for getting this initiative underway and documenting it so well 😃