2.3.7. Implementing a settings screen for your module

Note: this feature is only available for modules that use the multiple file module structure

Some modules that you write might need to store settings for later use. For those, you can create a settings page that can be accessed from the "Modules" page in the admin interface.

The settings page must be put in your module's directory by the name of "settings.php". So for our example module "foo" the file would go in {phorum dir}/mods/foo/settings.php. In the admin interface under the option "Modules", a link to the settings.php page will automatically be added if the settings.php file is available for your module.

Although you can do anything you want in your settings.php script, it is recommended that you use the tools that are handed to you by Phorum for building pages and storing settings.
If the standard tools are not enough for building your settings page, then it is of course fine to do things differently (e.g. let your module create and use database tables or build the full settings interface using your own form code.)

2.3.7.1. Building input forms

The Phorum PHP object "PhorumInputForm" can be used to build input forms and table displays in the admin interface. The best thing you can do for learning the possibilities of this class is to look at other Phorum modules (like "bbcode" or "replace") or the core admin scripts from the {phorum dir}/include/admin directory.