Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Fix #33: Document Javascript Fallback.

An earlier commit already removed the misleading 
`{% url gracfully_degrade %}` piece and noted the jQuery
dependency. This commit finishes up the improvements by
documenting how to add graceful degradation to your login
links.
  • Loading branch information...
commit 122dc677c645374fe658aa6de333fa3c47a8b039 1 parent 1ab8c1e
@Osmose authored
View
23 docs/details/customization.rst → docs/details/advanced.rst
@@ -1,7 +1,5 @@
-Customization
-=============
-
-.. _auto-user:
+Advanced Usage
+==============
Automatic Account Creation
--------------------------
@@ -38,6 +36,7 @@ following::
BROWSERID_CREATE_USER = False
+
Custom Verification
-------------------
@@ -74,3 +73,19 @@ similar to the following::
You are of course then free to store the email in the session and
prompt the user to sign up using a chosen identifier as their
username, or whatever else makes sense for your site.
+
+
+Javascript Fallback
+-------------------
+
+It is a good idea to provide an alternative method of authenticating with your
+site for users that do not have JavaScript available. An easy way of doing this
+is to modify the ``href`` of the link that you bind to BrowserID login to point
+to a traditional login and registration page::
+
+ <a id="browserid" href="{% url 'login.view.name' %}">Sign In</a>
+
+If a user has JavaScript enabled, when they click the link the JavaScript will
+take over and show a BrowserID popup. If a user has JavaScript disabled, they
+will be directed to your login view (which should not require JavaScript, of
+course).
View
2  docs/index.rst
@@ -20,6 +20,6 @@ to fork_ and contribute!
:maxdepth: 2
setup
- details/customization
+ details/advanced
details/settings
details/troubleshooting
Please sign in to comment.
Something went wrong with that request. Please try again.