[fiammybe]

Requested by David · project thread

Summary

Phase 0 of the imforum plan: an empty module that installs and updates on ImpressCMS 2.0 in IPF mode, with CI on PHP 8.2 to 8.5. No forum functions yet; those start with the data model in phase 1.

• src/icms_version.php: modname and dirname are both imforum. object_items is an empty array, which is enough for the core to set ipf = 1 and register src/class under mod_imforum (libraries/icms/module/Object.php).
• src/include/common.php: defines IMFORUM_DB_VERSION. The core reads it with constant() and no defined() check during install and update (icms_db_legacy_updater_Handler::moduleUpgrade), so it has to exist from the start.
• src/include/onupdate.php: has the icms_module_install_imforum / icms_module_update_imforum entry points and an empty imforum_db_upgrade_1(), which will create the indexes in phase 1. It also creates uploads/imforum with mode 0755 (iForum used 0777). The docblock explains why fields must be renamed over two releases: the updater drops undeclared columns before the upgrade functions run.
• A placeholder user index and an admin index, each with a template.
• English and Dutch language files (language/nederlands, the folder name the core uses), plus crowdin.yml with the core's language folder names.
• New icons, generated from scratch. Nothing is copied from iForum: iForum is GPL and this repository is MIT.

Tooling

• .github/workflows/ci.yml runs on PHP 8.2, 8.3, 8.4 and 8.5. It does php -l, then PHPStan level 6 against a checkout of fiammybe/impresscms (scanned only for signatures), then PHPUnit.
• The unit tests check that icms_version.php matches what the core expects: names, referenced files, templates and the db version. They also check that an upgrade function exists for every db version, that the upload folder is not world-writable, and that Dutch defines exactly the same constants as English.

Testing

All of this was run locally on PHP 8.3:

• php -l is clean on every file.
• PHPUnit passes: 12 tests, 40 assertions.
• PHPStan level 6 against the ImpressCMS 2.0.4 Beta core reports no errors.

Not tested: a real install and update on a running ImpressCMS 2.0 with MySQL, because there was no database in this environment. Please install the module once by hand to confirm.

---

Generated by Claude Code