class.ilCronManagerGUI.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

include_once "Services/Cron/classes/class.ilCronManager.php";

class ilCronManagerGUI
{
    public function executeCommand()
    {
        global $ilCtrl, $lng;
        
        $lng->loadLanguageModule("cron");

        $cmd = $ilCtrl->getCmd("render");
        $this->$cmd();
        
        return true;
    }
    
    public function render()
    {
        global $tpl, $ilSetting, $lng;
        
        if ($ilSetting->get('last_cronjob_start_ts')) {
            $tstamp = ilDatePresentation::formatDate(new ilDateTime($ilSetting->get('last_cronjob_start_ts'), IL_CAL_UNIX));
        } else {
            $tstamp = $lng->txt('cronjob_last_start_unknown');
        }
        ilUtil::sendInfo($lng->txt('cronjob_last_start') . ": " . $tstamp);
        
        include_once "Services/Cron/classes/class.ilCronManagerTableGUI.php";
        $tbl = new ilCronManagerTableGUI($this, "render");
        $tpl->setContent($tbl->getHTML());
    }
    
    public function edit(ilPropertyFormGUI $a_form = null)
    {
        global $ilCtrl, $tpl;
        
        $id = $_REQUEST["jid"];
        if (!$id) {
            $ilCtrl->redirect($this, "render");
        }
        
        if (!$a_form) {
            $a_form = $this->initEditForm($id);
        }
        
        $tpl->setContent($a_form->getHTML());
    }
    
    public function initEditForm($a_job_id)
    {
        global $ilCtrl, $lng;
        
        $job = ilCronManager::getJobInstanceById($a_job_id);
        if (!$job) {
            $ilCtrl->redirect($this, "render");
        }
        
        $ilCtrl->setParameter($this, "jid", $a_job_id);
        
        $data = array_pop(ilCronManager::getCronJobData($job->getId()));
        
        include_once("Services/Cron/classes/class.ilCronJob.php");
        include_once("Services/Form/classes/class.ilPropertyFormGUI.php");
        $form = new ilPropertyFormGUI();
        $form->setFormAction($ilCtrl->getFormAction($this, "update"));
        $form->setTitle($lng->txt("cron_action_edit") . ': "' . $job->getTitle() . '"');
        
        if ($job->hasFlexibleSchedule()) {
            $type = new ilRadioGroupInputGUI($lng->txt("cron_schedule_type"), "type");
            $type->setRequired(true);
            $type->setValue($data["schedule_type"]);
            $type->addOption(new ilRadioOption($lng->txt("cron_schedule_daily"), ilCronJob::SCHEDULE_TYPE_DAILY));
            $type->addOption(new ilRadioOption($lng->txt("cron_schedule_weekly"), ilCronJob::SCHEDULE_TYPE_WEEKLY));
            $type->addOption(new ilRadioOption($lng->txt("cron_schedule_monthly"), ilCronJob::SCHEDULE_TYPE_MONTHLY));
            $type->addOption(new ilRadioOption($lng->txt("cron_schedule_quarterly"), ilCronJob::SCHEDULE_TYPE_QUARTERLY));
            $type->addOption(new ilRadioOption($lng->txt("cron_schedule_yearly"), ilCronJob::SCHEDULE_TYPE_YEARLY));

            $min = new ilRadioOption(
                sprintf($lng->txt("cron_schedule_in_minutes"), "x"),
                ilCronJob::SCHEDULE_TYPE_IN_MINUTES
            );
            $mini = new ilNumberInputGUI($lng->txt("cron_schedule_value"), "smini");
            $mini->setRequired(true);
            $mini->setSize(5);
            if ($data["schedule_type"] == ilCronJob::SCHEDULE_TYPE_IN_MINUTES) {
                $mini->setValue($data["schedule_value"]);
            }
            $min->addSubItem($mini);
            $type->addOption($min);

            $hr = new ilRadioOption(
                sprintf($lng->txt("cron_schedule_in_hours"), "x"),
                ilCronJob::SCHEDULE_TYPE_IN_HOURS
            );
            $hri = new ilNumberInputGUI($lng->txt("cron_schedule_value"), "shri");
            $hri->setRequired(true);
            $hri->setSize(5);
            if ($data["schedule_type"] == ilCronJob::SCHEDULE_TYPE_IN_HOURS) {
                $hri->setValue($data["schedule_value"]);
            }
            $hr->addSubItem($hri);
            $type->addOption($hr);

            $dy = new ilRadioOption(
                sprintf($lng->txt("cron_schedule_in_days"), "x"),
                ilCronJob::SCHEDULE_TYPE_IN_DAYS
            );
            $dyi = new ilNumberInputGUI($lng->txt("cron_schedule_value"), "sdyi");
            $dyi->setRequired(true);
            $dyi->setSize(5);
            if ($data["schedule_type"] == ilCronJob::SCHEDULE_TYPE_IN_DAYS) {
                $dyi->setValue($data["schedule_value"]);
            }
            $dy->addSubItem($dyi);
            $type->addOption($dy);

            $form->addItem($type);
        }
        
        if ($job->hasCustomSettings()) {
            $job->addCustomSettingsToForm($form);
        }
        
        $form->addCommandButton("update", $lng->txt("save"));
        $form->addCommandButton("render", $lng->txt("cancel"));
        
        return $form;
    }
    
