<?php
/***************************************************/
/* this class represents a category + its children */
/***************************************************/

class Category {
    
    var $name;
    var $id;
    var $subcat;


    /**
     * the special name "ROOT" is the top category
     */
    function Category($id = 0)
    {
        $this->load($id);
    }

    
    /**
     * load the category data into this class 
     */
    function load($id)
    {
        $this->id = $id;

        if($id == 0)
        {
            $this->name = "ROOT";
        } else
        {
            $result = mysql_query("SELECT * FROM appCategory WHERE catId = $id");
            if(!$result)
            {
                // category not found! 
                errorpage("Internal Error: Category not found!");
                return;
            }

            $ob = mysql_fetch_object($result);
            $this->name = $ob->catName;
        }

        $result = mysql_query("SELECT catId, catName, catDescription FROM ".
                              "appCategory WHERE catParent = $this->id " .
                              "ORDER BY catName");
        if(mysql_num_rows($result) == 0)
            return; // no sub categories

        $this->subcat = array();
        while($row = mysql_fetch_object($result))
        {
            // ignore NONAME categories
            if($row->catName == "NONAME")
                continue;
            $this->subcat[$row->catId] = array($row->catName, $row->catDescription);
        }
    }


    /**
     * resolve the category id by name
     */
    function getCategoryId($name)
    {
        if($name == "ROOT")
            return 0;

        $result = mysql_query("SELECT catId FROM appCategory WHERE ".
                              "catName = '$name'");
        if(!$result)
            return -1;
        if(mysql_num_rows($result) != 1)
             return -1;
        $row = mysql_fetch_object($result);
        return $row->catId;
    }


    /**
     * returns the list of sub categories
     *
     * category list has the following format:
     *
     *     {  { catId => { catName, catDescription } }, ...  }
     */
    function getCategoryList()
    {
        return $this->subcat;
    }

    /**
     * returns a path like:
     *
     *     { ROOT, Games, Simulation }
     */
    function getCategoryPath()
    {
        $path = array();
        $id   = $this->id;
        while(1)
        {
            $result = mysql_query("SELECT catName, catId, catParent FROM appCategory WHERE catId = $id");
            if(!$result || mysql_num_rows($result) != 1)
                break;
            $cat = mysql_fetch_object($result);
            $path[] = array($cat->catId, $cat->catName);
            $id = $cat->catParent;
        }
        $path[] = array(0, "ROOT");
        return array_reverse($path);
    }

    
    /**
     * returns a list of applications in the specified category
     */
    function getAppList($id)
    {
        $result = mysql_query("SELECT appId, appName, description FROM ".
                              "appFamily WHERE catId = $id ".
                              "ORDER BY appName");
        if(!$result || mysql_num_rows($result) == 0)
            return array();

        $list = array();
        while($row = mysql_fetch_object($result))
        {
            if($row->appName == "NONAME")
                continue;
            $list[$row->appId] = array($row->appName, $row->description);
        }
        return $list;
    }


    /**
     * returns the number of apps in the specified category
     */
    function getAppCount($id, $recurse = 1)
    {
        $total = 0;

        $result = mysql_query("SELECT appId FROM appFamily WHERE catId = $id");
        if($result)
            $total += mysql_num_rows($result);

        if($recurse)
        {
            $result = mysql_query("SELECT catId FROM appCategory WHERE catParent = $id");
            if($result)
            {
                 while($ob = mysql_fetch_object($result))
                     $total += $this->getAppCount($ob->catId, 1);
            }
        }
        return $total;
    }
};


function appIdToName($appId)
{
    $result = mysql_query("SELECT appName FROM appFamily WHERE appId = $appId");
    if(!$result || !mysql_num_rows($result))
        return "<unknown>";  // shouldn't normally happen
    $ob = mysql_fetch_object($result);
    return $ob->appName;
}

function versionIdToName($versionId)
{
    $result = mysql_query("SELECT versionName FROM appVersion WHERE versionId = $versionId");
    if(!$result || !mysql_num_rows($result))
        return "<unknown>";  // shouldn't normally happen
    $ob = mysql_fetch_object($result);
    return $ob->versionName;
}

/**
 * create the Category: line at the top of appdb pages$
 */
function make_cat_path($path)
{
    $str = "";
    $catCount = 0;
    while(list($idx, list($id, $name)) = each($path))
    {
        if($name == "ROOT")
            $catname = "Main";
        else
            $catname = $name;

        if ($catCount > 0) $str .= " &gt; ";
        $str .= html_ahref($catname,"appbrowse.php?catId=$id");
        $catCount++;
    }

    if($_REQUEST['appId'])
        $str .= " &gt; ".html_ahref(appIdToName($_REQUEST['appId']),"appview.php?appId=".$_REQUEST['appId']);

    if($_REQUEST['versionId'])
        $str .= " &gt; ".html_ahref(versionIdToName($_REQUEST['versionId']),"appview.php?appId=".$_REQUEST['appId']."&versionId=".$_REQUEST['versionId']);

    return $str;
}

?>