tgapp-resetpassword 0.2.6

About resetpassword

resetpassword is a Pluggable application for TurboGears2 that permits to change user password or reset it when lost.

Installing

resetpassword can be installed both from pypi or from bitbucket:

pip install tgapp-resetpassword

should just work for most of the users

Plugging resetpassword

In your application config/app_cfg.py import plug:

from tgext.pluggable import plug

Then at the end of the file call plug with resetpassword:

plug(base_config, 'resetpassword')

You will be able to access the plugged application at http://localhost:8080/resetpassword.

If you use tgext.mailer you need to plug it:

plug(base_config, 'tgext.mailer')

Some options are available that can be set on .ini configuration file for your application. At least one option is required to make activation emails work:

• resetpassword.email_sender -> Outgoing mails sender

If you are using tgext.mailer you need to set up some configuration, check here for available options: https://github.com/amol-/tgext.mailer.

If you are not using neither TurboMail or tgext.mailer a few more configuration options must be set to make activation email work:

• resetpassword.smtp_host -> SMTP server to use to send emails

• resetpassword.smtp_port -> SMTP server port

• resetpassword.smtp_login -> Login for authentication on SMTP server

• resetpassword.smtp_passwd -> Password for authentication on SMTP server

Plugin Options

When plugging tgapp-resetpassword the following options can be passed to the plug call:

• reset_password_form -> Full python path of the form class to use for Reset Password form. By default resetpassword.lib.forms.ResetPasswordForm is used.

• new_password_form -> Full python path of the form class to use for New Password form. By default registration.lib.forms.NewPasswordForm is used.

So the plug call might look like:

plug(
    base_config,
    'resetpassword',
    reset_password_form='myproject.lib.resetpassword_forms.ResetPasswordForm',
    new_password_form='myproject.lib.resetpassword_forms.NewPasswordForm',
)

Available Hooks

resetpassword makes available a some hooks which will be called during some actions to alter the default behavior of the appplications:

• resetpassword.on_begin_reset_request(data)

• resetpassword.on_request(user, email_data, reset_link)

• resetpassword.before_render_change_password_template(user, deserialized_data)

• resetpassword.before_redirect(redirect_url)

Exposed Templates

The templates used by resetpassword and that can be replaced with tgext.pluggable.replace_template are:

• resetpassword.templates.index -> Page with password reset request form

• resetpassword.templates.change_password -> Page with change password request

Example usage (after the plug call):

from tgext.pluggable import replace_template
replace_template(base_config, 'resetpassword.templates.index', 'myproject.templates.reset_password')
replace_template(base_config, 'resetpassword.templates.change_password', 'myproject.templates.change_password')