chamilo-lms/plugin/search_course/lib/register_course_widget.class.php

<?php

/**
 * Register course widget. 
 * Handles user's registration action.
 * Display a register to course form if required.
 * 
 * @copyright (c) 2011 University of Geneva
 * @license GNU General Public License - http://www.gnu.org/copyleft/gpl.html
 * @author Laurent Opprecht
 */
class RegisterCourseWidget
{
    const ACTION_SUBSCRIBE = 'subscribe';

    const PARAM_SUBSCRIBE = 'subscribe';
    const PARAM_PASSCODE = 'course_registration_code';

    /**
     * Returns $_POST data for $key is it exists or $default otherwise.
     * 
     * @param string $key
     * @param object $default
     * @return string 
     */
    public static function post($key, $default = '')
    {
        return isset($_POST[$key]) ? $_POST[$key] : $default;
    }

    /**
     * Returns $_GET data for $key is it exists or $default otherwise.
     * 
     * @param string $key
     * @param object $default
     * @return string 
     */
    public static function get($key, $default = '')
    {
        return isset($_GET[$key]) ? $_GET[$key] : $default;
    }

    /**
     *
     * @return RegisterCourseWidget
     */
    public static function factory()
    {
        return new self();
    }

    function run()
    {
        return $this->action_subscribe_user();
    }

    /**
     * Handle the subscribe action.
     * 
     * @return bool
     */
    function action_subscribe_user()
    {
        $action = self::get('action');
        if ($action != self::ACTION_SUBSCRIBE)
        {
            return false;
        }

        $course_code = self::post(self::PARAM_SUBSCRIBE);
        if (empty($course_code))
        {
            return false;
        }
        
        $registration_code = self::post(self::PARAM_PASSCODE);

        if ($this->subscribe_user($course_code, $registration_code))
        {
            Display::display_confirmation_message(get_lang('EnrollToCourseSuccessful'));
            return;
        }
        if (!empty($registration_code))
        {
            Display::display_error_message(get_lang('CourseRegistrationCodeIncorrect'));
        }
        $this->display_form($course_code);
        return true;
    }

    /**
     * Regiser a user to a course.
     * Returns true on success, false otherwise.
     * 
     * @param string $course_code
     * @param string $registration_code
     * @param int $user_id
     * @return bool 
     */
    function subscribe_user($course_code, $registration_code = '', $user_id = null)
    {
        $course = $this->retrieve_course($course_code);
        $course_regisration_code = $course['registration_code'];
        if (!empty($course_regisration_code) && $registration_code != $course_regisration_code)
        {
            return false;
        }

        if (empty($user_id))
        {
            global $_user;
            $user_id = $_user['user_id'];
        }

        return (bool) CourseManager::add_user_to_course($user_id, $course_code);
    }

    /**
     * Display the course registration form.
     * Asks for registration code/password.
     * 
     * @param string $course_code
     */
    function display_form($course_code)
    {
        global $stok;

        $course = $this->retrieve_course($course_code);
        $self = $_SERVER['REQUEST_URI'];
        $course_code = $course['code'];
        $course_visual_code = $course['visual_code'];
        $course_title = $course['title'];
        $submit_registration_code_label = get_lang("SubmitRegistrationCode");
        $course_requires_password_label = get_lang('CourseRequiresPassword');

        $result = <<<EOT
            $course_requires_password_label<br/>
            $course_visual_code - $course_title
            <form action="$self" method="post">
            <input type="hidden" name="sec_token" value="$stok" />
            <input type="hidden" name="subscribe" value="$course_code" />
            <input type="text" name="course_registration_code" value="$registration_code" />
            <input type="Submit" name="submit_course_registration_code" value="OK" alt="$submit_registration_code_label" /></form>
EOT;
        echo $result;
    }

    /**
     * DB functions - DB functions - DB functions
     */

    /**
     *
     * @param type $course_code
     * @return type 
     */
    function retrieve_course($course_code)
    {
        require_once api_get_path(SYS_PATH) . '/main/inc/lib/course.lib.php';
        return CourseManager::get_course_information($course_code);
    }

}