more modules

[old-projects.git] / philter / philter / include / philter.inc.php

<?php
/********************************************************************************
* include/philter.inc.php : Philter base class
* -----------------------
*
* This file is part of the philter distribution
* Copyright: See COPYING files that comes with this distribution
********************************************************************************/

require_once("include/core.inc.php");

function i18n($_index) { global $philter; echo $philter->i18n($_index); }
function _i18n($_index) { global $philter; return $philter->i18n($_index); }
function bd() { global $philter; return ($philter->is_advanced() ? 'tmp_' : ''); }

/** Philter base configuration class
 * This is the base class of Philter.
 */
class Philter {
    /** philter configuration.
     * @see config.inc.php
     */
    var $config;
    /** error string */
    var $err;

    /** constructor */
    function Philter() {
        $this->config = array(
            'db'      => array('host', 'name', 'user', 'pwd', 'link'),
            'path'    => array('spool'),
            'match_plugins' => array(),
            'action_plugins' => array(),
            'global_plugins' => array(),
            'i18n' => array()
        );
        $this->err = "";
    }

    function is_advanced() { return isset($_SESSION['philter_adv']); }
    function set_advanced() { $_SESSION['philter_adv'] = true; }
    function del_advanced() { unset($_SESSION['philter_adv']); }

    /** returns the i18n string
     * @param   $_index   the index of the string
     * @returns the string or false
     */
    function i18n($_index) {
        if(isset($this->config['i18n'][$_index]))
            return $this->config['i18n'][$_index];
        return false;
    }

    /** returns the error.
     * @return  the error string
     */
    function error() {
        return $this->err;
    }

    /** sets the error string.
     * @return  nothing
     */
    function set_error($_err) {
        $this->err = $_err;
    }

    /** returns the database persistent connection link.
     * it's a shortname for $this->config['db']['link']
     * @returns a mysql resource
     */
    function link() { return $this->config['db']['link']; }

    /** init the link to the database */
    function pconnect() {
        $this->config['db']['link'] =
            mysql_pconnect(
                    $this->config['db']['host'],
                    $this->config['db']['user'],
                    $this->config['db']['pass']
            );
        mysql_select_db($this->config['db']['name'], $this->link());
    }

    /** function that writes the procmailrc.
     * @param   &$procmail  the string containing the procmail filter
     * @param   $filename   the base filename of the procmailrc filter
     * @return  true if all is ok
     */
    function write_procmailrc(&$procmail, $filename) {
        $file = $this->config['path']['spool']."/".$filename;
        $f = fopen($file.".tmp", "w");
        fwrite($f, $procmail, strlen($procmail));
        fclose($f);
        rename($file.".tmp", $file);
        echo "<pre>\n";
        echo $procmail;
        echo "</pre>\n";
        return true;
    }

    /** function that register a new Plugin
     * @param   $_plugin    an instance of the plugin
     * @return  true if all is ok, read error() else
     */
    function register_plugin($_plugin) {
        if($rtti = $_plugin->rtti()) {
            if(is_subclass_of($_plugin, 'matchplugin')) {
                if($_plugin->is_global()) {
                    $this->err = "Philter::register_plugin : this plugin is global";
                    return false;
                }
                $index = 'match_plugins';
            } elseif(is_subclass_of($_plugin, 'actionplugin')) {
                $index = 'action_plugins';
            } else {
                $this->err = "Philter::register_plugin : bad object";
                return false;
            }

            if(isset($this->config[$index][$rtti])) {
                $this->err = "Philter::register_plugin : a plugin is already registerd";
                return false;
            }

            $this->config[$index][$rtti] = $_plugin;
            return true;
        }

        $this->err = "Philter::register_plugin : rtti is 0, this is an abstract class";
        return false;
    }

    /** function that register plugin as a global rule
     * @param   $_plugin    an instance of the plugin
     * @return  true if all is ok, read error() else
     */
    function register_global_plugin($_plugin) {
        if($rtti = $_plugin->rtti()) {
            if(!is_subclass_of($_plugin, 'matchplugin')) {
                $this->err = "Philter::register_global_plugin : bad object";
                return false;
            }

            if(!$_plugin->is_global()) {
                $this->err = "Philter::register_global_plugin : this plugin is not global";
                return false;
            }
            
            if(isset($this->config['global_plugins'][$rtti])) {
                $this->err = "Philter::register_global_plugin : a plugin is already registerd";
                return false;
            }
            
            $this->config['global_plugins'][$rtti] = $_plugin;
            return true;
        }

        $this->err = "Philter::register_global_plugin : rtti is 0, this is an abstract class";
        return false;
    }
}

/********************************************************************************
* $Id$
* vim: set expandtab shiftwidth=4 tabstop=4 softtabstop=4 textwidth=100:
********************************************************************************/
?>