• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

RocketGeek

Home of WP-Members, The Original WordPress Membership Plugin

  • WordPress Plugins
    • WP-Members
      • FAQs
      • Quick Start
      • Documentation
      • Extensions
    • Advanced Options
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Download Protect
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Invite Codes
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • MailChimp Integration
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • PayPal Subscriptions
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Salesforce Web-to-Lead
    • Security
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Text Editor
      • Purchase the Plugin
      • Get the Pro Bundle
    • User List
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • User Tracking
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Memberships for WooCommerce
    • WordPass
  • Store
    • Cart
    • Checkout
  • Blog
    • Basics [Free]
    • Tips and Tricks
    • Filters
    • Actions
    • Code Snippets
    • Shortcodes
    • Design
    • Release Announcements
  • Contact
  • Sign In
  • Show Search
Hide Search
Home » Plugins » WP-Members » Documentation » Filter and Action Hooks » wpmem_exp_expired_msg

wpmem_exp_expired_msg

Description

This hook allows you to filter the message that is displayed to a user when they attempt to view content that is restricted to paying subscribers.  There are three possible default messages:

  • This content is for members only.
  • It appears that you have registered, but have not completed payment.  Once your payment is received, you will be able to access all of the premium members-only content on the site.
  • Your account has expired.

Parameters

$str
(string) (required) A string containing the message.

Examples

/**
 * This example changes the default message if the
 * user's account has expired.
 */
add_filter( 'wpmem_exp_expired_msg', 'my_expired_msg' );
function my_expired_msg( $msg ) {
    if ( strpos( $msg, 'Your account has expired.' ) !== false ) {
        $msg = 'Your account has expired. Please renew in
            the user settings area.';
    }

    // return the message, filtered or unfiltered
    return $msg;
}


/**
 * This example creates an entirely new message based on the
 * user's payment status (pending or expired).
 */
add_filter( 'wpmem_exp_expired_msg', 'my_expired_msg2' );
function my_expired_msg2( $msg ) {
    $user_id = get_current_user_id();
    $msg = '<div class="wpmem_msg" align="center">';
    if ( get_user_meta( $user_id, 'exp_type', true ) === 'pending' ) {
        $msg .= '<p><b>This content is for subscribers only.</b><br />';
        $msg .= 'Once the payment process is complete you will have access to premium members only content.';
        $msg .= '</p>';
        $msg.= wpmem_payment_button(); 
    } else {
        $msg .= '<p><b>Your subscription has expired.</b></p>';
        $msg .= '<p>Please <a href="' .   wpmem_profile_url( 'renew' ) . '">renew your subscription now</a>.</p>';
    }
    $msg.= '</div>';
    return $msg;
}

Notes

Once in the object, the settings managed by this filter can be changed directly in the object on the fly, so this filter is not used much anymore.  However, it remains supported in the plugin.

Changelog

  • Introduced in version 0.1.0

Source

wpmem_exp_expired_msg is located in /includes/class-wp-members-expiration-forms.php

  • Getting Started
  • Recommended WordPress® Settings
  • Plugin Settings
    • Options
    • Fields
    • Dialogs
    • Emails
    • New Feature Settings
  • Managing Content
    • Restricting Posts
    • Restricting Pages
    • Show Excerpts
    • Custom Post Types
  • Managing Users
  • Registration
    • Choosing Fields
    • Create a Registration Page
    • Moderating Registration
    • Using CAPTCHA
    • Removing Registration Options
  • User Profile
  • Membership Products
    • Membership Properties
  • Menus
    • Individual Menu Items
    • Logged In Menus
    • Login/Logout Menu Link
  • Customizing Emails
    • Email Address
    • Email Content
    • Email Format
    • Email Shortcodes
    • Email Troubleshooting
  • Customizing Forms
    • Create a Custom Stylesheet
    • Using the WordPress Customizer
    • Login Form HTML
    • Registration Form HTML
    • Widget Login Form HTML
  • Shortcodes
    • Pages and Forms
    • Login Status
    • User Fields
    • Email
    • Other Shortcodes
  • WP-CLI Commands
  • API Functions
  • Filter and Action Hooks
  • WP-Members FAQs
    • How to add a shortcode
    • How to apply login redirects
  • Demo Videos

Ready to get started?

Join Today!

© 2021 · butlerblog.com · RocketGeek is built using WordPress, WP-Members, and the Genesis Framework

  • butlerblog.com
  • WP-Members Support Subscription
  • Terms of Service
  • Refund Policy