What would you like to know more about?

Show Page Sections

Configuring Login

Quick Start

Getting the Login Widget up and running quickly will allow you to use other Widgets requiring authentication. See the Quick Start Guide to get started.

If the shared script hasn't been added to your website, add it to the appropriate webpage, replacing "example-church.com" with the base URL of your church's website.

<script id="MPWidgets" src="https://example-church.com/widgets/dist/MPWidgets.js"></script>

Create a webpage on your website that will display your Login Widget or identify the page on your website where it will be displayed.

Add the Login Widget to your church website by placing this snippet of code in the body of your chosen webpages. Ideally, the Login Widget will be added to each page that contains another Widget.

<mpp-user-login></mpp-user-login>
Tip: While not mandatory, this snippet would typically be placed inside a <div> element with the class "container".

Widget Configuration

If you choose to use any widgets that require authentication (like My Groups, My Household, My Subscriptions, and so on), you'll need to include the Login widget on the same page. But even if you only use widgets that don't require authentication, the Login Widget is recommended.

The Login widget always presents the option to log out, along with the ability to view and edit the user's information through the My Profile link.

The drop-down list may be extended to include additional navigation items by adding anchor tags inside of the widget tags. These links display as menu items if a user is logged in.
  • You can include multiple anchor tabs inside the widget tags.
  • When you edit the following to include your church's website, this displays an About Us menu item when a user is logged in:<mpp-user-login><a href="https://example-church.com/aboutus">About Us</a></mpp-user-login>

Configure Your Widget

Fill out the Widget Configurator below, copy your generated widget code, and paste it into your website.

Platform Configuration

The Login Widget uses the standard MinistryPlatform login flow to access different applications, so consider the following:
  • Any visitor to your church website can create an account using the login flow. Their account will have no security roles until an administrator assigns them.
  • Any visitor to your church website can reset their password using the login flow. Your password complexity displays when the user is resetting their password.
  • Creating or resetting a password requires the password complexity to be met, as determined on the Domain record.
    Tip: Help your users out by putting your password complexity requirements in your Account Recovery email.
  • All social logins (defined as Identity Providers) configured for use with existing MinistryPlatform applications will be available.

Review your Domain and Accounts settings for text message configuration, user account settings, and user account emails in relation to logging in. For details, see Login, Create Account, & Password Reset.

thumb_upYes thumb_downNo