qemudb/include/application.php

<?php
/***********************************************************/
/* this class represents an application incl. all versions */
/***********************************************************/

require_once(BASE."include/version.php");
require_once(BASE."include/vendor.php");
require_once(BASE."include/category.php");
require_once(BASE."include/url.php");
require_once(BASE."include/util.php");
require_once(BASE."include/mail.php");
require_once(BASE."include/maintainer.php");
require_once(BASE."include/tableve.php");

define("PLATINUM_RATING", "Platinum");
define("GOLD_RATING", "Gold");
define("SILVER_RATING", "Silver");
define("BRONZE_RATING", "Bronze");
define("GARBAGE_RATING", "Garbage");

define("MAINTAINER_REQUEST", 1);
define("SUPERMAINTAINER_REQUEST", 2);

/**
 * Application class for handling applications.
 */
class Application {

    var $iAppId;
    var $iVendorId;
    var $iCatId;
    var $sName;
    var $sKeywords;
    var $sDescription;
    var $sWebpage;
    var $sQueued;
    var $sSubmitTime;
    var $iSubmitterId;
    var $aVersionsIds;  // an array that contains the versionId of every version linked to this app.
    var $iMaintainerRequest; /* Temporary variable for tracking maintainer
                                requests on app submission.  Value denotes type of request */

    /**    
     * constructor, fetches the data.
     */
    function Application($iAppId = null, $oRow = null)
    {
        // we are working on an existing application
        if(!$iAppId && !$oRow)
            return;

        if(!$oRow)
        {
            /* fetch this applications information */
            $sQuery = "SELECT *
                    FROM appFamily 
                    WHERE appId = '?'";
            if($hResult = query_parameters($sQuery, $iAppId))
                $oRow = mysql_fetch_object($hResult);
        }

        if($oRow)
        {
            $this->iAppId = $oRow->appId;
            $this->iVendorId = $oRow->vendorId;
            $this->iCatId = $oRow->catId;
            $this->iSubmitterId = $oRow->submitterId;
            $this->sSubmitTime = $oRow->submitTime;
            $this->sName = $oRow->appName;
            $this->sKeywords = $oRow->keywords;
            $this->sDescription = $oRow->description;
            //TODO: we should move the url to the appData table
            // and return an id into the appData table here
            $this->sWebpage = Url::normalize($oRow->webPage);
            $this->sQueued = $oRow->queued;
        }

        /* fetch versions of this application, if there are any */
        $this->aVersionsIds = array();

        /* only admins can view all versions */
        //FIXME: it would be nice to move this permission into the user class as well as keep it generic
        if($_SESSION['current']->hasPriv("admin"))
        {
            $hResult = $this->_internal_retrieve_all_versions();
        } else
        {
            $hResult = $this->_internal_retrieve_unqueued_versions();
        }
        if($hResult)
        {
            while($oRow = mysql_fetch_object($hResult))
            {
                $this->aVersionsIds[] = $oRow->versionId;
            }
        }
    }

    function _internal_retrieve_all_versions()
    {
        $sQuery = "SELECT versionId FROM appVersion WHERE
                        appId = '?'";
        $hResult  = query_parameters($sQuery, $this->iAppId);
        return $hResult;
    }

    function _internal_retrieve_unqueued_versions()
    {
        $sQuery = "SELECT versionId FROM appVersion WHERE
                        queued = 'false' AND
                        appId = '?'";
        $hResult  = query_parameters($sQuery, $this->iAppId);
        return $hResult;
    }

    /**
     * Creates a new application.
     */
    function create()
    {
        if(!$_SESSION['current']->canCreateApplication())
            return;

        $hResult = query_parameters("INSERT INTO appFamily (appName, description, keywords, ".
                                    "webPage, vendorId, catId, submitterId, queued) VALUES (".
                                    "'?', '?', '?', '?', '?', '?', '?', '?')",
                                    $this->sName, $this->sDescription, $this->sKeywords,
                                    $this->sWebpage, $this->iVendorId, $this->iCatId,
                                    $_SESSION['current']->iUserId,
                                    $this->mustBeQueued() ? "true" : "false");
        if($hResult)
        {
            $this->iAppId = mysql_insert_id();
            $this->application($this->iAppId);
            $this->SendNotificationMail();  // Only administrators will be mailed as no supermaintainers exist for this app.

            /* Submit super maintainer request if asked to */
            if($this->iMaintainerRequest == SUPERMAINTAINER_REQUEST)
            {
                $oMaintainer = new Maintainer();
                $oMaintainer->iAppId = $this->iAppId;
                $oMaintainer->iUserId = $_SESSION['current']->iUserId;
                $oMaintainer->sMaintainReason = "This user submitted the application; auto-queued.";
                $oMaintainer->bSuperMaintainer = 1;
                $oMaintainer->create();
            }

            return true;
        } else
        {
            addmsg("Error while creating a new application.", "red");
            return false;
        }
    }


