Troubleshooting

AMS Connect for WP comes with a few built in troubleshooting tools that will make it easier for your to diagnose and resolve common issues.

SSO User Debugging Screen

The AMS Connect for WP dashboard has a widget called "Important Links" that has a URL called SSO User Debugging Url. This URL is useful for diagnosing the SSO data for any user that may be having trouble signing into their account or getting proper access. This URL will render out the same information as the [amsc-debug] shortcode, but without the need to embed the shortcode into any page.

If a user is having issues accessing gated content, you can send them this URL and request that they take a screenshot of it and send it back so that you can see the data that the SSO is detecting for this user.

Adding more debugging data

The [amsc-debug] shortcode data can be altered and added to by adding a function to the amsc_debug_data filter. This allows you to add custom data to this screen that may allow you to troubleshoot issues quickly for your specific setup:

add_filter(
	'amsc_debug_data',
	function ( $debug_data ) {
		$debug_data['custom_var'] = array(
			'label' => __( 'My Custom SSO Var', 'ams-connect' ),
			'value' => get_user_meta( get_current_user_id(), 'my_custom_user_meta_key' ),
		);
		return $debug_data;
	}
);