FEATURES

MAINTENANCE MODE

wolfXcore includes a built-in site-wide maintenance mode. When enabled, all visitors (except root admins) see a neon 503 page instead of the normal panel.

Enabling maintenance mode

There are two ways to enable maintenance mode:

Via the Super Admin panel (recommended)

Go to /admin/wxn-super/auth and authenticate.
Navigate to Maintenance Mode in the Super Admin dashboard.
Toggle the switch to ON.
Optionally set a custom maintenance message.
Save — the change takes effect immediately for all new requests.

Via the database

SQL

INSERT INTO settings (key, value) VALUES ('maintenance::enabled', 'true')
ON DUPLICATE KEY UPDATE value = 'true';

How it works

The SiteMaintenanceMiddleware is applied globally to all web routes. On every request it checks the maintenance::enabled setting in the DB. If enabled, it returns the neon 503 maintenance page — unless the requesting user is a root admin.

Visitor type	Maintenance ON	Maintenance OFF
Regular user	503 maintenance page	Normal panel
Panel admin	503 maintenance page	Normal panel
Root admin	Normal panel (bypassed)	Normal panel
Super Admin session	Normal panel (bypassed)	Normal panel

ℹ️

Root admin bypass. Users with root admin status in the panel automatically bypass maintenance mode. This is handled in SiteMaintenanceMiddleware — no configuration needed.

The 503 maintenance page

Visitors in maintenance mode see the neon wolfXcore 503 page (resources/views/errors/site-maintenance.blade.php). It features:

Animated grid background with neon green overlay
Pulsing status indicator ("Maintenance in progress")
wolfXcore branding (Orbitron + JetBrains Mono fonts)
Discrete admin login link at the bottom
Fully self-contained — no JavaScript, no external dependencies besides Google Fonts

Disabling maintenance mode

Via the Super Admin panel

Authenticate at /admin/wxn-super/auth.
Toggle maintenance mode to OFF and save.

Via the database

SQL

UPDATE settings SET value = 'false'
WHERE key = 'maintenance::enabled';

⚠️

Do not use php artisan down. The standard Laravel maintenance mode (artisan down) is separate from wolfXcore's built-in maintenance mode. Use the Super Admin panel toggle — it's stored in the database and does not affect the queue workers, scheduler, or Wings connections.

Customising the 503 page

Edit resources/views/errors/site-maintenance.blade.php to change the message, add an estimated return time, or adjust the styling. The file is pure HTML/CSS with optional Blade variables.

To show a custom message set via the Super Admin panel, use:

Blade

@if(config('wolfxcore.maintenance_message'))
  <p>{{ config('wolfxcore.maintenance_message') }}</p>
@endif

Relevant source files

File	Purpose
`app/Http/Middleware/SiteMaintenanceMiddleware.php`	Intercepts requests and returns 503 when enabled
`resources/views/errors/site-maintenance.blade.php`	Neon 503 page shown to visitors
`app/Http/Controllers/Admin/SuperAdminController.php`	Handles the toggle via Super Admin panel

← Plans