title]. */ function kbBulkArticles() { global $mysqli; $ids = array_values(array_unique(array_filter(array_map('intval', (array) ($_POST['kb_article_ids'] ?? []))))); $articles = []; if ($ids) { $sql = mysqli_query($mysqli, "SELECT kb_article_id, kb_article_title FROM kb_articles WHERE kb_article_id IN (" . implode(',', $ids) . ")"); while ($row = mysqli_fetch_assoc($sql)) { $articles[intval($row['kb_article_id'])] = $row['kb_article_title']; } } if (!$articles) { flashAlert('No articles were ticked.', 'error'); redirect(); } return $articles; } if (isset($_POST['add_kb_article'])) { [$fields, $error] = kbArticleFields(['keep_client_ids' => []] + $_POST); if ($error !== '') { flashAlert(escapeHtml($error), 'error'); redirect(); } $kb_article_id = kbArticleSave($fields); if (isset($_POST['tags_form'])) { tagSetForRecord('kb_article', $kb_article_id, (array) ($_POST['tags'] ?? [])); } $saved = kbArticleRow($kb_article_id); logAudit("Knowledge Base", "Create", "$session_name wrote " . ($fields['published'] ? '' : 'a draft of ') . "article " . escapeSql($fields['title']) . " - who can read it: " . escapeSql(kbAudienceText($saved, kbAudiencesFor([$kb_article_id])[$kb_article_id])), 0, $kb_article_id); // Written up from a ticket (Write up for the Knowledge Base) - its history says so $from_ticket = ticketRow($_POST['from_ticket_id'] ?? 0); if ($from_ticket && (!intval($from_ticket['ticket_client_id']) || hasClientAccess(intval($from_ticket['ticket_client_id'])))) { logTicketHistory(intval($from_ticket['ticket_id']), "$session_name wrote this ticket up as Knowledge Base article " . $fields['title']); } flashAlert("Article " . escapeHtml($fields['title']) . " " . ($fields['published'] ? 'published' : 'saved as a draft')); redirect("kb_article.php?kb_article_id=$kb_article_id"); } if (isset($_POST['edit_kb_article'])) { $row = kbArticleForHandler($_POST['kb_article_id'] ?? 0); $kb_article_id = intval($row['kb_article_id']); $audience_before = kbAudienceText($row, kbAudiencesFor([$kb_article_id])[$kb_article_id]); // Clients already on it stay, even ones this agent can't reach [$fields, $error] = kbArticleFields(['keep_client_ids' => kbAudienceFields($row)['client_ids']] + $_POST); if ($error !== '') { flashAlert(escapeHtml($error), 'error'); redirect(); } kbArticleSave($fields, $row); if (isset($_POST['tags_form'])) { tagSetForRecord('kb_article', $kb_article_id, (array) ($_POST['tags'] ?? [])); } $was = !empty($row['kb_article_published_at']); $how = $fields['published'] === $was ? 'edited' : ($fields['published'] ? 'edited and published' : 'edited and made a draft of'); $saved = kbArticleRow($kb_article_id); $audience_after = kbAudienceText($saved, kbAudiencesFor([$kb_article_id])[$kb_article_id]); logAudit("Knowledge Base", "Edit", "$session_name $how article " . escapeSql($fields['title']) . ($audience_after !== $audience_before ? " - who can read it: " . escapeSql("$audience_after (was $audience_before)") : ''), 0, $kb_article_id); flashAlert("Article " . escapeHtml($fields['title']) . " saved" . ($fields['published'] === $was ? '' : ($fields['published'] ? ' and published' : ' as a draft'))); redirect(); } if (isset($_GET['publish_kb_article']) || isset($_GET['draft_kb_article'])) { $publish = isset($_GET['publish_kb_article']); $row = kbArticleForHandler($publish ? $_GET['publish_kb_article'] : $_GET['draft_kb_article']); $kb_article_id = intval($row['kb_article_id']); mysqli_query($mysqli, "UPDATE kb_articles SET kb_article_published_at = " . ($publish ? 'COALESCE(kb_article_published_at, NOW())' : 'NULL') . " WHERE kb_article_id = $kb_article_id"); logAudit("Knowledge Base", $publish ? "Publish" : "Draft", "$session_name " . ($publish ? 'published' : 'made a draft of') . " article " . escapeSql($row['kb_article_title']), 0, $kb_article_id); flashAlert("Article " . escapeHtml($row['kb_article_title']) . " " . ($publish ? 'published' : 'is a draft again')); redirect(); } if (isset($_GET['mark_kb_article_reviewed'])) { $row = kbArticleForHandler($_GET['mark_kb_article_reviewed']); $kb_article_id = intval($row['kb_article_id']); mysqli_query($mysqli, "UPDATE kb_articles SET kb_article_reviewed_at = NOW(), kb_article_reviewed_by = " . intval($session_user_id) . " WHERE kb_article_id = $kb_article_id"); logAudit("Knowledge Base", "Review", "$session_name reviewed article " . escapeSql($row['kb_article_title']), 0, $kb_article_id); $months = intval($row['kb_article_review_months']); flashAlert("Article " . escapeHtml($row['kb_article_title']) . " marked reviewed" . ($months ? ' - next due ' . date('M j, Y', strtotime("+$months months")) : '')); redirect(); } if (isset($_GET['archive_kb_article']) || isset($_GET['restore_kb_article'])) { $archive = isset($_GET['archive_kb_article']); $row = kbArticleForHandler($archive ? $_GET['archive_kb_article'] : $_GET['restore_kb_article'], false); $kb_article_id = intval($row['kb_article_id']); mysqli_query($mysqli, "UPDATE kb_articles SET kb_article_archived_at = " . ($archive ? 'NOW()' : 'NULL') . " WHERE kb_article_id = $kb_article_id"); logAudit("Knowledge Base", $archive ? "Archive" : "Restore", "$session_name " . ($archive ? 'archived' : 'restored') . " article " . escapeSql($row['kb_article_title']), 0, $kb_article_id); flashAlert("Article " . escapeHtml($row['kb_article_title']) . " " . ($archive ? 'archived' : 'restored'), $archive ? 'error' : 'success'); redirect(); } if (isset($_GET['delete_kb_article'])) { $kb_article_id = intval($_GET['delete_kb_article']); $title = kbArticleDelete($kb_article_id); if ($title === null) { flashAlert('That article no longer exists.', 'error'); redirect('kb.php'); } logAudit("Knowledge Base", "Delete", "$session_name deleted article " . escapeSql($title) . " and its versions", 0, $kb_article_id); flashAlert("Article " . escapeHtml($title) . " deleted", 'error'); // Not back to its page - it's gone redirect(str_contains((string) ($_SERVER['HTTP_REFERER'] ?? ''), 'kb_article.php') ? 'kb.php' : null); } if (isset($_GET['copy_kb_article'])) { $row = kbArticleForHandler($_GET['copy_kb_article']); // A new draft, with copies of its images and files, its tags and who can read it $kb_article_id = kbArticleSave([ 'title' => mb_substr('Copy of ' . $row['kb_article_title'], 0, 200), 'summary' => (string) $row['kb_article_summary'], 'category_id' => intval($row['kb_article_category_id']), 'review_months' => intval($row['kb_article_review_months']), 'published' => false, 'content' => '', ] + kbAudienceFields($row)); $content = (string) $row['kb_article_content']; $from = kbArticleDir($row['kb_article_id']); if (is_dir($from)) { copyDirectory($from, kbArticleDir($kb_article_id)); $content = str_replace('/uploads/kb/' . intval($row['kb_article_id']) . '/', "/uploads/kb/$kb_article_id/", $content); kbArticleCopyFileRows($row['kb_article_id'], $kb_article_id); } mysqli_query($mysqli, "UPDATE kb_articles SET kb_article_content = '" . mysqli_real_escape_string($mysqli, $content) . "', kb_article_content_raw = '" . escapeSql(kbArticleContentRaw('Copy of ' . $row['kb_article_title'], (string) $row['kb_article_summary'], $content)) . "' WHERE kb_article_id = $kb_article_id"); mysqli_query($mysqli, "INSERT INTO kb_article_tags (kb_article_id, tag_id) SELECT $kb_article_id, tag_id FROM kb_article_tags WHERE kb_article_id = " . intval($row['kb_article_id'])); logAudit("Knowledge Base", "Create", "$session_name copied article " . escapeSql($row['kb_article_title']) . " as a new draft", 0, $kb_article_id); flashAlert("A copy of " . escapeHtml($row['kb_article_title']) . " is ready as a draft"); redirect("kb_article.php?kb_article_id=$kb_article_id"); } if (isset($_POST['restore_kb_article_version'])) { $kb_article_version_id = intval($_POST['kb_article_version_id'] ?? 0); $version = mysqli_fetch_assoc(mysqli_query($mysqli, "SELECT kb_article_version_title, kb_article_version_summary, kb_article_version_content, kb_article_version_kb_article_id FROM kb_article_versions WHERE kb_article_version_id = $kb_article_version_id")); if (!$version) { flashAlert('That version no longer exists.', 'error'); redirect(); } $row = kbArticleForHandler($version['kb_article_version_kb_article_id']); $kb_article_id = intval($row['kb_article_id']); // What it says now becomes a version itself kbArticleSave([ 'title' => $version['kb_article_version_title'], 'summary' => (string) $version['kb_article_version_summary'], 'category_id' => intval($row['kb_article_category_id']), 'review_months' => intval($row['kb_article_review_months']), 'published' => !empty($row['kb_article_published_at']), 'content' => (string) $version['kb_article_version_content'], ] + kbAudienceFields($row), $row); logAudit("Knowledge Base", "Edit", "$session_name put back an earlier version of article " . escapeSql($version['kb_article_version_title']), 0, $kb_article_id); flashAlert("The earlier version of " . escapeHtml($version['kb_article_version_title']) . " is back - what it said before is kept as a version"); redirect("kb_article.php?kb_article_id=$kb_article_id"); } if (isset($_GET['delete_kb_article_version'])) { $kb_article_version_id = intval($_GET['delete_kb_article_version']); $version = mysqli_fetch_assoc(mysqli_query($mysqli, "SELECT kb_article_version_title, kb_article_version_created_at, kb_article_version_kb_article_id FROM kb_article_versions WHERE kb_article_version_id = $kb_article_version_id")); if (!$version) { flashAlert('That version no longer exists.', 'error'); redirect(); } mysqli_query($mysqli, "DELETE FROM kb_article_versions WHERE kb_article_version_id = $kb_article_version_id"); logAudit("Knowledge Base", "Edit", "$session_name deleted the version of " . date('M j, Y g:ia', strtotime($version['kb_article_version_created_at'])) . " of article " . escapeSql($version['kb_article_version_title']), 0, intval($version['kb_article_version_kb_article_id'])); flashAlert("Version deleted", 'error'); redirect("kb_article.php?kb_article_id=" . intval($version['kb_article_version_kb_article_id'])); } if (isset($_POST['bulk_category_kb_articles'])) { $articles = kbBulkArticles(); $category_id = kbCategoryId($_POST['category_id'] ?? 0); mysqli_query($mysqli, "UPDATE kb_articles SET kb_article_category_id = $category_id WHERE kb_article_id IN (" . implode(',', array_keys($articles)) . ")"); $category = $category_id ? categoryRow($category_id) : null; foreach ($articles as $kb_article_id => $title) { logAudit("Knowledge Base", "Edit", "$session_name put article " . escapeSql($title) . ($category ? " in category " . escapeSql($category['category_name']) : " in no category"), 0, $kb_article_id); } $count = count($articles); flashAlert("$count article" . ($count === 1 ? '' : 's') . ($category ? " put in " . escapeHtml($category['category_name']) . "" : " taken out of their category")); redirect(); } if (isset($_POST['bulk_publish_kb_articles']) || isset($_POST['bulk_draft_kb_articles']) || isset($_POST['bulk_archive_kb_articles']) || isset($_POST['bulk_restore_kb_articles'])) { $articles = kbBulkArticles(); $ids = implode(',', array_keys($articles)); // What each does, on the ones it applies to if (isset($_POST['bulk_publish_kb_articles'])) { [$set, $only, $action, $verb] = ['kb_article_published_at = NOW()', 'kb_article_published_at IS NULL AND kb_article_archived_at IS NULL', 'Publish', 'published']; } elseif (isset($_POST['bulk_draft_kb_articles'])) { [$set, $only, $action, $verb] = ['kb_article_published_at = NULL', 'kb_article_published_at IS NOT NULL AND kb_article_archived_at IS NULL', 'Draft', 'made drafts']; } elseif (isset($_POST['bulk_archive_kb_articles'])) { [$set, $only, $action, $verb] = ['kb_article_archived_at = NOW()', 'kb_article_archived_at IS NULL', 'Archive', 'archived']; } else { [$set, $only, $action, $verb] = ['kb_article_archived_at = NULL', 'kb_article_archived_at IS NOT NULL', 'Restore', 'restored']; } $changed = []; $sql = mysqli_query($mysqli, "SELECT kb_article_id, kb_article_title FROM kb_articles WHERE kb_article_id IN ($ids) AND $only"); while ($row = mysqli_fetch_assoc($sql)) { $changed[intval($row['kb_article_id'])] = $row['kb_article_title']; } if ($changed) { mysqli_query($mysqli, "UPDATE kb_articles SET $set WHERE kb_article_id IN (" . implode(',', array_keys($changed)) . ")"); } foreach ($changed as $kb_article_id => $title) { logAudit("Knowledge Base", $action, "$session_name " . ($action === 'Draft' ? 'made a draft of' : $verb) . " article " . escapeSql($title), 0, $kb_article_id); } $count = count($changed); $left = count($articles) - $count; flashAlert("$count article" . ($count === 1 ? '' : 's') . " $verb" . ($left ? " - $left already " . ($left === 1 ? 'was' : 'were') : ''), in_array($action, ['Archive'], true) ? 'error' : 'success'); redirect(); } if (isset($_POST['bulk_delete_kb_articles'])) { $articles = kbBulkArticles(); foreach ($articles as $kb_article_id => $title) { kbArticleDelete($kb_article_id); logAudit("Knowledge Base", "Delete", "$session_name deleted article " . escapeSql($title) . " and its versions", 0, $kb_article_id); } $count = count($articles); flashAlert("$count article" . ($count === 1 ? '' : 's') . " deleted", 'error'); redirect(); } if (isset($_GET['copy_document_to_kb'])) { // The document's client must be one the agent can reach, as on its page $document_id = intval($_GET['copy_document_to_kb']); $document = mysqli_fetch_assoc(mysqli_query($mysqli, "SELECT document_name, document_client_id FROM documents WHERE document_id = $document_id")); if (!$document) { flashAlert('That document no longer exists.', 'error'); redirect(); } $client_id = intval($document['document_client_id']); enforceClientAccess(); $kb_article_id = kbArticleFromDocument($document_id); logAudit("Knowledge Base", "Create", "$session_name copied document " . escapeSql($document['document_name']) . " into the Knowledge Base as a draft", 0, $kb_article_id); flashAlert("" . escapeHtml($document['document_name']) . " is in the Knowledge Base as a draft - take out anything that's only about this client before you publish it"); redirect("kb_article.php?kb_article_id=$kb_article_id"); } /* * What readers said didn't help, dealt with - one answer (deal_with_kb_feedback) * or all of an article's (deal_with_kb_article_feedback). It stays on the * article, marked with who dealt with it, and leaves the Needs a look view. */ if (isset($_GET['deal_with_kb_feedback']) || isset($_GET['deal_with_kb_article_feedback'])) { if (!kbFeedbackReady()) { flashAlert('The Knowledge Base needs the database update - ask an admin to run it from Maintenance > Update.', 'error'); redirect(); } if (isset($_GET['deal_with_kb_feedback'])) { $feedback_id = intval($_GET['deal_with_kb_feedback']); $kb_article_id = intval(mysqli_fetch_row(mysqli_query($mysqli, "SELECT kb_article_feedback_kb_article_id FROM kb_article_feedback WHERE kb_article_feedback_id = $feedback_id"))[0] ?? 0); $where = "kb_article_feedback_id = $feedback_id"; } else { $kb_article_id = intval($_GET['deal_with_kb_article_feedback']); $where = "kb_article_feedback_kb_article_id = $kb_article_id"; } $row = kbArticleForHandler($kb_article_id, false); mysqli_query($mysqli, "UPDATE kb_article_feedback SET kb_article_feedback_dealt_at = NOW(), kb_article_feedback_dealt_by = $session_user_id WHERE $where AND kb_article_feedback_helpful = 0 AND kb_article_feedback_dealt_at IS NULL"); $dealt = mysqli_affected_rows($mysqli); if ($dealt > 0) { logAudit("Knowledge Base", "Edit", "$session_name dealt with $dealt reader" . ($dealt === 1 ? "'s" : "s'") . " feedback on article " . escapeSql($row['kb_article_title']), 0, $kb_article_id); } flashAlert($dealt === 1 ? 'Feedback dealt with' : ($dealt ? "$dealt answers dealt with" : 'Nothing left to deal with')); redirect("kb_article.php?kb_article_id=$kb_article_id#kbArticleFeedback"); } /* * Searches that found nothing, taken off the Not found list - one search, * wherever it was made (dismiss_kb_search_miss, its words) or all the agent * can see (dismiss_kb_search_misses). Searched again, one comes back. */ if (isset($_GET['dismiss_kb_search_miss']) || isset($_GET['dismiss_kb_search_misses'])) { if (kbFeedbackReady()) { $one = isset($_GET['dismiss_kb_search_miss']) ? mb_substr((string) $_GET['dismiss_kb_search_miss'], 0, 100) : null; mysqli_query($mysqli, "DELETE FROM kb_search_misses WHERE " . ($one !== null ? "kb_search_miss_query = '" . escapeSql($one) . "'" : '1') . clientScopeSql('kb_search_miss_client_id')); if (mysqli_affected_rows($mysqli) > 0) { logAudit("Knowledge Base", "Delete", "$session_name took " . ($one !== null ? 'the search "' . escapeSql($one) . '"' : 'every search') . " off the Not found list", 0, 0); } } flashAlert(isset($_GET['dismiss_kb_search_miss']) ? 'Search taken off the list' : 'Not found list cleared'); redirect('kb.php'); } /* Files added to an article, from its page - the kinds Files takes, up to 20 in all. */ if (isset($_POST['upload_kb_article_files'])) { $row = kbArticleForHandler($_POST['kb_article_id'] ?? 0); $kb_article_id = intval($row['kb_article_id']); $saved = kbArticleSaveFiles($kb_article_id); if ($saved['kept']) { logAudit("Knowledge Base", "Upload", "$session_name added " . escapeSql(implode(', ', $saved['kept'])) . " to article " . escapeSql($row['kb_article_title']), 0, $kb_article_id); } $added = $saved['kept'] ? (count($saved['kept']) === 1 ? '' . escapeHtml($saved['kept'][0]) . ' added' : count($saved['kept']) . ' files added') : ''; if ($saved['refused']) { flashAlert(($added !== '' ? "$added. " : '') . escapeHtml(implode(', ', $saved['refused'])) . (count($saved['refused']) === 1 ? " wasn't" : " weren't") . " added - a kind Files doesn't take, too big, or more than " . KB_ARTICLE_MAX_FILES . " on the article", 'error'); } elseif ($added !== '') { flashAlert($added); } redirect("kb_article.php?kb_article_id=$kb_article_id#kbArticleFiles"); } /* A file taken off an article, for good. */ if (isset($_GET['delete_kb_article_file'])) { $file = kbArticleFileRow($_GET['delete_kb_article_file']); $row = kbArticleForHandler($file['kb_article_file_kb_article_id'] ?? 0, false); $kb_article_id = intval($row['kb_article_id']); $name = kbArticleRemoveFile($kb_article_id, $_GET['delete_kb_article_file']); if ($name !== null) { logAudit("Knowledge Base", "Delete", "$session_name took " . escapeSql($name) . " off article " . escapeSql($row['kb_article_title']), 0, $kb_article_id); flashAlert('' . escapeHtml($name) . ' taken off', 'error'); } redirect("kb_article.php?kb_article_id=$kb_article_id#kbArticleFiles"); } /* The summary AI suggested in its review (modals/kb/kb_article_review.php), saved as the article's - the rest stays as it is, and no version is kept for it. */ if (isset($_POST['set_kb_article_summary'])) { $row = kbArticleForHandler($_POST['kb_article_id'] ?? 0); $kb_article_id = intval($row['kb_article_id']); $summary = mb_substr(trim(preg_replace('/\s+/u', ' ', strip_tags((string) ($_POST['summary'] ?? '')))), 0, 255); mysqli_query($mysqli, "UPDATE kb_articles SET kb_article_summary = " . ($summary !== '' ? "'" . escapeSql($summary) . "'" : 'NULL') . ", kb_article_content_raw = '" . escapeSql(kbArticleContentRaw($row['kb_article_title'], $summary, (string) $row['kb_article_content'])) . "', kb_article_updated_at = NOW(), kb_article_updated_by = " . intval($session_user_id) . " WHERE kb_article_id = $kb_article_id"); logAudit("Knowledge Base", "Edit", "$session_name gave article " . escapeSql($row['kb_article_title']) . " the summary AI suggested", 0, $kb_article_id); flashAlert("Article " . escapeHtml($row['kb_article_title']) . " has its new summary"); redirect("kb_article.php?kb_article_id=$kb_article_id"); } /* The article as a PDF - its title, summary and what it says. Reading, not changing: anyone who can read the Knowledge Base. */ if (isset($_GET['export_kb_article'])) { validateCSRFToken(); $kb_closed = kbClosedText(1); if ($kb_closed !== '') { flashAlert(escapeHtml($kb_closed), 'error'); redirect(); } $row = kbArticleForHandler($_GET['export_kb_article'], false); logAudit("Knowledge Base", "Export", "$session_name exported article " . escapeSql($row['kb_article_title']) . " as a PDF", 0, intval($row['kb_article_id'])); require_once '../libs/TCPDF/tcpdf.php'; $pdf = new TCPDF(); $pdf->SetCreator(PDF_CREATOR); $pdf->SetAuthor($session_name); $pdf->SetTitle($row['kb_article_title']); $pdf->setPrintHeader(false); $pdf->AddPage(); $pdf->SetFont('helvetica', '', 11); $summary = trim((string) $row['kb_article_summary']); $pdf->writeHTML('
' . escapeHtml($summary) . '
' : '') . documentHtmlPurify((string) $row['kb_article_content']), true, false, true, false, ''); // The PDF is the response - nothing may follow it $pdf->Output(preg_replace('/[^A-Za-z0-9 ._-]/', '', $row['kb_article_title']) . '.pdf', 'I'); exit; }