Gazelle/classes/class_torrents.php

<?
class Torrents {
	const FilelistDelim = 0xF7; // Hex for &divide; Must be the same as phrase_boundary in sphinx.conf!

	/*
	 * Function to get data and torrents for an array of GroupIDs.
	 * In places where the output from this is merged with sphinx filters, it will be in a different order.
	 *
	 * @param array $GroupIDs
	 * @param boolean $Return if false, nothing is returned. For priming cache.
	 * @param boolean $GetArtists if true, each group will contain the result of
	 *	Artists::get_artists($GroupID), in result[$GroupID]['ExtendedArtists']
	 * @param boolean $Torrents if true, each group contains a list of torrents, in result[$GroupID]['Torrents']
	 *
	 * @return array each row of the following format:
	 * GroupID => (
	 *	ID
	 *	Name
	 *	Year
	 *	RecordLabel
	 *	CatalogueNumber
	 *	TagList
	 *	ReleaseType
	 *	VanityHouse
	 *	WikiImage
	 *	CategoryID
	 *	Torrents => {
	 *		ID => {
	 *			GroupID, Media, Format, Encoding, RemasterYear, Remastered,
	 *			RemasterTitle, RemasterRecordLabel, RemasterCatalogueNumber, Scene,
	 *			HasLog, HasCue, LogScore, FileCount, FreeTorrent, Size, Leechers,
	 *			Seeders, Snatched, Time, HasFile, PersonalFL, IsSnatched
	 *		}
	 *	}
	 *	Artists => {
	 *		{
	 *			id, name, aliasid // Only main artists
	 *		}
	 *	}
	 *	ExtendedArtists => {
	 *		[1-6] => { // See documentation on Artists::get_artists
	 *			id, name, aliasid
	 *		}
	 *	}
	 *	Flags => {
	 *		IsSnatched
	 *	}
	 */
	public static function get_groups($GroupIDs, $Return = true, $GetArtists = true, $Torrents = true) {
		global $DB, $Cache, $Debug;

		// Make sure there's something in $GroupIDs, otherwise the SQL
		// will break
		if (count($GroupIDs) == 0) {
			return array('matches'=>array(),'notfound'=>array());
		}

		$Found = $NotFound = array_flip($GroupIDs);
		$Key = $Torrents ? 'torrent_group_' : 'torrent_group_light_';

		foreach ($GroupIDs as $GroupID) {
			$Data = $Cache->get_value($Key.$GroupID, true);
			if (!empty($Data) && (@$Data['ver'] == CACHE::GROUP_VERSION)) {
				unset($NotFound[$GroupID]);
				$Found[$GroupID] = $Data['d'];
			}
		}

		$IDs = implode(',',array_flip($NotFound));

		/*
		Changing any of these attributes returned will cause very large, very dramatic site-wide chaos.
		Do not change what is returned or the order thereof without updating:
			torrents, artists, collages, bookmarks, better, the front page,
		and anywhere else the get_groups function is used.
		Update self::array_group(), too
		*/

		if (count($NotFound) > 0) {
			$DB->query("SELECT
				g.ID, g.Name, g.Year, g.RecordLabel, g.CatalogueNumber, g.TagList, g.ReleaseType, g.VanityHouse, g.WikiImage, g.CategoryID
				FROM torrents_group AS g WHERE g.ID IN ($IDs)");

			while($Group = $DB->next_record(MYSQLI_ASSOC, true)) {
				unset($NotFound[$Group['ID']]);
				$Found[$Group['ID']] = $Group;
				$Found[$Group['ID']]['Torrents'] = array();
				$Found[$Group['ID']]['Artists'] = array();
			}

			// Orphan torrents. There shouldn't ever be any
			if (count($NotFound) > 0) {
				foreach (array_keys($NotFound) as $GroupID) {
					unset($Found[$GroupID]);
				}
			}

			if ($Torrents) {
				$DB->query("SELECT
							ID, GroupID, Media, Format, Encoding, RemasterYear, Remastered, RemasterTitle,
							RemasterRecordLabel, RemasterCatalogueNumber, Scene, HasLog, HasCue, LogScore,
							FileCount, FreeTorrent, Size, Leechers, Seeders, Snatched, Time, ID AS HasFile
							FROM torrents AS t
							WHERE GroupID IN($IDs)
							ORDER BY GroupID, Remastered, (RemasterYear <> 0) DESC, RemasterYear, RemasterTitle,
							RemasterRecordLabel, RemasterCatalogueNumber, Media, Format, Encoding, ID");
				while($Torrent = $DB->next_record(MYSQLI_ASSOC, true)) {
					$Found[$Torrent['GroupID']]['Torrents'][$Torrent['ID']] = $Torrent;
				}

				// Cache it all
				foreach ($Found as $GroupID => $GroupInfo) {
					$Cache->cache_value('torrent_group_'.$GroupID,
							array('ver' => CACHE::GROUP_VERSION, 'd' => $GroupInfo), 0);
					$Cache->cache_value('torrent_group_light_'.$GroupID,
							array('ver' => CACHE::GROUP_VERSION, 'd' => $GroupInfo), 0);
				}

			} else {
				foreach ($Found as $Group) {
					$Cache->cache_value('torrent_group_light_'.$Group['ID'], array('ver' => CACHE::GROUP_VERSION, 'd' => $Found[$Group['ID']]), 0);
				}
			}
		}
		if ($GetArtists) {
			$Artists = Artists::get_artists($GroupIDs);
		} else {
			$Artists = array();
		}

		if ($Return) { // If we're interested in the data, and not just caching it
			foreach ($Artists as $GroupID => $Data) {
				if (array_key_exists(1, $Data) || array_key_exists(4, $Data) || array_key_exists(6, $Data)) {
					$Found[$GroupID]['Artists'] = isset($Data[1]) ? $Data[1] : null; // Only use main artists (legacy)
					for ($i = 1; $i <= 6; $i++) {
						$Found[$GroupID]['ExtendedArtists'][$i] = isset($Data[$i]) ? $Data[$i] : null;
					}
				}
				else {
					$Found[$GroupID]['ExtendedArtists'] = false;
				}
			}
			// Fetch all user specific torrent properties
			foreach ($Found as &$Group) {
				$Group['Flags'] = array('IsSnatched' => false);
				if (!empty($Group['Torrents'])) {
					foreach ($Group['Torrents'] as &$Torrent) {
						self::torrent_properties($Torrent, $Group['Flags']);
					}
				}
			}

			$Matches = array('matches'=>$Found, 'notfound'=>array_flip($NotFound));

			return $Matches;
		}
	}

	/**
	 * Returns a reconfigured array from a Torrent Group
	 *
	 * Use this with extract() instead of the volatile list($GroupID, ...)
	 * Then use the variables $GroupID, $GroupName, etc
	 *
	 * @example  extract(Torrents::array_group($SomeGroup));
	 * @param array $Group torrent group
	 * @return array Re-key'd array
	 */
	public static function array_group (array &$Group)
	{
		return array(
			'GroupID' => $Group['ID'],
			'GroupName' => $Group['Name'],
			'GroupYear' => $Group['Year'],
			'GroupCategoryID' => $Group['CategoryID'],
			'GroupRecordLabel' => $Group['RecordLabel'],
			'GroupCatalogueNumber' => $Group['CatalogueNumber'],
			'GroupVanityHouse' => $Group['VanityHouse'],
			'GroupFlags' => $Group['Flags'],
			'TagList' => $Group['TagList'],
			'ReleaseType' => $Group['ReleaseType'],
			'WikiImage' => $Group['WikiImage'],
			'Torrents' => $Group['Torrents'],
			'Artists' => $Group['Artists'],
			'ExtendedArtists' => $Group['ExtendedArtists']
		);
	}

	/**
	 * Supplements a torrent array with information that only concerns certain users and therefore cannot be cached
	 *
	 * @param array $Torrent torrent array preferably in the form used by Torrents::get_groups() or get_group_info()
	 * @param int $TorrentID
	 */
	public static function torrent_properties(&$Torrent, &$Flags) {
		$Torrent['PersonalFL'] = empty($Torrent['FreeTorrent']) && self::has_token($Torrent['ID']);
		if ($Torrent['IsSnatched'] = self::has_snatched($Torrent['ID'])) {
			$Flags['IsSnatched'] = true;
		}
	}


	/*
	 * Write to the group log.
	 *
	 * @param int $GroupID
	 * @param int $TorrentID
	 * @param int $UserID
	 * @param string $Message
	 * @param boolean $Hidden Currently does fuck all. TODO: Fix that.
	 */
	public static function write_group_log($GroupID, $TorrentID, $UserID, $Message, $Hidden) {
		global $DB,$Time;
		$DB->query("INSERT INTO group_log (GroupID, TorrentID, UserID, Info, Time, Hidden) VALUES ("
			.$GroupID.", ".$TorrentID.", ".$UserID.", '".db_string($Message)."', '".sqltime()."', ".$Hidden.")");
	}


	/**
	 * Delete a torrent.
	 *
	 * @param int $ID The ID of the torrent to delete.
	 * @param int $GroupID Set it if you have it handy, to save a query. Otherwise, it will be found.
	 * @param string $OcelotReason The deletion reason for ocelot to report to users.
	 */
	public static function delete_torrent($ID, $GroupID=0, $OcelotReason=-1) {
		global $DB, $Cache, $LoggedUser;
		if (!$GroupID) {
			$DB->query("SELECT GroupID, UserID FROM torrents WHERE ID='$ID'");
			list($GroupID, $UploaderID) = $DB->next_record();
		}
		if (empty($UserID)) {
			$DB->query("SELECT UserID FROM torrents WHERE ID='$ID'");
			list($UserID) = $DB->next_record();
		}

		$RecentUploads = $Cache->get_value('recent_uploads_'.$UserID);
		if (is_array($RecentUploads)) {
			foreach ($RecentUploads as $Key => $Recent) {
				if ($Recent['ID'] == $GroupID) {
					$Cache->delete_value('recent_uploads_'.$UserID);
				}
			}
		}

		
		$DB->query("SELECT info_hash FROM torrents WHERE ID = ".$ID);
		list($InfoHash) = $DB->next_record(MYSQLI_BOTH, false);
		$DB->query("DELETE FROM torrents WHERE ID = ".$ID);
		Tracker::update_tracker('delete_torrent', array('info_hash' => rawurlencode($InfoHash), 'id' => $ID, 'reason' => $OcelotReason));

		$Cache->decrement('stats_torrent_count');

		$DB->query("SELECT COUNT(ID) FROM torrents WHERE GroupID='$GroupID'");
		list($Count) = $DB->next_record();

		if ($Count == 0) {
			Torrents::delete_group($GroupID);
		} else {
			Torrents::update_hash($GroupID);
		}

		// Torrent notifications
		$DB->query("SELECT UserID FROM users_notify_torrents WHERE TorrentID='$ID'");
		while(list($UserID) = $DB->next_record()) {
			$Cache->delete_value('notifications_new_'.$UserID);
		}
		$DB->query("DELETE FROM users_notify_torrents WHERE TorrentID='$ID'");


		$DB->query("UPDATE reportsv2 SET
				Status='Resolved',
				LastChangeTime='".sqltime()."',
				ModComment='Report already dealt with (Torrent deleted)'
			WHERE TorrentID=".$ID."
				AND Status != 'Resolved'");
		$Reports = $DB->affected_rows();
		if ($Reports) {
			$Cache->decrement('num_torrent_reportsv2', $Reports);
		}

		$DB->query("DELETE FROM torrents_files WHERE TorrentID='$ID'");
		$DB->query("DELETE FROM torrents_bad_tags WHERE TorrentID = ".$ID);
		$DB->query("DELETE FROM torrents_bad_folders WHERE TorrentID = ".$ID);
		$DB->query("DELETE FROM torrents_bad_files WHERE TorrentID = ".$ID);
		$DB->query("DELETE FROM torrents_cassette_approved WHERE TorrentID = ".$ID);
		$DB->query("DELETE FROM torrents_lossymaster_approved WHERE TorrentID = ".$ID);
		$DB->query("DELETE FROM torrents_lossyweb_approved WHERE TorrentID = ".$ID);

		// Tells Sphinx that the group is removed
		$DB->query("REPLACE INTO sphinx_delta (ID,Time) VALUES ($ID, UNIX_TIMESTAMP())");

		$Cache->delete_value('torrent_download_'.$ID);
		$Cache->delete_value('torrent_group_'.$GroupID);
		$Cache->delete_value('torrents_details_'.$GroupID);
	}


	/**
	 * Delete a group, called after all of its torrents have been deleted.
	 * IMPORTANT: Never call this unless you're certain the group is no longer used by any torrents
	 *
	 * @param int $GroupID
	 */
	public static function delete_group($GroupID) {
		global $DB, $Cache;

		Misc::write_log("Group ".$GroupID." automatically deleted (No torrents have this group).");

		$DB->query("SELECT CategoryID FROM torrents_group WHERE ID='$GroupID'");
		list($Category) = $DB->next_record();
		if ($Category == 1) {
			$Cache->decrement('stats_album_count');
		}
		$Cache->decrement('stats_group_count');

		

		// Collages
		$DB->query("SELECT CollageID FROM collages_torrents WHERE GroupID='$GroupID'");
		if ($DB->record_count()>0) {
			$CollageIDs = $DB->collect('CollageID');
			$DB->query("UPDATE collages SET NumTorrents=NumTorrents-1 WHERE ID IN (".implode(', ',$CollageIDs).")");
			$DB->query("DELETE FROM collages_torrents WHERE GroupID='$GroupID'");

			foreach ($CollageIDs as $CollageID) {
				$Cache->delete_value('collage_'.$CollageID);
			}
			$Cache->delete_value('torrent_collages_'.$GroupID);
		}

		// Artists
		// Collect the artist IDs and then wipe the torrents_artist entry
		$DB->query("SELECT ArtistID FROM torrents_artists WHERE GroupID = ".$GroupID);
		$Artists = $DB->collect('ArtistID');

		$DB->query("DELETE FROM torrents_artists WHERE GroupID='$GroupID'");

		foreach ($Artists as $ArtistID) {
			if (empty($ArtistID)) { continue; }
			// Get a count of how many groups or requests use the artist ID
			$DB->query("SELECT COUNT(ag.ArtistID)
						FROM artists_group as ag
							LEFT JOIN requests_artists AS ra ON ag.ArtistID=ra.ArtistID
						WHERE ra.ArtistID IS NOT NULL
							AND ag.ArtistID = '$ArtistID'");
			list($ReqCount) = $DB->next_record();
			$DB->query("SELECT COUNT(ag.ArtistID)
						FROM artists_group as ag
							LEFT JOIN torrents_artists AS ta ON ag.ArtistID=ta.ArtistID
						WHERE ta.ArtistID IS NOT NULL
							AND ag.ArtistID = '$ArtistID'");
			list($GroupCount) = $DB->next_record();
			if (($ReqCount + $GroupCount) == 0) {
				//The only group to use this artist
				Artists::delete_artist($ArtistID);
			} else {
				//Not the only group, still need to clear cache
				$Cache->delete_value('artist_groups_'.$ArtistID);
			}
		}

		// Requests
		$DB->query("SELECT ID FROM requests WHERE GroupID='$GroupID'");
		$Requests = $DB->collect('ID');
		$DB->query("UPDATE requests SET GroupID = NULL WHERE GroupID = '$GroupID'");
		foreach ($Requests as $RequestID) {
			$Cache->delete_value('request_'.$RequestID);
		}

		$DB->query("DELETE FROM torrents_group WHERE ID='$GroupID'");
		$DB->query("DELETE FROM torrents_tags WHERE GroupID='$GroupID'");
		$DB->query("DELETE FROM torrents_tags_votes WHERE GroupID='$GroupID'");
		$DB->query("DELETE FROM torrents_comments WHERE GroupID='$GroupID'");
		$DB->query("DELETE FROM bookmarks_torrents WHERE GroupID='$GroupID'");
		$DB->query("DELETE FROM wiki_torrents WHERE PageID='$GroupID'");

		$Cache->delete_value('torrents_details_'.$GroupID);
		$Cache->delete_value('torrent_group_'.$GroupID);
		$Cache->delete_value('groups_artists_'.$GroupID);
	}


	/**
	 * Update the cache and sphinx delta index to keep everything up to date.
	 *
	 * @param int $GroupID
	 */
	public static function update_hash($GroupID) {
		global $DB, $Cache;
		$DB->query("UPDATE torrents_group SET TagList=(SELECT REPLACE(GROUP_CONCAT(tags.Name SEPARATOR ' '),'.','_')
			FROM torrents_tags AS t
			INNER JOIN tags ON tags.ID=t.TagID
			WHERE t.GroupID='$GroupID'
			GROUP BY t.GroupID)
			WHERE ID='$GroupID'");

		// Fetch album vote score
		$DB->query("SELECT Score FROM torrents_votes WHERE GroupID=$GroupID");
		if ($DB->record_count()) {
			list($VoteScore) = $DB->next_record();
		} else {
			$VoteScore = 0;
		}

		// Fetch album artists
		$DB->query("SELECT GROUP_CONCAT(aa.Name separator ' ')
			FROM torrents_artists AS ta
				JOIN artists_alias AS aa ON aa.AliasID=ta.AliasID
			WHERE ta.GroupID=$GroupID AND ta.Importance IN ('1', '4', '5', '6')
			GROUP BY ta.GroupID");
		if ($DB->record_count()) {
			list($ArtistName) = $DB->next_record(MYSQLI_NUM, false);
		} else {
			$ArtistName = '';
		}

		$DB->query("REPLACE INTO sphinx_delta
				(ID, GroupID, GroupName, TagList, Year, CategoryID, Time, ReleaseType, RecordLabel,
				CatalogueNumber, VanityHouse, Size, Snatched, Seeders, Leechers, LogScore, Scene,
				HasLog, HasCue, FreeTorrent, Media, Format, Encoding, RemasterYear, RemasterTitle,
				RemasterRecordLabel, RemasterCatalogueNumber, FileList, VoteScore, ArtistName)
			SELECT
				t.ID, g.ID, Name, TagList, Year, CategoryID, UNIX_TIMESTAMP(t.Time), ReleaseType,
				RecordLabel, CatalogueNumber, VanityHouse, Size >> 10 AS Size, Snatched, Seeders,
				Leechers, LogScore, CAST(Scene AS CHAR), CAST(HasLog AS CHAR), CAST(HasCue AS CHAR),
				CAST(FreeTorrent AS CHAR), Media, Format, Encoding,
				RemasterYear, RemasterTitle, RemasterRecordLabel, RemasterCatalogueNumber,
				REPLACE(FileList, '_', ' ') AS FileList, $VoteScore, '".db_string($ArtistName)."'
			FROM torrents AS t
			JOIN torrents_group AS g ON g.ID=t.GroupID
			WHERE g.ID=$GroupID");

/*		$DB->query("INSERT INTO sphinx_delta
			(ID, ArtistName)
			SELECT torrents.ID, artists.ArtistName FROM (
				SELECT
				GroupID,
				GROUP_CONCAT(aa.Name separator ' ') AS ArtistName
				FROM torrents_artists AS ta
				JOIN artists_alias AS aa ON aa.AliasID=ta.AliasID
				WHERE ta.GroupID=$GroupID AND ta.Importance IN ('1', '4', '5', '6')
				GROUP BY ta.GroupID
			) AS artists
			JOIN torrents USING(GroupID)
			ON DUPLICATE KEY UPDATE ArtistName=values(ArtistName)");
*/
		$Cache->delete_value('torrents_details_'.$GroupID);
		$Cache->delete_value('torrent_group_'.$GroupID);

		$ArtistInfo = Artists::get_artist($GroupID);
		foreach ($ArtistInfo as $Importances => $Importance) {
			foreach ($Importance as $Artist) {
				$Cache->delete_value('artist_groups_'.$Artist['id']); //Needed for at least freeleech change, if not others.
			}
		}

		$Cache->delete_value('groups_artists_'.$GroupID);
	}

	/**
	 * Regenerate a torrent's filelist from its meta data,
	 * update the database record and clear relevant cache keys
	 *
	 * @param int $TorrentID
	 */
	public static function regenerate_filelist($TorrentID) {
		global $DB, $Cache;
		$DB->query("SELECT tg.ID,
				tf.File
			FROM torrents_files AS tf
				JOIN torrents AS t ON t.ID=tf.TorrentID
				JOIN torrents_group AS tg ON tg.ID=t.GroupID
				WHERE tf.TorrentID = ".$TorrentID);
		if ($DB->record_count() > 0) {
			list($GroupID, $Contents) = $DB->next_record(MYSQLI_NUM, false);
			if (Misc::is_new_torrent($Contents)) {
				$Tor = new BencodeTorrent($Contents);
				$FilePath = isset($Tor->Dec['info']['files']) ? Format::make_utf8($Tor->get_name()) : '';
			} else {
				$Tor = new TORRENT(unserialize(base64_decode($Contents)), true);
				$FilePath = isset($Tor->Val['info']->Val['files']) ? Format::make_utf8($Tor->get_name()) : '';
			}
			list($TotalSize, $FileList) = $Tor->file_list();
			foreach($FileList as $File) {
				$TmpFileList[] = self::filelist_format_file($File);
			}
			$FileString = implode("\n", $TmpFileList);
			$DB->query("UPDATE torrents SET Size = ".$TotalSize.", FilePath = '".db_string($FilePath)."', FileList = '".db_string($FileString)."' WHERE ID = ".$TorrentID);
			$Cache->delete_value('torrents_details_'.$GroupID);
		}
	}

	/**
	 * Return UTF-8 encoded string to use as file delimiter in torrent file lists
	 */
	public static function filelist_delim() {
		static $FilelistDelimUTF8;
		if (isset($FilelistDelimUTF8)) {
			return $FilelistDelimUTF8;
		}
		return $FilelistDelimUTF8 = utf8_encode(chr(self::FilelistDelim));
	}

	/**
	 * Create a string that contains file info in a format that's easy to use for Sphinx
	 *
	 * @param array $File (File size, File name)
	 * @return string with the format .EXT sSIZEs NAME DELIMITER
	 */
	public static function filelist_format_file($File) {
		list($Size, $Name) = $File;
		$Name = Format::make_utf8(strtr($Name, "\n\r\t", "   "));
		$ExtPos = strrpos($Name, '.');
		// Should not be $ExtPos !== false. Extensionless files that start with a . should not get extensions
		$Ext = $ExtPos ? trim(substr($Name, $ExtPos+1)) : '';
		return sprintf("%s s%ds %s %s", ".$Ext", $Size, $Name, self::filelist_delim());
	}

	/**
	 * Create a string that contains file info in the old format for the API
	 *
	 * @param string $File string with the format .EXT sSIZEs NAME DELIMITER
	 * @return string with the format NAME{{{SIZE}}}
	 */
	public static function filelist_old_format($File) {
		$File = self::filelist_get_file($File);
		return $File['name'] . '{{{' . $File['size'] . '}}}';
	}

	/**
	 * Translate a formatted file info string into a more useful array structure
	 *
	 * @param string $File string with the format .EXT sSIZEs NAME DELIMITER
	 * @return file info array with the keys 'ext', 'size' and 'name'
	 */
	public static function filelist_get_file($File) {
		// Need this hack because filelists are always display_str()ed
		$DelimLen = strlen(display_str(self::filelist_delim())) + 1;
		list($FileExt, $Size, $Name) = explode(' ', $File, 3);
		if ($Spaces = strspn($Name, ' ')) {
			$Name = str_replace(' ', '&nbsp;', substr($Name, 0, $Spaces)) . substr($Name, $Spaces);
		}
		return array('ext' => $FileExt, 'size' => substr($Size, 1, -1), 'name' => substr($Name, 0, -$DelimLen));
	}

	/**
	 * Format the information about a torrent.
	 * @param $Data an array a subset of the following keys:
	 *	Format, Encoding, HasLog, LogScore HasCue, Media, Scene, RemasterYear
	 *	RemasterTitle, FreeTorrent, PersonalFL
	 * @param boolean $ShowMedia if false, Media key will be omitted
	 * @param boolean $ShowEdition if false, RemasterYear/RemasterTitle will be omitted
	 */
	public static function torrent_info($Data, $ShowMedia = false, $ShowEdition = false) {
		$Info = array();
		if (!empty($Data['Format'])) { $Info[]=$Data['Format']; }
		if (!empty($Data['Encoding'])) { $Info[]=$Data['Encoding']; }
		if (!empty($Data['HasLog'])) {
			$Str = 'Log';
			if (!empty($Data['LogScore'])) {
				$Str.=' ('.$Data['LogScore'].'%)';
			}
			$Info[]=$Str;
		}
		if (!empty($Data['HasCue'])) { $Info[]='Cue'; }
		if ($ShowMedia && !empty($Data['Media'])) { $Info[]=$Data['Media']; }
		if (!empty($Data['Scene'])) { $Info[]='Scene'; }
		if ($ShowEdition) {
			$EditionInfo = array();
			if (!empty($Data['RemasterYear'])) { $EditionInfo[]=$Data['RemasterYear']; }
			if (!empty($Data['RemasterTitle'])) { $EditionInfo[]=$Data['RemasterTitle']; }
			if (count($EditionInfo)) { $Info[]=implode(' ',$EditionInfo); }
		}
		if ($Data['IsSnatched']) { $Info[]= Format::torrent_label('Snatched!'); }
		if ($Data['FreeTorrent'] == '1') { $Info[]= Format::torrent_label('Freeleech!'); }
		if ($Data['FreeTorrent'] == '2') { $Info[]= Format::torrent_label('Neutral Leech!'); }
		if ($Data['PersonalFL']) { $Info[]= Format::torrent_label('Personal Freeleech!'); }
		return implode(' / ', $Info);
	}


	/**
	 * Will freeleech / neutralleech / normalise a set of torrents
	 *
	 * @param array $TorrentIDs An array of torrents IDs to iterate over
	 * @param int $FreeNeutral 0 = normal, 1 = fl, 2 = nl
	 * @param int $FreeLeechType 0 = Unknown, 1 = Staff picks, 2 = Perma-FL (Toolbox, etc.), 3 = Vanity House
	 */
	public static function freeleech_torrents($TorrentIDs, $FreeNeutral = 1, $FreeLeechType = 0) {
		global $DB, $Cache, $LoggedUser;

		if (!is_array($TorrentIDs)) {
			$TorrentIDs = array($TorrentIDs);
		}

		$DB->query("UPDATE torrents SET FreeTorrent = '".$FreeNeutral."', FreeLeechType = '".$FreeLeechType
				."' WHERE ID IN (".implode(", ", $TorrentIDs).")");

		$DB->query("SELECT ID, GroupID, info_hash FROM torrents WHERE ID IN (".implode(", ", $TorrentIDs).") ORDER BY GroupID ASC");
		$Torrents = $DB->to_array(false, MYSQLI_NUM, false);
		$GroupIDs = $DB->collect('GroupID');

		foreach ($Torrents as $Torrent) {
			list($TorrentID, $GroupID, $InfoHash) = $Torrent;
			Tracker::update_tracker('update_torrent', array('info_hash' => rawurlencode($InfoHash), 'freetorrent' => $FreeNeutral));
			$Cache->delete_value('torrent_download_'.$TorrentID);
			Misc::write_log($LoggedUser['Username']." marked torrent ".$TorrentID." freeleech type ".$FreeLeechType."!");
			Torrents::write_group_log($GroupID, $TorrentID, $LoggedUser['ID'], "marked as freeleech type ".$FreeLeechType."!", 0);
		}

		foreach ($GroupIDs as $GroupID) {
			Torrents::update_hash($GroupID);
		}
	}


	/**
	 * Convenience function to allow for passing groups to Torrents::freeleech_torrents()
	 *
	 * @param array $GroupIDs the groups in question
	 * @param int $FreeNeutral see Torrents::freeleech_torrents()
	 * @param int $FreeLeechType see Torrents::freeleech_torrents()
	 */
	public static function freeleech_groups($GroupIDs, $FreeNeutral = 1, $FreeLeechType = 0) {
		global $DB;

		if (!is_array($GroupIDs)) {
			$GroupIDs = array($GroupIDs);
		}

		$DB->query("SELECT ID from torrents WHERE GroupID IN (".implode(", ", $GroupIDs).")");
		if ($DB->record_count()) {
			$TorrentIDs = $DB->collect('ID');
			Torrents::freeleech_torrents($TorrentIDs, $FreeNeutral, $FreeLeechType);
		}
	}


	/**
	 * Check if the logged in user has an active freeleech token
	 *
	 * @param int $TorrentID
	 * @return true if an active token exists
	 */
	public static function has_token($TorrentID) {
		global $DB, $Cache, $LoggedUser;
		if (empty($LoggedUser)) {
			return false;
		}

		static $TokenTorrents;
		$UserID = $LoggedUser['ID'];
		if (!isset($TokenTorrents)) {
			$TokenTorrents = $Cache->get_value('users_tokens_'.$UserID);
			if ($TokenTorrents === false) {
				$DB->query("SELECT TorrentID FROM users_freeleeches WHERE UserID=$UserID AND Expired=0");
				$TokenTorrents = array_fill_keys($DB->collect('TorrentID', false), true);
				$Cache->cache_value('users_tokens_'.$UserID, $TokenTorrents);
			}
		}
		return isset($TokenTorrents[$TorrentID]);
	}


	/**
	 * Check if the logged in user can use a freeleech token on this torrent
	 *
	 * @param int $Torrent
	 * @return boolen True if user is allowed to use a token
	 */
	public static function can_use_token($Torrent) {
		global $LoggedUser;
		if (empty($LoggedUser)) {
			return false;
		}
		return ($LoggedUser['FLTokens'] > 0
			&& $Torrent['Size'] < 1073741824
			&& !$Torrent['PersonalFL']
			&& empty($Torrent['FreeTorrent'])
			&& $LoggedUser['CanLeech'] == '1');
	}


	public static function has_snatched($TorrentID, $AllUsers = false) {
		global $DB, $Cache, $LoggedUser;
		if (!$AllUsers && (empty($LoggedUser) || !$LoggedUser['ShowSnatched'])) {
			return false;
		}

		$UserID = $LoggedUser['ID'];
		$Buckets = 64;
		$LastBucket = $Buckets - 1;
		$BucketID = $TorrentID & $LastBucket;
		static $SnatchedTorrents = array(), $LastUpdate = 0;

		if (empty($SnatchedTorrents)) {
			$SnatchedTorrents = array_fill(0, $Buckets, false);
			$LastUpdate = $Cache->get_value('users_snatched_'.$UserID.'_lastupdate') ?: 0;
		} elseif (isset($SnatchedTorrents[$BucketID][$TorrentID])) {
			return true;
		}

		// Torrent was not found in the previously inspected snatch lists
		$CurSnatchedTorrents =& $SnatchedTorrents[$BucketID];
		if ($CurSnatchedTorrents === false) {
			$CurTime = time();
			// This bucket hasn't been checked before
			$CurSnatchedTorrents = $Cache->get_value('users_snatched_'.$UserID.'_'.$BucketID, true);
			if ($CurSnatchedTorrents === false || $CurTime - $LastUpdate > 1800) {
				$Updated = array();
				if ($CurSnatchedTorrents === false || $LastUpdate == 0) {
					for ($i = 0; $i < $Buckets; $i++) {
						$SnatchedTorrents[$i] = array();
					}
					// Not found in cache. Since we don't have a suitable index, it's faster to update everything
					$DB->query("SELECT fid, tstamp AS TorrentID FROM xbt_snatched WHERE uid='$UserID'");
					while (list($ID) = $DB->next_record(MYSQLI_NUM, false)) {
						$SnatchedTorrents[$ID & $LastBucket][(int)$ID] = true;
					}
					$Updated = array_fill(0, $Buckets, true);
				} elseif (isset($CurSnatchedTorrents[$TorrentID])) {
					// Old cache, but torrent is snatched, so no need to update
					return true;
				} else {
					// Old cache, check if torrent has been snatched recently
					$DB->query("SELECT fid FROM xbt_snatched WHERE uid='$UserID' AND tstamp>=$LastUpdate");
					while (list($ID) = $DB->next_record(MYSQLI_NUM, false)) {
						$CurBucketID = $ID & $LastBucket;
						if ($SnatchedTorrents[$CurBucketID] === false) {
							$SnatchedTorrents[$CurBucketID] = $Cache->get_value('users_snatched_'.$UserID.'_'.$CurBucketID, true);
							if ($SnatchedTorrents[$CurBucketID] === false) {
								$SnatchedTorrents[$CurBucketID] = array();
							}
						}
						$SnatchedTorrents[$CurBucketID][(int)$ID] = true;
						$Updated[$CurBucketID] = true;
					}
				}
				for ($i = 0; $i < $Buckets; $i++) {
					if ($Updated[$i]) {
						$Cache->cache_value('users_snatched_'.$UserID.'_'.$i, $SnatchedTorrents[$i], 0);
					}
				}
				$Cache->cache_value('users_snatched_'.$UserID.'_lastupdate', $CurTime, 0);
				$LastUpdate = $CurTime;
			}
		}
		return isset($CurSnatchedTorrents[$TorrentID]);
	}


	public static function edition_string(array $Torrent, array $Group) {
		if ($Torrent['Remastered'] && $Torrent['RemasterYear'] != 0) {
			$EditionName = $Torrent['RemasterYear'];
			$AddExtra = ' - ';
			if ($Torrent['RemasterRecordLabel']) {
				$EditionName .= $AddExtra . display_str($Torrent['RemasterRecordLabel']);
				$AddExtra = ' / ';
			}
			if ($Torrent['RemasterCatalogueNumber']) {
				$EditionName .= $AddExtra . display_str($Torrent['RemasterCatalogueNumber']);
				$AddExtra = ' / ';
			}
			if ($Torrent['RemasterTitle']) {
				$EditionName .= $AddExtra . display_str($Torrent['RemasterTitle']);
				$AddExtra = ' / ';
			}
			$EditionName .= $AddExtra . display_str($Torrent['Media']);
		} else {
			$AddExtra = " / ";
			if (!$Torrent['Remastered']) {
				$EditionName = "Original Release";
				if ($Group['RecordLabel']) {
					$EditionName .= $AddExtra . $Group['RecordLabel'];
					$AddExtra = ' / ';
				}
				if ($Group['CatalogueNumber']) {
					$EditionName .= $AddExtra . $Group['CatalogueNumber'];
					$AddExtra = ' / ';
				}
			} else {
				$EditionName = "Unknown Release(s)";
			}
			$EditionName .= $AddExtra . display_str($Torrent['Media']);
		}
		return $EditionName;
	}
}
?>