<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>2.8. User Preferences — Bugzilla 5.0.4 documentation</title>
<link rel="stylesheet" href="../_static/bugzilla.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '5.0.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="2.9. Installed Extensions" href="extensions.html" />
<link rel="prev" title="2.7. Pro Tips" href="tips.html" />
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="extensions.html" title="2.9. Installed Extensions"
accesskey="N">next</a></li>
<li class="right" >
<a href="tips.html" title="2.7. Pro Tips"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">2. User Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="user-preferences">
<span id="id1"></span><h1>2.8. User Preferences<a class="headerlink" href="#user-preferences" title="Permalink to this headline">¶</a></h1>
<p>Once logged in, you can customize various aspects of
Bugzilla via the "Preferences" link in the page footer.
The preferences are split into a number of tabs, detailed in the sections
below.</p>
<div class="section" id="general-preferences">
<span id="generalpreferences"></span><h2>2.8.1. General Preferences<a class="headerlink" href="#general-preferences" title="Permalink to this headline">¶</a></h2>
<p>This tab allows you to change several default settings of Bugzilla.
Administrators have the power to remove preferences from this list, so you
may not see all the preferences available.</p>
<p>Each preference should be self-explanatory.</p>
</div>
<div class="section" id="email-preferences">
<span id="emailpreferences"></span><h2>2.8.2. Email Preferences<a class="headerlink" href="#email-preferences" title="Permalink to this headline">¶</a></h2>
<p>This tab allows you to enable or disable email notification on
specific events.</p>
<p>In general, users have almost complete control over how much (or
how little) email Bugzilla sends them. If you want to receive the
maximum amount of email possible, click the <code class="docutils literal"><span class="pre">Enable</span> <span class="pre">All</span>
<span class="pre">Mail</span></code> button. If you don't want to receive any email from
Bugzilla at all, click the <code class="docutils literal"><span class="pre">Disable</span> <span class="pre">All</span> <span class="pre">Mail</span></code> button.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">A Bugzilla administrator can stop a user from receiving
bugmail by clicking the <code class="docutils literal"><span class="pre">Bugmail</span> <span class="pre">Disabled</span></code> checkbox
when editing the user account. This is a drastic step
best taken only for disabled accounts, as it overrides
the user's individual mail preferences.</p>
</div>
<p>There are two global options -- <code class="docutils literal"><span class="pre">Email</span> <span class="pre">me</span> <span class="pre">when</span> <span class="pre">someone</span>
<span class="pre">asks</span> <span class="pre">me</span> <span class="pre">to</span> <span class="pre">set</span> <span class="pre">a</span> <span class="pre">flag</span></code> and <code class="docutils literal"><span class="pre">Email</span> <span class="pre">me</span> <span class="pre">when</span> <span class="pre">someone</span>
<span class="pre">sets</span> <span class="pre">a</span> <span class="pre">flag</span> <span class="pre">I</span> <span class="pre">asked</span> <span class="pre">for</span></code>. These define how you want to
receive bugmail with regards to flags. Their use is quite
straightforward: enable the checkboxes if you want Bugzilla to
send you mail under either of the above conditions.</p>
<p>If you'd like to set your bugmail to something besides
'Completely ON' and 'Completely OFF', the
<code class="docutils literal"><span class="pre">Field/recipient</span> <span class="pre">specific</span> <span class="pre">options</span></code> table
allows you to do just that. The rows of the table
define events that can happen to a bug -- things like
attachments being added, new comments being made, the
priority changing, etc. The columns in the table define
your relationship with the bug - reporter, assignee, QA contact (if enabled)
or CC list member.</p>
<p>To fine-tune your bugmail, decide the events for which you want
to receive bugmail; then decide if you want to receive it all
the time (enable the checkbox for every column) or only when
you have a certain relationship with a bug (enable the checkbox
only for those columns). For example, if you didn't want to
receive mail when someone added themselves to the CC list, you
could uncheck all the boxes in the <code class="docutils literal"><span class="pre">CC</span> <span class="pre">Field</span> <span class="pre">Changes</span></code>
line. As another example, if you never wanted to receive email
on bugs you reported unless the bug was resolved, you would
uncheck all boxes in the <code class="docutils literal"><span class="pre">Reporter</span></code> column
except for the one on the <code class="docutils literal"><span class="pre">The</span> <span class="pre">bug</span> <span class="pre">is</span> <span class="pre">resolved</span> <span class="pre">or</span>
<span class="pre">verified</span></code> row.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Bugzilla adds the <code class="docutils literal"><span class="pre">X-Bugzilla-Reason</span></code> header to
all bugmail it sends, describing the recipient's relationship
(AssignedTo, Reporter, QAContact, CC, or Voter) to the bug.
This header can be used to do further client-side filtering.</p>
</div>
<p>Bugzilla has a feature called <code class="docutils literal"><span class="pre">User</span> <span class="pre">Watching</span></code>.
When you enter one or more comma-delineated user accounts (usually email
addresses) into the text entry box, you will receive a copy of all the
bugmail those users are sent (security settings permitting).
This powerful functionality enables seamless transitions as developers
change projects or users go on holiday.</p>
<p>Each user listed in the <code class="docutils literal"><span class="pre">Users</span> <span class="pre">watching</span> <span class="pre">you</span></code> field
has you listed in their <code class="docutils literal"><span class="pre">Users</span> <span class="pre">to</span> <span class="pre">watch</span></code> list
and can get bugmail according to your relationship to the bug and
their <code class="docutils literal"><span class="pre">Field/recipient</span> <span class="pre">specific</span> <span class="pre">options</span></code> setting.</p>
<p>Lastly, you can define a list of bugs on which you no longer wish to receive
any email, ever. (You can also add bugs to this list individually by checking
the "Ignore Bug Mail" checkbox on the bug page for that bug.) This is useful
for ignoring bugs where you are the reporter, as that's a role it's not
possible to stop having.</p>
</div>
<div class="section" id="saved-searches">
<span id="id2"></span><h2>2.8.3. Saved Searches<a class="headerlink" href="#saved-searches" title="Permalink to this headline">¶</a></h2>
<p>On this tab you can view and run any Saved Searches that you have
created, and any Saved Searches that other members of the group
defined in the <span class="param">querysharegroup</span> parameter have shared.
Saved Searches can be added to the page footer from this screen.
If somebody is sharing a Search with a group they are allowed to
<a class="reference internal" href="../administering/groups.html#groups"><span class="std std-ref">assign users to</span></a>, the sharer may opt to have
the Search show up in the footer of the group's direct members by default.</p>
</div>
<div class="section" id="account-information">
<span id="id3"></span><h2>2.8.4. Account Information<a class="headerlink" href="#account-information" title="Permalink to this headline">¶</a></h2>
<p>On this tab, you can change your basic account information,
including your password, email address and real name. For security
reasons, in order to change anything on this page you must type your
<em>current</em> password into the <code class="docutils literal"><span class="pre">Password</span></code>
field at the top of the page.
If you attempt to change your email address, a confirmation
email is sent to both the old and new addresses with a link to use to
confirm the change. This helps to prevent account hijacking.</p>
</div>
<div class="section" id="api-keys">
<span id="id4"></span><h2>2.8.5. API Keys<a class="headerlink" href="#api-keys" title="Permalink to this headline">¶</a></h2>
<p>API keys allow you to give a "token" to some external software so it can log
in to the WebService API as you without knowing your password. You can then
revoke that token if you stop using the web service, and you don't need to
change your password everywhere.</p>
<p>You can create more than one API key if required. Each API key has an optional
description which can help you record what it is used for.</p>
<p>On this page, you can unrevoke, revoke and change the description of existing
API keys for your login. A revoked key means that it cannot be used. The
description is optional and purely for your information.</p>
<p>You can also create a new API key by selecting the checkbox under the 'New
API key' section of the page.</p>
</div>
<div class="section" id="permissions">
<span id="id5"></span><h2>2.8.6. Permissions<a class="headerlink" href="#permissions" title="Permalink to this headline">¶</a></h2>
<p>This is a purely informative page which outlines your current
permissions on this installation of Bugzilla.</p>
<p>A complete list of permissions in a default install of Bugzilla is below.
Your administrator may have defined other permissions. Only users with
<em>editusers</em> privileges can change the permissions of other users.</p>
<dl class="docutils">
<dt>admin</dt>
<dd>Indicates user is an Administrator.</dd>
<dt>bz_canusewhineatothers</dt>
<dd>Indicates user can configure whine reports for other users.</dd>
<dt>bz_canusewhines</dt>
<dd>Indicates user can configure whine reports for self.</dd>
<dt>bz_quip_moderators</dt>
<dd>Indicates user can moderate quips.</dd>
<dt>bz_sudoers</dt>
<dd>Indicates user can perform actions as other users.</dd>
<dt>bz_sudo_protect</dt>
<dd>Indicates user cannot be impersonated by other users.</dd>
<dt>canconfirm</dt>
<dd>Indicates user can confirm a bug or mark it a duplicate.</dd>
<dt>creategroups</dt>
<dd>Indicates user can create and destroy groups.</dd>
<dt>editbugs</dt>
<dd>Indicates user can edit all bug fields.</dd>
<dt>editclassifications</dt>
<dd>Indicates user can create, destroy and edit classifications.</dd>
<dt>editcomponents</dt>
<dd>Indicates user can create, destroy and edit products, components,
versions, milestones and flag types.</dd>
<dt>editkeywords</dt>
<dd>Indicates user can create, destroy and edit keywords.</dd>
<dt>editusers</dt>
<dd>Indicates user can create, disable and edit users.</dd>
<dt>tweakparams</dt>
<dd>Indicates user can change <a class="reference internal" href="../administering/parameters.html#parameters"><span class="std std-ref">Parameters</span></a>.</dd>
</dl>
<hr class="docutils" />
<p>This documentation undoubtedly has bugs; if you find some, please file
them <a class="reference external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation">here</a>.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/bugzilla.png" alt="Logo"/>
</a></p>
<h3><a href="../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">2.8. User Preferences</a><ul>
<li><a class="reference internal" href="#general-preferences">2.8.1. General Preferences</a></li>
<li><a class="reference internal" href="#email-preferences">2.8.2. Email Preferences</a></li>
<li><a class="reference internal" href="#saved-searches">2.8.3. Saved Searches</a></li>
<li><a class="reference internal" href="#account-information">2.8.4. Account Information</a></li>
<li><a class="reference internal" href="#api-keys">2.8.5. API Keys</a></li>
<li><a class="reference internal" href="#permissions">2.8.6. Permissions</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="tips.html"
title="previous chapter">2.7. Pro Tips</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="extensions.html"
title="next chapter">2.9. Installed Extensions</a></p>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="extensions.html" title="2.9. Installed Extensions"
>next</a></li>
<li class="right" >
<a href="tips.html" title="2.7. Pro Tips"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >2. User Guide</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6.
</div>
</body>
</html>
