a0be9ede66
Agent-Logs-Url: https://github.com/GameServerPanel/GSP/sessions/862c51a7-d835-4eb2-bd0e-2e2a5459036b Co-authored-by: iaretechnician <2749183+iaretechnician@users.noreply.github.com>
329 lines
18 KiB
PHP
329 lines
18 KiB
PHP
<?php
|
||
/*
|
||
*
|
||
* OGP - Open Game Panel
|
||
* Copyright (C) 2008 - 2017 The OGP Development Team
|
||
*
|
||
* http://www.opengamepanel.org/
|
||
*
|
||
* This program is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU General Public License
|
||
* as published by the Free Software Foundation; either version 2
|
||
* of the License, or any later version.
|
||
*
|
||
* This program is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
* GNU General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU General Public License
|
||
* along with this program; if not, write to the Free Software
|
||
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
||
*
|
||
*/
|
||
|
||
// Module general information
|
||
$module_title = "billing";
|
||
$module_version = "3.2";
|
||
$db_version = 2;
|
||
$module_required = FALSE;
|
||
// Module description
|
||
$module_description = "Billing storefront / provisioning integration. Public ordering runs as a standalone site; panel pages provide provisioning and admin order management.";
|
||
|
||
// No panel menu entries – billing runs as a standalone website, not panel pages.
|
||
// Install/uninstall/update DB logic below is still active.
|
||
$module_menus = array();
|
||
|
||
$install_queries = array();
|
||
|
||
// -----------------------------------------------------------------------
|
||
// db_version 1 — Baseline schema for fresh installs.
|
||
// All CREATE TABLE statements use IF NOT EXISTS so they are safe to re-run.
|
||
// NOTE: The panel updater runs $install_queries[$i+1] when upgrading a
|
||
// module from db_version $i. A module installed fresh at db_version 0
|
||
// therefore runs $install_queries[1], not $install_queries[0].
|
||
// -----------------------------------------------------------------------
|
||
$install_queries[1] = array(
|
||
// Billing Services — available game server packages
|
||
"CREATE TABLE IF NOT EXISTS `".OGP_DB_PREFIX."billing_services` (
|
||
`service_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`home_cfg_id` INT(11) NOT NULL DEFAULT 0,
|
||
`mod_cfg_id` INT(11) NOT NULL DEFAULT 0,
|
||
`service_name` VARCHAR(255) NOT NULL,
|
||
`description` VARCHAR(1000) NOT NULL DEFAULT '',
|
||
`img_url` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`remote_server_id` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`out_of_stock` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`slot_max_qty` INT(11) NOT NULL DEFAULT 0,
|
||
`slot_min_qty` INT(11) NOT NULL DEFAULT 0,
|
||
`price_daily` FLOAT(15,4) NOT NULL DEFAULT 0,
|
||
`price_monthly` FLOAT(15,4) NOT NULL DEFAULT 0,
|
||
`price_year` FLOAT(15,4) NOT NULL DEFAULT 0,
|
||
`ftp` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`install_method` VARCHAR(255) NOT NULL DEFAULT 'steamcmd',
|
||
`manual_url` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`access_rights` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`enabled` INT(11) NOT NULL DEFAULT 0,
|
||
PRIMARY KEY (`service_id`),
|
||
KEY `enabled` (`enabled`),
|
||
KEY `mod_cfg_id` (`mod_cfg_id`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;",
|
||
|
||
// Billing Orders — active game server instances
|
||
"CREATE TABLE IF NOT EXISTS `".OGP_DB_PREFIX."billing_orders` (
|
||
`order_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`user_id` INT(11) NOT NULL,
|
||
`service_id` INT(11) NOT NULL,
|
||
`home_name` VARCHAR(255) NOT NULL,
|
||
`ip` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`qty` INT(11) NOT NULL DEFAULT 1,
|
||
`invoice_duration` VARCHAR(16) NOT NULL DEFAULT 'month',
|
||
`max_players` INT(11) NOT NULL DEFAULT 0,
|
||
`price` FLOAT(15,2) NOT NULL DEFAULT 0,
|
||
`discount_amount` DECIMAL(10,2) NOT NULL DEFAULT 0.00,
|
||
`remote_control_password` VARCHAR(255) NULL,
|
||
`ftp_password` VARCHAR(255) NULL,
|
||
`home_id` VARCHAR(255) NOT NULL DEFAULT '0',
|
||
`status` VARCHAR(16) NOT NULL DEFAULT 'in-cart',
|
||
`order_date` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
`end_date` DATETIME NULL,
|
||
`payment_txid` VARCHAR(255) NULL,
|
||
`paid_ts` DATETIME NULL,
|
||
`coupon_id` INT(11) NOT NULL DEFAULT 0,
|
||
PRIMARY KEY (`order_id`),
|
||
KEY `user_id` (`user_id`),
|
||
KEY `status` (`status`),
|
||
KEY `home_id` (`home_id`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;",
|
||
|
||
// Billing Invoices — created on cart add, paid after payment capture.
|
||
// home_id is 0 until the service is provisioned after payment.
|
||
// billing_status tracks the renewal lifecycle (Active / Invoiced / Expired)
|
||
// independently of payment_status which tracks the payment state.
|
||
"CREATE TABLE IF NOT EXISTS `".OGP_DB_PREFIX."billing_invoices` (
|
||
`invoice_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`order_id` INT(11) NOT NULL DEFAULT 0,
|
||
`user_id` INT(11) NOT NULL,
|
||
`service_id` INT(11) NOT NULL DEFAULT 0, -- 0 = ad-hoc or admin-created invoice not linked to a catalogue service
|
||
`home_id` INT(11) NOT NULL DEFAULT 0,
|
||
`home_name` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`ip` INT(11) NOT NULL DEFAULT 0,
|
||
`max_players` INT(11) NOT NULL DEFAULT 0,
|
||
`remote_control_password` VARCHAR(255) NULL,
|
||
`ftp_password` VARCHAR(255) NULL,
|
||
`customer_name` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`customer_email` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`amount` FLOAT(15,2) NOT NULL DEFAULT 0,
|
||
`discount_amount` DECIMAL(10,2) NOT NULL DEFAULT 0.00,
|
||
`currency` VARCHAR(3) NOT NULL DEFAULT 'USD',
|
||
`status` VARCHAR(16) NOT NULL DEFAULT 'due',
|
||
`billing_status` VARCHAR(16) NOT NULL DEFAULT 'due',
|
||
`invoice_date` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
`due_date` DATETIME NULL,
|
||
`paid_date` DATETIME NULL,
|
||
`payment_txid` VARCHAR(255) NULL,
|
||
`payment_method` VARCHAR(50) NULL,
|
||
`description` VARCHAR(500) NOT NULL DEFAULT '',
|
||
`invoice_duration` VARCHAR(16) NOT NULL DEFAULT 'month',
|
||
`rate_type` ENUM('daily','monthly','yearly') NOT NULL DEFAULT 'monthly',
|
||
`rate_per_player` DECIMAL(15,4) NOT NULL DEFAULT 0,
|
||
`players` INT(11) NOT NULL DEFAULT 0,
|
||
`period_start` DATETIME NULL,
|
||
`period_end` DATETIME NULL,
|
||
`subtotal` DECIMAL(15,2) NOT NULL DEFAULT 0,
|
||
`total_due` DECIMAL(15,2) NOT NULL DEFAULT 0,
|
||
`payment_status` ENUM('unpaid','paid','cancelled','refunded') NOT NULL DEFAULT 'unpaid',
|
||
`qty` INT(11) NOT NULL DEFAULT 1,
|
||
`coupon_id` INT(11) NOT NULL DEFAULT 0,
|
||
PRIMARY KEY (`invoice_id`),
|
||
KEY `order_id` (`order_id`),
|
||
KEY `user_id` (`user_id`),
|
||
KEY `home_id` (`home_id`),
|
||
KEY `status` (`status`),
|
||
KEY `due_date` (`due_date`),
|
||
KEY `service_id` (`service_id`),
|
||
KEY `coupon_id` (`coupon_id`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;",
|
||
|
||
// Billing Transactions — immutable payment audit trail
|
||
"CREATE TABLE IF NOT EXISTS `".OGP_DB_PREFIX."billing_transactions` (
|
||
`transaction_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`invoice_id` INT(11) NOT NULL DEFAULT 0,
|
||
`user_id` INT(11) NOT NULL DEFAULT 0,
|
||
`home_id` INT(11) NOT NULL DEFAULT 0,
|
||
`payment_method` VARCHAR(50) NOT NULL DEFAULT 'paypal',
|
||
`transaction_external_id` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`amount` DECIMAL(15,2) NOT NULL DEFAULT 0.00,
|
||
`currency` VARCHAR(3) NOT NULL DEFAULT 'USD',
|
||
`status` ENUM('pending','completed','failed','refunded') NOT NULL DEFAULT 'pending',
|
||
`raw_response` MEDIUMTEXT NULL,
|
||
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
PRIMARY KEY (`transaction_id`),
|
||
KEY `invoice_id` (`invoice_id`),
|
||
KEY `user_id` (`user_id`),
|
||
KEY `home_id` (`home_id`),
|
||
KEY `status` (`status`),
|
||
KEY `payment_method` (`payment_method`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;",
|
||
|
||
// Billing Coupons — discount codes
|
||
"CREATE TABLE IF NOT EXISTS `".OGP_DB_PREFIX."billing_coupons` (
|
||
`coupon_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`code` VARCHAR(50) NOT NULL,
|
||
`name` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`description` TEXT NULL,
|
||
`discount_percent` DECIMAL(5,2) NOT NULL DEFAULT 0.00,
|
||
`usage_type` ENUM('one_time','permanent') NOT NULL DEFAULT 'one_time',
|
||
`game_filter_type` ENUM('all_games','specific_games') NOT NULL DEFAULT 'all_games',
|
||
`game_filter_list` TEXT NULL,
|
||
`max_uses` INT(11) NULL,
|
||
`current_uses` INT(11) NOT NULL DEFAULT 0,
|
||
`expires` DATETIME NULL,
|
||
`created_date` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
`created_by` INT(11) NULL,
|
||
`is_active` TINYINT(1) NOT NULL DEFAULT 1,
|
||
PRIMARY KEY (`coupon_id`),
|
||
UNIQUE KEY `idx_code` (`code`),
|
||
KEY `idx_active_expires` (`is_active`,`expires`),
|
||
KEY `idx_created_by` (`created_by`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;",
|
||
|
||
// Billing Config — global and per-game-key billing settings used by cron
|
||
"CREATE TABLE IF NOT EXISTS `".OGP_DB_PREFIX."billing_config` (
|
||
`config_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`game_key` VARCHAR(100) NULL DEFAULT NULL,
|
||
`enabled` TINYINT(1) NOT NULL DEFAULT 1,
|
||
`grace_days` INT(11) NOT NULL DEFAULT 0,
|
||
`delete_after_expired_days` INT(11) NOT NULL DEFAULT 7,
|
||
`rate_type` ENUM('daily','monthly','yearly') NOT NULL DEFAULT 'monthly',
|
||
`price_per_player` DECIMAL(10,4) NOT NULL DEFAULT 0.0000,
|
||
PRIMARY KEY (`config_id`),
|
||
KEY `game_key` (`game_key`),
|
||
KEY `enabled` (`enabled`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;",
|
||
|
||
// Drop legacy mapping table if it still exists from older installs
|
||
"DROP TABLE IF EXISTS `".OGP_DB_PREFIX."billing_service_remote_servers`"
|
||
);
|
||
|
||
// -----------------------------------------------------------------------
|
||
// db_version 2 — Safe idempotent column migrations for existing installs.
|
||
// Each callable checks whether the column already exists before running
|
||
// ALTER TABLE, so this migration can be re-run without errors.
|
||
// -----------------------------------------------------------------------
|
||
$install_queries[2] = array(
|
||
// billing_orders: add discount_amount if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_orders` ADD `discount_amount` DECIMAL(10,2) NOT NULL DEFAULT 0.00 AFTER `price`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add home_id if missing (needed by cron-shop.php join)
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `home_id` INT(11) NOT NULL DEFAULT 0 AFTER `service_id`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add discount_amount if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `discount_amount` DECIMAL(10,2) NOT NULL DEFAULT 0.00 AFTER `amount`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add billing_status (lifecycle: Active/Invoiced/Expired) if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `billing_status` VARCHAR(16) NOT NULL DEFAULT 'due' AFTER `status`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add rate_type enum if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `rate_type` ENUM('daily','monthly','yearly') NOT NULL DEFAULT 'monthly' AFTER `invoice_duration`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add rate_per_player if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `rate_per_player` DECIMAL(15,4) NOT NULL DEFAULT 0 AFTER `rate_type`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add players if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `players` INT(11) NOT NULL DEFAULT 0 AFTER `rate_per_player`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add subtotal if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `subtotal` DECIMAL(15,2) NOT NULL DEFAULT 0 AFTER `players`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add total_due if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `total_due` DECIMAL(15,2) NOT NULL DEFAULT 0 AFTER `subtotal`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add payment_status enum if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `payment_status` ENUM('unpaid','paid','cancelled','refunded') NOT NULL DEFAULT 'unpaid' AFTER `currency`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// billing_invoices: add coupon_id if missing
|
||
function($db) {
|
||
if (!$db->query("ALTER TABLE `OGP_DB_PREFIXbilling_invoices` ADD `coupon_id` INT(11) NOT NULL DEFAULT 0 AFTER `qty`")) {
|
||
return (stripos((string)$db->getError(), 'Duplicate column') !== false);
|
||
}
|
||
return true;
|
||
},
|
||
// Create billing_config table for cron-shop settings if missing
|
||
"CREATE TABLE IF NOT EXISTS `OGP_DB_PREFIXbilling_config` (
|
||
`config_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`game_key` VARCHAR(100) NULL DEFAULT NULL,
|
||
`enabled` TINYINT(1) NOT NULL DEFAULT 1,
|
||
`grace_days` INT(11) NOT NULL DEFAULT 0,
|
||
`delete_after_expired_days` INT(11) NOT NULL DEFAULT 7,
|
||
`rate_type` ENUM('daily','monthly','yearly') NOT NULL DEFAULT 'monthly',
|
||
`price_per_player` DECIMAL(10,4) NOT NULL DEFAULT 0.0000,
|
||
PRIMARY KEY (`config_id`),
|
||
KEY `game_key` (`game_key`),
|
||
KEY `enabled` (`enabled`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;",
|
||
// Create billing_coupons table if missing (older installs using panel.sql may not have it)
|
||
"CREATE TABLE IF NOT EXISTS `OGP_DB_PREFIXbilling_coupons` (
|
||
`coupon_id` INT(11) NOT NULL AUTO_INCREMENT,
|
||
`code` VARCHAR(50) NOT NULL,
|
||
`name` VARCHAR(255) NOT NULL DEFAULT '',
|
||
`description` TEXT NULL,
|
||
`discount_percent` DECIMAL(5,2) NOT NULL DEFAULT 0.00,
|
||
`usage_type` ENUM('one_time','permanent') NOT NULL DEFAULT 'one_time',
|
||
`game_filter_type` ENUM('all_games','specific_games') NOT NULL DEFAULT 'all_games',
|
||
`game_filter_list` TEXT NULL,
|
||
`max_uses` INT(11) NULL,
|
||
`current_uses` INT(11) NOT NULL DEFAULT 0,
|
||
`expires` DATETIME NULL,
|
||
`created_date` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
`created_by` INT(11) NULL,
|
||
`is_active` TINYINT(1) NOT NULL DEFAULT 1,
|
||
PRIMARY KEY (`coupon_id`),
|
||
UNIQUE KEY `idx_code` (`code`),
|
||
KEY `idx_active_expires` (`is_active`,`expires`),
|
||
KEY `idx_created_by` (`created_by`)
|
||
) ENGINE=MyISAM DEFAULT CHARSET=utf8mb4;"
|
||
);
|
||
|
||
?>
|