Enhance the Theme My Login Widget for Members

Modified appearance of the Theme My Login WidgetIf you’re using Theme My Login for adding an enhanced member login process on your site, check out the tutorial below to modify the plugin’s included widget feature. This recipe includes code to enhance the widget’s title and customize the displayed list of user links to match your site’s Members menu.

Adding this helpful widget with quick links to important areas of the membership is the perfect way to improve the members experience on your site.

How it Works

This recipe includes three separate functions that each handle a unique piece of the customization process. The first function modify_tml_widget_title modifies the widget’s title. The recipe replaces the default title “Welcome” to include the user’s display name a link to their Membership Account page (if you are using Paid Memberships Pro) or the user profile.

The second function, hide_tml_widget_user_links, is used to remove all of the default links that Theme My Login adds to the widget. You can read more about this filter at the Theme My Login documentation site. Note that if you’d like to keep the default links, just remove that section of the recipe.

show_member_menu_tml_widget_user_panel is the third and final function in the recipe, which is used to insert the “Members” navigation menu into the widget. You can use similar logic to insert another named menu if you would like to add alternative links. We can help you with inserting a custom menu as part of a Memberlite Support membership—just open a topic on our forums.

The Code Recipe

Adding the recipe to your website

Copy and paste this code recipe into a helper Memberlite Customizations plugin.


Default appearance of the Theme My Login Widget
Modified appearance of the Theme My Login Widget

Create a Plugin for Customizations to Your Memberlite Site

Many of our articles and code recipes include instructions on how to “customize and add this code to a plugin for customizations”. In addition, our support team may provide you with customizations to add to your site via this method.

This tutorial explains how to create and edit a custom plugin for all of your tweaks to the theme.

But can’t I just edit my theme?

We strongly recommend using the customization plugin method for a variety of reasons. To be clear, the file functions.php within Memberlite or your child theme (if applicable) performs like a plugin in that it can execute php code. While adding code to your active theme’s functions.php file is often quicker than building a plugin, the downside is that as we update Memberlite, you’ll lose the custom functionality that was added. Code in a plugin will persist.

In addition, the use of a customizations plugin helps your developers and our support team know exactly WHERE the custom code is located as it relates to your Memberlite setup.

First, figure out how to FTP into your Website

Your web host should have provided you with FTP or SFTP credentials. To properly log in to your web server you will need the:

  • FTP (or SFTP) address
  • Username
  • Password
  • (possibly) a port number and root directory

If you don’t know how to use FTP, this guide on the WordPress Codex provides some background on FTP and options for FTP clients, you can also refer to your web host’s FAQs and guides.

Creating Your Customizations Plugin

  1. Create a folder called memberlite-customizations in the wp-content/plugins folder of your site.
  2. Create a file called memberlite-customizations.php in the folder you just created.
  3. Edit the memberlite-customizations.php file and paste this block of code into the file:

  4. Save the file.
  5. Upload the plugin via FTP to your website.
  6. Activate the plugin via the Plugins page of your WordPress Admin.

Editing Your Customizations Plugin

  1. Connect to your web server via FTP.
  2. Navigate to the /wp-content/plugins/memberlite-customizations/ folder.
  3. Download the latest copy of the memberlite-customizations.php file.
  4. Open the file in your preferred editor.
  5. Add the code for the recipe or code shared via your support forum thread at the bottom of memberlite-customizations.php.
  6. Save the File and upload the folder and file to your website via FTP.

This Makes Me Nervous.

We understand that you may not be completely comfortable working “in the code”. Our support team can put minor code tweaks in place for you if you share FTP information in a private thread.

If you are updating the customizations on your own and an update to the customizations plugin completely breaks your site, don’t fret.

