6.0.0-git
2024-11-14
Last Modified 2017-11-23 by Jan Schneider

Attachments

 Qfolders90.png

This information is valid for Horde 5 and later only. See AltQuotaH4 for Horde 4 or AltQuotaH3 for Horde 3.

Notes

IMP 6, Horde 5
Modifies basic and dynamic views to display quotas.

This describes modifications to IMP 6 (Horde 5) quota to use two different partitions (file systems) with quota enabled. One is used for INBOX and the other is used for IMAP folders.

This allows different quota values for INBOX and IMAP folders.

It uses modified quota Imap driver and related Imp files.

Tested on Debian 7 (wheezy, stable) with Dovecot (wheezy distribution), Horde 5.1.5-IMP 6.1.6


Modifications

File Variables, Function(s)
imp/config/backends.local.php quota
imp/lib/Quota/Imap.php getQuota
imp/lib/Quota/Ui.php quota
imp/lib/Quota.php construct
imp/lib/Ajax/Queue.php m, p, l, add
imp/lib/View/Subinfo.php construct
imp/js/dimpbase.js r.m, r.l, quotaCallback
imp/templates/basic/subinfo.html.php quotaClass, quotaText
imp/templates/dynamic/mailbox_subinfo.html.php quota-text

Last updated 2014-01-01


Image of IMP showing quotas and 90% warning


Image of IMP showing quotas and 90% warning


Descriptions


Configuration example (imp/config/backends.local.php)

