th23 User Management

th23 User Management – FAQ and Support

Thanks for your interest in our plugin *smiley smiling*

We like to hear your feedback and suggestions – please leave your comment below!

As some questions arise more frequently, we put together a Frequently Asked Question collection – please check, if any of these already helps you…

  1. What is included in the Basic version?
  2. What are the additional functions in the Professional version?
  3. Where can I see / experience the plugin in action?
  4. How do I get and activate the Professional version?
  5. I get an error message when installing the Professional version from the ZIP file
  6. Why do I need to register here to get the Professional version?
  7. How can users access the plugin? How to integrate link to registration and login into my page?
  8. Does the plugin support additional login/ profile fields?
  9. How can I use the Google re-Captcha service?
  10. Is there any (known) incompatabilities with other plugins?
  11. How can I style / change the function of the overlay messages?

 

What is included in the Basic version?

The basic version makes the most important user management interactions for your users available on a nicely styled frontend page. This includes the following actions:

  • User registration
  • Login / Logout
  • View user profile

The style is very flexible, usually blending in perfectly with your choosen theme.

Via the th23 User Management widget an easy and nicely styled access to all user management activities is provided.

Other user management activities, e.g. the lost password functionality, of course remain available via the standard WordPress functions – and are linked in the provided widget.

 

What are the additional functions in the Professional version?

All user management actions are available on the frontend blending into the selected theme. This includes the following actions:

  • User profile changes
  • Lost password
  • Reset password

Access to the unstyled admin area can be restricted based on user groups – “wp-login.php” can be disabled completely

User chosen password upon registration option available – including initial e-mail validation

Admin approval for new users option available – before user can login

Option to use Google reCaptcha against spam and bots upon registration, lost password and login

Introduction of e-mail re-validation upon changes of address

 

Where can I see / experience the plugin in action?

The Professional version of the plugin is used for all user management actions on this site.

See the login / user widget in the sidebar on the right. Experience the registration process by signing up, resetting your password, editing your profile, etc.

 

How do I get and activate the Professional version?

To get the Professional version of the plugin, please register on this website and log in (Why?).

Once you have completed the registration, visit the plugin website and click the button “Go Professional”. Follow the PayPal payment process steps and you can immediately afterwards download the Professional version.

To install the professional version, just follow these steps:

  1. You have to install (or usually keep installed) the basic version
  2. Extract the “th23-user-management-pro.zip” file you have downloaded to a local folder
  3. Upload the extracted “th23-user-management-pro.php” file into the directory “wp-content/plugins/th23-user-management” on your WordPress installation

That’s it – it should work directly in the Professional mode, no further activation required!

The following images show the steps described above in a little bit more detail – step by step

 

I get an error message when installing the Professional version from the ZIP file

Please do NOT upload the “.zip” file to your server, but follow the instructions above to install the professional version.

Otherwise you will see an error message similiar to the following upon installation attempt

Unpacking the package...
Installing the plugin...
The package could not be installed. No valid plugins were found.
Plugin install failed.

 

Why do I need to register here to get the Professional version?

With the purchase of the Professional version you also get all updates for one year for free. To ensure your access to these updates and also provide you the option to download the file again, we require you to register on this site.

Rest assured, that your personal data (e.g. mail address) stays on our servers just for this purpose and nothing else!

 

How can users access the plugin? How to integrate link to registration and login into my page?

The plugin comes with a widget you can integrate into the WordPress sidebar (or any other widget area). This widget will provide the required links and form for your users to register, login, etc.

To add this widget, please follow these easy steps:

  1. Go to the WordPress admin area
  2. Open the Appearance / Widgets section
  3. Drag the “th23 User Management” widget from “Available Widgets” on the left to a selected “Widget Area” on the right

 

Does the plugin support additional login/ profile fields?

Yes, the plugin can handle additional fields upon registration and provides the required hooks/ filters. However, this requires other plugins to leverage upon these API points – or requires you (with some knowledge about PHP coding) to use them. On my website for example, a subscription plugin is using these hooks to integrate upon registration.

