ilDclTableEditGUI Class Reference

Class ilDclBaseFieldModel. More...

Collaboration diagram for ilDclTableEditGUI:

Public Member Functions
	__construct (ilDclTableListGUI $a_parent_obj)
	Constructor. More...
	executeCommand ()
	execute command More...
	create ()
	create table add form More...
	edit ()
	create field edit form More...
	getValues ()
	getFieldValues More...
	getStandardValues ()
	getStandardValues More...
	cancel ()
	initForm ($a_mode="create")
	initEditCustomForm More...
	doTableSwitch ()
	save ($a_mode="create")
	save More...
	accessDenied ()
	confirmDelete ()
	confirmDelete More...
	cancelDelete ()
	cancelDelete More...
	delete ()

Protected Member Functions
	checkInput ($a_mode)
	Custom checks for the form input. More...
	checkAccess ()
	createTableSwitcher ()

Protected Attributes
	$lng
	$ctrl
	$tpl
	$toolbar
	$form

Private Attributes
	$table_id
	$table

Detailed Description

Class ilDclBaseFieldModel.

Author

Martin Studer ms@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Marcel Raimann mr@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Oskar Truffer ot@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Version

$Id:

Definition at line 16 of file class.ilDclTableEditGUI.php.

Constructor & Destructor Documentation

__construct()

ilDclTableEditGUI::__construct

(

ilDclTableListGUI

$a_parent_obj

)

Constructor.

Parameters

ilDclTableListGUI

$a_parent_obj

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

References $_GET, $DIC, $ilCtrl, $lng, $toolbar, $tpl, checkAccess(), ilDclCache\getTableCache(), and ilUtil\sendFailure().

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
        $tpl = $DIC['tpl'];
        $toolbar = $DIC['ilToolbar'];
        $locator = $DIC['ilLocator'];

        $this->ctrl = $ilCtrl;
        $this->lng = $lng;
        $this->tpl = $tpl;
        $this->toolbar = $toolbar;
        $this->parent_object = $a_parent_obj;
        $this->obj_id = $a_parent_obj->obj_id;
        $this->table_id = $_GET['table_id'];
        $this->table = ilDclCache::getTableCache($this->table_id);

        $this->ctrl->saveParameter($this, 'table_id');
        $locator->addItem($this->table->getTitle(), $this->ctrl->getLinkTarget($this, 'edit'));
        $this->tpl->setLocator();

        if (!$this->checkAccess()) {
            ilUtil::sendFailure($this->lng->txt('permission_denied'), true);
            $this->ctrl->redirectByClass('ildclrecordlistgui', 'listRecords');
        }
    }

Here is the call graph for this function:

Member Function Documentation

accessDenied()

ilDclTableEditGUI::accessDenied

(

)

Definition at line 427 of file class.ilDclTableEditGUI.php.

Referenced by save().

    {
        $this->tpl->setContent("Access denied.");
    }

Here is the caller graph for this function:

cancel()

ilDclTableEditGUI::cancel

(

)

Definition at line 191 of file class.ilDclTableEditGUI.php.

    {
        $this->ctrl->redirectByClass("ilDclTableListGUI", "listTables");
    }

cancelDelete()

ilDclTableEditGUI::cancelDelete

(

)

cancelDelete

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

    {
        $this->ctrl->redirectByClass("ilDclTableListGUI", "listTables");
    }

checkAccess()

ilDclTableEditGUI::checkAccess ( )

protected

Returns

bool

Definition at line 480 of file class.ilDclTableEditGUI.php.

References ilObjDataCollectionAccess\hasAccessToEditTable(), and ilObjDataCollectionAccess\hasWriteAccess().

