Panel/Panel/modules/billing/QUICK_START.md

Quick Start Guide - GSP Billing Panel Integration

What Was Completed

✅ Created navigation.xml - Routes panel URLs to billing pages
✅ Created my_orders_panel.php - User view of paid orders
✅ Updated create_servers.php - Enhanced provisioning with multi-server support
✅ Created admin_orders.php - Admin order management interface
✅ Created test_integration.php - Integration testing tool
✅ Created PANEL_INTEGRATION.md - Complete documentation

How to Test Right Now

Step 1: Test Integration

1. Log into your GSP panel
2. Navigate to: home.php?m=billing&p=test_integration
3. Review all checks - everything should show green ✓

Step 2: Create a Test Order (Database)

If you don't have paid orders yet, create one in the database:

INSERT INTO billing_orders 
(user_id, service_id, home_name, max_players, price, qty, invoice_duration, status, order_date)
VALUES 
(1, 1, 'Test Minecraft Server', 25, 9.99, 1, 'month', 'paid', NOW());

Replace:

• user_id = 1 with your actual user ID
• service_id = 1 with a valid service_id from billing_services table

Step 3: View Your Orders

Navigate to: home.php?m=billing&p=my_orders

You should see:

• Table with your paid orders
• "Provision Server" button for each order
• "Provision All My Servers" button if multiple orders

Step 4: Provision a Server

Click "Provision Server" button

Expected behavior:

• Redirects to provision_servers page
• Creates game_home entry
• Assigns IP and port
• Installs game files (Steam/rsync/manual)
• Updates order status to 'installed'
• Shows success message
• Auto-redirects to Game Monitor after 3 seconds

Step 5: Admin Testing (Admin Only)

Navigate to: home.php?m=billing&p=admin_orders

Features to test:

• View all orders across all users
• Filter by status dropdown
• Search by username/order ID/server name
• Select multiple orders with checkboxes
• Bulk actions dropdown
• Individual provision/view buttons

Multi-Server Cart Testing

Setup:

Create multiple paid orders for the same user:

INSERT INTO billing_orders 
(user_id, service_id, home_name, max_players, price, qty, invoice_duration, status, order_date)
VALUES 
(1, 1, 'Minecraft Server 1', 25, 9.99, 1, 'month', 'paid', NOW()),
(1, 2, 'Minecraft Server 2', 50, 14.99, 1, 'month', 'paid', NOW()),
(1, 3, 'ARK Server', 100, 19.99, 1, 'month', 'paid', NOW());

Test:

1. Navigate to: home.php?m=billing&p=my_orders
2. Click "Provision All My Servers (3)" button
3. Wait for provisioning to complete
4. Verify all 3 orders changed to status='installed'
5. Check Game Monitor - all 3 servers should appear

Panel URLs Reference

Page	URL	Access	Purpose
Test Integration	home.php?m=billing&p=test_integration	user, admin	Verify setup
My Orders	home.php?m=billing&p=my_orders	user, admin	View paid orders
Provision Servers	home.php?m=billing&p=provision_servers&order_id=X	user, admin	Create servers
Admin Orders	home.php?m=billing&p=admin_orders	admin only	Manage all orders

Common Issues & Solutions

"No paid orders found"

Problem: No orders with status='paid' in database
Solution: Check database: SELECT * FROM billing_orders WHERE status='paid'
Fix: Update test order: UPDATE billing_orders SET status='paid' WHERE order_id=X

"Page not found" / 404 error

Problem: navigation.xml not loaded or file missing
Solution 1: Verify navigation.xml exists in modules/billing/
Solution 2: Check file permissions (must be readable by web server)
Solution 3: Verify XML syntax is valid (no typos)

"Access Denied"

Problem: User group doesn't match page access requirements
Solution: Check $_SESSION['users_group'] matches navigation.xml access attribute
Fix for admin pages: Only 'admin' group can access admin_orders

Provisioning fails silently

Problem: create_servers.php encounters error but doesn't show it
Solution: Check PHP error logs
Common causes:

