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)

	$version

const	aStandard_plugin

Detailed Description

manage the extension, it involves the table extension

Data member

$cn database connection
$variable :
- id (extension.ex_id)
- name (extension.ex_name)
- plugin_code (extension.ex_code)
- desc (extension.ex_desc)
- enable (extension.ex_enable)
- filepath (extension.ex_file)

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

Member Function Documentation

◆ __toString()

Extension::__toString ( )

Definition at line 433 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 93 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 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 300 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 128 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 331 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 282 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 421 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 460 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 227 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 147 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, $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 111 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 375 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;
            $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 200 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 264 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 212 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 79 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 248 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 64 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 62 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 60 of file extension.class.php.

◆ $order

Extension::$order

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

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

Referenced by insert_profile_menu().

◆ $version

Extension::$version

Definition at line 59 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 49 of file extension.class.php.

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

include/class/extension.class.php

Public Member Functions

Static Public Member Functions

Data Fields

Detailed Description

Member Function Documentation

◆ __toString()

◆ can_request()

◆ check_plugin_version()

◆ check_version()

◆ check_xml()

◆ clean()

◆ find_extension_code()

◆ get_version()

◆ insert_plugin()

◆ insert_profile_menu()

◆ make_array()

◆ read_definition()

◆ remove_from_profile_menu()

◆ remove_plugin()

◆ save_plugin()

◆ search()

◆ update_plugin()

◆ verify()

Field Documentation

◆ $depend

◆ $noalyss_version

◆ $order

◆ $version

◆ aStandard_plugin