.
/**
* Library of functions for chat outside of the core api
*/
defined('MOODLE_INTERNAL') || die();
require_once($CFG->dirroot . '/mod/chat/lib.php');
require_once($CFG->libdir . '/portfolio/caller.php');
/**
* @package mod_chat
* @copyright 1999 onwards Martin Dougiamas {@link http://moodle.com}
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class chat_portfolio_caller extends portfolio_module_caller_base {
/** @var object */
private $chat;
/** @var int Timestamp */
protected $start;
/** @var int Timestamp */
protected $end;
/**
* @return array
*/
public static function expected_callbackargs() {
return array(
'id' => true,
'start' => false,
'end' => false,
);
}
/**
* @global object
*/
public function load_data() {
global $DB;
if (!$this->cm = get_coursemodule_from_id('chat', $this->id)) {
throw new portfolio_caller_exception('invalidid', 'chat');
}
$this->chat = $DB->get_record('chat', array('id' => $this->cm->instance));
$select = 'chatid = ?';
$params = array($this->chat->id);
if ($this->start && $this->end) {
$select .= ' AND timestamp >= ? AND timestamp <= ?';
$params[] = $this->start;
$params[] = $this->end;
}
$this->messages = $DB->get_records_select(
'chat_messages',
$select,
$params,
'timestamp ASC'
);
$select .= ' AND userid = ?';
$params[] = $this->user->id;
$this->participated = $DB->record_exists_select(
'chat_messages',
$select,
$params
);
}
/**
* @return array
*/
public static function base_supported_formats() {
return array(PORTFOLIO_FORMAT_PLAINHTML);
}
/**
*
*/
public function expected_time() {
return portfolio_expected_time_db(count($this->messages));
}
/**
* @return string
*/
public function get_sha1() {
$str = '';
ksort($this->messages);
foreach ($this->messages as $m) {
$str .= implode('', (array)$m);
}
return sha1($str);
}
/**
* @return bool
*/
public function check_permissions() {
$context = context_module::instance($this->cm->id);
return has_capability('mod/chat:exportsession', $context)
|| ($this->participated
&& has_capability('mod/chat:exportparticipatedsession', $context));
}
/**
* @todo Document this function
*/
public function prepare_package() {
$content = '';
$lasttime = 0;
foreach ($this->messages as $message) { // We are walking FORWARDS through messages
$m = clone $message; // grrrrrr - this causes the sha1 to change as chat_format_message changes what it's passed.
$formatmessage = chat_format_message($m, $this->cm->course, $this->user);
if (!isset($formatmessage->html)) {
continue;
}
if (empty($lasttime) || (($message->timestamp - $lasttime) > CHAT_SESSION_GAP)) {
$content .= '
';
$content .= userdate($message->timestamp);
}
$content .= $formatmessage->html;
$lasttime = $message->timestamp;
}
$content = preg_replace('/\]*\>/', '', $content);
$this->exporter->write_new_file($content, clean_filename($this->cm->name . '-session.html'), false);
}
/**
* @return string
*/
public static function display_name() {
return get_string('modulename', 'chat');
}
/**
* @global object
* @return string
*/
public function get_return_url() {
global $CFG;
return $CFG->wwwroot . '/mod/chat/report.php?id='
. $this->cm->id . ((isset($this->start)) ? '&start=' . $this->start . '&end=' . $this->end : '');
}
}
/**
* A chat event such a user entering or leaving a chat activity
*
* @package mod_chat
* @copyright 2012 Andrew Davis
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class event_message implements renderable {
/** @var string The URL of the profile of the user who caused the event */
public $senderprofile;
/** @var string The ready to display name of the user who caused the event */
public $sendername;
/** @var string Ready to display event time */
public $time;
/** @var string Event description */
public $event;
/** @var string The chat theme name */
public $theme;
/**
* event_message constructor
*
* @param string $senderprofile The URL of the profile of the user who caused the event
* @param string $sendername The ready to display name of the user who caused the event
* @param string $time Ready to display event time
* @param string $theme The chat theme name
*/
public function __construct($senderprofile, $sendername, $time, $event, $theme) {
$this->senderprofile = $senderprofile;
$this->sendername = $sendername;
$this->time = $time;
$this->event = $event;
$this->theme = $theme;
}
}
/**
* A chat message from a user
*
* @package mod_chat
* @copyright 2012 Andrew Davis
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class user_message implements renderable {
/** @var string The URL of the profile of the user sending the message */
public $senderprofile;
/** @var string The ready to display name of the user sending the message */
public $sendername;
/** @var string HTML for the avatar of the user sending the message */
public $avatar;
/** @var string Empty or a html class definition to append to the html */
public $mymessageclass;
/** @var string Ready to display message time */
public $time;
/** @var string The message */
public $message;
/** @var string The name of the chat theme to use */
public $theme;
/**
* user_message constructor
*
* @param string $senderprofile The URL of the profile of the user sending the message
* @param string $sendername The ready to display name of the user sending the message
* @param string $avatar HTML for the avatar of the user sending the message
* @param string $mymessageclass Empty or a html class definition to append to the html
* @param string $time Ready to display message time
* @param string $message The message
* @param string $theme The name of the chat theme to use
*/
public function __construct($senderprofile, $sendername, $avatar, $mymessageclass, $time, $message, $theme) {
$this->senderprofile = $senderprofile;
$this->sendername = $sendername;
$this->avatar = $avatar;
$this->mymessageclass = $mymessageclass;
$this->time = $time;
$this->message = $message;
$this->theme = $theme;
}
}