• Invalid remote_server_id (stored in ip field)
• Missing game server files
• SteamCMD not configured
• Permissions issues on game directories

Multiple servers provision but some fail

Problem: Foreach loop continues even if one fails
Solution: Check individual order details in admin_orders
Fix: Provision failed orders individually to see specific error

Architecture Quick Reference

Order Status Flow

in-cart → paid → installed → invoiced → suspended/deleted
          ↑                     ↑
          |                     |
    (payment)            (renewal or non-payment)

Provisioning Flow

User orders on website → Payment processed → status='paid'
                                              ↓
User logs into panel → My Orders → Click "Provision Server"
                                              ↓
create_servers.php → Query WHERE status='paid' → foreach order
                                              ↓
Create game_home → Assign IP:Port → Install files → Update status='installed'
                                              ↓
                        Email + Discord notification → Redirect to Game Monitor

File Locations

modules/billing/
├── navigation.xml              [Panel routing config]
├── my_orders_panel.php         [User order list]
├── admin_orders.php            [Admin management]
├── create_servers.php          [Server provisioning]
├── test_integration.php        [Testing tool]
├── PANEL_INTEGRATION.md        [Full documentation]
└── QUICK_START.md              [This file]

Next Steps After Testing

1. Optional: Add Menu Items

Edit modules/billing/module.php around line 20:

$module_menus = array(
    array('subpage' => 'my_orders', 'name'=>'My Orders', 'group'=>'user'),
    array('subpage' => 'admin_orders', 'name'=>'Manage Orders', 'group'=>'admin')
);

This adds menu items to panel sidebar navigation.

2. Customize Success Messages

Edit create_servers.php around line 385 to customize redirect behavior:

• Change auto-redirect delay (currently 3 seconds)
• Add custom success messages
• Modify redirect destination

3. Add Email Templates

Enhance email notifications in create_servers.php:

• Custom HTML email templates
• Include server connection details
• Add next steps for users

4. Discord Webhook Formatting

Improve Discord notifications with:

• Rich embeds with server details
• Color coding by status
• Direct links to Game Monitor

5. Production Deployment

Before going live:

• Test with real payment gateway (PayPal/Stripe)
• Verify SteamCMD and game installs work
• Test with multiple concurrent users
• Set up monitoring and logging
• Configure backup system

Support & Troubleshooting

Debug Mode

To see detailed errors, enable PHP error reporting temporarily:

In create_servers.php at the top of exec_ogp_module():

error_reporting(E_ALL);
ini_set('display_errors', 1);

Database Debugging

Check order details:

SELECT o.*, s.service_name, u.users_login 
FROM billing_orders o
LEFT JOIN billing_services s ON o.service_id = s.service_id
LEFT JOIN users u ON o.user_id = u.user_id
WHERE o.status = 'paid';

Log Files to Check

• PHP error log: /var/log/php_errors.log (or server equivalent)
• Apache/Nginx error log: /var/log/apache2/error.log
• OGP agent log: Check agent output for remote commands
• Game server logs: In each game_home directory

Questions?

Refer to:

• PANEL_INTEGRATION.md - Complete technical documentation
• test_integration.php - Run diagnostics: home.php?m=billing&p=test_integration
• OGP documentation - For panel-specific questions
• create_servers.php - Source code with comments

Success Checklist

Before considering integration complete:

• test_integration.php shows all green checks
• Can view orders at my_orders page
• Can provision single order successfully
• Can provision multiple orders at once
• Orders update to status='installed' in database
• home_id saved correctly after provisioning
• end_date calculated and saved
• Servers appear in Game Monitor
• Admin can view all orders
• Admin can filter and search orders
• Bulk actions work (provision multiple)
• Email notifications sent (if configured)
• Discord webhooks work (if configured)

---

Integration Status: COMPLETE
Multi-Server Support: FUNCTIONAL
Admin Tools: READY
Testing Tool: AVAILABLE

Start with: home.php?m=billing&p=test_integration