wherever you see the rss (really simple syndication) logo (in...
TRANSCRIPT
Author: Edward Hardin Reference Number: AA-00602 Last Updated: 2011-11-28 15:02 0 Rating/ Voters
This is the first chapter of Knowledgebase Manager Pro User Guide. This chapter gives an overview of how KnowledgebaseManager Pro (KMP) works.
Articles
Articles are your knowledge base's main content portion. They contain the information that your users see. Whenever you wantto add new information to your knowledge base, create an article containing the information or update an existing article.
Each article has its own page in your knowledge base, which can hold text, images, video, animation and other kinds of data.Users can find articles in a variety of ways: from the knowledge base's front page, from a category page, or by searching.
In most implementations, a knowledge base article is similar to an encyclopedia entry. Ideally, it contains all the relevant,available information on a specific topic. However, you can modify the role of the article in KMP depending upon the purpose ofyour knowledge base. By allowing user comments and user-submitted questions, and setting up groups of users with differentprivileges, you can develop a knowledge base that also shares the characteristics of a community forum, blog, or news source.
You can restrict article availability. KMP allows you to make an article visible only to certain groups of users.
Categories
Categories group articles. Each of your knowledge base's articles must belong to at least one category. A list of categoriesdisplays on your knowledge base's front page. When a user clicks a category link, a page displays listing all the articles in thecategory.
As well as helping arrange your knowledge base's articles in a user-friendly way, you can also use categories to restrict article availability. KMP allows you to make a category visible and editable only by certain groups of users.
Users
Users are the people who view your knowledge base, provide feedback, and make administrative decisions and changes.
The degree to which users can make changes to your knowledge base depends on their access privileges. At one end of thescale, a user may be able to read only certain articles and make no changes, whereas at the other end of the scale thesuperuser ("admin") can change everything about the knowledge base. Somewhere in between, a trusted user may be able toread, comment on, write and edit articles - but nothing else.
Groups
User groups define the access privileges of the users that belong to them. You can configure the types of action that membersof each group can take, as well as the article categories that they can view and edit.
Custom Templates
"Templates" is a collective term for a large number of objects that control every aspect of your knowledge base's appearance and functionality.
Your knowledge base's templates are completely configurable. You can create a custom template by copying one of the basicthemes included with KMP, then edit the code (HTML and CSS) of each template as required.
Feedback
Feedback allows your knowledge base's users to interact with the knowledge base, article authors, and one another. Users canprovide feedback via comments (short pieces of text, added to the relevant article page), ratings (votes on whether or not anarticle was helpful and notes for article improvement), ask questions (get suggestions while typing a question, send it to KMP,and forward to specified users and emails).
Subscriptions
1. General overview
Wherever you see the RSS (Really Simple Syndication) logo (in your knowledge base, users can click the logo to subscribe toan RSS feed for the relevant section.
Also, user can subscribe to an article or category and get notified by email about updates (new articles, updated articles, ornew comments - by his choice).
Next chapter: Interface Overview >>
Author: Edward Hardin Reference Number: AA-00605 Last Updated: 2011-08-30 16:33 0 Rating/ Voters
This chapter explains KMP's Graphical User Interface (GUI). The GUI lets you control every aspect of KMP.
There are two user interfaces in KMP:
Back-end (we also call it "Control Panel" or "Admin Area"). It is for Staff users. It allows doing every single thing: create, edit, andview content, manage user accounts, work with customer feedback, customize look of the front-end part, and administrate theknowledge base. Back-end always requires login.
Front-end is designed as a public website and is intended for use by anonymous and Client users, for example your customers orother website visitors. You can restrict access to the front-end, and require login, for example if you want to allow access forregistered clients and your staff only (i.e. deny any public access to the knowledge base). Staff users can create, edit, and deletecontent from the front-end as well as from the back-end.
We will discuss the details of back-end user interface right now, and later return to the front-end.
The Toolbar
The Main Menu
The Workspace
The Footer
Tooltips
Data Grids
Entries
Sorting Columns
Group Actions
Toolbar with Buttons
Instant Search
Filter
Navigating
Grid Preferences
Reload Grid
Required Fields
Confirmation Notices
The Home Screen
The GUI is divided up into four parts.
2. Interface overview
The Toolbar
The toolbar displays on every screen.
Use the toolbar to perform tasks related to your account preferences and your profile details.
View yourKB
Opens the public area - front-end interface of the knowledge base.
Logout Logs you off from KMP
My Account Allows change your user profile options: name, password, email,language and time settings, etc.
Preferences Contains your personal preferences related to GUI behavior andappearance.
TurboEnables local storage of certain application files (images,JavaScript and CSS) avoiding the need to redownloadthem from the web onevery application reload. In order to use it you'll need to have GoogleGears installed on yourPC.
Help Opens general help for KMP that also includes the link to thisknowledge base.
The Main Menu
The main menu displays on every screen.
Use the main menu to go to screens where you can create, configure and manage your knowledge base.
Home Shows bits of the knowledge base articles, feedback entries, newitems creation buttons, etc. on a single screen.
ArticlesIncludes main tools for authoring: creation of articles, categories,article templates, glossary, management ofarticle drafts and emailsubscriptions.
FeedbackTools for user feedback are here. You can approve, decline, andanswer comments here, work with userquestions, check rating trends and reactto negative feedback here. Also list of censored words for usercomments canbe edited here.
Statistics Contains statistical information for articles and categories usage,search reports, and author activity charts.
Users &Groups
User management tools live here. You can create a new user or a group,approve registered user and assignhim to a group here.
Customization Tools for customization of front-end look and feel, custom article fields,user profile fields, and custom ratings.
Administration Administrative tools that mostly related to preferences for the wholeknowledge base.
The following notation will be used in this manual and other articles in the knowledge base:
Go to Articles > Articles & Categories
This means that you need to click on the Articles in the main menu and then click on the Articles & Categories item:
Also additional step can be mentioned in this notation, which points to a tab on the destination page:
Go to Customization > Styling and Front-end Settings > Access
This means "Click on the Customization in the main menu, then click on the Styling and Front-end Settings..."
"...then click on the Access tab on the new screen".
The Workspace
The contents that display in the workspace depend on the screen you are currently viewing. Usually you can go to another screenby clicking on a main menu item. Also dialog windows open over the workspace.
The Footer
Footer shows information about:
your version of KMP
link to Support Center
link to Bug Report/Feature Request form
Tooltips
Many objects in the GUI have context help icons next to them (?). Place your mouse pointer over the tooltip
or (if you mouse pointer changes to "hand") click on it to see more relevant information.
Other objects have text links next to them. Click these links to see an article from our knowledge base on the subject.
Data Grids
Data grids are used to present lists of entries with ability to create, view, and manage them.
Entries
Each entry represents an entity like article, glossary, term, comment, etc. depending on what screen you're on. Often entry has acheckbox that you can check to apply a group action on selected entries then. It shows the entity properties in one or severalcolumns, e.g.: title, creation date, id, etc. Also it has several action buttons that you can click to view, edit, delete, etc. the entity.
Sorting Columns
You can sort entries by almost any column. To do that, click the column header. First click sorts them in ascending order, secondclick sorts in descending order.
Group Actions
You can select several entries by clicking their checkboxes and do a group action on them. Most common group action is "delete",in some cases you can edit or copy several entries at once.
Toolbar with Buttons
Toolbars usually contain several buttons for creation of relevant entries – articles, comments, users, etc.
Instant Search
Instant search allows searching "here and now" within the items shown in current grid. For example you may select a category onthe left panel (on Articles > Articles & Categories screen) and articles assigned to this category will be shown in the grid. You canuse instant search now to search through these articles. It searches through the articles content as well as through the titles.
Path to the current category is marked with green color on the screenshot. We are searching in this category. Note that the"Search in Subcategories" checkbox is checked.
"Search Applied" marked with yellow color shows that we're watching a search results in the grid, instead of the all entries of thecurrent category.
Magenta area shows relevance - measure of how entry is pertinent to the search phrase.
Filter
Filters can be used to select items from current grid that match certain conditions. For example you can filter out featured articlesthat have from 1 to 5 attachments.
Filtering parameter is marked in green on the screenshot.
"Filter Applied" marked with yellow color shows that we're watching a search results in the grid, instead of the all entries of thecurrent category.
Magenta area shows column with number of attachments per article.
You can combine search and filters - you can filter out search results, or search in filtered items.
Navigating
Not all entries may be displayed on one grid page. You can go between pages with help of navigating tool.
<< Prev Click this to move backward one page in the list.
Next >> Click this to move forward one page in the list.
6-10 of 21 Select a range of entries to go to the respective page in the list.
You can change the number of entries shown on a page. To do this - just drag the bottom grid border.
Select Articles > Add an Article in the main menu.
Go to Article > Articles & Categories page and click "Add New Article" on the grid toolbar.
When you do this, the article creation window opens.
The main screen of the article creation window is comprehensible and intuitive. To finish creation of the article you need to giveit a title and assign it to a category.
Grid Preferences
Click the first of the three buttons under the grid to open grid preferences window.
Grid preferences window allows you to change the set of shown columns, appearance of action and group action buttons, number ofentries per page, and some other settings (settings can be different for each grid).
Note: You can reset the look of action and group action buttons in all grids at once. This can be done in the Preferences menu.
Reload Grid
KMP makes an Ajax request in the back-end when you click a button, select a menu item, etc. Ajax allows reloading a part of theweb page, instead of reloading the whole page and losing time on loading the same unchanged data again and again such as footer,header, and other parts of layout. For example when you click on a main menu item and go to a different screen, only workspace(middle part) is reloaded – the main menu and the toolbar are not.
Reload grid button works in a similar way – you can click this button to reload grid entries without refreshing of the web page.
Use this button where you see it to refresh current container (e.g. grid) contents. Refrain from using the Refresh button on yourbrowser toolbar (or F5/Ctrl-F5 shortcuts) unless you've got an error or just updated KMP to a new version. In these cases Ctrl-F5would help to avoid future errors and get the latest versions of scripts and styles.
Required Fields
When you configure one of KMP's features, you may be required to enter information, or select an option. These mandatory fieldsare necessary to set up the feature. If you try to save your changes without configuring a required field, a warning displays.
Fields marked with a red asterisk (*) are mandatory, whereas others are optional.
Confirmation Notices
When you have performed an action that modifies KMP's configuration, a notice displays when the screen reloads, confirming thatyour modification was completed successfully.
Or not successfully
If it has been unsuccessful, press Ctrl-F5 to reload KMP and try again. If you'll get the error again, please follow this guide to enableerror logs and report the problem to our support team.
The Home Screen
The home screen or the dashboard is shown when you log in the very first time or click the Home item in the main menu.
Add New Shortcuts for creation of an article, category, user, etc.
Summary & Popular Articles,Popular Categories, PopularSearches
General statistics for articles, categories, and searches.
Dashboard (Recently addedentries)
Your articles (sorted by last change date), article drafts, user questions, comments pendingmoderation, approved comments. Some of the listed tabs may not be shown if related option isdisabled in general options.
System Info Info about KMP version, license, etc.
Updates Shown remainder of Support & Maintenance subscription and availability of updates.
NewsShows new posts from Web-Site-Scripts blog. Often includes information about new releases,announces, best practices, etc.
Next chapter: Articles Overview >>
Author: Edward Hardin Reference Number: AA-00608 Last Updated: 2011-02-01 18:05 0 Rating/ Voters
This chapter gives a general overview of articles, the main content portion in KMP.
Article Format
Importing Articles
Article Status
Custom Fields
Glossary
Articles are the foundation of your knowledge base. In essence, your knowledge base is a database of articles, bound togetherby a framework that presents them to the user.
When you want to present information to your users, you should create an article. While the term "article" suggests a traditionalnewspaper or magazine format, the articles you create for your knowledge base can take whatever form you like. Use images,audio, video and flash animations to customize your articles.
Article Format
KMP articles use HTML (Hyper-Text Markup Language). This means that you can create articles in exactly the same way thatyou would create a web page.
Don't worry if you don't know HTML; KMP's powerful built-in WYSIWYG (What You See Is What You Get) HTML editor allowsyou to create and configure your articles using an interface similar to a standard word processor. You can also create HTMLcode elsewhere (in a web development tool such as Adobe Dreamweaver, for example) and paste it directly into the editor'swhen it is in the source mode.
Importing Articles
If you want to create large numbers of articles at once in KMP, you can do so by importing a CSV (Comma Separated Values)or XLS file containing the articles' details. A CSV file is a basic text file containing a variety of fields, each separated by acomma. Many applications (such as databases and spreadsheets) can output CSV files; see your source application'sdocumentation for details. You can map the fields created by your source application to KMP's fields.
Learn more about importing articles from CSV and XLS.
Article Status
KMP supports administrative user groups with a variety of user privileges. For example, you can create user groups whosemembers may only edit articles, or who may only see certain article categories, or any combination of privileges.
This is very useful if you have a distributed network of content creators or editors, and want to compartmentalize each person'sresponsibilities and privileges. For example, you can also create groups whose users may write articles, but not publish them,and another user group whose users may publish articles (i.e. they can approve articles).
In order to manage this workflow, each article has a status.
An article is Published if it was created or approved by a user who may write and publish articles. The article is visibleto the public.
An article is Not Published if it was created by a user who may write, but not publish articles. The article is not visible tothe public.
Also an article can get Expired. This happens if it was set by a user that this article must be hidden at certain date andtime and we are observing the article after this moment have passed. The article is not visible to the public.
Learn more about simple workflow mechanism.
Custom Fields
Depending upon the nature of your knowledge base, you may wish to add certain types of information to your articles that are
3. Articles overview
common to multiple articles. For example, if you are creating a knowledge base containing details of cars, you might want toadd information about manufacturer, model, engine size, years of production, and so on.
You can do this using KMP's custom fields. Custom fields allow an article creator to enter text or select choices from a listwhen editing an article.
The information then displays as part of the article's page in your knowledge base, arranged in the "Custom Fields" section.
Once you have created custom fields, each article you subsequently create or edit offers you the opportunity to include thecustom fields. Either enter the information (type text or select values from a list), or leave the custom field blank to not includethe custom field in your article (unless it is required – in this case you would need to fill it before saving the article).
Glossary
KMP's glossary is a dictionary that you define. It is designed to help your knowledge base's users quickly learn technical jargonor other non?standard terms.
When you create a glossary entry for a word or phrase, the word or phrase is highlighted any time it appears in your knowledgebase articles' body text. When a user places the mouse pointer over the term the definition displays.
Because you define the terms that are highlighted and the text that displays, you can also use the glossary feature for any kindof function where you want additional text to display without breaking the flow of the article.
Users can also view the glossary by clicking the "Glossary" link in your knowledge base's header bar. By default, the glossarypage opens showing all glossary entries. The user can also select a letter (or numerals) to see all glossary entries beginningwith the letter (or a numeral).
Glossary term and definition is always a plain-text with no formatting except line breaks. No html tags permitted as well.
We will learn how to add content to the knowledge base in the next chapter.
Author: Edward Hardin Reference Number: AA-00625 Last Updated: 2012-06-12 14:38 0 Rating/ Voters
This chapter describes basics of article and category creation, and drafts usage.
Creating a Category
Creating an Article
Using Drafts
You must have at least one category in the knowledge base to create an article because article may exist only if it is assignedto a category. If you're starting with an empty knowledge base, you need to create a category first. Otherwise you can skip thenext step and create an article right now.
Creating a Category
There are several ways create a new category. The easiest way is this:
Go to Article > Articles & Categories page and click "Add Category" on the left pane toolbar.
Give it a name and hit Enter or click on the green Apply button.
Note that the category will be created as a child to the currently selected category. You can select a category by single clickingon it - selected category has blue background.
It is the fastest way to create a category, because you are not asked for anything else except category name. Use this methodin future if you need to quickly create several categories.
We got our first category created; now we can add an article to the knowledge base.
Creating an Article
There are several equivalent ways to start creating a new article. You can:
Click the "Article" button on the "Add New" pane on the back-end home page.
4. Adding content
Take a look the buttons toolbar. There are several buttons on it.
Save &Close
Saves the article and closes the article create/edit window.
Save Just saves the article without closing the window
SaveDraft
Saves changes as your personal draft. Article itself is not changed. Your draft cannot be viewed by anyone else.You can continue to edit this draft later and save it as an article or delete eventually.
CopyTo
Copies the article to the category by your choice.
Print Shows printable version of the article and asks you to send it for printing.
Exportto PDF
Exports the article to PDF.
Preview Shows preview of the article with the latest (even unsaved) changes in the front-end.
Also notice the Make Featured button below.
Click it to make your article "featured". Next click will remove this status. Use it to promote articles and show them on the topof various lists in the front-end: featured article is shown on the top of the articles list when you're viewing a category contentsand in the category tree. Featured status overrides articles sorting.
Also there is Featured Articles list on the main front-end page, which shows the most popular featured articles. Use it for themost valued articles like "Beginner's Guide" or top news.
Article body with WYSIWYG toolbar is shown below. You can type there, copy-paste text from a text editor or web page, anduse WYSIWYG buttons to change text look and feel, alignment, colors, insert images, links, tables, and videos, and also edithtml source.
The article creation window has several tabs that allow you do change advanced settings, custom field values, versions, etc.We will talk about them later during discussion of article edit function.
Using Drafts
It was mentioned previously that there is Save Draft button on the tool bar or article create/edit window. It saves current articletitle, body, attached documents, and all preferences to drafts. Also, if you haven't saved your article and try to close the articleedit window, it will ask you what must be done with your changes and you can save them to a draft.
Exit Without Saving - discard changes and keep the latest saved article version.
Save Article - save changes to the article.
Save Draft - save changes as your personal draft.
Cancel - cancel article closing attempt and return to article editing.
Click "Save Draft". Then go to Articles > My Drafts. You will see your draft in the list. You can see on the next screenshot thatthere are two types of drafts: draft of a new article, and draft of an existing article.
They have different icons here, if you hover your mouse over an icon, you will see the hint that explains the draft type:
Draft of an existing article - either saved manually or by autosave (you can have only one draft per article, if yousave this draft, the old draft gets rewritten)
Draft of a new article - (you can have as many drafts of new articles as you want)
You can continue editing a draft from here by clicking "Resume". You will also be advised about existing drafts when you willtry to create an article or edit an article for which you have a draft version saved.
There are several options:
View difference - compare the draft with the current article (this option won't be shown if you're creating a new article)
View - open a window where you can view the draft contents (this option won't be shown if you're editing an existingarticle).
Resume - load the draft to the current article edit window, so you can continue to edit it.
Dismiss this message - hide this info message (only this time).
If you're creating a new article, and there are several drafts available, you will see a slightly different message.
View my drafts - go to Articles > My Drafts (closes the current article edit window).
Dismiss this message - hide this info message (only this time).
Also draft of the article you're currently editing is being saved automatically at certain intervals (by default it is 30 seconds, butthis can be changed by administrator at Administration > General Settings > General).
We will learn how to edit articles and change advanced article properties in the next chapter.
Author: Edward Hardin Reference Number: AA-00631 Last Updated: 2011-08-03 13:03 0 Rating/ Voters
This chapter explains article properties in details. These properties are grouped by tabs of the article edition window. Thesetabs are listed below:
General - this tab has been already discussed in the previous chapter.
Custom Fields
Advanced
Attachments
Related
Auto Related
Comments
Negative Article Ratings
History
Almost all properties described here can be changed when you're creating an article as well as when you're editing an existingarticle.
Custom Fields
If there are no article custom fields in the knowledge base, this tab would be hidden. For example, when you start with anempty knowledge base it doesn't show up.
Later we will discuss how to create, fill, and search custom fields.
The Advanced Options Page
On the "Advanced" tab you can change some special article preferences.
Author Allows you to select the article author
Created Allows to set the article creation date
5. Editing articles and their properties
LastUpdated
If this checkbox is checked, the article "last updated" time and date will be rewritten with current time and datewhen you save the article.
If the checkbox is unchecked, date and time won't be changed.
RatingAllows changing article rating. KMP collects rating trends for each article, if you change the rating manually,trend for the article will be reset.
Views You can change the number of hits (visits) here.
LastUpdated by
It shows the last user who updated this article.
Published
This option defines if the article is visible to the public (i.e. to anonymous users and Client users). AccessRestrictions option below is also considered when KMP checks if article should be seen by a user.
Published article icon:
Unpublished article icon:
Simple workflow system is based on this article status. Learn more.
PublicationDate
Date and time when you want article go online. If set to a moment in the future - article will not be visible to thepublic, and will be published on the specified moment. If set to a moment in the past (default behavior), it isconsidered as already published.
Expires
If enabled, article will expire on the specified date and time. Expired status is virtually the same as "notpublished". It just had a different icon and shows the expiration date when you hover its icon in the back-end.
ExpirationDate
Date and time when article should expire.
MetaKeywords
Meta keywords are used by third-party search engines like Google, Bing, and Yahoo for better indexing of yourknowledgebase. They are also included to the KMP search index.
MetaDescription
Meta description is used by third-party search engines like Google, Bing, and Yahoo for better indexing of yourknowledgebase. It is also included to the KMP search index.
AccessRestrictions
This option defines who can view and edit the article.
If it is set to Public:
The article is visible to all Staff users.
The article is visible to all Clients and anonymous users if flag "Published" is set above on this page.
It is editable by users from the Staff groups that have edit access to parent category. i.e. if parentcategory is Public, this article is editable by every Staff user. If parent category is Restricted to certaingroups, only these Staff groups can edit the article.
If it is set to Restricted:
Visible and editable only to users from the Staff groups specified within the adjacent combobox.
Visible only to users from the Client groups specified in the adjacent combobox.
Attachments
KMP allows you to upload files, for example DOC or PDF documents, archives. File that you upload must be attached to anarticle - it may not exist as a separate entity. File attached to an article can be downloaded by anyone who can view thearticle.
You can attach files in traditional way by clicking the browse/upload button and selecting a file on your computer (the option #3on the next screenshot), or upload them with drag and drop. You can learn more about file upload methods and watch the videotutorial here.
All popular file types are detected and it shows the relevant type icon for each file.
By default attachment name is the same as file name, though you can change it by clicking "Edit" and providing a new name.
Note that it doesn't change the file name itself. When you download the attached file, its name would be the same as it waswhen you uploaded the file.
If you want to update an attachment, just upload a new version and delete the old attachment. If you would like to track itsversions, you can do this by renaming the entry. For example rename "My Document" to "My Document v1.0", and when youupload a new version of this document, rename it to "My Document v1.1".
KMP creates a search index for documents that you attach and you can search these documents in the same way as yousearch articles. Many popular document formats are supported:
MS Office 2003 Word Documents: .doc, .dot
MS Office 2003 Excel Workbooks: .xls, .xlt
MS Office 2003 PowerPoint Presentations: .ppt, .pot
MS Office 2007 Word Documents: .docx, .docm, .dotx, .dotm
MS Office 2007 Excel Workbooks: .xlsx, .xlsm, .xltx, .xltm
MS Office 2007 PowerPoint Presentations: .pptx, .pptm, .potx, .potm
MS Office 2007 Visio Drawing: .vdx
Adobe PDF Documents: .pdf
RTF Documents: .rtf
TXT Documents: .txt, .htm, .html, .shtml, .shtm, .txt, .php, .asp, .cfm, .cfml, .pl, .cgi, .aspx, .jsp – we can extend thislist with any text based formats
Images: .jpg, .jpeg, .tiff, .tif (not images it selves, but meta data)
Related and Auto Related
You can add a list of related articles to each article. These relations are single-directional – if you add article A as related to B,it doesn't mean that article B is related to article A.
You can add related articles by clicking "Add New" and using the article picker.
Alternatively you can start typing something from the article name or its code to the "Add Related Article" field, and you'll see alist of suggested articles. Click on an article from the list to add it.
If an article has been deleted, it disappears from all Related Articles lists. If it has been renamed, it is also renamed in the Related Articles lists.
KMP can create relations between articles automatically. KMP Administrator can learn more about how auto related articleroutine works and how to enable it.
Comments
This tab shows comments posted to the article. Here you can create, delete, and reply to comments.
Negative Article Ratings
This tab shows negative rating messages for this article. When someone rates an article and chooses a rather negative rating,he is asked to reason it or provide a suggestion of how to improve the article. These messages are shown here.
History
You can view an article's previous versions, and roll back the article to a previous version if required. Each time a KMP staffuser saves the article, a new version is created.
When you roll back an article to a previous version its title and body are rolled back. Such properties as assigned category,custom fields, properties shown on the advanced tab, attachments, etc. are not rolled back.
Click "Compare" to see the comparison window of previous and current versions.
Click "Roll Back" to restore a previous version of the article.
In the next chapter we will learn how to work with categories .
Author: Edward Hardin Reference Number: AA-00669 Last Updated: 2011-08-30 18:51 0 Rating/ Voters
This chapter explains how to work with categories: view them, select, edit their properties, arrange them and reorder.
Basics
Moving and Reordering Categories
Changing Category Properties
Deleting Categories
The Toolbar
Basics
To start working with categories go to Articles > Articles & Categories. This is the most convenient place in KMP to work withcategories.
Here you can see the categories tree on the left.
It works similarly to the folder tree on your PC.
When you click on a category, the list of articles on the right reloads and shows all articles assigned to the selected category.Please note that only certain number of articles is shown per page, so use paging control if you want to browse all articles.
If a category has sub-categories, you can see the [+] marker against it. Click on the marker to expand the category.
To rename a category simply double-click on it.
6. Working with categories
Once you've finished typing a new name, press Enter.
Moving and Reordering Categories
You can arrange categories in any custom order. This can be done simply by dragging-n-dropping categories.
The icon next to your cursor will help you to find out what will happen to the category you're dragging after you drop it.
In this case the Reference category will be placed after the FAQ and before the Manual categories:
This screenshot shows that it will be added at the end of the list of subcategories of the Web Calendar Pro category.
In this case the category won't be moved.
Changing Category Properties
When a category is selected or when you hover your mouse pointer over a category you can see two buttons next to it.
The first button allows to edit category and its properties. Click on it.
You will see the Edit Category window.
You can change the following category properties here.
Name The displayed category name.
Parent Parent category. Changing this property is an alternative way to relocate the category.
MetaKeywords
Meta keywords are used by third-party search engines like Google, Bing, and Yahoo for better indexing ofyour knowledgebase. They are also included to the KMP search index.
MetaDescription
Meta description is used by third-party search engines like Google, Bing, and Yahoo for better indexing ofyour knowledgebase. It is also included to the KMP search index.
AccessRestrictions
This option has several meanings:It defines default access restrictions for new articles created in this category. I.e. when you create anarticle and assign it to this category, the article permissions are copied from the category permissions.It doesn't mean that the category overwrites permissions in any way - you can change the articlepermissions at any time and they can be different than permissions of the parent category.
It there are no articles with public access in this category, you can hide this category from public aswell by changing its access restrictions to "Restricted".
You can use this option to apply new access restrictions to articles and categories under this category.If access restrictions have been changed, after you press Save&Close a confirmation window will beshown with options to apply new restrictions to subcategories, child articles, and child articles withinsubcategories.
If it is set to Public:
This category is visible to all Staff and Client users. It doesn't affect child articles and categoriesvisibility.
This category is editable by all Staff users. Though some of the child articles (or all of them) may havedifferent permissions, so if you can edit this category, it doesn't mean that you can edit any article inthis category.
If it is set to Restricted:
This category is visible to the groups specified in the adjacent combo box (if it doesn't contain anyarticles visible to a given user). However, if a user can see an article under this category, he would beable to see the category as well.
This category is editable by Staff users specified in the adjacent combo box. Though some of the child
articles (or all of them) may have different permissions, so if you can edit this category, it doesn't meanthat you can edit any article in this category.
All articles in this category that have "Public" access restrictions are editable by Staff groups specifiedin the adjacent combo box. This is the only effect that category permissions have on child articlespermissions.
Deleting Categories
To delete a category click on the Delete button. You'll see a deletion confirmation before category and all its subcategories willbe deleted forever.
Articles that have been assigned only to the category (or categories) that you're deleting, will be moved to the Recycle Bin.Articles that have been assigned to other categories as well will be simply unassigned from the deleted category (or categories).
The Toolbar
There are several buttons on the Categories panel toolbar.
Add Category Quick creation of a new category - a new category named "Default Title" is created on click and allyou would need to do is give it a proper name and hit Enter.
Edit Categories
If one category is selected (clicked or marked with a checkbox) it opens the Edit Category window.If two or more categories are marked with checkboxes, it opens a group categories editwindow which allows to change permissions for a set of categories at once (and their child articlesand subcategories as well).
DeleteCategories
Delete all selected categories.
Expand/Collapse Expand/Collapse all category tree nodes.
Enable/DisableInline Edit andDrag'n'Drop
By default inline renaming and drag'n'drop of categories are allowed. This button toggles thesefunctions ON or OFF.
View Articlesfrom SelectedCategories
Usually you click on a category to see the list of its articles. You can also mark multiple categorieswith checkboxes and click this button to see all articles from selected categories.
Author: Edward Hardin Reference Number: AA-00671 Last Updated: 2011-08-30 20:12 0 Rating/ Voters
This chapter explains how to work with custom fields: create them, change their properties, and fill them out when youencounter them in your articles.
Custom fields are user-defined variables that can be assigned to articles. Custom fields provide additional level of organizationand filtration of articles in your corporate knowledge base. They allow greater customizability of types of data collected with theknowledge base entry.
Creating Custom Fields
Custom Fields Types
Custom Field Properties
Filling Custom Fields
Suggestions
Creating Custom Fields
To create a custom field go to Customization > Article Custom Fields first.
The Add Custom Field button opens the wizard that helps you to create and configure a custom field.
On the first step you should select the custom field type.
Click on a desired custom field type to proceed.
Custom Field Types
The table below shows the list of available custom fields with examples. While viewing these examples, please note thatcustom fields could have different names, number of options, and each option may have different value and format.
Customfield name
Description Example (in the article editor) What you caninput
Text Field(<255characters)
A basic single line text boxcustom field to allow simpletext input.
Any text.
Free Text
A multiline text area customfield to allow input of longer Any text (with
7. Working with custom fields
Free TextField(unlimitedtext)
field to allow input of longertext strings. This can be aplain text field, or a text fieldwith WYSIWYG editor whichcan hold rich formatted text,images, etc.
Any text (withformatting andimages ifWYSIWYGmode is enabled)
Multi Select Choose multiple values in aselect list.
Multiple options.
MultiCheckboxes
Choose multiple values usingcheckboxes.
Multiple options.
RadioButtons
A list of radio buttons.
Single option.
Select List A single selection list.
Single option.
ComboboxField
Single select from values incombobox.
Single option.
NumberField
A custom field that stores andvalidates numeric (floatingpoint) input.
Any number ofthe specifiedformat.
Email Field A custom field that validatesemail.
Any email.
URL LinkField
Allow links to other sites beadded to an article.
Any URL
Date Picker A custom field that storesdates and uses a date pickerto edit them.
Any date
Date andTime Picker
A custom field that stores andvalidates both date and timevalues.
Any date andtime (hours andminutes).
After you picked a desired custom field type, it shows the properties page.
Custom Field Properties
Custom fields may have different set of properties depending on their type.
Properties that apply to custom fields of ALL types
Title Custom field title. It is shown in both front-end and back-end.
HintHint is shown in article edit mode to explain what exactly must be written to the custom field. It is notshown to the front-end users.
RequiredIf this option is enabled, the custom field required to fill. It is impossible to save an article withoutfilling the required custom field.
Internal Use OnlyIf enabled, the custom field restricted for internal use only. Field will be available to staff membersonly.
Searchable in theback-end
This option makes the field searchable in the back-end.
Searchable in thefront-end
This option makes the field searchable in the front-end.
Show if emptyShow field in the front-end even if it is empty. By default empty custom field are not shown in thefront-end.
Some fields have additional properties
Properties that apply to custom fields of SOME types Applicable to:
SizeNumber of rows shown when the customfield is searched in the front-end.
Free Text Field (unlimited text), Multi Select, Multi Checkboxes,Radio Buttons, Select List, Combobox Field
UseWYSIWYG
Use WYSIWYG with this custom field. Free Text Field (unlimited text)
OptionsSeparator
Separator between multiple custom fieldvalues. It is used in view mode.
Multi Select, Multi Checkboxes
FormatFormat that will be used for this customfield.
Number Field
DateFormat
Date format that will be used for thiscustom field.
Date Picker, Date and Time Picker
TimeFormat
Time format that will be used for thiscustom field.
Date and Time Picker
Options The list of selectable options for selection-type custom fields.
Multi Select, Multi Checkboxes, Radio Buttons, Select List,Combobox Field
All these options can be setup when you create a custom field or later on.
Filling Custom Fields
When you edit an article you can fill the custom fields. To start doing this, just click on the "Custom Fields" tab of the EditArticle window.
You will see all available custom fields. You can edit them and save the article.
Suggestions
If you delete a custom field (at Customization > Article Custom Fields page), it destroys the custom field and all valuesassociated with this custom field per each article. There is no way to undo this! Be careful.
Author: Edward Hardin Reference Number: AA-00674 Last Updated: 2012-01-18 17:30 0 Rating/ Voters
Front-end has been primarily designed as a public website for end-users, such as your customers and call-center operators. Bydefault anyone can view unrestricted articles at the front-end without login. Staff users may want to use the front-end part fromtime to time, it is convenient to read articles and make amendments at the front-end.
Front-end layouts and styles can be thoroughly customized, for example to match your website design. Checkthe customization guide, it gives an introduction to the templates system in KMP and helps anyone who has at least basicknowledge of CSS and HTML to make changes to the front-end look. You can also check the Live Examples page at ourwebsite which has a collection of links to some of our customer's knowledge bases - there are some nice examples of front-endcustomization there.
Due to high customizability of the front-end its controls may vary for different themes, but since it is highly intuitive you willeasily find the button to edit an article or add a new glossary term.
If you are logged in to KMP as a Staff user, you can see more buttons and menu items than a regular visitor of the knowledgebase.
These buttons allow you to create and edit content right from the front-end.
Check these front-end How-To's. It is a collection of most popular questions regarding the front-end settings.
Change language, date & time format and time zone
Change the front-end pages title
Do not post comments automatically
Change search type and other search settings
Restrict access to the knowledge base
Change a label or text
Change color, size of an element, positions of KB parts, etc
Disable front-end completely
How To's
Change language, date & time format and time zone
Go to Customization > Styling and Front-end Settings page from the main menu.
You will see the options for language, date & time format, and time zone.
Please note that these settings apply only to users who are not logged in to KMP. When you are logged in your personalaccount settings override the front-end settings.
Change the front-end pages title
8. Front-end overview & settings
By default, front-end title reads "KnowledgeBase Manager Pro", but you can change it easily.
Go to Customization > Styling and Front-end Settings page from the main menu. Click on the "Home" tab.
You can change the title here and click "Save" to apply the change.
Do not post comments automatically
Go to Customization > Styling and Front-end Settings page from the main menu.
Go to the Article tab, and set checkbox against Moderation Required.
This option enables comments pre-moderation. Comments will not be shown immediately after posting, instead every commentwill require Staff approval before publishing.
If you enable the Autoapprove Staff Comments, this rule will not be applied to Staff users. All comments posted by Staff willbe published immediately.
Click Save to apply new settings.
Change search type and other search settings
Go to Customization > Styling and Front-end Settings page from the main menu.
Go to the Search tab.
Here you can select the Search Type. Natural Language Full-Text Search and Boolean Full-Text Search are recommended.Keyword Search is primarily used in multi-byte languages such as Japanese or Chinese.
The screenshot above shows default search settings that are recommended for most cases.
Click Save to apply new settings.
Please note that the search settings for the back-end located on a different page: Administration > General Settings > Search.
Restrict access to the knowledge base
Go to Customization > Styling and Front-end Settings page from the main menu.
Go to the Access tab, and set Access Mode to Authorization Required.
After you've done this nobody can access your knowledge base without entering username and password.
Click Save to apply new settings.
Change a label or text
Every bit of text: labels, button names, help messages, email templates, etc. can be changed in language profile.
There is one exception tough:
To change the "Rate It" text or option names for the article rating tool, you would need to create a custom rating form.
Change color, size of an element, positions of KB parts, etc
This can be done by changing styles and templates of your custom front-end theme.
Disable front-end completely
Go to Customization > Styling and Front-end Settings page from the main menu.
click the "Front-end Enabled" button
Now, if anyone goes to a front-end page he will see the message that Front-end in under maintenance mode currently.
To enabled Front-end, just click this button once again.
Author: Edward Hardin Reference Number: AA-00704 Last Updated: 2012-08-21 19:32 0 Rating/ Voters
KMP helps you to stay updated about the most recent changes in the knowledge base. You can subscribe by email or RSS to be notified about the latestcomments, new articles, and article updates. You can subscribe to a selected article or to all articles within a category at once. Any visitor of aknowledge base can subscribe himself to one category or article at a time. Staff user can subscribe a user to multiple (or even all) categories at once. Itis also possible to send user questions to groups of users, separate users, or any custom email address.
Cron Job required
Please note that email subscriptions to new comments, new articles, and article updates require working Cron Job. Check if Cron Job is set up andrunning.
Email Subscriptions
Questions
By Category to: New Articles, Updated Articles, New Comments
Subscribe yourself to a category (one at a time)
Subscribe a user to a category via the admin area (multiple categories)
By Article: Article Updates and Comments
Subscribe yourself to an article (one at a time)
Subscribe a user to an article via the admin area
RSS Subscriptions
Email Subscriptions
Questions
You can tell KMP to forward user questions submitted via Ask a Question form. To do that:
Go to the Customization > Styling and Front-end Settings page.
Click on the Ask a Question tab.
Chose user groups, separate users, or specify an email (or multiple emails separated by commas) in the "Send Questions by Email to" field and click"Save".
By Category to: New Articles, Updated Articles, New Comments
By subscribing to a category user will get an email when an article has been created or updated in this category, or a comment has been posted to one ofthe articles that belong to the category.
Subscribe yourself to a category (one at a time)
Anyone can subscribe himself to a category from the front-end. This is how the subscription button looks in the Theme1 and custom themes based on it:
Theme2:
9. Subscriptions
...and Theme3:
After you click on that button a window will appear with the subscription options.
Input your email here, select subscription options and click "Subscribe".
Subscribe a user to a category via the admin area (multiple categories)
If you are a Staff user, you can subscribe someone to one or multiple categories.
Go to Articles > Subscribers > Category Subscribers page.
Click Add Subscriber.
Click "Select" to select a category or multiple categories you wish to subscribe the user to, or even all categories by selecting the "All" checkbox.
Enter user's email.
Select the subscription options:
Add - for notifications about new articles
Edit - for notifications about updated articles
Comments - to be notified about new comments
Click Save & Close.
By Article: Article Updates and Comments
By subscribing to an article user will get an email when the article has been updated in this category or a comment has been posted to it.
Subscribe yourself to an article (one at a time)
Anyone can subscribe himself to a category from the front-end. This is how the subscription button looks in the Theme1 and custom themes based on it:
Theme2:
...and Theme3:
After you click on of that buttons, a window will appear where you can input your email and click "Subscribe" to subscribe yourself.
Subscribe a user to an article via the admin area
If you are a Staff user, you can subscribe someone to an article updates or comments.
Go to Articles > Subscribers > Article Subscribers page.
Click Add Subscriber.
Select an article you wish to subscribe the user to.
Enter user's email.
Select the subscription options.
Articles - if enabled, the user will be notified about the article updates.
Comments - if enabled, the user will be notified about new comments posted to this article.
RSS Subscriptions
RSS (Rich Site Summary) is a format for delivering regularly changing web content. By subscribing to an RSS feed using an RSS reader (a program thatcollects RSS feeds for you and displays them in a readable format) you can get notifications about changing content. In KMP you can subscribe to newand updated articles, and to comments by RSS.
If you look at a KMP front-end page you'll notice several RSS buttons.
They allow you to subscribe to various types of articles. For example the leftmost and right most RSS buttons provide subscription to all articles - you'llbe notified about each new article. Three buttons in the middle provide feeds for featured, most popular, and articles with the highest rating.
You can subscribe only to publicly available articles via RSS.
Author: Edward Hardin Reference Number: AA-00715 Last Updated: 2012-04-19 14:05 0 Rating/ Voters
Article templates are reusable part of content. You can use them for quick insertion into your articles. They can be rather big orsmall. They can include formatted text, images, videos, html code. Actually, anything that you can add to an article, you canalso add to a template. With the help of snippets you can quickly add a signature, custom formatting block, logo, notice,warning, recurring paragraph, general article layout, etc. to your articles.
Using Templates
There are some templates included to the KMP package. You can use them in your articles or delete them if you wish.
To insert a template to your article, click the next to the last button on the WYSIWYG toolbar when you're editing or creating anarticle:
You'll see a list of available templates arranged in several folders:
To insert a template, simply click on it. It will be inserted exactly to the current position of the keyboard cursor.
Creating Templates
To manage your templates, go to Articles > Article Templates page in the admin area. There you will see the list of templates onthe right and their categories on the left.
a. Article Templates
You can manage article templates similarly to how you manage articles. You can create a template by clicking on "Add NewArticle Template" button on the toolbar. You can arrange them by categories. You can also edit them in pretty much the sameway as you edit articles: