forked from GNUsocial/gnu-social
de55d8f83b
lib/plugin.php now has a parent onAutoload function that finds most common
files that are used in plugins (actions, dataobjects, forms, libs etc.) if
they are put in the standardised directories ('actions', 'classes', 'forms',
'lib' and perhaps some others in the future).
520 lines
16 KiB
PHP
520 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* StatusNet, the distributed open-source microblogging tool
|
|
*
|
|
* Superclass for plugins that do "real time" updates of timelines using Ajax
|
|
*
|
|
* PHP version 5
|
|
*
|
|
* LICENCE: This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* @category Plugin
|
|
* @package StatusNet
|
|
* @author Evan Prodromou <evan@status.net>
|
|
* @copyright 2009 StatusNet, Inc.
|
|
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
|
|
* @link http://status.net/
|
|
*/
|
|
|
|
if (!defined('STATUSNET') && !defined('LACONICA')) {
|
|
exit(1);
|
|
}
|
|
|
|
/**
|
|
* Superclass for plugin to do realtime updates
|
|
*
|
|
* Based on experience with the Comet and Meteor plugins,
|
|
* this superclass extracts out some of the common functionality
|
|
*
|
|
* @category Plugin
|
|
* @package StatusNet
|
|
* @author Evan Prodromou <evan@status.net>
|
|
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
|
|
* @link http://status.net/
|
|
*/
|
|
class RealtimePlugin extends Plugin
|
|
{
|
|
protected $showurl = null;
|
|
|
|
/**
|
|
* When it's time to initialize the plugin, calculate and
|
|
* pass the URLs we need.
|
|
*/
|
|
function onInitializePlugin()
|
|
{
|
|
// FIXME: need to find a better way to pass this pattern in
|
|
$this->showurl = common_local_url('shownotice',
|
|
array('notice' => '0000000000'));
|
|
return true;
|
|
}
|
|
|
|
function onCheckSchema()
|
|
{
|
|
$schema = Schema::get();
|
|
$schema->ensureTable('realtime_channel', Realtime_channel::schemaDef());
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Hook for RouterInitialized event.
|
|
*
|
|
* @param Net_URL_Mapper $m path-to-action mapper
|
|
* @return boolean hook return
|
|
*/
|
|
function onRouterInitialized($m)
|
|
{
|
|
$m->connect('main/channel/:channelkey/keepalive',
|
|
array('action' => 'keepalivechannel'),
|
|
array('channelkey' => '[a-z0-9]{32}'));
|
|
$m->connect('main/channel/:channelkey/close',
|
|
array('action' => 'closechannel'),
|
|
array('channelkey' => '[a-z0-9]{32}'));
|
|
return true;
|
|
}
|
|
|
|
function onEndShowScripts($action)
|
|
{
|
|
$channel = $this->_getChannel($action);
|
|
|
|
if (empty($channel)) {
|
|
return true;
|
|
}
|
|
|
|
$timeline = $this->_pathToChannel(array($channel->channel_key));
|
|
|
|
// If there's not a timeline on this page,
|
|
// just return true
|
|
|
|
if (empty($timeline)) {
|
|
return true;
|
|
}
|
|
|
|
$base = $action->selfUrl();
|
|
if (mb_strstr($base, '?')) {
|
|
$url = $base . '&realtime=1';
|
|
} else {
|
|
$url = $base . '?realtime=1';
|
|
}
|
|
|
|
$scripts = $this->_getScripts();
|
|
|
|
foreach ($scripts as $script) {
|
|
$action->script($script);
|
|
}
|
|
|
|
$user = common_current_user();
|
|
|
|
if (!empty($user->id)) {
|
|
$user_id = $user->id;
|
|
} else {
|
|
$user_id = 0;
|
|
}
|
|
|
|
if ($action->boolean('realtime')) {
|
|
$realtimeUI = ' RealtimeUpdate.initPopupWindow();';
|
|
}
|
|
else {
|
|
$pluginPath = common_path('plugins/Realtime/');
|
|
$keepalive = common_local_url('keepalivechannel', array('channelkey' => $channel->channel_key));
|
|
$close = common_local_url('closechannel', array('channelkey' => $channel->channel_key));
|
|
$realtimeUI = ' RealtimeUpdate.initActions('.json_encode($url).', '.json_encode($timeline).', '.json_encode($pluginPath).', '.json_encode($keepalive).', '.json_encode($close).'); ';
|
|
}
|
|
|
|
$script = ' $(document).ready(function() { '.
|
|
$realtimeUI.
|
|
$this->_updateInitialize($timeline, $user_id).
|
|
'}); ';
|
|
$action->inlineScript($script);
|
|
|
|
return true;
|
|
}
|
|
|
|
function onEndShowStatusNetStyles($action)
|
|
{
|
|
$action->cssLink(Plugin::staticPath('Realtime', 'realtimeupdate.css'),
|
|
null,
|
|
'screen, projection, tv');
|
|
return true;
|
|
}
|
|
|
|
function onHandleQueuedNotice($notice)
|
|
{
|
|
$paths = array();
|
|
|
|
// Add to the author's timeline
|
|
|
|
try {
|
|
$profile = $notice->getProfile();
|
|
} catch (Exception $e) {
|
|
$this->log(LOG_ERR, $e->getMessage());
|
|
return true;
|
|
}
|
|
|
|
$user = User::getKV('id', $notice->profile_id);
|
|
|
|
if (!empty($user)) {
|
|
$paths[] = array('showstream', $user->nickname, null);
|
|
}
|
|
|
|
// Add to the public timeline
|
|
|
|
if ($notice->is_local == Notice::LOCAL_PUBLIC ||
|
|
($notice->is_local == Notice::REMOTE && !common_config('public', 'localonly'))) {
|
|
$paths[] = array('public', null, null);
|
|
}
|
|
|
|
// Add to the tags timeline
|
|
|
|
$tags = $this->getNoticeTags($notice);
|
|
|
|
if (!empty($tags)) {
|
|
foreach ($tags as $tag) {
|
|
$paths[] = array('tag', $tag, null);
|
|
}
|
|
}
|
|
|
|
// Add to inbox timelines
|
|
// XXX: do a join
|
|
|
|
$ni = $notice->whoGets();
|
|
|
|
foreach (array_keys($ni) as $user_id) {
|
|
$user = User::getKV('id', $user_id);
|
|
$paths[] = array('all', $user->nickname, null);
|
|
}
|
|
|
|
// Add to the replies timeline
|
|
|
|
$reply = new Reply();
|
|
$reply->notice_id = $notice->id;
|
|
|
|
if ($reply->find()) {
|
|
while ($reply->fetch()) {
|
|
$user = User::getKV('id', $reply->profile_id);
|
|
if (!empty($user)) {
|
|
$paths[] = array('replies', $user->nickname, null);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Add to the group timeline
|
|
// XXX: join
|
|
|
|
$gi = new Group_inbox();
|
|
$gi->notice_id = $notice->id;
|
|
|
|
if ($gi->find()) {
|
|
while ($gi->fetch()) {
|
|
$ug = User_group::getKV('id', $gi->group_id);
|
|
$paths[] = array('showgroup', $ug->nickname, null);
|
|
}
|
|
}
|
|
|
|
if (count($paths) > 0) {
|
|
|
|
$json = $this->noticeAsJson($notice);
|
|
|
|
$this->_connect();
|
|
|
|
// XXX: We should probably fan-out here and do a
|
|
// new queue item for each path
|
|
|
|
foreach ($paths as $path) {
|
|
|
|
list($action, $arg1, $arg2) = $path;
|
|
|
|
$channels = Realtime_channel::getAllChannels($action, $arg1, $arg2);
|
|
$this->log(LOG_INFO, sprintf(_("%d candidate channels for notice %d"),
|
|
count($channels),
|
|
$notice->id));
|
|
|
|
foreach ($channels as $channel) {
|
|
|
|
// XXX: We should probably fan-out here and do a
|
|
// new queue item for each user/path combo
|
|
|
|
if (is_null($channel->user_id)) {
|
|
$profile = null;
|
|
} else {
|
|
$profile = Profile::getKV('id', $channel->user_id);
|
|
}
|
|
if ($notice->inScope($profile)) {
|
|
$this->log(LOG_INFO,
|
|
sprintf(_("Delivering notice %d to channel (%s, %s, %s) for user '%s'"),
|
|
$notice->id,
|
|
$channel->action,
|
|
$channel->arg1,
|
|
$channel->arg2,
|
|
($profile) ? ($profile->nickname) : "<public>"));
|
|
$timeline = $this->_pathToChannel(array($channel->channel_key));
|
|
$this->_publish($timeline, $json);
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->_disconnect();
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
function onStartShowBody($action)
|
|
{
|
|
$realtime = $action->boolean('realtime');
|
|
if (!$realtime) {
|
|
return true;
|
|
}
|
|
|
|
$action->elementStart('body',
|
|
(common_current_user()) ? array('id' => $action->trimmed('action'),
|
|
'class' => 'user_in realtime-popup')
|
|
: array('id' => $action->trimmed('action'),
|
|
'class'=> 'realtime-popup'));
|
|
|
|
// XXX hack to deal with JS that tries to get the
|
|
// root url from page output
|
|
|
|
$action->elementStart('address');
|
|
|
|
if (common_config('singleuser', 'enabled')) {
|
|
$user = User::singleUser();
|
|
$url = common_local_url('showstream', array('nickname' => $user->nickname));
|
|
} else {
|
|
$url = common_local_url('public');
|
|
}
|
|
|
|
$action->element('a', array('class' => 'url',
|
|
'href' => $url),
|
|
'');
|
|
|
|
$action->elementEnd('address');
|
|
|
|
$action->showContentBlock();
|
|
$action->showScripts();
|
|
$action->elementEnd('body');
|
|
return false; // No default processing
|
|
}
|
|
|
|
function noticeAsJson($notice)
|
|
{
|
|
// FIXME: this code should be abstracted to a neutral third
|
|
// party, like Notice::asJson(). I'm not sure of the ethics
|
|
// of refactoring from within a plugin, so I'm just abusing
|
|
// the ApiAction method. Don't do this unless you're me!
|
|
|
|
$act = new ApiAction('/dev/null');
|
|
|
|
$arr = $act->twitterStatusArray($notice, true);
|
|
$arr['url'] = $notice->bestUrl();
|
|
$arr['html'] = htmlspecialchars($notice->rendered);
|
|
$arr['source'] = htmlspecialchars($arr['source']);
|
|
$arr['conversation_url'] = $this->getConversationUrl($notice);
|
|
|
|
$profile = $notice->getProfile();
|
|
$arr['user']['profile_url'] = $profile->profileurl;
|
|
|
|
// Add needed repeat data
|
|
|
|
if (!empty($notice->repeat_of)) {
|
|
$original = Notice::getKV('id', $notice->repeat_of);
|
|
if (!empty($original)) {
|
|
$arr['retweeted_status']['url'] = $original->bestUrl();
|
|
$arr['retweeted_status']['html'] = htmlspecialchars($original->rendered);
|
|
$arr['retweeted_status']['source'] = htmlspecialchars($original->source);
|
|
$originalProfile = $original->getProfile();
|
|
$arr['retweeted_status']['user']['profile_url'] = $originalProfile->profileurl;
|
|
$arr['retweeted_status']['conversation_url'] = $this->getConversationUrl($original);
|
|
}
|
|
$original = null;
|
|
}
|
|
|
|
return $arr;
|
|
}
|
|
|
|
function getNoticeTags($notice)
|
|
{
|
|
$tags = null;
|
|
|
|
$nt = new Notice_tag();
|
|
$nt->notice_id = $notice->id;
|
|
|
|
if ($nt->find()) {
|
|
$tags = array();
|
|
while ($nt->fetch()) {
|
|
$tags[] = $nt->tag;
|
|
}
|
|
}
|
|
|
|
$nt->free();
|
|
$nt = null;
|
|
|
|
return $tags;
|
|
}
|
|
|
|
function getConversationUrl($notice)
|
|
{
|
|
$convurl = null;
|
|
|
|
if ($notice->hasConversation()) {
|
|
$conv = Conversation::getKV(
|
|
'id',
|
|
$notice->conversation
|
|
);
|
|
$convurl = $conv->uri;
|
|
|
|
if(empty($convurl)) {
|
|
$msg = sprintf( "Could not find Conversation ID %d to make 'in context'"
|
|
. "link for Notice ID %d.",
|
|
$notice->conversation,
|
|
$notice->id
|
|
);
|
|
|
|
common_log(LOG_WARNING, $msg);
|
|
} else {
|
|
$convurl .= '#notice-' . $notice->id;
|
|
}
|
|
}
|
|
|
|
return $convurl;
|
|
}
|
|
|
|
function _getScripts()
|
|
{
|
|
if (common_config('site', 'minify')) {
|
|
$js = 'realtimeupdate.min.js';
|
|
} else {
|
|
$js = 'realtimeupdate.js';
|
|
}
|
|
return array(Plugin::staticPath('Realtime', $js));
|
|
}
|
|
|
|
/**
|
|
* Export any i18n messages that need to be loaded at runtime...
|
|
*
|
|
* @param Action $action
|
|
* @param array $messages
|
|
*
|
|
* @return boolean hook return value
|
|
*/
|
|
function onEndScriptMessages($action, &$messages)
|
|
{
|
|
// TRANS: Text label for realtime view "play" button, usually replaced by an icon.
|
|
$messages['realtime_play'] = _m('BUTTON', 'Play');
|
|
// TRANS: Tooltip for realtime view "play" button.
|
|
$messages['realtime_play_tooltip'] = _m('TOOLTIP', 'Play');
|
|
// TRANS: Text label for realtime view "pause" button
|
|
$messages['realtime_pause'] = _m('BUTTON', 'Pause');
|
|
// TRANS: Tooltip for realtime view "pause" button
|
|
$messages['realtime_pause_tooltip'] = _m('TOOLTIP', 'Pause');
|
|
// TRANS: Text label for realtime view "popup" button, usually replaced by an icon.
|
|
$messages['realtime_popup'] = _m('BUTTON', 'Pop up');
|
|
// TRANS: Tooltip for realtime view "popup" button.
|
|
$messages['realtime_popup_tooltip'] = _m('TOOLTIP', 'Pop up in a window');
|
|
|
|
return true;
|
|
}
|
|
|
|
function _updateInitialize($timeline, $user_id)
|
|
{
|
|
return "RealtimeUpdate.init($user_id, \"$this->showurl\"); ";
|
|
}
|
|
|
|
function _connect()
|
|
{
|
|
}
|
|
|
|
function _publish($timeline, $json)
|
|
{
|
|
}
|
|
|
|
function _disconnect()
|
|
{
|
|
}
|
|
|
|
function _pathToChannel($path)
|
|
{
|
|
return '';
|
|
}
|
|
|
|
|
|
function _getTimeline($action)
|
|
{
|
|
$channel = $this->_getChannel($action);
|
|
if (empty($channel)) {
|
|
return null;
|
|
}
|
|
|
|
return $this->_pathToChannel(array($channel->channel_key));
|
|
}
|
|
|
|
function _getChannel($action)
|
|
{
|
|
$timeline = null;
|
|
$arg1 = null;
|
|
$arg2 = null;
|
|
|
|
$action_name = $action->trimmed('action');
|
|
|
|
// FIXME: lists
|
|
// FIXME: search (!)
|
|
// FIXME: profile + tag
|
|
|
|
switch ($action_name) {
|
|
case 'public':
|
|
// no arguments
|
|
break;
|
|
case 'tag':
|
|
$tag = $action->trimmed('tag');
|
|
if (!empty($tag)) {
|
|
$arg1 = $tag;
|
|
} else {
|
|
$this->log(LOG_NOTICE, "Unexpected 'tag' action without tag argument");
|
|
return null;
|
|
}
|
|
break;
|
|
case 'showstream':
|
|
case 'all':
|
|
case 'replies':
|
|
case 'showgroup':
|
|
$nickname = common_canonical_nickname($action->trimmed('nickname'));
|
|
if (!empty($nickname)) {
|
|
$arg1 = $nickname;
|
|
} else {
|
|
$this->log(LOG_NOTICE, "Unexpected $action_name action without nickname argument.");
|
|
return null;
|
|
}
|
|
break;
|
|
default:
|
|
return null;
|
|
}
|
|
|
|
$user = common_current_user();
|
|
|
|
$user_id = (!empty($user)) ? $user->id : null;
|
|
|
|
$channel = Realtime_channel::getChannel($user_id,
|
|
$action_name,
|
|
$arg1,
|
|
$arg2);
|
|
|
|
return $channel;
|
|
}
|
|
|
|
function onStartReadWriteTables(&$alwaysRW, &$rwdb)
|
|
{
|
|
$alwaysRW[] = 'realtime_channel';
|
|
return true;
|
|
}
|
|
}
|