Collaboration diagram for ilParameterAppender:

Public Member Functions
	__construct ($webr_id)
	Constructor @access public. More...

	getErrorCode ()

	setObjId ($a_obj_id)

	getObjId ()

	setName ($a_name)

	getName ()

	setValue ($a_value)

	getValue ()

	validate ()

	add ($a_link_id)

	delete ($a_param_id)

Static Public Member Functions
static	getParameterIds ($a_webr_id, $a_link_id)
	Get Parameter ids of link. More...

static	_isEnabled ()
	Check if dynamic parameters are enabled. More...

static	_append ($a_link_data)

static	_getParams ($a_link_id)
	Get dynamic parameter definitions. More...

static	parameterToInfo ($a_name, $a_value)
	Get info text describing an existing dynamic link. More...

static	_deleteAll ($a_webr_id)

static	_getOptionSelect ()
	Get options as array. More...

Data Fields
	$webr_id = null

	$db = null

	$err = null

Detailed Description

Class ilParameterAppender.

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

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

Constructor & Destructor Documentation

◆ __construct()

ilParameterAppender::__construct ( $webr_id )

Constructor @access public.

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

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $this->webr_id = $webr_id;
        $this->db = $ilDB;
    }

References $DIC, $ilDB, and $webr_id.

Member Function Documentation

◆ _append()

static ilParameterAppender::_append ( $a_link_data )

static

Definition at line 190 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
 
        if (!is_array($a_link_data)) {
            return false;
        }
        if (count($params = ilParameterAppender::_getParams($a_link_data['link_id']))) {
            // Check for prefix
 
            foreach ($params as $param_data) {
                if ((int) $param_data['value'] === LINKS_SESSION_ID) {
                    continue;
                }
                if (!strpos($a_link_data['target'], '?')) {
                    $a_link_data['target'] .= "?";
                } else {
                    $a_link_data['target'] .= "&";
                }
                $a_link_data['target'] .= ($param_data['name'] . "=");
                switch ($param_data['value']) {
                    case LINKS_LOGIN:
                        $a_link_data['target'] .= (urlencode($ilUser->getLogin()));
                        break;
                    case LINKS_USER_ID:
                        $a_link_data['target'] .= ($ilUser->getId());
                        break;
                        
                    case LINKS_MATRICULATION:
                        $a_link_data['target'] .= ($ilUser->getMatriculation());
                        break;
                }
            }
        }
        return $a_link_data;
    }

References $DIC, $ilUser, _getParams(), LINKS_LOGIN, LINKS_MATRICULATION, LINKS_SESSION_ID, and LINKS_USER_ID.

Referenced by ilObjLinkResourceListGUI\__readLink(), ilObjLinkResourceGUI\callDirectLink(), ilObjLinkResourceGUI\callLink(), and ilObjLinkResourceSubItemListGUI\getHTML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _deleteAll()

static ilParameterAppender::_deleteAll ( $a_webr_id )

static

Definition at line 278 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $query = "DELETE FROM webr_params WHERE webr_id = " .
            $ilDB->quote((int) $a_webr_id, 'integer');
        $res = $ilDB->manipulate($query);
 
        return true;
    }

References $DIC, $ilDB, $query, and $res.

◆ _getOptionSelect()

static ilParameterAppender::_getOptionSelect ( )

static

Get options as array.

Returns

Definition at line 295 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $lng = $DIC['lng'];
 
        return array(0 => $lng->txt('links_select_one'),
                     LINKS_USER_ID => $lng->txt('links_user_id'),
                     LINKS_LOGIN => $lng->txt('links_user_name'),
                     LINKS_MATRICULATION => $lng->txt('matriculation')
        );
    }

References $DIC, $lng, LINKS_LOGIN, LINKS_MATRICULATION, and LINKS_USER_ID.

Referenced by ilWebResourceEditableLinkTableGUI\fillRow(), and ilObjLinkResourceGUI\initFormLink().

Here is the caller graph for this function:

◆ _getParams()

static ilParameterAppender::_getParams ( $a_link_id )

static

Get dynamic parameter definitions.

Parameters

int $a_link_id

Returns

Definition at line 234 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $params = [];
 
        $res = $ilDB->query("SELECT * FROM webr_params WHERE link_id = " .
            $ilDB->quote((int) $a_link_id, 'integer'));
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $params[$row->param_id]['name'] = $row->name;
            $params[$row->param_id]['value'] = $row->value;
        }
 
        return $params;
    }

References $DIC, $ilDB, $res, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by _append(), ilLinkResourceItems\cloneItems(), ilObjLinkResourceGUI\initFormLink(), ilWebResourceEditableLinkTableGUI\parse(), ilwebresourceTest\testWebResourceParameters(), and ilLinkResourceItems\toXML().

Here is the caller graph for this function:

◆ _isEnabled()

static ilParameterAppender::_isEnabled ( )

static

Check if dynamic parameters are enabled.

Returns

Definition at line 181 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilSetting = $DIC['ilSetting'];
 
        return $ilSetting->get('links_dynamic', false) ? true : false;
    }

References $DIC, $ilSetting, and true.

Referenced by ilObjLinkResourceListGUI\__readLink(), ilObjLinkResourceGUI\callDirectLink(), ilObjLinkResourceGUI\callLink(), ilObjLinkResourceGUI\checkLinkInput(), ilWebResourceEditableLinkTableGUI\fillRow(), ilObjLinkResourceGUI\initFormLink(), ilObjLinkResourceGUI\saveAddLink(), ilObjLinkResourceGUI\setValuesFromLink(), and ilObjLinkResourceGUI\updateLink().

