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

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

		
				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.