$matches[1], 'repo' => $matches[2], ); } return new WP_Error( 'invalid_format', __( 'Could not parse GitHub URL', 'robotstxt-documentation-markdown' ) ); } /** * Get all markdown files from repository * * @since 1.0.0 * * @param string $owner Repository owner. * @param string $repo Repository name. * @param string $branch Branch name. * @param string $token GitHub token (encrypted). * @return array|WP_Error Array of files or error. */ function robotstxt_docmd_get_all_markdown_files( $owner, $repo, $branch, $token ) { // Check cache first. $cache_key = sprintf( 'robotstxt_docmd_files_%s_%s_%s', $owner, $repo, $branch ); $cached = get_transient( $cache_key ); if ( false !== $cached ) { return $cached; } // Decrypt token. $decrypted_token = robotstxt_docmd_decrypt_token( $token ); // Get files recursively. $files = robotstxt_docmd_get_repository_contents_recursive( $owner, $repo, '', $branch, $decrypted_token ); if ( is_wp_error( $files ) ) { return $files; } // Filter only markdown files. $markdown_files = array_filter( $files, function ( $file ) { return preg_match( '/\.(md|markdown)$/i', $file['path'] ); } ); // Re-index array. $markdown_files = array_values( $markdown_files ); // Cache for 24 hours. set_transient( $cache_key, $markdown_files, DAY_IN_SECONDS ); return $markdown_files; } /** * Get repository contents recursively * * @since 1.0.0 * * @param string $owner Repository owner. * @param string $repo Repository name. * @param string $path Path in repository. * @param string $branch Branch name. * @param string $token GitHub token (plain). * @param int $depth Current depth (for recursion limit). * @return array|WP_Error Array of files or error. */ function robotstxt_docmd_get_repository_contents_recursive( $owner, $repo, $path, $branch, $token, $depth = 0 ) { // Prevent infinite recursion. if ( $depth > 10 ) { return array(); } $url = sprintf( 'https://api.github.com/repos/%s/%s/contents/%s?ref=%s', $owner, $repo, $path, $branch ); $response = wp_remote_get( $url, array( 'headers' => array( 'Authorization' => 'Bearer ' . $token, 'Accept' => 'application/vnd.github.v3+json', 'User-Agent' => 'WordPress-Documentation-Plugin', ), 'timeout' => 30, ) ); if ( is_wp_error( $response ) ) { return $response; } $code = wp_remote_retrieve_response_code( $response ); if ( 200 !== $code ) { return new WP_Error( 'github_api_error', sprintf( /* translators: %d: HTTP response code */ __( 'GitHub API error: %d', 'robotstxt-documentation-markdown' ), $code ) ); } $body = wp_remote_retrieve_body( $response ); $contents = json_decode( $body, true ); if ( ! is_array( $contents ) ) { return new WP_Error( 'invalid_response', __( 'Invalid GitHub API response', 'robotstxt-documentation-markdown' ) ); } $files = array(); foreach ( $contents as $item ) { if ( 'file' === $item['type'] ) { // Skip files larger than 10MB. if ( $item['size'] > 10 * 1024 * 1024 ) { continue; } $files[] = array( 'path' => $item['path'], 'name' => $item['name'], 'size' => $item['size'], 'sha' => $item['sha'], ); } elseif ( 'dir' === $item['type'] ) { // Recurse into directory. $subfiles = robotstxt_docmd_get_repository_contents_recursive( $owner, $repo, $item['path'], $branch, $token, $depth + 1 ); if ( ! is_wp_error( $subfiles ) ) { $files = array_merge( $files, $subfiles ); } } } return $files; } /** * Get file content from GitHub * * @since 1.0.0 * * @param string $owner Repository owner. * @param string $repo Repository name. * @param string $file_path File path. * @param string $branch Branch name. * @param string $token GitHub token (encrypted). * @return string|WP_Error File content or error. */ function robotstxt_docmd_get_file_content( $owner, $repo, $file_path, $branch, $token ) { $decrypted_token = robotstxt_docmd_decrypt_token( $token ); $url = sprintf( 'https://api.github.com/repos/%s/%s/contents/%s?ref=%s', $owner, $repo, $file_path, $branch ); $response = wp_remote_get( $url, array( 'headers' => array( 'Authorization' => 'Bearer ' . $decrypted_token, 'Accept' => 'application/vnd.github.v3+json', 'User-Agent' => 'WordPress-Documentation-Plugin', ), 'timeout' => 30, ) ); if ( is_wp_error( $response ) ) { return $response; } $code = wp_remote_retrieve_response_code( $response ); if ( 200 !== $code ) { return new WP_Error( 'github_api_error', sprintf( /* translators: %d: HTTP response code */ __( 'GitHub API error: %d', 'robotstxt-documentation-markdown' ), $code ) ); } $body = wp_remote_retrieve_body( $response ); $data = json_decode( $body, true ); if ( ! isset( $data['content'] ) || ! isset( $data['encoding'] ) ) { return new WP_Error( 'invalid_response', __( 'Invalid file response from GitHub', 'robotstxt-documentation-markdown' ) ); } // Decode content (GitHub returns base64). if ( 'base64' === $data['encoding'] ) { return base64_decode( $data['content'] ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_decode } return $data['content']; }