cwebber/mediagoblin-rescued-repos: Rescued MediaGoblin repositories from before Gitorious shutdown.

Jessica Tallon d88fcb03e2 Change codebase to query or create correct User model		vor 9 Jahren
..
static	857512e81e need to send the users email to persona if the user logged in with persona.	vor 11 Jahren
templates	85cf52f865 reword persona edit link	vor 11 Jahren
README.rst	94a566e60e typo	vor 11 Jahren
__init__.py	d88fcb03e2 Change codebase to query or create correct User model	vor 9 Jahren
forms.py	f4686cde16 wtforms.fields.TextField was deprecated	vor 10 Jahren
models.py	4f8f0a4e1f merge --squash persona branch to take care of a false merge commit in	vor 11 Jahren
views.py	e49b7e02b2 Use six.text_type instead of unicode().	vor 10 Jahren

		
				README.rst
			
				.. _persona-chapter:

================
 persona plugin
================

The persona plugin allows users to login to you GNU MediaGoblin instance using
`Mozilla Persona`_.

This plugin can be enabled alongside :ref:`openid-chapter` and
:ref:`basic_auth-chapter`.

.. note::
    When :ref:`basic_auth-chapter` is enabled alongside this persona plugin, and
    a user creates an account using their persona. If they would like to add a
    password to their account, they can use the forgot password feature to do
    so.

.. _Mozilla Persona: https://www.mozilla.org/en-US/persona/

Set up the persona plugin
=========================

1. Install the ``requests`` package.

2. Add the following to your MediaGoblin .ini file in the ``[plugins]`` section::

    [[mediagoblin.plugins.persona]]

3. Run::

        gmg dbupdate

   in order to create and apply migrations to any database tables that the
   plugin requires.

4. Run::

        gmg assetlink

   in order to persona's static assets.