External Auth Module: Third-Party OAuth Integration
Simplify user onboarding and boost registration rates. The External Auth Module integrates popular third-party OAuth 2.0 services - specifically Google, Facebook, and GitHub - directly into your PolyCMS site for fast, secure social logins.
Core Features
Configure settings under your admin dashboard under the settings menu:
1. Multi-Provider OAuth 2.0 Support
Enables users to register and log in instantly via Google, Facebook, or GitHub. The module manages the entire OAuth state token workflow to prevent CSRF attacks.
2. Auto-Registration and Role Assignment
When a user logs in via a social provider for the first time, the module checks if an account with that email already exists. If not, it automatically creates a new user profile with a secure, randomized password and assigns the default 'customer' role.
3. Smart Email Resolution for GitHub
Addresses private email scenarios on GitHub. If a user's GitHub profile has a hidden email field, the module uses a secondary API call to fetch their primary, verified email address, ensuring registration is never disrupted.
4. Admin Management Panel
Manage all API credentials from a unified panel under Settings -> External Auth. Turn individual providers on or off and securely configure Client IDs and Client Secrets.
PolyCMS is an open-source content management system for modern web applications, inspired by the WordPress plugin and theme ecosystem but built on top of the Laravel framework. It is designed to provide a complete foundation for content publishing, e-commerce, multi-language support, and extensible module architecture — powered by a Vue 3 admin panel with data served entirely through RESTful APIs.
Whether you're building a blog, a documentation site, an online store, or a multi-tenant SaaS platform, PolyCMS aims to give you a comprehensive starting scaffold so you can ship quickly and extend easily through integrated modules and themes. In particular, themes in PolyCMS follow a multi-theme architecture — one Main theme and an unlimited number of Sub themes can run side by side on the same installation.
We hope this ready-made foundation proves useful for building your next website, blog, or web app, saving you from having to start completely from scratch.