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 any page where you want the Login Widget to appear (that's probably most, if not all, pages). Be sure to replace "{your platform domain}" in the following code with your church's base MP URL.

<script id="MPWidgets" src="https://{your platform domain}/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>

Widget Configuration

If you choose to use any Widgets that require authentication (My Groups, My Household, My Subscriptions, etc.), 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 logout along with the ability to view/edit the User's information via the My Profile link.
• The drop-down may be extended to include additional navigation items by adding anchor tags inside of the widget tags. These links will be displayed as menu items if a user is logged in.
  • You can include multiple anchor tabs inside the widget tags.
  • The following will display an About Us menu item when a user is logged in:

<mpp-user-login><a href="https://{your domain}/aboutus">About Us</a></mpp-user-login>

Platform Configuration

The Login Widget uses the standard MinistryPlatform Login flow, so consider:

• Any visitor to your church website can create an account using the Login flow. Their account will have no Security Roles. 
• Any visitor to your church website can reset their password using the Login flow. Your password complexity will display when the user is resetting their password. 
• Creating or resetting a password will be subject to the password complexity determined on the Domain record. Pro tip: Help your users out by putting your password complexity requirements in your Account Recovery email.
• All Social Logins (Identity Providers) configured for use with existing MinistryPlatform applications will be available.

Review your Domain/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.

​Customization

Want to make your Login Widget really stand out by making it a bright color or calling it something different? Great! Widgets are customizable so you can do YOUR church YOUR way!

CSS: Every Widget accepts the Custom CSS attribute. Include it before the opening Widget tag is closed to customize your Widgets.

Application Labels: "Log In" feel too stuffy for your church? Want to say "Hi There!" instead? Go for it! You can change the labels by navigating to System Setup > Application Labels (note that churches are responsible for all translations if the default is not used).

• mpp-user-login.loginButtonLabel - Label to launch the Login flow. Default is "Login." 
• mpp-user-login.logoutButtonLabel - Label for the menu item which will launch the Logout flow. Default is "Log Out."