    /**
     * Update application.
     * Returns true on success and false on failure.
     */
    function update($bSilent=false)
    {
        $sWhatChanged = "";

        /* if the user doesn't have permission to modify this application, don't let them */
        if(!$_SESSION['current']->canModifyApplication($this))
            return;

        /* create an instance of ourselves so we can see what has changed */
        $oApp = new Application($this->iAppId);

        if ($this->sName && ($this->sName!=$oApp->sName))
        {
            if (!query_parameters("UPDATE appFamily SET appName = '?' WHERE appId = '?'",
                                  $this->sName, $this->iAppId))
                return false;
            $sWhatChanged .= "Name was changed from ".$oApp->sName." to ".$this->sName.".\n\n";
        }     

        if ($this->sDescription && ($this->sDescription!=$oApp->sDescription))
        {
            if (!query_parameters("UPDATE appFamily SET description = '?' WHERE appId = '?'",
                                  $this->sDescription, $this->iAppId))
                return false;
            $sWhatChanged .= "Description was changed from\n ".$oApp->sDescription."\n to \n".$this->sDescription.".\n\n";
        }

        if ($this->sKeywords && ($this->sKeywords!=$oApp->sKeywords))
        {
            if (!query_parameters("UPDATE appFamily SET keywords = '?' WHERE appId = '?'",
                                  $this->sKeywords, $this->iAppId))
                return false;
            $sWhatChanged .= "Keywords were changed from\n ".$oApp->sKeywords."\n to \n".$this->sKeywords.".\n\n";
        }

        if ($this->sWebpage && ($this->sWebpage!=$oApp->sWebpage))
        {
            if (!query_parameters("UPDATE appFamily SET webPage = '?' WHERE appId = '?'",
                                  $this->sWebpage, $this->iAppId))
                return false;
            $sWhatChanged .= "Web page was changed from ".$oApp->sWebpage." to ".$this->sWebpage.".\n\n";
        }
     
        if ($this->iVendorId && ($this->iVendorId!=$oApp->iVendorId))
        {
            if (!query_parameters("UPDATE appFamily SET vendorId = '?' WHERE appId = '?'",
                                  $this->iVendorId, $this->iAppId))
                return false;
            $oVendorBefore = new Vendor($oApp->iVendorId);
            $oVendorAfter = new Vendor($this->iVendorId);
            $sWhatChanged .= "Vendor was changed from ".$oVendorBefore->sName." to ".$oVendorAfter->sName.".\n\n";
        }

        if ($this->iCatId && ($this->iCatId!=$oApp->iCatId))
        {
            if (!query_parameters("UPDATE appFamily SET catId = '?' WHERE appId = '?'",
                                  $this->iCatId, $this->iAppId))
                return false;
            $oCatBefore = new Category($oApp->iCatId);
            $oCatAfter = new Category($this->iCatId);
            $sWhatChanged .= "Category was changed from ".$oCatBefore->sName." to ".$oCatAfter->sName.".\n\n";
        }
        if($sWhatChanged and !$bSilent)
            $this->SendNotificationMail("edit",$sWhatChanged);
        return true;
    }

    /**    
     * Deletes the application from the database. 
     * and request the deletion of linked elements.
     */
    function delete($bSilent=false)
    {
        $bSuccess = true;

        /* make sure the current user has the appropriate permission to delete
           this application */
        if(!$_SESSION['current']->canDeleteApplication($this))
            return false;

        /* we have to retrieve the versions again here because */
        /* new ones could have been added since this application */
        /* object was created */
        //FIXME: how to deal with concurrency issues such as
        //  if a new version was added during this deletion?
        $hResult = $this->_internal_retrieve_all_versions();
        while($oRow = mysql_fetch_object($hResult))
        {
            $iVersionId = $oRow->versionId;
            $oVersion = new Version($iVersionId);
            if(!$oVersion->delete($bSilent))
                $bSuccess = false; // return false, deleting the version failed
        }

        /* fetch urlsIds */
        $aUrlsIds = array();
        $sQuery = "SELECT id
                       FROM appData
                       WHERE type = 'url'
                       AND appId = '?'";

        if($hResult = query_parameters($sQuery, $this->iAppId))
        {
            while($oRow = mysql_fetch_object($hResult))
            {
                $aUrlsIds[] = $oRow->id;
            }
        }

        foreach($aUrlsIds as $iUrlId)
        {
            $oUrl = new Url($iUrlId);
            $oUrl->delete($bSilent);
        }

        // remove any supermaintainers for this application so we don't orphan them
        $hResult = Maintainer::deleteMaintainersForApplication($this);
        if(!$hResult)
        {
            addmsg("Error removing app maintainers for the deleted application!", "red");
        }

        $sQuery = "DELETE FROM appFamily 
                   WHERE appId = '?' 
                   LIMIT 1";
        if(!($hResult = query_parameters($sQuery, $this->iAppId)))
        {
            addmsg("Error deleting application!", "red");
        }

        if(!$bSilent)
            $this->SendNotificationMail("delete");

        return $bSuccess;
    }


