qemudb/include/bugs.php

<?php
require_once(BASE."include/util.php");
require_once(BASE."include/application.php");
/******************************************/
/* bug class and related functions */
/******************************************/


/**
 * Bug Link class for handling Bug Links and thumbnails
 */
class Bug {
    var $iLinkId;

    // parameters necessary to create a new Bug with Bug::create()
    var $iVersionId;
    var $iBug_id;

    // values retrieved from bugzilla
    var $sShort_desc;
    var $sBug_status;
    var $sResolution;
    var $iAppId;
    var $sSubmitTime;
    var $iSubmitterId;
    var $bQueued;

    /**    
     * Constructor, fetches the data and bug objects if $ilinkId is given.
     */
    function bug($iLinkId = null)
    {
        // we are working on an existing Bug
        if(is_numeric($iLinkId))
        {
            $sQuery = "SELECT buglinks.*, appVersion.appId AS appId
                       FROM buglinks, appVersion 
                       WHERE buglinks.versionId = appVersion.versionId 
                       AND linkid = '?'";
            if($hResult = query_parameters($sQuery, $iLinkId))
            {
                $oRow = mysql_fetch_object($hResult);
                $this->iLinkId = $iLinkId;
                $this->iAppId = $oRow->appId;
                $this->iBug_id = $oRow->bug_id;
                $this->iVersionId = $oRow->versionId;
                $this->bQueued = ($oRow->queued=="true")?true:false;
                $this->sSubmitTime = $oRow->submitTime;
                $this->iSubmitterId = $oRow->submitterId;
                /* lets fill in some blanks */ 
                if ($this->iBug_id)
                {
                    $sQuery = "SELECT *
                              FROM bugs 
                              WHERE bug_id = ".$this->iBug_id;
                    if($hResult = query_bugzilladb($sQuery))
                    {
                        $oRow = mysql_fetch_object($hResult);
                        $this->sShort_desc = $oRow->short_desc;
                        $this->sBug_status = $oRow->bug_status;
                        $this->sResolution = $oRow->resolution;
                    }
                }
            }
        }
    }
 