$servers['imap'] = array(
    ...

    'quota' => array(
        'driver' => 'imap',
        'params' => array(
            'hide_when_unlimited' => false,
            'unit' => 'GB'
        )

    ...
);


imp/lib/Quota/Imap.php

  • Function getQuota
$quotavar, usagevar, limitvar.
$quotahome, usagehome, limithome.

Backup your original imp/lib/Quota/Imap.php and create a new Imap.php with the following code:
<?php
/**
 * Copyright 2002-2013 Horde LLC (http://www.horde.org/)
 *
 * See the enclosed file COPYING for license information (GPL). If you
 * did not receive this file, see http://www.horde.org/licenses/gpl.
 *
 * @category  Horde
 * @copyright 2002-2013 Horde LLC
 * @license   http://www.horde.org/licenses/gpl GPL
 * @package   IMP
 * Modified by Mauricio Jose T. Tecles <mtecles@biof.ufrj.br>
 * Updated 2013 December 18
 */

/**
 * Quota driver for IMAP servers.
 *
 * @author    Mike Cochrane <mike@graftonhall.co.nz>
 * @category  Horde
 * @copyright 2002-2013 Horde LLC
 * @license   http://www.horde.org/licenses/gpl GPL
 * @package   IMP
 */
class IMP_Quota_Imap extends IMP_Quota
{
    /**
     * Constructor.
     *
     * @param array $params  Parameters:
     *   - imap_ob: (Horde_Imap_Client_Base) IMAP client object [REQUIRED].
     */
    public function __construct(array $params = array())
    {
        if (!isset($params['imap_ob'])) {
            throw new InvalidArgumentException('Missing imap_ob parameter');
        }

        parent::__construct($params);
    }

    /**
     */
    public function getQuota($mailbox = null)
    {
        try {
            $quotavar = $this->_params['imap_ob']->getQuotaRoot('INBOX');
            $quotahome = $this->_params['imap_ob']->getQuotaRoot('');
        } catch (IMP_Imap_Exception $e) {
            throw new IMP_Exception(_("Unable to retrieve quota"));
        }

        $quota_var_val = reset($quotavar);
        $quota_home_val = reset($quotahome);

        if (isset($quota_var_val['storage'])) {
                  $quota_val['limitvar'] = $quota_var_val['storage']['limit'] * 1024;
                  $quota_val['usagevar'] = $quota_var_val['storage']['usage'] * 1024;
        } else {
                $quota_val['limitvar'] = 0;
                $quota_val['usagevar'] = 0;
        }

        if (isset($quota_home_val['storage'])) {
                  $quota_val['limithome'] = $quota_home_val['storage']['limit'] * 1024;
                  $quota_val['usagehome'] = $quota_home_val['storage']['usage'] * 1024;
        } else {
                $quota_val['limithome'] = 0;
                $quota_val['usagehome'] = 0;
        }

        return $quota_val;

    }

}

imp/lib/Quota/Ui.php

  • Function quota:
limitvar, usagevar, percentvar, messagevar.
limithome, usagehome, percenthome, messagehome.

Backup your original imp/lib/Quota/Ui.php and create a new Ui.php with the following code:
<?php
/**
 * Copyright 2012-2013 Horde LLC (http://www.horde.org/)
 *
 * See the enclosed file COPYING for license information (GPL). If you
 * did not receive this file, see http://www.horde.org/licenses/gpl.
 *
 * @category  Horde
 * @copyright 2012-2013 Horde LLC
 * @license   http://www.horde.org/licenses/gpl GPL
 * @package   IMP
 * Modified by Mauricio Jose T. Tecles <mtecles@biof.ufrj.br>
 * Updated 2013 December 18
 */

/**
 * Common code dealing with quota UI display.
 *
 * @author    Michael Slusarz <slusarz@horde.org>
 * @category  Horde
 * @copyright 2012-2013 Horde LLC
 * @license   http://www.horde.org/licenses/gpl GPL
 * @package   IMP
 */
class IMP_Quota_Ui
{
    /**
     * Returns data needed to output quota.
     *
     * @param string $mailbox  Mailbox to query.
     *
     * @return array  Array with these keys: class, message, percent.
     */
    public function quota($mailbox = null)
    {
        global $injector;

        if (!$injector->getInstance('IMP_Imap')->config->quota) {
            return false;
        }

        if (!is_null($mailbox)) {
            $mailbox = IMP_Mailbox::get($mailbox);
            if ($mailbox->nonimap) {
                return false;
            }
        }

        try {
            $quotaDriver = $injector->getInstance('IMP_Quota');
            $quota = $quotaDriver->getQuota($mailbox);
        } catch (IMP_Exception $e) {
            Horde::log($e, 'ERR');
            return false;
        }

        if (empty($quota)) {
            return false;
        }

        $strings = $quotaDriver->getMessages();
        list($calc, $unit) = $quotaDriver->getUnit();
        $ret = array(
            'classvar' => '',
            'percentvar' => 0,
            'classhome' => '',
            'percenthome' => 0
        );

        /* Quota for dev_fldrs */
        unset($ret['messagehome']);
        if ($quota['limithome'] != 0) {
            $quota['usagehome'] = $quota['usagehome'] / $calc;
            $quota['limithome'] = $quota['limithome'] / $calc;
            $ret['percenthome'] = ($quota['usagehome'] * 100) / $quota['limithome'];
 
            if ($ret['percenthome'] >= 100) {
                $ret['classhome'] = 'quotaalert';
            } elseif ($ret['percenthome'] >= 90) {
                $ret['classhome'] = 'quotawarn';
            }
 
            if ($quota['usagevar'] != 0) {
                $ret['messagehome'] = sprintf($strings['shorth'], $ret['percenthome'], $quota['limithome'], $unit);
                $ret['percenthome'] = sprintf("%.2f", $ret['percenthome']);
            } else {
                $ret['messagehome'] = sprintf($strings['sshorth'], $ret['percenthome'], $quota['limithome'], $unit);
                $ret['percenthome'] = sprintf("%.2f", $ret['percenthome']);
            }
 
        } else {
            if ($quota['usagehome'] != 0) {
                if ($quota['usagevar'] != 0) {
                    $quota['usagehome'] = $quota['usagehome'] / $calc;
                    $ret['messagehome'] = sprintf($strings['nolimit_shorth'], $quota['usagehome'], $unit);
                } else {
                    $quota['usagehome'] = $quota['usagehome'] / $calc;
                    $ret['messagehome'] = sprintf($strings['nolimit_sshorth'], $quota['usagehome'], $unit);
                }
            } else {
                $ret['messagehome'] = _(" ");
            }
        }
 
        /* Quota for dev_inbx */
        if ($quota['limitvar'] != 0) {
            $quota['usagevar'] = $quota['usagevar'] / $calc;
            $quota['limitvar'] = $quota['limitvar'] / $calc;
            $ret['percentvar'] = ($quota['usagevar'] * 100) / $quota['limitvar'];
 
            if ($ret['percentvar'] >= 100) {
                $ret['classvar'] = 'quotaalert';
            } elseif ($ret['percentvar'] >= 90) {
                $ret['classvar'] = 'quotawarn';
            }
 
            $ret['messagevar'] = sprintf($strings['shortv'], $ret['percentvar'], $quota['limitvar'], $unit);
            $ret['percentvar'] = sprintf("%.2f", $ret['percentvar']);
        } else {
            if ($quota['usagevar'] != 0) {
                $quota['usagevar'] = $quota['usagevar'] / $calc;
 
                $ret['messagevar'] = sprintf($strings['nolimit_shortv'], $quota['usagevar'], $unit);
            } else {
                $ret['messagevar'] = _(" ");
            }
        }

        return $ret;
    }

}

imp/lib/Quota.php

  • Only short formats.

Backup your original imp/lib/Quota.php and replace function construct with the following code:

    public function __construct(array $params = array())
    {
        $this->_params = array_merge($this->_params, $params);

        $this->_params['format'] = array(
            'shortv' => isset($this->_params['format']['short'])
                ? $this->_params['format']['short']
                : _("Inbox: %.0f%% of %.1f %s"),
            'shorth' => isset($this->_params['format']['shorth'])
                ? $this->_params['format']['shorth']
                : _(" - Folders: %.0f%% of %.1f %s"),
            'sshorth' => isset($this->_params['format']['sshorth'])
                ? $this->_params['format']['sshorth']
                : _("Folders: %.0f%% of %.1f %s"),
            'nolimit_shortv' => isset($this->_params['format']['nolimit_short'])
                ? $this->_params['format']['nolimit_short']
                : _("Inbox: %.1f %s"),
            'nolimit_shorth' => isset($this->_params['format']['nolimit_shorth'])
                ? $this->_params['format']['nolimit_shorth']
                : _(" - Folders: %.1f %s"),
            'nolimit_sshorth' => isset($this->_params['format']['nolimit_sshorth'])
                ? $this->_params['format']['nolimit_sshorth']
                : _("Folders: %.1f %s"),
        );
    }


imp/lib/Ajax/Queue.php

  • mv, pv, lv: quota message, percentage and class for Inbox.
  • mh, ph, lh: quota message, percentage and class for folders.
  • merrov, mvclasse, merroh, mhclasse: Message when usage > 90%.

Backup your original imp/lib/Ajax/Queue.php and replace function add with the following code:

    public function add(IMP_Ajax_Application $ajax)
    {
        global $injector, $registry;

        /* Add compose attachment information. */
        if (!empty($this->_atc)) {
            $ajax->addTask('compose-atc', $this->_atc);
            $this->_atc = array();
        }

        /* Add compose information. */
        if (!is_null($this->_compose)) {
            $compose = new stdClass;
            if (!$this->_compose->additionalAttachmentsAllowed()) {
                $compose->atclimit = 1;
            }
            $compose->cacheid = $this->_compose->getCacheId();

            $ajax->addTask('compose', $compose);
            $this->_compose = null;
        }

        /* Add flag information. */
        if (!empty($this->_flag)) {
            $ajax->addTask('flag', $this->_flag);
            $this->_flag = array();
        }

        /* Add flag configuration. */
        if ($this->_flagconfig) {
            $flags = array();

            foreach ($injector->getInstance('IMP_Flags')->getList() as $val) {
                $flags[] = array_filter(array(
                    'a' => $val->canset,
                    'b' => $val->bgdefault ? null : $val->bgcolor,
                    'c' => $val->css,
                    'f' => $val->fgcolor,
                    'i' => $val->css ? null : $val->cssicon,
                    'id' => $val->id,
                    'l' => $val->label,
                    's' => intval($val instanceof IMP_Flag_Imap),
                    'u' => intval($val instanceof IMP_Flag_User)
                ));
            }

            $ajax->addTask('flag-config', $flags);
        }

        /* Add folder tree information. */
        $imptree = $injector->getInstance('IMP_Imap_Tree');
        $imptree->setIteratorFilter(
            ($registry->getView() == $registry::VIEW_DYNAMIC)
                ? $imptree::FLIST_NOSPECIALMBOXES
                : 0
        );
        $out = $imptree->getAjaxResponse();
        if (!empty($out)) {
            $ajax->addTask('mailbox', array_merge($out, $this->_mailboxOpts));
        }

        /* Add mail log information. */
        if (!empty($this->_maillog)) {
            $imp_maillog = $injector->getInstance('IMP_Maillog');
            $maillog = array();

            foreach ($this->_maillog as $val) {
                if ($tmp = $imp_maillog->getLogObs($val['msg_id'])) {
                    $log_ob = new stdClass;
                    $log_ob->buid = intval($val['buid']);
                    $log_ob->log = $tmp;
                    $log_ob->mbox = $val['mailbox']->form_to;
                    $maillog[] = $log_ob;
                }
            }

            if (!empty($maillog)) {
                $ajax->addTask('maillog', $maillog);
            }
        }

        /* Add message information. */
        if (!empty($this->_messages)) {
            $ajax->addTask('message', $this->_messages);
            $this->_messages = array();
        }

        /* Add poll information. */
        $poll = $poll_list = array();
        foreach ($this->_poll as $val) {
            $poll_list[strval($val)] = 1;
        }

        if (count($poll_list)) {
            $imap_ob = $injector->getInstance('IMP_Imap');
            if ($imap_ob->init) {
                foreach ($imap_ob->statusMultiple(array_keys($poll_list), Horde_Imap_Client::STATUS_UNSEEN) as $key => $val) {
                    $poll[IMP_Mailbox::formTo($key)] = intval($val['unseen']);
                }
            }

            if (!empty($poll)) {
                $ajax->addTask('poll', $poll);
                $this->_poll = array();
            }
        }

        /* Add quota information. */
        if (($this->_quota !== false) &&
            ($quotadata = $injector->getInstance('IMP_Quota_Ui')->quota($this->_quota))) {
            /* Quota for dev_inbx */
            $merrov = null;
            if (round($quotadata['percentvar']) >= 100) {
                $mvclasse = 'horde.error';
                $merrov = sprintf("Inbox above limit.");
             } else if ($quotadata['percentvar'] >= 90) {
             
                    $merrov = sprintf("Inbox above 90%%.");
                    $mvclasse = 'horde.warning';
            }
            /* Quota for dev_fldrs */
            $merroh = null;
            if (round($quotadata['percenthome'] >= 100)) {
                $mhclasse = 'horde.error';
                $merroh = sprintf("Folders above limit.");
            } elseif ($quotadata['percenthome'] >= 90) {
                $merroh = sprintf("Folders above 90%%.");
                $mhclasse = 'horde.warning';
            }
 
            if (!empty($merrov)) {
                $GLOBALS['notification']->push($merrov, $mvclasse);
            }
            if (!empty($merroh)) {
                $GLOBALS['notification']->push($merroh, $mhclasse);
            }

            $ajax->addTask('quota', array(
                'mv' => $quotadata['messagevar'],
                'pv' => round($quotadata['percentvar']),
                'lv' => $quotadata['percentvar'] >= 100
                    ? 'alert'
                    : ($quotadata['percentvar'] >= 90 ? 'warn' : 'control'),
                'mh' => $quotadata['messagehome'],
                'ph' => round($quotadata['percenthome']),
                'lh' => $quotadata['percenthome'] >= 100
                    ? 'alert'
                    : ($quotadata['percenthome'] >= 90 ? 'warn' : 'control')
            ));
            $this->_quota = false;
        }
    }


imp/lib/View/Subinfo.php

  • function __construct: quotaClassV, quotaTextV, quotaClassH, quotaTextH.

Backup your original imp/lib/View/Subinfo.php and replace function construct with the following code:

    public function __construct(array $config = array())
    {
        $config['templatePath'] = IMP_TEMPLATES . '/basic';
        parent::__construct($config);

        $quotadata = $GLOBALS['injector']->getInstance('IMP_Quota_Ui')->quota(isset($config['mailbox']) ? $config['mailbox'] : null);
        if (!empty($quotadata)) {
            $this->quotaClassV = $quotadata['classvar'];
            $this->quotaTextV = $quotadata['messagevar'];
            $this->quotaClassH = $quotadata['classhome'];
            $this->quotaTextH = $quotadata['messagehome'];
            }
    }


imp/js/dimpbase.js

  • quotaCallback
quotaV, mv, lv.
quotaH, mh, lh.

Backup your original imp/js/dimpbase.js. Edit dimpbase.js and replace quotaCallback with the following code:
    quotaCallback: function(r)
    {
        var quotaV = $('quota-textV');
        var quotaH = $('quota-textH');
        quotaV.removeClassName('quotaalert').
            removeClassName('quotawarn').
            setText(r.mv);
        quotaH.removeClassName('quotaalert').
            removeClassName('quotawarn').
            setText(r.mh);
 
        switch (r.lv) {
        case 'alert':
        case 'warn':
            quotaV.addClassName('quota' + r.lv);
            break;
        }
 
        switch (r.lh) {
        case 'alert':
        case 'warn':
            quotaH.addClassName('quota' + r.lh);
            break;
        }
    },

imp/templates/basic/subinfo.html.php

  • quotaTextV, quotaClassV, quotaTextH, quotaClassH.

Backup your original imp/templates/basic/subinfo.html.php and replace the following code:
From:

<?php if ($this->quotaText): ?>
<span class="<?php echo $this->quotaClass ?>"><?php echo $this->quotaText ?></span>
<?php endif ?>

To:

<?php if ($this->quotaTextV): ?>
<span class="<?php echo $this->quotaClassV ?>"><?php echo $this->quotaTextV ?></span>
<?php endif ?>
<?php if ($this->quotaTextH): ?>
<span class="<?php echo $this->quotaClassH ?>"><?php echo $this->quotaTextH ?></span>
<?php endif ?>


imp/templates/dynamic/mailbox_subinfo.html.php

  • quota-textV, quota-textH.

Backup your original imp/templates/dynamic/mailbox_subinfo.html.php and replace the following code:
From:

<?php if ($this->quota): ?>
<span id="quota-text"></span>
<?php endif ?>

To:

<?php if ($this->quota): ?>
<span id="quota-textV"></span><span id="quota-textH"></span>
<?php endif ?>