* $Author:: $ *
* -------------------------------------------------------------------- *
* Copyright (c) 2003 - 2009 by Roland Haeder *
- * Copyright (c) 2009 - 2011 by Mailer Developer Team *
- * For more information visit: http://www.mxchange.org *
+ * Copyright (c) 2009 - 2013 by Mailer Developer Team *
+ * For more information visit: http://mxchange.org *
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
$return = $ref_points;
// Get all ref levels
- $result_refs = SQL_QUERY('SELECT `level`,`percents` FROM `{?_MYSQL_PREFIX?}_refdepths` WHERE `level` > 0 ORDER BY `level` ASC',
+ $result_refs = sqlQuery('SELECT `level`, `percents` FROM `{?_MYSQL_PREFIX?}_refdepths` WHERE `level` > 0 ORDER BY `level` ASC',
__FUNCTION__, __LINE__);
// "Walk" through all level
- while ($content = SQL_FETCHARRAY($result_refs)) {
+ while ($content = sqlFetchArray($result_refs)) {
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'level=' . $content['level'] . ',percents=' . $content['percents'] . ' - LOOP START!');
// Reset ref depths
- initReferalSystem();
+ initReferralSystem();
// Init array
$refids = getArrayFromRefbackLevel($userid, $content['level']);
* call. If you do so, you will check the wrong direction, $userid
* is always bigger than $refid.
*/
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . makeNullToZero($refid) . ' - CALLING getRefbackPercents()');
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . convertNullToZero($refid) . ' - CALLING getRefbackPercents()');
$content['refback_percents'] = getRefbackPercents($refid, $userid);
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . makeNullToZero($refid) . ',refback_percents=' . $content['refback_percents']);
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . convertNullToZero($refid) . ',refback_percents=' . $content['refback_percents']);
// Some percents given?
if ($content['refback_percents'] > 0) {
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'points=' . $points . ',percents=' . $content['percents'] . ',refback_percents=' . $content['refback_percents'] . ',level=' . $content['level'] . ',refback_points=' . $refbackPoints);
// Update refback table ('refid' and 'userid' must be exchanged!)
- SQL_QUERY_ESC('UPDATE
+ sqlQueryEscaped('UPDATE
`{?_MYSQL_PREFIX?}_user_refs`
SET
`refback_points`=`refback_points`+%s
), __FUNCTION__, __LINE__);
// Something must have been updated
- if (SQL_HASZEROAFFECTED()) {
+ if (ifSqlHasZeroAffectedRows()) {
// Please report this bug
- debug_report_bug(__FUNCTION__, __LINE__, 'Nothing has been updated in user_refs,userid=' . $userid . ',refid=' . makeNullToZero($refid) . ',refbackPoints=' . $refbackPoints);
+ reportBug(__FUNCTION__, __LINE__, 'Nothing has been updated in user_refs,userid=' . $userid . ',refid=' . convertNullToZero($refid) . ',refbackPoints=' . $refbackPoints);
} // END - if
// Add points again, but only directly
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refbackPoints=' . $refbackPoints . ',userid=' . $userid . ',ref=' . $ref . ',refid=' . makeNullToZero($refid) . ' - REFBACK-UPDATE! (' . SQL_AFFECTEDROWS() . ')');
- addPointsThroughReferalSystem(sprintf("refback:%s", $refid), $userid, $refbackPoints);
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refbackPoints=' . $refbackPoints . ',userid=' . $userid . ',ref=' . $ref . ',refid=' . convertNullToZero($refid) . ' - REFBACK-UPDATE! (' . sqlAffectedRows() . ')');
+ addPointsThroughReferralSystem(sprintf("refback:%s", $refid), $userid, $refbackPoints);
// Reduce points if refid is found
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . $refid . ',ref=' . $ref . ' - REDUCING?');
} // END - while
// Free result
- SQL_FREERESULT($result_refs);
+ sqlFreeResult($result_refs);
// Restore ref depth
$GLOBALS['ref_level'] = $GLOBALS['refback_depth'][$userid][$ref];
* "Getter" for refback percents
*
* @param $userid "Current" user's userid
- * @param $refid $userid has this userid as referal
+ * @param $refid $userid has this userid as referral
* @return $percents Refback percents $userid has given to $refid
*/
function getRefbackPercents ($userid, $refid) {
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . $refid . ' - ENTERED!');
- if ((!isValidUserId($userid)) || (!isValidUserId($refid))) {
+ if ((!isValidId($userid)) || (!isValidId($refid))) {
// userid and/or refid is invalid
- debug_report_bug(__FUNCTION__, __LINE__, 'userid=' . makeNullToZero($userid) . ', refid=' . makeNullToZero($refid) . ' - Both must be > 0');
+ reportBug(__FUNCTION__, __LINE__, 'userid=' . convertNullToZero($userid) . ', refid=' . convertNullToZero($refid) . ' - Both must be > 0');
} elseif ($userid == $refid) {
// Skip identical ids
return 0;
$GLOBALS['refback_percents'][$userid][$refid] = '0';
// Get percents from database
- $result = SQL_QUERY_ESC("SELECT `refback_percents` FROM `{?_MYSQL_PREFIX?}_user_refs` WHERE `userid`=%s AND `refid`=%s LIMIT 1",
+ $result = sqlQueryEscaped("SELECT `refback_percents` FROM `{?_MYSQL_PREFIX?}_user_refs` WHERE `userid`=%s AND `refid`=%s LIMIT 1",
array($userid, $refid), __FUNCTION__, __LINE__);
// Entry found? (Should be!)
- if (SQL_NUMROWS($result) == 1) {
+ if (sqlNumRows($result) == 1) {
// Fetch percents
- list($GLOBALS['refback_percents'][$userid][$refid]) = SQL_FETCHROW($result);
+ list($GLOBALS['refback_percents'][$userid][$refid]) = sqlFetchRow($result);
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . $refid . ',percents=' . $GLOBALS['refback_percents'][$userid][$refid]);
} else {
// Please report all findings
- debug_report_bug(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . $refid . ' - No entry found. :-(');
+ reportBug(__FUNCTION__, __LINE__, 'userid=' . $userid . ',refid=' . $refid . ' - No entry found. :-(');
}
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
} // END - if
// Return percents
// "Getter" for userid array which will return only one entry
function getArrayFromRefbackLevel ($refid, $level) {
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . makeNullToZero($refid) . ',level=' . $level . ' - ENTERED!');
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . convertNullToZero($refid) . ',level=' . $level . ' - ENTERED!');
// Init userids
$userIds = array();
// Look for all
- $result = SQL_QUERY_ESC("SELECT
+ $result = sqlQueryEscaped("SELECT
`userid`
FROM
`{?_MYSQL_PREFIX?}_user_refs`
array($refid, $level), __FUNCTION__, __LINE__);
// Entries found?
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'numRows=' . SQL_NUMROWS($result));
- if (!SQL_HASZERONUMS($result)) {
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'numRows=' . sqlNumRows($result));
+ if (!ifSqlHasZeroNums($result)) {
// Add all
- while ($content = SQL_FETCHARRAY($result)) {
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . makeNullToZero($refid) . ',level=' . $level . ',userid=' . $content['userid']);
- $userIds[] = $content['userid'];
+ while ($content = sqlFetchArray($result)) {
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . convertNullToZero($refid) . ',level=' . $level . ',userid=' . $content['userid']);
+ array_push($userIds, $content['userid']);
} // END - while
} // END - if
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
// Return array
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . makeNullToZero($refid) . ',userIds()=' . count($userIds) . ' - EXIT!');
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . convertNullToZero($refid) . ',userIds()=' . count($userIds) . ' - EXIT!');
return $userIds;
}
$refs = array();
// Get refs from database
- $result = SQL_QUERY_ESC("SELECT
- r.`id`,
- r.`refid`,
- r.`refback_percents`,
- r.`refback_points`,
- d.`status`,
- d.`joined`,
- d.`mails_confirmed`,
- d.`emails_received`,
- d.`refid` AS `level_refid`
+ $result = sqlQueryEscaped("SELECT
+ `r`.`id`,
+ `r`.`refid`,
+ `r`.`refback_percents`,
+ `r`.`refback_points`,
+ `d`.`status`,
+ `d`.`joined`,
+ `d`.`mails_confirmed`,
+ `d`.`emails_received`,
+ `d`.`refid` AS `level_refid`
FROM
- `{?_MYSQL_PREFIX?}_user_refs` AS r
+ `{?_MYSQL_PREFIX?}_user_refs` AS `r`
LEFT JOIN
- `{?_MYSQL_PREFIX?}_user_data` AS d
+ `{?_MYSQL_PREFIX?}_user_data` AS `d`
ON
- r.`refid`=d.`userid`
+ `r`.`refid`=`d`.`userid`
WHERE
- r.`userid`=%s AND
- r.`level`=%s
+ `r`.`userid`=%s AND
+ `r`.`level`=%s
ORDER BY
- r.`refid` ASC",
+ `r`.`refid` ASC",
array(bigintval($userid), bigintval($level)), __FUNCTION__, __LINE__);
// Are there some entries?
- if (!SQL_HASZERONUMS($result)) {
+ if (!ifSqlHasZeroNums($result)) {
// Fetch all entries
- while ($row = SQL_FETCHARRAY($result)) {
- // Init click rate
- $row['click_rate'] = '0';
-
- // Does he have received some mails?
- if ($row['emails_received'] > 0) {
- // Calculate click rate
- $row['click_rate'] = ($row['mails_confirmed'] / $row['emails_received'] * 100);
- } // END - if
+ while ($row = sqlFetchArray($result)) {
+ // Calculate click rate
+ $row['click_rate'] = calculatePercentageRate($row['mails_confirmed'], $row['emails_received']);
// Add row
$refs[$row['id']] = $row;
} // END - if
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
// Return result
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',level=' . $level . ',refs()=' . count($refs) . ' - EXIT!');
$id = bigintval($id);
// Get entry from database
- $result = SQL_QUERY_ESC("SELECT `id`,`userid`,`refid`,`refback_percents`,`level`,`refback_points` FROM `{?_MYSQL_PREFIX?}_user_refs` WHERE `id`=%s AND `userid`=%s LIMIT 1",
+ $result = sqlQueryEscaped("SELECT `id`, `userid`, `refid`, `refback_percents`, `level`, `refback_points` FROM `{?_MYSQL_PREFIX?}_user_refs` WHERE `id`=%s AND `userid`=%s LIMIT 1",
array($id, getMemberId()), __FUNCTION__, __LINE__);
// Is there an entry?
- if (SQL_NUMROWS($result) == 1) {
+ if (sqlNumRows($result) == 1) {
// Fetch data
- $data = SQL_FETCHARRAY($result);
+ $data = sqlFetchArray($result);
} // END - if
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
// Return entry
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'id=' . $id . ',data()=' . count($data) . ' - EXIT!');
$content = getArrayFromUserRefbackData($id);
// Is this valid?
- if (count($content) == 0) {
+ if (!isFilledArray($content)) {
// id does not belong to user!
$status['message'] = 'MEMBER_REFBACK_ERROR_ID_MISMATCH';
return $status;
$percents = convertCommaToDot($percents);
// Update entry
- SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_user_refs` SET `refback_percents`='%s' WHERE `id`=%s AND `userid`=%s LIMIT 1",
+ sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_user_refs` SET `refback_percents`='%s' WHERE `id`=%s AND `userid`=%s LIMIT 1",
array(
$percents,
$id,
), __FUNCTION__, __LINE__);
// Entry updated?
- if (SQL_HASZEROAFFECTED()) {
+ if (ifSqlHasZeroAffectedRows()) {
// Entry not updated!
$status['message'] = 'MEMBER_REFBACK_ERROR_NOT_UPDATED';
return $status;
// Prepare email content
$content['refback_percents'] = $percents;
- $content['refback_note'] = $note;
+ $content['refback_notice'] = $note;
// Load member email template
$mail = loadEmailTemplate('member_refback', $content, $content['refid']);
sendAdminNotification('{--ADMIN_REFBACK_SUBJECT--}', 'admin_refback', $content, $content['refid']);
// All fine!
- $status['ok'] = true;
+ $status['ok'] = TRUE;
// Return status array
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'id=' . $id . ',percents=' . $percents . ' - EXIT!');
return $status;
}
-// Checks wether refback is enabled
+// ----------------------------------------------------------------------------
+// Wrapper functions for configuration entries
+// ----------------------------------------------------------------------------
+
+// Getter for refback_enabled
+function getRefbackEnabled () {
+ // Is there cache?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__] = getConfig('refback_enabled');
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__];
+}
+
+// Checks whether refback is enabled
function isRefbackEnabled () {
- // Do we have cache?
+ // Is there cache?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__] = (getRefbackEnabled() == 'Y');
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for refback_max_perc
+function getRefbackMaxPerc () {
+ // Is there cache?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__] = getConfig('refback_max_perc');
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for refback_min_perc
+function getRefbackMinPerc () {
+ // Is there cache?
if (!isset($GLOBALS[__FUNCTION__])) {
// Determine it
- $GLOBALS[__FUNCTION__] = (getConfig('refback_enabled') == 'Y');
+ $GLOBALS[__FUNCTION__] = getConfig('refback_min_perc');
} // END - if
// Return cache