Back to Documentation
Custom authentication
Customise the user authentication with hooks.
Add a second domain name to your email addresses
Let's say you have two addresses user@domain.com, and alias@domain.com, and you want to read emails for user@otherdomain.com, and alias@otherdomain.com. Then add the following to config-site.php:
$config['CUSTOM_EMAIL_QUERY_FUNCTION'] = 'my_custom_func';
function my_custom_func($username = '') {
$a = array($username);
$s = explode("@", $username);
array_push($a, $s[0] . "@otherdomain.com");
return $a;
}
Fix IMAP authentication
This example assumes an IMAP server that expects only the username part without the domain (eg. @example.com). To fix the issue, we append @example.com to all non-@local accounts
$config['CUSTOM_EMAIL_QUERY_FUNCTION'] = 'my_custom_func';
function my_custom_func($username = '') {
if(!strstr($username, '@local')) {
$email = $username . '@example.com';
return array($email);
}
}
Fix IMAP server name based on user domain
Piler also supports a pre authentication hook which runs before any authentication is performed. You define only IMAP_PORT and IMAP_SSL in config-site.php, and set the IMAP_SERVER based on the domain part of the username
$config['ENABLE_IMAP_AUTH'] = 1;
$config['IMAP_PORT'] = 993;
$config['IMAP_SSL'] = true;
$config['CUSTOM_PRE_AUTH_FUNCTION'] = 'my_imap';
function my_imap($username = '') {
global $session;
if(strstr($username, "@domain1.com")) {
define('IMAP_SERVER', 'imap.domain1.com');
} else if(strstr($username, "@domain2.com")) {
define('IMAP_SERVER', 'imap.domain2.com');
} else {
define('IMAP_SERVER', 'imap.somedomain.com');
}
}