Zen Social Login: Official User Manual & Documentation

The Professional, One-Click Authentication Suite for Joomla 6 & PHP 8.3+

Introduction

ZenSocialLogin is the most modern, friction-free registration and login solution for Joomla. We believe in user sovereignty and conversion optimization: removing the hurdles of long sign-up forms and password fatigue by allowing visitors to authenticate with their existing Google, Facebook, or LinkedIn identities.

Part 1: Installation & Activation

1.1. Installing the Package

Download the pkg_zensociallogin.zip (or the PRO version pkg_zensociallogin_pro.zip).
Navigate to System -> Install -> Extensions.
Upload the archive. The system installs the component, the plugin, and creates necessary database tables automatically.

1.2. Activating the Plugin

Navigate to System -> Manage -> Plugins.
Search for "System - Zen Social Login".
Set the status to Enabled and open the plugin to configure your provider credentials.

Part 2: Provider Configuration

2.1. Credential Setup

To ensure security, you must obtain API credentials from each provider's developer console. Ensure your Redirect URI matches the following exactly (replace yourdomain.com):

https://yourdomain.com/index.php?option=com_zensociallogin&task=oauth.callback&provider=[google/facebook/linkedin]

After obtaining your Client ID/Secret or App ID/Secret, paste them into the respective tabs within the plugin settings.

Part 3: Advanced Options & Data Hygiene

3.1. Auto Register & User Groups

In the Advanced tab, configure the following for account management:

Auto Register: When enabled, a Joomla account is created automatically upon the first successful social login.
Default Group: Select the Joomla user group (e.g., "Registered") to assign to new users created via ZenSocialLogin.

3.2. PRO Exclusive: Log Retention & GDPR

ZenSocialLogin PRO is built for professional compliance:

Log Retention: Set how many days to keep login history (0 = keep forever). The system automatically prunes old entries.
GDPR Self-Service: Enable the front-end self-service tool to allow users to disconnect their social accounts, supporting their right to erasure without admin intervention.

Part 4: PRO Intelligence Suite

4.1. Analytics Dashboard

The PRO dashboard provides real-time insights:

Traffic Breakdown: Visualize logins by provider (Google vs. Facebook vs. LinkedIn).
Recent Activity: View the last 10 login events with IP addresses and timestamps.
CSV Export: Download the full login history for external auditing.

4.2. Smart Features

Smart Return URL: Automatically remembers the page the user was visiting before login and redirects them back after authentication.
OpenGraph & Twitter Cards: Automatically generates professional meta-tags for shared content.

Part 5: FAQ

Q: Why don't the buttons appear on my login form?
A: Ensure the provider tab is set to "Enabled" and that you have cleared your Joomla cache (System -> Maintenance -> Clear Cache).

Q: Does ZenSocialLogin work if my site is on HTTP?
A: No. OAuth providers (Google, Facebook, LinkedIn) strictly require HTTPS for security.

Q: How do I move my PRO license to a new domain?
A: Please contact our support team so we can release the domain lock for your license key.

ZenSocialLogin v1.0.0+ | Built by ZenSuite Team

Contact Us