[GUIDE] How to Install GTAW Auth phpBB Forum Extension

[Skent]

🎯 What is this?

GTAW Auth is a phpBB extension that fully replaces the traditional login system with GTA World OAuth integration, allowing users to authenticate using their UCP account and select an in-game character to access your forum.

---

🧩 Key Features

✅ Login/Register via GTA World
Users authenticate via GTA World UCP and select a character — no passwords or manual registration.

✅ Character Selector UI
Once authenticated, users see a custom page to choose from their in-game characters.

✅ Automatic Account Creation
If no matching phpBB account exists, one is created instantly with the character’s full name.

✅ ACP Password Generator
If the user is an admin, a temporary ACP password is shown post-login and set on the account. This allows secure access to /adm without setting a real password.

✅ Universal Theme Support
Fully compatible with all phpBB themes.

✅ ACP Settings Page
Admins can toggle login enforcement, view their OAuth callback URL, and configure credentials directly from the forum backend.

✅ Login/Register Redirect
When enabled, any attempt to access login or registration redirects the user to GTA World authentication.

---

📦 Installation

📁 Extract ZIP Contents to:

/ext

 

Navigate to:
ACP → Extensions → GTAW Auth

Enter your Client ID and Client Secret and activate GTAW Login

---

🛠️ How to Get a Client ID and Secret

To use this extension, you must register your forum as an OAuth client with GTA World.

Steps:

1. Visit: https://ucp.gta.world

2. Go to: GTA World for Developers → GTA World OAuth & API

3. Fill out the form to request access

4. In the callback URL field, enter:

   https://yourforum.com/app.php/gtawauth/callback

5. Submit and wait for approval

6. You will receive your Client ID and Client Secret

---

🎨 Theme Suggestions

If you’re comfortable editing phpBB templates and want a smoother experience, you can:

• Remove the default login boxes from your theme

• Replace them with a simple GTAW login button that redirects to

  app.php/gtawauth/redirect

   

 

💡 This ensures users can always access the login flow — even if redirect hooks are disabled.

---

🔄 Changelog

v1.0.0

• 🆕 ACP password generator for GTAW-authenticated admins

• 🆕 ACP config module (enable/disable auth, manage keys)

• 🆕 Login/registration redirection toggle

• 🔐 Secure session override for GTAW users

• 🎨 Character selector UI with radio button layout

• 🧼 Universal theme compatibility

---

⬇️ Download

📥 Click to download GTAW Auth Extension

---

💬 Support

Need help, bug reports, or integration advice?
Contact @Skent

Edited May 18 by Skent

[delux]

Another GOAT. Thanks for making this

[dawpi]

This is crazy. We need this. Finally!

[Spring]

The best.

[Pengu]

FTW

[LennyVL]

YES

[Sindre2k19]

Amazing guide!

[Skydeluire]

Incredible, big props

[Everett]

Amazing work @Skent, thanks a lot <3

[Scaryxo]

Good job!