[], 'posts' => [], 'authors' => [] ]; $csv_data = []; // Read and normalize file content $fileContent = file_get_contents( $file ); if ( $fileContent === false ) { return $data; // Return empty data if file reading fails } $fileContent = str_replace( [ "\r\n", "\r" ], "\n", $fileContent ); // Parse through a stream so fgetcsv() correctly assembles records whose // quoted fields span multiple lines (e.g. multi-line doc content). A plain // explode( "\n" ) + str_getcsv() per line splits such records apart, producing // rows whose column count no longer matches the headers — which makes the // array_combine() calls below fatal (500 error on Sample Docs import). // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fopen -- in-memory stream, no filesystem access; required for multi-line CSV records. $handle = fopen( 'php://temp', 'r+' ); if ( $handle !== false ) { fwrite( $handle, $fileContent ); rewind( $handle ); while ( ( $row = fgetcsv( $handle, 0, ',' ) ) !== false ) { $csv_data[] = $row; } // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fclose -- closing in-memory stream; WP_Filesystem does not apply. fclose( $handle ); } $headers = array_shift( $csv_data ); // Bail out cleanly on an empty/malformed file instead of fataling below. if ( ! is_array( $headers ) || empty( $headers ) ) { return $data; } // Process specific headers for 'Docs Title' if ( $headers[0] == 'Docs Title' ) { $replacementMap = [ 'Docs Slug' => 'post_name' ]; $headers = array_map( function ( $item ) use ( $replacementMap ) { return $replacementMap[ $item ] ?? $item; }, $headers ); $data['type'] = 'sample/csv'; foreach ( $csv_data as $row ) { $row = array_pad( $row, count( $headers ), '' ); $data['posts'][] = array_combine( $headers, $row ); } return $data; } usort( $csv_data, [ $this, 'csvSort' ] ); // The combined CSV packs three blocks side by side: Docs (from index 1), // then Author, then Term. CSVs exported after the WPML language columns // were added widen the Docs block by 2 columns (Docs language code + // translation source slug), shifting the Author/Term offsets. Locate // each block by its header name rather than a fixed position, so the // layout is detected wherever the columns land (and adding a column to // one block can't silently corrupt the others). $has_wpml_columns = in_array( 'Docs language code', $headers, true ); $author_offset = array_search( 'Author id', $headers, true ); $term_offset = array_search( 'Taxonomy', $headers, true ); // Fall back to the historical fixed offsets if a block header is missing // (malformed file) so such files still parse exactly as they did before. if ( $author_offset === false ) { $author_offset = $has_wpml_columns ? 24 : 22; } if ( $term_offset === false ) { $term_offset = $has_wpml_columns ? 30 : 28; } // The Docs block runs from index 1 up to the start of the Author block. $post_block_len = $author_offset - 1; foreach ( $csv_data as $row ) { $type = $row[0]; if ( $type === 'glossaries' ) { $term_headers = array_slice( $headers, 0, 7 ); $term_row = array_slice( $row, 0, 7 ); $term_row = array_pad( $term_row, count( $term_headers ), '' ); if ( count( $term_headers ) !== count( $term_row ) ) { return $data; } $term_data = array_combine( $term_headers, $term_row ); $term_args = [ 'term_taxonomy' => $term_data['Taxonomy'], 'term_id' => $term_data['Term ID'], 'term_name' => $term_data['Term name'], 'slug' => $term_data['Term slug'], 'term_group' => $term_data['Term group'] ]; $term_args['termmeta'][] = [ 'key' => 'glossary_term_description', 'value' => $term_data['Term description'] ]; $data['terms'][] = $term_args; } elseif ( $type === 'Term' ) { $term_headers = array_slice( $headers, $term_offset, 11 ); $term_row = array_slice( $row, $term_offset, 11 ); $term_row = array_pad( $term_row, count( $term_headers ), '' ); $term_data = array_combine( $term_headers, $term_row ); $taxonomy = $term_data['Taxonomy']; $term_args = [ 'term_id' => sanitize_text_field( $term_data['Term ID'] ), 'term_taxonomy' => $taxonomy, 'slug' => sanitize_text_field( $term_data['Term slug'] ), 'term_parent' => sanitize_text_field( $term_data['Term parent'] ), 'term_name' => sanitize_text_field( $term_data['Term name'] ), 'description' => sanitize_text_field( $term_data['Term description'] ), 'term_group' => sanitize_text_field( $term_data['Term group'] ), 'termmeta' => [] ]; if ( $taxonomy === 'doc_category' ) { if ( ! empty( $term_data['Assigned Docs'] ) ) { $term_args['termmeta'][] = [ 'key' => '_docs_order', 'value' => sanitize_text_field( $term_data['Assigned Docs'] ) ]; } if ( ! empty( $term_data['Assigned KBs'] ) ) { $doc_category_knowledge_base = explode( ",", sanitize_text_field( $term_data['Assigned KBs'] ) ); $term_args['termmeta'][] = [ 'key' => 'doc_category_knowledge_base', 'value' => rest_sanitize_array( $doc_category_knowledge_base ) ]; } if ( ! empty( $term_data['Doc Category order'] ) ) { $term_args['termmeta'][] = [ 'key' => 'doc_category_order', 'value' => sanitize_text_field( $term_data['Doc Category order'] ) ]; } } else if ( $taxonomy === 'knowledge_base' && ! empty( $term_data['KB order'] ) ) { $term_args['termmeta'][] = [ 'key' => 'kb_order', 'value' => $term_data['KB order'] ]; } $data['terms'][] = $term_args; } elseif ( $type === 'Author' ) { $author_headers = array_slice( $headers, $author_offset, 6 ); $author_row = array_slice( $row, $author_offset, 6 ); $author_row = array_pad( $author_row, count( $author_headers ), '' ); $author_data = array_combine( $author_headers, $author_row ); $data['authors'][$author_data['Author login']] = [ 'author_id' => sanitize_text_field( $author_data['Author id'] ), 'author_login' => sanitize_text_field( $author_data['Author login'] ), 'author_email' => sanitize_text_field( $author_data['Author email'] ), 'author_display_name' => sanitize_text_field( $author_data['Author display name'] ), 'author_first_name' => sanitize_text_field( $author_data['Author first name'] ), 'author_last_name' => sanitize_text_field( $author_data['Author last name'] ) ]; } else if ( $type === 'Docs' || $type === 'FAQ' ) { // Keep FAQ import (HEAD) and use the dynamic post-block length // from the WPML branch so the variable WPML language columns are // handled instead of a hardcoded count. $post_headers = array_slice( $headers, 1, $post_block_len ); $post_row = array_slice( $row, 1, $post_block_len ); $post_row = array_pad( $post_row, count( $post_headers ), '' ); $post_data = array_combine( $post_headers, $post_row ); $post_args = [ 'post_id' => sanitize_text_field( $post_data['Docs ID'] ) ?? '', 'post_type' => $type === 'FAQ' ? 'betterdocs_faq' : 'docs', 'post_author' => sanitize_text_field( $post_data['Docs author'] ) ?? '', 'post_content' => sanitize_text_field( $post_data['Docs content'] ) ?? '', 'post_title' => sanitize_text_field( $post_data['Docs title'] ) ?? '', 'post_name' => sanitize_text_field( $post_data['Docs slug'] ) ?? '', 'post_excerpt' => sanitize_text_field( $post_data['Docs excerpt'] ) ?? '', 'status' => sanitize_text_field( $post_data['Docs status'] ) ?? 'publish', 'post_password' => sanitize_text_field( $post_data['Docs password'] ) ?? '', 'post_parent' => sanitize_text_field( $post_data['Docs parent'] ) ?? '', 'menu_order' => sanitize_text_field( $post_data['Docs menu order'] ) ?? '', 'post_date' => sanitize_text_field( $post_data['Docs date'] ) ?? '', 'post_date_gmt' => sanitize_text_field( $post_data['Docs date gmt'] ) ?? '', 'post_modified' => sanitize_text_field( $post_data['Docs modified date'] ) ?? '', 'post_modified_gmt' => sanitize_text_field( $post_data['Docs modified date gmt'] ) ?? '', 'terms' => [], 'postmeta' => [] ]; if ( isset( $post_data['Doc Categories'] ) && $data['terms'] ) { $post_args['terms'] = array_merge( $this->searchTermsByIds( $data['terms'], sanitize_text_field( $post_data['Doc Categories'] ) ), $this->searchTermsByIds( $data['terms'], sanitize_text_field( $post_data['Doc Tags'] ) ), $this->searchTermsByIds( $data['terms'], sanitize_text_field( $post_data['Knowledge Bases'] ) ) ); } if ( $has_wpml_columns ) { if ( ! empty( $post_data['Docs language code'] ) ) { $post_args['postmeta'][] = [ 'key' => '_betterdocs_wpml_lang', 'value' => sanitize_text_field( $post_data['Docs language code'] ), ]; } if ( ! empty( $post_data['Docs translation source slug'] ) ) { $post_args['postmeta'][] = [ 'key' => '_betterdocs_wpml_source_slug', 'value' => sanitize_text_field( $post_data['Docs translation source slug'] ), ]; } } $data['posts'][] = $post_args; if ( ! empty( $post_data['Docs attachement url'] ) ) { $attachment_args = [ 'post_type' => 'attachment', 'post_author' => sanitize_text_field( $post_data['Docs author'] ) ?? '', 'post_id' => sanitize_text_field( $post_data['Docs attachement ID'] ) ?? '', 'status' => 'inherit', 'post_content' => '', 'post_excerpt' => '', 'guid' => '', 'post_title' => pathinfo( sanitize_text_field( $post_data['Docs attachement url'] ), PATHINFO_FILENAME ), 'post_name' => pathinfo( sanitize_text_field( $post_data['Docs attachement url'] ), PATHINFO_FILENAME ), 'post_parent' => sanitize_text_field( $post_data['Docs ID'] ) ?? '', 'attachment_url' => sanitize_text_field( $post_data['Docs attachement url'] ) ]; $data['posts'][] = $attachment_args; } } } return $data; } public function searchTermsByIds( $terms, $termIds ) { // Convert the comma-separated term IDs to an array $termIdsArray = explode( ',', $termIds ); // Initialize the result array $result = []; // Iterate through each term_id in the array foreach ( $termIdsArray as $termId ) { // Find the corresponding term in the terms array $foundTerm = array_filter( $terms, function ( $term ) use ( $termId ) { return $term['term_id'] == $termId; } ); // If the term is found, add it to the result array if ( ! empty( $foundTerm ) ) { $foundTerm = reset( $foundTerm ); $result[] = [ 'name' => $foundTerm['term_name'], 'slug' => $foundTerm['slug'], 'domain' => $foundTerm['term_taxonomy'] ]; } } return $result; } }