Skip to main content

Customize your theme with supporter portal links

This theme upgrade kit outlines how to include links to the supporter portal in various parts of your theme

Updated over 6 months ago

Supporters who register an account have access to a dedicated page in the supporter portal where they can manage their login and security settings. In case you want to place it elsewhere, we’ve added a liquid variable that you can use that will override our automatic injection of this link.

Adding the Login and Security Settings Link

  1. If you want this link to appear on the existing Account Settings page found at /forms/signups/:id/edit, then edit the signups_edit.html file for your custom theme

  2. Add this link to the page where it makes sense for the page layout and style of your theme: <a href="/supporter_portal/security">Login and security settings</a>

    1. If you have translated your website, this is an opportunity to translate the link to the language of your website.

    2. Be sure to add any other attributes needed for your theme for links on this page, e.g. classes, ids, ARIA attributes, or any other needed attributes.

  3. If you want this link to appear on a different page for the authenticated supporter, add the link to the page template of your choice after the conditional check for the authenticated supporter

    1. If you do this, then you must edit signups_edit.html from the first step to add data-skip-injecting-link="true" to any element in the layout. This will prevent our automatic injection of the link onto the page.

Example Implementation

If you have a custom theme based on the Raise stock theme. You will see that we have automatically added the link to the bottom of the settings form:

In this case, it would be better to have the link added to the sidebar navigation. After editing the page template and adding the link, the link is no longer automatically injected and it now appears in the location that is preferred for the custom theme based on Raise:

You can also customize it as you want, such as specifying to have the link open in a new tab like in this example.

Suppose you want to include the link to the Login and security page to a basic page content and custom template for it that might be routed to /account. However, you still need to edit the signups_edit.html file to add the data attribute data-skip-injecting-link="true" to any element so that our code knows not to automatically inject a link onto the Account Settings page. For example:

Did this answer your question?