Site Settings


User Documentation

Main Settings

Site Name


Site Email

The default email that system-generated emails are sent from

Site Status


Items per page




Security Settings

Allow User Registrations?

Activation Method


Login Type

Email Only/Username Only/Email or Username

User display across bonfire


Allow 'Remember Me'?


Password Strength Settings

Set the minimum length of passwords allowed by the system

Password Options

Should password force numbers?

If checked, passwords must include numbers.

Should password force symbols?


Should password force mixed case?

If checked, passwords must include lowercase and uppercase letters.

Display password validation labels

If checked, password validation labels will be displayed.

Password Stretching

See article on password management with phpass

Force Password Resets


Developer Settings

Show Admin Profiler?


Show Front End Profiler?


Extended Settings

See Extended Settings documentation for more information.

Developer Documentation


The Settings library (Settings_lib) acts as an interface to the Settings_model and the system's configuration files. It also manages caching of the settings to reduce the need to access the database and filesystem when reading site settings.


Retrieves the requested setting ($name) from the database. If the setting was not found in the database, it attempts to retrieve it from the config files. Caches the value so subsequent requests will retrieve it from the cache.

set($name, $value, $module='core')

Updates/inserts a setting in the database, and caches the new value.

delete($name, $module='core')

Deletes a setting from the database and removes it from the cache.


Returns all of the settings in the database or the cache. If the cache is not set, initializes the cache with all of the returned settings.

find_by($field, $value)

Attempts to find a setting that matches the given $field/$value pair and caches the returned result.
To retrieve multiple settings that match a $field/$value pair, see find_all_by().


Attempts to Find all settings that match the given $field/$value pair and caches the returned results.
To retrieve a single setting that matches a $field/$value pair, see find_by($field, $value).

settings_item($name) helper method

The settings_item() helper method calls Settings_lib::item($name), and returns the requested setting.