Jump to >

This documentation covers Review Board 4.0. You can see the latest Review Board documentation or all other versions.

reviewboard.accounts.forms.pages

class AccountPageForm(page, request, user, *args, **kwargs)[source]

Bases: djblets.configforms.forms.ConfigPageForm

Base class for a form on the My Account page.

AccountPageForms belong to AccountPages, and will be displayed on the My Account page for a user.

A simple form presents fields that can be filled out and posted. More advanced forms can supply their own template or even their own JavaScript models and views.

required_features = [][source]

Features required for a form to be displayed.

is_visible()[source]

Return whether or not the form should be rendered.

This is a base implementation that takes into account a set of required features.

Returns
bool: Whether or not the form should be rendered.
declared_fields = {'form_target': <django.forms.fields.CharField object>}[source]
class AccountSettingsForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

Form for the Settings page for an account.

form_id = u'settings'[source]
form_title = u'Settings'[source]
load()[source]

Load data for the form.

save()[source]

Save the form.

class Meta[source]
fieldsets = ((u'General Settings', {u'fields': (u'form_target', u'timezone', u'syntax_highlighting', u'open_an_issue', u'default_use_rich_text')}), (u'Notifications', {u'fields': (u'should_send_email', u'should_send_own_updates', u'enable_desktop_notifications')}))[source]
declared_fields = {'default_use_rich_text': <django.forms.fields.BooleanField object>, 'enable_desktop_notifications': <django.forms.fields.BooleanField object>, 'form_target': <django.forms.fields.CharField object>, 'open_an_issue': <django.forms.fields.BooleanField object>, 'should_send_email': <django.forms.fields.BooleanField object>, 'should_send_own_updates': <django.forms.fields.BooleanField object>, 'syntax_highlighting': <django.forms.fields.BooleanField object>, 'timezone': <djblets.forms.fields.TimeZoneField object>}[source]
class AvatarSettingsForm(*args, **kwargs)[source]

Bases: djblets.avatars.forms.AvatarSettingsForm

A form for configuring the avatar for a user.

This form will only be shown when avatars are enabled for the server.

avatar_service_registry = <SimpleLazyObject: <reviewboard.avatars.registry.AvatarServiceRegistry object>>[source]
is_visible()[source]

Return whether or not to show the avatar settings form.

Returns:Whether or not to show the avatar settings form.
Return type:bool
declared_fields = {'avatar_service_id': <django.forms.fields.ChoiceField object>, 'form_target': <django.forms.fields.CharField object>}[source]
class APITokensForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

Form for showing a user’s API tokens.

form_id = u'api_tokens'[source]
form_title = u'API Tokens'[source]
save_label = None[source]
js_view_class = u'RB.APITokensView'[source]
get_js_view_data()[source]

Get data to pass to the JavaScript view.

declared_fields = {'form_target': <django.forms.fields.CharField object>}[source]
class ChangePasswordForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

Form for changing a user’s password.

form_id = u'change_password'[source]
form_title = u'Change Password'[source]
save_label = u'Change Password'[source]
is_visible()[source]

Return whether or not the “change password” form should be shown.

Returns:Whether or not the form will be rendered.
Return type:bool
clean_old_password()[source]

Validate the ‘old_password’ field.

This checks to make sure the old password is correct when changing the password.

clean_password2()[source]

Validate the ‘password2’ field.

This makes sure that the two password fields match.

save()[source]

Save the form.

declared_fields = {'form_target': <django.forms.fields.CharField object>, 'old_password': <django.forms.fields.CharField object>, 'password1': <django.forms.fields.CharField object>, 'password2': <django.forms.fields.CharField object>}[source]
class ProfileForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

Form for the Profile page for an account.

form_id = u'profile'[source]
form_title = u'Profile'[source]
save_label = u'Save Profile'[source]
load()[source]

Load data for the form.

save()[source]

Save the form.

declared_fields = {'email': <django.forms.fields.EmailField object>, 'first_name': <django.forms.fields.CharField object>, 'form_target': <django.forms.fields.CharField object>, 'last_name': <django.forms.fields.CharField object>, 'profile_private': <django.forms.fields.BooleanField object>}[source]
class GroupsForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