These steps should repair your site:

  1. Connect to your website via FTP and navigate to the wp-content/plugins folder.
  2. Rename the folder memberlite-customizations to anything else (I generally rename it to memberlite-customizations-off.
  3. Now, visit your site. WordPress will automatically deactivate the plugin and, in doing do, your site should be restored.
  4. You can then repair any broken code in the file and rename the folder to the original memberlite-customizations.
  5. Upload the updated file and reactivate the plugin via the ‘Plugins’ dashboard page.

Memberlite Update v4.0

We’re excited to announce a new phase in the Memberlite theme lifecycle plus the release of the Memberlite Elements plugin.

Memberlite v4.0

This update prepares Memberlite further for submission to the WordPress.org theme repository. One requirement for this is that some functionality needed to be moved into plugins. Functionality around banners, sidebars, and widgets have been moved into the Memberlite Elements plugin. After upgrading to Memberlite 4.0, you will need to install the new Memberlite Elements plugin. Use the steps below to upgrade Memberlite and install the new required plugin.

As soon as the theme is accepted into the WordPress.org theme repository, we will push out a minor update to tell the theme to update through WordPress.org going forward.

To find out more about Memberlite 4.0, you can now browse the demo site of the entire Memberlite Theme or read the theme documentation.

Adhering to WordPress theme standards and best practices.

In preparation for the theme’s submission to the WordPress.org Themes Repository we’ve updated the code to fully adhere to WordPress’ standards and guidelines as outlined in the Theme Check plugin. We also purchased a theme review from Justin Tadlock at ThemeReview.co, which prompted additional updates to harden up our code base and make it more reliable and secure for all users.

In Memberlite v3.0 all shortocdes were extracted to a separate plugin: Memberlite Shortcodes. For Memberlite v4.0, some other functionality around banners, sidebars, and widgets have now been moved to a new plugin Memberlite Elements.

Style Updates

Memberlite v4.0 has a few relatively minor, but impactful, style updates.

  • The default font size has been increased for improved readability. This should look fine on most sites, but you may need to tweak some content and styles on your site to get things to fit with the new sizing.
  • We are now including some web safe fonts (Arial, Helvetica, Times, etc.) in addition to the Google Fonts previously available.
  • Font Awesome has been updated to version 5.2, offering new icons and icon styles (regular, solid and brand).
  • Buttons have been given a hover effect to grab the attention of your users.
  • A new [memberlite_accordion] shortcode has been added to Memberlite Shortcodes.
  • Additional theme Hooks and Filters have been added to support individual site customization as well as child theme development.

Already using the Memberlite Theme?

Below are the step-by-step directions for upgrading to the new version and installing the companion Memberlite Shortcodes plugin. Before beginning this process we recommend taking a backup of your WordPress site.

  1. Back up your site files and database [instructions]
  2. Install and activate the Memberlite Elements plugin.
  3. Upgrade your theme via the WordPress Updates admin page, or download the theme and upload it to your /wp-content/themes/ folder.
  4. If you haven’t already, consider installing the Memberlite Shortcodes plugin.
  5. If you are using a caching plugin, delete and rebuild your cache.

Memberlite Support members can get support for this upgrade process via the Members Forum. Just open a topic and we will schedule a time to perform your upgrade.

Memberlite Shortcodes Update v1.1

v1.1 of the Memberlite Shortcodes plugin has just launched. The update adds some new features to included shortcodes, as well as improvements to page speed for loaded plugin assets (CSS, JS).

How to Update

Please update Memberlite Shortcodes from the Dashboard > Updates page of your WordPress admin. You can also get the latest version of Memberlite Shortcodes here.

The full list of updates is below.

  • BUG: Fixed warning and deprecated function for get_the_author_meta().
  • BUG: Now checking that PMPro is active before requiring [memberlite_signup] shortcode.
  • ENHANCEMENT: More attributes for recent posts shortcode to display posts by author or select post type (CPT). [docs]
  • ENHANCEMENT: Added a 'icon_position' attribute to the [memberlite_btn] shortcode. [docs]
  • ENHANCEMENT: Added a 'class' attribute to the [memberlite_btn] shortcode. [docs]
  • ENHANCEMENT: Now only loading CSS/JS resources when needed.

Memberlite Update v3.0.4

Version 3.0.4 of Memberlite theme is out with few security/bug fixes. This update also maintains the theme’s compatibility with v1.9.4 of Paid Memberships Pro – where certain plugin pages were improved for frontend display across devices using a div-based HTML layout in place of tables.

About the Update

Memberlite is still free to download and update, and we still plan to move the plugin into the WordPress.org repository. This update is an interim release to add compatibility with the newest release of Paid Memberships Pro. We will be shortly releasing another larger update to meet additional rules of the theme repository.

In an effort to improve the display and responsive layout of default plugin pages, v1.9.4 of Paid Memberships Pro has migrated to a “table-free” layout for selected frontend pages. Affected pages include those pages using the following shortcodes: [pmpro_checkout], [pmpro_confirmation], and [pmpro_billing]. The CSS in Memberlite v3.0.4 has been updated to support this div-based HTML layout.

How to Update

Please update Memberlite from the Dashboard > Updates page of your WordPress admin. You can also get the latest version of Memberlite here.

The full list of updates is below.

  • SECURITY/BUG FIX/ENHANCEMENT: Added sanitization and escaping to the banner metabox on the edit post page, fixed the cropping settings for the uploaded images, and refactored the code to make it more readable. (Thanks, Massimo Marazzi)
  • ENHANCEMENT: Improved checkout template to work with the div-based layout now used in PMPro 1.9.4+. Read more about this update here.

Memberlite Update v3.0.3

Version 3.0.3 of Memberlite theme is out with a handful of bug fixes and enhancements. We also fixed a bug with our update server that was causing issues with automatic updates. So if you were having trouble updating before, it may work now.

About the Update

Memberlite is still free to download and update, and we still plan to move the plugin into the WordPress.org repository. Many of the bug fixes in this update were part of the theme repository review process, however there is still work to be done before we can do that. The theme repository has strict rules on what kinds of functionality can be included in themes and what kinds of functionality are “plugin territory”.

The custom sidebars and post banner functions of Memberlite need to be moved into their own plugins. The bad news is that this will take some time and force Memberlite users at some point to install and activate those plugins, although we’ll do our best to make installing those plugins as easy as possible. The good news is that users of other themes will be able to take advantage of that functionality.

If you are running an edited version of Memberlite or Memberlite with a child theme, please update the theme from the updates page of your WordPress dashboard. You can also get the latest version of Memberlite here.

The full list of updates is below.

  • SECURITY: Escaping login/logout URLs, account/profile URLs, landing page level URL, home_url.
  • BUG FIX: Fixed float for Full Width and Narrow Width page templates when default pages layout set to left sidebar.
  • BUG/ENHANCEMENT: Wrapping welcome text in header and a few other strings for translation.
  • BUG/ENHANCEMENT: Added comment support to pages.
  • BUG/ENHANCEMENT: Fixed abbr and heading tag use on PMPro checkout page.
  • BUG/ENHANCEMENT: Fixed text link color issue for cancel button.
  • BUG/ENHANCEMENT: Setting the content width on after_setup_theme hook now.
  • BUG/ENHANCEMENT: No longer enqueuing jQuery directly. It is set as a dependency for our JS files.
  • NOTE: Added Copyright section to the readme.
  • NOTE: The get_the_content_before_more and get_the_content_after_more functions are now prefixed, memberlite_get_the_content_before_more() and memberlite_get_the_content_after_more().
  • NOTE/ENHACEMENT: Now only showing the post meta generated by memberlite_get_entry_meta() on the post CPT.
  • NOTE/ENHANCEMENT: Now only showing the footer widgets primary background stripe if there are active widgets in the area.
  • ENHANCEMENT: Added CSS for JetPack contact form submission/results blockquote.
  • ENHANCEMENT: Improved breadcrumbs for custom post type archives and custom taxonomies
  • ENHANCEMENT: Improved page title for custom post type archives and custom taxonomies
  • ENHANCEMENT: Updated bbPress single forum topic title output.

Add a Call to Action or Additional Content Using Page Bottom Banners

Memberlite adds a new “Memberlite Options” metabox to the “Edit Page” screen in your WordPress admin. Here you can add additional content that spans the fluid width of your page.

This post provides a few example ideas for your page’s bottom banner.

Show Recent Posts

Show recently posted articles either overall or for a category that relates to the page. This recipe uses the [memberlite_recent_posts] shortcode

Add a CTA for Visitors to Call or Email You

If you are a consulting team or individual, this sample concept displays a button for visitors to call or email you. It’s a good way to stop page abandonment and give your reader a “next step” after reading your awesome content.

Add a Dynamic List of Related Pages for Continued Reading

Once a visitor has read your page of content, what are they going to read next? This recipe adds a list of subpages using the [memberlite_subpagelist] shortcode

All banners span the entire page width, so if you would like to show content in columns, use the [row] and [col] shortcodes [docs]. The banner automatically uses your site’s “secondary” background color as defined in Appearance > Colors > Secondary [docs].

View Page Bottom Banner Documentation

Need to set the same “Page Bottom Banner” to multiple pages/posts?

If you would like to set a Page Bottom Banner for several pages, or conditionally based on whether the user is logged in or a member of a specific level, use the before_footer hook. Here is an example that uses this hook to set a sitewide membership signup banner.

Memberlite Update v3.0.2

Version 3.0.2 of Memberlite theme is out with handful of bug fixes and enhancements.

We are in the process of having the theme reviewed for the WordPress.org Theme Repository, but in the meantime we are still serving theme updates from our PMPro servers. We also posted about this update at PaidMembershipsPro.com. Future updates will be posted only at Memberlite.com, with maybe a link from the blog at PaidMembershipsPro.com.

If you are NOT running an edited version of Memberlite or using Memberlite with a child theme, please update the theme from the updates page of your WordPress dashboard. You can also get the latest version of Memberlite here.

The full list of updates is below.

  • BUG: Fixed issue with update code when PMPro is not installed.
  • BUG/ENHANCEMENT: Now running “do_shortcode” on the “Banner Right” content.
  • BUG/ENHANCEMENT: CSS tweak for input elements in iOS browsers.
  • ENHANCEMENT: Added Narrow Width page template for an 8 column centered main content layout with no sidebar.

Memberlite: Download the Import File to Setup a Demo Site

An import file containing demo content is now available for sites using the Memberlite Theme. The demo content covers basic theme features as well as the shortcodes available in the Memberlite Shortcodes plugin.

Downloading the Demo Content

The demo content file (.xml) is available on the Memberlite Theme website. We’ll continue to update and enhance the demo file as more features are added to the theme or as requests for a demonstration of specific theme features are made.

How to Set Up Your Demo Site

Demo content can be imported into a new or existing WordPress site. Just follow the steps below, omitting any steps that you already have completed for an existing site.

Be sure to make a backup of your site if you already have settings and content that you might want to revert to. [guide]
  1. Install and Activate Theme

  2. Install and Activate Plugins

  3. Import the Demo Content

  4. Set Up Paid Memberships Pro Levels & Pages

    • The theme demo is designed to reference three basic levels. You can simply name them Bronze, Silver, Gold and set any pricing. [level setup docs]
    • After setting up the levels, under the Memberships > Pages tab, click the link to generate the membership pages. [page setup docs]
  5. Assign the Menu

    • Navigate to Appearance > Menus
    • Assign the imported “Primary Menu” to the “Primary Menu” theme location.
  6. Assign the Static Front Page

    • Navigate to Appearance > Customize > Static Front Page
    • Set “Front Page displays” to “a static page”.
    • Assign “Home” to the “Front page”
    • Assign “Blog” to the “Posts page”

Note that you cannot undo the import. If you are working on an existing site, you may want to take a data backup before beginning the steps above.


Sitewide Membership Signup Banners for Memberlite – Three Sample Concepts

Convert more site visitors into members with these three sample callout banners for Memberlite.

There are many creative ways to display an advertisement for membership throughout your site (once I get started coming up with layout ideas I find it hard to stop). I find that an ad at the bottom of your page is a great place to start—it’s a catch all when the reader has reached the end of your content looking for the next page to view.

memberlite_before_footer_upgrade1Banner Sample 1: Membership Callout for Site Visitors and Members of Level ID 1

This demo is designed for a site with two levels: a free level and a support level for $10. The example checks to see if the page bottom banner has already been set; if it is not set, the visitor sees a callout and link to sign up OR upgrade to level ID 2. You can update the recipe with your own messaging and level IDs.

REQUIRES: Memberlite, Memberlite Shortcodes, Paid Memberships Pro.

This code recipe requires a Memberlite Support Membership.

Register Now

memberlite_before_footer_upgrade2Banner Sample 2: Advertise Membership Signup for a Single Level + Login Link for Existing Members

This demo features a signup link for a single level as well as a link for existing members to login. The logic checks to see if there is a logged in user or if the page bottom banner has already been set; if neither is true, the visitor sees a callout with a link to sign up for level ID 1 or a link to log in. You can update the recipe with your own messaging and level IDs.

REQUIRES: Memberlite, Memberlite Shortcodes, Paid Memberships Pro.

This code recipe requires a Memberlite Support Membership.

Register Now

memberlite_before_footer_upgrade3Sample 3: A Full 3-Column Levels Display for Site Visitors and Existing Level 1 or 2 Members

The final demo shows a full Membership Levels comparison for a site with three levels (or more). We use a model similar to this for our site here at Paid Memberships Pro. There’s a main heading to identify the section, the three levels compared side-by-side, and a link below for existing members to log in.

REQUIRES: Memberlite, Advanced Levels Page Shortcode Add On, Paid Memberships Pro.

This code recipe requires a Memberlite Support Membership.

Register Now

If you’re not using Memberlite, check with your theme author to find a similar hook that you can use to add this banner or try this tutorial to insert ads within post content.