\s*.*?<\/h1>\s*<\/div>\s*(
.*?<\/h1>\s*<\/div>\s*(\s*)?/is', '', $content );
$content = preg_replace( '/\s*<\/div>\s*$/is', '', $content );
}
// Remove leading title (already handled as post_title)
$content = preg_replace( '/^\s*[^<]*<\/h1>\s*/i', '', $content, 1 );
// Return content as-is from origin without auto-wrapping in Gutenberg
// block comments. Push sends raw post_content, pull restores it raw.
return trim( $content );
}
/**
* Commit content to GitLab repository (placeholder)
*
* @param string $file_path
* @param string $content
* @param WP_Post $post
* @param array $config
* @return array|WP_Error
*/
protected function commit_to_gitlab( $file_path, $content, $post, $config, $commit_message = '' ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return new \WP_Error( 'missing_project_id', __( 'GitLab Project ID is not configured. Please reconnect your GitLab account in BetterDocs Settings with a valid Project ID.', 'betterdocs-pro' ) );
}
$pid = urlencode( $project_id );
$branch = $config['branch'] ?: 'main';
$token = $config['access_token'];
if ( empty( $commit_message ) ) {
$commit_message = sprintf( 'Update %s via BetterDocs', $post->post_title );
}
// Check if file already exists (to decide create vs update action)
$check_url = "{$base_url}/api/v4/projects/{$pid}/repository/files/" . urlencode( $file_path ) . '?ref=' . urlencode( $branch );
$check = wp_remote_get( $check_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
$exists = ! is_wp_error( $check ) && wp_remote_retrieve_response_code( $check ) === 200;
// Detect no-changes: fetch raw file content and compare directly
if ( $exists ) {
$raw_url = "{$base_url}/api/v4/projects/{$pid}/repository/files/" . urlencode( $file_path ) . '/raw?ref=' . urlencode( $branch );
$raw_response = wp_remote_get( $raw_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
if ( ! is_wp_error( $raw_response ) && wp_remote_retrieve_response_code( $raw_response ) === 200 ) {
$remote_content = wp_remote_retrieve_body( $raw_response );
if ( $remote_content === $content ) {
return new \WP_Error( 'no_changes', __( 'No changes to push — content is already up to date.', 'betterdocs-pro' ) );
}
}
}
// GitLab Commits API — single file commit
$api_url = "{$base_url}/api/v4/projects/{$pid}/repository/commits";
$response = wp_remote_post( $api_url, [
'headers' => [
'PRIVATE-TOKEN' => $token,
'Content-Type' => 'application/json',
],
'body' => wp_json_encode( [
'branch' => $branch,
'commit_message' => $commit_message,
'actions' => [
[
'action' => $exists ? 'update' : 'create',
'file_path' => $file_path,
'content' => $content,
],
],
] ),
'timeout' => 30,
] );
if ( is_wp_error( $response ) ) {
return $response;
}
$code = wp_remote_retrieve_response_code( $response );
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( $code >= 400 ) {
$raw_msg = $body['message'] ?? $body['error'] ?? '';
if ( is_array( $raw_msg ) ) $raw_msg = implode( ', ', $raw_msg );
return new \WP_Error( 'gitlab_api_error', $this->humanize_api_error( $code, $raw_msg, 'gitlab' ) );
}
return [
'commit_hash' => $body['id'] ?? '',
'message' => __( 'Pushed to GitLab successfully.', 'betterdocs-pro' ),
];
}
/**
* Commit content to Bitbucket repository (placeholder)
*
* @param string $file_path
* @param string $content
* @param WP_Post $post
* @param array $config
* @return array|WP_Error
*/
protected function commit_to_bitbucket( $file_path, $content, $post, $config ) {
return new \WP_Error( 'not_implemented', __( 'Bitbucket integration not yet implemented', 'betterdocs-pro' ) );
}
/**
* Fetch content from GitLab repository (placeholder)
*
* @param string $file_path
* @param array $config
* @return array|WP_Error
*/
protected function fetch_from_gitlab( $file_path, $config ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return new \WP_Error( 'missing_project_id', __( 'GitLab Project ID is not configured. Please reconnect your GitLab account in BetterDocs Settings with a valid Project ID.', 'betterdocs-pro' ) );
}
$pid = urlencode( $project_id );
$branch = $config['branch'] ?: 'main';
$token = $config['access_token'];
$api_url = "{$base_url}/api/v4/projects/{$pid}/repository/files/" . urlencode( $file_path ) . '?ref=' . urlencode( $branch );
$response = wp_remote_get( $api_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
if ( is_wp_error( $response ) ) {
return $response;
}
$code = wp_remote_retrieve_response_code( $response );
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( $code === 404 ) {
return new \WP_Error( 'github_api_error', __( 'File not found in the repository. It may have been deleted or the file path has changed.', 'betterdocs-pro' ), [ 'status_code' => 404 ] );
}
if ( $code >= 400 ) {
$raw_msg = $body['message'] ?? $body['error'] ?? '';
return new \WP_Error( 'gitlab_api_error', $this->humanize_api_error( $code, $raw_msg, 'gitlab' ) );
}
// GitLab returns file content as base64
$content = isset( $body['content'] ) ? base64_decode( $body['content'] ) : '';
return [
'content' => $content,
'sha' => $body['last_commit_id'] ?? $body['blob_id'] ?? '',
];
}
/**
* Fetch content from Bitbucket repository (placeholder)
*
* @param string $file_path
* @param array $config
* @return array|WP_Error
*/
protected function fetch_from_bitbucket( $file_path, $config ) {
return new \WP_Error( 'not_implemented', __( 'Bitbucket integration not yet implemented', 'betterdocs-pro' ) );
}
/**
* Convert HTML to Markdown
*
* @param string $html
* @return string
*/
protected function html_to_markdown( $html ) {
// Clean up the HTML first
$html = $this->clean_html_for_markdown( $html );
// Convert common HTML elements to Markdown
$conversions = [
// Headers
'/]*>(.*?)<\/h1>/i' => '# $1',
'/]*>(.*?)<\/h2>/i' => '## $1',
'/]*>(.*?)<\/h3>/i' => '### $1',
'/]*>(.*?)<\/h4>/i' => '#### $1',
'/]*>(.*?)<\/h5>/i' => '##### $1',
'/]*>(.*?)<\/h6>/i' => '###### $1',
// Bold and Italic
'/]*>(.*?)<\/strong>/i' => '**$1**',
'/]*>(.*?)<\/b>/i' => '**$1**',
'/]*>(.*?)<\/em>/i' => '*$1*',
'/]*>(.*?)<\/i>/i' => '*$1*',
// Links
'/]*href=["\']([^"\']*)["\'][^>]*>(.*?)<\/a>/i' => '[$2]($1)',
// Images
'/]*src=["\']([^"\']*)["\'][^>]*alt=["\']([^"\']*)["\'][^>]*[\/]?>/i' => '',
'/]*alt=["\']([^"\']*)["\'][^>]*src=["\']([^"\']*)["\'][^>]*[\/]?>/i' => '',
'/]*src=["\']([^"\']*)["\'][^>]*[\/]?>/i' => '',
// Code
'/]*>(.*?)<\/code>/i' => '`$1`',
'/]*>]*>(.*?)<\/code><\/pre>/is' => "```\n$1\n```",
'/]*>(.*?)<\/pre>/is' => "```\n$1\n```",
// Lists
'/]*>/i' => '',
'/<\/ul>/i' => '',
'/]*>/i' => '',
'/<\/ol>/i' => '',
'/]*>(.*?)<\/li>/i' => '- $1',
// Blockquotes
'/]*>(.*?)<\/blockquote>/is' => '> $1',
// Line breaks and paragraphs
'/]*\/?>/i' => "\n",
'/]*>/i' => '',
'/<\/p>/i' => "\n\n",
// Tables (basic)
'/]*>/i' => '',
'/<\/table>/i' => "\n",
'/]*>/i' => '',
'/<\/tr>/i' => "|\n",
'/]*>(.*?)<\/th>/i' => '| $1 ',
'/]*>(.*?)<\/td>/i' => '| $1 ',
// Remove remaining HTML tags
'/<[^>]+>/' => '',
];
foreach ( $conversions as $pattern => $replacement ) {
$html = preg_replace( $pattern, $replacement, $html );
}
// Clean up extra whitespace
$html = preg_replace( '/\n\s*\n\s*\n/', "\n\n", $html );
$html = trim( $html );
// Decode HTML entities
$html = html_entity_decode( $html, ENT_QUOTES, 'UTF-8' );
return $html;
}
/**
* Convert Markdown to HTML
*
* @param string $markdown
* @return string
*/
/**
* Convert Markdown to Gutenberg-compatible block HTML.
*
* Step 1: Convert markdown syntax to HTML using regex (headings, bold, etc.)
* Step 2: Wrap each HTML element in Gutenberg block comments so the editor
* renders proper blocks instead of a single Classic block.
*/
protected function markdown_to_html( $markdown ) {
// Normalize line endings
$markdown = str_replace( "\r\n", "\n", $markdown );
$markdown = str_replace( "\r", "\n", $markdown );
// ── Step 1: Convert Markdown to HTML ──────────────────────────
$conversions = [
// Code blocks (fenced) — must come before inline code
'/```\n(.*?)\n```/s' => '$1
',
// Headers
'/^###### (.*$)/m' => '$1
',
'/^##### (.*$)/m' => '$1
',
'/^#### (.*$)/m' => '$1
',
'/^### (.*$)/m' => '$1
',
'/^## (.*$)/m' => '$1
',
'/^# (.*$)/m' => '$1
',
// Images (before links to avoid conflict)
'/!\[([^\]]*)\]\(([^)]+)\)/' => '
',
// Links
'/\[([^\]]+)\]\(([^)]+)\)/' => '$1',
// Bold and Italic
'/\*\*(.*?)\*\*/' => '$1',
'/\*(.*?)\*/' => '$1',
// Inline code
'/`([^`]+)`/' => '$1',
// Lists
'/^- (.*$)/m' => '$1 ',
'/^\* (.*$)/m' => '$1 ',
'/^\d+\. (.*$)/m' => '$1 ',
// Blockquotes
'/^> (.*$)/m' => '$1
',
// Horizontal rules
'/^(---+|\*\*\*+|___+)\s*$/m' => '
',
// Paragraphs — double newlines become paragraph breaks
'/\n\n/' => '',
];
foreach ( $conversions as $pattern => $replacement ) {
$markdown = preg_replace( $pattern, $replacement, $markdown );
}
// Wrap in paragraphs
$html = '
' . $markdown . '
';
// Clean up empty paragraphs
$html = preg_replace( '/\s*<\/p>/', '', $html );
// Fix list wrapping — consecutive
inside become
$html = preg_replace( '/(
- .*?<\/li>)<\/p>/s', '
$1
', $html );
$html = preg_replace( '/<\/li>\s* - /', '
- ', $html );
// Fix blockquote wrapping
$html = preg_replace( '/
(
.*?<\/blockquote>)<\/p>/s', '$1', $html );
// ── Step 2: Wrap HTML elements in Gutenberg block comments ────
// Headings
for ( $i = 1; $i <= 6; $i++ ) {
$attrs = $i !== 2 ? ' {"level":' . $i . '}' : '';
$html = preg_replace(
'/(.*?)<\/h' . $i . '>/s',
"\n$1 \n",
$html
);
}
// Code blocks
$html = preg_replace(
'/(.*?)<\/code><\/pre>/s',
"\n$1
\n",
$html
);
// Lists
$html = preg_replace(
'/(.*?)<\/ul>/s',
"\n$1
\n",
$html
);
// Blockquotes
$html = preg_replace(
'/(.*?)<\/blockquote>/s',
"\n$1
\n",
$html
);
// Images
$html = preg_replace(
'/
/',
"\n![\"$2\"/](\"$1\")
/',
"\n
\n",
$html
);
// Paragraphs — wrap remaining ...
that aren't already inside a block
$html = preg_replace(
'/(?)\s*(.*?)<\/p>/s',
"\n\n
$1
\n",
$html
);
// Clean up whitespace
$html = preg_replace( '/\n{3,}/', "\n\n", $html );
$html = trim( $html );
return $html;
}
/**
* Clean HTML for better Markdown conversion
*
* @param string $html
* @return string
*/
protected function clean_html_for_markdown( $html ) {
// Remove WordPress-specific elements that don't translate well
$html = preg_replace( '/]*class="[^"]*wp-block[^"]*"[^>]*>/i', '', $html );
// Remove empty paragraphs
$html = preg_replace( '/]*>\s*<\/p>/i', '', $html );
// Convert WordPress image captions
$html = preg_replace(
'/]*class="[^"]*wp-caption[^"]*"[^>]*>.*?]*)>.*?]*class="[^"]*wp-caption-text[^"]*"[^>]*>(.*?)<\/p>.*?<\/div>/is',
']*src=["\']([^"\']*)["\'][^>]*>(.*)$/s', $caption_content, $img_matches ) ) {
$img_src = $img_matches[1];
$caption_text = wp_strip_all_tags( trim( $img_matches[2] ) );
return "\n\n*{$caption_text}*\n\n";
}
return $caption_content;
},
$content
);
// Convert [code] shortcode
$content = preg_replace( '/\[code[^\]]*\](.*?)\[\/code\]/s', "```\n$1\n```", $content );
// Convert [quote] shortcode
$content = preg_replace( '/\[quote[^\]]*\](.*?)\[\/quote\]/s', "> $1", $content );
// Remove other shortcodes that don't have good Markdown equivalents
$content = preg_replace( '/\[[^\]]+\]/', '', $content );
return $content;
}
/**
* Process images for GitHub compatibility
*
* @param string $markdown
* @param WP_Post $post
* @return string
*/
// ── New AJAX actions for GitHub Sync toolbar button ────────────────────
/**
* AJAX: Get diff between current post content and the version in GitHub
*/
public function ajax_get_diff() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_github_diff_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$post_id = isset( $_POST['post_id'] ) ? intval( wp_unslash( $_POST['post_id'] ) ) : 0;
$post = get_post( $post_id );
if ( ! $post || $post->post_type !== 'docs' ) {
wp_send_json_error( __( 'This document could not be found or is not a valid BetterDocs article.', 'betterdocs-pro' ) );
}
// Auto-drafts with no real content should show "no changes".
if ( $post->post_status === 'auto-draft' && empty( trim( $post->post_content ) ) ) {
wp_send_json_success( [
'diff_lines' => [],
'additions' => 0,
'deletions' => 0,
'changes' => 0,
] );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$file_path = $this->resolve_file_path( $post_id, $post );
// Fetch remote version
$remote = $this->fetch_from_repository( $file_path, $config );
if ( is_wp_error( $remote ) ) {
// If file not found remotely, the whole doc is "new"
$local_md = $this->convert_to_markdown( $post );
$lines = explode( "\n", $local_md );
$diff_lines = [];
foreach ( $lines as $i => $line ) {
$diff_lines[] = [ 'type' => 'add', 'line_no' => $i + 1, 'content' => $line ];
}
wp_send_json_success( [
'diff_lines' => $diff_lines,
'additions' => count( $lines ),
'deletions' => 0,
'changes' => count( $lines ),
] );
}
$local_md = $this->convert_to_markdown( $post );
$remote_md = $remote['content'];
$diff_result = $this->compute_diff( $remote_md, $local_md );
wp_send_json_success( $diff_result );
}
/**
* AJAX handler for "Fetch" — returns diff + remote branch status (commits behind).
* Used by the editor dropdown to show a GitHub-Desktop-style fetch indicator.
*/
public function ajax_fetch_status() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_git_fetch_status_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$post_id = isset( $_POST['post_id'] ) ? intval( wp_unslash( $_POST['post_id'] ) ) : 0;
$post = get_post( $post_id );
if ( ! $post || $post->post_type !== 'docs' ) {
wp_send_json_error( __( 'This document could not be found or is not a valid BetterDocs article.', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$file_path = $this->resolve_file_path( $post_id, $post );
// Diff portion (same logic as ajax_get_diff).
$diff_result = [
'diff_lines' => [],
'additions' => 0,
'deletions' => 0,
'changes' => 0,
];
$remote_exists = true;
if ( $post->post_status === 'auto-draft' && empty( trim( $post->post_content ) ) ) {
// keep default
} else {
$remote = $this->fetch_from_repository( $file_path, $config );
if ( is_wp_error( $remote ) ) {
$remote_exists = false;
$local_md = $this->convert_to_markdown( $post );
$lines = explode( "\n", $local_md );
$add = [];
foreach ( $lines as $i => $line ) {
$add[] = [ 'type' => 'add', 'line_no' => $i + 1, 'content' => $line ];
}
$diff_result = [
'diff_lines' => $add,
'additions' => count( $lines ),
'deletions' => 0,
'changes' => count( $lines ),
];
} else {
$local_md = $this->convert_to_markdown( $post );
$diff_result = $this->compute_diff( $remote['content'], $local_md );
}
}
// Remote branch status.
$last_pushed_hash = get_post_meta( $post_id, '_betterdocs_git_commit_hash', true );
$behind = $this->get_commits_behind( $last_pushed_hash, $config );
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
wp_send_json_success( array_merge( $diff_result, [
'branch' => $branch,
'remote_exists' => $remote_exists,
'behind_by' => is_array( $behind ) && isset( $behind['behind_by'] ) ? intval( $behind['behind_by'] ) : null,
'latest_commit' => is_array( $behind ) && isset( $behind['latest_commit'] ) ? $behind['latest_commit'] : null,
'has_last_pushed' => ! empty( $last_pushed_hash ),
] ) );
}
/**
* Return recent commits touching the current doc's file (or the branch
* when the file isn't tracked yet) for the History tab.
*/
public function ajax_commit_history() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_git_commit_history_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$post_id = isset( $_POST['post_id'] ) ? intval( wp_unslash( $_POST['post_id'] ) ) : 0;
$post = get_post( $post_id );
if ( ! $post || $post->post_type !== 'docs' ) {
wp_send_json_error( __( 'This document could not be found or is not a valid BetterDocs article.', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$file_path = $this->resolve_file_path( $post_id, $post );
$commits = $this->get_commit_history( $file_path, $config, 15 );
wp_send_json_success( [
'commits' => is_array( $commits ) ? $commits : [],
'branch' => isset( $config['branch'] ) ? $config['branch'] : 'main',
] );
}
protected function get_commit_history( $file_path, $config, $limit = 15 ) {
$provider = isset( $config['provider'] ) ? $config['provider'] : 'github';
if ( $provider === 'gitlab' ) {
return $this->get_gitlab_commit_history( $file_path, $config, $limit );
}
return $this->get_github_commit_history( $file_path, $config, $limit );
}
protected function get_github_commit_history( $file_path, $config, $limit = 15 ) {
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return [];
}
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
$args = [ 'sha' => $branch, 'per_page' => $limit ];
if ( ! empty( $file_path ) ) {
$args['path'] = $file_path;
}
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/commits?" . http_build_query( $args );
$response = $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
if ( is_wp_error( $response ) || ! is_array( $response ) ) {
return [];
}
$out = [];
foreach ( $response as $c ) {
if ( ! is_array( $c ) ) {
continue;
}
$sha_full = isset( $c['sha'] ) ? $c['sha'] : '';
$out[] = [
'sha' => $sha_full ? substr( $sha_full, 0, 7 ) : '',
'sha_full'=> $sha_full,
'message' => isset( $c['commit']['message'] ) ? strtok( $c['commit']['message'], "\n" ) : '',
'author' => isset( $c['commit']['author']['name'] ) ? $c['commit']['author']['name'] : '',
'avatar' => isset( $c['author']['avatar_url'] ) ? $c['author']['avatar_url'] : '',
'date' => isset( $c['commit']['author']['date'] ) ? $c['commit']['author']['date'] : '',
'url' => isset( $c['html_url'] ) ? $c['html_url'] : '',
];
}
return $out;
}
protected function get_gitlab_commit_history( $file_path, $config, $limit = 15 ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return [];
}
$pid = urlencode( $project_id );
$args = [
'ref_name' => isset( $config['branch'] ) ? $config['branch'] : 'main',
'per_page' => $limit,
];
if ( ! empty( $file_path ) ) {
$args['path'] = $file_path;
}
$url = "{$base_url}/api/v4/projects/{$pid}/repository/commits?" . http_build_query( $args );
$res = wp_remote_get( $url, [
'headers' => [ 'PRIVATE-TOKEN' => $config['access_token'] ],
'timeout' => 15,
] );
if ( is_wp_error( $res ) || wp_remote_retrieve_response_code( $res ) >= 400 ) {
return [];
}
$body = json_decode( wp_remote_retrieve_body( $res ), true );
if ( ! is_array( $body ) ) {
return [];
}
$out = [];
foreach ( $body as $c ) {
$out[] = [
'sha' => isset( $c['short_id'] ) ? $c['short_id'] : '',
'sha_full'=> isset( $c['id'] ) ? $c['id'] : '',
'message' => isset( $c['title'] ) ? $c['title'] : '',
'author' => isset( $c['author_name'] ) ? $c['author_name'] : '',
'avatar' => '',
'date' => isset( $c['created_at'] ) ? $c['created_at'] : '',
'url' => isset( $c['web_url'] ) ? $c['web_url'] : '',
];
}
return $out;
}
/**
* Compare a stored local commit hash with the current remote branch HEAD.
* Returns ['behind_by' => int, 'latest_commit' => [...]] or null when the
* count cannot be determined (e.g. no prior push, provider unsupported).
*/
protected function get_commits_behind( $last_hash, $config ) {
$provider = isset( $config['provider'] ) ? $config['provider'] : 'github';
if ( empty( $last_hash ) ) {
$latest = $this->get_latest_commit( $config );
if ( $latest ) {
return [ 'behind_by' => null, 'latest_commit' => $latest ];
}
return null;
}
if ( $provider === 'gitlab' ) {
return $this->get_gitlab_commits_behind( $last_hash, $config );
}
return $this->get_github_commits_behind( $last_hash, $config );
}
protected function get_github_commits_behind( $last_hash, $config ) {
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return null;
}
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/compare/" . rawurlencode( $last_hash ) . '...' . rawurlencode( $branch );
$response = $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
if ( is_wp_error( $response ) || ! is_array( $response ) ) {
return null;
}
$latest = null;
if ( ! empty( $response['commits'] ) && is_array( $response['commits'] ) ) {
$last = end( $response['commits'] );
if ( is_array( $last ) ) {
$latest = [
'sha' => isset( $last['sha'] ) ? substr( $last['sha'], 0, 7 ) : '',
'message' => isset( $last['commit']['message'] ) ? strtok( $last['commit']['message'], "\n" ) : '',
'author' => isset( $last['commit']['author']['name'] ) ? $last['commit']['author']['name'] : '',
'date' => isset( $last['commit']['author']['date'] ) ? $last['commit']['author']['date'] : '',
];
}
}
return [
'behind_by' => isset( $response['behind_by'] ) ? intval( $response['behind_by'] ) : 0,
'latest_commit' => $latest,
];
}
protected function get_gitlab_commits_behind( $last_hash, $config ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return null;
}
$pid = urlencode( $project_id );
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
$url = "{$base_url}/api/v4/projects/{$pid}/repository/compare?from=" . rawurlencode( $last_hash ) . '&to=' . rawurlencode( $branch );
$response = wp_remote_get( $url, [
'headers' => [ 'PRIVATE-TOKEN' => $config['access_token'] ],
'timeout' => 15,
] );
if ( is_wp_error( $response ) ) {
return null;
}
$code = wp_remote_retrieve_response_code( $response );
if ( $code >= 400 ) {
return null;
}
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( ! is_array( $body ) ) {
return null;
}
$commits = isset( $body['commits'] ) && is_array( $body['commits'] ) ? $body['commits'] : [];
$latest = null;
if ( ! empty( $commits ) ) {
$last = end( $commits );
$latest = [
'sha' => isset( $last['short_id'] ) ? $last['short_id'] : '',
'message' => isset( $last['title'] ) ? $last['title'] : '',
'author' => isset( $last['author_name'] ) ? $last['author_name'] : '',
'date' => isset( $last['created_at'] ) ? $last['created_at'] : '',
];
}
return [
'behind_by' => count( $commits ),
'latest_commit' => $latest,
];
}
/**
* Fetch the latest branch commit when we have no local hash to compare against.
*/
protected function get_latest_commit( $config ) {
$provider = isset( $config['provider'] ) ? $config['provider'] : 'github';
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
if ( $provider === 'gitlab' ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return null;
}
$pid = urlencode( $project_id );
$url = "{$base_url}/api/v4/projects/{$pid}/repository/commits?ref_name=" . rawurlencode( $branch ) . '&per_page=1';
$res = wp_remote_get( $url, [
'headers' => [ 'PRIVATE-TOKEN' => $config['access_token'] ],
'timeout' => 15,
] );
if ( is_wp_error( $res ) || wp_remote_retrieve_response_code( $res ) >= 400 ) {
return null;
}
$body = json_decode( wp_remote_retrieve_body( $res ), true );
if ( ! is_array( $body ) || empty( $body[0] ) ) {
return null;
}
$c = $body[0];
return [
'sha' => isset( $c['short_id'] ) ? $c['short_id'] : '',
'message' => isset( $c['title'] ) ? $c['title'] : '',
'author' => isset( $c['author_name'] ) ? $c['author_name'] : '',
'date' => isset( $c['created_at'] ) ? $c['created_at'] : '',
];
}
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return null;
}
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/commits?sha=" . rawurlencode( $branch ) . '&per_page=1';
$res = $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
if ( is_wp_error( $res ) || ! is_array( $res ) || empty( $res[0] ) ) {
return null;
}
$c = $res[0];
return [
'sha' => isset( $c['sha'] ) ? substr( $c['sha'], 0, 7 ) : '',
'message' => isset( $c['commit']['message'] ) ? strtok( $c['commit']['message'], "\n" ) : '',
'author' => isset( $c['commit']['author']['name'] ) ? $c['commit']['author']['name'] : '',
'date' => isset( $c['commit']['author']['date'] ) ? $c['commit']['author']['date'] : '',
];
}
/**
* Compute a simple unified diff between two strings.
* Returns structured diff lines for the frontend renderer.
*
* @param string $old
* @param string $new
* @return array
*/
protected function compute_diff( $old, $new ) {
$old_lines = explode( "\n", $old );
$new_lines = explode( "\n", $new );
$diff_lines = [];
$additions = 0;
$deletions = 0;
// Use a simple LCS-based diff
$n = count( $old_lines );
$m = count( $new_lines );
// Build LCS table (limit to 500 lines each to avoid memory issues)
$max = 500;
if ( $n > $max || $m > $max ) {
// Fallback: treat entire file as changed
foreach ( $old_lines as $i => $line ) {
$diff_lines[] = [ 'type' => 'del', 'line_no' => $i + 1, 'content' => $line ];
$deletions++;
}
foreach ( $new_lines as $i => $line ) {
$diff_lines[] = [ 'type' => 'add', 'line_no' => $i + 1, 'content' => $line ];
$additions++;
}
return compact( 'diff_lines', 'additions', 'deletions' ) + [ 'changes' => $additions + $deletions ];
}
$lcs = array_fill( 0, $n + 1, array_fill( 0, $m + 1, 0 ) );
for ( $i = $n - 1; $i >= 0; $i-- ) {
for ( $j = $m - 1; $j >= 0; $j-- ) {
$lcs[ $i ][ $j ] = ( $old_lines[ $i ] === $new_lines[ $j ] )
? $lcs[ $i + 1 ][ $j + 1 ] + 1
: max( $lcs[ $i + 1 ][ $j ], $lcs[ $i ][ $j + 1 ] );
}
}
$i = $j = 0;
$context = 3;
$pending = [];
while ( $i < $n || $j < $m ) {
if ( $i < $n && $j < $m && $old_lines[ $i ] === $new_lines[ $j ] ) {
$pending[] = [ 'type' => 'ctx', 'line_no' => $j + 1, 'content' => $old_lines[ $i ] ];
$i++;
$j++;
} elseif ( $j < $m && ( $i >= $n || $lcs[ $i ][ $j + 1 ] >= $lcs[ $i + 1 ][ $j ] ) ) {
$diff_lines[] = [ 'type' => 'add', 'line_no' => $j + 1, 'content' => $new_lines[ $j ] ];
$additions++;
$pending = [];
$j++;
} else {
$diff_lines[] = [ 'type' => 'del', 'line_no' => $i + 1, 'content' => $old_lines[ $i ] ];
$deletions++;
$pending = [];
$i++;
}
}
$changes = $additions + $deletions;
return compact( 'diff_lines', 'additions', 'deletions', 'changes' );
}
/**
* AJAX: List .md files in the configured docs directory of the GitHub repo
*/
public function ajax_list_md_files() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_github_list_md_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$docs_dir = trim( $config['docs_directory'], '/' );
$response = $this->list_directory_contents( $config, $docs_dir );
if ( is_wp_error( $response ) ) {
wp_send_json_error( $response->get_error_message() );
}
if ( ! is_array( $response ) ) {
wp_send_json_error( __( 'Unexpected API response', 'betterdocs-pro' ) );
}
// GitHub uses type=file, GitLab uses type=blob.
$file_type = $config['provider'] === 'gitlab' ? 'blob' : 'file';
$files = [];
foreach ( $response as $item ) {
if ( ! is_array( $item ) ) continue;
if ( isset( $item['type'] ) && $item['type'] === $file_type && isset( $item['name'] ) && substr( $item['name'], -3 ) === '.md' ) {
// Check if a doc already exists — by git file path meta or slug
$slug = basename( $item['name'], '.md' );
$existing = get_posts( [
'post_type' => 'docs',
'post_status' => 'any',
'posts_per_page' => 1,
'fields' => 'ids',
// phpcs:disable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- Plugin-controlled meta lookup to map a single git file path to its doc.
'meta_key' => '_betterdocs_git_file_path',
'meta_value' => $item['path'],
// phpcs:enable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value
] );
if ( empty( $existing ) ) {
$existing = get_posts( [
'post_type' => 'docs',
'name' => $slug,
'post_status' => 'any',
'posts_per_page' => 1,
'fields' => 'ids',
] );
}
$files[] = [
'name' => $item['name'],
'path' => $item['path'],
'exists_as_doc' => ! empty( $existing ),
];
}
}
wp_send_json_success( [ 'files' => $files ] );
}
/**
* List directory contents from the configured Git provider.
*
* @param array $config Git config from get_config().
* @param string $dir_path Directory path inside the repository.
* @return array|WP_Error Array of file/tree items or WP_Error.
*/
protected function list_directory_contents( $config, $dir_path ) {
if ( $config['provider'] === 'gitlab' ) {
return $this->list_gitlab_directory( $config, $dir_path );
}
// GitHub
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return $repo_info;
}
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/contents/{$dir_path}";
$api_url .= '?ref=' . urlencode( $config['branch'] );
return $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
}
/**
* List files in a GitLab project directory via the Repository Tree API.
*
* @param array $config Git config from get_config().
* @param string $dir_path Directory path inside the repository.
* @return array|WP_Error Array of tree items or WP_Error.
*/
protected function list_gitlab_directory( $config, $dir_path ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return new \WP_Error( 'missing_project_id', __( 'GitLab Project ID is not configured. Please reconnect your GitLab account in BetterDocs Settings with a valid Project ID.', 'betterdocs-pro' ) );
}
$pid = urlencode( $project_id );
$branch = $config['branch'] ?: 'main';
$token = $config['access_token'];
$api_url = "{$base_url}/api/v4/projects/{$pid}/repository/tree?per_page=100";
$api_url .= '&ref=' . urlencode( $branch );
if ( $dir_path ) {
$api_url .= '&path=' . urlencode( $dir_path );
}
$response = wp_remote_get( $api_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
if ( is_wp_error( $response ) ) {
return $response;
}
$code = wp_remote_retrieve_response_code( $response );
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( $code === 404 ) {
return new \WP_Error( 'directory_not_found', __( 'The configured docs directory was not found in the repository. Please check the directory path in BetterDocs Settings.', 'betterdocs-pro' ) );
}
if ( $code >= 400 ) {
$raw_msg = $body['message'] ?? $body['error'] ?? '';
return new \WP_Error( 'gitlab_api_error', $this->humanize_api_error( $code, $raw_msg, 'gitlab' ) );
}
return is_array( $body ) ? $body : [];
}
/**
* AJAX: Import selected .md files from Git as docs posts
*/
public function ajax_import_md() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_github_import_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
// The React modal sends `files` as a JSON-encoded array (so it can
// pass through application/x-www-form-urlencoded as a single field).
// Plain $_POST won't decode it — we have to do that ourselves before
// iterating, otherwise every fetch would target a literal '["foo.md"]'
// path and fail.
$raw = isset( $_POST['files'] ) ? wp_unslash( $_POST['files'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- JSON blob; each decoded element is sanitized below.
$decoded = is_string( $raw ) ? json_decode( $raw, true ) : null;
if ( ! is_array( $decoded ) ) {
$decoded = is_array( $raw ) ? $raw : ( $raw === '' ? [] : [ $raw ] );
}
$files = [];
foreach ( $decoded as $file ) {
if ( is_string( $file ) && $file !== '' ) {
$files[] = sanitize_text_field( $file );
}
}
if ( empty( $files ) ) {
wp_send_json_error( __( 'No files selected', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$imported = [];
$errors = [];
foreach ( $files as $file_path ) {
$file_path = sanitize_text_field( $file_path );
$response = $this->fetch_from_repository( $file_path, $config );
if ( is_wp_error( $response ) || empty( $response['content'] ) ) {
$errors[] = $file_path;
continue;
}
$md_content = $response['content'];
$sha = $response['sha'] ?? '';
$html = $this->convert_from_markdown( $md_content );
// Extract title from front matter, HTML h1 wrapper, or first Markdown heading
$title = '';
if ( preg_match( '/^---\s*\ntitle:\s*["\']?(.+?)["\']?\s*\n/s', $md_content, $m ) ) {
$title = trim( $m[1], '"\'` ' );
} elseif ( preg_match( '/(.*?)<\/h1>/i', $md_content, $m ) ) {
$title = trim( wp_strip_all_tags( $m[1] ) );
} elseif ( preg_match( '/^#\s+(.+)/m', $md_content, $m ) ) {
$title = trim( $m[1] );
}
if ( empty( $title ) ) {
$title = ucwords( str_replace( [ '-', '_' ], ' ', basename( $file_path, '.md' ) ) );
}
$slug = basename( $file_path, '.md' );
// Check if post already exists — first by git file path meta, then by slug
$existing = get_posts( [
'post_type' => 'docs',
'post_status' => 'any',
'posts_per_page' => 1,
// phpcs:disable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- Plugin-controlled meta lookup to map a single git file path to its doc.
'meta_key' => '_betterdocs_git_file_path',
'meta_value' => $file_path,
// phpcs:enable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value
] );
if ( empty( $existing ) ) {
$existing = get_posts( [
'post_type' => 'docs',
'name' => $slug,
'post_status' => 'any',
'posts_per_page' => 1,
] );
}
if ( $existing ) {
$post_data = [
'ID' => $existing[0]->ID,
'post_content' => $html,
'post_title' => $title,
];
$post_id = wp_update_post( $post_data );
} else {
$post_data = [
'post_type' => 'docs',
'post_title' => $title,
'post_name' => $slug,
'post_content' => $html,
'post_status' => 'publish',
];
$post_id = wp_insert_post( $post_data );
}
if ( $post_id && ! is_wp_error( $post_id ) ) {
update_post_meta( $post_id, '_betterdocs_git_file_path', $file_path );
update_post_meta( $post_id, '_betterdocs_git_sync_status', 'synced' );
update_post_meta( $post_id, '_betterdocs_git_last_sync', current_time( 'mysql' ) );
if ( $sha ) {
update_post_meta( $post_id, '_betterdocs_git_commit_hash', $sha );
}
$imported[] = $post_id;
} else {
$errors[] = $file_path;
}
}
if ( ! empty( $errors ) && empty( $imported ) ) {
/* translators: %s: comma-separated list of file paths that failed to import. */
wp_send_json_error( sprintf( __( 'Failed to import: %s', 'betterdocs-pro' ), implode( ', ', $errors ) ) );
}
wp_send_json_success( [
'imported' => count( $imported ),
'errors' => count( $errors ),
'post_ids' => $imported,
] );
}
// ── End of new AJAX actions ─────────────────────────────────────────────
protected function process_images_for_github( $markdown, $post ) {
// Convert relative image URLs to absolute URLs
$site_url = get_site_url();
// Find all image references in Markdown
$markdown = preg_replace_callback(
'/!\[([^\]]*)\]\(([^)]+)\)/',
function( $matches ) use ( $site_url ) {
$alt_text = $matches[1];
$image_url = $matches[2];
// Convert relative URLs to absolute
if ( strpos( $image_url, 'http' ) !== 0 ) {
if ( strpos( $image_url, '/' ) === 0 ) {
$image_url = $site_url . $image_url;
} else {
$image_url = $site_url . '/' . $image_url;
}
}
return "";
},
$markdown
);
return $markdown;
}
/**
* Convert raw API error responses into clear, actionable messages.
*
* @param int $status_code HTTP status code.
* @param string $raw_message Raw message from the API (e.g. "Not Found").
* @param string $provider 'github' or 'gitlab'.
* @return string
*/
protected function humanize_api_error( $status_code, $raw_message, $provider = 'github' ) {
$label = $provider === 'gitlab' ? 'GitLab' : 'GitHub';
switch ( $status_code ) {
case 401:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Authentication failed — your %s access token is invalid or has expired. Please disconnect and reconnect your account in BetterDocs Settings.', 'betterdocs-pro' ),
$label
);
case 403:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Permission denied — your %s token does not have the required permissions to perform this action. Please ensure it has push/write access to this repository.', 'betterdocs-pro' ),
$label
);
case 404:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Repository or file not found on %s. It may have been deleted, renamed, or your access token no longer has permission to view it. Please verify the repository still exists and your connection is active.', 'betterdocs-pro' ),
$label
);
case 409:
return __( 'Conflict — the file was modified on the remote repository since your last sync. Please pull the latest changes first, then try pushing again.', 'betterdocs-pro' );
case 422:
return sprintf(
/* translators: 1: Git provider name (GitHub or GitLab); 2: raw error message from the provider. */
__( 'The request was rejected by %1$s. This usually means the branch is protected or the commit data is invalid. Details: %2$s', 'betterdocs-pro' ),
$label,
$raw_message
);
case 429:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Rate limit exceeded — too many requests to the %s API. Please wait a few minutes and try again.', 'betterdocs-pro' ),
$label
);
case 500:
case 502:
case 503:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( '%s is temporarily unavailable (server error). Please try again in a few minutes.', 'betterdocs-pro' ),
$label
);
default:
if ( ! empty( $raw_message ) && strtolower( $raw_message ) !== 'not found' ) {
return sprintf(
/* translators: 1: Git provider name (GitHub or GitLab); 2: HTTP status code; 3: raw error message. */
__( '%1$s API error (%2$d): %3$s', 'betterdocs-pro' ),
$label,
$status_code,
$raw_message
);
}
return sprintf(
/* translators: 1: Git provider name (GitHub or GitLab); 2: HTTP status code. */
__( 'An unexpected error occurred while communicating with %1$s (HTTP %2$d). Please check your connection settings and try again.', 'betterdocs-pro' ),
$label,
$status_code
);
}
}
}
title (already handled as post_title)
$content = preg_replace( '/^\s*[^<]*<\/h1>\s*/i', '', $content, 1 );
// Return content as-is from origin without auto-wrapping in Gutenberg
// block comments. Push sends raw post_content, pull restores it raw.
return trim( $content );
}
/**
* Commit content to GitLab repository (placeholder)
*
* @param string $file_path
* @param string $content
* @param WP_Post $post
* @param array $config
* @return array|WP_Error
*/
protected function commit_to_gitlab( $file_path, $content, $post, $config, $commit_message = '' ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return new \WP_Error( 'missing_project_id', __( 'GitLab Project ID is not configured. Please reconnect your GitLab account in BetterDocs Settings with a valid Project ID.', 'betterdocs-pro' ) );
}
$pid = urlencode( $project_id );
$branch = $config['branch'] ?: 'main';
$token = $config['access_token'];
if ( empty( $commit_message ) ) {
$commit_message = sprintf( 'Update %s via BetterDocs', $post->post_title );
}
// Check if file already exists (to decide create vs update action)
$check_url = "{$base_url}/api/v4/projects/{$pid}/repository/files/" . urlencode( $file_path ) . '?ref=' . urlencode( $branch );
$check = wp_remote_get( $check_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
$exists = ! is_wp_error( $check ) && wp_remote_retrieve_response_code( $check ) === 200;
// Detect no-changes: fetch raw file content and compare directly
if ( $exists ) {
$raw_url = "{$base_url}/api/v4/projects/{$pid}/repository/files/" . urlencode( $file_path ) . '/raw?ref=' . urlencode( $branch );
$raw_response = wp_remote_get( $raw_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
if ( ! is_wp_error( $raw_response ) && wp_remote_retrieve_response_code( $raw_response ) === 200 ) {
$remote_content = wp_remote_retrieve_body( $raw_response );
if ( $remote_content === $content ) {
return new \WP_Error( 'no_changes', __( 'No changes to push — content is already up to date.', 'betterdocs-pro' ) );
}
}
}
// GitLab Commits API — single file commit
$api_url = "{$base_url}/api/v4/projects/{$pid}/repository/commits";
$response = wp_remote_post( $api_url, [
'headers' => [
'PRIVATE-TOKEN' => $token,
'Content-Type' => 'application/json',
],
'body' => wp_json_encode( [
'branch' => $branch,
'commit_message' => $commit_message,
'actions' => [
[
'action' => $exists ? 'update' : 'create',
'file_path' => $file_path,
'content' => $content,
],
],
] ),
'timeout' => 30,
] );
if ( is_wp_error( $response ) ) {
return $response;
}
$code = wp_remote_retrieve_response_code( $response );
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( $code >= 400 ) {
$raw_msg = $body['message'] ?? $body['error'] ?? '';
if ( is_array( $raw_msg ) ) $raw_msg = implode( ', ', $raw_msg );
return new \WP_Error( 'gitlab_api_error', $this->humanize_api_error( $code, $raw_msg, 'gitlab' ) );
}
return [
'commit_hash' => $body['id'] ?? '',
'message' => __( 'Pushed to GitLab successfully.', 'betterdocs-pro' ),
];
}
/**
* Commit content to Bitbucket repository (placeholder)
*
* @param string $file_path
* @param string $content
* @param WP_Post $post
* @param array $config
* @return array|WP_Error
*/
protected function commit_to_bitbucket( $file_path, $content, $post, $config ) {
return new \WP_Error( 'not_implemented', __( 'Bitbucket integration not yet implemented', 'betterdocs-pro' ) );
}
/**
* Fetch content from GitLab repository (placeholder)
*
* @param string $file_path
* @param array $config
* @return array|WP_Error
*/
protected function fetch_from_gitlab( $file_path, $config ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return new \WP_Error( 'missing_project_id', __( 'GitLab Project ID is not configured. Please reconnect your GitLab account in BetterDocs Settings with a valid Project ID.', 'betterdocs-pro' ) );
}
$pid = urlencode( $project_id );
$branch = $config['branch'] ?: 'main';
$token = $config['access_token'];
$api_url = "{$base_url}/api/v4/projects/{$pid}/repository/files/" . urlencode( $file_path ) . '?ref=' . urlencode( $branch );
$response = wp_remote_get( $api_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
if ( is_wp_error( $response ) ) {
return $response;
}
$code = wp_remote_retrieve_response_code( $response );
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( $code === 404 ) {
return new \WP_Error( 'github_api_error', __( 'File not found in the repository. It may have been deleted or the file path has changed.', 'betterdocs-pro' ), [ 'status_code' => 404 ] );
}
if ( $code >= 400 ) {
$raw_msg = $body['message'] ?? $body['error'] ?? '';
return new \WP_Error( 'gitlab_api_error', $this->humanize_api_error( $code, $raw_msg, 'gitlab' ) );
}
// GitLab returns file content as base64
$content = isset( $body['content'] ) ? base64_decode( $body['content'] ) : '';
return [
'content' => $content,
'sha' => $body['last_commit_id'] ?? $body['blob_id'] ?? '',
];
}
/**
* Fetch content from Bitbucket repository (placeholder)
*
* @param string $file_path
* @param array $config
* @return array|WP_Error
*/
protected function fetch_from_bitbucket( $file_path, $config ) {
return new \WP_Error( 'not_implemented', __( 'Bitbucket integration not yet implemented', 'betterdocs-pro' ) );
}
/**
* Convert HTML to Markdown
*
* @param string $html
* @return string
*/
protected function html_to_markdown( $html ) {
// Clean up the HTML first
$html = $this->clean_html_for_markdown( $html );
// Convert common HTML elements to Markdown
$conversions = [
// Headers
'/]*>(.*?)<\/h1>/i' => '# $1',
'/]*>(.*?)<\/h2>/i' => '## $1',
'/]*>(.*?)<\/h3>/i' => '### $1',
'/]*>(.*?)<\/h4>/i' => '#### $1',
'/]*>(.*?)<\/h5>/i' => '##### $1',
'/]*>(.*?)<\/h6>/i' => '###### $1',
// Bold and Italic
'/]*>(.*?)<\/strong>/i' => '**$1**',
'/]*>(.*?)<\/b>/i' => '**$1**',
'/]*>(.*?)<\/em>/i' => '*$1*',
'/]*>(.*?)<\/i>/i' => '*$1*',
// Links
'/]*href=["\']([^"\']*)["\'][^>]*>(.*?)<\/a>/i' => '[$2]($1)',
// Images
'/]*src=["\']([^"\']*)["\'][^>]*alt=["\']([^"\']*)["\'][^>]*[\/]?>/i' => '',
'/]*alt=["\']([^"\']*)["\'][^>]*src=["\']([^"\']*)["\'][^>]*[\/]?>/i' => '',
'/]*src=["\']([^"\']*)["\'][^>]*[\/]?>/i' => '',
// Code
'/]*>(.*?)<\/code>/i' => '`$1`',
'/]*>]*>(.*?)<\/code><\/pre>/is' => "```\n$1\n```",
'/]*>(.*?)<\/pre>/is' => "```\n$1\n```",
// Lists
'/]*>/i' => '',
'/<\/ul>/i' => '',
'/]*>/i' => '',
'/<\/ol>/i' => '',
'/]*>(.*?)<\/li>/i' => '- $1',
// Blockquotes
'/]*>(.*?)<\/blockquote>/is' => '> $1',
// Line breaks and paragraphs
'/]*\/?>/i' => "\n",
'/]*>/i' => '',
'/<\/p>/i' => "\n\n",
// Tables (basic)
'/]*>/i' => '',
'/<\/table>/i' => "\n",
'/]*>/i' => '',
'/<\/tr>/i' => "|\n",
'/]*>(.*?)<\/th>/i' => '| $1 ',
'/]*>(.*?)<\/td>/i' => '| $1 ',
// Remove remaining HTML tags
'/<[^>]+>/' => '',
];
foreach ( $conversions as $pattern => $replacement ) {
$html = preg_replace( $pattern, $replacement, $html );
}
// Clean up extra whitespace
$html = preg_replace( '/\n\s*\n\s*\n/', "\n\n", $html );
$html = trim( $html );
// Decode HTML entities
$html = html_entity_decode( $html, ENT_QUOTES, 'UTF-8' );
return $html;
}
/**
* Convert Markdown to HTML
*
* @param string $markdown
* @return string
*/
/**
* Convert Markdown to Gutenberg-compatible block HTML.
*
* Step 1: Convert markdown syntax to HTML using regex (headings, bold, etc.)
* Step 2: Wrap each HTML element in Gutenberg block comments so the editor
* renders proper blocks instead of a single Classic block.
*/
protected function markdown_to_html( $markdown ) {
// Normalize line endings
$markdown = str_replace( "\r\n", "\n", $markdown );
$markdown = str_replace( "\r", "\n", $markdown );
// ── Step 1: Convert Markdown to HTML ──────────────────────────
$conversions = [
// Code blocks (fenced) — must come before inline code
'/```\n(.*?)\n```/s' => '$1
',
// Headers
'/^###### (.*$)/m' => '$1
',
'/^##### (.*$)/m' => '$1
',
'/^#### (.*$)/m' => '$1
',
'/^### (.*$)/m' => '$1
',
'/^## (.*$)/m' => '$1
',
'/^# (.*$)/m' => '$1
',
// Images (before links to avoid conflict)
'/!\[([^\]]*)\]\(([^)]+)\)/' => '',
// Links
'/\[([^\]]+)\]\(([^)]+)\)/' => '$1',
// Bold and Italic
'/\*\*(.*?)\*\*/' => '$1',
'/\*(.*?)\*/' => '$1',
// Inline code
'/`([^`]+)`/' => '$1',
// Lists
'/^- (.*$)/m' => '$1 ',
'/^\* (.*$)/m' => '$1 ',
'/^\d+\. (.*$)/m' => '$1 ',
// Blockquotes
'/^> (.*$)/m' => '$1
',
// Horizontal rules
'/^(---+|\*\*\*+|___+)\s*$/m' => '
',
// Paragraphs — double newlines become paragraph breaks
'/\n\n/' => '',
];
foreach ( $conversions as $pattern => $replacement ) {
$markdown = preg_replace( $pattern, $replacement, $markdown );
}
// Wrap in paragraphs
$html = '
' . $markdown . '
';
// Clean up empty paragraphs
$html = preg_replace( '/\s*<\/p>/', '', $html );
// Fix list wrapping — consecutive
inside become
$html = preg_replace( '/(
- .*?<\/li>)<\/p>/s', '
$1
', $html );
$html = preg_replace( '/<\/li>\s* - /', '
- ', $html );
// Fix blockquote wrapping
$html = preg_replace( '/
(
.*?<\/blockquote>)<\/p>/s', '$1', $html );
// ── Step 2: Wrap HTML elements in Gutenberg block comments ────
// Headings
for ( $i = 1; $i <= 6; $i++ ) {
$attrs = $i !== 2 ? ' {"level":' . $i . '}' : '';
$html = preg_replace(
'/(.*?)<\/h' . $i . '>/s',
"\n$1 \n",
$html
);
}
// Code blocks
$html = preg_replace(
'/(.*?)<\/code><\/pre>/s',
"\n$1
\n",
$html
);
// Lists
$html = preg_replace(
'/(.*?)<\/ul>/s',
"\n$1
\n",
$html
);
// Blockquotes
$html = preg_replace(
'/(.*?)<\/blockquote>/s',
"\n$1
\n",
$html
);
// Images
$html = preg_replace(
'//',
"\n
/',
"\n
\n",
$html
);
// Paragraphs — wrap remaining ...
that aren't already inside a block
$html = preg_replace(
'/(?)\s*(.*?)<\/p>/s',
"\n\n
$1
\n",
$html
);
// Clean up whitespace
$html = preg_replace( '/\n{3,}/', "\n\n", $html );
$html = trim( $html );
return $html;
}
/**
* Clean HTML for better Markdown conversion
*
* @param string $html
* @return string
*/
protected function clean_html_for_markdown( $html ) {
// Remove WordPress-specific elements that don't translate well
$html = preg_replace( '/]*class="[^"]*wp-block[^"]*"[^>]*>/i', '', $html );
// Remove empty paragraphs
$html = preg_replace( '/]*>\s*<\/p>/i', '', $html );
// Convert WordPress image captions
$html = preg_replace(
'/]*class="[^"]*wp-caption[^"]*"[^>]*>.*?]*)>.*?]*class="[^"]*wp-caption-text[^"]*"[^>]*>(.*?)<\/p>.*?<\/div>/is',
']*src=["\']([^"\']*)["\'][^>]*>(.*)$/s', $caption_content, $img_matches ) ) {
$img_src = $img_matches[1];
$caption_text = wp_strip_all_tags( trim( $img_matches[2] ) );
return "\n\n*{$caption_text}*\n\n";
}
return $caption_content;
},
$content
);
// Convert [code] shortcode
$content = preg_replace( '/\[code[^\]]*\](.*?)\[\/code\]/s', "```\n$1\n```", $content );
// Convert [quote] shortcode
$content = preg_replace( '/\[quote[^\]]*\](.*?)\[\/quote\]/s', "> $1", $content );
// Remove other shortcodes that don't have good Markdown equivalents
$content = preg_replace( '/\[[^\]]+\]/', '', $content );
return $content;
}
/**
* Process images for GitHub compatibility
*
* @param string $markdown
* @param WP_Post $post
* @return string
*/
// ── New AJAX actions for GitHub Sync toolbar button ────────────────────
/**
* AJAX: Get diff between current post content and the version in GitHub
*/
public function ajax_get_diff() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_github_diff_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$post_id = isset( $_POST['post_id'] ) ? intval( wp_unslash( $_POST['post_id'] ) ) : 0;
$post = get_post( $post_id );
if ( ! $post || $post->post_type !== 'docs' ) {
wp_send_json_error( __( 'This document could not be found or is not a valid BetterDocs article.', 'betterdocs-pro' ) );
}
// Auto-drafts with no real content should show "no changes".
if ( $post->post_status === 'auto-draft' && empty( trim( $post->post_content ) ) ) {
wp_send_json_success( [
'diff_lines' => [],
'additions' => 0,
'deletions' => 0,
'changes' => 0,
] );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$file_path = $this->resolve_file_path( $post_id, $post );
// Fetch remote version
$remote = $this->fetch_from_repository( $file_path, $config );
if ( is_wp_error( $remote ) ) {
// If file not found remotely, the whole doc is "new"
$local_md = $this->convert_to_markdown( $post );
$lines = explode( "\n", $local_md );
$diff_lines = [];
foreach ( $lines as $i => $line ) {
$diff_lines[] = [ 'type' => 'add', 'line_no' => $i + 1, 'content' => $line ];
}
wp_send_json_success( [
'diff_lines' => $diff_lines,
'additions' => count( $lines ),
'deletions' => 0,
'changes' => count( $lines ),
] );
}
$local_md = $this->convert_to_markdown( $post );
$remote_md = $remote['content'];
$diff_result = $this->compute_diff( $remote_md, $local_md );
wp_send_json_success( $diff_result );
}
/**
* AJAX handler for "Fetch" — returns diff + remote branch status (commits behind).
* Used by the editor dropdown to show a GitHub-Desktop-style fetch indicator.
*/
public function ajax_fetch_status() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_git_fetch_status_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$post_id = isset( $_POST['post_id'] ) ? intval( wp_unslash( $_POST['post_id'] ) ) : 0;
$post = get_post( $post_id );
if ( ! $post || $post->post_type !== 'docs' ) {
wp_send_json_error( __( 'This document could not be found or is not a valid BetterDocs article.', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$file_path = $this->resolve_file_path( $post_id, $post );
// Diff portion (same logic as ajax_get_diff).
$diff_result = [
'diff_lines' => [],
'additions' => 0,
'deletions' => 0,
'changes' => 0,
];
$remote_exists = true;
if ( $post->post_status === 'auto-draft' && empty( trim( $post->post_content ) ) ) {
// keep default
} else {
$remote = $this->fetch_from_repository( $file_path, $config );
if ( is_wp_error( $remote ) ) {
$remote_exists = false;
$local_md = $this->convert_to_markdown( $post );
$lines = explode( "\n", $local_md );
$add = [];
foreach ( $lines as $i => $line ) {
$add[] = [ 'type' => 'add', 'line_no' => $i + 1, 'content' => $line ];
}
$diff_result = [
'diff_lines' => $add,
'additions' => count( $lines ),
'deletions' => 0,
'changes' => count( $lines ),
];
} else {
$local_md = $this->convert_to_markdown( $post );
$diff_result = $this->compute_diff( $remote['content'], $local_md );
}
}
// Remote branch status.
$last_pushed_hash = get_post_meta( $post_id, '_betterdocs_git_commit_hash', true );
$behind = $this->get_commits_behind( $last_pushed_hash, $config );
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
wp_send_json_success( array_merge( $diff_result, [
'branch' => $branch,
'remote_exists' => $remote_exists,
'behind_by' => is_array( $behind ) && isset( $behind['behind_by'] ) ? intval( $behind['behind_by'] ) : null,
'latest_commit' => is_array( $behind ) && isset( $behind['latest_commit'] ) ? $behind['latest_commit'] : null,
'has_last_pushed' => ! empty( $last_pushed_hash ),
] ) );
}
/**
* Return recent commits touching the current doc's file (or the branch
* when the file isn't tracked yet) for the History tab.
*/
public function ajax_commit_history() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_git_commit_history_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$post_id = isset( $_POST['post_id'] ) ? intval( wp_unslash( $_POST['post_id'] ) ) : 0;
$post = get_post( $post_id );
if ( ! $post || $post->post_type !== 'docs' ) {
wp_send_json_error( __( 'This document could not be found or is not a valid BetterDocs article.', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$file_path = $this->resolve_file_path( $post_id, $post );
$commits = $this->get_commit_history( $file_path, $config, 15 );
wp_send_json_success( [
'commits' => is_array( $commits ) ? $commits : [],
'branch' => isset( $config['branch'] ) ? $config['branch'] : 'main',
] );
}
protected function get_commit_history( $file_path, $config, $limit = 15 ) {
$provider = isset( $config['provider'] ) ? $config['provider'] : 'github';
if ( $provider === 'gitlab' ) {
return $this->get_gitlab_commit_history( $file_path, $config, $limit );
}
return $this->get_github_commit_history( $file_path, $config, $limit );
}
protected function get_github_commit_history( $file_path, $config, $limit = 15 ) {
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return [];
}
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
$args = [ 'sha' => $branch, 'per_page' => $limit ];
if ( ! empty( $file_path ) ) {
$args['path'] = $file_path;
}
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/commits?" . http_build_query( $args );
$response = $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
if ( is_wp_error( $response ) || ! is_array( $response ) ) {
return [];
}
$out = [];
foreach ( $response as $c ) {
if ( ! is_array( $c ) ) {
continue;
}
$sha_full = isset( $c['sha'] ) ? $c['sha'] : '';
$out[] = [
'sha' => $sha_full ? substr( $sha_full, 0, 7 ) : '',
'sha_full'=> $sha_full,
'message' => isset( $c['commit']['message'] ) ? strtok( $c['commit']['message'], "\n" ) : '',
'author' => isset( $c['commit']['author']['name'] ) ? $c['commit']['author']['name'] : '',
'avatar' => isset( $c['author']['avatar_url'] ) ? $c['author']['avatar_url'] : '',
'date' => isset( $c['commit']['author']['date'] ) ? $c['commit']['author']['date'] : '',
'url' => isset( $c['html_url'] ) ? $c['html_url'] : '',
];
}
return $out;
}
protected function get_gitlab_commit_history( $file_path, $config, $limit = 15 ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return [];
}
$pid = urlencode( $project_id );
$args = [
'ref_name' => isset( $config['branch'] ) ? $config['branch'] : 'main',
'per_page' => $limit,
];
if ( ! empty( $file_path ) ) {
$args['path'] = $file_path;
}
$url = "{$base_url}/api/v4/projects/{$pid}/repository/commits?" . http_build_query( $args );
$res = wp_remote_get( $url, [
'headers' => [ 'PRIVATE-TOKEN' => $config['access_token'] ],
'timeout' => 15,
] );
if ( is_wp_error( $res ) || wp_remote_retrieve_response_code( $res ) >= 400 ) {
return [];
}
$body = json_decode( wp_remote_retrieve_body( $res ), true );
if ( ! is_array( $body ) ) {
return [];
}
$out = [];
foreach ( $body as $c ) {
$out[] = [
'sha' => isset( $c['short_id'] ) ? $c['short_id'] : '',
'sha_full'=> isset( $c['id'] ) ? $c['id'] : '',
'message' => isset( $c['title'] ) ? $c['title'] : '',
'author' => isset( $c['author_name'] ) ? $c['author_name'] : '',
'avatar' => '',
'date' => isset( $c['created_at'] ) ? $c['created_at'] : '',
'url' => isset( $c['web_url'] ) ? $c['web_url'] : '',
];
}
return $out;
}
/**
* Compare a stored local commit hash with the current remote branch HEAD.
* Returns ['behind_by' => int, 'latest_commit' => [...]] or null when the
* count cannot be determined (e.g. no prior push, provider unsupported).
*/
protected function get_commits_behind( $last_hash, $config ) {
$provider = isset( $config['provider'] ) ? $config['provider'] : 'github';
if ( empty( $last_hash ) ) {
$latest = $this->get_latest_commit( $config );
if ( $latest ) {
return [ 'behind_by' => null, 'latest_commit' => $latest ];
}
return null;
}
if ( $provider === 'gitlab' ) {
return $this->get_gitlab_commits_behind( $last_hash, $config );
}
return $this->get_github_commits_behind( $last_hash, $config );
}
protected function get_github_commits_behind( $last_hash, $config ) {
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return null;
}
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/compare/" . rawurlencode( $last_hash ) . '...' . rawurlencode( $branch );
$response = $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
if ( is_wp_error( $response ) || ! is_array( $response ) ) {
return null;
}
$latest = null;
if ( ! empty( $response['commits'] ) && is_array( $response['commits'] ) ) {
$last = end( $response['commits'] );
if ( is_array( $last ) ) {
$latest = [
'sha' => isset( $last['sha'] ) ? substr( $last['sha'], 0, 7 ) : '',
'message' => isset( $last['commit']['message'] ) ? strtok( $last['commit']['message'], "\n" ) : '',
'author' => isset( $last['commit']['author']['name'] ) ? $last['commit']['author']['name'] : '',
'date' => isset( $last['commit']['author']['date'] ) ? $last['commit']['author']['date'] : '',
];
}
}
return [
'behind_by' => isset( $response['behind_by'] ) ? intval( $response['behind_by'] ) : 0,
'latest_commit' => $latest,
];
}
protected function get_gitlab_commits_behind( $last_hash, $config ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return null;
}
$pid = urlencode( $project_id );
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
$url = "{$base_url}/api/v4/projects/{$pid}/repository/compare?from=" . rawurlencode( $last_hash ) . '&to=' . rawurlencode( $branch );
$response = wp_remote_get( $url, [
'headers' => [ 'PRIVATE-TOKEN' => $config['access_token'] ],
'timeout' => 15,
] );
if ( is_wp_error( $response ) ) {
return null;
}
$code = wp_remote_retrieve_response_code( $response );
if ( $code >= 400 ) {
return null;
}
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( ! is_array( $body ) ) {
return null;
}
$commits = isset( $body['commits'] ) && is_array( $body['commits'] ) ? $body['commits'] : [];
$latest = null;
if ( ! empty( $commits ) ) {
$last = end( $commits );
$latest = [
'sha' => isset( $last['short_id'] ) ? $last['short_id'] : '',
'message' => isset( $last['title'] ) ? $last['title'] : '',
'author' => isset( $last['author_name'] ) ? $last['author_name'] : '',
'date' => isset( $last['created_at'] ) ? $last['created_at'] : '',
];
}
return [
'behind_by' => count( $commits ),
'latest_commit' => $latest,
];
}
/**
* Fetch the latest branch commit when we have no local hash to compare against.
*/
protected function get_latest_commit( $config ) {
$provider = isset( $config['provider'] ) ? $config['provider'] : 'github';
$branch = isset( $config['branch'] ) ? $config['branch'] : 'main';
if ( $provider === 'gitlab' ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return null;
}
$pid = urlencode( $project_id );
$url = "{$base_url}/api/v4/projects/{$pid}/repository/commits?ref_name=" . rawurlencode( $branch ) . '&per_page=1';
$res = wp_remote_get( $url, [
'headers' => [ 'PRIVATE-TOKEN' => $config['access_token'] ],
'timeout' => 15,
] );
if ( is_wp_error( $res ) || wp_remote_retrieve_response_code( $res ) >= 400 ) {
return null;
}
$body = json_decode( wp_remote_retrieve_body( $res ), true );
if ( ! is_array( $body ) || empty( $body[0] ) ) {
return null;
}
$c = $body[0];
return [
'sha' => isset( $c['short_id'] ) ? $c['short_id'] : '',
'message' => isset( $c['title'] ) ? $c['title'] : '',
'author' => isset( $c['author_name'] ) ? $c['author_name'] : '',
'date' => isset( $c['created_at'] ) ? $c['created_at'] : '',
];
}
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return null;
}
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/commits?sha=" . rawurlencode( $branch ) . '&per_page=1';
$res = $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
if ( is_wp_error( $res ) || ! is_array( $res ) || empty( $res[0] ) ) {
return null;
}
$c = $res[0];
return [
'sha' => isset( $c['sha'] ) ? substr( $c['sha'], 0, 7 ) : '',
'message' => isset( $c['commit']['message'] ) ? strtok( $c['commit']['message'], "\n" ) : '',
'author' => isset( $c['commit']['author']['name'] ) ? $c['commit']['author']['name'] : '',
'date' => isset( $c['commit']['author']['date'] ) ? $c['commit']['author']['date'] : '',
];
}
/**
* Compute a simple unified diff between two strings.
* Returns structured diff lines for the frontend renderer.
*
* @param string $old
* @param string $new
* @return array
*/
protected function compute_diff( $old, $new ) {
$old_lines = explode( "\n", $old );
$new_lines = explode( "\n", $new );
$diff_lines = [];
$additions = 0;
$deletions = 0;
// Use a simple LCS-based diff
$n = count( $old_lines );
$m = count( $new_lines );
// Build LCS table (limit to 500 lines each to avoid memory issues)
$max = 500;
if ( $n > $max || $m > $max ) {
// Fallback: treat entire file as changed
foreach ( $old_lines as $i => $line ) {
$diff_lines[] = [ 'type' => 'del', 'line_no' => $i + 1, 'content' => $line ];
$deletions++;
}
foreach ( $new_lines as $i => $line ) {
$diff_lines[] = [ 'type' => 'add', 'line_no' => $i + 1, 'content' => $line ];
$additions++;
}
return compact( 'diff_lines', 'additions', 'deletions' ) + [ 'changes' => $additions + $deletions ];
}
$lcs = array_fill( 0, $n + 1, array_fill( 0, $m + 1, 0 ) );
for ( $i = $n - 1; $i >= 0; $i-- ) {
for ( $j = $m - 1; $j >= 0; $j-- ) {
$lcs[ $i ][ $j ] = ( $old_lines[ $i ] === $new_lines[ $j ] )
? $lcs[ $i + 1 ][ $j + 1 ] + 1
: max( $lcs[ $i + 1 ][ $j ], $lcs[ $i ][ $j + 1 ] );
}
}
$i = $j = 0;
$context = 3;
$pending = [];
while ( $i < $n || $j < $m ) {
if ( $i < $n && $j < $m && $old_lines[ $i ] === $new_lines[ $j ] ) {
$pending[] = [ 'type' => 'ctx', 'line_no' => $j + 1, 'content' => $old_lines[ $i ] ];
$i++;
$j++;
} elseif ( $j < $m && ( $i >= $n || $lcs[ $i ][ $j + 1 ] >= $lcs[ $i + 1 ][ $j ] ) ) {
$diff_lines[] = [ 'type' => 'add', 'line_no' => $j + 1, 'content' => $new_lines[ $j ] ];
$additions++;
$pending = [];
$j++;
} else {
$diff_lines[] = [ 'type' => 'del', 'line_no' => $i + 1, 'content' => $old_lines[ $i ] ];
$deletions++;
$pending = [];
$i++;
}
}
$changes = $additions + $deletions;
return compact( 'diff_lines', 'additions', 'deletions', 'changes' );
}
/**
* AJAX: List .md files in the configured docs directory of the GitHub repo
*/
public function ajax_list_md_files() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_github_list_md_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$docs_dir = trim( $config['docs_directory'], '/' );
$response = $this->list_directory_contents( $config, $docs_dir );
if ( is_wp_error( $response ) ) {
wp_send_json_error( $response->get_error_message() );
}
if ( ! is_array( $response ) ) {
wp_send_json_error( __( 'Unexpected API response', 'betterdocs-pro' ) );
}
// GitHub uses type=file, GitLab uses type=blob.
$file_type = $config['provider'] === 'gitlab' ? 'blob' : 'file';
$files = [];
foreach ( $response as $item ) {
if ( ! is_array( $item ) ) continue;
if ( isset( $item['type'] ) && $item['type'] === $file_type && isset( $item['name'] ) && substr( $item['name'], -3 ) === '.md' ) {
// Check if a doc already exists — by git file path meta or slug
$slug = basename( $item['name'], '.md' );
$existing = get_posts( [
'post_type' => 'docs',
'post_status' => 'any',
'posts_per_page' => 1,
'fields' => 'ids',
// phpcs:disable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- Plugin-controlled meta lookup to map a single git file path to its doc.
'meta_key' => '_betterdocs_git_file_path',
'meta_value' => $item['path'],
// phpcs:enable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value
] );
if ( empty( $existing ) ) {
$existing = get_posts( [
'post_type' => 'docs',
'name' => $slug,
'post_status' => 'any',
'posts_per_page' => 1,
'fields' => 'ids',
] );
}
$files[] = [
'name' => $item['name'],
'path' => $item['path'],
'exists_as_doc' => ! empty( $existing ),
];
}
}
wp_send_json_success( [ 'files' => $files ] );
}
/**
* List directory contents from the configured Git provider.
*
* @param array $config Git config from get_config().
* @param string $dir_path Directory path inside the repository.
* @return array|WP_Error Array of file/tree items or WP_Error.
*/
protected function list_directory_contents( $config, $dir_path ) {
if ( $config['provider'] === 'gitlab' ) {
return $this->list_gitlab_directory( $config, $dir_path );
}
// GitHub
$repo_info = $this->parse_github_url( $config['repository_url'] );
if ( is_wp_error( $repo_info ) ) {
return $repo_info;
}
$api_url = "https://api.github.com/repos/{$repo_info['owner']}/{$repo_info['repo']}/contents/{$dir_path}";
$api_url .= '?ref=' . urlencode( $config['branch'] );
return $this->github_api_request( $api_url, 'GET', null, $config['access_token'] );
}
/**
* List files in a GitLab project directory via the Repository Tree API.
*
* @param array $config Git config from get_config().
* @param string $dir_path Directory path inside the repository.
* @return array|WP_Error Array of tree items or WP_Error.
*/
protected function list_gitlab_directory( $config, $dir_path ) {
$oauth_user = get_option( GitHubOAuth::USER_OPTION, [] );
$project_id = $oauth_user['project_id'] ?? $config['repository_url'] ?? '';
$base_url = $oauth_user['instance_url'] ?? 'https://gitlab.com';
if ( empty( $project_id ) ) {
return new \WP_Error( 'missing_project_id', __( 'GitLab Project ID is not configured. Please reconnect your GitLab account in BetterDocs Settings with a valid Project ID.', 'betterdocs-pro' ) );
}
$pid = urlencode( $project_id );
$branch = $config['branch'] ?: 'main';
$token = $config['access_token'];
$api_url = "{$base_url}/api/v4/projects/{$pid}/repository/tree?per_page=100";
$api_url .= '&ref=' . urlencode( $branch );
if ( $dir_path ) {
$api_url .= '&path=' . urlencode( $dir_path );
}
$response = wp_remote_get( $api_url, [
'headers' => [ 'PRIVATE-TOKEN' => $token ],
'timeout' => 15,
] );
if ( is_wp_error( $response ) ) {
return $response;
}
$code = wp_remote_retrieve_response_code( $response );
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( $code === 404 ) {
return new \WP_Error( 'directory_not_found', __( 'The configured docs directory was not found in the repository. Please check the directory path in BetterDocs Settings.', 'betterdocs-pro' ) );
}
if ( $code >= 400 ) {
$raw_msg = $body['message'] ?? $body['error'] ?? '';
return new \WP_Error( 'gitlab_api_error', $this->humanize_api_error( $code, $raw_msg, 'gitlab' ) );
}
return is_array( $body ) ? $body : [];
}
/**
* AJAX: Import selected .md files from Git as docs posts
*/
public function ajax_import_md() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['nonce'] ) ), 'betterdocs_github_import_nonce' ) ) {
wp_send_json_error( __( 'Invalid nonce', 'betterdocs-pro' ) );
}
if ( ! current_user_can( 'edit_docs' ) ) {
wp_send_json_error( __( 'Insufficient permissions', 'betterdocs-pro' ) );
}
// The React modal sends `files` as a JSON-encoded array (so it can
// pass through application/x-www-form-urlencoded as a single field).
// Plain $_POST won't decode it — we have to do that ourselves before
// iterating, otherwise every fetch would target a literal '["foo.md"]'
// path and fail.
$raw = isset( $_POST['files'] ) ? wp_unslash( $_POST['files'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- JSON blob; each decoded element is sanitized below.
$decoded = is_string( $raw ) ? json_decode( $raw, true ) : null;
if ( ! is_array( $decoded ) ) {
$decoded = is_array( $raw ) ? $raw : ( $raw === '' ? [] : [ $raw ] );
}
$files = [];
foreach ( $decoded as $file ) {
if ( is_string( $file ) && $file !== '' ) {
$files[] = sanitize_text_field( $file );
}
}
if ( empty( $files ) ) {
wp_send_json_error( __( 'No files selected', 'betterdocs-pro' ) );
}
$config = $this->get_config();
if ( empty( $config['repository_url'] ) || empty( $config['access_token'] ) ) {
wp_send_json_error( __( 'Git integration is not fully configured. Please connect your account and select a repository in BetterDocs Settings.', 'betterdocs-pro' ) );
}
$imported = [];
$errors = [];
foreach ( $files as $file_path ) {
$file_path = sanitize_text_field( $file_path );
$response = $this->fetch_from_repository( $file_path, $config );
if ( is_wp_error( $response ) || empty( $response['content'] ) ) {
$errors[] = $file_path;
continue;
}
$md_content = $response['content'];
$sha = $response['sha'] ?? '';
$html = $this->convert_from_markdown( $md_content );
// Extract title from front matter, HTML h1 wrapper, or first Markdown heading
$title = '';
if ( preg_match( '/^---\s*\ntitle:\s*["\']?(.+?)["\']?\s*\n/s', $md_content, $m ) ) {
$title = trim( $m[1], '"\'` ' );
} elseif ( preg_match( '/(.*?)<\/h1>/i', $md_content, $m ) ) {
$title = trim( wp_strip_all_tags( $m[1] ) );
} elseif ( preg_match( '/^#\s+(.+)/m', $md_content, $m ) ) {
$title = trim( $m[1] );
}
if ( empty( $title ) ) {
$title = ucwords( str_replace( [ '-', '_' ], ' ', basename( $file_path, '.md' ) ) );
}
$slug = basename( $file_path, '.md' );
// Check if post already exists — first by git file path meta, then by slug
$existing = get_posts( [
'post_type' => 'docs',
'post_status' => 'any',
'posts_per_page' => 1,
// phpcs:disable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- Plugin-controlled meta lookup to map a single git file path to its doc.
'meta_key' => '_betterdocs_git_file_path',
'meta_value' => $file_path,
// phpcs:enable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value
] );
if ( empty( $existing ) ) {
$existing = get_posts( [
'post_type' => 'docs',
'name' => $slug,
'post_status' => 'any',
'posts_per_page' => 1,
] );
}
if ( $existing ) {
$post_data = [
'ID' => $existing[0]->ID,
'post_content' => $html,
'post_title' => $title,
];
$post_id = wp_update_post( $post_data );
} else {
$post_data = [
'post_type' => 'docs',
'post_title' => $title,
'post_name' => $slug,
'post_content' => $html,
'post_status' => 'publish',
];
$post_id = wp_insert_post( $post_data );
}
if ( $post_id && ! is_wp_error( $post_id ) ) {
update_post_meta( $post_id, '_betterdocs_git_file_path', $file_path );
update_post_meta( $post_id, '_betterdocs_git_sync_status', 'synced' );
update_post_meta( $post_id, '_betterdocs_git_last_sync', current_time( 'mysql' ) );
if ( $sha ) {
update_post_meta( $post_id, '_betterdocs_git_commit_hash', $sha );
}
$imported[] = $post_id;
} else {
$errors[] = $file_path;
}
}
if ( ! empty( $errors ) && empty( $imported ) ) {
/* translators: %s: comma-separated list of file paths that failed to import. */
wp_send_json_error( sprintf( __( 'Failed to import: %s', 'betterdocs-pro' ), implode( ', ', $errors ) ) );
}
wp_send_json_success( [
'imported' => count( $imported ),
'errors' => count( $errors ),
'post_ids' => $imported,
] );
}
// ── End of new AJAX actions ─────────────────────────────────────────────
protected function process_images_for_github( $markdown, $post ) {
// Convert relative image URLs to absolute URLs
$site_url = get_site_url();
// Find all image references in Markdown
$markdown = preg_replace_callback(
'/!\[([^\]]*)\]\(([^)]+)\)/',
function( $matches ) use ( $site_url ) {
$alt_text = $matches[1];
$image_url = $matches[2];
// Convert relative URLs to absolute
if ( strpos( $image_url, 'http' ) !== 0 ) {
if ( strpos( $image_url, '/' ) === 0 ) {
$image_url = $site_url . $image_url;
} else {
$image_url = $site_url . '/' . $image_url;
}
}
return "";
},
$markdown
);
return $markdown;
}
/**
* Convert raw API error responses into clear, actionable messages.
*
* @param int $status_code HTTP status code.
* @param string $raw_message Raw message from the API (e.g. "Not Found").
* @param string $provider 'github' or 'gitlab'.
* @return string
*/
protected function humanize_api_error( $status_code, $raw_message, $provider = 'github' ) {
$label = $provider === 'gitlab' ? 'GitLab' : 'GitHub';
switch ( $status_code ) {
case 401:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Authentication failed — your %s access token is invalid or has expired. Please disconnect and reconnect your account in BetterDocs Settings.', 'betterdocs-pro' ),
$label
);
case 403:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Permission denied — your %s token does not have the required permissions to perform this action. Please ensure it has push/write access to this repository.', 'betterdocs-pro' ),
$label
);
case 404:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Repository or file not found on %s. It may have been deleted, renamed, or your access token no longer has permission to view it. Please verify the repository still exists and your connection is active.', 'betterdocs-pro' ),
$label
);
case 409:
return __( 'Conflict — the file was modified on the remote repository since your last sync. Please pull the latest changes first, then try pushing again.', 'betterdocs-pro' );
case 422:
return sprintf(
/* translators: 1: Git provider name (GitHub or GitLab); 2: raw error message from the provider. */
__( 'The request was rejected by %1$s. This usually means the branch is protected or the commit data is invalid. Details: %2$s', 'betterdocs-pro' ),
$label,
$raw_message
);
case 429:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( 'Rate limit exceeded — too many requests to the %s API. Please wait a few minutes and try again.', 'betterdocs-pro' ),
$label
);
case 500:
case 502:
case 503:
return sprintf(
/* translators: %s: Git provider name (GitHub or GitLab). */
__( '%s is temporarily unavailable (server error). Please try again in a few minutes.', 'betterdocs-pro' ),
$label
);
default:
if ( ! empty( $raw_message ) && strtolower( $raw_message ) !== 'not found' ) {
return sprintf(
/* translators: 1: Git provider name (GitHub or GitLab); 2: HTTP status code; 3: raw error message. */
__( '%1$s API error (%2$d): %3$s', 'betterdocs-pro' ),
$label,
$status_code,
$raw_message
);
}
return sprintf(
/* translators: 1: Git provider name (GitHub or GitLab); 2: HTTP status code. */
__( 'An unexpected error occurred while communicating with %1$s (HTTP %2$d). Please check your connection settings and try again.', 'betterdocs-pro' ),
$label,
$status_code
);
}
}
}
$1$1
', '/^##### (.*$)/m' => '$1
', '/^#### (.*$)/m' => '$1
', '/^### (.*$)/m' => '$1
', '/^## (.*$)/m' => '$1
', '/^# (.*$)/m' => '$1
', // Images (before links to avoid conflict) '/!\[([^\]]*)\]\(([^)]+)\)/' => '$1',
// Lists
'/^- (.*$)/m' => '$1', // Horizontal rules '/^(---+|\*\*\*+|___+)\s*$/m' => '
', // Paragraphs — double newlines become paragraph breaks '/\n\n/' => '
', ]; foreach ( $conversions as $pattern => $replacement ) { $markdown = preg_replace( $pattern, $replacement, $markdown ); } // Wrap in paragraphs $html = '
' . $markdown . '
'; // Clean up empty paragraphs $html = preg_replace( '/\s*<\/p>/', '', $html ); // Fix list wrapping — consecutive
become
-
$html = preg_replace( '/
- .*?<\/li>)<\/p>/s', '
- $1
- /', '
- ', $html );
// Fix blockquote wrapping
$html = preg_replace( '/
(
.*?<\/blockquote>)<\/p>/s', '$1', $html ); // ── Step 2: Wrap HTML elements in Gutenberg block comments ──── // Headings for ( $i = 1; $i <= 6; $i++ ) { $attrs = $i !== 2 ? ' {"level":' . $i . '}' : ''; $html = preg_replace( '/
(.*?)<\/code><\/pre>/s', "\n
\n", $html ); // Lists $html = preg_replace( '/$1- (.*?)<\/ul>/s',
"\n
- $1
(.*?)<\/blockquote>/s', "\n
\n", $html ); // Images $html = preg_replace( '/$1
/', "\n
\n", $html ); // Paragraphs — wrap remaining...
that aren't already inside a block $html = preg_replace( '/(?)\s*(.*?)<\/p>/s', "\n\n
$1
\n", $html ); // Clean up whitespace $html = preg_replace( '/\n{3,}/', "\n\n", $html ); $html = trim( $html ); return $html; } /** * Clean HTML for better Markdown conversion * * @param string $html * @return string */ protected function clean_html_for_markdown( $html ) { // Remove WordPress-specific elements that don't translate well $html = preg_replace( '/', $html ); // Remove empty paragraphs $html = preg_replace( '/(.*?)<\/h1>/i', $md_content, $m ) ) { $title = trim( wp_strip_all_tags( $m[1] ) ); } elseif ( preg_match( '/^#\s+(.+)/m', $md_content, $m ) ) { $title = trim( $m[1] ); } if ( empty( $title ) ) { $title = ucwords( str_replace( [ '-', '_' ], ' ', basename( $file_path, '.md' ) ) ); } $slug = basename( $file_path, '.md' ); // Check if post already exists — first by git file path meta, then by slug $existing = get_posts( [ 'post_type' => 'docs', 'post_status' => 'any', 'posts_per_page' => 1, // phpcs:disable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value -- Plugin-controlled meta lookup to map a single git file path to its doc. 'meta_key' => '_betterdocs_git_file_path', 'meta_value' => $file_path, // phpcs:enable WordPress.DB.SlowDBQuery.slow_db_query_meta_key, WordPress.DB.SlowDBQuery.slow_db_query_meta_value ] ); if ( empty( $existing ) ) { $existing = get_posts( [ 'post_type' => 'docs', 'name' => $slug, 'post_status' => 'any', 'posts_per_page' => 1, ] ); } if ( $existing ) { $post_data = [ 'ID' => $existing[0]->ID, 'post_content' => $html, 'post_title' => $title, ]; $post_id = wp_update_post( $post_data ); } else { $post_data = [ 'post_type' => 'docs', 'post_title' => $title, 'post_name' => $slug, 'post_content' => $html, 'post_status' => 'publish', ]; $post_id = wp_insert_post( $post_data ); } if ( $post_id && ! is_wp_error( $post_id ) ) { update_post_meta( $post_id, '_betterdocs_git_file_path', $file_path ); update_post_meta( $post_id, '_betterdocs_git_sync_status', 'synced' ); update_post_meta( $post_id, '_betterdocs_git_last_sync', current_time( 'mysql' ) ); if ( $sha ) { update_post_meta( $post_id, '_betterdocs_git_commit_hash', $sha ); } $imported[] = $post_id; } else { $errors[] = $file_path; } } if ( ! empty( $errors ) && empty( $imported ) ) { /* translators: %s: comma-separated list of file paths that failed to import. */ wp_send_json_error( sprintf( __( 'Failed to import: %s', 'betterdocs-pro' ), implode( ', ', $errors ) ) ); } wp_send_json_success( [ 'imported' => count( $imported ), 'errors' => count( $errors ), 'post_ids' => $imported, ] ); } // ── End of new AJAX actions ───────────────────────────────────────────── protected function process_images_for_github( $markdown, $post ) { // Convert relative image URLs to absolute URLs $site_url = get_site_url(); // Find all image references in Markdown $markdown = preg_replace_callback( '/!\[([^\]]*)\]\(([^)]+)\)/', function( $matches ) use ( $site_url ) { $alt_text = $matches[1]; $image_url = $matches[2]; // Convert relative URLs to absolute if ( strpos( $image_url, 'http' ) !== 0 ) { if ( strpos( $image_url, '/' ) === 0 ) { $image_url = $site_url . $image_url; } else { $image_url = $site_url . '/' . $image_url; } } return ""; }, $markdown ); return $markdown; } /** * Convert raw API error responses into clear, actionable messages. * * @param int $status_code HTTP status code. * @param string $raw_message Raw message from the API (e.g. "Not Found"). * @param string $provider 'github' or 'gitlab'. * @return string */ protected function humanize_api_error( $status_code, $raw_message, $provider = 'github' ) { $label = $provider === 'gitlab' ? 'GitLab' : 'GitHub'; switch ( $status_code ) { case 401: return sprintf( /* translators: %s: Git provider name (GitHub or GitLab). */ __( 'Authentication failed — your %s access token is invalid or has expired. Please disconnect and reconnect your account in BetterDocs Settings.', 'betterdocs-pro' ), $label ); case 403: return sprintf( /* translators: %s: Git provider name (GitHub or GitLab). */ __( 'Permission denied — your %s token does not have the required permissions to perform this action. Please ensure it has push/write access to this repository.', 'betterdocs-pro' ), $label ); case 404: return sprintf( /* translators: %s: Git provider name (GitHub or GitLab). */ __( 'Repository or file not found on %s. It may have been deleted, renamed, or your access token no longer has permission to view it. Please verify the repository still exists and your connection is active.', 'betterdocs-pro' ), $label ); case 409: return __( 'Conflict — the file was modified on the remote repository since your last sync. Please pull the latest changes first, then try pushing again.', 'betterdocs-pro' ); case 422: return sprintf( /* translators: 1: Git provider name (GitHub or GitLab); 2: raw error message from the provider. */ __( 'The request was rejected by %1$s. This usually means the branch is protected or the commit data is invalid. Details: %2$s', 'betterdocs-pro' ), $label, $raw_message ); case 429: return sprintf( /* translators: %s: Git provider name (GitHub or GitLab). */ __( 'Rate limit exceeded — too many requests to the %s API. Please wait a few minutes and try again.', 'betterdocs-pro' ), $label ); case 500: case 502: case 503: return sprintf( /* translators: %s: Git provider name (GitHub or GitLab). */ __( '%s is temporarily unavailable (server error). Please try again in a few minutes.', 'betterdocs-pro' ), $label ); default: if ( ! empty( $raw_message ) && strtolower( $raw_message ) !== 'not found' ) { return sprintf( /* translators: 1: Git provider name (GitHub or GitLab); 2: HTTP status code; 3: raw error message. */ __( '%1$s API error (%2$d): %3$s', 'betterdocs-pro' ), $label, $status_code, $raw_message ); } return sprintf( /* translators: 1: Git provider name (GitHub or GitLab); 2: HTTP status code. */ __( 'An unexpected error occurred while communicating with %1$s (HTTP %2$d). Please check your connection settings and try again.', 'betterdocs-pro' ), $label, $status_code ); } } }
(