Extension Class Reference

manage the extension, it involves the table extension More...

Inheritance diagram for Extension:

Collaboration diagram for Extension:

Public Member Functions
	__toString ()
	can_request ($p_login)
	return 1 if the user given in parameter can access this extension otherwise returns 0
	check_xml (SimpleXMLElement $xml)
	Check that the xml contains all the needed information to change them into a extension, the exception code is 0 if the element is optional.
	insert_plugin ()
	Insert a plugin into the given profile, by default always insert into EXT.
	insert_profile_menu ($p_id=1)
	insert into the table profile_menu for the given profile id and depending of the module $p_module
	remove_from_profile_menu ($p_id)
	remove_plugin ()
	save_plugin ()
	save a plugin into MENU_REF , calls insert_plugin or update_plugin if it already exists
	search ($p_what)
	search a extension, the what is the column (extends_code
	update_plugin ()
	verify ()

Static Public Member Functions
static	check_plugin_version ($p_plugin_code)
	compare the version of the plugin and the last version , propose to update it if a new version exists
static	check_version ($i, $p_plugin_code=null)
	check the version of the plugin , null stands for one of the standard plugins, it means self::aStandard_plugin @global type $version_noalyss
static	clean (Database $p_cn)
	remove all the standard plugins schema
static	find_extension_code ($a_extension, $access_code)
	find the extension with the me_code = last part of access_code
static	get_version ($xml_file, $plugin_code)
	retrieve the version of the current plugin
static	make_array ($cn)
	make an array of the available plugin for the current user
static	read_definition ($p_file)
	Parse a XML file to complete an array of extension objects, in the plugin.xml file , you can find several plugins sharing some parts.

Data Fields
	$depend
	default depending menu (can be override by config menu)
	$noalyss_version
	minimum version of NOALYSS for this plugin
	$order
	$order in the menu (can be override by config menu)
	$schema
	default database schema to store data for the plugin
	$version
	Variables from plugin.xml.
const	aStandard_plugin

Detailed Description

manage the extension, it involves the table extension

Data member

• $cn database connection

Definition at line 39 of file extension.class.php.

Member Function Documentation

__toString()

Extension::__toString

(

)

Definition at line 428 of file extension.class.php.

                                : string
    {
        $r = "";
        $r .= "  me_code " . $this->me_code.PHP_EOL;
        $r .= "  me_menu.".$this->me_menu.PHP_EOL;
        $r .= "  version".$this->version.PHP_EOL;
        $r .= "  noalyss_version".$this->noalyss_version.PHP_EOL;
        $r .= "  me_file" . $this->me_file.PHP_EOL;
        $r .= "  me_url" . $this->me_url.PHP_EOL;
        $r .= "  me_description" . $this->me_description.PHP_EOL;
        $r .= "  me_parameter" . $this->me_parameter.PHP_EOL;
        $r .= "  me_javascript" . $this->me_javascript.PHP_EOL;
        $r .= "  me_type" . $this->me_type.PHP_EOL;
        $r .= "  me_descrition_etendue" . $this->me_description_etendue.PHP_EOL;
        $r .= "  noalyss_version " . $this->noalyss_version.PHP_EOL;
        $r .= "  version " . $this->version.PHP_EOL;
        $r .= "  order " . $this->order.PHP_EOL;
        $r .= "  depend " . $this->depend.PHP_EOL;
        return "Extension $r";
    }

References $r, and depend.

can_request()

Extension::can_request

(

$p_login

)

return 1 if the user given in parameter can access this extension otherwise returns 0

Parameters

$p_login

the user login

Returns

1 has access, 0 has no access

Definition at line 86 of file extension.class.php.

    {
        $cnt=$this->cn->get_value("select count(*) from menu_ref
                                                                join profile_menu using (me_code)
                                                                join profile_user using (p_id)
                                                                where
                                                                me_code=$1
                                                                and user_name=$2", array($this->me_code, $p_login));
        if ($cnt>0)
            return 1;
        return 0;
    }

References $cnt, and cn.

check_plugin_version()

static Extension::check_plugin_version ( $p_plugin_code )

static

compare the version of the plugin and the last version , propose to update it if a new version exists

Todo

add a mechanism to check once a day @global User $g_user @global number $version_plugin

Definition at line 293 of file extension.class.php.

    {
        global $g_user, $version_plugin;
        if ($g_user->Admin()==1)
        {
            if ( in_array($p_plugin_code, self::aStandard_plugin) && SITE_UPDATE_PLUGIN!="")
            {
               $update=@file_get_contents(SITE_UPDATE_PLUGIN);
                if ($update>$version_plugin)
                {
                    echo '<div id="version_plugin_div_id" class="inner_box" style="position:absolute;zindex:2;top:5px;left:37.5%;width:25%">';
                    echo '<p class="notice">';
                    echo "Mise à jour disponible des plugins pour NOALYSS, version actuelle : $update votre version $version_plugin";
                    echo '</p>';
                    echo '<p style="text-align:center">'.
                    '<a id="version_plugin_button" class="button" onclick="$(\'version_plugin_div_id\').remove()">'.
                    _('Fermer').
                    "</a></p>";
                    echo '</div>';
                }
            }
        }
    }

References $g_user, and _.

Referenced by check_version().

check_version()

static Extension::check_version ( $i, $p_plugin_code = null )

static

check the version of the plugin , null stands for one of the standard plugins, it means self::aStandard_plugin @global type $version_noalyss

Parameters

type	$i
type	$p_plugin_code

Returns

type

Definition at line 121 of file extension.class.php.

    {
        global $version_noalyss;
        if (!isset($version_noalyss)||$version_noalyss<$i)
        {
            alert(_('Cette extension ne fonctionne pas sur cette version de NOALYSS'.
                            ' Veuillez mettre votre programme a jour. Version minimum ').$i);
            return;
        }
        Extension::check_plugin_version($p_plugin_code);
    }

References $i, $version_noalyss, _, alert(), and check_plugin_version().

Here is the call graph for this function:

check_xml()

Extension::check_xml

(

SimpleXMLElement

$xml

)

Check that the xml contains all the needed information to change them into a extension, the exception code is 0 if the element is optional.

Check XML.

Parameters

SimpleXMLElement

$xml

Exceptions

Exception

Definition at line 324 of file extension.class.php.

    {
        try
        {
            if (!isset($xml->plugin))
                throw new Exception(_('Manque plugin'), 1);
            $nb_plugin=count($xml->plugin);
 
            for ($i=0; $i<$nb_plugin; $i++)
            {
                if (!isset($xml->plugin[$i]->name))
                    throw new Exception(_('Manque nom'), 1);
                if (!isset($xml->plugin[$i]->description))
                    throw new Exception(_('Manque description'), 0);
                if (!isset($xml->plugin[$i]->code))
                    throw new Exception(_('Manque code'), 1);
                if (!isset($xml->plugin[$i]->author))
                    throw new Exception(_('Manque auteur'), 0);
                if (!isset($xml->plugin[$i]->root))
                    throw new Exception(_('Manque répertoire racine'), 1);
                if (!isset($xml->plugin[$i]->file))
                    throw new Exception(_('Manque fichier à inclure'), 1);
                if (!isset($xml->plugin[$i]->version))
                    throw new Exception(_("Manque version de l'extension"), 1);
 
                if (!isset($xml->plugin[$i]->depend))
                    $xml->plugin[$i]->depend="EXT";
                if (!isset($xml->plugin[$i]->order))
                    $xml->plugin[$i]->order=9000;
            }
        }
        catch (Exception $ex)
        {
            throw $ex;
        }
    }

References $ex, $i, $nb_plugin, $xml, and _.

clean()

static Extension::clean ( Database $p_cn )

static

remove all the standard plugins schema

Parameters

Database

$p_cn

Definition at line 275 of file extension.class.php.

    {
        $a_ext=array("tva_belge", "amortissement", "impdol", "coprop", "importbank");
        for ($i=0; $i<count($a_ext); $i++)
        {
            if ($p_cn->exist_schema($a_ext[$i]))
            {
                $p_cn->exec_sql("drop schema ".$a_ext[$i]." cascade");
            }
        }
    }

References $i, DatabaseCore\exec_sql(), and DatabaseCore\exist_schema().

Here is the call graph for this function:

find_extension_code()

static Extension::find_extension_code ( $a_extension, $access_code )

static

find the extension with the me_code = last part of access_code

Parameters

$a_extension
$access_code	find the ME_CODE (normally last part )

Returns

the extension or null

Definition at line 416 of file extension.class.php.

                                                                         :Extension|null
    {
        $a_me_code=explode("/", $access_code);
        if (empty($a_me_code ) ) return null;
        $nb_me_code=count($a_me_code);
        $me_code=$a_me_code[$nb_me_code-1];
        foreach ($a_extension as $extension) {
            if ($extension->me_code==$me_code) return $extension;
        }
        return null;
    }

References $access_code, $extension, and $me_code.

Referenced by get_version().

get_version()

static Extension::get_version ( $xml_file, $plugin_code )

static

retrieve the version of the current plugin

Parameters

$xml_file	always DIR."/plugin.xml"
$plugin_code	the plugin or $_REQUEST['ac']

Returns

int version or -1 if not found

Definition at line 455 of file extension.class.php.

                                                              :int
    {
        $aExtension=\Extension::read_definition($xml_file);
        $extension=self::find_extension_code($aExtension, $plugin_code);
        if ( empty($plugin_code)) return -1;
        return $extension->version??0;
    }

References $extension, find_extension_code(), and read_definition().

Here is the call graph for this function:

insert_plugin()

Extension::insert_plugin

(

)

Insert a plugin into the given profile, by default always insert into EXT.

Parameters

type

$p_id

profile.p_id

Exceptions

Exception

if duplicate or error db

Definition at line 220 of file extension.class.php.

    {
        try
        {
            $this->cn->start();
            $this->verify();
            // check if duplicate
            $this->me_code=strtoupper($this->me_code);
            $count=$this->cn->get_value("select count(*) from menu_ref where me_code=$1", array($this->me_code));
            if ($count!=0)
                throw new Exception("Doublon");
            $this->me_type='PL';
            $this->insert();
            $this->cn->commit();
        }
        catch (Exception $exc)
        {
            echo alert($exc->getMessage());
        }
    }

References $count, alert(), cn, and verify().

Referenced by save_plugin().

Here is the call graph for this function:

insert_profile_menu()

Extension::insert_profile_menu

(

$p_id = 1

)

insert into the table profile_menu for the given profile id and depending of the module $p_module

Remarks

type $cn

Parameters

type

$p_id

profile.p_id

Exceptions

Exception

10 : profile absent , 20 module absent , 30 No parent menu

Definition at line 140 of file extension.class.php.

    {
        global $cn;
        // Module for the plugin
        $p_module=$this->depend;
        //profile exists ?
        $profile=new Profile_sql($cn, $p_id);
        if ($profile->p_id!=$p_id)
        {
            throw new Exception(_('Profil inexistant'), 10);
        }
        // Menu exists
 
        $module=new Menu_Ref($cn, $p_module);
        if ($module->me_code==null)
        {
            throw new Exception(_('Module inexistant'), 20);
        }
        // Dependency
        $dep_id=$cn->get_array('select pm_id from profile_menu 
                where
                p_id=$1
                and me_code = $2 ', array($p_id, $p_module));
        // throw an exception if there is no dependency
        if (empty($dep_id))
        {
            $msg = sprintf(_("Le menu %s dont dépend %s doit être crée ou %s doit être ajouté depuis le menu C0PROFL"),
            $p_module,$this->me_code,$this->me_code);
            throw new Exception($msg, 30);
        }
        $nb_dep=count($dep_id);
 
        // insert at the right location
        for ($i=0; $i<$nb_dep; $i++)
        {
            $profil_menu=new Profile_Menu($cn);
            $profil_menu->me_code=$this->me_code;
            $profil_menu->me_code_dep=$p_module;
            $profil_menu->p_type_display='S';
            $profil_menu->p_id=$p_id;
            $profil_menu->pm_id_dep=$dep_id[$i]['pm_id'];
            $profil_menu->pm_default=0;
            $profil_menu->p_order=$this->order;
 
            $cnt=$profil_menu->count(' where pm_id_dep=$3 and p_id=$1 and me_code = $2',
                    array($p_id, $this->me_code, $dep_id[$i]['pm_id']));
            if ($cnt==0)
            {
                $profil_menu->insert();
            }
        }
    }

References $cn, $cnt, $depend, $i, $me_code, $module, $msg, $nb_dep, $order, $p_id, $profile, and _.

make_array()

static Extension::make_array ( $cn )

static

make an array of the available plugin for the current user

Returns

an array

See also

ISelect

Definition at line 104 of file extension.class.php.

    {
        $sql="select DISTINCT me_code as value, me_menu as label from ".
                " menu_ref join profile_menu using (me_code)
                                 join profile_user using (p_id) where ".
                " user_name=$1 and me_type='PL' ORDER BY ME_MENU";
        $a=$cn->get_array($sql, array($_SESSION[SESSION_KEY.'g_user']));
        return $a;
    }

References $a, $cn, and $sql.

read_definition()

static Extension::read_definition ( $p_file )

static

Parse a XML file to complete an array of extension objects, in the plugin.xml file , you can find several plugins sharing some parts.

Parameters

string

$p_file

filename

Returns

array array of Extension

Definition at line 368 of file extension.class.php.

    {
        global $cn;
        $dom=new DomDocument('1.0');
        $dom->load($p_file);
        $xml=simplexml_import_dom($dom);
        $nb_plugin=count($xml->plugin);
        $a_extension=array();
        for ($i=0; $i<$nb_plugin; $i++)
        {
 
            $extension=new Extension($cn);
            try
            {
                $extension->check_xml($xml);
            }
            catch (Exception $ex)
            {
                echo_warning($ex->getMessage());
                if ($ex->getCode()==1)
                {
                    continue;
                }
            }
            $extension->me_file=trim($xml->plugin[$i]->root).'/'.trim($xml->plugin[$i]->file);
            $extension->me_code=trim($xml->plugin[$i]->code);
            $extension->me_description=(isset($xml->plugin[$i]->description))?trim($xml->plugin[$i]->description):"";
            $extension->me_description_etendue=(trim($xml->plugin[$i]->author))?trim($xml->plugin[$i]->author):"";
            $extension->me_type='PL';
            $extension->me_menu=trim($xml->plugin[$i]->name);
            $extension->me_parameter='plugin_code='.trim($xml->plugin[$i]->code);
            $extension->depend=(isset($xml->plugin[$i]->depend))?trim($xml->plugin[$i]->depend):"EXT";
            $extension->order=(isset($xml->plugin[$i]->order))?trim($xml->plugin[$i]->order):9000;
            $extension->version=trim($xml->plugin[$i]->version);
            $extension->noalyss_version=(isset($xml->plugin[$i]->noalyss_version))?trim($xml->plugin[$i]->noalyss_version):8000;
            $extension->schema=(isset($xml->plugin[$i]->schema))?trim($xml->plugin[$i]->schema):"public";
            
            $a_extension[]=clone $extension;
        }
        return $a_extension;
    }

References $cn, $ex, $extension, $i, $nb_plugin, $xml, and echo_warning().

Referenced by get_version().

Here is the call graph for this function:

remove_from_profile_menu()

Extension::remove_from_profile_menu

(

$p_id

)

Definition at line 193 of file extension.class.php.

    {
        global $cn;
 
        $cn->exec_sql('delete from profile_menu  where (me_code = $1 or me_code in (select me_code from menu_ref where me_file=$2)) and p_id=$3',
                array($this->me_code, $this->me_file, $p_id));
    }

References $cn, and $p_id.

remove_plugin()

Extension::remove_plugin

(

)

Definition at line 257 of file extension.class.php.

    {
        try
        {
            $this->cn->start();
            $this->delete();
            $this->cn->commit();
        }
        catch (Exception $exc)
        {
            echo alert($exc->getMessage());
        }
    }

References alert(), and cn.

Here is the call graph for this function:

save_plugin()

Extension::save_plugin

(

)

save a plugin into MENU_REF , calls insert_plugin or update_plugin if it already exists

Returns

void

Definition at line 205 of file extension.class.php.

    {
        if ( $this->cn->get_value("select count(*) from menu_ref where me_code=$1",[$this->me_code]) > 0) {
            $this->update_plugin();
        } else {
            $this->insert_plugin();
 
        }
    }

References cn, insert_plugin(), and update_plugin().

Here is the call graph for this function:

search()

Extension::search

(

$p_what

)

search a extension, the what is the column (extends_code

Definition at line 72 of file extension.class.php.

    {
        $this->me_code=strtoupper($p_what);
        if ($this->load()==false)
            return null;
        return 1;
    }

update_plugin()

Extension::update_plugin

(

)

Definition at line 241 of file extension.class.php.

    {
        try
        {
            $this->cn->start();
            $this->verify();
            $this->me_type='PL';
            $this->update();
            $this->cn->commit();
        }
        catch (Exception $exc)
        {
            echo alert($exc->getMessage());
        }
    }

References alert(), cn, and verify().

Referenced by save_plugin().

Here is the call graph for this function:

verify()

Extension::verify

(

)

Definition at line 57 of file extension.class.php.

    {
        // Verify that the elt we want to add is correct
        if (trim($this->me_code)=="")
            throw new Exception('Le code ne peut pas être vide');
        if (trim($this->me_menu)=="")
            throw new Exception('Le nom ne peut pas être vide');
        if (trim($this->me_file)=="")
            throw new Exception('Chemin incorrect');
        if (file_exists(NOALYSS_PLUGIN.'/'.$this->me_file)==false)
            throw new Exception("$this->me_code $this->me_file".'Extension non trouvée, le chemin est-il correct?');
    }

Referenced by insert_plugin(), and update_plugin().

Field Documentation

$depend

Extension::$depend

default depending menu (can be override by config menu)

Definition at line 55 of file extension.class.php.

Referenced by insert_profile_menu().

$noalyss_version

Extension::$noalyss_version

minimum version of NOALYSS for this plugin

Definition at line 53 of file extension.class.php.

$order

Extension::$order

$order in the menu (can be override by config menu)

Definition at line 54 of file extension.class.php.

Referenced by insert_profile_menu().

$schema

Extension::$schema

default database schema to store data for the plugin

Definition at line 56 of file extension.class.php.

$version

Extension::$version

Variables from plugin.xml.

Definition at line 52 of file extension.class.php.

aStandard_plugin

const Extension::aStandard_plugin

Initial value:

=
            array('AMORTIS','BACKNOADM','COPRO','IMPCARD',
                'IMPORTBANK','INVOICING','LISTING',
                'MODOP','RAPAV','SAV',
                'TOOLPCMN','TOOLS','TRANSFORM',
                'TVA')

Definition at line 42 of file extension.class.php.

---

The documentation for this class was generated from the following file:

• include/class/extension.class.php