Form for the group membership page.

Unlike most forms, this doesn’t deal with fields or saving to the database. Instead, it sets up the JavaScript View and provides serialized data representing the groups. The View handles group membership through the API.

form_id = u'groups'[source]
form_title = u'Groups'[source]
save_label = None[source]
js_view_class = u'RB.JoinedGroupsView'[source]
get_js_view_data()[source]

Get data to pass to the JavaScript view.

declared_fields = {'form_target': <django.forms.fields.CharField object>}[source]
class OAuthApplicationsForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

The OAuth Application form.

This provides a list of all current OAuth2 applications the user has access to.

form_id = u'oauth'[source]
form_title = u'OAuth Applications'[source]
js_view_class = u'RB.OAuthApplicationsView'[source]
required_features = [<reviewboard.oauth.features.OAuth2ServiceFeature object>][source]
save_label = None[source]
get_js_view_data()[source]

Return the data for the associated Javascript view.

Returns:Data to be passed to the Javascript view.
Return type:dict
static serialize_app(app)[source]

Serialize an application for the JavaScript view.

Parameters:app (reviewboard.oauth.models.Application) – The application to serialize.
Returns:The serialized application.
Return type:dict
declared_fields = {'form_target': <django.forms.fields.CharField object>}[source]
class OAuthTokensForm(page, request, user, *args, **kwargs)[source]

Bases: reviewboard.accounts.forms.pages.AccountPageForm

The OAuth Token form

This provides a list of all current OAuth2 tokens the user has created.

form_id = u'oauth_tokens'[source]
form_title = u'OAuth Tokens'[source]
js_view_class = u'RB.OAuthTokensView'[source]
required_features = [<reviewboard.oauth.features.OAuth2ServiceFeature object>][source]
save_label = None[source]
get_js_view_data()[source]

Return the data for the JavaScript view.

Returns:A dict containing a single key:
'tokens' (list):
A list of serialized information about each token.
Return type:dict
static serialize_token(token)[source]

Serialize a single token for the JavaScript view.

Returns:A dict with the following keys:
'apiURL' (unicode):
The URL to access the token via the API.
'application' (unicode):
The name of the application the token is associated with.
Return type:dict
declared_fields = {'form_target': <django.forms.fields.CharField object>}[source]
class PrivacyForm(*args, **kwargs)[source]

Bases: djblets.privacy.consent.forms.ConsentConfigPageFormMixin, reviewboard.accounts.forms.pages.AccountPageForm

A form for displaying privacy information and gathering consent.

This will display a user’s privacy rights, link to any configured Privacy Policy document, and display a form for gathering consent for features that make use of the user’s personally identifying information.

form_title = u'My Privacy Rights'[source]
template_name = u'accounts/privacy_form.html'[source]
__init__(*args, **kwargs)[source]

Initialize the form.

Parameters:
  • *args (tuple) – Positional arguments to pass to the parent form.
  • **kwargs (dict) – Keyword arguments to pass to the parent form.
load()[source]

Load the form data.

If a ?next query argument is provided, it will be loaded into the initial value for the next_url so that it will persist through page submission.

is_visible()[source]

Return whether or not the form should be rendered.

This will check if there’s any information to display in this form. It’s only displayed if consent requirements are enabled or there’s any privacy information configured in Admin Settings.

Returns
bool: Whether or not the form should be rendered.
get_extra_context()[source]

Return extra context for the template.

Returns:Context used for rendering the form’s template.
Return type:dict
clean_next_url()[source]

Clean the next_url field.

Returns:The URL to redirect to, if any.
Return type:unicode
save()[source]

Save the privacy form.

This may redirect the user to the next URL if it is specified.

Returns:A redirect to the next URL if given and None otherwise.
Return type:django.http.HttpResponseRedirect
declared_fields = {'form_target': <django.forms.fields.CharField object>, 'next_url': <django.forms.fields.CharField object>}[source]