    /**
     * Move application out of the queue.
     */
    function unQueue()
    {
        if(!$_SESSION['current']->canUnQueueApplication())
            return;

        if(query_parameters("UPDATE appFamily SET queued = '?', keywords = '?' WHERE appId = '?'",
                            "false",  str_replace(" *** ","",$this->sKeywords), $this->iAppId))
        {
            $this->sQueued = 'false';
            // we send an e-mail to interested people
            $this->mailSubmitter();
            $this->SendNotificationMail();

            /* Unqueue matching super maintainer request */
            $hResultMaint = query_parameters("SELECT maintainerId FROM appMaintainers WHERE userId = '?' AND appId = '?'", $this->iSubmitterId, $this->iAppId);
            if($hResultMaint && mysql_num_rows($hResultMaint))
            {
                $oMaintainerRow = mysql_fetch_object($hResultMaint);
                $oMaintainer = new Maintainer($oMaintainerRow->maintainerId);
                $oMaintainer->unQueue("OK");
            }
        }
    }

    function Reject()
    {
        if(!$_SESSION['current']->canRejectApplication($this))
            return;

        // If we are not in the queue, we can't move the application out of the queue.
        if(!$this->sQueued == 'true')
            return false;

        if(query_parameters("UPDATE appFamily SET queued = '?' WHERE appId = '?'",
                            "rejected", $this->iAppId))
        {
            $this->sQueued = 'rejected';
            // we send an e-mail to interested people
            $this->mailSubmitter("reject");
            $this->SendNotificationMail("reject");

            // the application has been rejected
            addmsg("The application has been rejected.", "green");
        }
    }

    function objectGetItemsPerPage($bQueued = false)
    {
        $aItemsPerPage = array(25, 50, 100, 200);
        $iDefaultPerPage = 25;
        return array($aItemsPerPage, $iDefaultPerPage);
    }

    function ReQueue()
    {
        if(!$_SESSION['current']->canRequeueApplication($this))
            return false;

        if(query_parameters("UPDATE appFamily SET queued = '?' WHERE appId = '?'",
                            "true", $this->iAppId))
        {
            $this->sQueued = 'true';
            // we send an e-mail to interested people
            $this->SendNotificationMail();

            // the application has been re-queued
            addmsg("The application has been re-queued.", "green");
        }
    }

    function mailSubmitter($sAction="add")
    {
        global $aClean;
        if(!isset($aClean['sReplyText']))
            $aClean['sReplyText'] = "";

        if($this->iSubmitterId)
        {
            $oSubmitter = new User($this->iSubmitterId);
            switch($sAction)
            {
            case "add":
                $sSubject =  "Submitted application accepted";
                $sMsg  = "The application you submitted (".$this->sName.") has been accepted by ".$_SESSION['current']->sRealname.".\n";
                $sMsg .= "Administrator's Response:\n";
            break;
            case "reject":
                $sSubject =  "Submitted application rejected";
                $sMsg  = "The application you submitted (".$this->sName.") has been rejected by ".$_SESSION['current']->sRealname.".";
                $sMsg .= "Clicking on the link in this email will allow you to modify and resubmit the application. ";
                $sMsg .= "A link to your queue of applications and versions will also show up on the left hand side of the Appdb site once you have logged in. ";
                $sMsg .= APPDB_ROOT."objectManager.php?sClass=application_queue".
                        "&bIsQueue=true&bIsRejected=true&iId=".$this->iAppId."&sTitle=".
                        "Edit+Application\n";
                $sMsg .= "Reason given:\n";
            break;
            case "delete":
                $sSubject =  "Submitted application deleted";
                $sMsg  = "The application you submitted (".$this->sName.") has been deleted by ".$_SESSION['current']->sRealname.".";
                $sMsg .= "Reason given:\n";
            break;
            }

            $sMsg .= $aClean['sReplyText']."\n";
            $sMsg .= "We appreciate your help in making the Application Database better for all users.";

            mail_appdb($oSubmitter->sEmail, $sSubject ,$sMsg);
        }
    }


    function countWithRating($sRating)
    {
        $sQuery = "SELECT DISTINCT count(appId) as total 
                       FROM appVersion
                       WHERE maintainer_rating = '?'
                       AND queued='false'";

        if($hResult = query_parameters($sQuery, $sRating))
        {
            $oRow = mysql_fetch_object($hResult);
        }
	     return $oRow->total;
    }

