<spanid="evennia-contrib-base-systems-email-login-email-login"></span><h1>evennia.contrib.base_systems.email_login.email_login<aclass="headerlink"href="#module-evennia.contrib.base_systems.email_login.email_login"title="Permalink to this headline">¶</a></h1>
<p>Email-based login system</p>
<p>Evennia contrib - Griatch 2012</p>
<p>This is a variant of the login system that requires an email-address
instead of a username to login.</p>
<p>This used to be the default Evennia login before replacing it with a
more standard username + password system (having to supply an email
for some reason caused a lot of confusion when people wanted to expand
on it. The email is not strictly needed internally, nor is any
confirmation email sent out anyway).</p>
<p>Installation is simple:</p>
<p>To your settings file, add/edit settings as follows:</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.base_systems.email_login.email_login.</code><codeclass="sig-name descname">CmdUnconnectedConnect</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedConnect"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'connect'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['conn', 'con', 'co']</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedConnect.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.func"title="Permalink to this definition">¶</a></dt>
<dd><p>Uses the Django admin api. Note that unlogged-in commands
have a unique position in that their <strong>func()</strong> receives
a session object instead of a <strong>source_object</strong> like all
other types of logged-in commands (this is because
there is no object yet before the account has logged in)</p>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': 'conn con co', 'category': 'general', 'key': 'connect', 'no_prefix': ' conn con co', 'tags': '', 'text': '\n Connect to the game.\n\n Usage (at login screen):\n connect <email><password>\n\n Use the create command to first create an account before logging in.\n '}</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedConnect.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.base_systems.email_login.email_login.</code><codeclass="sig-name descname">CmdUnconnectedCreate</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedCreate"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'create'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['cr', 'cre']</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">parse</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedCreate.parse"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.parse"title="Permalink to this definition">¶</a></dt>
<dd><p>The parser must handle the multiple-word account
name enclosed in quotes:</p>
<blockquote>
<div><p>connect “Long name with many words” <aclass="reference external"href="mailto:my%40myserv.com">my<span>@</span>myserv<span>.</span>com</a> mypassw</p>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedCreate.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedCreate.lock_storage"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.base_systems.email_login.email_login.</code><codeclass="sig-name descname">CmdUnconnectedQuit</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedQuit"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'quit'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['q', 'qu']</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedQuit.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': 'q qu', 'category': 'general', 'key': 'quit', 'no_prefix': ' q qu', 'tags': '', 'text': '\n We maintain a different version of the `quit` command\n here for unconnected accounts for the sake of simplicity. The logged in\n version is a bit more complicated.\n '}</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedQuit.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.base_systems.email_login.email_login.</code><codeclass="sig-name descname">CmdUnconnectedLook</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedLook"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = '__unloggedin_look_command'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['l', 'look']</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedLook.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': 'l look', 'category': 'general', 'key': '__unloggedin_look_command', 'no_prefix': ' l look', 'tags': '', 'text': '\n This is an unconnected version of the `look` command for simplicity.\n\n This is called by the server and kicks everything in gear.\n All it does is display the connect screen.\n '}</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedLook.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.base_systems.email_login.email_login.</code><codeclass="sig-name descname">CmdUnconnectedHelp</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedHelp"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'help'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['h', '?']</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/base_systems/email_login/email_login.html#CmdUnconnectedHelp.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': 'h ?', 'category': 'general', 'key': 'help', 'no_prefix': ' h ?', 'tags': '', 'text': '\n This is an unconnected version of the help command,\n for simplicity. It shows a pane of info.\n '}</em><aclass="headerlink"href="#evennia.contrib.base_systems.email_login.email_login.CmdUnconnectedHelp.search_index_entry"title="Permalink to this definition">¶</a></dt>