Version 2.2.2

upload/sources/api/api_topic_view.php

@@ -2,14 +2,24 @@
 
 /*
 +--------------------------------------------------------------------------
-|   Invision Power Board
+|   Invision Power Board 2.2.2
 |   =============================================
 |   by Matthew Mecham
 |   (c) 2001 - 2006 Invision Power Services, Inc.
 |   http://www.invisionpower.com
 |   =============================================
 |   Web: http://www.invisionboard.com
+|        http://www.ibresource.ru/products/invisionpowerboard/
+|   Time: Monday 05th of March 2007 10:10:54 PM
+|   Release: e3790216629e5a2aaf37070b32237f06
 |   Licence Info: http://www.invisionboard.com/?license
+|                 http://www.ibresource.ru/license
++---------------------------------------------------------------------------
+|   INVISION POWER BOARD IS NOT FREE / OPEN SOURCE!
++---------------------------------------------------------------------------
+|   INVISION POWER BOARD ÍÅ ßÂËßÅÒÑß ÁÅÑÏËÀÒÍÛÌ ÏÐÎÃÐÀÌÌÍÛÌ ÎÁÅÑÏÅ×ÅÍÈÅÌ!
+|   Ïðàâà íà ÏÎ ïðèíàäëåæàò Invision Power Services
+|   Ïðàâà íà ïåðåâîä IBResource (http://www.ibresource.ru)
 +---------------------------------------------------------------------------
 |   > $Date: 2005-10-10 14:08:54 +0100 (Mon, 10 Oct 2005) $
 |   > $Revision: 23 $
@@ -24,24 +34,22 @@
 */
 
 /**
-* API: Forums
+* API: Ôîðóìîâ
 *
-* EXAMPLE USAGE
+* ÏÐÈÌÅÐ ÈÑÏÎËÜÇÎÂÀÍÈß
 * <code>
   $api = new api_topic_view();
   $api->ipsclass =& $this->ipsclass;
   $api->topic_list_config['forums'] = array( 1,2,3,4 );
   $api->topic_list_config['limit'] = 10;
   $topics = $api->return_topic_list_data();
-  // Loop on $topics and output the data
+  // Ïðîéòè ìàññèâ $topics è âûâåñòè äàííûå
 * </code>
 *
-* API will return attachment data in an array
-* attachment_data - you are responsible for any
-* processing or displaying if you wish to do so
+* API âîçâðàùàåò èíôîðìàöèþ î ïðèêðåïëåííûõ ôàéëàõ â ìàññèâå
+* attachment_data
 *
-* Attachment data returned will be in an array with the
-* topic/post data like so:
+* Ñòðóêòóðà ìàññèâà ïðèêðåïëåííûõ ôàéëîâ:
 
             [attachment_data] => Array
                 (
@@ -60,12 +68,14 @@
                         )
 
                 )
-* You can then loop on the attachment_data key (if
-* it exists - it won't exist if there are no attachments)
-* and process each attachment in the record.
+* Ïåðåáèðàÿ êëþ÷è ìàññèâà attachment_data (åñëè îíè 
+* ñóùåñòâóþò - åñëè íåò, òî íåò è ïðèêðåïëåííûõ ôàéëîâ)
+* ìîæíî îáðàáîòàòü êàæäûé ïðèêðåïëåííûé ôàéë.
 *
-* Attachment types - thumb = thumbnail, image = regular image
-*	reg = regular attachment
+* Òèïû ïðèêðåïëåííûõ ôàéëîâ ( çíà÷åíèÿ types): 
+* thumb = ýñêèç, 
+* image = èçîáðàæåíèå,
+* reg   = ôàéë
 *
 * @package		InvisionPowerBoard
 * @subpackage	APIs
@@ -88,9 +98,9 @@ if ( ! class_exists( 'api_core' ) )
 }
 
 /**
-* API: Languages
+* API: Ôîðóìîâ
 *
-* This class deals with all available language functions.
+* Êëàññ ïðåäîñòàâëÿåò âñå ìåòîäû API äëÿ ðàáîòû ñ âûâîäîì òåì.
 *
 * @package		InvisionPowerBoard
 * @subpackage	APIs
@@ -101,34 +111,35 @@ if ( ! class_exists( 'api_core' ) )
 class api_topic_view extends api_core
 {
 	/**
-	* IPS Class Object
+	* Îáúåêò ñóïåð-êëàññà IPS 
 	*
 	* @var object
 	*/
 	//var $ipsclass;
 	
 	/**
-	* Topic list config
+	* Êîíôèãóðàöèÿ âûâîäà ñïèñêà òåì
 	*
 	* @var array
 	*/
-	var $topic_list_config = array( 'offset'      => 0,
-								    'limit'       => 5,
-									'forums'      => 1,
-									'order_field' => 'last_post',
-									'order_by'    => 'DESC' );
+	var $topic_list_config = array( 'offset'      => 0,             // ñ êàêîé òåìû íà÷èíàòü âûâîä
+								    'limit'       => 5,             // êîëè÷åñòâî âûâîäèìûõ òåì
+									'forums'      => 1,             // èç êàêèõ ôîðóìîâ áðàòü òåìû (ìîæåò áûòü ìàññèâîì)
+									'order_field' => 'last_post',   // ïîëå ïî êîòîðîìó ñîðòèðîâàòü òåìû
+									'order_by'    => 'DESC' );      // ïîðÿäîê ñîðòèðîâêè
 									
 	var $attach_pids = array();
 									
 	/*-------------------------------------------------------------------------*/
-	// Returns an array of topic data
+	// Ïîëó÷åíèå ìàññèâà äàííûõ òåì
 	/*-------------------------------------------------------------------------*/
 	/**
-	* Returns an array of topic data
-	* NOTE: Returns ALL topics regardless of permission as
-	* if viewed from the ACP.
+	* Âîçâðàùàåò ìàññèâ ñ äàííûìè âñåõ òåì
+    * 
+	* ÂÍÈÌÀÍÈÅ: ìåòîä âîçâðàùàåò ÂÑÅ òåìû, ïðàâà ïîëüçîâàòåëÿ íå ó÷èòûâàþòñÿ, ò.å.
+    * äîñòóïíû âñå ôîðóìû!
 	*
-	* @return   array	Array of topic data
+	* @return   array	Ìàññèâ ñ äàííûìè òåì
 	*/
 	function return_topic_list_data()
 	{