    function getWithRating($sRating, $iOffset, $iItemsPerPage)
    {
        $aApps = array();
        $sQuery = "SELECT DISTINCT appId 
                       FROM appVersion
                       WHERE maintainer_rating = '?'
                       AND queued = 'false'
                       ORDER BY appId ASC LIMIT ?, ?";
        
        if($hResult = query_parameters($sQuery, $sRating, $iOffset, $iItemsPerPage))
        {
            while($aRow = mysql_fetch_row($hResult))
            {
                array_push($aApps, $aRow[0]);
            }
        }
        return $aApps;
    }

    function SendNotificationMail($sAction="add",$sMsg=null)
    {
        global $aClean;
        if(!isset($aClean['sReplyText']))
            $aClean['sReplyText'] = "";

        switch($sAction)
        {
            case "add":
                if($this->sQueued == 'false') // Has been accepted.
                {
                    $sSubject = $this->sName." has been added by ".$_SESSION['current']->sRealname;
                    $sMsg  = $this->objectMakeUrl()."\n";
                    if($this->iSubmitterId)
                    {
                        $oSubmitter = new User($this->iSubmitterId);
                        $sMsg .= "This application has been submitted by ".$oSubmitter->sRealname.".";
                        $sMsg .= "\n";
                    }
                    if($aClean['sReplyText'])
                    {
                        $sMsg .= "Appdb admin reply text:\n";
                        $sMsg .= $aClean['sReplyText']."\n"; // append the reply text, if there is any 
                    }

                    addmsg("The application was successfully added into the database.", "green");
                } else
                {
                    $sSubject = $this->sName." has been submitted by ".$_SESSION['current']->sRealname;
                    $sMsg .= "This application has been queued.";
                    $sMsg .= "\n";
                    addmsg("The application you submitted will be added to the database after being reviewed.", "green");
                }
            break;
            case "edit":
                $sSubject =  $this->sName." has been modified by ".$_SESSION['current']->sRealname;
                $sMsg  .= $this->objectMakeUrl()."\n";
                addmsg("Application modified.", "green");
            break;
            case "delete":
                $sSubject = $this->sName." has been deleted by ".$_SESSION['current']->sRealname;

                // if sReplyText is set we should report the reason the application was deleted 
                if($aClean['sReplyText'])
                {
                    $sMsg .= "Reason given:\n";
                    $sMsg .= $aClean['sReplyText']."\n"; // append the reply text, if there is any 
                }

                addmsg("Application deleted.", "green");
            break;
            case "reject":
                $sSubject = $this->sName." has been rejected by ".$_SESSION['current']->sRealname;
                $sMsg .= APPDB_ROOT."objectManager.php?sClass=application_queue".
                        "&bIsQueue=true&bIsRejected=true&iId=".$this->iAppId."&sTitle=".
                        "Edit+Application\n";

                // if sReplyText is set we should report the reason the application was rejected 
                if($aClean['sReplyText'])
                {
                    $sMsg .= "Reason given:\n";
                    $sMsg .= $aClean['sReplyText']."\n"; // append the reply text, if there is any 
                }

                addmsg("Application rejected.", "green");
            break;
        }
        $sEmail = User::get_notify_email_address_list($this->iAppId);
        if($sEmail)
            mail_appdb($sEmail, $sSubject ,$sMsg);
    } 


