RocketGeek

Home of WP-Members, The Original WordPress Membership Plugin

Home » Search for "short code"

Search Results for: short code

Request additional data fields on a specific page

· ·

This particular example is a generic tutorial for requesting additional data fields in the registration form on a specific page. Since these are fields that do not show up in the regular registration form, we need to also present the data to logged in users to add this data.

While conceptually this is not an overly complicated process, the practical implementation has quite a few steps, so I will try to explain each step in the process while giving that particular code snippet being discussed at that point.Continue Reading →

wpmem_exp_sc_expmsg

Description

This hook allows you to filter the message that is displayed to a user when they attempt to view content that is restricted by the subscription shortcode:

  • [[wp-members status=sub]This is subscription content[/wp-members]]
  • [wpmem_logged_in status=sub]This is subscription content[/wpmem_logged_in]

Parameters

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

Changelog

Introduced in version 0.1

Source

wpmem_exp_sc_expmsg is located in module.php

wpmem_login_form_args

Description

This filter allows you to pass arguments to the login form function to override default values that are used in the form building process. Note that this function is used to create the login, change password, and reset password forms. The wpmem_login_form() function uses the wp_parse_args() function to merge arguments passed through this filter with the following defaults:

$defaults = array(

    // wrappers
    'heading_before'  => '<legend>',
    'heading_after'   => '</legend>',
    'fieldset_before' => '<fieldset>',
    'fieldset_after'  => '</fieldset>',
    'main_div_before' => '<div id="wpmem_login">',
    'main_div_after'  => '</div>',
    'txt_before'      => '',
    'txt_after'       => '',
    'row_before'      => '',
    'row_after'       => '',
    'buttons_before'  => '<div class="button_div">',
    'buttons_after'   => '</div>',
    'link_before'     => '<div class="link-text">',
    'link_after'      => '</div>',
    'link_span_before' => '<span class="link-text-%s">',
    'link_span_after'  => '</span>',

    // classes & ids
    'form_id'         => 'wpmem_login_form',
    'form_class'      => 'form',
    'button_id'       => '',
    'button_class'    => 'buttons',

    // other
    'strip_breaks'    => true,
    'wrap_inputs'     => true,
    'remember_check'  => true,
    'n'               => "\n",
    't'               => "\t",
    'redirect_to'     => $redirect_to,
    'login_form_action' => true,

);

Parameters

$args
(array) (required) An array of arguments that are to override form $defaults.

$action
(string) (optional) Indicates the form that is being displayed (login|pwdreset|pwdchange|getusername).

Useage

add_filter( 'wpmem_login_form_args', function ( $args, $action ) {

    // This example adds a div wrapper around each row in the login form.
    $args['row_before'] = '<div class="my-row-wrapper">';
    $args['row_after']  = '</div>';
    
    return $args;
    
}, 10, 2 );

Changelog

Introduced in version 2.9.0
3.1.7 moved to the forms object class, added WP action login_form
3.2.6 Added nonce to the short form

Source

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

wpmem_inc_login_args

Description

DEPRECATED as of 3.3.0. Use wpmem_login_form_defaults instead.

This hook allows you to override the defaults for the login form. While there are four elements in the array, it is not recommended that you change the “action” or the “inputs” values.  The “action” value determines what action is being handled by the form, and the “inputs” can be filtered more directly with wpmem_inc_login_inputs.

$defaults = array(
    'heading'      => "Existing Users Log In", // Comes from $wpmem->get_text( 'login_heading' )
    'button_text'  => "Log In",                // Comes from $wpmem->get_text( 'login_button' )
    'action'       => "login", 
    'inputs'       => $default_inputs,         // Filtered by 'wpmem_inc_login_inputs'
    'redirect_to'  => $redirect_to,
);

Parameters

$args
(array) (required) An array of arguments that are to override form $defaults.

Usage

add_filter( 'wpmem_inc_login_args', 'my_login_args' );

function my_login_args( $args ) {
    // This example changes the button text.
    $args = array( 'button_text'  => "Log Me In" );

    return $args;
}

Changelog

Introduced in version 2.9.0
Deprecated as of 3.3.0, use wpmem_login_form_defaults instead

Source

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

wpmem_register_form_args

Description

This filter allows you to pass arguments to the registration form function to override default values that are used in the form building process. This includes default tags, labels, text, and small items including various booleans. The wpmem_inc_registration() function uses the wp_parse_args() function to merge arguments passed through this filter with the following defaults:

$defaults = array(

    // Wrappers.
    'heading_before'   => '<legend>',
    'heading_after'    => '</legend>',
    'fieldset_before'  => '<fieldset>',
    'fieldset_after'   => '</fieldset>',
    'main_div_before'  => '<div id="wpmem_reg">',
    'main_div_after'   => '</div>',
    'txt_before'       => '',
    'txt_after'        => '',
    'row_before'       => '',
    'row_after'        => '',
    'buttons_before'   => '<div class="button_div">',
    'buttons_after'    => '</div>',

    // Classes & ids.
    'form_id'          => ( 'new' == $tag ) ? 'wpmem_register_form' : 'wpmem_profile_form',
    'form_class'       => 'form',
    'button_id'        => '',
    'button_class'     => 'buttons',

    // Required field tags and text.
    'req_mark'         => $wpmem->get_text( 'register_req_mark' ),
    'req_label'        => $wpmem->get_text( 'register_required' ),
    'req_label_before' => '<div class="req-text">',
    'req_label_after'  => '</div>',

    // Buttons.
    'show_clear_form'  => false,
    'clear_form'       => $wpmem->get_text( 'register_clear' ),
    'submit_register'  => $wpmem->get_text( 'register_submit' ),
    'submit_update'    => $wpmem->get_text( 'profile_submit' ),

    // Other.
    'post_to'          => get_permalink(),
    'strip_breaks'     => true,
    'use_nonce'        => false,
    'wrap_inputs'      => true,
    'n'                => "\n",
    't'                => "\t",

    'register_form_action' => true,
);

Parameters

$args
(array) (required) An array of arguments that are to override form $defaults.

$toggle
(string) (optional) Indicates the form that is being displayed (new|edit).

Examples

/**
 * This example adds a div wrapper around each
 * row in the registration form.
 */
add_filter( 'wpmem_register_form_args', function( $args, $tag ) {
    $args = array(
        'row_before' => '<div class="my-row-wrapper">',
        'row_after'  => '</div>',
    );
 
    return $args;
}, 10, 2 );


/**
 * The following example would change the
 * class assigned to buttons.
 */
add_filter( 'wpmem_register_form_args', function( $args, $tag ) {
    $args['button_class'] = 'btn btn-primary';
    return $args;
}, 10, 2 );


/**
 * This example sets register_form_action to false to 
 * disable the WP "register_form" action hook in the form.
 */
 add_filter( 'wpmem_register_form_args', function( $args, $tag ) {
    $args['register_form_action'] = false;
    return $args;
}, 10, 2 );

Changelog

Introduced in version 2.9.0

Source

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

Related

wpmem_register_form_rows

Ready to get started?

Join Today!