Inheritance diagram for ilMemberExportGUI:

Collaboration diagram for ilMemberExportGUI:

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

	executeCommand ()

	initCSV (?ilPropertyFormGUI $a_form=null)

	initExcel (?ilPropertyFormGUI $a_form=null)

	show ()

	export ()
	Export, create member export file and store it in data directory. More...

	exportExcel ()

	deliverData ()

	showFileList ()
	Show file list of available export files. More...

	downloadExportFile ()
	Download export file. More...

	confirmDeleteExportFile ()
	Confirm deletion of export files. More...

	deleteExportFile ()
	Delete member export files. More...

Protected Member Functions
	initSettingsForm (bool $a_is_excel=false)

	handleIncoming ()

	initFileIdsFromPost ()

	initFileSystemStorage ()

Protected Attributes
GlobalHttpState	$http

Factory	$refinery

ilCtrl	$ctrl

ilGlobalTemplateInterface	$tpl

ilLanguage	$lng

ilToolbarGUI	$toolbar

Profile	$profile

ilMemberExport	$export = null

ilExportFieldsInfo	$fields_info = null

ilFileSystemAbstractionStorage	$fss_export = null

ilUserFormSettings	$exportSettings

Private Attributes
int	$ref_id

int	$obj_id

string	$type

Detailed Description

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om \

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

Constructor & Destructor Documentation

◆ __construct()

ilMemberExportGUI::__construct ( int $a_ref_id )

Constructor @access public.

Parameters

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

    {
        global $DIC;
 
        $this->http = $DIC->http();
        $this->refinery = $DIC->refinery();
 
        $this->ctrl = $DIC->ctrl();
        $this->tpl = $DIC->ui()->mainTemplate();
        $this->toolbar = $DIC->toolbar();
        $this->profile = $DIC['user']->getProfile();
        $this->lng = $DIC->language();
        $this->lng->loadLanguageModule('ps');
        $this->ref_id = $a_ref_id;
        $this->obj_id = ilObject::_lookupObjId($this->ref_id);
        $this->type = ilObject::_lookupType($this->obj_id);
 
        $this->fields_info = ilExportFieldsInfo::_getInstanceByType($this->type);
        $this->initFileSystemStorage();
    }

References $DIC, ilExportFieldsInfo\_getInstanceByType(), ilObject\_lookupObjId(), ilObject\_lookupType(), ILIAS\Repository\ctrl(), ILIAS\FileDelivery\http(), initFileSystemStorage(), ILIAS\Repository\lng(), ILIAS\Repository\profile(), ILIAS\Repository\refinery(), and ILIAS\Repository\toolbar().

Here is the call graph for this function:

Member Function Documentation

◆ confirmDeleteExportFile()

ilMemberExportGUI::confirmDeleteExportFile ( )

Confirm deletion of export files.

Definition at line 386 of file class.ilMemberExportGUI.php.

                                             : void
    {
        $file_ids = $this->initFileIdsFromPost();
        if (!count($file_ids)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('ps_select_one'), true);
            $this->ctrl->redirect($this, 'show');
        }
        $confirmation_gui = new ilConfirmationGUI();
        $confirmation_gui->setFormAction($this->ctrl->getFormAction($this));
        $confirmation_gui->setHeaderText($this->lng->txt('info_delete_sure') /* .' '.$this->lng->txt('ps_delete_export_files') */);
        $confirmation_gui->setCancel($this->lng->txt('cancel'), 'show');
        $confirmation_gui->setConfirm($this->lng->txt('delete'), 'deleteExportFile');
        foreach ($this->fss_export->getMemberExportFiles() as $file) {
            if (!in_array(md5($file['name']), $file_ids)) {
                continue;
            }
            $confirmation_gui->addItem(
                "id[]",
                md5($file['name']),
                strtoupper($file['type']) . ' - ' .
                ilDatePresentation::formatDate(new ilDateTime($file['timest'], IL_CAL_UNIX))
            );
        }
        $this->tpl->setContent($confirmation_gui->getHTML());
    }

References ILIAS\Repository\ctrl(), ilDatePresentation\formatDate(), IL_CAL_UNIX, initFileIdsFromPost(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ deleteExportFile()

ilMemberExportGUI::deleteExportFile ( )

Delete member export files.

Reimplemented in ilPRGMembersExportGUI.

Definition at line 415 of file class.ilMemberExportGUI.php.

                                      : void
    {
        $file_ids = $this->initFileIdsFromPost();
        if (!count($file_ids)) {
            $this->ctrl->redirect($this, 'show');
        }
        foreach ($this->fss_export->getMemberExportFiles() as $file) {
            if (!in_array(md5($file['name']), $file_ids)) {
                continue;
            }
 
            $path = $file['timest'] . '_participant_export_' .
                $file['type'] . '_' . $this->obj_id . '.' . $file['type'];
            if ($this->fss_export->hasMemberExportFile($path)) {
                $this->fss_export->deleteMemberExportFile($path);
                continue;
            }
 
            if ($file['type'] !== "xls") {
                continue;
            }
            //try xlsx if type is xls and file can't be found
            $path = $file['timest'] . '_participant_export_xls_' . $this->obj_id . '.xlsx';
            if ($this->fss_export->hasMemberExportFile($path)) {
                $this->fss_export->deleteMemberExportFile($path);
            }
        }
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('ps_files_deleted'), true);
        $this->ctrl->redirect($this, 'show');
    }