    /* output a html table and this applications values to the fields for editing */
    function outputEditor($sVendorName = "")
    {
        HtmlAreaLoaderScript(array("app_editor"));

        echo '<input type="hidden" name="iAppId" value="'.$this->iAppId.'">';

        /* Used to distinguish between the first step of entering an application
           name and the full editor displayed here */
        echo '<input type="hidden" name="bMainAppForm" value="true" />'."\n";

        echo html_frame_start("Application Form", "90%", "", 0);
        echo "<table class='color0' width='100%' border=0 cellpadding=2 cellspacing=0>\n";
        echo '<tr valign=top><td class="color0"><b>Application name</b></td>',"\n";
        echo '<td><input size="20" type="text" name="sAppName" value="'.$this->sName.'"></td></tr>',"\n";

        // app Category
        $w = new TableVE("view");
        echo '<tr valign=top><td class="color0"><b>Category</b></td><td>',"\n";
        echo $w->make_option_list("iAppCatId", $this->iCatId,"appCategory","catId","catName");
        echo '</td></tr>',"\n";

        // vendor name
        echo '<tr valign=top><td class="color0"><b>Vendor</b></td>',"\n";
        echo '<td>If it is not on the list please add it using the form below</td></tr>',"\n";

        // alt vendor
        $x = new TableVE("view");
        echo '<tr valign=top><td class="color0">&nbsp;</td><td>',"\n";
        echo $x->make_option_list("iAppVendorId",
                                  $this->iVendorId,"vendor","vendorId","vendorName",
                                  array("vendor.queued", "false"));
        echo '</td></tr>',"\n";

        // url
        echo '<tr valign=top><td class="color0"><b>URL</b></td>',"\n";
        echo '<td><input size="20" type=text name="sAppWebpage" value="'.$this->sWebpage.'"></td></tr>',"\n";

        echo '<tr valign=top><td class="color0"><b>Keywords</b></td>',"\n";
        echo '<td><input size="75%" type="text" name="sAppKeywords" value="'.$this->sKeywords.'"></td></tr>',"\n";

        echo '<tr valign=top><td class="color0"><b>Application description</b></td>',"\n";
        echo '<td><p><textarea cols="80" rows="20" id="app_editor" name="shAppDescription">';

        echo $this->sDescription.'</textarea></p></td></tr>',"\n";

        // Allow user to apply as super maintainer if this is a new app
        if(!$this->iAppId)
        {
            $sMaintainerOptions = 
                "<input type=\"radio\" name=\"iMaintainerRequest\" value=\"0\" />".
                "I would not like to become a maintainer<br />\n".
                "<input type=\"radio\" name=\"iMaintainerRequest\" ". 
                "value=\"".MAINTAINER_REQUEST."\" />".
                "I would like to be a maintainer of the new version only<br />\n".
                "<input type=\"radio\" name=\"iMaintainerRequest\" ". 
                "value=\"".SUPERMAINTAINER_REQUEST."\" />".
                "I would like to be a maintainer of the entire application<br />\n";

            $sMaintainerOptionsSelected = str_replace(
                "value=\"$this->iMaintainerRequest\"",
                "value=\"$this->iMaintainerRequest\" checked=\"checked\"",
                $sMaintainerOptions);

            echo html_tr(array(
                array("<b>Maintainer options</b>", "class=\"color0\""),
                $sMaintainerOptionsSelected),
                "", "valign=\"top\"");
        }

        echo "</table>\n";

        echo html_frame_end();
    }

    function CheckOutputEditorInput($aValues)
    {
        $errors = "";

        if (empty($aValues['iAppCatId']))
            $errors .= "<li>Please enter a category for your application.</li>\n";

        if (strlen($aValues['sAppName']) > 200 )
            $errors .= "<li>Your application name is too long.</li>\n";

        if (empty($aValues['sAppName']))
            $errors .= "<li>Please enter an application name.</li>\n";

        // No vendor entered, and nothing in the list is selected
        if (empty($aValues['sVendorName']) && !$aValues['iAppVendorId'])
            $errors .= "<li>Please enter a vendor.</li>\n";

        if (empty($aValues['shAppDescription']))
            $errors .= "<li>Please enter a description of your application.</li>\n";

        return $errors;
    }

    /* retrieves values from $aValues that were output by outputEditor() */
    /* $aValues can be $_REQUEST or any array with the values from outputEditor() */
    function GetOutputEditorValues($aValues)
    {
        $this->iAppId = $aValues['iAppId'];
        $this->sName = $aValues['sAppName'];
        $this->sDescription = $aValues['shAppDescription'];
        $this->iCatId = $aValues['iAppCatId'];
        $this->iVendorId = $aValues['iAppVendorId'];
        $this->sWebpage = $aValues['sAppWebpage'];
        $this->sKeywords = $aValues['sAppKeywords'];
        $this->iMaintainerRequest = $aValues['iMaintainerRequest'];
    }

