Skip to main content

Pluggable application for TurboGears2 that permits to change user password or reset it when lost, with sqla and ming compatibility

Project description

About resetpassword

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


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/ 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:

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:


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_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')

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tgapp-resetpassword-0.2.3.tar.gz (11.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page