%s
', esc_html( sprintf( _n( '%d table renamed successfully.', '%d tables renamed successfully.', $count, 'robotstxt-mlp2-mlp5' ), $count ) ) ); // phpcs:ignore WordPress.WP.I18n.MismatchedPlaceholders + } + if ( isset( $_GET['rename_errors'] ) ) { + $count = (int) $_GET['rename_errors']; + /* translators: %d: number of tables that could not be renamed */ + printf( '%s
%s
%s
%s
%s
%s
| + | + + ● + + ✓ + + | +
| + | + + ✓ + + — + + | +
| + | + + ✓ get_version() ) ); ?> + + — + + | +
+
+
+ + + + + get_results( "SELECT site_1, site_2 FROM `{$table}`", ARRAY_A ); + + if ( empty( $rows ) ) { + return array(); + } + + $ids = array(); + foreach ( $rows as $row ) { + $ids[] = (int) $row['site_1']; + $ids[] = (int) $row['site_2']; + } + $ids = array_unique( $ids ); + + $existing = get_sites( + array( + 'site__in' => $ids, + 'fields' => 'ids', + 'number' => count( $ids ), + ) + ); + $existing = array_map( 'intval', $existing ); + + return array_values( array_diff( $ids, $existing ) ); + } + + /** + * Sample up to $sample content relation rows and count orphaned elements. + * + * @param string $table MLP2 backup content relations table name. + * @param string $type 'post' or 'term'. + * @param int $sample Maximum rows to inspect. + * @return int Count of orphaned references found in the sample. + */ + private static function detect_orphaned_content( string $table, string $type, int $sample ): int { + if ( '' === $table ) { + return 0; + } + + global $wpdb; + + $type_safe = ( 'term' === $type ) ? 'term' : 'post'; + + // phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + $rows = $wpdb->get_results( + $wpdb->prepare( + "SELECT ml_blogid, ml_elementid FROM `{$table}` WHERE ml_type = %s LIMIT %d", + $type_safe, + $sample + ), + ARRAY_A + ); + // phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + + if ( empty( $rows ) ) { + return 0; + } + + $orphans = 0; + foreach ( $rows as $row ) { + $site_id = (int) $row['ml_blogid']; + $element_id = (int) $row['ml_elementid']; + + if ( ! get_site( $site_id ) ) { + ++$orphans; + continue; + } + + switch_to_blog( $site_id ); + if ( 'term' === $type_safe ) { + $exists = (bool) get_term( $element_id ); + } else { + $exists = (bool) get_post( $element_id ); + } + restore_current_blog(); + + if ( ! $exists ) { + ++$orphans; + } + } + + return $orphans; + } + + /** + * Count duplicate rows in the content relations table. + * + * @param string $table MLP2 backup content relations table name. + * @return int Count of duplicate rows. + */ + private static function count_duplicate_relations( string $table ): int { + if ( '' === $table ) { + return 0; + } + + global $wpdb; + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + $total = (int) $wpdb->get_var( "SELECT COUNT(*) FROM `{$table}`" ); + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + $distinct = (int) $wpdb->get_var( "SELECT COUNT(*) FROM (SELECT DISTINCT ml_source_blogid, ml_source_elementid, ml_blogid, ml_elementid, ml_type FROM `{$table}`) AS d" ); + + return max( 0, $total - $distinct ); + } + + /** + * Validate that MLP5 tables have the expected columns. + * + * @param string $mlp5_site MLP5 site relations table. + * @param string $mlp5_content MLP5 content relations table. + * @param string $mlp5_rel MLP5 relationships table. + * @param Robotstxt_Mlp2_Mlp5_Detector_Mlp2 $mlp2 MLP2 detector. + * @param string $mlp2_site MLP2 backup site relations table. + * @param string $mlp2_content MLP2 backup content relations table. + * @return array [ bool $ok, string $error_message ] + */ + private static function validate_mlp5_schema( + string $mlp5_site, + string $mlp5_content, + string $mlp5_rel, + Robotstxt_Mlp2_Mlp5_Detector_Mlp2 $mlp2, + string $mlp2_site, + string $mlp2_content + ): array { + if ( '' === $mlp5_site || '' === $mlp5_content ) { + return array( false, __( 'MLP5 tables not found. Ensure MultilingualPress 5 is active and has been initialized.', 'robotstxt-mlp2-mlp5' ) ); + } + + // Site relations: expect site_1 and site_2 columns. + $site_cols = $mlp2->describe_table( $mlp5_site ); + if ( ! isset( $site_cols['site_1'], $site_cols['site_2'] ) ) { + return array( false, sprintf( /* translators: %s: table name */ __( 'Table %s does not have expected columns (site_1, site_2).', 'robotstxt-mlp2-mlp5' ), $mlp5_site ) ); + } + + // Content relations: expect relationship_id, site_id, content_id. + $content_cols = $mlp2->describe_table( $mlp5_content ); + if ( ! isset( $content_cols['relationship_id'], $content_cols['site_id'], $content_cols['content_id'] ) ) { + return array( false, sprintf( /* translators: %s: table name */ __( 'Table %s does not have expected columns (relationship_id, site_id, content_id).', 'robotstxt-mlp2-mlp5' ), $mlp5_content ) ); + } + + // Relationships group table: expect id and type columns. + if ( '' !== $mlp5_rel ) { + $rel_cols = $mlp2->describe_table( $mlp5_rel ); + if ( ! isset( $rel_cols['id'], $rel_cols['type'] ) ) { + return array( false, sprintf( /* translators: %s: table name */ __( 'Table %s does not have expected columns (id, type).', 'robotstxt-mlp2-mlp5' ), $mlp5_rel ) ); + } + } + + // MLP2 backup: check the content table has the known columns. + if ( '' !== $mlp2_content ) { + $mlp2_cols = $mlp2->describe_table( $mlp2_content ); + $required = array( 'ml_blogid', 'ml_elementid', 'ml_type' ); + foreach ( $required as $col ) { + if ( ! isset( $mlp2_cols[ $col ] ) ) { + return array( false, sprintf( /* translators: 1: column name, 2: table name */ __( 'MLP2 backup table %2$s is missing expected column "%1$s". Schema may differ from expected.', 'robotstxt-mlp2-mlp5' ), $col, $mlp2_content ) ); + } + } + } + + return array( true, '' ); + } + + /** + * Detect the source-blog column name for the MLP2 content relations table. + * + * @param Robotstxt_Mlp2_Mlp5_Detector_Mlp2 $mlp2 MLP2 detector. + * @param string $table Content relations table name. + * @return string Column name or empty string. + */ + private static function source_blog_col( Robotstxt_Mlp2_Mlp5_Detector_Mlp2 $mlp2, string $table ): string { + $cols = $mlp2->describe_table( $table ); + foreach ( array( 'ml_source_blogid', 'ml_blogid' ) as $candidate ) { + if ( isset( $cols[ $candidate ] ) ) { + return $candidate; + } + } + return ''; + } + + /** + * Detect the source-element column name for the MLP2 content relations table. + * + * @param Robotstxt_Mlp2_Mlp5_Detector_Mlp2 $mlp2 MLP2 detector. + * @param string $table Content relations table name. + * @return string Column name or empty string. + */ + private static function source_element_col( Robotstxt_Mlp2_Mlp5_Detector_Mlp2 $mlp2, string $table ): string { + $cols = $mlp2->describe_table( $table ); + foreach ( array( 'ml_source_elementid', 'ml_elementid' ) as $candidate ) { + if ( isset( $cols[ $candidate ] ) ) { + return $candidate; + } + } + return ''; + } +} diff --git a/includes/class-robotstxt-mlp2-mlp5-step-cleanup.php b/includes/class-robotstxt-mlp2-mlp5-step-cleanup.php new file mode 100644 index 0000000..b58faf3 --- /dev/null +++ b/includes/class-robotstxt-mlp2-mlp5-step-cleanup.php @@ -0,0 +1,194 @@ +is_active() ) { + Robotstxt_Mlp2_Mlp5_Logger::log( 'skipped', 'cleanup', null, null, __( 'MLP2 deactivation: plugin is already inactive.', 'robotstxt-mlp2-mlp5' ) ); + return 'skipped'; + } + + if ( ! function_exists( 'deactivate_plugins' ) ) { + require_once ABSPATH . 'wp-admin/includes/plugin.php'; + } + + deactivate_plugins( $mlp2->get_plugin_file(), true ); + Robotstxt_Mlp2_Mlp5_Logger::log( 'success', 'cleanup', null, null, __( 'MLP2 plugin deactivated network-wide.', 'robotstxt-mlp2-mlp5' ) ); + return 'success'; + } + + /** + * Drop all MLP2 backup tables ({prefix}mlp2bak_*). + * + * Each table drop is logged individually. + * + * @return array { @type int $dropped, @type int $errors } + */ + public static function drop_backup_tables(): array { + global $wpdb; + + $tables = Robotstxt_Mlp2_Mlp5_Table_Preparer::get_backup_tables(); + $dropped = 0; + $errors = 0; + + foreach ( $tables as $table ) { + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.SchemaChange, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + $result = $wpdb->query( "DROP TABLE IF EXISTS `{$table}`" ); + + if ( false === $result ) { + Robotstxt_Mlp2_Mlp5_Logger::log( 'error', 'cleanup', null, null, sprintf( /* translators: %s: table name */ __( 'Failed to drop backup table: %s', 'robotstxt-mlp2-mlp5' ), $table ) ); + ++$errors; + } else { + Robotstxt_Mlp2_Mlp5_Logger::log( 'success', 'cleanup', null, null, sprintf( /* translators: %s: table name */ __( 'Backup table dropped: %s', 'robotstxt-mlp2-mlp5' ), $table ) ); + ++$dropped; + } + } + + return array( + 'dropped' => $dropped, + 'errors' => $errors, + ); + } + + /** + * Delete MLP2-related entries from wp_sitemeta. + * + * Removes all sitemeta keys whose name starts with 'mlp_' (MLP2 prefix). + * + * @return int Number of keys deleted. + */ + public static function remove_mlp2_sitemeta(): int { + global $wpdb; + + $like = $wpdb->esc_like( 'mlp_' ) . '%'; + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $keys = $wpdb->get_col( + $wpdb->prepare( + "SELECT meta_key FROM {$wpdb->sitemeta} WHERE meta_key LIKE %s AND site_id = %d", + $like, + get_current_network_id() + ) + ); + + $deleted = 0; + foreach ( (array) $keys as $key ) { + if ( delete_site_option( $key ) ) { + ++$deleted; + } + } + + Robotstxt_Mlp2_Mlp5_Logger::log( 'success', 'cleanup', null, null, sprintf( /* translators: %d: key count */ __( 'Removed %d MLP2 sitemeta entries.', 'robotstxt-mlp2-mlp5' ), $deleted ) ); + return $deleted; + } + + /** + * Render the Step 6 UI. + */ + public static function render(): void { + $backup_tables = Robotstxt_Mlp2_Mlp5_Table_Preparer::get_backup_tables(); + $mlp2 = new Robotstxt_Mlp2_Mlp5_Detector_Mlp2(); + ?> + + ++
+ ' . esc_html( number_format_i18n( $progress['processed'] ) ) . '', + '' . esc_html( number_format_i18n( $progress['total'] ) ) . '' + ); + ?> +
+ ++ + + +
+ + + + + + + + 'success' ) ); + $skipped = Robotstxt_Mlp2_Mlp5_Logger::count( array( 'type' => 'skipped' ) ); + $errors = Robotstxt_Mlp2_Mlp5_Logger::count( array( 'type' => 'error' ) ); + + // Subtract site_relation log entries (those belong to step 3). + $migrated -= Robotstxt_Mlp2_Mlp5_Logger::count( + array( + 'type' => 'success', + 'context' => 'site_relation', + ) + ); + $skipped -= Robotstxt_Mlp2_Mlp5_Logger::count( + array( + 'type' => 'skipped', + 'context' => 'site_relation', + ) + ); + $errors -= Robotstxt_Mlp2_Mlp5_Logger::count( + array( + 'type' => 'error', + 'context' => 'site_relation', + ) + ); + + return array( + 'total' => $post_total + $term_total, + 'processed' => $post_offset + $term_offset, + 'migrated' => max( 0, $migrated ), + 'skipped' => max( 0, $skipped ), + 'errors' => max( 0, $errors ), + 'done' => $post_done && $term_done, + ); + } +} diff --git a/includes/class-robotstxt-mlp2-mlp5-step-preflight.php b/includes/class-robotstxt-mlp2-mlp5-step-preflight.php new file mode 100644 index 0000000..fd4f337 --- /dev/null +++ b/includes/class-robotstxt-mlp2-mlp5-step-preflight.php @@ -0,0 +1,142 @@ + 0; + $original_present = Robotstxt_Mlp2_Mlp5_Table_Preparer::has_original_tables(); + $mlp5_active = $mlp5->is_active(); + + if ( ! $tables_renamed ) { + if ( $original_present ) { + $issues[] = __( 'MLP2 tables have not been renamed yet. Go back to the plugin status page and click "Rename MLP2 tables".', 'robotstxt-mlp2-mlp5' ); + } else { + $issues[] = __( 'No MLP2 tables found (neither original nor backup). Restore your database from a backup before proceeding.', 'robotstxt-mlp2-mlp5' ); + } + } + + if ( ! $mlp5_active ) { + $issues[] = __( 'MultilingualPress 5 is not network-active. Activate it before running the migration.', 'robotstxt-mlp2-mlp5' ); + } + + return array( + 'mlp2_tables_renamed' => $tables_renamed, + 'mlp2_original_present' => $original_present, + 'mlp2_backup_tables' => $backup_tables, + 'mlp2_active' => $mlp2->is_active(), + 'mlp2_version' => $mlp2->get_version(), + 'mlp5_active' => $mlp5_active, + 'mlp5_version' => $mlp5->get_version(), + 'can_proceed' => $tables_renamed && $mlp5_active, + 'blocking_issues' => $issues, + ); + } + + /** + * Render the Step 1 UI. + */ + public static function render(): void { + $checks = self::run(); + $can_proceed = $checks['can_proceed']; + ?> + + +| + | + + ✓ + + ✗ + + ✗ + + | +
| + | + + ⚠ + + ✓ + + | +
| + | + + ✓ + + ✗ + + | +
+
+ + + + + + array( + 'label' => __( 'Site Relations', 'robotstxt-mlp2-mlp5' ), + 'expected' => (int) ( $analysis['site_relations_count'] ?? 0 ), + ), + 'post_relation' => array( + 'label' => __( 'Post Relations', 'robotstxt-mlp2-mlp5' ), + 'expected' => (int) ( $analysis['post_groups_count'] ?? 0 ), + ), + 'term_relation' => array( + 'label' => __( 'Term Relations', 'robotstxt-mlp2-mlp5' ), + 'expected' => (int) ( $analysis['term_groups_count'] ?? 0 ), + ), + ); + + $summary = array(); + foreach ( $contexts as $context => $meta ) { + $summary[ $context ] = array( + 'label' => $meta['label'], + 'expected' => $meta['expected'], + 'migrated' => Robotstxt_Mlp2_Mlp5_Logger::count( + array( + 'type' => 'success', + 'context' => $context, + ) + ), + 'skipped' => Robotstxt_Mlp2_Mlp5_Logger::count( + array( + 'type' => 'skipped', + 'context' => $context, + ) + ), + 'errors' => Robotstxt_Mlp2_Mlp5_Logger::count( + array( + 'type' => 'error', + 'context' => $context, + ) + ), + ); + } + + return $summary; + } + + /** + * Handle the CSV export request. + * + * Must be called on network_admin_init when the export GET param is present. + */ + public static function maybe_export_csv(): void { + check_admin_referer( 'mlp_migrator_export_log', 'mlp_export_nonce' ); + + if ( ! current_user_can( 'manage_network' ) ) { + wp_die( esc_html__( 'You do not have permission to export the log.', 'robotstxt-mlp2-mlp5' ) ); + } + + $csv = Robotstxt_Mlp2_Mlp5_Logger::export_csv(); + + header( 'Content-Type: text/csv; charset=UTF-8' ); + header( 'Content-Disposition: attachment; filename="mlp-migration-log.csv"' ); + header( 'Pragma: no-cache' ); + // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped + echo $csv; + exit; + } + + /** + * Render the Step 5 UI. + */ + public static function render(): void { + $summary = self::get_summary(); + $export_url = wp_nonce_url( + admin_url( 'admin-post.php?action=mlp_migrator_export_log' ), + 'mlp_migrator_export_log', + 'mlp_export_nonce' + ); + ?> + + + +| + | + | + | + | + |
|---|---|---|---|---|
| + | + | + | + | + |
+ + + +
+ + + base_prefix . self::ORIGINAL_FRAGMENT; + + if ( ! str_starts_with( $original_table, $orig_prefix ) ) { + return ''; + } + + return $wpdb->base_prefix . self::BACKUP_FRAGMENT . substr( $original_table, strlen( $orig_prefix ) ); + } + + /** + * Return the original table name for a given backup table. + * + * @param string $backup_table Full backup table name (including base_prefix). + * @return string Original table name, or empty string if not a backup table. + */ + public static function original_name( string $backup_table ): string { + global $wpdb; + + $bak_prefix = $wpdb->base_prefix . self::BACKUP_FRAGMENT; + + if ( ! str_starts_with( $backup_table, $bak_prefix ) ) { + return ''; + } + + return $wpdb->base_prefix . self::ORIGINAL_FRAGMENT . substr( $backup_table, strlen( $bak_prefix ) ); + } + + /** + * Return all tables in the database with the original MLP2 prefix. + * + * @return string[] Array of full table names. + */ + public static function get_original_tables(): array { + global $wpdb; + + $like = $wpdb->esc_like( $wpdb->base_prefix . self::ORIGINAL_FRAGMENT ) . '%'; + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $tables = $wpdb->get_col( $wpdb->prepare( 'SHOW TABLES LIKE %s', $like ) ); + + return is_array( $tables ) ? $tables : array(); + } + + /** + * Return all tables in the database with the backup prefix. + * + * @return string[] Array of full table names. + */ + public static function get_backup_tables(): array { + global $wpdb; + + $like = $wpdb->esc_like( $wpdb->base_prefix . self::BACKUP_FRAGMENT ) . '%'; + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $tables = $wpdb->get_col( $wpdb->prepare( 'SHOW TABLES LIKE %s', $like ) ); + + return is_array( $tables ) ? $tables : array(); + } + + /** + * Whether any original MLP2 tables exist in the database. + * + * @return bool + */ + public static function has_original_tables(): bool { + return count( self::get_original_tables() ) > 0; + } + + /** + * Whether any backup (renamed) MLP2 tables exist in the database. + * + * @return bool + */ + public static function has_backup_tables(): bool { + return count( self::get_backup_tables() ) > 0; + } + + /** + * Rename all original MLP2 tables to their backup equivalents. + * + * Tables that already have a backup copy are skipped. Tables that cannot + * be converted to a valid backup name are recorded as errors. + * + * @return array { + * @type string[] $renamed Tables successfully renamed. + * @type string[] $skipped Tables skipped (backup name already exists). + * @type string[] $errors Tables that could not be renamed. + * } + */ + public static function rename_to_backup(): array { + global $wpdb; + + $result = array( + 'renamed' => array(), + 'skipped' => array(), + 'errors' => array(), + ); + + foreach ( self::get_original_tables() as $table ) { + $backup = self::backup_name( $table ); + + if ( '' === $backup ) { + $result['errors'][] = $table; + continue; + } + + // Skip tables that belong to this plugin. + $suffix = substr( $table, strlen( $wpdb->base_prefix . self::ORIGINAL_FRAGMENT ) ); + if ( in_array( $suffix, self::PLUGIN_TABLE_SUFFIXES, true ) ) { + $result['skipped'][] = $table; + continue; + } + + if ( self::table_exists( $backup ) ) { + $result['skipped'][] = $table; + continue; + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.SchemaChange, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + $renamed = $wpdb->query( "RENAME TABLE `{$table}` TO `{$backup}`" ); + + if ( false === $renamed ) { + $result['errors'][] = $table; + } else { + $result['renamed'][] = $table; + } + } + + return $result; + } + + /** + * Restore backup tables to their original names. + * + * Intended as a recovery mechanism if the rename needs to be undone before + * MLP5 has been activated. Tables whose original name already exists in the + * database are skipped. + * + * @return array { + * @type string[] $restored Tables successfully restored. + * @type string[] $skipped Tables skipped (original name already exists). + * @type string[] $errors Tables that could not be restored. + * } + */ + public static function restore_from_backup(): array { + global $wpdb; + + $result = array( + 'restored' => array(), + 'skipped' => array(), + 'errors' => array(), + ); + + foreach ( self::get_backup_tables() as $table ) { + $original = self::original_name( $table ); + + if ( '' === $original ) { + $result['errors'][] = $table; + continue; + } + + if ( self::table_exists( $original ) ) { + $result['skipped'][] = $table; + continue; + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.SchemaChange, WordPress.DB.PreparedSQL.InterpolatedNotPrepared + $restored = $wpdb->query( "RENAME TABLE `{$table}` TO `{$original}`" ); + + if ( false === $restored ) { + $result['errors'][] = $table; + } else { + $result['restored'][] = $table; + } + } + + return $result; + } + + /** + * Check whether a table exists in the database. + * + * @param string $table Full table name. + * @return bool + */ + private static function table_exists( string $table ): bool { + global $wpdb; + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + return (string) $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $table ) ) === $table; + } +} diff --git a/includes/class-robotstxt-mlp2-mlp5-wizard-state.php b/includes/class-robotstxt-mlp2-mlp5-wizard-state.php new file mode 100644 index 0000000..a044373 --- /dev/null +++ b/includes/class-robotstxt-mlp2-mlp5-wizard-state.php @@ -0,0 +1,151 @@ +get_content_relations_table(); + + if ( '' === $table ) { + return false; + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $found = (int) $wpdb->get_var( + $wpdb->prepare( + // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared + "SELECT COUNT(*) FROM `{$table}` WHERE site_id = %d AND content_id = %d", + $site_id, + $content_id + ) + ); + + return $found > 0; + } + + /** + * Create a relationship group in MLP5 for the given members. + * + * Inserts one row into mlp_relationships and one row per member into + * mlp_content_relations. Wrapped in a transaction for atomicity. + * + * @param string $type WordPress content type: post type slug or taxonomy name. + * Pass 'post' for standard posts, 'term' for terms. + * @param array[] $members Array of ['site_id' => int, 'element_id' => int]. + * @return bool True on success, false on any DB error. + */ + public static function create_group( string $type, array $members ): bool { + global $wpdb; + + $mlp5 = new Robotstxt_Mlp2_Mlp5_Detector_Mlp5(); + $rel_table = $mlp5->get_relationships_table(); + $cont_table = $mlp5->get_content_relations_table(); + + if ( '' === $rel_table || '' === $cont_table ) { + return false; + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $wpdb->query( 'START TRANSACTION' ); + + // Insert relationship group. + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $inserted = $wpdb->insert( + $rel_table, + array( 'type' => $type ), + array( '%s' ) + ); + + if ( false === $inserted ) { + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $wpdb->query( 'ROLLBACK' ); + return false; + } + + $relationship_id = (int) $wpdb->insert_id; + + // Insert each member. + foreach ( $members as $member ) { + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $ok = $wpdb->insert( + $cont_table, + array( + 'relationship_id' => $relationship_id, + 'site_id' => (int) $member['site_id'], + 'content_id' => (int) $member['element_id'], + ), + array( '%d', '%d', '%d' ) + ); + + if ( false === $ok ) { + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $wpdb->query( 'ROLLBACK' ); + return false; + } + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $wpdb->query( 'COMMIT' ); + return true; + } +} diff --git a/includes/class-robotstxt-mlp2-mlp5-writer-site-relations.php b/includes/class-robotstxt-mlp2-mlp5-writer-site-relations.php new file mode 100644 index 0000000..6ae84d6 --- /dev/null +++ b/includes/class-robotstxt-mlp2-mlp5-writer-site-relations.php @@ -0,0 +1,96 @@ +get_site_relations_table(); + + if ( '' === $table ) { + return false; + } + + // Normalise: site_1 must be the lower value. + if ( $site_1 > $site_2 ) { + list( $site_1, $site_2 ) = array( $site_2, $site_1 ); + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $found = $wpdb->get_var( + $wpdb->prepare( + // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared + "SELECT COUNT(*) FROM `{$table}` WHERE site_1 = %d AND site_2 = %d", + $site_1, + $site_2 + ) + ); + + return (int) $found > 0; + } + + /** + * Write a site relation to MLP5. + * + * Normalises site IDs (smaller value in site_1) before inserting. + * Returns false if the target table does not exist. + * + * @param int $site_1 First site ID. + * @param int $site_2 Second site ID. + * @return bool True on success, false on failure. + */ + public static function write_relation( int $site_1, int $site_2 ): bool { + global $wpdb; + + $mlp5 = new Robotstxt_Mlp2_Mlp5_Detector_Mlp5(); + $table = $mlp5->get_site_relations_table(); + + if ( '' === $table ) { + return false; + } + + // Normalise. + if ( $site_1 > $site_2 ) { + list( $site_1, $site_2 ) = array( $site_2, $site_1 ); + } + + // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching + $result = $wpdb->insert( + $table, + array( + 'site_1' => $site_1, + 'site_2' => $site_2, + ), + array( '%d', '%d' ) + ); + + return false !== $result; + } +} diff --git a/includes/class-robotstxt-mlp2-mlp5.php b/includes/class-robotstxt-mlp2-mlp5.php new file mode 100644 index 0000000..801a0f0 --- /dev/null +++ b/includes/class-robotstxt-mlp2-mlp5.php @@ -0,0 +1,115 @@ +register_hooks(); + } + + /** + * Constructor. + * + * @param string $plugin_file Absolute path to the main plugin file. + */ + private function __construct( string $plugin_file ) { + $this->plugin_file = $plugin_file; + } + + /** + * Register WordPress hooks. + */ + private function register_hooks(): void { + register_activation_hook( $this->plugin_file, array( $this, 'activate' ) ); + register_deactivation_hook( $this->plugin_file, array( $this, 'deactivate' ) ); + add_action( 'admin_notices', array( $this, 'multisite_notice' ) ); + add_action( 'plugins_loaded', array( $this, 'load_textdomain' ) ); + // Run pending DB upgrades on every request after a plugin update. + add_action( 'plugins_loaded', array( 'Robotstxt_Mlp2_Mlp5_Db_Upgrader', 'maybe_upgrade' ) ); + // Register AJAX handlers for the batch migration runner. + Robotstxt_Mlp2_Mlp5_Ajax::register(); + // Register the Network Admin page (network_admin_menu hook fires inside). + Robotstxt_Mlp2_Mlp5_Admin_Page::init(); + } + + /** + * Plugin activation callback. + * + * Prevents activation on non-Multisite installations. On Multisite, + * creates the migration log table. + */ + public function activate(): void { + if ( ! is_multisite() ) { + deactivate_plugins( plugin_basename( $this->plugin_file ), true ); + wp_die( + esc_html__( 'MLP2 to MLP5 Migrator requires a WordPress Multisite installation.', 'robotstxt-mlp2-mlp5' ), + esc_html__( 'Plugin Activation Error', 'robotstxt-mlp2-mlp5' ), + array( 'back_link' => true ) + ); + } + + Robotstxt_Mlp2_Mlp5_Db_Upgrader::maybe_upgrade(); + } + + /** + * Plugin deactivation callback. + */ + public function deactivate(): void { + // Reserved for future cleanup on deactivation. + } + + /** + * Display an admin notice when the plugin is loaded on a non-Multisite installation. + * + * Belt-and-suspenders guard in case the plugin ends up loaded outside of + * the network activation flow. + */ + public function multisite_notice(): void { + if ( is_multisite() ) { + return; + } + + printf( + '%s