    /* display this application */
    function display()
    {
        /* is this user supposed to view this version? */
        if(!$_SESSION['current']->canViewApplication($this))
            util_show_error_page_and_exit("Something went wrong with the application or version id");

        // header
        apidb_header("Viewing App - ".$this->sName);

        // cat display
        $oCategory = new Category($this->iCatId);
        $oCategory->display($this->iAppId);

        // set Vendor
        $oVendor = new Vendor($this->iVendorId);

        // set URL
        $appLinkURL = ($this->sWebpage) ? "<a href=\"".$this->sWebpage."\">".substr(stripslashes($this->sWebpage),0,30)."</a>": "&nbsp;";
  
        // start display application
        echo html_frame_start("","98%","",0);
        echo "<tr><td class=color4 valign=top>\n";
        echo "  <table>\n";
        echo "    <tr><td>\n";

        echo '      <table width="250" border="0" cellpadding="3" cellspacing="1">',"\n";
        echo "        <tr class=color0 valign=top><td width=\"100\"><b>Name</b></td><td width='100%'> ".$this->sName." </td>\n";
        echo "        <tr class=\"color1\"><td><b>Vendor</b></td><td> ".
            $oVendor->objectMakeLink()."&nbsp;\n";
        echo "        </td></tr>\n";
    
        // main URL
        echo "        <tr class=\"color0\"><td><b>URL</b></td><td>".$appLinkURL."</td></tr>\n";

        // optional links
        if($sUrls = url::display(NULL, $this->iAppId))
            echo $sUrls;

        // image
        $img = Screenshot::get_random_screenshot_img($this->iAppId, null, false);
        echo "<tr><td align=\"center\" colspan=\"2\">$img</td></tr>\n";

        echo "      </table>\n"; /* close of name/vendor/bugs/url table */

        echo "    </td></tr>\n";
        echo "    <tr><td>\n";

        // Display all supermaintainers maintainers of this application
        echo "      <table class=\"color4\" width=\"250\" border=\"1\">\n";
        echo "        <tr><td align=\"left\"><b>Super maintainers:</b></td></tr>\n";
        $other_maintainers = Maintainer::getSuperMaintainersUserIdsFromAppId($this->iAppId);
        if($other_maintainers)
        {
            echo "        <tr><td align=\"left\"><ul>\n";
            while(list($index, $userIdValue) = each($other_maintainers))
            {
                $oUser = new User($userIdValue);
                echo "        <li>".$oUser->objectMakeLink()."</li>\n";
            }
            echo "</ul></td></tr>\n";
        } else
        {
            echo "        <tr><td align=right>No maintainers.Volunteer today!</td></tr>\n";
        }

        // Display the app maintainer button
        echo '        <tr><td align="center">';
        if($_SESSION['current']->isLoggedIn())
        {
            /* are we already a maintainer? */
            if($_SESSION['current']->isSuperMaintainer($this->iAppId)) /* yep */
            {
                echo '        <form method="post" name="sMessage" action="maintainerdelete.php"><input type=submit value="Remove yourself as a super maintainer" class="button">';
            } else /* nope */
            {
                echo '        <form method="post" name="sMessage" action="maintainersubmit.php"><input type="submit" value="Be a super maintainer of this app" class="button" title="Click here to know more about super maintainers.">';
            }

            echo "        <input type=\"hidden\" name=\"iAppId\" value=\"".$this->iAppId."\">";
            echo "        <input type=\"hidden\" name=\"iSuperMaintainer\" value=\"1\">"; /* set superMaintainer to 1 because we are at the appFamily level */
            echo "        </form>";
            
            if($_SESSION['current']->isSuperMaintainer($this->iAppId) || $_SESSION['current']->hasPriv("admin"))
            {
                echo '        <form method="post" name="sEdit" action="admin/editAppFamily.php"><input type="hidden" name="iAppId" value="'.$this->iAppId.'"><input type="submit" value="Edit Application" class="button"></form>';
            }
            if($_SESSION['current']->isLoggedIn())
            {
                echo '<form method="post" name="sMessage" action="'.
                        'objectManager.php?sClass=version_queue&iAppId='.$this->iAppId
                        .'&sTitle=Submit+New+Version&sAction=add">';
                echo '<input type=submit value="Submit new version" class="button">';
                echo '</form>';
            }
            if($_SESSION['current']->hasPriv("admin"))
            {
                $url = BASE."admin/deleteAny.php?sWhat=appFamily&amp;iAppId=".$this->iAppId."&amp;sConfirmed=yes";
                echo "        <form method=\"post\" name=\"sEdit\" action=\"javascript:deleteURL('Are you sure?', '".$url."')\"><input type=\"submit\" value=\"Delete App\" class=\"button\"></form>";
                echo '        <form method="post" name="sEdit" action="admin/editBundle.php"><input type="hidden" name="iBundleId" value="'.$this->iAppId.'"><input type="submit" value="Edit Bundle" class="button"></form>';
            }
        } else
        {
            echo '<form method="post" action="account.php?sCmd=login"><input type="submit" value="Log in to become a super maintainer" class="button"></form>';
        }
        echo "        </td></tr>\n";
        echo "      </table>\n"; /* close of super maintainers table */
        echo "    </td></tr>\n";
        echo "  </table>\n"; /* close the table that contains the whole left hand side of the upper table */

        // description
        echo "  <td class=color2 valign=top width='100%'>\n";
        echo "<div class='info_container'>\n";
        echo "\t<div class='title_class'>\n";
        echo "\t\tDescription\n";
        echo "\t</div>\n";                      // close the 'title_class' div
        echo "\t<div class='info_contents'>\n";
        echo "\t\t".$this->sDescription."\n";
        echo "\t</div>\n";                      // close the 'info_contents' div
        echo "</div>\n";                        // close the 'info_container' div

        echo html_frame_end("For more details and user comments, view the versions of this application.");

        // display versions
        Version::display_approved($this->aVersionsIds);

        // display bundle
        display_bundle($this->iAppId);
    }

    function lookup_name($appId)
    {
        if(!$appId) return null;
        $result = query_parameters("SELECT appName FROM appFamily WHERE appId = '?'",
                                   $appId);
        if(!$result || mysql_num_rows($result) != 1)
            return null;
        $ob = mysql_fetch_object($result);
        return $ob->appName;
    }

    /* List applications submitted by a given user */
    function listSubmittedBy($iUserId, $bQueued = true)
    {
        $hResult = query_parameters("SELECT appId, appName, vendorId, description,
               submitTime FROM appFamily
                WHERE
                submitterId = '?'
                AND
                queued = '?'
                    ORDER BY appId", $iUserId, $bQueued ? "true" : "false");

        if(!$hResult || !mysql_num_rows($hResult))
            return false;

        $oTable = new Table();
        $oTable->SetWidth("100%");
        $oTable->SetAlign("center");

        $oTableRow = new TableRow();
        $oTableRow->AddTextCell("Application");
        $oTableRow->AddTextCell("Description");
        $oTableRow->AddTextCell("Vendor");
        $oTableRow->AddTextCell("Submission Date");
        $oTableRow->SetClass("color4");
        $oTable->SetHeader($oTableRow);

        for($i = 1; $oRow = mysql_fetch_object($hResult); $i++)
        {
          
            $oVendor = new vendor($oRow->vendorId);
            $oApp = new application($oRow->appId);
            
            $oTableRow = new TableRow();
            $oTableRow->AddTextCell($oApp->objectMakeLink());
            $oTableRow->AddTextCell($oRow->description);
            $oTableRow->AddTextCell($oVendor->objectMakeLink());
            $oTableRow->AddTextCell(print_date(mysqltimestamp_to_unixtimestamp($oRow->submitTime)));
            $oTableRow->SetClass(($i % 2) ? "color0" : "color1");

            $oTable->AddRow($oTableRow);
        }

        return $oTable->GetString();
    }

    function objectMakeUrl()
    {
        $sUrl = APPDB_ROOT."appview.php?iAppId=$this->iAppId";
        return $sUrl;
    }

    function objectMakeLink()
    {
        $sLink = "<a href=\"".$this->objectMakeUrl()."\">".
                 $this->sName."</a>";
        return $sLink;
    }

    function objectGetEntries($bQueued, $bRejected, $iRows = 0, $iStart = 0, $sOrderBy = "appId")
    {
        $sLimit = "";

        /* Should we add a limit clause to the query? */
        if($iRows || $iStart)
        {
            $sLimit = " LIMIT ?,?";

            /* Selecting 0 rows makes no sense, so we assume the user wants to select all of them
               after an offset given by iStart */
            if(!$iRows)
                $iRows = maintainer::objectGetEntriesCount($bQueued, $bRejected);
        }

        $sQuery = "SELECT * FROM appFamily WHERE
                     appFamily.queued = '?'";

        $sQueued = objectManager::getQueueString($bQueued, $bRejected);

        if($bQueued && !application::canEdit())
        {
            /* Without global edit rights a user can only view his rejected apps */
            if(!$bRejected)
                return FALSE;

            $sQuery .= " AND appFamily.submitterId = '?' ORDER BY '?'$sLimit";
            if($sLimit)
            {
                $hResult = query_parameters($sQuery, $sQueued,
                                            $_SESSION['current']->iUserId, $sOrderBy,
                                            $iStart, $iRows);
            } else
            {
                $hResult = query_parameters($sQuery, $sQueued,
                                            $_SESSION['current']->iUserId, $sOrderBy);
            }
        } else
        {
            $sQuery .= " ORDER BY '?'$sLimit";
            if($sLimit)
            {
                $hResult = query_parameters($sQuery, $sQueued, $sOrderBy,
                                            $iStart, $iRows);
            } else
            {
                $hResult = query_parameters($sQuery, $sQueued, $sOrderBy);
            }
        }

        if(!$hResult)
            return FALSE;

        return $hResult;
    }

    function objectGetHeader()
    {
        $aCells = array(
                "Submission Date",
                "Submitter",
                "Vendor",
                "Application");

        return $aCells;
    }

    function objectGetTableRow()
    {
        $oUser = new user($this->iSubmitterId);
        $oVendor = new vendor($this->iVendorId);
        if(!$oVendor->sName)
            $sVendor = get_vendor_from_keywords($this->sKeywords);
        else
            $sVendor = $oVendor->objectMakeLink();

        $oTableRow = new TableRow();
        $oTableRow->AddTextCell(print_date(mysqltimestamp_to_unixtimestamp($this->sSubmitTime)));
        $oTableRow->AddTextCell($oUser->objectMakeLink());
        $oTableRow->AddTextCell($sVendor);
        $oTableRow->AddTextCell($this->sName);

        $oOMTableRow = new OMTableRow($oTableRow);
        return $oOMTableRow;
    }

    function canEdit()
    {
        if($_SESSION['current']->hasPriv("admin"))
            return TRUE;
        
        if(isset($this) && is_object($this) && $this->iAppId)
        {
            if(maintainer::isUserSuperMaintainer($_SESSION['current'],
                $this->iAppId))
                return TRUE;

            if($this->sQueued != "true" && $this->iSubmitterId =
               $_SESSION['current']->iUserId)
                return TRUE;

            return FALSE;
        }
        else
            return FALSE;
    }

    function mustBeQueued()
    {
        if($_SESSION['current']->hasPriv("admin"))
            return FALSE;
        else
            return TRUE;
    }

    function objectDisplayQueueProcessingHelp()
    {
        echo "<p>This is the list of applications waiting for your approval, ".
             "or to be rejected.</p>\n";
        echo "<p>To view a submission, click on its name. ".
             "From that page you can edit, delete or approve it into the AppDB.</p>\n";
    }

    function objectDisplayAddItemHelp()
    {
        /* We don't display the full help on the page where you only input the app name */
        if(!$this->sName)
        {
            echo "<p>First, please enter the name of the application you wish to add. ";
            echo "This will allow you to determine whether there is already ";
            echo "an entry for it in the database.</p>\n";
        } else
        {
            echo "<p>This page is for submitting new applications to be added to the\n";
            echo "database. The application will be reviewed by an AppDB Administrator,\n";
            echo "and you will be notified via e-mail if it is added to the database or rejected.</p>\n";
            echo "<p><h2>Before continuing, please ensure that you have</h2>\n";
            echo "<ul>\n";
            echo " <li>Entered a valid version for this application.  This is the application\n";
            echo "   version, NOT the Wine version (which goes in the test results section of the template)</li>\n";
            echo " <li>Tested this application under Wine.  There are tens of thousands of applications\n";
            echo "   for Windows, we do not need placeholder entries in the database.  Please enter as complete \n";
            echo "   as possible test results in the version template provided below</li>\n";
            echo "</ul></p>";
            echo "<p>Having app descriptions just sponsoring the app\n";
            echo "(yes, some vendors want to use the appdb for this) or saying &#8216;I haven&#8217;t tried this app with Wine&#8217; ";
            echo "will not help Wine development or Wine users. Application descriptions should be exactly that and only that, \n";
            echo "they should not contain any information about how well the app works, just what the app is. The same applies to the \n";
            echo "version information, it should be only information on what is unique or different about that version of the application, \n";
            echo "not how well that version works or how great you think a new feature is.</p>\n";
            echo "<p>When you reach the \"Test Form\" part (What works, What doesn't work, etc) please be detailed \n";
            echo "about how well it worked and if any workarounds were needed but do NOT paste chunks of terminal output.</p>\n";
            echo "<p>Please write information in proper English with correct grammar and punctuation!</p>\n";            
            echo "<b><span style=\"color:red\">Please only submit applications/versions that you have tested.\n";
            echo "Submissions without test information or not using the provided template will be rejected.\n";
            echo "If you are unable to see the in-browser editors below, please try Firefox, Mozilla or Opera browsers.\n</span></b>";
            echo "<p>After your application has been added, you will be able to submit screenshots for it, post";
            echo " messages in its forums or become a maintainer to help others trying to run the application.</p>";
        }
    }

    function objectGetEntriesCount($bQueued, $bRejected)
    {
        $sQueued = objectManager::getQueueString($bQueued, $bRejected);

        if($bQueued && !application::canEdit())
        {
            /* Without edit rights users can only resubmit their rejected entries */
            if(!$bRejected)
                return FALSE;

            $sQuery = "SELECT COUNT(appId) as count FROM appFamily WHERE
                    submitterId = '?'
                    AND
                    queued = '?'";
            $hResult = query_parameters($sQuery, $_SESSION['current']->iUserId,
                                        $sQueued);
        } else
        {
            $sQuery = "SELECT COUNT(appId) as count FROM appFamily WHERE queued = '?'";
            $hResult = query_parameters($sQuery, $sQueued);
        }

        if(!$hResult)
            return FALSE;

        if(!$oRow = mysql_fetch_object($hResult))
            return FALSE;

        return $oRow->count;
    }

    function objectMoveChildren($iNewId)
    {
        /* Keep track of how many children we have moved */
        $iCount = 0;

        foreach($this->aVersionsIds as $iVersionId)
        {
            $oVersion = new version($iVersionId);
            $oVersion->iAppId = $iNewId;
            if($oVersion->update())
                $iCount++;
            else
                return FALSE;
        }

        /* If no errors occured we return the number of moved children */
        return $iCount;
    }

    function allowAnonymousSubmissions()
    {
        return FALSE;
    }

    function objectGetId()
    {
        return $this->iAppId;
    }
}

function get_vendor_from_keywords($sKeywords)
{
    $aKeywords = explode(" *** ",$sKeywords);
    $iLastElt = (sizeOf($aKeywords)-1);
    return($aKeywords[$iLastElt]);
}

?>