load_defaults(); // register these boolean fields $RCI->config_props = array( 'ip_check' => 1, 'enable_caching' => 1, 'enable_spellcheck' => 1, 'auto_create_user' => 1, 'smtp_log' => 1, 'prefer_html' => 1, 'preview_pane' => 1, 'htmleditor' => 1, ); // allow the current user to get to the next step $_SESSION['allowinstaller'] = true; if (!empty($_POST['submit'])) { echo '

Copy or download the following configurations and save them in two files'; echo ' (names above the text box) within the config/ directory of your RoundCube installation.
'; echo ' Make sure that there are no characters outside the <?php ?> brackets when saving the files.

'; $textbox = new html_textarea(array('rows' => 16, 'cols' => 60, 'class' => "configfile")); echo '
main.inc.php (download)
'; echo $textbox->show($RCI->create_config('main')); echo '
db.inc.php (download)
'; echo $textbox->show($RCI->create_config('db')); echo '

Of course there are more options to configure. Have a look at the config files or visit Howto_Config to find out.

'; echo '

'; // echo ''; echo "\n
\n"; } ?>
General configuration
product_name
'_product_name', 'size' => 30, 'id' => "cfgprodname")); echo $input_prodname->show($RCI->getprop('product_name')); ?>
The name of your service (used to compose page titles)
skin_path
'_skin_path', 'size' => 30, 'id' => "cfgskinpath")); echo $input_skinpath->show($RCI->getprop('skin_path')); ?>
Relative path to the skin folder
temp_dir
'_temp_dir', 'size' => 30, 'id' => "cfgtempdir")); echo $input_tempdir->show($RCI->getprop('temp_dir')); ?>
Use this folder to store temp files (must be writebale for webserver)
log_dir
'_log_dir', 'size' => 30, 'id' => "cfglogdir")); echo $input_logdir->show($RCI->getprop('log_dir')); ?>
Use this folder to store log files (must be writebale for webserver)
ip_check
'_ip_check', 'id' => "cfgipcheck")); echo $check_ipcheck->show(intval($RCI->getprop('ip_check')), array('value' => 1)); ?>

This increases security but can cause sudden logouts when someone uses a proxy with changeing IPs.

des_key
'_des_key', 'size' => 30, 'id' => "cfgdeskey")); echo $input_deskey->show($RCI->getprop('des_key')); ?>
This key is used to encrypt the users imap password before storing in the session record

It's a random generated string to ensure that every installation has it's own key. If you enter it manually please provide a string of exactly 24 chars.

enable_caching
'_enable_caching', 'id' => "cfgcache")); echo $check_caching->show(intval($RCI->getprop('enable_caching')), array('value' => 1)); ?>
enable_spellcheck
'_enable_spellcheck', 'id' => "cfgspellcheck")); echo $check_caching->show(intval($RCI->getprop('enable_spellcheck')), array('value' => 1)); ?>

It is based on GoogieSpell what implies that the message content will be sent to Google in order to check the spelling.

mdn_requests
'_mdn_requests', 'id' => "cfgmdnreq")); $select_mdnreq->add(array('ask the user', 'send automatically', 'ignore'), array(0, 1, 2)); echo $select_mdnreq->show(intval($RCI->getprop('mdn_requests'))); ?>
Behavior if a received message requests a message delivery notification (read receipt)
Database setup
db_dsnw

Database settings for read/write operations:

'mysql', 'MySQLi' => 'mysqli', 'PgSQL' => 'pgsql', 'SQLite' => 'sqlite'); $select_dbtype = new html_select(array('name' => '_dbtype', 'id' => "cfgdbtype")); foreach ($supported_dbs AS $database => $ext) { if (extension_loaded($ext)) { $select_dbtype->add($database, $ext); } } $input_dbhost = new html_inputfield(array('name' => '_dbhost', 'size' => 20, 'id' => "cfgdbhost")); $input_dbname = new html_inputfield(array('name' => '_dbname', 'size' => 20, 'id' => "cfgdbname")); $input_dbuser = new html_inputfield(array('name' => '_dbuser', 'size' => 20, 'id' => "cfgdbuser")); $input_dbpass = new html_passwordfield(array('name' => '_dbpass', 'size' => 20, 'id' => "cfgdbpass")); $dsnw = MDB2::parseDSN($RCI->getprop('db_dsnw')); echo $select_dbtype->show($RCI->is_post ? $_POST['_dbtype'] : $dsnw['phptype']); echo '
'; echo $input_dbhost->show($RCI->is_post ? $_POST['_dbhost'] : $dsnw['hostspec']); echo '
'; echo $input_dbname->show($RCI->is_post ? $_POST['_dbname'] : $dsnw['database']); echo '
'; echo $input_dbuser->show($RCI->is_post ? $_POST['_dbuser'] : $dsnw['username']); echo '
'; echo $input_dbpass->show($RCI->is_post ? $_POST['_dbpass'] : $dsnw['password']); echo '
'; ?>
db_backend
'_db_backend', 'id' => "cfgdbba")); if (class_exists('DB')) $select_dbba->add('DB', 'db'); if (class_exists('MDB2')) $select_dbba->add('MDB2', 'mdb2'); echo $select_dbba->show($RCI->getprop('db_backend')); ?>
PEAR Database backend to use
IMAP Settings
default_host
The IMAP host(s) chosen to perform the log-in
'_default_host[]', 'size' => 30)); $default_hosts = $RCI->get_hostlist(); if (empty($default_hosts)) $default_hosts = array(''); $i = 0; foreach ($default_hosts as $host) { echo '
' . $text_imaphost->show($host); if ($i++ > 0) echo 'remove'; echo '
'; } ?>
add

Leave blank to show a textbox at login. To use SSL/IMAPS connection, type ssl://hostname

default_port
'_default_port', 'size' => 6, 'id' => "cfgimapport")); echo $text_imapport->show($RCI->getprop('default_port')); ?>
TCP port used for IMAP connections
username_domain
'_username_domain', 'size' => 30, 'id' => "cfguserdomain")); echo $text_userdomain->show($RCI->getprop('username_domain')); ?>
Automatically add this domain to user names for login

