mirror of
https://github.com/itflow-org/itflow
synced 2026-11-22 04:17:24 +00:00
QoL 69: a Knowledge Base Articles starter pack of 29 client how-tos loaded as agent-only drafts with Knowledge Base categories and article tags in their packs, and a demo Knowledge Base with every kind of audience, reads, feedback, versions, a review due, searches that found nothing and links from ticket replies, removed with the demo along with its clients' ticket read marks
This commit is contained in:
@@ -51,7 +51,7 @@ function starterItemLook($pack, $row) {
|
||||
|
||||
/* The packs whose items have more to them than a line - shown whole by Preview. */
|
||||
function starterPreviewPacks() {
|
||||
return ['ticket_templates', 'project_templates', 'canned_responses', 'vendor_templates', 'document_templates', 'license_templates', 'products'];
|
||||
return ['ticket_templates', 'project_templates', 'canned_responses', 'kb_articles', 'vendor_templates', 'document_templates', 'license_templates', 'products'];
|
||||
}
|
||||
|
||||
/* [Words in brackets] in a template, marked as the bits filled in as it is used. */
|
||||
@@ -171,6 +171,16 @@ function starterItemPreview($pack, $row) {
|
||||
$html .= starterPreviewFillIns((array) ($row['fill_ins'] ?? []));
|
||||
return $html . '<h3 class="itflow-starter-preview-head">What it says</h3><div class="itflow-starter-preview-doc">' . starterPreviewFills($row['content'] ?? '') . '</div>';
|
||||
|
||||
case 'kb_articles':
|
||||
$review = intval($row['review_months'] ?? 0);
|
||||
$html .= '<dl class="itflow-starter-preview-facts">'
|
||||
. starterPreviewFact('Category', escapeHtml((string) ($row['category'] ?? '')))
|
||||
. starterPreviewFact('Tags', escapeHtml(implode(', ', (array) ($row['tags'] ?? []))))
|
||||
. starterPreviewFact('Reviewed', $review ? 'Every ' . ($review === 12 ? 'year' : "$review months") : '')
|
||||
. starterPreviewFact('Comes in as', 'A draft only your team can see')
|
||||
. '</dl>';
|
||||
return $html . '<h3 class="itflow-starter-preview-head">What it says</h3><div class="itflow-starter-preview-doc">' . starterKbFill($row['content'] ?? '') . '</div>';
|
||||
|
||||
case 'license_templates':
|
||||
$html .= '<dl class="itflow-starter-preview-facts">'
|
||||
. starterPreviewFact('Type', escapeHtml((string) ($row['type'] ?? '')))
|
||||
|
||||
@@ -722,6 +722,7 @@ function demoDataLoad($mysqli) {
|
||||
'projects' => 0,
|
||||
'billing' => 0,
|
||||
'company' => 0,
|
||||
'kb' => 0,
|
||||
'skipped_credentials' => 0,
|
||||
];
|
||||
|
||||
@@ -768,6 +769,8 @@ function demoDataLoad($mysqli) {
|
||||
// install from - and both builders are guarded, so a run that only fills in
|
||||
// missing clients does not double anything up.
|
||||
demoBuildInternalDiary($mysqli, $context, $counts);
|
||||
// The Knowledge Base - after the clients, as who can read each article, its feedback and the tickets linking to it are theirs
|
||||
demoBuildKnowledgeBase($mysqli, $context, $counts);
|
||||
demoBuildCompanyFinancials($mysqli, $context, $counts);
|
||||
demoReconcileAccounts($mysqli, $context);
|
||||
|
||||
@@ -790,11 +793,25 @@ function demoDataRemove($mysqli) {
|
||||
|
||||
$clients = demoDataClients($mysqli);
|
||||
$org_vendors = demoDataOrgVendorIds($mysqli);
|
||||
$kb_articles = demoKbArticleIds($mysqli);
|
||||
|
||||
if (!$clients && !$org_vendors) {
|
||||
if (!$clients && !$org_vendors && !$kb_articles) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
// The Knowledge Base articles - matched on title and summary together - with
|
||||
// their versions, tags, readers and feedback, and the searches that found nothing
|
||||
foreach ($kb_articles as $kb_article_id) {
|
||||
kbArticleDelete($kb_article_id);
|
||||
}
|
||||
if ($kb_articles || $clients) {
|
||||
foreach (demoKbSearchMisses() as $miss) {
|
||||
if ($miss[1] === '') {
|
||||
mysqli_query($mysqli, "DELETE FROM kb_search_misses WHERE kb_search_miss_source = 'public' AND kb_search_miss_client_id = 0 AND kb_search_miss_query = '" . escapeSql($miss[0]) . "'");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
foreach (array_keys($clients) as $client_id) {
|
||||
|
||||
$client_id = intval($client_id);
|
||||
@@ -812,6 +829,7 @@ function demoDataRemove($mysqli) {
|
||||
mysqli_query($mysqli, "DELETE FROM ticket_assets WHERE ticket_id IN ($ticket_ids)");
|
||||
mysqli_query($mysqli, "DELETE FROM ticket_watchers WHERE watcher_ticket_id IN ($ticket_ids)");
|
||||
mysqli_query($mysqli, "DELETE FROM ticket_views WHERE view_ticket_id IN ($ticket_ids)");
|
||||
mysqli_query($mysqli, "DELETE FROM ticket_reads WHERE ticket_id IN ($ticket_ids)");
|
||||
mysqli_query($mysqli, "DELETE FROM ticket_attachments WHERE ticket_attachment_ticket_id IN ($ticket_ids)");
|
||||
mysqli_query($mysqli, "DELETE FROM tasks WHERE task_ticket_id IN ($ticket_ids)");
|
||||
mysqli_query($mysqli, "DELETE FROM sla_history WHERE sla_history_ticket_id IN ($ticket_ids)");
|
||||
@@ -967,6 +985,10 @@ function demoDataRemove($mysqli) {
|
||||
mysqli_query($mysqli, "DELETE FROM logs WHERE log_client_id = $client_id");
|
||||
mysqli_query($mysqli, "DELETE FROM notifications WHERE notification_client_id = $client_id");
|
||||
mysqli_query($mysqli, "DELETE FROM client_tags WHERE client_id = $client_id");
|
||||
if (demoKbTablesReady($mysqli)) {
|
||||
mysqli_query($mysqli, "DELETE FROM kb_search_misses WHERE kb_search_miss_client_id = $client_id");
|
||||
mysqli_query($mysqli, "DELETE FROM kb_article_feedback WHERE kb_article_feedback_client_id = $client_id");
|
||||
}
|
||||
mysqli_query($mysqli, "DELETE FROM clients WHERE client_id = $client_id");
|
||||
|
||||
// Never leave the company's own-client designation pointing at a client that is gone
|
||||
@@ -4555,6 +4577,476 @@ function demoOneOffInvoicePool() {
|
||||
// - fictional contacts must never be deliverable and a fictional domain must
|
||||
// never resolve to somebody's real business if a refresh gets clicked.
|
||||
// build 0 is a Windows house, build 1 is a Linux house.
|
||||
// ------------------------------
|
||||
// demoDataKbArticles
|
||||
// The Knowledge Base this MSP has grown - its own articles, apart from the
|
||||
// starter ones (whose titles none of these share, so the Knowledge Base
|
||||
// Articles pack still adds its own beside them). Who can read each: every
|
||||
// client, the clients with some client tags, named demo clients, anyone
|
||||
// (the public help center), or agents only - and two drafts and an archived
|
||||
// one. Each carries how long ago it went out, how often it is reviewed and
|
||||
// when it last was, its reads, older versions and what its readers said; and
|
||||
// 'tickets', the demo ticket subjects whose replies link to it. Removal
|
||||
// matches an article on its title and summary together.
|
||||
// name, description, category, tags, content, audience, months ago made,
|
||||
// review months, months ago reviewed (null never), views, versions (months
|
||||
// ago => [summary, content] it said then), feedback ([helpful, comment] from
|
||||
// portal contacts, or public ones with 'public'), tickets, archived months ago
|
||||
// ------------------------------
|
||||
function demoDataKbArticles() {
|
||||
|
||||
$steps = function (array $items) {
|
||||
return '<ol><li>' . implode('</li><li>', $items) . '</li></ol>';
|
||||
};
|
||||
$list = function (array $items) {
|
||||
return '<ul><li>' . implode('</li><li>', $items) . '</li></ul>';
|
||||
};
|
||||
$a = function ($name, $description, $category, array $tags, $content, $audience, $made, $review, $reviewed, $views, array $versions = [], array $feedback = [], array $tickets = [], $archived = null) {
|
||||
return compact('name', 'description', 'category', 'tags', 'content', 'audience', 'made', 'review', 'reviewed', 'views', 'versions', 'feedback', 'tickets', 'archived');
|
||||
};
|
||||
$yes = [1, ''];
|
||||
|
||||
$support_hours = '<p>Our help desk is staffed 8:00 AM to 6:00 PM, Monday to Friday, apart from public holidays.</p>'
|
||||
. '<h5>How fast we respond</h5>' . $list([
|
||||
'<strong>Critical</strong> - the business can\'t work, or a security incident: within 1 hour, around the clock for managed clients',
|
||||
'<strong>High</strong> - one person can\'t work: within 2 business hours',
|
||||
'<strong>Normal</strong> - something is wrong but there is a way around it: within 4 business hours',
|
||||
'<strong>Low</strong> - requests and questions: within 1 business day',
|
||||
])
|
||||
. '<h5>Reaching us</h5><p>Open a ticket in the client portal or email us, and for anything critical call as well. Every request gets a ticket number by email straight away - reply to that email to add to it.</p>';
|
||||
|
||||
return [
|
||||
|
||||
// Every client
|
||||
$a('How we handle your support requests', 'Our support hours, how quickly we respond to each priority, and how to reach us.', 'Getting Help', ['How-To'],
|
||||
$support_hours, ['all'], 22, 12, 3, 486,
|
||||
[14 => ['Our support hours and how quickly we respond.', str_replace(['1 hour', '2 business hours'], ['2 hours', '4 business hours'], $support_hours)]],
|
||||
[$yes, $yes, $yes, $yes, $yes, $yes, [0, 'Does the 1 hour include weekends for us? We are not on the managed plan.'], $yes]),
|
||||
|
||||
$a('Reporting a suspicious email to us', 'Use the Report button in Outlook - it reaches us and takes the email out of your inbox.', 'Security', ['Security', 'How-To'],
|
||||
'<p>If an email looks wrong, report it rather than deleting it - we check it, and if it is phishing we pull it out of everyone else\'s mailbox too.</p>'
|
||||
. $steps(['Don\'t click any links or open attachments.', 'In Outlook, select the email and choose <strong>Report</strong> on the toolbar, then <strong>Report phishing</strong>.', 'That\'s it - it goes to us and leaves your inbox.'])
|
||||
. '<p>On a phone, open the email, tap the <strong>...</strong> menu and choose <strong>Report phishing</strong>. If you already clicked something or typed your password, call us straight away.</p>',
|
||||
['all'], 19, 6, 2, 371,
|
||||
[11 => ['Forward suspicious emails to us as an attachment.', '<p>Forward any suspicious email to us as an attachment, then delete it.</p>']],
|
||||
[$yes, $yes, $yes, $yes, [0, 'There is no Report button in my Outlook on the Mac.'], $yes, $yes],
|
||||
['Suspicious invoice email reported by staff']),
|
||||
|
||||
$a('Outlook disconnected after a password change', 'What to do when Outlook says Disconnected or keeps asking for your password after you changed it.', 'Email and Calendar', ['Troubleshooting', 'Quick Fix', 'Microsoft 365'],
|
||||
'<p>Outlook remembers your old password until you give it the new one. Usually all it takes is:</p>'
|
||||
. $steps(['Close Outlook completely.', 'Open it again and type your new password when it asks - tick <strong>Remember my credentials</strong>.', 'Approve the sign-in on your phone.'])
|
||||
. '<p>If it doesn\'t ask, or keeps asking: restart the computer and open Outlook again. Your phone may ask for the new password too - type it in there as well.</p>'
|
||||
. '<p>Still showing Disconnected after a restart? Open a ticket and tell us the time you changed the password.</p>',
|
||||
['all'], 16, 12, 4, 298, [], [$yes, $yes, $yes, $yes, $yes, [0, 'Did all of this and it still says disconnected.'], $yes],
|
||||
['Outlook stuck on disconnected after password reset']),
|
||||
|
||||
$a('When multi-factor prompts keep coming back on your phone', 'Why your phone keeps asking you to approve sign-ins, and how to make it stop.', 'Accounts and Passwords', ['Troubleshooting', 'Mobile', 'Security'],
|
||||
'<p>A prompt you didn\'t start is a warning - <strong>deny it</strong> and call us, someone may have your password.</p>'
|
||||
. '<p>If the prompts are yours but keep looping, it is usually the phone\'s mail app or Teams using an old sign-in:</p>'
|
||||
. $steps(['Open the Authenticator app and check the time on your phone is set automatically.', 'In the Outlook and Teams apps, sign out and sign in again.', 'If you changed your password recently, update it in each app that asks.', 'Restart the phone.'])
|
||||
. '<p>If it still loops, tell us which apps are open and what the prompt says.</p>',
|
||||
['all'], 9, 6, null, 167, [], [$yes, $yes, [0, 'Prompts stopped for a day and came back.'], $yes],
|
||||
['Multi factor prompts looping on mobile']),
|
||||
|
||||
$a('A slow computer - what to try first', 'Quick things that speed up a slow computer, and what to tell us if they don\'t.', 'Devices', ['Quick Fix', 'Self-Service'],
|
||||
$steps(['Restart it - choose Restart, not Shut down.', 'Close browser tabs you don\'t need - each one uses memory.', 'Check for updates waiting to install, and let them finish.', 'Make sure you have space left - Settings > System > Storage.'])
|
||||
. '<p>If it is still slow, open a ticket saying when it started and what is slow - starting up, one program, or everything. We can see what it is doing from here.</p>',
|
||||
['all'], 14, 12, 5, 242, [], [$yes, $yes, $yes, $yes, $yes],
|
||||
['Workstation running very slowly since last week']),
|
||||
|
||||
// Clients by client tag
|
||||
$a('What your managed service covers', 'What is included in your managed service agreement, and what is billed as extra work.', 'Policies', ['Policy'],
|
||||
'<h5>Included</h5>' . $list(['Help desk support for your staff, remote and on site', 'Monitoring, patching and antivirus on every managed computer and server', 'Backups of your servers and Microsoft 365, checked daily', 'Moves, adds and changes for existing staff', 'A quarterly review with us'])
|
||||
. '<h5>Billed separately</h5>' . $list(['New hardware and software, and setting it up', 'Projects - office moves, new servers, migrations', 'Work on devices we don\'t manage', 'After-hours work you ask for that isn\'t an emergency'])
|
||||
. '<p>Not sure if something is covered? Ask before we start - we always quote first.</p>',
|
||||
['tags' => ['Managed']], 20, 12, 7, 133,
|
||||
[12 => ['What is included in your managed service.', '<h5>Included</h5><ul><li>Help desk support</li><li>Monitoring and patching</li><li>Backups</li></ul>']],
|
||||
[$yes, $yes, $yes]),
|
||||
|
||||
$a('Reaching us after hours', 'Who to call outside business hours, and what counts as an emergency.', 'Getting Help', ['How-To'],
|
||||
'<p>Your agreement includes after-hours support for emergencies. Call our main number and choose the on-call option - it rings the engineer on call, who calls you back within 30 minutes.</p>'
|
||||
. '<h5>An emergency is</h5>' . $list(['The whole office, or a site, can\'t work', 'A server or the internet connection is down', 'A suspected security incident - ransomware, a hacked account'])
|
||||
. '<p>Everything else, open a ticket and we pick it up first thing.</p>',
|
||||
['tags' => ['After Hours Support']], 18, 12, 4, 64, [], [$yes, $yes]),
|
||||
|
||||
$a('Nextcloud - when files stop syncing', 'Fix a Nextcloud desktop client that has stopped syncing on one computer.', 'Files and Sharing', ['Troubleshooting'],
|
||||
'<p>The Nextcloud icon by the clock shows how syncing is going - a red cross or a pause sign means it has stopped.</p>'
|
||||
. $steps(['Click the icon and check it says you are signed in - sign in again if it asks.', 'If it says paused, choose <strong>Resume sync</strong>.', 'Look under <strong>Not synced</strong> for files with problems - a name with characters like : or ? won\'t sync, rename it.', 'Quit Nextcloud and start it again from the Start menu.'])
|
||||
. '<p>Still stuck? Open a ticket with a screenshot of the Nextcloud window.</p>',
|
||||
['tags' => ['Hosting']], 11, 12, null, 58, [], [$yes, [0, 'Mine said the server was unreachable.']],
|
||||
['Nextcloud sync stuck on one machine']),
|
||||
|
||||
$a('Sending sensitive information securely', 'How to send records, ID documents and financial details safely, as your compliance requirements expect.', 'Security', ['Security', 'Policy'],
|
||||
'<p>Some information can\'t go out as an ordinary email: patient or client records, ID documents, bank and card details.</p>'
|
||||
. $list(['Type <strong>[secure]</strong> at the start of the subject line - the email is encrypted, and the person reads it after confirming their address', 'For files, share a OneDrive link to specific people, with an expiry date, rather than attaching them', 'Never put card numbers or passwords in an email at all'])
|
||||
. '<p>If you sent something to the wrong person, tell us straight away - we may be able to recall it, and you may need to report it.</p>',
|
||||
['tags' => ['Compliance']], 13, 6, 5, 104, [], [$yes, $yes, $yes, [0, 'Does [secure] work from the phone app too?']]),
|
||||
|
||||
$a('Working alongside your in-house IT team', 'How we split the work with your own IT staff, and how to raise things with us.', 'Policies', ['Policy'],
|
||||
'<p>On a co-managed agreement your own IT team stays the first point of contact for your staff. We look after the infrastructure, security and backups, and back your team up on anything they pass to us.</p>'
|
||||
. $list(['Your IT team raises tickets with us through the portal, like anyone else', 'We tell them about changes we make, before we make them', 'Anything urgent, they call us directly'])
|
||||
. '<p>Your account manager reviews the split with your IT lead every quarter.</p>',
|
||||
['tags' => ['Co-Managed']], 15, 12, 6, 37),
|
||||
|
||||
// Named clients
|
||||
$a('Ravenwood - imaging workstation won\'t open X-rays', 'What to check when the imaging software can\'t open patient X-rays in an operatory.', 'Devices', ['Troubleshooting', 'Known Issue'],
|
||||
'<p>The imaging software reads X-rays from the imaging server. When it can\'t reach it, images show as a grey box or the software says the image store is unavailable.</p>'
|
||||
. $steps(['Check the other operatory - if theirs works too, it is this workstation; if not, call us straight away.', 'Close the imaging software and the patient chart, and open them again.', 'Restart the workstation.'])
|
||||
. '<p>Don\'t restart the imaging server yourself, even out of hours - call us. If the sensor itself won\'t take images, Meridian Dental Systems look after that: their number is on the sticker on the sensor\'s box.</p>',
|
||||
['clients' => ['Ravenwood Dental Group']], 8, 6, 1, 41, [], [[1, ''], [1, '']]),
|
||||
|
||||
$a('Kestrel - connecting a shop floor tablet to the production Wi-Fi', 'Get a shop floor tablet onto the production network so it can reach the machine schedules.', 'Network and Wi-Fi', ['How-To'],
|
||||
'<p>Shop floor tablets use the production Wi-Fi, not the office or guest network - only it reaches the machine schedules and the CNC file share.</p>'
|
||||
. $steps(['On the tablet, open Wi-Fi settings and choose the production network.', 'Sign in with the tablet\'s own account, from the label on its back - not your own.', 'Open the schedule app and check today\'s jobs load.'])
|
||||
. '<p>New tablets have to be added by us first - open a ticket with its serial number before it goes on the floor.</p>',
|
||||
['clients' => ['Kestrel Precision Manufacturing']], 6, 12, null, 19),
|
||||
|
||||
$a('Harbor Point - signing in with your security key', 'Use your hardware security key to sign in to your computer and the core banking system.', 'Accounts and Passwords', ['How-To', 'Security'],
|
||||
'<p>Every member of staff signs in with a hardware security key as well as their password - your examiners expect it.</p>'
|
||||
. $steps(['Plug the key into a USB port, or hold it to the reader.', 'Type your PIN for the key when asked.', 'Touch the gold disc on the key when it flashes.'])
|
||||
. '<p>Keep the key on your lanyard, never in the computer when you leave it. Lost or forgotten it? Your branch manager has a temporary key and we can register it in a few minutes.</p>',
|
||||
['clients' => ['Harbor Point Credit Union']], 10, 6, 3, 88, [], [$yes, $yes, $yes]),
|
||||
|
||||
$a('Summit Ridge - showing your screen on the classroom display', 'Cast your laptop to the classroom display, and what to do when it won\'t connect.', 'Phones and Meetings', ['How-To'],
|
||||
$steps(['Make sure your laptop is on the staff Wi-Fi.', 'Press <strong>Windows + K</strong> and choose the room\'s display - its name is on the label under the screen.', 'Enter the code shown on the display if it asks.'])
|
||||
. '<p>If it isn\'t listed, turn the display off and on with its remote, wait a minute and try again. Sound plays from the display once connected - check the display\'s own volume.</p>',
|
||||
['clients' => ['Summit Ridge Charter School']], 7, 12, null, 156, [], [$yes, $yes, [0, 'Room 14 display never shows up in the list.'], $yes]),
|
||||
|
||||
$a('Blue Mountain - taproom card terminal offline', 'Get a card terminal in the taproom taking payments again.', 'Network and Wi-Fi', ['Troubleshooting', 'Quick Fix'],
|
||||
$steps(['Check the terminal\'s screen - <strong>No connection</strong> means the network, anything else call the payment provider.', 'Turn the terminal off and on with its power button.', 'Check the network cable at the back of its dock is clicked in.', 'Use the spare terminal behind the bar while you wait.'])
|
||||
. '<p>If both terminals are offline, the taproom\'s internet may be down - call us.</p>',
|
||||
['clients' => ['Blue Mountain Brewing Co']], 5, 12, null, 27),
|
||||
|
||||
// Anyone - every portal, and the public help center when it is on
|
||||
$a('Service status and planned maintenance', 'Where we post outages and planned maintenance, and how much notice we give.', 'Getting Help', ['How-To'],
|
||||
'<p>We post anything affecting more than one client - outages at a provider we rely on, and our own planned maintenance - on our status page and email the contacts at each client affected.</p>'
|
||||
. $list(['Planned maintenance is out of hours, with at least 48 hours notice', 'During an outage we update every 30 minutes until it is fixed', 'Once it is fixed we say what happened and what we are changing'])
|
||||
. '<p>Something not working that isn\'t on the status page? Tell us - we may not know yet.</p>',
|
||||
['public'], 21, 12, 9, 523, [], [[1, '', 'public'], [1, '', 'public'], [1, '', 'public'], [0, 'Link to the status page please', 'public'], [1, '', 'public']]),
|
||||
|
||||
$a('Is this email really from us?', 'How we contact you, and what we will never ask for - so you can spot someone pretending to be us.', 'Security', ['Security'],
|
||||
'<p>Criminals sometimes pretend to be IT support. We will <strong>never</strong>:</p>'
|
||||
. $list(['Ask for your password, or a code from your phone', 'Ask you to install remote control software we haven\'t mentioned in a ticket', 'Ask you to buy gift cards or make an urgent payment', 'Call out of the blue saying your computer has a virus'])
|
||||
. '<p>Emails about your tickets come from our help desk address and quote the ticket number. If you are not sure, hang up or don\'t reply, and call us on the number you already have.</p>',
|
||||
['public'], 17, 12, 4, 309, [], [[1, '', 'public'], [1, '', 'public'], [1, '', 'public']]),
|
||||
|
||||
// Agents only
|
||||
$a('Resetting a user\'s MFA methods', 'Clear a user\'s registered sign-in methods so they can set up a new phone.', 'Internal Procedures', ['How-To', 'Microsoft 365'],
|
||||
'<p>Only after confirming who they are - call them back on the number in their contact record, never one they give you.</p>'
|
||||
. $steps(['In the Entra admin center, open <strong>Users</strong> and the user.', 'Choose <strong>Authentication methods</strong>, then <strong>Require re-register multifactor authentication</strong>.', 'Revoke their sessions.', 'Note in the ticket how you confirmed who they were.'])
|
||||
. '<p>Ask them to set up the new phone straight away - see the client article on moving an authenticator to a new phone.</p>',
|
||||
['agents'], 12, 12, 2, 0),
|
||||
|
||||
$a('Escalating a circuit fault to the provider', 'What to have ready, and how to chase it, when a client\'s internet circuit is down.', 'Internal Procedures', ['How-To'],
|
||||
$steps(['Confirm it is the circuit - the router\'s WAN is down, and the provider\'s equipment shows no sync.', 'Find the circuit ID and the provider\'s support line in the client\'s documentation.', 'Open the fault with the provider and put their reference in the ticket.', 'Set the ticket to Waiting on Vendor and update the client every hour.'])
|
||||
. '<p>If the client has failover, check it took over, and tell them what will be slower until the circuit is back.</p>',
|
||||
['agents'], 15, 12, 10, 0),
|
||||
|
||||
$a('On call - what counts as urgent', 'Which calls to deal with overnight, and which can wait for the morning.', 'Internal Procedures', ['Policy'],
|
||||
'<p>Pick up and work it now:</p>' . $list(['A whole site down, or a server', 'A suspected security incident', 'Anything a client with after-hours support calls in as critical'])
|
||||
. '<p>Log it and leave it for the morning queue:</p>' . $list(['One user, with a way around it', 'Password resets, unless they can\'t work on a night shift', 'Requests and questions'])
|
||||
. '<p>Hand over anything still open at the morning stand-up.</p>',
|
||||
['agents'], 13, 6, 3, 0),
|
||||
|
||||
// Drafts
|
||||
$a('Imaging server share drops after Windows updates', 'Written up from a solved ticket - the imaging share went missing after the monthly updates. Check it before publishing.', 'Devices', ['Known Issue', 'Troubleshooting'],
|
||||
'<p>After the monthly Windows updates, the imaging server sometimes comes back without its share, and the operatory workstations can\'t open X-rays.</p>'
|
||||
. $steps(['Check the imaging service has started on the server.', 'Check the share is there and its permissions are unchanged.', 'Restart the imaging service, then check from one operatory.'])
|
||||
. '<p>We now hold the updates on this server for a week and restart it by hand, out of clinic hours.</p>',
|
||||
['draft'], 1, 0, null, 0),
|
||||
|
||||
$a('Using the new guest Wi-Fi sign-in page', 'How visitors get online now the guest Wi-Fi has a sign-in page.', 'Network and Wi-Fi', ['How-To'],
|
||||
'<p>Visitors join the guest network as before, and their phone or laptop opens a sign-in page. They enter their name and email address and accept the terms, and they are online for the day.</p>'
|
||||
. '<p>If the page doesn\'t appear, open any website and it will.</p>',
|
||||
['draft'], 0, 12, null, 0),
|
||||
|
||||
// Archived
|
||||
$a('Upgrading to Windows 11 - what to expect', 'What changes when your computer moves to Windows 11, and how long it takes.', 'Devices', ['How-To'],
|
||||
'<p>We are moving every managed computer to Windows 11 over the next few months, a few each evening. Your files, programs and settings stay as they are.</p>'
|
||||
. $list(['It happens overnight - leave the computer on and plugged in', 'The Start button is in the middle of the taskbar now', 'The first sign-in takes a few minutes longer'])
|
||||
. '<p>Anything not working afterwards? Open a ticket and mention the upgrade.</p>',
|
||||
['all'], 23, 0, null, 612, [], [$yes, $yes, $yes, $yes], [], 4),
|
||||
|
||||
];
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// demoKbCategoryId
|
||||
// A Knowledge Base category by name - the Categories pack's own, with its
|
||||
// colour, icon and order, when this install doesn't have it yet. Left in
|
||||
// place on removal, as demoCategoryId()'s are.
|
||||
// ------------------------------
|
||||
function demoKbCategoryId($mysqli, $name) {
|
||||
static $cache = [];
|
||||
if (isset($cache[$name])) {
|
||||
return $cache[$name];
|
||||
}
|
||||
$id = starterCategoryId($mysqli, $name, 'kb');
|
||||
if (!$id) {
|
||||
foreach (starterContentCategories() as $category) {
|
||||
if ($category['type'] === 'kb' && $category['name'] === $name) {
|
||||
$id = starterInsert($mysqli, 'categories', [
|
||||
'category_name' => $category['name'],
|
||||
'category_type' => 'kb',
|
||||
'category_color' => $category['color'],
|
||||
'category_icon' => $category['icon'],
|
||||
'category_description' => $category['description'],
|
||||
'category_order' => $category['order'],
|
||||
]);
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
return $cache[$name] = $id;
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// demoKbArticleIds
|
||||
// The demo's articles here, archived or not - title|summary => id.
|
||||
// ------------------------------
|
||||
function demoKbArticleIds($mysqli) {
|
||||
$ids = [];
|
||||
if (!mysqli_num_rows(mysqli_query($mysqli, "SHOW TABLES LIKE 'kb_articles'"))) {
|
||||
return $ids;
|
||||
}
|
||||
foreach (demoDataKbArticles() as $article) {
|
||||
$row = mysqli_fetch_assoc(mysqli_query($mysqli, "SELECT kb_article_id FROM kb_articles WHERE kb_article_title = '" . escapeSql($article['name']) . "'
|
||||
AND kb_article_summary = '" . escapeSql($article['description']) . "' LIMIT 1"));
|
||||
if ($row) {
|
||||
$ids[$article['name'] . '|' . $article['description']] = intval($row['kb_article_id']);
|
||||
}
|
||||
}
|
||||
return $ids;
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// demoKbSearchMisses
|
||||
// What the demo clients' staff, and visitors to the public help center,
|
||||
// searched for and didn't find - query, client name ('' for the help
|
||||
// center), searches, days ago first and last.
|
||||
// ------------------------------
|
||||
function demoKbSearchMisses() {
|
||||
return [
|
||||
['guest wifi password', 'Ravenwood Dental Group', 6, 70, 3],
|
||||
['scan to email', 'Kestrel Precision Manufacturing', 4, 52, 9],
|
||||
['out of office', 'Blackburn and Meyer LLP', 3, 40, 12],
|
||||
['voicemail pin', 'Harbor Point Credit Union', 2, 33, 18],
|
||||
['vpn', 'Sinclair Property Group', 5, 61, 2],
|
||||
['new starter form', 'Delaney Construction', 2, 25, 11],
|
||||
['chromebook', 'Summit Ridge Charter School', 7, 80, 1],
|
||||
['shared calendar', 'Ironbridge Architects', 2, 20, 6],
|
||||
['remote support', '', 9, 85, 1],
|
||||
['pricing', '', 4, 60, 8],
|
||||
];
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// demoBuildKnowledgeBase
|
||||
// The demo's Knowledge Base articles (demoDataKbArticles()) that aren't here
|
||||
// - each with who can read it, its tags, older versions, reads and feedback,
|
||||
// and a reply on the demo tickets it answers linking to it - and the
|
||||
// searches that found nothing. Once each: an article already here, and a
|
||||
// search already logged, is left alone.
|
||||
// ------------------------------
|
||||
function demoBuildKnowledgeBase($mysqli, $context, &$counts) {
|
||||
|
||||
if (!mysqli_num_rows(mysqli_query($mysqli, "SHOW TABLES LIKE 'kb_articles'"))) {
|
||||
return;
|
||||
}
|
||||
|
||||
$user_id = $context['user_id'];
|
||||
$clients = array_flip(array_map('mb_strtolower', demoDataClients($mysqli)));
|
||||
$here = demoKbArticleIds($mysqli);
|
||||
|
||||
foreach (demoDataKbArticles() as $index => $article) {
|
||||
if (isset($here[$article['name'] . '|' . $article['description']])) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Months ago, as days - so nothing lands past today whatever day of the month it is
|
||||
$made = demoDateTime($article['made'] * 30 + 2 + $index % 9, 10, ($index * 7) % 60);
|
||||
$audience = $article['audience'];
|
||||
$kind = isset($audience[0]) ? $audience[0] : (isset($audience['tags']) ? 'tags' : 'clients');
|
||||
$published = $kind !== 'draft';
|
||||
$visibility = ['all' => 'clients', 'tags' => 'clients', 'clients' => 'clients', 'public' => 'public'][$kind] ?? 'agents';
|
||||
$versions = $article['versions'];
|
||||
krsort($versions);
|
||||
|
||||
// What it says now, and when it last changed - the newest of its versions is when it was last edited
|
||||
$updated = $versions ? demoDateTime(max(1, min(array_keys($versions)) * 30 - 20), 14, 30) : null;
|
||||
$category_id = demoKbCategoryId($mysqli, $article['category']);
|
||||
$fields = [
|
||||
'kb_article_title' => $article['name'],
|
||||
'kb_article_summary' => $article['description'],
|
||||
'kb_article_content' => $article['content'],
|
||||
'kb_article_content_raw' => kbArticleContentRaw($article['name'], $article['description'], $article['content']),
|
||||
'kb_article_category_id' => $category_id,
|
||||
'kb_article_visibility' => $visibility,
|
||||
'kb_article_all_clients' => $kind === 'all' ? 1 : 0,
|
||||
'kb_article_review_months' => intval($article['review']),
|
||||
'kb_article_views' => intval($article['views']),
|
||||
'kb_article_created_at' => $made,
|
||||
'kb_article_created_by' => $user_id,
|
||||
];
|
||||
if ($published) {
|
||||
$fields['kb_article_published_at'] = date('Y-m-d H:i:s', strtotime($made . ' +2 hours'));
|
||||
}
|
||||
if ($updated) {
|
||||
$fields['kb_article_updated_at'] = $updated;
|
||||
$fields['kb_article_updated_by'] = $user_id;
|
||||
}
|
||||
if ($article['reviewed'] !== null) {
|
||||
$fields['kb_article_reviewed_at'] = demoDateTime($article['reviewed'] * 30 + 3, 11, 0);
|
||||
$fields['kb_article_reviewed_by'] = $user_id;
|
||||
}
|
||||
if ($article['archived'] !== null) {
|
||||
$fields['kb_article_archived_at'] = demoDateTime($article['archived'] * 30 + 1, 16, 0);
|
||||
}
|
||||
$kb_article_id = starterInsert($mysqli, 'kb_articles', $fields, ['kb_article_content']);
|
||||
$counts['kb']++;
|
||||
|
||||
// Who it is for
|
||||
if ($kind === 'tags') {
|
||||
demoAttachTags($mysqli, 'kb_article_client_tags', 'kb_article_id', 'tag_id', $kb_article_id, 1, $audience['tags']);
|
||||
}
|
||||
$readers = [];
|
||||
if ($kind === 'clients') {
|
||||
foreach ($audience['clients'] as $client_name) {
|
||||
$client_id = intval($clients[mb_strtolower($client_name)] ?? 0);
|
||||
if ($client_id) {
|
||||
demoLink($mysqli, 'kb_article_clients', 'kb_article_id', $kb_article_id, 'client_id', $client_id);
|
||||
}
|
||||
}
|
||||
}
|
||||
demoAttachTags($mysqli, 'kb_article_tags', 'kb_article_id', 'tag_id', $kb_article_id, 13, $article['tags']);
|
||||
|
||||
// What it said before, oldest first - each dated when it was written, the first when the article was
|
||||
$first = true;
|
||||
foreach ($versions as $months_ago => $version) {
|
||||
starterInsert($mysqli, 'kb_article_versions', [
|
||||
'kb_article_version_title' => $article['name'],
|
||||
'kb_article_version_summary' => $version[0],
|
||||
'kb_article_version_content' => $version[1],
|
||||
'kb_article_version_created_at' => $first ? $made : demoDateTime($months_ago * 30 + 5, 10, 0),
|
||||
'kb_article_version_created_by' => $user_id,
|
||||
'kb_article_version_kb_article_id' => $kb_article_id,
|
||||
], ['kb_article_version_content']);
|
||||
$first = false;
|
||||
}
|
||||
|
||||
// What its readers said - portal contacts of clients who can read it, or visitors to the help center
|
||||
if ($published && $article['feedback'] && demoKbTablesReady($mysqli)) {
|
||||
$contacts = [];
|
||||
$sql = mysqli_query($mysqli, "SELECT contact_id, contact_client_id FROM contacts
|
||||
WHERE contact_archived_at IS NULL AND contact_email <> '' AND contact_client_id IN (" . implode(',', array_map('intval', $clients ? array_values($clients) : [0])) . ")
|
||||
ORDER BY contact_id");
|
||||
while ($row = mysqli_fetch_row($sql)) {
|
||||
$contacts[] = [intval($row[0]), intval($row[1])];
|
||||
}
|
||||
$readable = demoKbReadableClients($mysqli, $kb_article_id);
|
||||
$contacts = array_values(array_filter($contacts, function ($contact) use ($readable) {
|
||||
return isset($readable[$contact[1]]);
|
||||
}));
|
||||
foreach ($article['feedback'] as $n => $feedback) {
|
||||
$public = ($feedback[2] ?? '') === 'public';
|
||||
if (!$public && !$contacts) {
|
||||
continue;
|
||||
}
|
||||
$contact = $public ? [0, 0] : $contacts[($index * 5 + $n * 3) % count($contacts)];
|
||||
$at = demoDateTime(max(1, 3 + (($index * 11 + $n * 17) % 150)), 9 + $n % 8, ($n * 13) % 60);
|
||||
if (strtotime($at) < strtotime($made)) {
|
||||
$at = date('Y-m-d H:i:s', strtotime($made . " +" . ($n + 1) . " days"));
|
||||
}
|
||||
$row = [
|
||||
'kb_article_feedback_kb_article_id' => $kb_article_id,
|
||||
'kb_article_feedback_helpful' => intval($feedback[0]),
|
||||
'kb_article_feedback_source' => $public ? 'public' : 'portal',
|
||||
'kb_article_feedback_contact_id' => $contact[0],
|
||||
'kb_article_feedback_client_id' => $contact[1],
|
||||
'kb_article_feedback_created_at' => $at,
|
||||
];
|
||||
if ($public) {
|
||||
$row['kb_article_feedback_ip'] = '203.0.113.' . (10 + ($index * 7 + $n) % 200);
|
||||
}
|
||||
if ($feedback[1] !== '') {
|
||||
$row['kb_article_feedback_comment'] = $feedback[1];
|
||||
}
|
||||
// Some of the "no"s have been looked at
|
||||
if (!$feedback[0] && $index % 2 === 0) {
|
||||
$row['kb_article_feedback_dealt_at'] = date('Y-m-d H:i:s', strtotime($at . ' +1 day'));
|
||||
$row['kb_article_feedback_dealt_by'] = $user_id;
|
||||
}
|
||||
starterInsert($mysqli, 'kb_article_feedback', $row);
|
||||
}
|
||||
}
|
||||
|
||||
// The demo tickets it answers, after it went out, get a reply linking to it
|
||||
if ($published && $article['tickets'] && $article['archived'] === null) {
|
||||
$readable = $kind === 'public' ? null : demoKbReadableClients($mysqli, $kb_article_id);
|
||||
$url = $kind === 'public' ? kbPublicUrl($kb_article_id, $article['name']) : kbPortalArticleUrl($kb_article_id);
|
||||
$subjects = implode(', ', array_map(function ($subject) {
|
||||
return "'" . escapeSql($subject) . "'";
|
||||
}, $article['tickets']));
|
||||
$sql = mysqli_query($mysqli, "SELECT ticket_id, ticket_client_id, ticket_created_at, ticket_resolved_at FROM tickets
|
||||
WHERE ticket_subject IN ($subjects) AND ticket_created_at > '" . $fields['kb_article_published_at'] . "'
|
||||
AND ticket_client_id IN (" . implode(',', array_map('intval', $clients ? array_values($clients) : [0])) . ")");
|
||||
while ($ticket = mysqli_fetch_assoc($sql)) {
|
||||
if ($readable !== null && !isset($readable[intval($ticket['ticket_client_id'])])) {
|
||||
continue;
|
||||
}
|
||||
$at = strtotime($ticket['ticket_created_at'] . ' +25 minutes');
|
||||
if (!empty($ticket['ticket_resolved_at']) && $at >= strtotime($ticket['ticket_resolved_at'])) {
|
||||
$at = (strtotime($ticket['ticket_created_at']) + strtotime($ticket['ticket_resolved_at'])) / 2;
|
||||
}
|
||||
starterInsert($mysqli, 'ticket_replies', [
|
||||
'ticket_reply' => '<p>This walks through it step by step, for next time:</p><p><a href="' . escapeHtml($url) . '">' . escapeHtml($article['name']) . '</a></p>',
|
||||
'ticket_reply_type' => 'Public',
|
||||
'ticket_reply_by' => $user_id,
|
||||
'ticket_reply_ticket_id' => intval($ticket['ticket_id']),
|
||||
'ticket_reply_created_at' => date('Y-m-d H:i:s', intval($at)),
|
||||
], ['ticket_reply']);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// What was searched for and not found
|
||||
if (demoKbTablesReady($mysqli)) {
|
||||
foreach (demoKbSearchMisses() as $miss) {
|
||||
$client_id = $miss[1] === '' ? 0 : intval($clients[mb_strtolower($miss[1])] ?? 0);
|
||||
if ($miss[1] !== '' && !$client_id) {
|
||||
continue;
|
||||
}
|
||||
mysqli_query($mysqli, "INSERT IGNORE INTO kb_search_misses SET kb_search_miss_query = '" . escapeSql($miss[0]) . "',
|
||||
kb_search_miss_source = '" . ($client_id ? 'portal' : 'public') . "', kb_search_miss_client_id = $client_id,
|
||||
kb_search_miss_searches = " . intval($miss[2]) . ", kb_search_miss_first_at = '" . demoDateTime($miss[3], 10, 15) . "',
|
||||
kb_search_miss_last_at = '" . demoDateTime($miss[4], 14, 40) . "'");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// The demo clients who can read an article - [client_id => true] (kbClientSql(), whether or not it is published).
|
||||
function demoKbReadableClients($mysqli, $kb_article_id) {
|
||||
$out = [];
|
||||
$kb_article_id = intval($kb_article_id);
|
||||
$clients = demoDataClients($mysqli);
|
||||
foreach (array_keys($clients) as $client_id) {
|
||||
$client_id = intval($client_id);
|
||||
$sql = "SELECT 1 FROM kb_articles WHERE kb_article_id = $kb_article_id AND (kb_article_visibility = 'public' OR (kb_article_visibility = 'clients' AND (kb_article_all_clients = 1
|
||||
OR EXISTS (SELECT 1 FROM kb_article_clients kc WHERE kc.kb_article_id = kb_articles.kb_article_id AND kc.client_id = $client_id)
|
||||
OR EXISTS (SELECT 1 FROM kb_article_client_tags kt JOIN client_tags ct ON ct.tag_id = kt.tag_id WHERE kt.kb_article_id = kb_articles.kb_article_id AND ct.client_id = $client_id))))";
|
||||
if (mysqli_num_rows(mysqli_query($mysqli, $sql))) {
|
||||
$out[$client_id] = true;
|
||||
}
|
||||
}
|
||||
return $out;
|
||||
}
|
||||
|
||||
// Has the database the Knowledge Base's feedback and search tables (database 3.9.7)? Asked of the tables - the demo loads with the module off too.
|
||||
function demoKbTablesReady($mysqli) {
|
||||
static $ready = null;
|
||||
return $ready ?? ($ready = mysqli_num_rows(mysqli_query($mysqli, "SHOW TABLES LIKE 'kb_search_misses'")) > 0);
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
function demoDataSpecs() {
|
||||
return [
|
||||
|
||||
@@ -182,6 +182,26 @@ if (isset($_POST['update_starter_vendor_templates'])) {
|
||||
|
||||
}
|
||||
|
||||
if (isset($_POST['update_starter_kb_articles'])) {
|
||||
|
||||
// The starter Knowledge Base articles already here, brought up to this version
|
||||
validateCSRFToken();
|
||||
|
||||
require_once 'starter_content_model.php';
|
||||
|
||||
$counts = starterUpdateKbArticles();
|
||||
|
||||
if ($counts['replaced']) {
|
||||
logAudit("Starter Content", "Edit", "$session_name brought {$counts['replaced']} starter Knowledge Base articles up to date");
|
||||
flashAlert("Brought <strong>{$counts['replaced']}</strong> starter Knowledge Base articles up to date - any whose words changed keep what they said before in their versions");
|
||||
} else {
|
||||
flashAlert("None of the starter Knowledge Base articles are here to update - add them instead", 'info');
|
||||
}
|
||||
|
||||
redirect();
|
||||
|
||||
}
|
||||
|
||||
if (isset($_POST['update_starter_license_templates'])) {
|
||||
|
||||
// The starter license templates already here, brought up to this version
|
||||
@@ -210,12 +230,15 @@ if (isset($_POST['load_demo_data'])) {
|
||||
|
||||
$counts = demoDataLoad($mysqli);
|
||||
|
||||
if (!$counts['clients']) {
|
||||
if (!$counts['clients'] && !$counts['kb']) {
|
||||
flashAlert("Nothing to add - every demo client is already here", 'info');
|
||||
redirect();
|
||||
}
|
||||
|
||||
$summary = "{$counts['clients']} clients, {$counts['contacts']} contacts, {$counts['assets']} assets, {$counts['documentation']} documentation records, {$counts['tickets']} tickets, {$counts['projects']} projects, {$counts['billing']} billing records, {$counts['company']} company records";
|
||||
$summary = $counts['clients'] ? "{$counts['clients']} clients, {$counts['contacts']} contacts, {$counts['assets']} assets, {$counts['documentation']} documentation records, {$counts['tickets']} tickets, {$counts['projects']} projects, {$counts['billing']} billing records, {$counts['company']} company records" : '';
|
||||
if ($counts['kb']) {
|
||||
$summary .= ($summary !== '' ? ', ' : '') . "{$counts['kb']} Knowledge Base articles";
|
||||
}
|
||||
|
||||
|
||||
logAudit("Demo Data", "Create", "$session_name loaded demo data - $summary");
|
||||
|
||||
@@ -25,12 +25,12 @@ function starterContentPacks() {
|
||||
'categories' => [
|
||||
'label' => 'Categories',
|
||||
'icon' => 'fa-list-ul',
|
||||
'description' => 'Expense, income, referral and ticket categories for an MSP. Income categories are also what products are filed under.',
|
||||
'description' => 'Expense, income, referral, ticket and Knowledge Base categories for an MSP. Income categories are also what products are filed under.',
|
||||
],
|
||||
'tags' => [
|
||||
'label' => 'Tags',
|
||||
'icon' => 'fa-tags',
|
||||
'description' => 'Tags for clients, locations, contacts, credentials, assets, vendors, domains, licenses, services, networks, documents and tickets.',
|
||||
'description' => 'Tags for clients, locations, contacts, credentials, assets, vendors, domains, licenses, services, networks, documents, tickets and Knowledge Base articles.',
|
||||
],
|
||||
'ticket_templates' => [
|
||||
'label' => 'Ticket Templates',
|
||||
@@ -56,6 +56,16 @@ function starterContentPacks() {
|
||||
'confirm' => 'Bring the %d starter canned responses you have up to date? What they say, where they are offered and what they set up are replaced with this version - changes you made to them are lost. How often they have been used stays.',
|
||||
],
|
||||
],
|
||||
'kb_articles' => [
|
||||
'label' => 'Knowledge Base Articles',
|
||||
'icon' => 'fa-book',
|
||||
'description' => "How-tos and fixes clients ask for again and again - resetting a password, setting up MFA, reporting phishing, Outlook, OneDrive, the VPN, printers, Wi-Fi - each filed under its Knowledge Base category with its tags, and reviewed once a year. They come in as drafts only your team can see, ending with how to reach you from Company Details: read each, make it say what your clients use, then publish it to the clients it suits.",
|
||||
'requires' => 'categories',
|
||||
'update' => [
|
||||
'button' => 'update_starter_kb_articles',
|
||||
'confirm' => 'Bring the %d starter Knowledge Base articles you have up to date? Their summary, what they say, category and review period are replaced with this version - what they said before is kept as a version, so changes you made can be put back. Whether they are published, who can read them, their tags, reads and feedback stay as they are.',
|
||||
],
|
||||
],
|
||||
'vendor_templates' => [
|
||||
'label' => 'Vendor Templates',
|
||||
'icon' => 'fa-building',
|
||||
@@ -218,6 +228,8 @@ function starterContentLoad($mysqli, $pack, $dry_run = false, $only = null) {
|
||||
return starterLoadProjectTemplates($mysqli, $dry_run, $only);
|
||||
case 'canned_responses':
|
||||
return starterLoadCannedResponses($mysqli, $dry_run, $only);
|
||||
case 'kb_articles':
|
||||
return starterLoadKbArticles($mysqli, $dry_run, $only);
|
||||
case 'vendor_templates':
|
||||
return starterLoadVendorTemplates($mysqli, $dry_run, $only);
|
||||
case 'document_templates':
|
||||
@@ -246,6 +258,8 @@ function starterContentRows($pack) {
|
||||
return starterContentProjectTemplates();
|
||||
case 'canned_responses':
|
||||
return starterContentCannedResponses();
|
||||
case 'kb_articles':
|
||||
return starterContentKbArticles();
|
||||
case 'vendor_templates':
|
||||
return starterContentVendorTemplates();
|
||||
case 'document_templates':
|
||||
@@ -294,6 +308,8 @@ function starterItemGroup($pack, $row) {
|
||||
return function_exists('tagEntityByType') ? (string) (tagEntityByType($row[0])['title'] ?? '') : '';
|
||||
case 'products':
|
||||
return (string) $row[4];
|
||||
case 'kb_articles':
|
||||
return (string) $row['category'];
|
||||
}
|
||||
return '';
|
||||
}
|
||||
@@ -340,7 +356,8 @@ function starterContentItems($mysqli, $pack) {
|
||||
default:
|
||||
$tables = ['ticket_templates' => ['ticket_templates', 'ticket_template_name'], 'project_templates' => ['project_templates', 'project_template_name'],
|
||||
'vendor_templates' => ['vendor_templates', 'vendor_template_name'], 'document_templates' => ['document_templates', 'document_template_name'],
|
||||
'products' => ['products', 'product_name'], 'license_templates' => ['software_templates', 'software_template_name']];
|
||||
'products' => ['products', 'product_name'], 'license_templates' => ['software_templates', 'software_template_name'],
|
||||
'kb_articles' => ['kb_articles', 'kb_article_title']];
|
||||
if (!isset($tables[$pack])) {
|
||||
return [];
|
||||
}
|
||||
@@ -376,6 +393,7 @@ function starterPackRecords($pack) {
|
||||
'document_templates' => ['table' => 'document_templates', 'id' => 'document_template_id', 'name' => 'document_template_name', 'archived' => 'document_template_archived_at'],
|
||||
'products' => ['table' => 'products', 'id' => 'product_id', 'name' => 'product_name', 'archived' => 'product_archived_at', 'kind' => 'product_code'],
|
||||
'license_templates' => ['table' => 'software_templates', 'id' => 'software_template_id', 'name' => 'software_template_name', 'archived' => 'software_template_archived_at'],
|
||||
'kb_articles' => ['table' => 'kb_articles', 'id' => 'kb_article_id', 'name' => 'kb_article_title', 'archived' => 'kb_article_archived_at'],
|
||||
];
|
||||
return $packs[$pack] ?? null;
|
||||
}
|
||||
@@ -445,7 +463,7 @@ function starterPackUsed($mysqli, $pack, array $ids) {
|
||||
switch ($pack) {
|
||||
case 'categories':
|
||||
// What Admin > Categories counts for each kind, and what it doesn't
|
||||
foreach (['Expense', 'Income', 'Referral', 'Ticket'] as $kind) {
|
||||
foreach (['Expense', 'Income', 'Referral', 'Ticket', 'kb'] as $kind) {
|
||||
foreach (array_keys(categoryUsage($kind)) as $category_id) {
|
||||
$used[intval($category_id)] = true;
|
||||
}
|
||||
@@ -519,6 +537,14 @@ function starterPackUsed($mysqli, $pack, array $ids) {
|
||||
case 'license_templates':
|
||||
$queries = ["SELECT software_template_id FROM software WHERE software_template_id IN ($in)"];
|
||||
break;
|
||||
case 'kb_articles':
|
||||
// Published, read, reviewed, reworded (it has versions) or answered - anything more than the draft it came in as
|
||||
$queries = [
|
||||
"SELECT kb_article_id FROM kb_articles WHERE kb_article_id IN ($in) AND (kb_article_published_at IS NOT NULL OR kb_article_views > 0 OR kb_article_reviewed_at IS NOT NULL)",
|
||||
"SELECT kb_article_version_kb_article_id FROM kb_article_versions WHERE kb_article_version_kb_article_id IN ($in)",
|
||||
"SELECT kb_article_feedback_kb_article_id FROM kb_article_feedback WHERE kb_article_feedback_kb_article_id IN ($in)",
|
||||
];
|
||||
break;
|
||||
}
|
||||
foreach ($queries as $query) {
|
||||
$sql = mysqli_query($mysqli, str_replace('SELECT ', 'SELECT DISTINCT ', $query));
|
||||
@@ -615,6 +641,8 @@ function starterContentTotal($pack) {
|
||||
return count(starterContentProjectTemplates());
|
||||
case 'canned_responses':
|
||||
return count(starterContentCannedResponses());
|
||||
case 'kb_articles':
|
||||
return count(starterContentKbArticles());
|
||||
case 'vendor_templates':
|
||||
return count(starterContentVendorTemplates());
|
||||
case 'document_templates':
|
||||
@@ -885,6 +913,139 @@ function starterUpdateLicenseTemplates() {
|
||||
return softwareTemplatesImport($templates, 'replace', true);
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterLoadKbArticles
|
||||
// As drafts only agents can read, each with its Knowledge Base category and
|
||||
// tags - those of the Categories and Tags packs, so one that isn't here
|
||||
// leaves the article without it. One whose title an article here already
|
||||
// has, archived or not, is left alone. How to reach you is filled in from
|
||||
// Company Details as they are now (starterKbFill()).
|
||||
// ------------------------------
|
||||
function starterLoadKbArticles($mysqli, $dry_run = false, $only = null) {
|
||||
$existing = starterExistingNames($mysqli, 'kb_articles', 'kb_article_title');
|
||||
$added = 0;
|
||||
|
||||
foreach (starterOnly('kb_articles', starterContentKbArticles(), $only) as $article) {
|
||||
if (isset($existing[mb_strtolower($article['name'])])) {
|
||||
continue;
|
||||
}
|
||||
$added++;
|
||||
if ($dry_run) {
|
||||
continue;
|
||||
}
|
||||
$kb_article_id = kbArticleSave(starterKbFields($mysqli, $article) + ['published' => false, 'visibility' => 'agents', 'all_clients' => false, 'client_tag_ids' => [], 'client_ids' => []]);
|
||||
starterKbTags($mysqli, $kb_article_id, $article['tags']);
|
||||
$existing[mb_strtolower($article['name'])] = true;
|
||||
}
|
||||
|
||||
return $added;
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterUpdateKbArticles
|
||||
// The starter articles here, not archived, brought up to this library's
|
||||
// version - their summary, what they say, category (when it is here) and
|
||||
// review period. What one said before is kept as a version, as any edit's
|
||||
// is; one that already says this is left untouched. Whether they are
|
||||
// published, who can read them, their reads and feedback stay, and they gain
|
||||
// the library's tags they haven't got. Returns ['replaced' => n].
|
||||
// ------------------------------
|
||||
function starterUpdateKbArticles() {
|
||||
global $mysqli;
|
||||
|
||||
$here = starterPackHere($mysqli, 'kb_articles');
|
||||
$replaced = 0;
|
||||
foreach (starterContentKbArticles() as $article) {
|
||||
$row = kbArticleRow($here[mb_strtolower($article['name'])] ?? 0);
|
||||
if (!$row) {
|
||||
continue;
|
||||
}
|
||||
$fields = starterKbFields($mysqli, $article);
|
||||
$fields['title'] = $row['kb_article_title'];
|
||||
$fields['category_id'] = $fields['category_id'] ?: intval($row['kb_article_category_id']);
|
||||
if ($fields['summary'] !== (string) $row['kb_article_summary'] || $fields['content'] !== (string) $row['kb_article_content']
|
||||
|| $fields['category_id'] !== intval($row['kb_article_category_id']) || $fields['review_months'] !== intval($row['kb_article_review_months'])) {
|
||||
kbArticleSave($fields + ['published' => !empty($row['kb_article_published_at'])] + kbAudienceFields($row), $row);
|
||||
}
|
||||
starterKbTags($mysqli, $row['kb_article_id'], $article['tags']);
|
||||
$replaced++;
|
||||
}
|
||||
|
||||
return ['replaced' => $replaced];
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterKbFields
|
||||
// A library article as kbArticleSave() takes it - its category this
|
||||
// install's Knowledge Base category of that name (0 when there is none), and
|
||||
// what it says filled in (starterKbFill()).
|
||||
// ------------------------------
|
||||
function starterKbFields($mysqli, array $article) {
|
||||
return [
|
||||
'title' => $article['name'],
|
||||
'summary' => $article['description'],
|
||||
'category_id' => starterCategoryId($mysqli, $article['category'], 'kb'),
|
||||
'review_months' => intval($article['review_months']),
|
||||
'content' => starterKbFill($article['content']),
|
||||
];
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterKbTags
|
||||
// Puts the Knowledge Base article tags of these names on an article - the
|
||||
// ones here and not archived, and not on it already.
|
||||
// ------------------------------
|
||||
function starterKbTags($mysqli, $kb_article_id, array $names) {
|
||||
$kb_article_id = intval($kb_article_id);
|
||||
if (!$kb_article_id || !$names) {
|
||||
return;
|
||||
}
|
||||
$names_sql = implode(', ', array_map(function ($name) {
|
||||
return "'" . escapeSql(mb_strtolower($name)) . "'";
|
||||
}, $names));
|
||||
$sql = mysqli_query($mysqli, "SELECT tag_id FROM tags WHERE tag_type = 13 AND tag_archived_at IS NULL AND LOWER(tag_name) IN ($names_sql)");
|
||||
while ($row = mysqli_fetch_row($sql)) {
|
||||
mysqli_query($mysqli, "INSERT IGNORE INTO kb_article_tags SET kb_article_id = $kb_article_id, tag_id = " . intval($row[0]));
|
||||
}
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterKbFill
|
||||
// A starter article's [Portal] and [Contact us] filled in from this install:
|
||||
// a link to the client portal (words alone when the portal is off), and a
|
||||
// closing line saying how to reach you - open a ticket in the portal, the
|
||||
// address tickets are emailed from (or the company's), and the company's
|
||||
// phone, from Company Details as they are now.
|
||||
// ------------------------------
|
||||
function starterKbFill($html) {
|
||||
global $config_base_url, $config_ticket_from_email;
|
||||
|
||||
$company = billingCompany();
|
||||
$portal_on = function_exists('moduleOn') && moduleOn('portal') && !empty($config_base_url);
|
||||
$portal_url = $portal_on ? 'https://' . $config_base_url . '/client/' : '';
|
||||
$portal = $portal_on ? '<a href="' . escapeHtml($portal_url) . '">the client portal</a>' : 'the client portal';
|
||||
|
||||
$ways = [];
|
||||
if ($portal_on) {
|
||||
$ways[] = 'open a ticket in ' . $portal;
|
||||
}
|
||||
$email = trim((string) ($config_ticket_from_email ?? '')) ?: trim((string) ($company['company_email'] ?? ''));
|
||||
if ($email !== '') {
|
||||
$ways[] = 'email <a href="mailto:' . escapeHtml($email) . '">' . escapeHtml($email) . '</a>';
|
||||
}
|
||||
if (($company['phone_display'] ?? '') !== '') {
|
||||
$ways[] = 'call ' . escapeHtml($company['phone_display']);
|
||||
}
|
||||
if ($ways) {
|
||||
$last = array_pop($ways);
|
||||
$contact = '<p><strong>Still stuck?</strong> ' . ucfirst($ways ? implode(', ', $ways) . ' or ' . $last : $last) . ' and we will take it from there.</p>';
|
||||
} else {
|
||||
$contact = '<p><strong>Still stuck?</strong> Get in touch with us and we will take it from there.</p>';
|
||||
}
|
||||
|
||||
return str_replace(['[Portal]', '[Contact us]'], [$portal, $contact], (string) $html);
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterLoadProducts
|
||||
// Products are filed under income categories. A category that is not present
|
||||
@@ -1034,6 +1195,22 @@ function starterContentCategories() {
|
||||
['Other', '#343a40', 'fa-question-circle', 'Does not fit any standard category'],
|
||||
];
|
||||
|
||||
// How Knowledge Base articles are grouped - an article's icon is its category's
|
||||
$kb_categories = [
|
||||
['Getting Help', '#007bff', 'fa-life-ring', 'Reaching the help desk, the client portal and support hours'],
|
||||
['Accounts and Passwords', '#ffc107', 'fa-key', 'Signing in, passwords and multi-factor authentication'],
|
||||
['Email and Calendar', '#fd7e14', 'fa-envelope', 'Outlook, mailboxes, calendars and shared mail'],
|
||||
['Files and Sharing', '#20c997', 'fa-folder-open', 'OneDrive, SharePoint, shared drives and sending files'],
|
||||
['Security', '#dc3545', 'fa-shield-alt', 'Phishing, lost devices and keeping data safe'],
|
||||
['Remote Work', '#6f42c1', 'fa-laptop-house', 'The VPN, working from home and traveling'],
|
||||
['Printing and Scanning', '#6c757d', 'fa-print', 'Printers, scanners and copiers'],
|
||||
['Phones and Meetings', '#28a745', 'fa-headset', 'Desk phones, voicemail and video meetings'],
|
||||
['Devices', '#17a2b8', 'fa-laptop', 'Computers, phones and tablets, and keeping them up to date'],
|
||||
['Network and Wi-Fi', '#6610f2', 'fa-wifi', 'The office and guest Wi-Fi, and the internet connection'],
|
||||
['Policies', '#001f3f', 'fa-clipboard-check', 'How we work together - new starters, leavers and acceptable use'],
|
||||
['Internal Procedures', '#343a40', 'fa-user-shield', 'How your team does things - kept to agents'],
|
||||
];
|
||||
|
||||
$categories = [];
|
||||
|
||||
$simple_types = [
|
||||
@@ -1054,17 +1231,19 @@ function starterContentCategories() {
|
||||
}
|
||||
}
|
||||
|
||||
$order = 1;
|
||||
foreach ($ticket_categories as $row) {
|
||||
$categories[] = [
|
||||
'type' => 'Ticket',
|
||||
'name' => $row[0],
|
||||
'color' => $row[1],
|
||||
'icon' => $row[2],
|
||||
'description' => $row[3],
|
||||
'order' => $order,
|
||||
];
|
||||
$order++;
|
||||
foreach (['Ticket' => $ticket_categories, 'kb' => $kb_categories] as $type => $rows) {
|
||||
$order = 1;
|
||||
foreach ($rows as $row) {
|
||||
$categories[] = [
|
||||
'type' => $type,
|
||||
'name' => $row[0],
|
||||
'color' => $row[1],
|
||||
'icon' => $row[2],
|
||||
'description' => $row[3],
|
||||
'order' => $order,
|
||||
];
|
||||
$order++;
|
||||
}
|
||||
}
|
||||
|
||||
return $categories;
|
||||
@@ -1074,7 +1253,8 @@ function starterContentCategories() {
|
||||
// ------------------------------
|
||||
// starterContentTags
|
||||
// tag_type 1 Client, 2 Location, 3 Contact, 4 Credential, 5 Asset, 6 Vendor, 7 Domain,
|
||||
// 8 License, 9 Service, 10 Network, 11 Document, 12 Ticket - tagKinds() in functions/tags.php.
|
||||
// 8 License, 9 Service, 10 Network, 11 Document, 12 Ticket, 13 Knowledge Base article - tagKinds()
|
||||
// in functions/tags.php.
|
||||
// tag_icon is stored without the fa- prefix, the views add it.
|
||||
// ------------------------------
|
||||
function starterContentTags() {
|
||||
@@ -1220,6 +1400,18 @@ function starterContentTags() {
|
||||
[12, 'Warranty Claim', '#28a745', 'certificate'],
|
||||
[12, 'Waiting on Vendor', '#ffc107', 'hourglass-half'],
|
||||
[12, 'Security', '#343a40', 'shield-alt'],
|
||||
|
||||
// Knowledge Base article
|
||||
[13, 'How-To', '#007bff', 'list-ol'],
|
||||
[13, 'Troubleshooting', '#fd7e14', 'wrench'],
|
||||
[13, 'Quick Fix', '#ffc107', 'bolt'],
|
||||
[13, 'Self-Service', '#28a745', 'hand-pointer'],
|
||||
[13, 'Security', '#dc3545', 'shield-alt'],
|
||||
[13, 'Policy', '#001f3f', 'gavel'],
|
||||
[13, 'Microsoft 365', '#0078d4', 'cloud'],
|
||||
[13, 'Mobile', '#17a2b8', 'mobile-alt'],
|
||||
[13, 'New Starter', '#20c997', 'user-plus'],
|
||||
[13, 'Known Issue', '#d81b60', 'exclamation-triangle'],
|
||||
];
|
||||
|
||||
return $tags;
|
||||
@@ -2469,3 +2661,378 @@ function starterContentLicenseTemplates() {
|
||||
];
|
||||
|
||||
}
|
||||
|
||||
// ------------------------------
|
||||
// starterContentKbArticles
|
||||
// How-tos and fixes for an MSP's clients - name (the title), description (the
|
||||
// line under it), category (a Knowledge Base category of the Categories
|
||||
// pack), tags (Knowledge Base article tags of the Tags pack), review_months
|
||||
// and content (HTML). Written as the MSP, to its clients' staff, for
|
||||
// Microsoft 365 and Windows as most clients have them - each says where to
|
||||
// put what yours differs in. [Portal] and [Contact us] are filled in as each
|
||||
// comes in (starterKbFill()).
|
||||
// ------------------------------
|
||||
function starterContentKbArticles() {
|
||||
|
||||
$steps = function (array $items) {
|
||||
return '<ol><li>' . implode('</li><li>', $items) . '</li></ol>';
|
||||
};
|
||||
$list = function (array $items) {
|
||||
return '<ul><li>' . implode('</li><li>', $items) . '</li></ul>';
|
||||
};
|
||||
$article = function ($name, $description, $category, array $tags, $content, $review_months = 12) {
|
||||
return ['name' => $name, 'description' => $description, 'category' => $category, 'tags' => $tags, 'review_months' => $review_months, 'content' => $content . '[Contact us]'];
|
||||
};
|
||||
|
||||
return [
|
||||
|
||||
// Getting Help
|
||||
$article('Getting help from the help desk', 'How to reach us, what to tell us so we can help straight away, and what happens next.', 'Getting Help', ['How-To'],
|
||||
'<p>The quickest way to get help is to open a ticket in [Portal] - it reaches the whole team, and you can follow it as we work on it. Email works too, and for anything stopping you from working, call us.</p>'
|
||||
. '<h5>Tell us</h5>' . $list([
|
||||
'What you were trying to do, and what happened instead - the exact wording of any error helps a lot (a screenshot is even better)',
|
||||
'When it started, and whether anything changed around then',
|
||||
'Whether it is just you, or others too',
|
||||
'The best number to reach you on, and when you are free',
|
||||
])
|
||||
. '<h5>What happens next</h5><p>You get an email with the ticket\'s number straight away. Reply to that email to add anything - keep the number in the subject so it lands on the same ticket. We let you know when someone has picked it up, when we need something from you, and when it is fixed.</p>'
|
||||
. '<p>If something is urgent - you can\'t work, or several people are affected - say so, and call as well as opening the ticket.</p>'),
|
||||
|
||||
$article('Raising a ticket in the client portal', 'Sign in to the client portal, open a ticket and follow it as we work on it.', 'Getting Help', ['How-To', 'Self-Service'],
|
||||
'<p>The client portal is where you open tickets, see what is happening with them and reply to us. It is quicker than email, and nothing gets lost in an inbox.</p>'
|
||||
. $steps([
|
||||
'Go to [Portal] and sign in with your work email address. The first time, use <strong>Forgot your password?</strong> to set one.',
|
||||
'Choose <strong>New Ticket</strong>.',
|
||||
'Give it a subject that says what is wrong - "Outlook won\'t open on my laptop" helps more than "Problem".',
|
||||
'Say what happened, when it started and anything you have tried. Add a screenshot if you have one.',
|
||||
'Choose how urgent it is, then <strong>Submit</strong>.',
|
||||
])
|
||||
. '<p>While you type the subject, the portal suggests articles that might answer it - worth a look, you may not have to wait for us at all.</p>'
|
||||
. '<p>Your tickets are under <strong>Tickets</strong>. Open one to see where it is up to and to reply. When we mark it resolved, you can reply to reopen it if it isn\'t fixed.</p>'),
|
||||
|
||||
// Accounts and Passwords
|
||||
$article('Changing or resetting your Microsoft 365 password', 'Change your password yourself, reset it when you have forgotten it, and what to do when you are locked out.', 'Accounts and Passwords', ['How-To', 'Self-Service', 'Microsoft 365'],
|
||||
'<h5>Change it while you know it</h5>' . $steps([
|
||||
'Sign in at <a href="https://myaccount.microsoft.com">myaccount.microsoft.com</a>.',
|
||||
'Choose <strong>Password</strong> (or <strong>Change password</strong>).',
|
||||
'Type your old password, then the new one twice, and save.',
|
||||
])
|
||||
. '<h5>Forgotten it</h5>' . $steps([
|
||||
'Go to <a href="https://passwordreset.microsoftonline.com">passwordreset.microsoftonline.com</a>.',
|
||||
'Enter your work email address and the characters shown.',
|
||||
'Prove it is you with your authenticator app, a text or a call, as you set up when you registered.',
|
||||
'Choose a new password.',
|
||||
])
|
||||
. '<p>On a work computer, sign in with the new password straight away. Your phone and other devices will ask for it next time they check email - type it in when they do.</p>'
|
||||
. '<h5>Locked out</h5><p>After too many wrong attempts your account locks for a while. Wait 15 minutes and try again, or use the reset above. If self-service reset isn\'t set up for you, we can reset it - we will check it is really you first, so expect a call back.</p>'
|
||||
. '<p>Never send your password to anyone by email or in a ticket - we will never ask for it.</p>'),
|
||||
|
||||
$article('Setting up multi-factor authentication', 'Register the Microsoft Authenticator app so signing in needs your phone as well as your password.', 'Accounts and Passwords', ['How-To', 'Security', 'Microsoft 365', 'Mobile'],
|
||||
'<p>Multi-factor authentication (MFA) means that signing in takes your password and a tap on your phone. Even if someone gets your password, they can\'t get in without your phone.</p>'
|
||||
. '<h5>You need</h5>' . $list(['Your phone, with the <strong>Microsoft Authenticator</strong> app installed from the App Store or Google Play', 'A computer, signed in to your work account'])
|
||||
. '<h5>Set it up</h5>' . $steps([
|
||||
'On the computer, go to <a href="https://aka.ms/mfasetup">aka.ms/mfasetup</a> and sign in.',
|
||||
'When asked to keep your account secure, choose <strong>Next</strong> until a QR code shows.',
|
||||
'In the Authenticator app, tap <strong>+</strong>, choose <strong>Work or school account</strong>, then <strong>Scan a QR code</strong>, and scan it.',
|
||||
'Back on the computer, choose <strong>Next</strong>. A test notification arrives on your phone - type the number shown on screen into the app and approve it.',
|
||||
'Add your phone number as a backup method when asked.',
|
||||
])
|
||||
. '<p>From now on, when you sign in somewhere new you are asked to approve it on your phone.</p>'
|
||||
. '<p><strong>Only approve a sign-in you have just started yourself.</strong> If your phone asks you to approve one you didn\'t start, deny it and tell us straight away - someone has your password.</p>'),
|
||||
|
||||
$article('Moving your authenticator to a new phone', 'Get multi-factor sign-in onto a new phone before you wipe or trade in the old one.', 'Accounts and Passwords', ['How-To', 'Mobile', 'Microsoft 365'],
|
||||
'<p>Do this while you still have the old phone - without it, you won\'t be able to sign in until we reset your methods.</p>'
|
||||
. $steps([
|
||||
'Install <strong>Microsoft Authenticator</strong> on the new phone.',
|
||||
'On a computer, go to <a href="https://mysignins.microsoft.com/security-info">mysignins.microsoft.com/security-info</a> and sign in, approving on the old phone.',
|
||||
'Choose <strong>Add sign-in method</strong>, then <strong>Authenticator app</strong>, and follow the steps with the new phone to scan the QR code.',
|
||||
'Make the new phone the default method if asked.',
|
||||
'Delete the old phone\'s entry from the list, then remove the account from the app on the old phone.',
|
||||
'If your phone number changed, update it on the same page.',
|
||||
])
|
||||
. '<h5>Already lost or wiped the old phone</h5><p>Contact us. We will check it is really you, clear your old methods, and you set the new phone up the next time you sign in.</p>'),
|
||||
|
||||
$article('Choosing a strong password and using a password manager', 'How to pick passwords that are hard to guess and easy to remember, and why a password manager helps.', 'Accounts and Passwords', ['Security'],
|
||||
'<p>Most account break-ins use passwords that were guessed or leaked from another website. Two habits stop nearly all of them.</p>'
|
||||
. '<h5>Use a passphrase</h5><p>Three or four random words make a password that is long, strong and easy to remember - <em>copper-lantern-river-oak</em> is far harder to crack than <em>P@ssw0rd1</em>. Don\'t use names, dates, or anything someone could find on your social media.</p>'
|
||||
. '<h5>Never reuse it</h5><p>Every website gets its own password. When one site is breached, criminals try the same email and password everywhere else.</p>'
|
||||
. '<h5>Let a password manager remember them</h5>' . $list([
|
||||
'It remembers a different strong password for every site, and fills them in for you',
|
||||
'You only remember one passphrase - the one that unlocks it',
|
||||
'It only fills a password in on the real website, so it helps you spot fake ones',
|
||||
])
|
||||
. '<p>Ask us which password manager we support for your business before you put work passwords in a personal one.</p>'),
|
||||
|
||||
// Security
|
||||
$article('Spotting and reporting a phishing email', 'The signs of a phishing email, and how to report one without clicking anything.', 'Security', ['Security', 'How-To'],
|
||||
'<p>Phishing emails pretend to be from someone you trust to get you to click a link, open an attachment, enter your password or pay something.</p>'
|
||||
. '<h5>Warning signs</h5>' . $list([
|
||||
'It is urgent or threatening - your account will be closed, a payment is overdue, act now',
|
||||
'The sender\'s address doesn\'t match who it says it is from - hover over the name to see the real address',
|
||||
'A link\'s address, shown when you hover over it, goes somewhere unexpected',
|
||||
'It asks you to sign in, pay, change bank details or buy gift cards',
|
||||
'An attachment you weren\'t expecting, even from someone you know',
|
||||
'A warning banner saying it is from outside the company, when it claims to be from inside',
|
||||
])
|
||||
. '<h5>Report it</h5>' . $steps([
|
||||
'Don\'t click links, open attachments or reply.',
|
||||
'In Outlook, use <strong>Report</strong> (or <strong>Report Phishing</strong>) on the toolbar - or forward it to us as an attachment.',
|
||||
'Delete it.',
|
||||
])
|
||||
. '<p>Not sure? Ask us before you click - we would much rather check ten genuine emails than clean up after one bad one. If someone asks you to change bank details or make an urgent payment, call them on a number you already have to check.</p>'),
|
||||
|
||||
$article('I clicked a link or entered my password - what now?', 'What to do straight away if you think you fell for a phishing email.', 'Security', ['Security', 'Quick Fix'],
|
||||
'<p>It happens to everyone. Acting quickly makes the difference, so don\'t wait to be sure.</p>'
|
||||
. $steps([
|
||||
'If you typed your password into a page, change it now - see <em>Changing or resetting your Microsoft 365 password</em>. Change it anywhere else you used the same one.',
|
||||
'If you opened an attachment or ran something, unplug the network cable or turn off Wi-Fi on that computer, but leave it switched on.',
|
||||
'Call us straight away and tell us what you clicked, when, and what happened. Keep the email - don\'t delete it.',
|
||||
'Deny any multi-factor sign-in request you didn\'t start.',
|
||||
])
|
||||
. '<p>We will check your account for anything changed - forwarding rules, new sign-ins, sent email - and tell you if anything else needs doing. Nobody is in trouble for reporting it; the only mistake is keeping quiet.</p>'),
|
||||
|
||||
$article('Lost or stolen laptop or phone', 'What to do straight away when a device with work email or files on it goes missing.', 'Security', ['Security'],
|
||||
'<p>Tell us as soon as you notice - day or night. The sooner we know, the less anyone can do with it.</p>'
|
||||
. $steps([
|
||||
'Call us, and say which device it is and when you last had it.',
|
||||
'If it was stolen, report it to the police and keep the reference number.',
|
||||
'Change your Microsoft 365 password from another device.',
|
||||
])
|
||||
. '<p>We sign the device out of your work account, and for devices we manage we can lock or wipe it remotely. If it turns up, let us know before you use it again.</p>'),
|
||||
|
||||
// Devices
|
||||
$article('Keeping your computer up to date', 'Why updates matter, what the restart reminders mean, and how to get them done without losing work.', 'Devices', ['How-To', 'Self-Service'],
|
||||
'<p>Updates fix security holes that attackers use. We send them out to managed computers and schedule most of them for outside working hours - but many only finish when the computer restarts.</p>'
|
||||
. '<h5>When it asks you to restart</h5>' . $list([
|
||||
'Save your work and restart at the end of the day, or choose a time that suits you',
|
||||
'Don\'t keep putting it off - after a few days it restarts on its own',
|
||||
'Leave the computer on and plugged in at night when you can - most updates run then',
|
||||
])
|
||||
. '<h5>To check yourself</h5><p>On Windows, open <strong>Settings > Windows Update</strong> and choose <strong>Check for updates</strong>. On a Mac, open <strong>System Settings > General > Software Update</strong>.</p>'
|
||||
. '<p>Keep your phone and tablet up to date too - install updates when they appear.</p>'),
|
||||
|
||||
$article('Restarting your computer properly', 'Why restarting fixes so much, and why shutting down isn\'t the same.', 'Devices', ['Quick Fix', 'Troubleshooting'],
|
||||
'<p>A restart clears out programs that have stopped responding, finishes updates and reconnects to the network. It fixes a surprising number of problems, so it is the first thing to try.</p>'
|
||||
. $steps([
|
||||
'Save your work and close your programs.',
|
||||
'Choose <strong>Start</strong>, the power button, then <strong>Restart</strong> - not Shut down.',
|
||||
'Wait for it to start again and sign in.',
|
||||
])
|
||||
. '<p>On Windows, <strong>Shut down</strong> keeps part of the system as it was so it starts faster - it doesn\'t clear things out the way <strong>Restart</strong> does. Closing a laptop\'s lid only puts it to sleep.</p>'
|
||||
. '<p>If it still isn\'t right after a restart, tell us what you were doing and what you see - and that you have restarted, which saves a step.</p>'),
|
||||
|
||||
// Email and Calendar
|
||||
$article('Setting an out of office reply', 'Tell people who email you that you are away, in Outlook or on the web.', 'Email and Calendar', ['How-To', 'Self-Service', 'Microsoft 365'],
|
||||
'<h5>Outlook on the web, or the new Outlook</h5>' . $steps([
|
||||
'Open <strong>Settings</strong> (the gear), then <strong>Account > Automatic replies</strong>.',
|
||||
'Turn on <strong>Turn on automatic replies</strong>.',
|
||||
'Tick <strong>Send replies only during a time period</strong> and choose when you leave and when you are back.',
|
||||
'Write the message - one for people in your company, and one for everyone else if you want it to differ.',
|
||||
'Choose <strong>Save</strong>.',
|
||||
])
|
||||
. '<h5>Classic Outlook on Windows</h5><p>Choose <strong>File > Automatic Replies</strong>, then as above.</p>'
|
||||
. '<p>Say when you are back and who to contact meanwhile - but keep personal details, like being on holiday abroad, out of the reply that goes outside the company.</p>'),
|
||||
|
||||
$article('Sharing your calendar or opening someone else\'s', 'Let colleagues see when you are free, and add their calendars beside yours.', 'Email and Calendar', ['How-To', 'Microsoft 365'],
|
||||
'<h5>Share yours</h5>' . $steps([
|
||||
'In Outlook, open your calendar.',
|
||||
'Choose <strong>Share</strong> (or right-click your calendar and choose <strong>Sharing permissions</strong>).',
|
||||
'Add the person, and choose what they see - just when you are busy, the titles and places, or everything - or let them edit it.',
|
||||
'Choose <strong>Share</strong>. They get an email to accept.',
|
||||
])
|
||||
. '<h5>Open someone else\'s</h5><p>In your calendar choose <strong>Add calendar</strong>, then <strong>Add from directory</strong> (or <strong>Open shared calendar</strong>), and pick the person. You see what they have shared with you.</p>'
|
||||
. '<p>To book a meeting without needing their calendar, use the <strong>Scheduling Assistant</strong> in a new meeting - it shows when everyone is free.</p>'),
|
||||
|
||||
$article('Adding a shared mailbox in Outlook', 'Open a shared mailbox like info@ or accounts@ alongside your own.', 'Email and Calendar', ['How-To', 'Microsoft 365'],
|
||||
'<p>Once we have given you access, a shared mailbox usually appears in Outlook on its own within an hour or so - restart Outlook if it hasn\'t.</p>'
|
||||
. '<h5>If it doesn\'t appear</h5><p><strong>Outlook on the web or the new Outlook:</strong> right-click <strong>Folders</strong> in the folder list, choose <strong>Add shared folder or mailbox</strong> and type the mailbox\'s address.</p>'
|
||||
. '<p><strong>Classic Outlook on Windows:</strong> choose <strong>File > Account Settings > Account Settings</strong>, select your account, <strong>Change > More Settings > Advanced</strong>, then <strong>Add</strong> the mailbox\'s address.</p>'
|
||||
. '<h5>Sending as the shared mailbox</h5><p>In a new email, show the <strong>From</strong> field (under <strong>Options</strong>), choose <strong>Other email address</strong> and pick the shared mailbox. If you get an error saying you don\'t have permission, ask us - sending as a mailbox is a separate permission from reading it.</p>'
|
||||
. '<p>Need access to a shared mailbox you don\'t have? Open a ticket saying which one - we check with whoever looks after it first.</p>'),
|
||||
|
||||
$article('Outlook keeps asking for your password or won\'t sync', 'Quick fixes when Outlook prompts for a password over and over, or new email stops arriving.', 'Email and Calendar', ['Troubleshooting', 'Microsoft 365'],
|
||||
'<p>Try these in order, checking after each one.</p>'
|
||||
. $steps([
|
||||
'Check you can sign in at <a href="https://outlook.office.com">outlook.office.com</a>. If you can\'t, your password may have expired or your account may be locked - see <em>Changing or resetting your Microsoft 365 password</em>.',
|
||||
'If you changed your password recently, type the new one when Outlook asks.',
|
||||
'Close Outlook completely and open it again.',
|
||||
'Restart the computer.',
|
||||
'Check the bottom of the Outlook window - <strong>Working Offline</strong> means it isn\'t connecting. On the <strong>Send / Receive</strong> tab, turn <strong>Work Offline</strong> off.',
|
||||
'Check other websites load - if not, it is your internet connection, not Outlook.',
|
||||
])
|
||||
. '<p>If email works on the web but not in Outlook, tell us - your Outlook profile may need rebuilding, which we can do remotely.</p>'),
|
||||
|
||||
// Files and Sharing
|
||||
$article('Sending large files securely', 'Share files too big for email, or too sensitive for an attachment, with a OneDrive link.', 'Files and Sharing', ['How-To', 'Security', 'Microsoft 365'],
|
||||
'<p>Email attachments are limited in size and stay in inboxes forever. A sharing link from OneDrive is better for both: no size limit, and you can stop sharing at any time.</p>'
|
||||
. $steps([
|
||||
'Save the file to OneDrive (or find it in SharePoint or Teams).',
|
||||
'Right-click it and choose <strong>Share</strong>.',
|
||||
'Choose who the link works for - <strong>Specific people</strong> is safest - and type their email addresses.',
|
||||
'Untick <strong>Allow editing</strong> unless they need to change it, and set an expiry date for anything sensitive.',
|
||||
'Choose <strong>Send</strong>, or <strong>Copy link</strong> to paste it into your own email.',
|
||||
])
|
||||
. '<p>To stop sharing later, choose <strong>Manage access</strong> on the file and remove the link.</p>'
|
||||
. '<p>For bank details, ID documents or health information, check with us how your business has agreed to send them before you do.</p>'),
|
||||
|
||||
$article('Syncing SharePoint and Teams files to your computer', 'Work on shared files from File Explorer, the same as files on your computer.', 'Files and Sharing', ['How-To', 'Microsoft 365'],
|
||||
$steps([
|
||||
'In Teams, open the channel and its <strong>Files</strong> tab, and choose <strong>Open in SharePoint</strong> - or go to the SharePoint site directly.',
|
||||
'Choose <strong>Sync</strong> (or <strong>Add shortcut to My files</strong>, which works on every computer you sign in to).',
|
||||
'Allow the browser to open OneDrive if it asks.',
|
||||
'The library appears in File Explorer under your organization\'s name, or in your OneDrive.',
|
||||
])
|
||||
. '<h5>What the icons mean</h5>' . $list([
|
||||
'A cloud - the file is online only, and downloads when you open it',
|
||||
'A green tick - it is on this computer too',
|
||||
'Red with a cross - it didn\'t sync. Click the OneDrive cloud by the clock to see why',
|
||||
])
|
||||
. '<p>Two people editing the same Word, Excel or PowerPoint file at once is fine - open it from the shared library rather than a copy you emailed around.</p>'),
|
||||
|
||||
$article('Getting back a deleted or overwritten file', 'Restore a file from the recycle bin, or an earlier version of one, from OneDrive or SharePoint.', 'Files and Sharing', ['How-To', 'Self-Service', 'Microsoft 365'],
|
||||
'<h5>Deleted</h5>' . $steps([
|
||||
'Go to <a href="https://www.office.com">office.com</a>, open OneDrive (or the SharePoint site the file was in).',
|
||||
'Choose <strong>Recycle bin</strong>.',
|
||||
'Select the file and choose <strong>Restore</strong>.',
|
||||
])
|
||||
. '<p>Files stay in the recycle bin for 93 days.</p>'
|
||||
. '<h5>Saved over by mistake</h5>' . $steps([
|
||||
'Find the file in OneDrive or SharePoint on the web.',
|
||||
'Right-click it and choose <strong>Version history</strong>.',
|
||||
'Find the version from before the change and choose <strong>Restore</strong>.',
|
||||
])
|
||||
. '<p>Can\'t find it, or it was on a shared drive or a computer rather than OneDrive? Tell us the file\'s name, where it was and roughly when it was last right - we can restore it from backup.</p>'),
|
||||
|
||||
// Remote Work
|
||||
$article('Connecting to the VPN when you work away from the office', 'Reach the office\'s shared drives and systems securely from home or on the road.', 'Remote Work', ['How-To'],
|
||||
'<p>The VPN connects your work computer to the office network over the internet, securely. You need it for shared drives and systems that only run in the office - email, Teams and OneDrive work without it.</p>'
|
||||
. $steps([
|
||||
'Connect to the internet first - home Wi-Fi, or your phone\'s hotspot.',
|
||||
'Open the VPN app from the system tray by the clock, or from the Start menu.',
|
||||
'Choose <strong>Connect</strong> and sign in with your work account, approving it on your phone.',
|
||||
'When it says connected, open your shared drives as usual.',
|
||||
])
|
||||
. '<p>Disconnect when you have finished, especially on a hotel or other shared Wi-Fi.</p>'
|
||||
. '<h5>If it won\'t connect</h5>' . $list(['Check other websites load', 'Disconnect, wait a minute and connect again', 'Restart the computer', 'Tell us the exact error message - a screenshot is best'])
|
||||
. '<p><em>Your VPN\'s name, and anything different about it, go here.</em></p>'),
|
||||
|
||||
$article('Working securely from home or on the road', 'Simple habits that keep work data safe away from the office.', 'Remote Work', ['Security', 'Policy'],
|
||||
$list([
|
||||
'Lock your screen whenever you step away - press <strong>Windows + L</strong>, or <strong>Control + Command + Q</strong> on a Mac',
|
||||
'Use your work computer for work, and don\'t let family members use it',
|
||||
'Keep work files in OneDrive or SharePoint, not on the desktop or a USB stick',
|
||||
'On public or hotel Wi-Fi, connect to the VPN, or use your phone\'s hotspot instead',
|
||||
'Don\'t take calls about sensitive matters where others can hear, and watch who can see your screen',
|
||||
'Keep your home router updated and change its default password',
|
||||
'Print work documents only when you need to, and shred them afterwards',
|
||||
])
|
||||
. '<p>If a work device is lost or stolen, tell us straight away - see <em>Lost or stolen laptop or phone</em>.</p>'),
|
||||
|
||||
// Printing and Scanning
|
||||
$article('Adding a printer', 'Add an office printer to your computer, or add it again after it disappears.', 'Printing and Scanning', ['How-To'],
|
||||
'<p>On managed computers the office printers are added for you. If one is missing:</p>'
|
||||
. '<h5>Windows</h5>' . $steps([
|
||||
'Open <strong>Settings > Bluetooth & devices > Printers & scanners</strong>.',
|
||||
'Choose <strong>Add device</strong> and wait for the list.',
|
||||
'Choose the printer by its name - often written on a label on the printer - and <strong>Add device</strong>.',
|
||||
])
|
||||
. '<h5>Mac</h5><p>Open <strong>System Settings > Printers & Scanners</strong>, choose <strong>Add Printer, Scanner or Fax</strong>, pick it from the list and choose <strong>Add</strong>.</p>'
|
||||
. '<p>If it isn\'t listed, make sure you are on the office network (not guest Wi-Fi), then tell us the printer\'s name and where it is.</p>'),
|
||||
|
||||
$article('Printer not printing', 'Quick checks before you open a ticket about a printer.', 'Printing and Scanning', ['Troubleshooting', 'Quick Fix'],
|
||||
$steps([
|
||||
'Look at the printer\'s screen - paper jams, empty trays and low toner show there.',
|
||||
'Check you sent it to the right printer - the name is in the print window.',
|
||||
'Open the print queue - <strong>Settings > Printers & scanners</strong>, the printer, <strong>Open print queue</strong> - and cancel anything stuck at the top.',
|
||||
'Turn the printer off, wait 30 seconds and turn it on again.',
|
||||
'Restart your computer.',
|
||||
'Try printing from another computer - if that works, the problem is on yours.',
|
||||
])
|
||||
. '<p>Still not printing? Tell us the printer\'s name, what its screen says, and whether it is just you or everyone.</p>'),
|
||||
|
||||
$article('Scanning to email or a folder', 'Scan documents on the office copier straight to your inbox or a shared folder.', 'Printing and Scanning', ['How-To'],
|
||||
$steps([
|
||||
'Put the pages face up in the feeder on top, or face down on the glass.',
|
||||
'On the copier\'s screen, choose <strong>Scan</strong> (or <strong>Send</strong>).',
|
||||
'Choose <strong>Email</strong> and pick yourself from the address book - or choose the folder you scan to.',
|
||||
'Check the settings - PDF, color or black and white, one or both sides.',
|
||||
'Press <strong>Start</strong>.',
|
||||
])
|
||||
. '<p>The scan arrives in a minute or two. If it doesn\'t, check your junk email folder, then tell us the copier\'s name and the time you scanned.</p>'
|
||||
. '<p><em>Your copier\'s name, and where scans to a folder land, go here.</em></p>'),
|
||||
|
||||
// Phones and Meetings
|
||||
$article('Fixing sound and video in Teams meetings', 'What to check when people can\'t hear or see you in a Teams meeting, or you can\'t hear them.', 'Phones and Meetings', ['Troubleshooting', 'Microsoft 365'],
|
||||
'<h5>Before you join</h5><p>On the joining screen, check the camera preview and choose <strong>Device settings</strong> (the gear) to pick the right microphone, speaker and camera - a headset, not the laptop\'s own, if you use one.</p>'
|
||||
. '<h5>In the meeting</h5>' . $steps([
|
||||
'Check you aren\'t muted in Teams, and that your headset doesn\'t have its own mute switch on.',
|
||||
'Choose <strong>More > Settings > Device settings</strong> and check the microphone and speaker - make a test call from there.',
|
||||
'Unplug the headset and plug it in again, then pick it again in Device settings.',
|
||||
'Close other apps that might be using the camera or microphone.',
|
||||
'Leave the meeting and join again.',
|
||||
])
|
||||
. '<p>Choppy sound or frozen video is usually the connection - turn your camera off, move closer to the Wi-Fi, or plug in a network cable.</p>'),
|
||||
|
||||
$article('Setting up voicemail and forwarding on your desk phone', 'Record your voicemail greeting, check messages and forward calls when you are away from your desk.', 'Phones and Meetings', ['How-To', 'Self-Service'],
|
||||
'<h5>Voicemail</h5>' . $steps([
|
||||
'Press the <strong>Messages</strong> (envelope) button, or dial your voicemail number.',
|
||||
'Enter your PIN - the first time, use the one we gave you and choose a new one when asked.',
|
||||
'Follow the prompts to record your name and greeting.',
|
||||
])
|
||||
. '<h5>Forwarding</h5><p>Press <strong>Forward</strong> on the phone\'s screen, enter the number to forward to, and confirm. Press it again to turn it off. Some systems let you forward from the phone\'s web portal or app instead.</p>'
|
||||
. '<p>Forgotten your voicemail PIN, or want calls to ring your mobile too? Open a ticket - we can set both up.</p>'
|
||||
. '<p><em>Your phone system\'s voicemail number and the exact buttons go here.</em></p>'),
|
||||
|
||||
// Network and Wi-Fi
|
||||
$article('Connecting to the office or guest Wi-Fi', 'Which Wi-Fi to use for work devices, and for visitors and personal phones.', 'Network and Wi-Fi', ['How-To'],
|
||||
'<p>The office has two Wi-Fi networks, kept apart on purpose:</p>'
|
||||
. $list([
|
||||
'<strong>The staff network</strong> - for work computers and work phones. It reaches the printers and shared drives. Managed devices connect to it on their own.',
|
||||
'<strong>The guest network</strong> - for visitors and personal phones. It reaches the internet only.',
|
||||
])
|
||||
. '<p>Please don\'t connect personal devices to the staff network, or give its password to visitors. The guest network\'s password is posted at reception, and changes from time to time.</p>'
|
||||
. '<h5>Not connecting</h5>' . $list(['Turn Wi-Fi off and on again', 'Choose the network, <strong>Forget</strong> it, and connect again with the password', 'Restart the device', 'Try a spot nearer the access point - is it just you, or everyone in that area?'])
|
||||
. '<p><em>Your network names go here.</em></p>'),
|
||||
|
||||
$article('Slow or no internet - checks before you call', 'Work out whether it is your computer, the Wi-Fi or the office\'s connection.', 'Network and Wi-Fi', ['Troubleshooting', 'Quick Fix'],
|
||||
$steps([
|
||||
'Try a couple of different websites - is it everything, or one site? One site may be down for everyone.',
|
||||
'Ask a colleague - is it just you, or everyone? If everyone, tell us straight away.',
|
||||
'If it is just you, turn Wi-Fi off and on, or unplug and replug the network cable.',
|
||||
'Restart your computer.',
|
||||
'At home, restart your router: unplug it, wait 30 seconds and plug it back in. Give it a few minutes.',
|
||||
])
|
||||
. '<p>If the whole office is down, we usually know already from our monitoring - but call so we know it affects you. Working from home and only your connection is slow? That is your internet provider, but tell us if it stops you working and we will help.</p>'),
|
||||
|
||||
// Policies
|
||||
$article('New starters and leavers', 'What we need to know before someone joins or leaves, and how far ahead.', 'Policies', ['Policy', 'New Starter'],
|
||||
'<h5>Someone joining</h5><p>Let us know at least five working days before their first day - longer if they need a new computer, which can take a couple of weeks to arrive. Tell us:</p>'
|
||||
. $list([
|
||||
'Their name, job title and start date',
|
||||
'Who they report to, and which team they are in',
|
||||
'Who they will work like - we give them the same access, mailboxes and software',
|
||||
'Whether they need a computer, phone or desk phone, and where they will sit',
|
||||
])
|
||||
. '<h5>Someone leaving</h5><p>Tell us as soon as you know their last day, and straight away if they are leaving sooner than planned. Say:</p>'
|
||||
. $list([
|
||||
'Their last day, and when their access should stop - for an awkward exit, ask us to stop it at a set time',
|
||||
'Who should get their email and files, and for how long',
|
||||
'Which equipment is coming back, and when',
|
||||
])
|
||||
. '<p>Only the people allowed to ask for these changes should - we will check with you if a request comes from someone else.</p>'),
|
||||
|
||||
$article('Acceptable use of work computers and accounts', 'The ground rules for using company computers, email and accounts - a starting point for your own policy.', 'Policies', ['Policy'],
|
||||
'<p><em>A starting point: make it match your organization\'s own policy before publishing it.</em></p>'
|
||||
. $list([
|
||||
'Work computers, phones and accounts are for work. Reasonable personal use is fine, as long as it doesn\'t get in the way of work or break these rules.',
|
||||
'Your account is yours alone. Don\'t share your password, or let anyone else use your account or approve sign-ins for them.',
|
||||
'Only install software we have approved - ask us first.',
|
||||
'Keep work files in the company\'s systems, not on personal accounts, personal devices or USB sticks.',
|
||||
'Lock your screen when you step away.',
|
||||
'Report anything suspicious straight away - a strange email, a sign-in request you didn\'t start, a lost device. You won\'t be in trouble for reporting it.',
|
||||
'What you send and store on company systems isn\'t private, and may be monitored to keep them secure.',
|
||||
])),
|
||||
|
||||
];
|
||||
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user