    public function update()
    {
        global $ilCtrl, $lng;
        
        $id = $_REQUEST["jid"];
        if (!$id) {
            $ilCtrl->redirect($this, "render");
        }
        
        $form = $this->initEditForm($id);
        if ($form->checkInput()) {
            $job = ilCronManager::getJobInstanceById($id);
            if ($job) {
                $valid = true;
                if ($job->hasCustomSettings() &&
                    !$job->saveCustomSettings($form)) {
                    $valid = false;
                }
                
                if ($valid && $job->hasFlexibleSchedule()) {
                    $type = $form->getInput("type");
                    switch ($type) {
                        case ilCronJob::SCHEDULE_TYPE_IN_MINUTES:
                            $value = $form->getInput("smini");
                            break;

                        case ilCronJob::SCHEDULE_TYPE_IN_HOURS:
                            $value = $form->getInput("shri");
                            break;

                        case ilCronJob::SCHEDULE_TYPE_IN_DAYS:
                            $value = $form->getInput("sdyi");
                            break;

                        default:
                            $value = null;
                    }

                    ilCronManager::updateJobSchedule($job, $type, $value);
                }
                if ($valid) {
                    ilUtil::sendSuccess($lng->txt("cron_action_edit_success"), true);
                    $ilCtrl->redirect($this, "render");
                }
            }
        }
        
        $form->setValuesByPost();
        $this->edit($form);
    }
        
    public function run()
    {
        $this->confirm("run");
    }
    
    public function confirmedRun()
    {
        global $ilCtrl, $lng;
        
        $job_id = $_GET["jid"];
        if ($job_id) {
            if (ilCronManager::runJobManual($job_id)) {
                ilUtil::sendSuccess($lng->txt("cron_action_run_success"), true);
            } else {
                ilUtil::sendFailure($lng->txt("cron_action_run_fail"), true);
            }
        }
        
        $ilCtrl->redirect($this, "render");
    }
    
    public function activate()
    {
        $this->confirm("activate");
    }
    
    public function confirmedActivate()
    {
        global $ilCtrl, $lng;
        
        $jobs = $this->getMultiActionData();
        if ($jobs) {
            foreach ($jobs as $job) {
                if (ilCronManager::isJobInactive($job->getId())) {
                    ilCronManager::resetJob($job);
                    ilCronManager::activateJob($job, true);
                }
            }
            
            ilUtil::sendSuccess($lng->txt("cron_action_activate_success"), true);
        }
            
        $ilCtrl->redirect($this, "render");
    }
    
    public function deactivate()
    {
        $this->confirm("deactivate");
    }
    