Only for IMAP servers that require full e-mail addresses for login

auto_create_user
'_auto_create_user', 'id' => "cfgautocreate")); echo $check_autocreate->show(intval($RCI->getprop('auto_create_user')), array('value' => 1)); ?>

A user is authenticated by the IMAP server but it requires a local record to store settings and contacts. With this option enabled a new user record will automatically be created once the IMAP login succeeds.

If this option is disabled, the login only succeeds if there's a matching user-record in the local RoundCube database what means that you have to create those records manually or disable this option after the first login.

sent_mbox
'_sent_mbox', 'size' => 20, 'id' => "cfgsentmbox")); echo $text_sentmbox->show($RCI->getprop('sent_mbox')); ?>
Store sent messages is this folder

Leave blank if sent messages should not be stored

trash_mbox
'_trash_mbox', 'size' => 20, 'id' => "cfgtrashmbox")); echo $text_trashmbox->show($RCI->getprop('trash_mbox')); ?>
Move messages to this folder when deleting them

Leave blank if they should be deleted directly

drafts_mbox
'_drafts_mbox', 'size' => 20, 'id' => "cfgdraftsmbox")); echo $text_draftsmbox->show($RCI->getprop('drafts_mbox')); ?>
Store draft messages is this folder
SMTP Settings
smtp_server
'_smtp_server', 'size' => 30, 'id' => "cfgsmtphost")); echo $text_smtphost->show($RCI->getprop('smtp_server')); ?>
Use this host for sending mails

To use SSL connection, set ssl://smtp.host.com. If left blank, the PHP mail() function is used

smtp_port
'_smtp_port', 'size' => 6, 'id' => "cfgsmtpport")); echo $text_smtpport->show($RCI->getprop('smtp_port')); ?>
SMTP port (default is 25; 465 for SSL)
smtp_user/smtp_pass
'_smtp_user', 'size' => 20, 'id' => "cfgsmtpuser")); $text_smtppass = new html_passwordfield(array('name' => '_smtp_pass', 'size' => 20, 'id' => "cfgsmtppass")); echo $text_smtpuser->show($RCI->getprop('smtp_user')); echo $text_smtppass->show($RCI->getprop('smtp_pass')); ?>
SMTP username and password (if required)

'_smtp_user_u', 'id' => "cfgsmtpuseru")); echo $check_smtpuser->show($RCI->getprop('smtp_user') == '%u' || $_POST['_smtp_user_u'] ? 1 : 0, array('value' => 1)); ?>

smtp_log
'_smtp_log', 'id' => "cfgsmtplog")); echo $check_smtplog->show(intval($RCI->getprop('smtp_log')), array('value' => 1)); ?>
Display settings & user prefs
locale_string
'_locale_string', 'size' => 6, 'id' => "cfglocale")); echo $input_locale->show($RCI->getprop('locale_string')); ?>
The default locale setting. This also defines the language of the login screen.

Enter a RFC1766 formatted locale name. Examples: en_US, de, de_CH, fr, pt_BR

pagesize *
'_pagesize', 'size' => 6, 'id' => "cfgpagesize")); echo $input_pagesize->show($RCI->getprop('pagesize')); ?>
Show up to X items in list view.
prefer_html *
'_prefer_html', 'id' => "cfghtmlview", 'value' => 1)); echo $check_htmlview->show(intval($RCI->getprop('prefer_html'))); ?>
preview_pane *
'_preview_pane', 'id' => "cfgprevpane", 'value' => 1)); echo $check_prevpane->show(intval($RCI->getprop('preview_pane'))); ?>
htmleditor *
'_htmleditor', 'id' => "cfghtmlcompose", 'value' => 1)); echo $check_htmlcomp->show(intval($RCI->getprop('htmleditor'))); ?>
draft_autosave *
'_draft_autosave', 'id' => 'cfgautosave')); $select_autosave->add('never', 0); foreach (array(3, 5, 10) as $i => $min) $select_autosave->add("$min min", $min*60); echo $select_autosave->show(intval($RCI->getprop('draft_autosave'))); ?>

*  These settings are defaults for the user preferences

failures ? 'disabled' : '') . ' />

'; ?>