\n";
// Adjust rating points
if ($this->get_config('rate_with_words', false)) {
$points = $this->wordRating($points, $votes);
}
elseif ($this->image_name != '0') {
$points = $this->imageRating($points, $votes);
}
return array("karma_block" => $karma_block, "points" => $points);
}
function event_hook($event, &$bag, &$eventData, $addData = null) {
global $serendipity;
$hooks = &$bag->get('event_hooks');
if (isset($hooks[$event])) {
// Moved from above: only get image data if we're actually going to do something
$this->set_valid_image_data();
// Get dimensions of image, only if not text-only
if ($this->image_name) {
// Is this a single-image bar, or a single segment?
$ratio = $this->image_width / $this->image_height;
if ($ratio < $max_segment_ratio) {
// This is probably a single segment. Square segments
// will have a ratio of 0.3; long, flat segments won't
// get up to 1.0 unless they're 3 times as wide as they
// are tall; full-bar images with square segments will
// be 1.666; and full-bar images with tall, narrow
// segments will be greater than 1.0 unless they're
// nearly twice as high as they are wide.
$this->image_width = $this->image_width * 5;
}
}
switch($event) {
//Javascript for ajax functionality
case 'frontend_footer':
if ($this->get_config('ajax') == true) {
?>
$req) {
$val = explode('=', $req);
if (empty($_REQUEST[$val[0]])) {
$_REQUEST[$val[0]] = $val[1];
}
}
}
$parts = explode('_', $uri_parts[0]);
switch($parts[0]) {
case 'karma-ajaxquery':
$this->performkarmaVote();
$q = "SELECT SUM(votes) AS votes, SUM(points) AS points, SUM(visits) AS visits
FROM " . $serendipity['dbPrefix'] . "karma
WHERE entryid = '" . (int)$_POST['karmaId'] . "';";
$sql = serendipity_db_query($q);
$track_clicks = serendipity_db_bool($this->get_config('visits_active', true));
$track_karma = serendipity_db_bool($this->get_config('karma_active', true));
$enough_votes = $track_karma && ($sql[0]['votes'] >= $this->get_config('min_disp_votes', 0));
$enough_visits = $track_clicks && ($sql[0]['visits'] >= $this->get_config('min_disp_visits', 0));
$textual_msg = true;
$textual_current = true;
$textual_visits = true;
if ($this->image_name != '0') {
$textual_msg = $this->get_config('textual_msg', 'true');
$textual_current = $this->get_config('textual_current', 'true');
$textual_visits = $this->get_config('textual_visits', 'true');
}
$temp = $this->karmaVoted((int)$_POST['karmaVote'],$sql[0]['points'],$sql[0]['votes']);
$myvote = $temp['myvote'];
$msg = $temp['msg'];
$bar = $temp['bar'];
$temp = $this->createkarmaBlock((int)$_POST['karmaId'], $textual_msg, $msg, $bar, $enough_votes, $textual_current, $enough_visits, $textual_visits, $sql[0]['points'], $sql[0]['votes']);
$karma_block = $temp['karma_block'];
$points = $temp['points'];
echo sprintf($karma_block, $myvote, $points, $sql[0]['votes'], $sql[0]['visits'], '');
break;
}
return true;
break;
// Early hook, before any page is displayed
case 'frontend_configure':
$this->performkarmaVote();
return true;
break;
// CSS generation hooks
case 'backend_header':
// Generate the CSS for the graphical rating bar selector
//
// The CSS appears to be generated in a completely
// different instance of Serendipity, as if index.php gets
// called separately for the CSS.
//
// Note that the css_backend hook adds properties to the
// serendipity_admin.css, but that file is *always*
// cached. We use backend_header and add the CSS to the
// HEAD styles to make it dynamic.
// Get the CSS, set $this->image_name so we'll output the
// standard graphical CSS prologue if any images are found.
$this->createRatingSelector();
print ("\n");
}
return true;
break;
//--TODO: Comment the functionality of this event hook.
case 'event_additional_statistics':
$sql = array();
$sql['visits_top'] = array('visits', 'DESC');
$sql['visits_bottom'] = array('visits', 'ASC');
$sql['votes_top'] = array('votes', 'DESC');
$sql['votes_bottom'] = array('votes', 'ASC');
$sql['points_top'] = array('points', 'DESC');
$sql['points_bottom'] = array('points', 'ASC');
foreach($sql AS $key => $rows) {
$q = "SELECT e.id,
e.title,
e.timestamp,
SUM(k.{$rows[0]}) AS no
FROM {$serendipity['dbPrefix']}karma
AS k
JOIN {$serendipity['dbPrefix']}entries
AS e
ON k.entryid = e.id
WHERE k.{$rows[0]} IS NOT NULL AND k.{$rows[0]} != 0
GROUP BY e.id, e.title, e.timestamp ORDER BY no {$rows[1]} LIMIT {$addData['maxitems']}";
$sql_rows = serendipity_db_query($q);
?>
$row) {
?>
get_config('dbversion', 0) != PLUGIN_KARMA_DB_VERSION) {
$this->checkScheme();
}
// Find the ID of this entry
if (isset($serendipity['GET']['id'])) {
$entryid = (int)serendipity_db_escape_string($serendipity['GET']['id']);
} elseif (preg_match(PAT_COMMENTSUB, $_SERVER['REQUEST_URI'], $matches)) {
$entryid = (int)$matches[1];
} else {
$entryid = false;
}
// If we're actually reading the entry, not voting or editing it...
if ($entryid && empty($serendipity['GET']['adminAction']) && !$serendipity['GET']['karmaVote']) {
// Update the number of visits
// Are we supposed to track visits?
$track_clicks = serendipity_db_bool($this->get_config('visits_active', true)) && $this->track_clicks_allowed_by_user();
if ($track_clicks && $_SERVER['REQUEST_METHOD'] == 'GET') {
$sql = serendipity_db_query(
"UPDATE {$serendipity['dbPrefix']}karma
SET visits = visits + 1
WHERE entryid = $entryid",
true);
if (serendipity_db_affected_rows() < 1) {
serendipity_db_query(
"INSERT INTO {$serendipity['dbPrefix']}karma (entryid, points, votes, lastvote, visits)
VALUES ('$entryid', 0, 0, 0, 1)"
);
}
}
}
// Set a cookie to look for later, verifying that cookies are enabled
serendipity_setCookie('check', '1');
switch($this->karmaVote) {
case 'nocookie':
// Users with no cookies won't be able to vote.
$msg = '
' . PLUGIN_KARMA_NOCOOKIE . '
';
// Continue until output
case 'timeout2':
if (!isset($msg)) {
$msg = '
' . PLUGIN_KARMA_CLOSED . '
';
}
// Continue until output
case 'timeout':
if (!isset($msg)) {
$msg = '
';
}
// Continue until output
case 'alreadyvoted':
if (!isset($msg)) {
$msg = '
' . PLUGIN_KARMA_ALREADYVOTED . '
';
}
// Continue until output
case 'invalid1':
case 'invalid2':
case 'invalid':
// Set message
if (!isset($msg)) {
$msg = '
' . PLUGIN_KARMA_INVALID . '
';
}
// Continue until output
/* OUTPUT MESSAGE */
//--TODO: Shouldn't this work with the cache plugin, too?
if ($addData['extended']) {
$eventData[0]['exflag'] = 1;
$eventData[0]['add_footer'] .= $msg;
} else {
$elements = count($eventData);
// Find the right container to store our message in.
for ($i = 0; $i < $elements; $i++) {
if ($eventData[$i]['id'] == $this->karmaId) {
$eventData[$i]['add_footer'] .= $msg;
}
}
}
break;
case 'voted':
default:
// If there's no data, there's no need to go on
if (!is_array($eventData)) return;
// Find out what the admin wants
$track_clicks = serendipity_db_bool($this->get_config('visits_active', true));
$track_karma = serendipity_db_bool($this->get_config('karma_active', true));
if (serendipity_db_bool($this->get_config('karma_active_registered', false))) {
if (!serendipity_userLoggedIn()) $track_karma = false;
}
$track_exits = serendipity_db_bool($this->get_config('exits_active', true));
// Get the limits
$now = time();
$karmatime = $this->get_config('max_karmatime', 7);
$max_karmatime = $karmatime * 24 * 60 * 60;
// Accept infinite voting
if ($max_karmatime <= 0) {
$max_karmatime = $now;
}
//--TODO: Ensure that this works with the Custom Permalinks plugin
// (We've seen trouble; it votes correctly, but redirects to the front page)
$url = serendipity_currentURL(true);
// Voting is only allowed on entries. Therefore voting URLs must be
// either single-entry URLs or summary URLs. serendipity_currentURL
// converts them to an "ErrorDocument-URI", so we can focus on the
// query portion of the URI.
//
// Single-entry URLs should be well-defined. They can be permalinks,
// of course; otherwise they're of the configured pattern.
//
// Summary URLs could be a little harder. The summary pages that
// include entries are: frontpage, category, author, and archives.
// It's possible a plugin would show entries, but if that's the case
// we don't need to allow the user to vote on them. Still, that's
// a lot of URLs to check for.
//
// Then there's the problem of the rest of the query. It could
// include stuff we really want to keep around, like template
// overrides or something. One can even add serendipity variables
// to the URL in extreme cases.
//
// It seems that canonicalizing the URL will be quite difficult.
// The only thing we can say for certain is that whatever the
// current URL is, it got us to this page, and we'd like to return
// to this page after we cast our vote.
// Remove any clutter from our previous voting activity
$url_parts = parse_url(serendipity_currentURL(true));
if (!empty($url_parts['query'])) {
$exclude = array('serendipity[karmaVote]', 'serendipity[karmaId]');
// I tried using parse_str, but it gave me very weird results
// with embedded arrays
//parse_str($url_parts['query'], $q_parts);
$q_parts = array();
// I don't know why this URL has been HTML encoded. Oh well.
$pairs = explode('&', $url_parts['query']);
foreach($pairs as $pair) {
$parts = explode('=', $pair);
$q_parts[$parts[0]] = $parts[1];
}
foreach($q_parts as $key => $value) {
if (in_array($key, $exclude)) {
$rm = preg_quote("$key=$value");
$url = preg_replace("@(&|&)?$rm@", '', $url);
}
}
}
if (substr($url, -1) != '?') {
$url .= '&';
}
// Get the cookie data (past votes, etc)
$karma = (isset($serendipity['COOKIE']['karmaVote']) ? unserialize($serendipity['COOKIE']['karmaVote']) : array());
// Get all required entry IDs, making keys match keys in eventData
$entries = array();
if ($addData['extended'] || $addData['preview']) {
// We're in extended or preview mode, we only need the current ID
$eventData[0]['exflag'] = 1;
$entries[0] = (int)($eventData[0]['id']);
} elseif (!serendipity_db_bool($this->get_config('extended_only', false))) {
// We're in overview mode, and we want rating bars for all the entry IDs
foreach(array_keys($eventData) as $key) {
if (isset($eventData[$key]['id'])) {
$entries[$key] = (int)$eventData[$key]['id'];
}
}
}
// Fetch votes for all entry IDs. Store them in an array for later usage.
$q = 'SELECT k.entryid, SUM(votes) AS votes, SUM(points) AS points, SUM(visits) AS visits
FROM ' . $serendipity['dbPrefix'] . 'karma AS k
WHERE k.entryid IN (' . implode(', ', $entries) . ') GROUP BY k.entryid';
$sql = serendipity_db_query($q);
$rows = array();
if ($sql && is_array($sql)) {
foreach($sql AS $row) {
$rows[$row['entryid']] = array(
'votes' => $row['votes'],
'points' => $row['points'],
'visits' => $row['visits']
);
}
}
$this->prepareExits($entries);
// Add karma block to the footer of each entry
//
// The entries array was populated, above, so its keys match the eventData array,
// and overview entries are skipped if "extended only" is enabled
foreach (array_keys($entries) as $i) {
// Get the statistics
$entryid = $eventData[$i]['id'];
$votes = (!empty($rows[$entryid]['votes']) ? $rows[$entryid]['votes'] : 0);
$points = (!empty($rows[$entryid]['points']) ? $rows[$entryid]['points'] : 0);
$visits = (!empty($rows[$entryid]['visits']) ? $rows[$entryid]['visits'] : 0);
$enough_votes = $track_karma && ($votes >= $this->get_config('min_disp_votes', 0));
$enough_visits = $track_clicks && ($visits >= $this->get_config('min_disp_visits', 0));
$textual_msg = true;
$textual_current = true;
$textual_visits = true;
if ($this->image_name != '0') {
$textual_msg = $this->get_config('textual_msg', 'true');
$textual_current = $this->get_config('textual_current', 'true');
$textual_visits = $this->get_config('textual_visits', 'true');
}
// Where's the footer? Normally it would be
// in eventData[n]['add_footer'] but if the
// cache plugin is used, it's in
// eventData[n]['properties']['ep_cache_add_footer'].
// This method retrieves it either way.
$footer = &$this->getFieldReference('add_footer', $eventData[$i]);
// Depending on what existed, $footer could
// be referencing the cached version, the
// uncached version, or even a new empty
// string. In particular, if $eventData[$i]
// has no properties, and no 'add_footer' key,
// $footer is referencing a new empty string,
// so adding a karma bar to $footer would do
// nothing.
//
// We could be referencing an empty uncached
// 'add_footer', but empty cache entries are
// never returned.
//
// Reference a footer that will be printed
if (empty($footer) && !isset($eventData[$i]['add_footer']) && is_array($eventData[$i])) {
$eventData[$i]['add_footer'] = '';
$footer = &$eventData[$i]['add_footer'];
// It's still empty, but it's referencing
// the right place.
}
if ($track_exits) {
$footer .= $this->getExits($entryid, true);
}
// Pick the appropriate intro msg and rating bar
// No msg or bar if karma is disabled
if ($track_karma) {
if (isset($karma[$entryid])) {
// We already voted for this one
$temp = $this->karmaVoted($karma[$entryid],$points,$votes);
$myvote = $temp['myvote'];
$msg = $temp['msg'];
$bar = $temp['bar'];
} elseif ($eventData[$i]['timestamp'] < ($now - $max_karmatime)) {
// Too late to vote for this one
$msg =
'
' . sprintf(PLUGIN_KARMA_CLOSED, $karmatime) . '
';
// Just a current rating bar, if any
$bar = $this->createRatingBar(null, $points, $votes);
} else {
// We can vote for this; make the whole voting block
$rate_msg = $this->get_config('rate_msg', PLUGIN_KARMA_VOTETEXT);
$msg =
'
\n");
*/
// Substitute the % stuff and add it to the footer
$eventData[$i]['properties']['myvote'] = $myvote;
$eventData[$i]['properties']['points'] = $points;
$eventData[$i]['properties']['votes'] = $votes;
$eventData[$i]['properties']['visits'] = $visits;
$footer .= sprintf($karma_block, $myvote, $points, $votes, $visits, $url);
} // foreach key in entries
}// End switch on karma voting status
return true;
break;
// Display the Karma Log link on the sidebar
case 'backend_sidebar_entries':
?>
$msg\n");
//}
// Was I asked to process any votes?
if (($serendipity['POST']['delete_button'] || $serendipity['POST']['approve_button'])
&& sizeof($serendipity['POST']['delete']) != 0 && serendipity_checkFormToken()) {
foreach($serendipity['POST']['delete'] as $d => $i) {
$kdata = $serendipity['POST']['karmalog'.$i];
// validate posted variables
// posted points
$ppoints = $kdata['points'];
if (!is_numeric($ppoints) || ((int)$ppoints < -2) || ((int)$ppoints > 2)) {
print("
".PLUGIN_KARMA_INVALID_INPUT."
\n");
return false;
}
// posted id
$pid = $kdata['entryid'];
if (!is_numeric($pid)) {
print("
".PLUGIN_KARMA_INVALID_INPUT."
\n");
return false;
}
// posted IP
$pip = long2ip(ip2long($kdata['ip']));
if ($pip == -1 || $pip === FALSE) {
print("
".PLUGIN_KARMA_INVALID_INPUT."
\n");
return false;
}
// posted user agent (need a better validator, I think)
$puser_agent = $kdata['user_agent'];
if (serendipity_db_escape_string($puser_agent) != $puser_agent) {
print("
\n");
return false;
}
// Remove karma from entry?
if ($serendipity['POST']['delete_button']) {
// Fetch vote total for the entry IDs
$q = 'SELECT k.*
FROM ' . $serendipity['dbPrefix'] . 'karma AS k
WHERE k.entryid IN (' . $pid . ') GROUP BY k.entryid';
$sql = serendipity_db_query($q);
if (is_array($sql)) {
$karma = $sql[0];
$update = sprintf(
"UPDATE {$serendipity['dbPrefix']}karma
SET points = %s,
votes = %s
WHERE entryid = %s",
serendipity_db_escape_string($karma['points'] - $ppoints),
serendipity_db_escape_string($karma['votes'] - 1),
serendipity_db_escape_string($pid)
);
$updated = serendipity_db_query($update);
if ($updated != 1) {
printf("
".PLUGIN_KARMA_REMOVE_ERROR."
\n", $pid);
// Don't delete from karma log if we couldn't take away the points
continue;
}
} else {
// This will only happen if someone is messing with the karma table or submit data
printf("
".PLUGIN_KARMA_UPDATE_ERROR."
", $pid);
continue;
}
}
// Remove vote from log (approved or deleted, doesn't matter)
$del = sprintf(
"DELETE FROM {$serendipity['dbPrefix']}karmalog
WHERE entryid = %s AND ip = '%s' AND user_agent LIKE '%%%s%%' AND votetime = %s LIMIT 1",
serendipity_db_escape_string($pid),
serendipity_db_escape_string($pip),
serendipity_db_escape_string($puser_agent),
serendipity_db_escape_string($pvotetime)
);
$deleted = serendipity_db_query($del);
// User feedback
if ($deleted == 1) {
if ($serendipity['POST']['delete_button']) {
printf("
".PLUGIN_KARMA_REMOVED_POINTS."
\n", $ppoints, $pid);
} else {
printf("
".PLUGIN_KARMA_APPROVED_POINTS."
\n", $ppoints, $pid);
}
} else {
printf("
".PLUGIN_KARMA_REMOVE_ERROR."
\n", $pid);
}
}
}
// URL; expected to be event_display and karmalog, respectively
$url = '?serendipity[adminModule]='.htmlspecialchars($serendipity['GET']['adminModule']).'&serendipity[adminAction]='.htmlspecialchars($serendipity['GET']['adminAction']);
// Filters
print("
");
// Paging (partly ripped from include/admin/comments.inc.php)
$commentsPerPage = (int)(!empty($serendipity['GET']['filter']['perpage']) ? $serendipity['GET']['filter']['perpage'] : 25);
$sql = serendipity_db_query("SELECT COUNT(*) AS total FROM {$serendipity['dbPrefix']}karmalog l WHERE 1 = 1 " . $and, true);
$totalVotes = $sql['total'];
$pages = ($commentsPerPage == COMMENTS_FILTER_ALL ? 1 : ceil($totalVotes/(int)$commentsPerPage));
$page = (int)$serendipity['GET']['page'];
if ($page == 0 || ($page > $pages)) {
$page = 1;
}
if ($page > 1) {
$linkPrevious = $url . '&serendipity[page]='. ($page-1) . $searchString;
}
if ($pages > $page) {
$linkNext = $url . '&serendipity[page]='. ($page+1) . $searchString;
}
if ($commentsPerPage == COMMENTS_FILTER_ALL) {
$limit = '';
}else {
$limit = serendipity_db_limit_sql(serendipity_db_limit(($page-1)*(int)$commentsPerPage, (int)$commentsPerPage));
}
// Variables for display
if ($linkPrevious) {
$linkPrevious = '';
} else {
$linkPrevious = ' ';
}
if ($linkNext) {
$linkNext = '';
} else {
$linkNext = ' ';
}
$paging = sprintf(PAGE_BROWSE_COMMENTS, $page, $pages, $totalVotes);
// Retrieve the next batch of karma votes
// [entryid, points, ip, user_agent, votetime]
$sql = serendipity_db_query("SELECT l.entryid AS entryid, l.points AS points, l.ip AS ip, l.user_agent AS user_agent, l.votetime AS votetime, e.title AS title FROM {$serendipity['dbPrefix']}karmalog l
LEFT JOIN {$serendipity['dbPrefix']}entries e ON (e.id = l.entryid)
WHERE 1 = 1 " . $and . "
ORDER BY $orderby $limit");
// Start the form for display and deleting
if (is_array($sql)) {
print("
");
}
// Print the footer paging table
print("
$linkPrevious
$paging
$linkNext
");
} else {
print("
No entries to display.
");
}
return true;
break;
default:
return false;
}// End switch on event hooks
} else {
return false;
}
}
/**
* Check, if visit counting for the actual visitor should be done.
*/
function track_clicks_allowed_by_user(){
if (!$this->get_config('track_visits_of_loggedin_users',true) && serendipity_userLoggedIn()){
return false;
}
return true;
}
/**
* Creates an HTML snippet with images of all the available rating bars.
*
* @return string an HTML string including working images of all the rating bars in the img/ directory.
*/
function createRatingSelector() {
// Since the inputs are set up with the proper names, the config item
// gets saved automatically, with no need for magic
// Get the filename to be automatically selected
$this->set_valid_image_data();
$cursel = $this->image_name;
$this->select_css = '';
$this->select_html = '';
// We will be wrapped in a
";
// Add the 'text-only' selection and its CSS
if ($cursel == '0') {
$checked = 'checked="checked" ';
} else {
$checked = '';
}
$this->image_name = '0';
$bar = $this->createRatingBar('', 0, 0, 'textbar');
$this->select_html .= "
" . PLUGIN_KARMA_STATISTICS_POINTS_NO . " $bar
\n";
$this->select_css .= "
.textbar, .textbar a, .textbar a:hover {
font-size: 100%;
position: relative;
background: none;
}
.serendipityAdminContent span.textbar {
color: black !important;
}
";
// Retrieve all the *valid* images from the image directory
$files = $this->getImageFiles();
// Add an for each rating bar, and add its CSS overrides
$n = 0;
foreach ($files as $fdata) {
// Columnize
if (($n % 3) == 0) {
// Time to start a new row
$this->select_html .= "
\n
\n";
}
// Set the image data
$fname = $fdata['fname'];
$height = $fdata['height'];
$width = $fdata['width'];
$ratio = $width / $height;
// If this is a single segment, adjust width
if ($ratio < $max_segment_ratio) {
$width = $width * 5;
}
$height = $height / 3;
// Set up class variables correctly
$this->image_name = $fname;
$this->image_width = $width;
$this->image_height = $height;
// Create a rating bar of this image
//
// What would be a good CSS class for this image?
$css_class = str_replace(array('.',' '), array('_','_'), $fname);
$checked = '';
if ($fname == $cursel) {
$checked = 'checked="checked" ';
}
$bar_html =
"
\n";
$bar_html = sprintf($bar_html, '', '2.5 of 5', '1');
$this->select_html .= $bar_html;
// Add the necessary CSS to the stylesheet (will be added when css hooks are called)
// Sorry to interrupt your regularly scheduled HTML; I need to
// use the $css_class while it's still here.
$this->select_css .= "
/* Overrides for $css_class */
.$css_class
{
width: ${width}px;
height: ${height}px;
}
.$css_class,
.$css_class a:hover,
.$css_class .serendipity_karmaVoting_current-rating
{
background-image: url({$serendipity['baseURL']}plugins/serendipity_event_karma/img/${fname});
}
.$css_class,
.$css_class a,
.$css_class .serendipity_karmaVoting_current-rating
{
line-height: ${height}px;
height: ${height}px;
}
";
$n++;
} // Go back up for another image
// Check for nothing displayed
if ($n == 0) {
// There were no images!
$this->select_html .= "
\n
" . PLUGIN_KARMA_NO_IMAGES . "
";
}
// End the table, with a config-item bottom-border separator
$this->select_html .=
"
\n
\n";
// The config item and row are closed by the core code
return $this->select_html;
}
/**
* Retrieves all the images from the img/ directory
*
* @return array an array with 'fname', 'width', and 'height' entries for
* each valid image file in the img/ directory
*/
function getImageFiles() {
$path = dirname(__FILE__) . "/img";
$images = array();
$folder = opendir($path);
while (false !== ($filename = readdir($folder))) {
if ($filename != "ajax-loader.gif") {
$parts = serendipity_parseFileName($filename);
$img_data = serendipity_getimagesize($path . '/' . $filename);
if (!isset($img_data['noimage'])) {
// Curly braces are just a different syntax of associative array assignment
$images{$filename} = array('fname'=>$filename, 'width'=>$img_data[0], 'height'=>$img_data[1]);
}
}
}
closedir($folder);
ksort($images);
return $images;
}
/**
* Creates the HTML snippet for the currently defined rating bar, with
* appropriate links (and current rating indication for graphical bars).
* Automatically detects from $this->image_name whether to create text
* links or a graphical bar.
*
* @param string id optional The ID of the bar we're creating; an empty
* id ('' or 0) creates a bar with dummy links; null creates a bar with
* no voting links at all (shows only current configuration).
* @param int karma optional The current total karma (default: 0 points)
* @param int votes optional The total number of votes (default: 0 votes))
* @param string extra_class optional Any additional CSS classes to be added to the bar container
*/
function createRatingBar($id = null, $karma = 0, $votes = 0, $extra_class = '') {
// Are there enough votes to display the current rating?
$enough_votes = ($votes >= $this->get_config('min_disp_votes', 0));
// Do I need to create links?
if ($id !== null) {
// Create the rating tooltips and texts
$vilestr = $this->get_config('rate_vile', PLUGIN_KARMA_VOTEPOINT_1);
$poorstr = $this->get_config('rate_poor', PLUGIN_KARMA_VOTEPOINT_2);
$okaystr = $this->get_config('rate_okay', PLUGIN_KARMA_VOTEPOINT_3);
$goodstr = $this->get_config('rate_good', PLUGIN_KARMA_VOTEPOINT_4);
$beststr = $this->get_config('rate_best', PLUGIN_KARMA_VOTEPOINT_5);
$vile = sprintf(PLUGIN_KARMA_RATE, $vilestr);
$poor = sprintf(PLUGIN_KARMA_RATE, $poorstr);
$okay = sprintf(PLUGIN_KARMA_RATE, $okaystr);
$good = sprintf(PLUGIN_KARMA_RATE, $goodstr);
$best = sprintf(PLUGIN_KARMA_RATE, $beststr);
$vilestr = $this->get_config('text_vile', PLUGIN_KARMA_VOTETEXT_1);
$poorstr = $this->get_config('text_poor', PLUGIN_KARMA_VOTETEXT_2);
$okaystr = $this->get_config('text_okay', PLUGIN_KARMA_VOTETEXT_3);
$goodstr = $this->get_config('text_good', PLUGIN_KARMA_VOTETEXT_4);
$beststr = $this->get_config('text_best', PLUGIN_KARMA_VOTETEXT_5);
if (empty($id)) {
// Create dummy links
$link_1 =
'' . $vilestr . '';
$link_2 =
'' . $poorstr . '';
$link_3 =
'' . $okaystr . '';
$link_4 =
'' . $goodstr . '';
$link_5 =
'' . $beststr . '';
// There *are* enough votes for a dummy rating bar
$enough_votes = true;
} else {
// Create ordinary links
$link_1 = "$vilestr";
$link_2 = "$poorstr";
$link_3 = " $okaystr";
$link_4 = "$goodstr";
$link_5 = "$beststr";
}
}
// Normalize the CSS class
if (!empty($extra_class)) {
$extra_class = " $extra_class";
}
// Create the rating bar
if ($this->image_name == '0') {
// Text bar
//
if ($id === null) {
// No need for a "current rating" bar, like with graphics
$karma_display = '';
} else {
// Show the links
$karma_display = "
$link_1 | $link_2 | $link_3 | $link_4 | $link_5 ";
}
} else {
// Graphic bar
//
// No need to create a bar if there's nothing to display
if (($id !== null) || $enough_votes) {
// Start the bar
$karma_display = "
";
// Only display the current rating if there are enough votes
if ($enough_votes) {
// Figure out the image-based rating and width
$rating = $this->imageRating($karma, $votes);
$cr_width = ($rating * $this->image_width) / 5;
// Get current karma text
$curr_msg = $this->get_config('curr_msg', PLUGIN_KARMA_CURRENT);
$karma_display .= "
";
}
// Only create voting links if required
if ($id !== null) {
$karma_display .= "
$link_1
$link_2
$link_3
$link_4
$link_5
";
}
// Close the
$karma_display .= "
";
}
}
return $karma_display;
}
/**
* Sets $this->image_name to the name of a valid image, or to '0' to
* indicate text-only rating bars should be used.
*/
function set_valid_image_data() {
$base_image = $this->get_config('base_image', false);
if ($base_image !== false) {
// Definitely configured
if ($base_image == '0') {
// Configured to text-only
$this->image_name = $base_image;
} else {
$imagesize = serendipity_getimagesize(dirname(__FILE__) . "/img/" . $base_image);
if ($imagesize['noimage']) {
// Leave as default
} else {
// Set to valid image name
$this->image_name = $base_image;
}
}
}
// Is the (possibly default) image valid?
if ($this->image_name) {
$imagesize = serendipity_getimagesize(dirname(__FILE__) . "/img/" . $this->image_name);
if ($imagesize['noimage']) {
// No valid image; use text-only
$this->image_name = '0';
} else {
// Valid graphical image; set the dimensions, too
$this->image_width = $imagesize[0];
$this->image_height = $imagesize[1];
}
}
}
/**
* Compute the equivalent graphical points rating for a karma rating.
*
* @param int points The total karma points
* @param int votes The total number of votes
*
* @return string A string indicating the number of points "of 5",
* or PLUGIN_KARMA_IMAGE_NONE_RATING if no votes have been recorded.
*/
function imageRating($points, $votes) {
if ($votes == 0) {
$rating = PLUGIN_KARMA_IMAGE_NONE_RATING;
} else {
// Find average karma (-2 to +2)
$rating = ((float)$points) / ((float)$votes);
// Remap into [1,5]
$rating = $rating + 3;
// Put it into the language-specific string format
if ($rating == (int)$rating) {
$rating = sprintf(PLUGIN_KARMA_IMAGE_INT_RATING, $rating);
} else {
$rating = sprintf(PLUGIN_KARMA_IMAGE_RATING, $rating);
}
}
return $rating;
}
/* Compute the equivalent word rating for a karma rating.
*
* @param mixed points The total karma points
* @param mixed votes The total number of votes
*
* @return string A word corresponding to the article rating,
* or PLUGIN_KARMA_IMAGE_NONE_RATING if no votes have been recorded.
*/
function wordRating($points, $votes) {
if ($votes == 0) {
$rating = PLUGIN_KARMA_IMAGE_NONE_RATING;
} else {
// Find average karma (-2 to +2)
$rating = ((float)$points) / ((float)$votes);
// Put it into the language-specific string format, rounding up
// I'm mapping invalid cases (rating > 5 and rating < -2) to the extremes
if ($rating < -1.5) {
$rating = $this->get_config('rate_vile', PLUGIN_KARMA_VOTEPOINT_1);
} elseif ($rating < -0.5) {
$rating = $this->get_config('rate_poor', PLUGIN_KARMA_VOTEPOINT_2);
} elseif ($rating < 0.5) {
$rating = $this->get_config('rate_okay', PLUGIN_KARMA_VOTEPOINT_3);
} elseif ($rating < 1.5) {
$rating = $this->get_config('rate_good', PLUGIN_KARMA_VOTEPOINT_4);
} else {
$rating = $this->get_config('rate_best', PLUGIN_KARMA_VOTEPOINT_5);
}
}
return $rating;
}
}
/* vim: set sts=4 ts=4 sw=4 expandtab : */