    public function confirmedDeactivate()
    {
        global $ilCtrl, $lng;
        
        $jobs = $this->getMultiActionData();
        if ($jobs) {
            foreach ($jobs as $job) {
                if (ilCronManager::isJobActive($job->getId())) {
                    ilCronManager::deactivateJob($job, true);
                }
            }
            
            ilUtil::sendSuccess($lng->txt("cron_action_deactivate_success"), true);
        }
        
        $ilCtrl->redirect($this, "render");
    }
    
    public function reset()
    {
        $this->confirm("reset");
    }
    
    public function confirmedReset()
    {
        global $ilCtrl, $lng;

        $jobs = $this->getMultiActionData();
        if ($jobs) {
            foreach ($jobs as $job) {
                if (ilCronManager::isJobActive($job->getId())) {
                    ilCronManager::resetJob($job);
                }
            }
            ilUtil::sendSuccess($lng->txt("cron_action_reset_success"), true);
        }

        $ilCtrl->redirect($this, "render");
    }
    
    protected function getMultiActionData()
    {
        $res = array();
        
        if ($_REQUEST["jid"]) {
            $job_id = trim($_REQUEST["jid"]);
            $job = ilCronManager::getJobInstanceById($job_id);
            if ($job) {
                $res[$job_id] = $job;
            }
        } elseif (is_array($_REQUEST["mjid"])) {
            foreach ($_REQUEST["mjid"] as $job_id) {
                $job = ilCronManager::getJobInstanceById($job_id);
                if ($job) {
                    $res[$job_id] = $job;
                }
            }
        }
    
        return $res;
    }
    
    protected function confirm($a_action)
    {
        global $ilCtrl, $tpl, $lng;
        
        $jobs = $this->getMultiActionData();
        if (!$jobs) {
            $ilCtrl->redirect($this, "render");
        }

        if ('run' == $a_action) {
            // Filter jobs which are not indented to be executed manually
            $jobs = array_filter($jobs, function ($job) {
                return $job->isManuallyExecutable();
            });

            if (0 == count($jobs)) {
                ilUtil::sendFailure($lng->txt('cron_no_executable_job_selected'), true);
                $ilCtrl->redirect($this, 'render');
            }
        }

        include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
        $cgui = new ilConfirmationGUI();
        
        if (sizeof($jobs) == 1) {
            $job_id = array_pop(array_keys($jobs));
            $job = array_pop($jobs);
            $title = $job->getTitle();
            if (!$title) {
                $title = preg_replace("[^A-Za-z0-9_\-]", "", $job->getId());
            }

            $cgui->setHeaderText(sprintf(
                $lng->txt("cron_action_" . $a_action . "_sure"),
                $title
            ));

            $ilCtrl->setParameter($this, "jid", $job_id);
        } else {
            $cgui->setHeaderText($lng->txt("cron_action_" . $a_action . "_sure_multi"));
            
            foreach ($jobs as $job_id => $job) {
                $cgui->addItem("mjid[]", $job_id, $job->getTitle());
            }
        }
        
        $cgui->setFormAction($ilCtrl->getFormAction($this, "confirmed" . ucfirst($a_action)));
        $cgui->setCancel($lng->txt("cancel"), "render");
        $cgui->setConfirm($lng->txt("cron_action_" . $a_action), "confirmed" . ucfirst($a_action));

        $tpl->setContent($cgui->getHTML());
    }
    
    public function addToExternalSettingsForm($a_form_id)
    {
        $fields = array();
        
        $data = ilCronManager::getCronJobData();
        foreach ($data as $item) {
            $job = ilCronManager::getJobInstance(
                $item["job_id"],
                $item["component"],
                $item["class"],
                $item["path"]
            );
            
            if (method_exists($job, "addToExternalSettingsForm")) {
                $job->addToExternalSettingsForm($a_form_id, $fields, $item["job_status"]);
            }
        }
        
        if (sizeof($fields)) {
            return array("cron_jobs"=>array("jumpToCronJobs", $fields));
        }
    }
}