References $path, ILIAS\Repository\ctrl(), initFileIdsFromPost(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ deliverData()

ilMemberExportGUI::deliverData ( )

Definition at line 276 of file class.ilMemberExportGUI.php.

                                 : void
    {
        foreach ($this->fss_export->getMemberExportFiles() as $file) {
            $member_export_filename = (string) ilSession::get('member_export_filename');
            if ($file['name'] === $member_export_filename) {
                $content = $this->fss_export->getMemberExportFile($member_export_filename);
                ilUtil::deliverData(
                    $content,
                    date('Y_m_d_H-i', $file['timest']) .
                    '_member_export_' .
                    $this->obj_id .
                    '.csv',
                    'text/csv'
                );
            }
        }
    }

References ilUtil\deliverData(), and ilSession\get().

Here is the call graph for this function:

◆ downloadExportFile()

ilMemberExportGUI::downloadExportFile ( )

Download export file.

Reimplemented in ilPRGMembersExportGUI.

Definition at line 306 of file class.ilMemberExportGUI.php.

                                        : void
    {
        $fl = '';
        if ($this->http->wrapper()->query()->has('fl')) {
            $fl = $this->http->wrapper()->query()->retrieve(
                'fl',
                $this->refinery->kindlyTo()->string()
            );
        }
 
        $hash = trim($fl);
        if (!$hash) {
            $this->ctrl->redirect($this, 'show');
        }
 
        foreach ($this->fss_export->getMemberExportFiles() as $file) {
            if (md5($file['name']) === $hash) {
                $contents = $this->fss_export->getMemberExportFile($file['timest'] . '_participant_export_' .
                    $file['type'] . '_' . $this->obj_id . '.' . $file['type']);
 
                // newer export files could be .xlsx
                if ($file['type'] === 'xls' && !$contents) {
                    $contents = $this->fss_export->getMemberExportFile($file['timest'] . '_participant_export_' .
                        $file['type'] . '_' . $this->obj_id . '.xlsx');
                    $file['type'] = 'xlsx';
                }
 
                switch ($file['type']) {
                    case 'xlsx':
                        ilUtil::deliverData(
                            $contents,
                            date('Y_m_d_H-i' . $file['timest']) . '_member_export_' . $this->obj_id . '.xlsx',
                            'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
                        );
 
                        // no break
                    case 'xls':
                        ilUtil::deliverData(
                            $contents,
                            date('Y_m_d_H-i' . $file['timest']) . '_member_export_' . $this->obj_id . '.xls',
                            'application/vnd.ms-excel'
                        );
 
                        // no break
                    default:
                    case 'csv':
                        ilUtil::deliverData(
                            $contents,
                            date('Y_m_d_H-i' . $file['timest']) .
                            '_member_export_' .
                            $this->obj_id .
                            '.csv',
                            'text/csv'
                        );
                        break;
                }
            }
        }
    }

References ILIAS\Repository\ctrl(), ilUtil\deliverData(), ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

◆ executeCommand()

ilMemberExportGUI::executeCommand ( )

Definition at line 76 of file class.ilMemberExportGUI.php.

                                    : void
    {
        if (!ilPrivacySettings::getInstance()->checkExportAccess($this->ref_id)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('permission_denied'), true);
            $this->ctrl->returnToParent($this);
        }
 
        $next_class = $this->ctrl->getNextClass($this);
        $cmd = $this->ctrl->getCmd();
 
        switch ($next_class) {
            default:
                if (!$cmd) {
                    $cmd = 'show';
                }
                $this->$cmd();
                break;
        }
    }