Here is the caller graph for this function:

◆ add()

ilParameterAppender::add ( $a_link_id )

Definition at line 137 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        if (!$a_link_id) {
            return false;
        }
        if (!strlen($this->getName() or !strlen($this->getValue()))) {
            return false;
        }
 
        $next_id = $ilDB->nextId('webr_params');
        $query = "INSERT INTO webr_params (param_id,webr_id,link_id,name,value) " .
            "VALUES( " .
            $ilDB->quote($next_id, 'integer') . ", " .
            $ilDB->quote($this->getObjId(), 'integer') . ", " .
            $ilDB->quote($a_link_id, 'integer') . ", " .
            $ilDB->quote($this->getName(), 'text') . ", " .
            $ilDB->quote($this->getValue(), 'integer') .
            ")";
        $res = $ilDB->manipulate($query);
 
        return $next_id;
    }

References $DIC, $ilDB, $query, $res, getName(), getObjId(), and getValue().

Here is the call graph for this function:

◆ delete()

ilParameterAppender::delete ( $a_param_id )

Definition at line 164 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        $query = "DELETE FROM webr_params " .
            "WHERE param_id = " . $ilDB->quote($a_param_id, 'integer') . " " .
            "AND webr_id = " . $ilDB->quote($this->getObjId(), 'integer');
        $res = $ilDB->manipulate($query);
        return true;
    }

References $DIC, $ilDB, $query, $res, and getObjId().

Here is the call graph for this function:

◆ getErrorCode()

ilParameterAppender::getErrorCode ( )

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

    {
        return $this->err;
    }

References $err.

◆ getName()

ilParameterAppender::getName ( )

Definition at line 106 of file class.ilParameterAppender.php.

    {
        return $this->name;
    }

References $name.

Referenced by add(), and validate().

Here is the caller graph for this function:

◆ getObjId()

ilParameterAppender::getObjId ( )

Definition at line 97 of file class.ilParameterAppender.php.

    {
        return $this->webr_id;
    }

References $webr_id.

Referenced by add(), and delete().

Here is the caller graph for this function:

◆ getParameterIds()

static ilParameterAppender::getParameterIds	(	$a_webr_id,
		$a_link_id
	)

static

Get Parameter ids of link.

Parameters

int	$a_webr_id
int	$a_link_id

Returns

Definition at line 70 of file class.ilParameterAppender.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        $query = "SELECT * FROM webr_params " .
            "WHERE webr_id = " . $ilDB->quote($a_webr_id, 'integer') . " " .
            "AND link_id = " . $ilDB->quote($a_link_id, 'integer');
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) {
            $params[] = $row['param_id'];
        }
        return (array) $params;
    }

References $DIC, $ilDB, $query, $res, and ilDBConstants\FETCHMODE_ASSOC.

Referenced by ilWebLinkXmlParser\handlerBeginTag().

Here is the caller graph for this function:

◆ getValue()

ilParameterAppender::getValue ( )

Definition at line 114 of file class.ilParameterAppender.php.

    {
        return $this->value;
    }

Referenced by add(), and validate().

Here is the caller graph for this function:

◆ parameterToInfo()

static ilParameterAppender::parameterToInfo	(	$a_name,
		$a_value
	)

static

Get info text describing an existing dynamic link.

Parameters

string	$a_name
int	$a_value

Returns

Definition at line 258 of file class.ilParameterAppender.php.

    {
        $info = $a_name;
        
        switch ($a_value) {
            case LINKS_USER_ID:
                return $info . '=USER_ID';
                
            case LINKS_SESSION_ID:
                return $info . '=SESSION_ID';
                
            case LINKS_LOGIN:
                return $info . '=LOGIN';
                
            case LINKS_MATRICULATION:
                return $info . '=MATRICULATION';
        }
        return '';
    }

References LINKS_LOGIN, LINKS_MATRICULATION, LINKS_SESSION_ID, and LINKS_USER_ID.

Referenced by ilWebResourceEditableLinkTableGUI\fillRow(), and ilObjLinkResourceGUI\initFormLink().

Here is the caller graph for this function:

◆ setName()

ilParameterAppender::setName ( $a_name )

Definition at line 102 of file class.ilParameterAppender.php.

    {
        $this->name = $a_name;
    }

◆ setObjId()

ilParameterAppender::setObjId ( $a_obj_id )

Definition at line 92 of file class.ilParameterAppender.php.

    {
        $this->webr_id = $a_obj_id;
    }

◆ setValue()

ilParameterAppender::setValue ( $a_value )

Definition at line 110 of file class.ilParameterAppender.php.

    {
        $this->value = $a_value;
    }

◆ validate()

ilParameterAppender::validate ( )

Definition at line 119 of file class.ilParameterAppender.php.

    {
        if (!strlen($this->getName()) and !$this->getValue()) {
            $this->err = LINKS_ERR_NO_NAME_VALUE;
            return false;
        }
        if (!strlen($this->getName())) {
            $this->err = LINKS_ERR_NO_NAME;
            return false;
        }
        if (!$this->getValue()) {
            $this->err = LINKS_ERR_NO_VALUE;
            return false;
        }
        return true;
    }