regme

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 11 Open GitHub ↗

User registration and management library using MongoEngine

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Registration for MongoEngine
============================

User registration and management library using MongoEngine

Features
--------

* Create inactive user
* Generate activation token
* Try to activate user via activation token
* Set user password
* Check is activation token expired
* Integrate with django.contrib.auth
* Registration form
* Activation form
* Sample/default registration templates

TODO
----

* Django command to prune users that were not activated.

Installation
------------

`pip install regme`

Configuration
-------------

In addition to [MongoEngine Django support settings](http://docs.mongoengine.org/django.html) Regme requires following settings:

# The number of days activation token will be valid
    ACCOUNT_ACTIVATION_DAYS = 7
    
    # Regme custom user document for MongoEngine
    # You should not change it unless you know what are you doing
    MONGOENGINE_USER_DOCUMENT = 'regme.documents.User'
    
    # Include regme into installed apps list 
    INSTALLED_APPS = (
        # …
        'django.contrib.auth',
        # …
        'mongoengine.django.mongo_auth',
        # …
        'regme',
        # …
    )
    
    # Site information (domain and name) for use in activation mail messages
    SITE = {'domain': 'domain.tld', 'name': 'Site Name'}

Usage
-----

### Simple

* Include `regme.urls` into your `urlconf`.
* Use tag `{% url 'register' %}` to point to the regme registration view.
* (Optional) Override default templates placed in `regme/templates` folder.

### Advanced

* Use or subclass `regme.forms.UserCreationForm` and `regme.forms.UserActivationForm` manually.
* Subclass `regme.documents.User` and perform whatever magic you want.

Contribute
----------

Feel free to report any issue or fork this project on [Regme Github page](https://github.com/lig/regme).

Authors
-------

[Serge Matveenko](https://github.com/lig)

License
-------

Apache License. See `LICENSE` file.

regme

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README