    /**
     * Creates a new Bug.
     */
    function create()
    {
        $oVersion = new Version($this->iVersionId);
        // Security, if we are not an administrator or a maintainer, the Bug must be queued.
        if(!($_SESSION['current']->hasPriv("admin") ||
             $_SESSION['current']->isMaintainer($oVersion->iVersionId) ||
             $_SESSION['current']->isSuperMaintainer($oVersion->iAppId)))
        {
            $this->bQueued = true;
        } else
        {
            $this->bQueued = false;
        }
        /* lets check for a valid bug id */

        if(!is_numeric($this->iBug_id))
        {
            addmsg($this->iBug_id." is not a valid bug number.", "red");
            return false;
        }

        /* check that bug # exists in bugzilla*/

        $sQuery = "SELECT *
                   FROM bugs 
                   WHERE bug_id = ".$this->iBug_id;
        if(mysql_num_rows(query_bugzilladb($sQuery, "checking bugzilla")) == 0)
        {
            addmsg("There is no bug in Bugzilla with that bug number.", "red");
            return false;
        }

        /* Check for Duplicates */

        $sQuery = "SELECT *
                   FROM buglinks 
                   WHERE versionId = '?'";
        if($hResult = query_parameters($sQuery, $this->iVersionId))
        {
            while($oRow = mysql_fetch_object($hResult))
            {
                if($oRow->bug_id == $this->iBug_id)
                {
                   addmsg("The Bug link has already been submitted.", "red");
                   return false;
                }
            }
        }

        /* passed the checks so lets insert the puppy! */

        $hResult = query_parameters("INSERT INTO buglinks (versionId, bug_id, ".
                                    "submitTime, submitterId, queued) ".
                                    "VALUES('?', '?', ?, '?', '?')",
                                    $this->iVersionId, $this->iBug_id,
                                    "NOW()",
                                    $_SESSION['current']->iUserId,
                                    $this->bQueued ? "true":"false");
        if($hResult)
        {
            $this->iLinkId = mysql_insert_id();

            $this->SendNotificationMail();

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


    /**    
     * Deletes the Bug from the database. 
     * and request its deletion from the filesystem (including the thumbnail).
     */
    function delete($bSilent=false)
    {
        $sQuery = "DELETE FROM buglinks 
                   WHERE linkId = '?'";
        if($hResult = query_parameters($sQuery, $this->iLinkId))
        {
            if(!$bSilent)
                $this->SendNotificationMail(true);
        }
        if($this->iSubmitterId &&
           ($this->iSubmitterId != $_SESSION['current']->iUserId))
        {
            $this->mailSubmitter(true);
        }

    }


    /**
     * Move Bug out of the queue.
     */
    function unQueue()
    {
        // If we are not in the queue, we can't move the Bug out of the queue.
        if(!$this->bQueued)
            return false;

        if(query_parameters("UPDATE buglinks SET queued = '?' WHERE linkId='?'",
                            "false", $this->iLinkId))
        {
            $this->bQueued = false;
            // we send an e-mail to interested people
            $this->mailSubmitter();
            $this->SendNotificationMail();
            // the Bug has been unqueued
            addmsg("The Bug has been unqueued.", "green");
        }
    }


    function mailSubmitter($bRejected=false)
    {
        global $aClean;
        if(!isset($aClean['sReplyText']))
            $aClean['sReplyText'] = "";
	
        if($this->iSubmitterId)
        {
            $oSubmitter = new User($this->iSubmitterId);
            $sAppName = Application::lookup_name($this->iAppId)." ".Version::lookup_name($this->iVersionId);
            if(!$bRejected)
            {
                $sSubject =  "Submitted Bug Link accepted";
                $sMsg  = "The bug link you submitted between Bug ".$this->iBug_id." and ".  
                        $sAppName." has been accepted.";
            } else
            {
                 $sSubject =  "Submitted Bug Link rejected";
                 $sMsg  = "The bug link you submitted between Bug ".$this->iBug_id." and ".  
                        $sAppName." has been deleted.";
            }
            $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 SendNotificationMail($bDeleted=false)
    {
        $sAppName = version::fullName($this->iVersionId);
        $oVersion = new version($this->iVersionId);
        if(!$bDeleted)
        {
            if(!$this->bQueued)
            {
                $sSubject = "Link between Bug ".$this->iBug_id." and ".$sAppName." added by ".$_SESSION['current']->sRealname;
                $sMsg  = $oVersion->objectMakeUrl()."\n";
                if($this->iSubmitterId)
                {
                    $oSubmitter = new User($this->iSubmitterId);
                    $sMsg .= "This Bug Link has been submitted by ".$oSubmitter->sRealname.".";
                    $sMsg .= "\n";
                }
                addmsg("The Bug Link was successfully added into the database.", "green");
            } else // Bug Link queued.
            {
                $sSubject = "Link between Bug ".$this->iBug_id." and ".$sAppName." submitted by ".$_SESSION['current']->sRealname;
                $sMsg  = $oVersion->objectMakeUrl()."\n";
                $sMsg .= "This Bug Link has been queued.";
                $sMsg .= "\n";
                addmsg("The Bug Link you submitted will be added to the database after being reviewed.", "green");
            }
        } else // Bug Link deleted.
        {
            $sSubject = "Link between Bug ".$this->iBug_id." and ".$sAppName." deleted by ".$_SESSION['current']->sRealname;
            $sMsg  = $oVersion->objectMakeUrl()."\n";
            addmsg("Bug Link deleted.", "green");
        }

        $sEmail = User::get_notify_email_address_list(null, $this->iVersionId);
        if($sEmail)
        {
            mail_appdb($sEmail, $sSubject ,$sMsg);
        }
    }

    /* Get a list of bugs submitted by a given user */
    function listSubmittedBy($iUserId, $bQueued = true)
    {
        $hResult = query_parameters("SELECT appFamily.appName, buglinks.versionId, appVersion.versionName, buglinks.submitTime, buglinks.bug_id FROM buglinks, appFamily, appVersion WHERE appFamily.appId = appVersion.appId AND buglinks.versionId = appVersion.versionId AND buglinks.queued = '?' AND buglinks.submitterId = '?' ORDER BY buglinks.versionId", $bQueued ? "true" : "false", $iUserId);

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

        $sReturn = html_table_begin("width=\"100%\" align=\"center\"");
        $sReturn .= html_tr(array(
            "Version",
            array("Bug #", 'width="50"'),
            array("Status", 'width="80"'),
            array("Resolution", 'width="110"'),
            "Description",
            "Submit time"),
            "color4");

        for($i = 1; $oRow = mysql_fetch_object($hResult); $i++)
        {
            $oBug = new Bug($oRow->bug_id);
            $sReturn .= html_tr(array(
                version::fullNameUrl($oRow->versionId),
                "<a href=\"".BUGZILLA_ROOT."show_bug.cgi?id=".$oRow->bug_id."\">".$oRow->bug_id."</a>",
                $oBug->sBug_status,
                $oBug->sResolution,
                $oBug->sShort_desc,
                print_date(mysqldatetime_to_unixtimestamp($oRow->submitTime))),
                ($i % 2) ? "color0" : "color1");
        }

        $sReturn .= html_table_end();

        return $sReturn;
    }

    function isOpen()
    {
        return ($this->sBug_status != 'RESOLVED' && $this->sBug_status != 'CLOSED');
    }
}


/*
 * Bug Link functions that are not part of the class
 */

function view_version_bugs($iVersionId = null, $aBuglinkIds)
{
    global $aClean;

    $bCanEdit = FALSE;
    $oVersion = new Version($iVersionId);

    // Security, if we are an administrator or a maintainer, we can remove or ok links.
    if(($_SESSION['current']->hasPriv("admin") ||
                 $_SESSION['current']->isMaintainer($oVersion->iVersionId) ||
                 $_SESSION['current']->isSuperMaintainer($oVersion->iAppId)))
    {
        $bCanEdit = TRUE;
    } 
    
    //start format table
    if($_SESSION['current']->isLoggedIn())
    {
        echo "<form method=post action='".$oVersion->objectMakeUrl()."'>\n";
    }
    echo html_frame_start("Known bugs","98%",'',0);
    echo "<table width=\"100%\" border=\"0\" cellpadding=\"3\" cellspacing=\"1\">\n\n";
    echo "<tr class=color4>\n";
    echo "    <td align=center width=\"80\">Bug #</td>\n";
    echo "    <td>Description</td>\n";
    echo "    <td align=center width=\"80\">Status</td>\n";
    echo "    <td align=center width=\"80\">Resolution</td>\n";
    echo "    <td align=center width=\"80\">Other Apps affected</td>\n";

    if($bCanEdit == true)
    {
        echo "    <td align=center width=\"80\">delete</td>\n";
        echo "    <td align=center width=\"80\">checked</td>\n";
    }
    echo "</tr>\n\n";

    $c = 0;
    foreach($aBuglinkIds as $iBuglinkId)
    {
        $oBuglink = new Bug($iBuglinkId);

        if (
                (!isset($aClean['sAllBugs']) && $oBuglink->isOpen() )
                ||
                isset($aClean['sAllBugs'])
            )
        {
            // set row color
            $bgcolor = ($c % 2 == 0) ? "color0" : "color1";

            //display row
            echo "<tr class=$bgcolor>\n";
            echo "<td align=center><a href='".BUGZILLA_ROOT."show_bug.cgi?id=".$oBuglink->iBug_id."'>".$oBuglink->iBug_id."</a></td>\n";
            echo "<td>".$oBuglink->sShort_desc."</td>\n";
            echo "<td align=center>".$oBuglink->sBug_status."</td>","\n";
            echo "<td align=center>".$oBuglink->sResolution."</td>","\n";
            echo "<td align=center><a href='viewbugs.php?bug_id=".$oBuglink->iBug_id."'>View</a></td>\n";
    
            
            if($bCanEdit == true)
            {
                echo "<td align=center>[<a href='".$oVersion->objectMakeUrl()."&sSub=delete&iBuglinkId=".$oBuglink->iLinkId."'>delete</a>]</td>\n";
                if ($oBuglink->bQueued)
                {
                    echo "<td align=center>[<a href='".$oVersion->objectMakeUrl()."&sSub=unqueue&iBuglinkId=".$oBuglink->iLinkId."'>OK</a>]</td>\n";
                } else
                {
                    echo "<td align=center>Yes</td>\n";
                }
                
            }
            echo "</tr>\n\n";
    

            $c++;
        }
    }

    if($_SESSION['current']->isLoggedIn())
    {
        echo '<input type="hidden" name="iVersionId" value="'.$iVersionId.'">',"\n";
        echo '<tr class=color3><td align=center>',"\n";
        $sBuglinkId = isset($aClean['buglinkId']) ? $aClean['buglinkId'] : '';
        echo '<input type="text" name="iBuglinkId" value="'.$sBuglinkId.'" size="8"></td>',"\n";
        echo '<td><input type="submit" name="sSub" value="Submit a new bug link."></td>',"\n";
        echo '<td colspan=6></td></tr></form>',"\n";
    }
    echo '</table>',"\n";

    // show only open link
    if ( isset( $aClean['sAllBugs'] ) )
    {
        $sURL = str_replace( '&sAllBugs', '', $_SERVER['REQUEST_URI'] );
        $sLink = '<a href="' . $sURL . '">Show Open Bugs</a>';
    }
    // show all link
    else
    {
        $sURL = $_SERVER['REQUEST_URI'] . '&sAllBugs';
        $sLink = '<a href="' . $sURL . '">Show All Bugs</a>';
    }
    
    echo '<div style="text-align:right;">' . $sLink .'</div>';
    echo html_frame_end();
}

?>