Referenced by __construct().

    {
        $ref_id = $this->parent_object->getDataCollectionObject()->getRefId();
        return $this->table_id ? ilObjDataCollectionAccess::hasAccessToEditTable($ref_id, $this->table_id) : ilObjDataCollectionAccess::hasWriteAccess($ref_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkInput()

ilDclTableEditGUI::checkInput (   $a_mode )

protected

Custom checks for the form input.

Parameters

$a_mode

'create' | 'update'

Returns

bool

Definition at line 401 of file class.ilDclTableEditGUI.php.

References $title, ilObjDataCollection\_hasTableByTitle(), and ilUtil\sendFailure().

Referenced by save().

    {
        $return = $this->form->checkInput();

        // Title of table must be unique in one DC
        if ($a_mode == 'create') {
            if ($title = $this->form->getInput('title')) {
                if (ilObjDataCollection::_hasTableByTitle($title, $this->obj_id)) {
                    $inputObj = $this->form->getItemByPostVar('title');
                    $inputObj->setAlert($this->lng->txt("dcl_table_title_unique"));
                    $return = false;
                }
            }
        }

        if (!$return) {
            ilUtil::sendFailure($this->lng->txt("form_input_not_valid"));
        }

        return $return;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

confirmDelete()

ilDclTableEditGUI::confirmDelete

(

)

confirmDelete

Definition at line 436 of file class.ilDclTableEditGUI.php.

    {
        include_once './Services/Utilities/classes/class.ilConfirmationGUI.php';
        $conf = new ilConfirmationGUI();
        $conf->setFormAction($this->ctrl->getFormAction($this));
        $conf->setHeaderText($this->lng->txt('dcl_confirm_delete_table'));

        $conf->addItem('table', (int) $this->table->getId(), $this->table->getTitle());

        $conf->setConfirm($this->lng->txt('delete'), 'delete');
        $conf->setCancel($this->lng->txt('cancel'), 'cancelDelete');

        $this->tpl->setContent($conf->getHTML());
    }

create()

ilDclTableEditGUI::create

(

)

create table add form

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

References getStandardValues(), and initForm().

    {
        $this->initForm();
        $this->getStandardValues();
        $this->tpl->setContent($this->form->getHTML());
    }

Here is the call graph for this function:

createTableSwitcher()

ilDclTableEditGUI::createTableSwitcher ( )

protected

Parameters

$options

Returns

mixed

Definition at line 492 of file class.ilDclTableEditGUI.php.

References PHPMailer\PHPMailer\$options, $table, and ilSubmitButton\getInstance().

Referenced by initForm().

    {
        // Show tables
        $tables = $this->parent_object->getDataCollectionObject()->getTables();

        foreach ($tables as $table) {
            $options[$table->getId()] = $table->getTitle();
        }
        include_once './Services/Form/classes/class.ilSelectInputGUI.php';
        $table_selection = new ilSelectInputGUI('', 'table_id');
        $table_selection->setOptions($options);
        $table_selection->setValue($this->table->getId());

        $this->toolbar->setFormAction($this->ctrl->getFormActionByClass("ilDclTableEditGUI", "doTableSwitch"));
        $this->toolbar->addText($this->lng->txt("dcl_select"));
        $this->toolbar->addInputItem($table_selection);
        $button = ilSubmitButton::getInstance();
        $button->setCommand("doTableSwitch");
        $button->setCaption('change');
        $this->toolbar->addButtonInstance($button);

        return $options;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

delete()

ilDclTableEditGUI::delete

(

)

Definition at line 464 of file class.ilDclTableEditGUI.php.

References ilUtil\sendFailure().

    {
        if (count($this->table->getCollectionObject()->getTables()) < 2) {
            ilUtil::sendFailure($this->lng->txt("dcl_cant_delete_last_table"), true); //TODO change lng var
            $this->table->doDelete(true);
        } else {
            $this->table->doDelete(false);
        }

        $this->ctrl->redirectByClass("ildcltablelistgui", "listtables");
    }

Here is the call graph for this function:

doTableSwitch()

ilDclTableEditGUI::doTableSwitch

(

)

Definition at line 317 of file class.ilDclTableEditGUI.php.

References $_POST.

    {
        $this->ctrl->setParameter($this, "table_id", $_POST['table_id']);
        $this->ctrl->redirect($this, "edit");
    }

edit()

ilDclTableEditGUI::edit

(

)

create field edit form

Definition at line 117 of file class.ilDclTableEditGUI.php.

References ilDclCache\getTableCache(), getValues(), and initForm().

    {
        if (!$this->table_id) {
            $this->ctrl->redirectByClass("ildclfieldeditgui", "listFields");

            return;
        } else {
            $this->table = ilDclCache::getTableCache($this->table_id);
        }
        $this->initForm("edit");
        $this->getValues();
        $this->tpl->setContent($this->form->getHTML());
    }

Here is the call graph for this function:

executeCommand()

ilDclTableEditGUI::executeCommand

(

)

execute command

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

References save().

    {
        $cmd = $this->ctrl->getCmd();

        switch ($cmd) {
            case 'update':
                $this->save("update");
                break;
            default:
                $this->$cmd();
                break;
        }

        return true;
    }

Here is the call graph for this function:

getStandardValues()

ilDclTableEditGUI::getStandardValues

(

)

getStandardValues

Definition at line 168 of file class.ilDclTableEditGUI.php.

References $values.

Referenced by create().

    {
        $values = array(
            'title' => "",
            'add_perm' => 1,
            'edit_perm' => 1,
            'edit_perm_mode' => 'own',
            'delete_perm_mode' => 'own',
            'delete_perm' => 1,
            'edit_by_owner' => 1,
            'export_enabled' => 0,
            'import_enabled' => 0,
            'limited' => 0,
            'limit_start' => null,
            'limit_end' => null,
        );
        $this->form->setValuesByArray($values);
    }

Here is the caller graph for this function:

getValues()

ilDclTableEditGUI::getValues

(

)

getFieldValues

Definition at line 135 of file class.ilDclTableEditGUI.php.

References $values.

Referenced by edit().

    {
        $values = array(
            'title' => $this->table->getTitle(),
            'add_perm' => (int) $this->table->getAddPerm(),
            'edit_perm' => (int) $this->table->getEditPerm(),
            'edit_perm_mode' => $this->table->getEditByOwner() ? 'own' : 'all',
            'delete_perm' => (int) $this->table->getDeletePerm(),
            'delete_perm_mode' => $this->table->getDeleteByOwner() ? 'own' : 'all',
            'export_enabled' => $this->table->getExportEnabled(),
            'import_enabled' => $this->table->getImportEnabled(),
            'limited' => $this->table->getLimited(),
            'limit_start' => substr($this->table->getLimitStart(), 0, 10) . " " . substr($this->table->getLimitStart(), -8),
            'limit_end' => substr($this->table->getLimitEnd(), 0, 10) . " " . substr($this->table->getLimitEnd(), -8),
            'default_sort_field' => $this->table->getDefaultSortField(),
            'default_sort_field_order' => $this->table->getDefaultSortFieldOrder(),
            'description' => $this->table->getDescription(),
            'view_own_records_perm' => $this->table->getViewOwnRecordsPerm(),
            'save_confirmation' => $this->table->getSaveConfirmation(),
        );
        if (!$this->table->getLimitStart()) {
            $values['limit_start'] = null;
        }
        if (!$this->table->getLimitEnd()) {
            $values['limit_end'] = null;
        }
        $this->form->setValuesByArray($values);
    }

Here is the caller graph for this function:

initForm()

ilDclTableEditGUI::initForm

(

$a_mode = "create"

)

initEditCustomForm

Parameters

string

$a_mode

Definition at line 202 of file class.ilDclTableEditGUI.php.

References PHPMailer\PHPMailer\$options, $section, createTableSwitcher(), ilFormPropertyGUI\setInfo(), ilFormPropertyGUI\setRequired(), ilDateTimeInputGUI\setShowTime(), and ilTextAreaInputGUI\setUseRte().

Referenced by create(), edit(), and save().

    {
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $this->form = new ilPropertyFormGUI();

        $item = new ilTextInputGUI($this->lng->txt('title'), 'title');
        $item->setRequired(true);
        $this->form->addItem($item);

        // Show default order field, direction and tableswitcher only in edit mode, because table id is not yet given and there are no fields to select
        if ($a_mode != 'create') {
            $this->createTableSwitcher();

            $item = new ilSelectInputGUI($this->lng->txt('dcl_default_sort_field'), 'default_sort_field');
            $item->setInfo($this->lng->txt('dcl_default_sort_field_desc'));
            $fields = $this->table->getFields();
            $options = array(0 => $this->lng->txt('dcl_please_select'));
            foreach ($fields as $field) {
                if ($field->getId() == 'comments') {
                    continue;
                }
                $options[$field->getId()] = $field->getTitle();
            }
            $item->setOptions($options);
            $this->form->addItem($item);

            $item = new ilSelectInputGUI($this->lng->txt('dcl_default_sort_field_order'), 'default_sort_field_order');
            $options = array('asc' => $this->lng->txt('dcl_asc'), 'desc' => $this->lng->txt('dcl_desc'));
            $item->setOptions($options);
            $this->form->addItem($item);
        }

        $item = new ilTextAreaInputGUI($this->lng->txt('additional_info'), 'description');
        $item->setUseRte(true);
        $item->setInfo($this->lng->txt('dcl_additional_info_desc'));
        //        $item->setRTESupport($this->table->getId(), 'dcl', 'table_settings');
        $item->setRteTagSet('mini');
        $this->form->addItem($item);

        $section = new ilFormSectionHeaderGUI();
        $section->setTitle($this->lng->txt('dcl_permissions_form'));
        $this->form->addItem($section);

        $item = new ilCustomInputGUI();
        $item->setHtml($this->lng->txt('dcl_table_info'));
        $item->setTitle($this->lng->txt('dcl_table_info_title'));
        $this->form->addItem($item);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_add_perm'), 'add_perm');
        $item->setInfo($this->lng->txt("dcl_add_perm_desc"));
        $this->form->addItem($item);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_save_confirmation'), 'save_confirmation');
        $item->setInfo($this->lng->txt('dcl_save_confirmation_desc'));
        $this->form->addItem($item);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_edit_perm'), 'edit_perm');
        //              $item->setInfo($this->lng->txt("dcl_edit_perm_info"));
        $this->form->addItem($item);

        $radios = new ilRadioGroupInputGUI('', 'edit_perm_mode');
        $radios->addOption(new ilRadioOption($this->lng->txt('dcl_all_entries'), 'all'));
        $radios->addOption(new ilRadioOption($this->lng->txt('dcl_own_entries'), 'own'));
        $item->addSubItem($radios);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_delete_perm'), 'delete_perm');
        //              $item->setInfo($this->lng->txt("dcl_delete_perm_info"));
        $this->form->addItem($item);

        $radios = new ilRadioGroupInputGUI('', 'delete_perm_mode');
        $radios->addOption(new ilRadioOption($this->lng->txt('dcl_all_entries'), 'all'));
        $radios->addOption(new ilRadioOption($this->lng->txt('dcl_own_entries'), 'own'));
        $item->addSubItem($radios);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_view_own_records_perm'), 'view_own_records_perm');
        //              $item->setInfo($this->lng->txt("dcl_edit_by_owner_info"));
        $this->form->addItem($item);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_export_enabled'), 'export_enabled');
        $item->setInfo($this->lng->txt('dcl_export_enabled_desc'));
        $this->form->addItem($item);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_import_enabled'), 'import_enabled');
        $item->setInfo($this->lng->txt('dcl_import_enabled_desc'));
        $this->form->addItem($item);

        $item = new ilCheckboxInputGUI($this->lng->txt('dcl_limited'), 'limited');
        $sitem1 = new ilDateTimeInputGUI($this->lng->txt('dcl_limit_start'), 'limit_start');
        $sitem1->setShowTime(true);
        $sitem2 = new ilDateTimeInputGUI($this->lng->txt('dcl_limit_end'), 'limit_end');
        $sitem2->setShowTime(true);
        $item->setInfo($this->lng->txt("dcl_limited_desc"));
        $item->addSubItem($sitem1);
        $item->addSubItem($sitem2);
        $this->form->addItem($item);

        if ($a_mode == "edit") {
            $this->form->addCommandButton('update', $this->lng->txt('dcl_table_' . $a_mode));
        } else {
            $this->form->addCommandButton('save', $this->lng->txt('dcl_table_' . $a_mode));
        }

        $this->form->addCommandButton('cancel', $this->lng->txt('cancel'));
        $this->form->setFormAction($this->ctrl->getFormAction($this, $a_mode));
        if ($a_mode == "edit") {
            $this->form->setTitle($this->lng->txt('dcl_edit_table'));
        } else {
            $this->form->setTitle($this->lng->txt('dcl_new_table'));
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

save()

ilDclTableEditGUI::save

(

$a_mode = "create"

)

save

Parameters

string

$a_mode

values: create | edit

Definition at line 329 of file class.ilDclTableEditGUI.php.

References $DIC, accessDenied(), ilObjDataCollectionAccess\checkActionForObjId(), checkInput(), ilDclCache\getTableCache(), and initForm().

Referenced by executeCommand().

    {
        global $DIC;
        $ilTabs = $DIC['ilTabs'];

        if (!ilObjDataCollectionAccess::checkActionForObjId('write', $this->obj_id)) {
            $this->accessDenied();

            return;
        }

        $ilTabs->activateTab("id_fields");
        $this->initForm($a_mode);

        if ($this->checkInput($a_mode)) {
            if ($a_mode != "update") {
                $this->table = ilDclCache::getTableCache();
            } elseif ($this->table_id) {
                $this->table = ilDclCache::getTableCache($this->table_id);
            } else {
                $this->ctrl->redirectByClass("ildclfieldeditgui", "listFields");
            }

            $this->table->setTitle($this->form->getInput("title"));
            $this->table->setObjId($this->obj_id);
            $this->table->setSaveConfirmation((bool) $this->form->getInput('save_confirmation'));
            $this->table->setAddPerm((bool) $this->form->getInput("add_perm"));
            $this->table->setEditPerm((bool) $this->form->getInput("edit_perm"));
            if ($this->table->getEditPerm()) {
                $edit_by_owner = ($this->form->getInput('edit_perm_mode') == 'own');
                $this->table->setEditByOwner($edit_by_owner);
            }
            $this->table->setDeletePerm((bool) $this->form->getInput("delete_perm"));
            if ($this->table->getDeletePerm()) {
                $delete_by_owner = ($this->form->getInput('delete_perm_mode') == 'own');
                $this->table->setDeleteByOwner($delete_by_owner);
            }
            $this->table->setViewOwnRecordsPerm($this->form->getInput('view_own_records_perm'));
            $this->table->setExportEnabled($this->form->getInput("export_enabled"));
            $this->table->setImportEnabled($this->form->getInput("import_enabled"));
            $this->table->setDefaultSortField($this->form->getInput("default_sort_field"));
            $this->table->setDefaultSortFieldOrder($this->form->getInput("default_sort_field_order"));
            $this->table->setLimited($this->form->getInput("limited"));
            $this->table->setDescription($this->form->getInput('description'));
            $limit_start = $this->form->getInput("limit_start");
            $limit_end = $this->form->getInput("limit_end");
            $this->table->setLimitStart($limit_start);
            $this->table->setLimitEnd($limit_end);
            if ($a_mode == "update") {
                $this->table->doUpdate();
                ilUtil::sendSuccess($this->lng->txt("dcl_msg_table_edited"), true);
                $this->ctrl->redirectByClass("ildcltableeditgui", "edit");
            } else {
                $this->table->doCreate();
                ilUtil::sendSuccess($this->lng->txt("dcl_msg_table_created"), true);
                $this->ctrl->setParameterByClass("ildclfieldlistgui", "table_id", $this->table->getId());
                $this->ctrl->redirectByClass("ildclfieldlistgui", "listFields");
            }
        } else {
            $this->form->setValuesByPost();
            $this->tpl->setContent($this->form->getHTML());
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$ctrl

ilDclTableEditGUI::$ctrl

protected

Definition at line 34 of file class.ilDclTableEditGUI.php.

$form

ilDclTableEditGUI::$form

protected

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

$lng

ilDclTableEditGUI::$lng

protected

Definition at line 30 of file class.ilDclTableEditGUI.php.

Referenced by __construct().

$table

ilDclTableEditGUI::$table

private

Definition at line 26 of file class.ilDclTableEditGUI.php.

Referenced by createTableSwitcher().

$table_id

ilDclTableEditGUI::$table_id

private

Definition at line 22 of file class.ilDclTableEditGUI.php.

$toolbar

ilDclTableEditGUI::$toolbar

protected

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

Referenced by __construct().

$tpl

ilDclTableEditGUI::$tpl

protected

Definition at line 38 of file class.ilDclTableEditGUI.php.

Referenced by __construct().

---

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

• Modules/DataCollection/classes/Table/class.ilDclTableEditGUI.php