GSP/Panel

Fork 0

iaretechnician 08f07dca97 moved website outside of panel folder

2026-05-13 20:00:40 -04:00

9.1 KiB

Raw Blame History

Billing Module Standalone & Coupon System - Implementation Summary

Overview

This update addresses two major requirements:

Standalone Billing Module: The billing module can now operate independently from the panel, either on the same server or on a separate web host.
Enhanced Coupon System: A comprehensive coupon system with game filters, usage tracking, and permanent/one-time discount options.

Changes Made

1. Standalone Database Connection (Critical Fix)

Problem: The billing module was trying to use panel database functions that don't exist when deployed on a separate server, causing PayPal payment processing to fail with "Unexpected end of JSON input" error.

Solution:

Removed all require_once statements that reference panel files like includes/database_mysqli.php
Replaced panel database functions with native mysqli functions
Created standalone config.inc.php file for database credentials
Updated api/capture_order.php to use mysqli_connect() instead of createDatabaseConnection()

Files Modified:

.github/copilot-instructions.md - Added standalone requirement documentation
modules/billing/includes/config.inc.php - Created from template (should be gitignored in production)
modules/billing/api/capture_order.php - Fixed database connection

2. Enhanced Coupon System

Features Implemented:

✅ Create, edit, delete coupons through admin interface
✅ Percentage-based discounts (0-100%)
✅ One-time vs. permanent discount types
✅ Game-specific filtering (all games or specific games)
✅ Usage limits and tracking
✅ Expiration dates
✅ Coupon application in cart with real-time price updates
✅ Automatic discount application on payment
✅ Discount display in My Servers and Admin Invoices views

Files Created:

modules/billing/create_coupons_table.sql - Database schema
modules/billing/admin_coupons.php - Admin management interface
modules/billing/COUPON_SYSTEM.md - Comprehensive documentation

Files Modified:

modules/billing/admin.php - Added "Manage Coupons" link
modules/billing/cart.php - Added coupon application form and discount logic
modules/billing/api/capture_order.php - Apply coupons on payment, track usage
modules/billing/my_servers.php - Display discount information
modules/billing/admin_invoices.php - Display discount information

3. Database Schema Updates

New Table: ogp_billing_coupons

- coupon_id (primary key)
- code (unique)
- name, description
- discount_percent
- usage_type (one_time/permanent)
- game_filter_type (all_games/specific_games)
- game_filter_list (JSON array of game keys)
- max_uses, current_uses
- expires, is_active

Updated Tables:

ogp_billing_invoices: Added coupon_id, discount_amount
ogp_billing_orders: Added coupon_id, discount_amount

Installation Instructions

Prerequisites

MySQL/MariaDB database
PHP 7.4 or higher
Existing billing module installation

Step 1: Create Configuration File

If deploying on a separate server (not co-located with panel):

cd modules/billing/includes/
cp config.inc.php.orig config.inc.php

Edit config.inc.php with your database credentials:

$db_host = "your-db-host";
$db_user = "your-db-user";
$db_pass = "your-db-password";
$db_name = "your-db-name";
$table_prefix = "ogp_";

Important: Add config.inc.php to .gitignore to prevent committing sensitive credentials.

Step 2: Run Database Migration

mysql -u [username] -p [database] < modules/billing/create_coupons_table.sql

Or import via phpMyAdmin.

Step 3: Verify Installation

Log in as admin: /modules/billing/admin.php
Click "Manage Coupons"
You should see the coupon management interface with 2 sample coupons

Step 4: Test Coupon System

Create a test coupon or use existing "WELCOME10"
Add a server to cart: /modules/billing/order.php
View cart: /modules/billing/cart.php
Apply coupon code
Verify discount is calculated correctly
Complete payment (or use free server button if admin)
Check My Servers page for discount display

Usage

For Administrators

Create a Coupon:

Navigate to Admin → Manage Coupons
Scroll to "Add New Coupon" form
Fill in details:
- Code (e.g., "SUMMER25")
- Discount percentage (e.g., 25 for 25% off)
- Usage type (one-time or permanent)
- Game filter (all games or specific)
Click "Add Coupon"

Monitor Usage:

View current uses vs. max uses in coupon list
Edit or deactivate coupons as needed
Delete expired or unused coupons

For Customers

Apply a Coupon:

Add servers to cart
On cart page, find "Have a coupon code?" section
Enter coupon code
Click "Apply Coupon"
Prices update automatically
Proceed to PayPal checkout

View Discounts:

Cart page shows applied discount
My Servers page shows original price (strikethrough) and discounted price
Coupon code displayed with percentage

Coupon Types Explained

One-Time Coupons

Applied to first invoice only
Renewals use original price
Example: "WELCOME10" for new customers

Permanent Coupons

Applied to initial purchase AND all renewals
Discount stored in order record
Example: "VIP50" for permanent 50% off

Game Filters

All Games:

Coupon applies to any game in cart
Simplest option for general promotions

Specific Games:

Define list of game keys
Only matching games get discount
Uses partial matching (e.g., "arma3" matches "arma3_linux64")
Example: Arma-only promotion

Troubleshooting

PayPal Payment Returns JSON Error

Symptom: "Unexpected end of JSON input" on cart page after PayPal payment

Cause: Missing config.inc.php or incorrect database credentials

Fix:

Check /modules/billing/includes/config.inc.php exists
Verify credentials are correct
Test database connection: /modules/billing/test_db_connection.php
Check error logs: /modules/billing/logs/ and server error log

Coupon Not Applying

Checks:

Code is correct (case-sensitive)
Coupon is active
Not expired
Usage limit not reached
Game matches filter (for game-specific coupons)

Discount Not Showing After Payment