To add additional HTML to the registration page, see the following sample code – using a filter

// register filter
add_filter('th23_user_management_register_options_html', array(&$this, 'add_fields'));

// add html
function add_fields($html) {
	$html .= '<p><label for="last_name">' . __('Last Name', 'th23-user-management') . '</label><br /><input type="text" name="last_name" id="last_name" class="input" value="' . esc_attr((isset($_POST['last_name'])) ? wp_unslash($_POST['last_name']) : '') . '" size="20"  tabindex="1" /></p>';
	return $html;
}

To evaluate and store the user input upon registration, see the following lines of code – using an action

// register action
add_action('th23_user_management_register_send_mail', array(&$this, 'handle_fields'));

// store user input
function handle_fields($new_user) {
	$user_input = array(
		'last_name' => '',
	);
	foreach($user_input as $name => $null) {
		$user_input[$name] = (isset($_POST[$name])) ? sanitize_text_field($_POST[$name]) : '';
	}
	$user_input['ID'] = $new_user->ID;
	$user_id = wp_update_user($user_input);
}

For reference, I put together a working demo plugin, you can download here.

 

How can I use the Google re-Captcha service?

re-Captcha is a proven method to reduce fake registrations and spam for on your website. This service is provided by Google for free, but it requires you to sign up for an account.

After your registration you get a public and a private key for the service. These key have to be entered on the settings page of the plugin:

  1. Go to the WordPress admin area
  2. Open the Settings / th23 User Management section
  3. Enter the keys into the fields “Public Key” and “Private Key”

Enabling the options without a (valid) key will not work!

 

Is there any (known) incompatabilities with other plugins?

This list can of course never be complete – and might change due to updates on this and other plugins happening.

However, we will try to list all reported and/ or discovered incompatibilities below:

  • No CAPTCHA reCAPTCHA plugin – caused issue upon login
  • Jetpack – sometimes caused unwanted logouts, issue happened with various plugins, see this link for details

If you encounter any, please send feedback about them – ideally including the versions of WordPress and the plugins involved!

 

How can I style / change the function of the overlay messages?

Since version 2.2 of the plugin we optimized the functionality of the overlay messages shown upon login and logout. These are now more easily stylable and the functionality can be adjusted via additional JS, e.g. in your themes CSS and JS files.

On this website we leverage this functionality using the JavaScript code below in our themes JS file:

jQuery(document).ready(function($){
	$.th23omsg = function(object, action, context) {
		var box = object.closest('.th23-omsg');
		var boxOffset = (bigScreen) ? '-' + (box.outerHeight() + 10) + 'px' : '-' + (box.outerWidth() + 10) + 'px';
		var cssProperty = (bigScreen) ? 'top' : 'left';
		if(action == 'open') {
			box.css({'top': '0', 'left': '0'});
		}
		else if(action == 'close_click' || action == 'close_auto') {
			box.css(cssProperty, boxOffset).one('transitionend webkitTransitionEnd oTransitionEnd MSTransitionEnd', function(){ $(this).remove(); });
		}
	};
});

Please note, that this is an example code – it might/ will not work like that without linkage to other functions on this website!

 

Still no answer to your question?

Please leave us a message describing your question / issue below – and we will try to get back to you as soon as possible!

105 thoughts on “th23 User Management – FAQ and Support”

  1. Email messages are rather cryptic and not correct. For instance, here is one such message:

    Hi robert.pureaqua, Following user is logged in your site

    Robert is actually the user in the site. Should be the name of the person being sent the message and should say – ” following user is logged into your site.” How do I correct the messages?

    1. Hi RADX,

      within my plugin I don’t recall to use this message string (“Following user is logged in your site”*smiley winking* – must be either from WP core or from another plugin you use…

      You search in the source PHP files for this string – ideally with an editor that allows search in files for a complete folder of course.

      As I am currently travelling without my PC can only check myself in a source WP copy next weekend…

Leave a Reply