409 lines
15 KiB
PHP
409 lines
15 KiB
PHP
<?php
|
|
/**
|
|
* AKSRT Admin — Import/Export Controller
|
|
*
|
|
* Handles REST routes for settings export, import, section reset,
|
|
* and health diagnostics.
|
|
*
|
|
* @package AKSRT
|
|
*/
|
|
|
|
defined('ABSPATH') || exit;
|
|
|
|
class AKSRT_Admin_Import_Export_Controller extends AKSRT_Admin_Controller_Base {
|
|
use AKSRT_Admin_Import_Export_Controller_Part_1;
|
|
use AKSRT_Admin_Import_Export_Controller_Part_2;
|
|
|
|
|
|
private static $instance = null;
|
|
private const SCHEDULED_BACKUP_HOOK = 'aksrt_settings_scheduled_backup';
|
|
private const MONTHLY_SCHEDULE = 'aksrt_monthly';
|
|
|
|
private function __construct() {
|
|
add_filter('cron_schedules', [$this, 'register_backup_schedules']);
|
|
add_action('init', [$this, 'sync_backup_schedule']);
|
|
add_action(self::SCHEDULED_BACKUP_HOOK, [$this, 'run_scheduled_backup']);
|
|
add_filter('upgrader_pre_install', [$this, 'handle_theme_upgrade_snapshot'], 10, 2);
|
|
add_action('switch_theme', [$this, 'clear_backup_schedule']);
|
|
}
|
|
|
|
public static function get_instance(): self {
|
|
if (null === self::$instance) self::$instance = new self();
|
|
return self::$instance;
|
|
}
|
|
|
|
/**
|
|
* Register REST routes for import/export operations.
|
|
*/
|
|
public function register_routes(): void {
|
|
// Export all settings
|
|
register_rest_route(self::API_NAMESPACE, '/settings/export', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'rest_export_settings'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Import settings
|
|
register_rest_route(self::API_NAMESPACE, '/settings/import', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'rest_import_settings'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Reset a domain to defaults
|
|
register_rest_route(self::API_NAMESPACE, '/settings/reset/(?P<domain>[a-z_]+)', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'rest_reset_domain'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Reset all schema-managed settings to defaults
|
|
register_rest_route(self::API_NAMESPACE, '/settings/reset-all', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'rest_reset_all'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Health check / diagnostics
|
|
register_rest_route(self::API_NAMESPACE, '/settings/health', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'rest_health_check'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Migration status
|
|
register_rest_route(self::API_NAMESPACE, '/settings/migration-status', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'rest_migration_status'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Schema introspection (for frontend to discover available fields)
|
|
register_rest_route(self::API_NAMESPACE, '/settings/schema/(?P<domain>[a-z_]+)', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'rest_get_schema'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
register_rest_route(self::API_NAMESPACE, '/settings/schema/(?P<domain>[a-z_]+)/(?P<section>[a-z0-9_-]+)', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'rest_get_schema_section'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
register_rest_route(self::API_NAMESPACE, '/settings/schema/(?P<domain>[a-z_]+)/(?P<section>[a-z0-9_-]+)', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'rest_save_schema_section'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Backup snapshots
|
|
register_rest_route(self::API_NAMESPACE, '/settings/backups', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'list_setting_backups'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
register_rest_route(self::API_NAMESPACE, '/settings/backups', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'create_setting_backup'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
register_rest_route(self::API_NAMESPACE, '/settings/backups/(?P<id>\d+)/restore', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'restore_setting_backup'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
register_rest_route(self::API_NAMESPACE, '/settings/backups/(?P<id>\d+)', [
|
|
'methods' => 'DELETE',
|
|
'callback' => [$this, 'delete_setting_backup'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// ── Widget Template Management ──
|
|
|
|
// Export current widget configuration
|
|
register_rest_route(self::API_NAMESPACE, '/widgets/export', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'export_widgets'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Import widget configuration
|
|
register_rest_route(self::API_NAMESPACE, '/widgets/import', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'import_widgets'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// List saved widget templates
|
|
register_rest_route(self::API_NAMESPACE, '/widgets/templates', [
|
|
'methods' => 'GET',
|
|
'callback' => [$this, 'list_widget_templates'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Save current layout as a named template
|
|
register_rest_route(self::API_NAMESPACE, '/widgets/templates', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'save_widget_template'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Apply a saved template
|
|
register_rest_route(self::API_NAMESPACE, '/widgets/templates/(?P<id>\d+)/apply', [
|
|
'methods' => 'POST',
|
|
'callback' => [$this, 'apply_widget_template'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
|
|
// Delete a saved template
|
|
register_rest_route(self::API_NAMESPACE, '/widgets/templates/(?P<id>\d+)', [
|
|
'methods' => 'DELETE',
|
|
'callback' => [$this, 'delete_widget_template'],
|
|
'permission_callback' => [$this, 'check_permission'],
|
|
]);
|
|
}
|
|
|
|
/* ------------------------------------------------------------------ */
|
|
/* Handlers */
|
|
/* ------------------------------------------------------------------ */
|
|
|
|
/**
|
|
* Export all AKSRT settings as a JSON-serializable array.
|
|
*/
|
|
public function rest_export_settings(WP_REST_Request $request): WP_REST_Response {
|
|
$schema_provider = AKSRT_Admin_Schema_Provider::get_instance();
|
|
$domains = $schema_provider->get_domain_keys();
|
|
|
|
$export = [
|
|
'version' => AKSRT_VERSION ?? '3.4.0',
|
|
'exported' => gmdate('Y-m-d H:i:s'),
|
|
'domains' => [],
|
|
];
|
|
|
|
foreach ($domains as $domain) {
|
|
$export['domains'][$domain] = [
|
|
'option_key' => $schema_provider->get_option_key($domain),
|
|
'data' => $schema_provider->read_settings($domain),
|
|
];
|
|
}
|
|
|
|
// Also export standalone options from the registry
|
|
$standalone_keys = AKSRT_Settings::STANDALONE_OPTION_KEYS;
|
|
|
|
$export['standalone'] = [];
|
|
foreach ($standalone_keys as $key) {
|
|
$val = get_option($key);
|
|
if ($val !== false) {
|
|
$export['standalone'][$key] = $val;
|
|
}
|
|
}
|
|
|
|
return $this->success(['data' => $export]);
|
|
}
|
|
|
|
/**
|
|
* Import settings from a JSON payload.
|
|
*
|
|
* Request body: { domains: { domain: { data: {...} } }, standalone: { key: value } }
|
|
* Optional: { dry_run: true } to validate without saving.
|
|
*/
|
|
public function rest_import_settings(WP_REST_Request $request): WP_REST_Response {
|
|
$params = $this->get_json_params($request);
|
|
$dry_run = !empty($params['dry_run']);
|
|
|
|
if (empty($params['domains']) && empty($params['standalone'])) {
|
|
return $this->error('没有可导入的数据');
|
|
}
|
|
|
|
$schema_provider = AKSRT_Admin_Schema_Provider::get_instance();
|
|
$results = [];
|
|
|
|
// Import domain settings
|
|
if (!$dry_run) {
|
|
$backup = $this->create_backup_record('manual', __('导入前自动快照', 'aksrt'));
|
|
$this->persist_setting_backup($backup);
|
|
}
|
|
|
|
// Import domain settings
|
|
if (!empty($params['domains']) && is_array($params['domains'])) {
|
|
foreach ($params['domains'] as $domain => $payload) {
|
|
$data = $payload['data'] ?? $payload;
|
|
if (!is_array($data)) {
|
|
$results[$domain] = ['status' => 'error', 'message' => 'Invalid data format'];
|
|
continue;
|
|
}
|
|
|
|
// Validate
|
|
$validation = $schema_provider->validate($domain, $data);
|
|
if (!$validation['valid']) {
|
|
$results[$domain] = ['status' => 'error', 'errors' => $validation['errors']];
|
|
continue;
|
|
}
|
|
|
|
if (!$dry_run) {
|
|
$schema_provider->write_settings($domain, $data);
|
|
$results[$domain] = ['status' => 'imported'];
|
|
} else {
|
|
$results[$domain] = ['status' => 'valid'];
|
|
}
|
|
}
|
|
}
|
|
|
|
// Import standalone options
|
|
if (!empty($params['standalone']) && is_array($params['standalone'])) {
|
|
foreach ($params['standalone'] as $key => $value) {
|
|
if (!preg_match('/^aksrt_/', $key)) {
|
|
$results[$key] = ['status' => 'skipped', 'message' => 'Not an AKSRT option'];
|
|
continue;
|
|
}
|
|
if (!$dry_run) {
|
|
update_option($key, $value);
|
|
$results[$key] = ['status' => 'imported'];
|
|
} else {
|
|
$results[$key] = ['status' => 'valid'];
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!$dry_run) {
|
|
AKSRT_Settings::flush_settings_cache();
|
|
}
|
|
|
|
return $this->success([
|
|
'dry_run' => $dry_run,
|
|
'results' => $results,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Reset a domain's settings to defaults.
|
|
*/
|
|
public function rest_reset_domain(WP_REST_Request $request): WP_REST_Response {
|
|
$domain = $request->get_param('domain');
|
|
$schema_provider = AKSRT_Admin_Schema_Provider::get_instance();
|
|
|
|
if (!in_array($domain, $schema_provider->get_domain_keys(), true)) {
|
|
return $this->error('未知的设置域: ' . esc_html($domain), 404);
|
|
}
|
|
|
|
$backup = $this->create_backup_record('reset_domain', sprintf(__('重置 %s 前快照', 'aksrt'), $domain));
|
|
$this->persist_setting_backup($backup);
|
|
|
|
$schema_provider->reset_to_defaults($domain);
|
|
|
|
return $this->success([
|
|
'message' => sprintf('%s 域设置已重置为默认值', $domain),
|
|
'data' => [
|
|
'backup_id' => $backup['id'],
|
|
],
|
|
]);
|
|
}
|
|
|
|
public function rest_reset_all(WP_REST_Request $request): WP_REST_Response {
|
|
$schema_provider = AKSRT_Admin_Schema_Provider::get_instance();
|
|
$backup = $this->create_backup_record('reset_all', __('重置全部前快照', 'aksrt'));
|
|
$this->persist_setting_backup($backup);
|
|
|
|
foreach ($schema_provider->get_domain_keys() as $domain) {
|
|
$schema_provider->reset_to_defaults($domain);
|
|
}
|
|
|
|
AKSRT_Settings::flush_settings_cache();
|
|
|
|
return $this->success([
|
|
'message' => __('全部 schema 托管设置已重置为默认值', 'aksrt'),
|
|
'data' => [
|
|
'backup_id' => $backup['id'],
|
|
],
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Health check — returns system diagnostics.
|
|
*/
|
|
public function rest_health_check(WP_REST_Request $request): WP_REST_Response {
|
|
global $wpdb;
|
|
|
|
$checks = [];
|
|
|
|
// PHP version
|
|
$checks['php_version'] = [
|
|
'label' => 'PHP 版本',
|
|
'value' => PHP_VERSION,
|
|
'status' => version_compare(PHP_VERSION, '8.1', '>=') ? 'ok' : 'warning',
|
|
];
|
|
|
|
// WordPress version
|
|
$wp_version = get_bloginfo('version');
|
|
$checks['wp_version'] = [
|
|
'label' => 'WordPress 版本',
|
|
'value' => $wp_version,
|
|
'status' => version_compare($wp_version, '6.4', '>=') ? 'ok' : 'warning',
|
|
];
|
|
|
|
// Theme version
|
|
$theme = wp_get_theme();
|
|
$checks['theme_version'] = [
|
|
'label' => '主题版本',
|
|
'value' => $theme->get('Version') ?? 'unknown',
|
|
'status' => 'ok',
|
|
];
|
|
|
|
// Database tables
|
|
$expected_tables = [
|
|
$wpdb->prefix . 'aksrt_credit_log',
|
|
$wpdb->prefix . 'aksrt_signin_log',
|
|
$wpdb->prefix . 'aksrt_invite',
|
|
$wpdb->prefix . 'aksrt_dl_token',
|
|
$wpdb->prefix . 'aksrt_notification',
|
|
];
|
|
$missing_tables = [];
|
|
foreach ($expected_tables as $table) {
|
|
if ($wpdb->get_var($wpdb->prepare('SHOW TABLES LIKE %s', $table)) !== $table) {
|
|
$missing_tables[] = str_replace($wpdb->prefix, '', $table);
|
|
}
|
|
}
|
|
$checks['db_tables'] = [
|
|
'label' => '数据表',
|
|
'value' => empty($missing_tables) ? '全部就绪' : '缺少: ' . implode(', ', $missing_tables),
|
|
'status' => empty($missing_tables) ? 'ok' : 'error',
|
|
];
|
|
|
|
// Email verification backfill
|
|
$backfill_done = get_option('aksrt_email_verification_backfill_done', false);
|
|
$checks['email_backfill'] = [
|
|
'label' => '邮箱验证迁移',
|
|
'value' => $backfill_done ? '已完成' : '未完成',
|
|
'status' => $backfill_done ? 'ok' : 'info',
|
|
];
|
|
|
|
// Avatar source
|
|
$avatar_source = AKSRT_Settings::get_all()['avatar_source'] ?? 'cn.cravatar.com';
|
|
$checks['avatar_source'] = [
|
|
'label' => '头像服务',
|
|
'value' => $avatar_source,
|
|
'status' => $avatar_source === 'cn.cravatar.com' ? 'ok' : 'info',
|
|
];
|
|
|
|
// Option count
|
|
$option_count = (int) $wpdb->get_var(
|
|
"SELECT COUNT(*) FROM {$wpdb->options} WHERE option_name LIKE 'aksrt_%'"
|
|
);
|
|
$checks['option_count'] = [
|
|
'label' => 'AKSRT 选项数',
|
|
'value' => $option_count,
|
|
'status' => $option_count < 100 ? 'ok' : 'warning',
|
|
];
|
|
|
|
return $this->success(['checks' => $checks]);
|
|
}
|
|
|
|
/**
|
|
* Migration status — reports schema version and pending migrations.
|
|
*/
|
|
}
|