Jump to main content Jump to doc navigation

The Register controller is used for either showing a registration form, or when discuss.sso_mode is enabled (recommended), to redirect the user to the registration resource.

Basic Information

Since Version 1.0
Controller File controllers/web/register.class.php
Controller Class Name DiscussRegisterController
Controller Template pages/register.tpl (only used if sso_mode=0)
Manifest Name register


The Register controller does not have any manifest options.

The usage of the Register controller depends on 2 system settings. If the discuss.register_resource_id is set and discuss.sso_mode is enabled, the Register controller will simply redirect requests to the resource specified by the register_resource_id setting with a &discuss=1 query string.

If either sso_mode is disabled or no register_resource_id is set, the Login controller will use the pages/login.tpl template to display a login form.

Controller Template

There are no specific placeholders to use in this controller template.

    &activationEmailSubject=`Thanks for Registering!`
    &usergroups=`Forum New Member`
<form class="dis-form dis-register" action="[[~[[*id]]]]register" method="post">
    <h2>[[%discuss.register? &namespace=`discuss` &topic=`web`]]</h2>
    <span class="error">[[+error.spam_empty]]</span>
    <input type="hidden" name="spam_empty" value="" />
    <label for="dis-register-username">[[%discuss.username]]:
        <span class="error">[[+error.username]]</span>
    <input type="text" name="username" id="dis-register-username" value="[[+username]]" />
    <label for="dis-register-password">[[%discuss.password]]:
        <span class="error">[[+error.password]]</span>
    <input type="password" name="password" id="dis-register-password" value="[[+password]]" />
    <label for="dis-register-password-confirm">[[%discuss.password_confirm]]:
        <span class="error">[[+error.password_confirm]]</span>
    <input type="password" name="password_confirm" id="dis-register-password-confirm" value="[[+password]]" />
    <label for="dis-register-email">[[%discuss.email]]:
        <span class="error">[[+error.email]]</span>
    <input type="text" name="email" id="dis-register-email" value="[[+email]]" />
    <label for="dis-register-show-email">[[%discuss.show_email]]:
        <span class="error">[[+error.show_email]]</span>
    <input type="checkbox" name="show_email" id="dis-register-show-email" value="1" [[+show_email]] />

    <div style="padding-left: 140px; clear:both;">

    <br class="clearfix" />
    <div class="dis-form-buttons">
    <input type="submit" class="dis-action-btn" name="dis-register-btn" value="[[%discuss.register]]" />

System Events

No custom system events trigger on this controller.

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.



$0 per month—let's make that $500!

Learn more