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
  • Loading branch information...
1 parent 1ab8c1e commit 122dc677c645374fe658aa6de333fa3c47a8b039 @Osmose committed Jun 27, 2012
Showing with 20 additions and 5 deletions.
  1. +19 −4 docs/details/{customization.rst → advanced.rst}
  2. +1 −1 docs/index.rst
23 docs/details/customization.rst → docs/details/advanced.rst
@@ -1,7 +1,5 @@
-.. _auto-user:
+Advanced Usage
Automatic Account Creation
@@ -38,6 +36,7 @@ following::
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 '' %}">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
2 docs/index.rst
@@ -20,6 +20,6 @@ to fork_ and contribute!
:maxdepth: 2
- details/customization
+ details/advanced

0 comments on commit 122dc67

Please sign in to comment.