References ILIAS\Repository\ctrl(), ilPrivacySettings\getInstance(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ export()

ilMemberExportGUI::export ( )

Export, create member export file and store it in data directory.

Reimplemented in ilPRGMembersExportGUI.

Definition at line 249 of file class.ilMemberExportGUI.php.

                            : void
    {
        $this->handleIncoming();
 
        $this->export = new ilMemberExport($this->ref_id);
        $this->export->create();
 
        $filename = time() . '_participant_export_csv_' . $this->obj_id . '.csv';
        $this->fss_export->addMemberExportFile($this->export->getCSVString(), $filename);
        $this->ctrl->redirect($this, 'show');
    }

References $filename, ILIAS\Repository\ctrl(), export(), and handleIncoming().

Referenced by export(), and exportExcel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportExcel()

ilMemberExportGUI::exportExcel ( )

Reimplemented in ilPRGMembersExportGUI.

Definition at line 261 of file class.ilMemberExportGUI.php.

                                 : void
    {
        $this->handleIncoming();
 
        $filename = time() . '_participant_export_xls_' . $this->obj_id;
        $this->fss_export->initMemberExportDirectory();
        $filepath = $this->fss_export->getMemberExportDirectory() . DIRECTORY_SEPARATOR . $filename;
 
        $this->export = new ilMemberExport($this->ref_id, ilMemberExport::EXPORT_EXCEL);
        $this->export->setFilename($filepath);
        $this->export->create();
 
        $this->ctrl->redirect($this, 'show');
    }

References $filename, $obj_id, ILIAS\Repository\ctrl(), export(), ilMemberExport\EXPORT_EXCEL, and handleIncoming().

Here is the call graph for this function:

◆ handleIncoming()

ilMemberExportGUI::handleIncoming ( )

protected

Reimplemented in ilPRGMembersExportGUI.

Definition at line 222 of file class.ilMemberExportGUI.php.

                                       : void
    {
        $settings = [];
        $incoming = [];
        if ($this->http->wrapper()->post()->has('export_members')) {
            $incoming = $this->http->wrapper()->post()->retrieve(
                'export_members',
                $this->refinery->kindlyTo()->dictOf(
                    $this->refinery->kindlyTo()->string()
                )
            );
        }
        if (count($incoming)) {
            foreach ($incoming as $id) {
                $settings[$id] = true;
            }
        }
 
        // Save (form) settings
        $this->exportSettings = new ilUserFormSettings('memexp');
        $this->exportSettings->set($settings);
        $this->exportSettings->store();
    }

References $id, ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by export(), and exportExcel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initCSV()

ilMemberExportGUI::initCSV ( ?ilPropertyFormGUI $a_form = null )

Definition at line 192 of file class.ilMemberExportGUI.php.

                                                              : void
    {
        if (!$a_form) {
            $a_form = $this->initSettingsForm();
        }
        $this->tpl->setContent($a_form->getHTML());
    }

References initSettingsForm().

Here is the call graph for this function:

◆ initExcel()

ilMemberExportGUI::initExcel ( ?ilPropertyFormGUI $a_form = null )

Definition at line 200 of file class.ilMemberExportGUI.php.

                                                                : void
    {
        if (!$a_form) {
            $a_form = $this->initSettingsForm(true);
        }
        $this->tpl->setContent($a_form->getHTML());
    }

References initSettingsForm().

Here is the call graph for this function:

◆ initFileIdsFromPost()

ilMemberExportGUI::initFileIdsFromPost ( )

protected

Returns: string[]

Definition at line 369 of file class.ilMemberExportGUI.php.

                                            : array
    {
        $ids = [];
        if ($this->http->wrapper()->post()->has('id')) {
            $ids = $this->http->wrapper()->post()->retrieve(
                'id',
                $this->refinery->kindlyTo()->listOf(
                    $this->refinery->kindlyTo()->string()
                )
            );
        }
        return $ids;
    }

References ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by confirmDeleteExportFile(), deleteExportFile(), and ilPRGMembersExportGUI\deleteExportFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFileSystemStorage()

ilMemberExportGUI::initFileSystemStorage ( )

protected

Reimplemented in ilPRGMembersExportGUI.

Definition at line 447 of file class.ilMemberExportGUI.php.

                                              : void
    {
        if ($this->type === 'crs') {
            $this->fss_export = new ilFSStorageCourse($this->obj_id);
        }
        if ($this->type === 'grp') {
            $this->fss_export = new ilFSStorageGroup($this->obj_id);
        }
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ initSettingsForm()

ilMemberExportGUI::initSettingsForm ( bool $a_is_excel = false )

protected

Reimplemented in ilPRGMembersExportGUI.

Definition at line 96 of file class.ilMemberExportGUI.php.

                                                                 : ilPropertyFormGUI
    {
        // Check user selection
        $this->exportSettings = new ilUserFormSettings('memexp');
 
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setTitle($this->lng->txt('ps_export_settings'));
 
        if ($a_is_excel) {
            $form->addCommandButton('exportExcel', $this->lng->txt('ps_export_excel'));
        } else {
            $form->addCommandButton('export', $this->lng->txt('ps_perform_export'));
        }
        $form->addCommandButton('show', $this->lng->txt('cancel'));
 
        // roles
        $roles = new ilCheckboxGroupInputGUI($this->lng->txt('ps_user_selection'), 'export_members');
        $roles->addOption(new ilCheckboxOption($this->lng->txt('ps_export_admin'), 'admin'));
        if ($this->type === 'crs') {
            $roles->addOption(new ilCheckboxOption($this->lng->txt('ps_export_tutor'), 'tutor'));
        }
        $roles->addOption(new ilCheckboxOption($this->lng->txt('ps_export_member'), 'member'));
        $roles->addOption(new ilCheckboxOption($this->lng->txt('ps_export_sub'), 'subscribers'));
        $roles->addOption(new ilCheckboxOption($this->lng->txt('ps_export_wait'), 'waiting_list'));
        $form->addItem($roles);
        $current_roles = array();
        foreach (array('admin', 'tutor', 'member', 'subscribers', 'waiting_list') as $role) {
            if ($this->exportSettings->enabled($role)) {
                $current_roles[] = $role;
            }
        }
        $roles->setValue($current_roles);
 
        // user data
        $current_udata = array();
        $udata = new ilCheckboxGroupInputGUI($this->lng->txt('ps_export_user_data'), 'export_members');
        $form->addItem($udata);
 
        // standard fields
        $this->fields_info->sortExportFields();
        foreach ($this->fields_info->getFieldsInfo() as $field => $exportable) {
            if (!$exportable) {
                continue;
            }
            $udata->addOption(new ilCheckboxOption($this->lng->txt($field), $field));
            if ($this->exportSettings->enabled($field)) {
                $current_udata[] = $field;
            }
        }
 
        // udf
        foreach ($this->profile->getVisibleUserDefinedFields(Context::buildFromObjectType($this->type)) as $field) {
            $field_id = 'udf_' . $field->getIdentifier();
            $udata->addOption(new ilCheckboxOption($field->getLabel($this->lng), $field_id));
            if ($this->exportSettings->enabled($field_id)) {
                $current_udata[] = $field_id;
            }
        }
 
        $udata->setValue($current_udata);
 
        // course custom data
        $cdf_fields = ilCourseDefinedFieldDefinition::_getFields($this->obj_id);
        if (count($cdf_fields)) {
            $cdf = new ilCheckboxGroupInputGUI($this->lng->txt('ps_' . $this->type . '_user_fields'), 'export_members');
            $form->addItem($cdf);
 
            $current_cdf = array();
            foreach ($cdf_fields as $field_obj) {
                $field = 'cdf_' . $field_obj->getId();
                $cdf->addOption(new ilCheckboxOption($field_obj->getName(), $field));
                if ($this->exportSettings->enabled($field)) {
                    $current_cdf[] = $field;
                }
            }
 
            $cdf->setValue($current_cdf);
        }
 
        // consultation hours
        if (ilBookingEntry::hasObjectBookingEntries($this->obj_id, $GLOBALS['DIC']['ilUser']->getId())) {
            $this->lng->loadLanguageModule('dateplaner');
            $chours = new ilCheckboxInputGUI($this->lng->txt('cal_ch_field_ch'), 'export_members[]');
            $chours->setValue('consultation_hour');
            $chours->setChecked($this->exportSettings->enabled('consultation_hour'));
            $form->addItem($chours);
        }
 
        $grp_membr = new ilCheckboxInputGUI($this->lng->txt('crs_members_groups'), 'export_members[]');
        $grp_membr->setValue('group_memberships');
        $grp_membr->setChecked($this->exportSettings->enabled('group_memberships'));
        $form->addItem($grp_membr);
        return $form;
    }

References $GLOBALS, ilCourseDefinedFieldDefinition\_getFields(), ILIAS\Repository\ctrl(), ILIAS\Survey\Mode\getId(), ilBookingEntry\hasObjectBookingEntries(), ILIAS\Repository\lng(), and ILIAS\Repository\profile().

Referenced by initCSV(), and initExcel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ show()

ilMemberExportGUI::show ( )

Definition at line 208 of file class.ilMemberExportGUI.php.

                          : void
    {
        $this->toolbar->addButton(
            $this->lng->txt('ps_perform_export'),
            $this->ctrl->getLinkTarget($this, "initCSV")
        );
        $this->toolbar->addButton(
            $this->lng->txt('ps_export_excel'),
            $this->ctrl->getLinkTarget($this, "initExcel")
        );
 
        $this->showFileList();
    }

References ILIAS\Repository\lng(), showFileList(), and ILIAS\Repository\toolbar().

Here is the call graph for this function:

◆ showFileList()

ilMemberExportGUI::showFileList ( )

Show file list of available export files.

Definition at line 297 of file class.ilMemberExportGUI.php.

                                  : void
    {
        $tbl = new ilMemberExportFileTableGUI($this, 'show', $this->fss_export);
        $this->tpl->setContent($tbl->getHTML());
    }