This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

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.

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

Release History

This version
History Node

0.2.0

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tgapp-resetpassword-0.2.0.tar.gz (11.5 kB) Copy SHA256 Checksum SHA256 Source Apr 11, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting