moodle/mod/chat/backuplib.php

<?php //$Id$
    //This php script contains all the stuff to backup/restore
    //chat mods

    //This is the "graphical" structure of the chat mod:
    //
    //                       chat
    //                    (CL,pk->id)             
    //                        |
    //                        |
    //                        |
    //                   chat_messages 
    //               (UL,pk->id, fk->chatid)
    //
    // Meaning: pk->primary key field of the table
    //          fk->foreign key to link with parent
    //          nt->nested field (recursive data)
    //          CL->course level info
    //          UL->user level info
    //          files->table may have files)
    //
    //-----------------------------------------------------------

    //This function executes all the backup procedure about this mod
    function chat_backup_mods($bf,$preferences) {
        global $CFG, $DB;

        $status = true;

        //Iterate over chat table
        $chats = $DB->get_records ("chat", array("course"=>$preferences->backup_course), "id");
        if ($chats) {
            foreach ($chats as $chat) {
                if (backup_mod_selected($preferences,'chat',$chat->id)) {
                    $status = chat_backup_one_mod($bf,$preferences,$chat);
                }
            }
        }
        return $status;  
    }

    function chat_backup_one_mod($bf,$preferences,$chat) {
        global $CFG, $DB;
    
        if (is_numeric($chat)) {
            $chat = $DB->get_record('chat', array('id'=>$chat));
        }
    
        $status = true;

        //Start mod
        fwrite ($bf,start_tag("MOD",3,true));
        //Print chat data
        fwrite ($bf,full_tag("ID",4,false,$chat->id));
        fwrite ($bf,full_tag("MODTYPE",4,false,"chat"));
        fwrite ($bf,full_tag("NAME",4,false,$chat->name));
        fwrite ($bf,full_tag("INTRO",4,false,$chat->intro));
        fwrite ($bf,full_tag("KEEPDAYS",4,false,$chat->keepdays));
        fwrite ($bf,full_tag("STUDENTLOGS",4,false,$chat->studentlogs));
        fwrite ($bf,full_tag("SCHEDULE",4,false,$chat->schedule));
        fwrite ($bf,full_tag("CHATTIME",4,false,$chat->chattime));
        fwrite ($bf,full_tag("TIMEMODIFIED",4,false,$chat->timemodified));
        //if we've selected to backup users info, then execute backup_chat_messages
        if (backup_userdata_selected($preferences,'chat',$chat->id)) {
            $status = backup_chat_messages($bf,$preferences,$chat->id);
        }
        //End mod
        $status =fwrite ($bf,end_tag("MOD",3,true));

        return $status;
    }

    //Backup chat_messages contents (executed from chat_backup_mods)
    function backup_chat_messages ($bf,$preferences,$chat) {
        global $CFG, $DB;

        $status = true;

        $chat_messages = $DB->get_records("chat_messages", array("chatid"=>$chat), "id");
        //If there is messages
        if ($chat_messages) {
            //Write start tag
            $status =fwrite ($bf,start_tag("MESSAGES",4,true));
            //Iterate over each message
            foreach ($chat_messages as $cha_mes) {
                //Start message
                $status =fwrite ($bf,start_tag("MESSAGE",5,true));
                //Print message contents
                fwrite ($bf,full_tag("ID",6,false,$cha_mes->id));       
                fwrite ($bf,full_tag("USERID",6,false,$cha_mes->userid));       
                fwrite ($bf,full_tag("GROUPID",6,false,$cha_mes->groupid)); 
                fwrite ($bf,full_tag("SYSTEM",6,false,$cha_mes->system));       
                fwrite ($bf,full_tag("MESSAGE_TEXT",6,false,$cha_mes->message));       
                fwrite ($bf,full_tag("TIMESTAMP",6,false,$cha_mes->timestamp));       
                //End submission
                $status =fwrite ($bf,end_tag("MESSAGE",5,true));
            }
            //Write end tag
            $status =fwrite ($bf,end_tag("MESSAGES",4,true));
        }
        return $status;
    }

    //Return an array of info (name,value)
    function chat_check_backup_mods($course,$user_data=false,$backup_unique_code,$instances=null) {

        if (!empty($instances) && is_array($instances) && count($instances)) {
            $info = array();
            foreach ($instances as $id => $instance) {
                $info += chat_check_backup_mods_instances($instance,$backup_unique_code);
            }
            return $info;
        }
        //First the course data
        $info[0][0] = get_string("modulenameplural","chat");
        if ($ids = chat_ids ($course)) {
            $info[0][1] = count($ids);
        } else {
            $info[0][1] = 0;
        }

        //Now, if requested, the user_data
        if ($user_data) {
            $info[1][0] = get_string("messages","chat");
            if ($ids = chat_message_ids_by_course ($course)) { 
                $info[1][1] = count($ids);
            } else {
                $info[1][1] = 0;
            }
        }
        return $info;
    }

    //Return an array of info (name,value)
    function chat_check_backup_mods_instances($instance,$backup_unique_code) {
        //First the course data
        $info[$instance->id.'0'][0] = '<b>'.$instance->name.'</b>';
        $info[$instance->id.'0'][1] = '';

        //Now, if requested, the user_data
        if (!empty($instance->userdata)) {
            $info[$instance->id.'1'][0] = get_string("messages","chat");
            if ($ids = chat_message_ids_by_instance ($instance->id)) { 
                $info[$instance->id.'1'][1] = count($ids);
            } else {
                $info[$instance->id.'1'][1] = 0;
            }
        }
        return $info;
    }

    //Return a content encoded to support interactivities linking. Every module
    //should have its own. They are called automatically from the backup procedure.
    function chat_encode_content_links ($content,$preferences) {

        global $CFG;

        $base = preg_quote($CFG->wwwroot,"/");

        //Link to the list of chats
        $buscar="/(".$base."\/mod\/chat\/index.php\?id\=)([0-9]+)/";
        $result= preg_replace($buscar,'$@CHATINDEX*$2@$',$content);

        //Link to chat view by moduleid
        $buscar="/(".$base."\/mod\/chat\/view.php\?id\=)([0-9]+)/";
        $result= preg_replace($buscar,'$@CHATVIEWBYID*$2@$',$result);

        return $result;
    }

    // INTERNAL FUNCTIONS. BASED IN THE MOD STRUCTURE

    //Returns an array of chats id 
    function chat_ids ($course) {
        global $DB;

        return $DB->get_records_sql("SELECT c.id, c.course
                                       FROM {chat} c
                                      WHERE c.course = ?", array($course));
    }
    
    //Returns an array of assignment_submissions id
    function chat_message_ids_by_course ($course) {
        global $DB;

        return $DB->get_records_sql("SELECT m.id , m.chatid
                                       FROM {chat_messages} m, {chat} c
                                      WHERE c.course = ? AND
                                            m.chatid = c.id", array($course));
    }

    //Returns an array of chat id
    function chat_message_ids_by_instance ($instanceid) {
        global $DB;

        return $DB->get_records_sql("SELECT m.id , m.chatid
                                       FROM {chat_messages} m
                                      WHERE m.chatid = ?", array($instanceid));
    }
?>