phpDocumentor updates
[squirrelmail.git] / plugins / bug_report / bug_report.php
1 <?php
2
3 /**
4 * bug_report.php
5 *
6 * This generates the bug report data, gives information about where
7 * it will be sent to and what people will do with it, and provides
8 * a button to show the bug report mail message in order to actually
9 * send it.
10 *
11 * This is a standard SquirrelMail 1.2 API for plugins.
12 *
13 * @copyright &copy; 1999-2005 The SquirrelMail Project Team
14 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
15 * @version $Id$
16 * @package plugins
17 * @subpackage bug_report
18 */
19
20 /**
21 * @ignore
22 */
23 define('SM_PATH','../../');
24
25 require_once(SM_PATH . 'include/validate.php');
26
27 /** is bug_report plugin disabled */
28 if (! is_plugin_enabled('bug_report')) {
29 error_box(_("Plugin is disabled."),$color);
30 echo "\n</body></html>\n";
31 exit();
32 }
33
34 // loading form functions
35 include_once(SM_PATH . 'functions/forms.php');
36
37 displayPageHeader($color, 'None');
38
39 include_once(SM_PATH . 'plugins/bug_report/system_specs.php');
40 include_once(SM_PATH . 'plugins/bug_report/functions.php');
41 global $body;
42
43 $body_top = "I subscribe to the squirrelmail-users mailing list.\n" .
44 " [ ] True - No need to CC me when replying\n" .
45 " [ ] False - Please CC me when replying\n" .
46 "\n" .
47 "This bug occurs when I ...\n" .
48 " ... view a particular message\n" .
49 " ... use a specific plugin/function\n" .
50 " ... try to do/view/use ....\n" .
51 "\n\n\n" .
52 "The description of the bug:\n\n\n" .
53 "I can reproduce the bug by:\n\n\n" .
54 "(Optional) I got bored and found the bug occurs in:\n\n\n" .
55 "(Optional) I got really bored and here's a fix:\n\n\n" .
56 "----------------------------------------------\n\n";
57
58 $body = htmlspecialchars($body_top) . $body;
59
60 ?>
61 <br />
62 <table width="95%" align="center" border="0" cellpadding="2" cellspacing="0"><tr>
63 <?php echo html_tag('td','<b>'._("Submit a Bug Report").'</b>','center',$color[0]); ?>
64 </tr></table>
65
66 <?php
67 echo $warning_html;
68
69 echo '<p><a href="show_system_specs.php" target="_blank">';
70 echo _("Show System Specifications");
71 echo "</a></p>\n\n";
72 echo '<p><big>';
73 echo _("Before you send your bug report, please make sure to check this checklist for any common problems.");
74 echo "</big></p>\n";
75
76 echo '<ul>';
77 echo '<li>';
78 printf(_("Make sure that you are running the most recent copy of %s. You are currently using version %s."), '<a href="http://www.squirrelmail.org/" target="_blank">SquirrelMail</a>', $version);
79 echo "</li>\n";
80
81 echo '<li>';
82 printf(_("Check to see if your bug is already listed in the %sBug List%s on SourceForge. If it is, we already know about it and are trying to fix it."), '<a href="http://sourceforge.net/bugs/?group_id=311" target="_blank">', '</a>');
83 echo "</li>\n";
84
85 echo '<li>';
86 echo _("Try to make sure that you can repeat it. If the bug happens sporatically, try to document what you did when it happened. If it always occurs when you view a specific message, keep that message around so maybe we can see it.");
87 echo "</li>\n";
88
89 echo '<li>';
90 printf(_("If there were warnings displayed above, try to resolve them yourself. Read the guides in the %s directory where SquirrelMail was installed."), '<tt>doc/</tt>');
91 echo "</li>\n";
92 echo "</ul>\n";
93
94 echo '<p>';
95 echo _("Pressing the button below will start a mail message to the developers of SquirrelMail that will contain a lot of information about your system, your browser, how SquirrelMail is set up, and your IMAP server. It will also prompt you for information. Just fill out the sections at the top. If you like, you can scroll down in the message to see what else is being sent.");
96 echo "</p>\n";
97
98 echo '<p>';
99 echo _("Please make sure to fill out as much information as you possibly can to give everyone a good chance of finding and removing the bug. Submitting your bug like this will not have it automatically added to the bug list on SourceForge, but someone who gets your message may add it for you.");
100 echo "</p>\n";
101 ?>
102 <form action="../../src/compose.php" method=post>
103 <table align="center" border="0">
104 <tr>
105 <td>
106 <?php echo _("This bug involves"); ?>: <select name="send_to">
107 <option value="squirrelmail-users@lists.sourceforge.net"><?php
108 echo _("the general program"); ?></option>
109 <option value="squirrelmail-plugins@lists.sourceforge.net"><?php
110 echo _("a specific plugin"); ?></option>
111 </select>
112 </td>
113 </tr>
114 <tr>
115 <td align="center">
116 <?php
117 echo addHidden("send_to_cc","");
118 echo addHidden("send_to_bcc","");
119 echo addHidden("subject","Bug Report");
120 echo addHidden("body",$body);
121 echo addSubmit(_("Start Bug Report Form"));
122 ?>
123 </td>
124 </tr>
125 </table>
126 </form>
127 <br />
128 <?php
129 // special forms that allow searching for bugs in mailing list and bugtracker
130 echo html_tag('table',
131 html_tag('tr',
132 html_tag('th', _("Search Mailing List Archives"), 'center', $color[0])
133 ) .
134 html_tag('tr',
135 html_tag('td', add_gmane_form())
136 ) .
137 html_tag('tr',
138 html_tag('td', '&nbsp;<br />')
139 ) .
140 html_tag('tr',
141 html_tag('th', _("Search SourceForge Bugtracker"), 'center', $color[0])
142 ) .
143 html_tag('tr',
144 html_tag('td', add_sf_bug_form())
145 ), 'center', '', 'width="95%"');
146 ?>
147 </body>
148 </html>