About KnowSystem: Knowledge Base System
KnowSystem is a universal knowledge management tool that might be configured to any business goal and any set of Odoo apps: for helpdesk, marketing, IT, HR, project management, so on and so on. Typical use cases are:
Helpdesk - once faced a challenge, its solution might be recorded in KnowSystem for repeated usage by co-workers and for self-service by clients
Sales and CRM - salesperson helper to find information about products, offers, frequently asked customer questions
Project management - to keep and easily retrieve knowledge of existing solutions, tools, hints, and experiments
HR - to prepare instructions, guidelines, learning tours and training, and any codified knowledge of routine in your company
Marketing - to organize Odoo online library of product use cases, expert knowledge, and well-structured documentation
Legal issues - systematize your policies, contract and approval managements, keep the full classifier of trademarks, licenses Informational technologies - share easy-reached manuals and configuration guidelines.
The app provides:
Single view KMS navigation
Reference of articles in messages
Applied in any functional area
Documentation builder, Website and portal, Custom fields, and multilanguage support
Concepts and terms
Here you can find all terms and add-ons icons that were used through all documentation.
Article - a piece of text, that contains some sort of knowledge, has a title and preview text.
Article template - a ready sample of an article, that you can edit to create a new one preserving formatting.
Article revision - a version of an article, kept in history and can be restored.
KnowSystem section - articles' storage, that provides an opportunity to give access to user groups for all contained articles. Supports hierarchy and therefore can have a parent section and subsections.
KnowSystem tag - is a mark on an article, that helps to navigate and give access to articles to particular portal users.
Learning tour - a set of articles united by a common topic, with the learning purpose.
Documentation category - a combination of documentation sections, that are similar in a way, for a structured layout.
Documentation section - a set of articles, referring to the same topic and giving a full perspective of it.
Documentation version - a product version, that documentation describes.
Mass action - an action that can be applied to several articles at once.
Article type () - an organizing KMS instrument.
Article custom field - an extra field, that you can add to an article, that may contain different types of information of your choice.
Article attachment - a document that is assigned to an article.
Backend editor - an editing wizard, that supports simple templates and basic editing options to make it possible to update an email or a message body with an article's text.
Website editor - an editing wizard, with various advanced templates, perfect for displaying on a website.
Code editor - an HTML wizard, for advanced users, that prefer to write code.
Internal user - employee.
Portal user - partner.
Public user - website visitor.
Single View Interface & Article interaction for internal users - the functional interface that internal users see, from which you can add and edit sections, tags, types (), tours, and apply mass actions to one or several articles at once.
KMS (Knowledge Base System) navigation for portal/public users () - the interface on a website, that portal and public users see, can look differently for different portal users based on the articles, sections, tags, types that they have access to.
Documentation categories & documentation navigation for all users () - the documentation interface, that you see on a website, can look differently for various users. If a person doesn't have rights for one or several articles of the documentation you can choose: not show this article, show a warning that there is an article that you don't have the access to or neglect access rights, and show the article anyway.
Features introduced by add-ons are marked with these signs.
KnowSystem: Website and Portal
The module lets you publish articles on the website, share them with portal users, and use the website builder to update articles.
Odoo Documentation Builder
The module lets you design website documentation pages based on knowledge base articles.
KnowSystem: Custom Fields
The module lets you add and show custom fields for articles (backend).
KnowSystem: Custom Fields for Website and Portal
The module shows custom fields on website and portal pages (frontend). Free, but requires KnowSystem: Custom Fields.
KnowSystem: Multi Languaged
The module lets you translate articles, sections, and tags to installed in Odoo languages.
Single-view knowledge navigation
Managing KnowSystem sections
KnowSystem section is a supreme KMS object, an articles' storage, which is used for convenient navigation over articles and managing access to internal user groups. Each article should have a single linked section. Sections serve to fulfill the following tasks:
1. To unite articles (you can add only one section to an article)
2. To restrict rights to articles (see. Access rights)
3. To navigate through articles and find them quickly, by putting a tick for the required section
Sections have a hierarchy. You can set a parent section and some subsections while editing or creating a section. You can also change the hierarchy by Drag&Drop. If a user group has access to the parent section, it would have access to all included sections (see. Access rights). It is also possible to print all available articles by a section (see KnowSystem in use).
You can create and edit sections right from the single view interface and from the separate menu Configuration > Sections.
To add a new section through the single-view interface just click '...add new section' and write the title. Click on a section with the right side of the mouse to see all available actions:
1. Create (click to start creating a new section)
2. Rename (click to change section's name)
3. Edit (click to edit a section)
4. Print (click to print all articles in a section and its subsections if any)
5. Archive (click to archive a section, its articles will remain active)
How to edit sections:
1. In the KnowSystem menu click on a section with the right side of the mouse, then choose 'Edit', or go to Configurations > Sections, choose the section and click 'Edit'.
2. Set the hierarchy by choosing the parent and sub-sections
3. Click the tab 'Restrict access' to set the groups of people that will be able to see the section and articles in it. Access to the parent section allows reading all articles in it and in its' sub-sections (see. Access rights)
4. Add the description to the section
5. Click 'Save'.
Article types is an organizing instrument introduced by an optional add-on KnowSystem: Custom fields (). Types serve to fulfill the following tasks:
1. To show properties only for suitable types. Thus set of attributes for 'user guidelines' and 'technical specifications' might be different (see. KnowSystem: Custom fields)
2. To organize articles and navigate through articles (an article may have only one type)
Types also support hierarchy. You can set parent types and subtypes while editing or creating a section or by Drag&Drop.
Create and edit types right from the single view interface or from the separate menu in Configuration > Types.
To add a type through the single-view interface just click '...add new type' and write the title or click on a type with the right side of the mouse to see all available actions:
1. Create (click to start creating a new type)
2. Rename (click to change type's name)
3. Edit (click to edit a type)
4. Archive (click to archive a type, its articles will remain active)
To edit types:
1. In the KnowSystem menu click on a type with the right side of the mouse, then choose 'Edit', or go to Configurations > Article types, choose the section and click 'Edit'.
2. Write the title
3. Choose a parent type
4. If you remove the tick from the box 'Active', then the type will be archived
5. If you want the type to be visible on your site, tick the box 'Visible on the current website' ()
6. If you have several sites, you can choose one to show the type, or leave the field 'Website' () empty to show on all sites
7. Click 'Save'.
Organizing a tour is a good way to combine all articles that a person needs in order to reach something. For example, you can organize a tour for newcomers, so they could learn all the nuances of working in your company. Learning tours allow you to:
1. Combine articles in a particular order with the possibility to move through them with the help of extra buttons '<Back' and '>Forward'
2. Restrict access to tours to particular user groups
3. Track users' progress and invite particular users to complete a tour
4. Add a description page before articles
You can manage learning tours in two interfaces: in the single view interface and in the separate menu Configuration > Tours.
Creating a tour
How to add a learning tour:
1. Start creating a tour through a single view interface by clicking on '...add a new tour', or by going to Configuration > Tours and clicking 'Create'
2. In the single-view interface choose all the articles that you need by ticking the box in the top right corner of an article. In the left navigation panel choose the mass actions 'Add to tour'
3. Choose an existing tour and click 'Save&Close'
4. Click 'Add a line' to add some more articles to your tour. Choose an article and click 'Save&New' to add one more, or 'Save&Close' if you have already added the ones you need
5. Click on the tab 'Restrict access' to choose groups of users that will have the access to the tour, if you leave the field empty, all internal users would see the tour. If you choose one group, then only this group will be able to start the tour
6. Click on the tab 'Description' to add some words about the tour. The page with this description would be the first one your users see as they open the tour
7. Click 'Save&Close' and you will be automatically redirected to the tour page, where you can see all the articles that you added
8. Click 'Edit'
9. Drag&drop to change the sequence of the articles, press bin on the right side of an article to delete it from this tour
It is also possible to click '...add new tour' in the left navigation panel of the interface and add articles to the tour manually one by one.
You can always edit your tours, either by clicking on it with the right side of the mouse, or by going to Configuration > Tours.
In the editing mode you can also see the user's progress, just click on the tab 'Users Progress'. Here you can also invite separate users to complete the tour by clicking 'Add a line' and choosing a user.
Completing a tour
To begin a tour. Open the KnowSystem single view interface, find tours in the left navigation panel of it, and click on a required one.
If a user doesn't have access rights to one or several articles in the tour, then he or she will not see those articles in the tour. Thus the same tour may look differently for different users.
To start a learning tour:
1. Open a tour from the KnowSystem app
2. Click 'Start a tour'
3. Move through the articles. When you return to the previous article you do not lose your progress. You can close a tour and continue it again later. Then, you will start from the same place, where you stopped
4. At the end of a tour, you see a congratulation alert 'Good job! The tour is over.'
How to create an article
There are two user groups that can create an article. Those are KnowSystem Admin and KnowSystem Editor.
To create an article:
1. Open the KnowSystem app
2. Click 'Create'
3. Introduce title and preview text
4. Optionally add the published title ( the title, that will be visible on the website)
5. Add tags, section, type (), and choose the website to show the article on ( the article will not be visible on the site until you publish it. If you leave the field empty, then the article will be seen on all your websites after publishing)
6. Attach files, if you want
7. Now you can fill the body of the article in the Backend builder, use building blocks, change styles
8. Click 'Save'
An article may have two titles, an article's title and a published title. If an article has a published title, then it will be used in:
1. Pdf's name. If you download a single article, which has a published title, the title will be used as the file's name.
2. Article name in pdfs. If an article has a published title, then it will be used in generated pdfs instead of the article's title.
3. Article title on portal / website (). If an article has a published title, then this title will be shown on portal/website both in the list of articles, and as you open a particular article instead of the article's title.
4. Article header in documentation navigation + content ().
If an article has a published title, then it will be used as the article's headers and in the navigation list instead of the article's title. The article's title is the title, which is used in backend. If an article doesn't have a published title, then the article's title will be used in all the cases.
You can also create an article from a template, to avoid losing time on adjusting blocks and styles (see Creating an article from a template).
There are three ways to edit an article. You can do that in the Backend builder, Website builder (), and HTML editor. It is up to you which one to choose, according to your needs and preferences.
The default one
- Basic styles
- Safe for printing and email referencing
- Looks less attractive on the site
- Easy to use
Open the article and click 'Edit on Website'
- Advanced styles
- May display incorrectly when added to emails
- Perfect for site
- Easy to use
Click </> to switch between backend builder and HTML code. Or fully replace backend builder ()
- Any simple and advanced HTML styles
- Can add article's text to emails, when only simple styles are used
- Difficult to use
Backend builder is an editor that you see when you create or edit an article internally. It provides you with a set of simple and safe for backend blocks, which are compatible with printing and messaging layouts. There are three types of blocks: text blocks, special blocks, and image blocks. Each block has a grey intro box, where you see how it looks like.
The available text blocks are:
1. Title + text
3. Title + Subtitle
5. Two columns
6. Three columns
The available special blocks are:
The available picture blocks are:
1. Two columns
2. Three columns
3. Image + Text
4. Text + Image
Drag and drop building blocks to update an article's body. As you save the article the styles change to the ones that are safe for reading in backend, printing, and adding to messages.
In the backend builder, you can choose text styles, make text bold, italic, underlined, change font size, remove font style, add ordered and unordered lists, add checklists, align paragraphs, add tables, links, pictures, switch to the code view, and undo and redo actions. Here you can also switch to raw code view to update articles HTML at any moment, by clicking on the </> sing in the backend builder.
To make sure the sub-titles look good while printing, avoid using the style 'Header 1' in the article's body.
Website builder is introduced by an optional KnowSystem add-on KnowSystem: Website and Portal (). It allows you to apply advanced styles and complex widgets by using Odoo built-in website editor to make website-friendly articles. Numerous snippets, animations, style templates, and options will help you to prepare nice-looking portal knowledge pages. Avoid using that for internal or printing purposes: advanced styles often contradict printing and composer layouts.
How to edit an article in the website builder:
1. Open the article you want to edit
2. Click the button 'Edit on Website'
3. Add blocks, choose various styles, write an article
4. Click 'Save'
You can also start creating an article, write title, text, add tags, section, type (), and choose the website to show the article on, click 'Save', and fill the article's body in the website builder, the same way as in 'How to create an article'. If you entered the published title in the backend builder, then, as you open the article through the website builder – you will see the published title. Even if the article is not published.
The backend builder and website builder have different purposes. Choose the backend builder, if you want to create articles for internal use, that you will be able to print and refer to when sending an email or a message. Choose the website builder, if you want to publish your articles on a website, share, or give access to some partners. In the website builder, the choice of blocks and styles is wider. You can also animate icons and some boxes to catch the reader's attention. It is possible to change the font's color and its' background color.
The set of available blocks depends on the modules and themes installed in your Odoo system. For writing articles available all the same blocks as when you create a website. For example: Title, Text, Numbers, Picture, Text - Image, Image - Text, Columns, Accordion, Alert, etc.
There are a lot of tools to make your articles stand out by customizing building blocks. Try various styles, fonts, and fonts' colors.
If you primarily use website builder to edit articles, you might be interested to replace backend builder with HTML editor permanently. For that go to Configuration > Configuration, find the section 'KnowSystem options', and put a tick to the box 'Turn off Backend Editor' (see. Code editor).
You can turn off website builder in settings and publish articles made in backend builder instead. In this case, articles will be less colorful, but you will preserve the opportunity to print them and add them to an email's body.
To turn off the website builder, go to Configuration > Configuration, section KnowSystem Options, and remove the tick from 'Edit on Website'. After that articles would be available on your website in read-only mode only.
Code editor allows you to apply any simple and advanced HTML styles but requires certain technical knowledge. Articles that are written with the help of simple HTML might be compatible with printing and messaging layouts. Switch to raw code from backend builder from time to time or replace it fully with the code editor, if you have the add-on KnowSystem: Website and Portal installed ().
You can switch to raw code view to update articles HTML at any moment, by clicking on the </> sign in the backend builder.
Optionally replace the backend editor with XML editor to rely fully on the website builder () and edit only raw code in the backed. Introduce any HTML tags and styles, including bootstrap-ready elements and even iframes.
Creating an article from a template
Creating an article from a template is a fast and convenient way to create new articles while keeping uniform styles. You can prepare new knowledge templates or save any existing article as a template.
You can use any article as a template and use it for further articles. For that, open any article, in the head menu of it find the 'Actions' button, choose 'Make template', write the reference, change it the way you want, and click 'Save'.
You can also create a template in the configuration menu. To create a template, open the KnowSystem app, go to Configuration > Templates, click 'Create', write a reference title, fill the main body and click 'Save'.
Use backend articles' templates only for articles in backend to make sure styles are displayed correctly.
To create an article from a template:
1. Open the KnowSystem app
2. Click 'Create from template'
3. Choose a template
4. Click 'Create'
5. After that, the body of an article will be filled with the values of a template
6. Continue creating an article (see How to create an article)
Interaction with an article
As you open an article, you see the header with available actions above the title. To change something in the article, click 'Edit' or 'Edit on Website' (). Here as in the KnowSystem menu, you can create a new article from scratch and from a template.
As you click on the 'Discuss' button, you would see the article's message thread. Any internal user that has the access to the article can take part in discussing it. Here you can see, the notifications stating that the article was revised and other people's comments. Click 'Send message' to open the message typing field, add smiles, attach files or open the message wizard to change text style.
You can also add a Log note or schedule an activity connected with an article, e.g. to revise it. All followers might receive notifications about revisions of an article (see Article revision and history of changes). Click 'Follow' to become a follower of the article, or unfollow, if it is not relevant. You can add followers and channels, by clicking on a 'Person' icon, and selecting the recipients of the invitation.
As you click on the 'Revisions' button, you would see the list of editions with information about the date and the person who changed the article. You can click the button 'Observe' by any revision in the list, to see how the article used to look. If you like some variant more or the article was spoiled, you can click 'Restore this revision' and confirm your choice in the pop-up window to back up an article. Keep in mind, that this action will be written as a new revision and you still will be able to return to any previous state of the article (see Article revision and history of changes).
As you click on the 'Info' button, you see all the available information about the article, including:
1. The list of contributors that took part in creating and revising the article
2. The time of publishing and last revision
3. Article's statistics, such as views and the number of times the article was referred in emails and was viewed by each person
4. Documentation sections (), where the article is used
5. People who liked, disliked, or added the article to favorites
6. At the bottom of the page, you can also see the links, that lead to the article. If the box 'Published' () is ticked, then you see two links: Website URL and Internal link
7. Share button ()
You can share the link to the article with any user neglecting the access rights (). For that click on the 'Share' button at the bottom of the info page. The link with a special token would be generated. Copy the link and send it to a user. Anyone with the link will be able to see the article even if it is not published ().
Click on the 'Star' sign, to add the article to favorites, put a like or dislike to the article. You can always change your mind and put a like instead of dislike or vice versa. The chosen icon will be grey, to change the answer click on the one that is green. Click 'Save as PDF' to start the instant download of the article. Click 'Actions' to: restrict access, (un)publish the article (), make a template, add it to a tour, duplicate, archive, or delete the article.
KnowSystem import and export
If you already have articles in some KMS system you can add them to KnowSystem. Use the 'Import' tool above the articles view to import an electronic table with such articles. Take into account: the body of an article should be pure HTML.
To import your articles to KnowSystem:
1. Click 'Favourites' at the top of the page, above articles list
2. Choose 'Import records'
3. Click 'Load file' and choose a file with articles
4. Choose the columns for import
5. Click 'Import'
6. Upon finishing you will see a message stating that a certain number of records is imported
If you create articles in KnowSystem and want to move to some other app or just to have an extra file with articles for extra security, use the mass actions button 'Export'. It would generate a table which might be also used for import. You can choose various fields for export, and save files in .xlsx or .csv format.
To export articles:
1. Choose the articles for export, by ticking the box in the article's right top corner or click 'Select all found'
2. Click 'Export' in the right navigation panel mass actions
3. Choose article's fields for export (by default there are: article title, article, preview summary, section, tags)
4. Tick the box 'I want to update data' if you want the file to be import-compatible
Article revisions and history of changes
The history of article revisions is kept in Odoo in a similar way it's done in Wikipedia. If one of the users breaks something, it takes 2 clicks to recover a proper knowledge version. A revision is created when an article or an important detail (title, content, section, tags, attachments) is changed. Not significant modifications do not lead to creating a new revision. Revisions help to restore only important details.
As you click on the Revisions button you see a pop-up window with all the revisions of the article. You can find out who and when changed something in an article. There are 5 columns, where changes are stated - in contents you see how many signs were added, if they are green or deleted if they are red and with a minus; the other columns show previous state, for example, the previous title, or a deleted tag.
To restore a revision of an article:
1. Open an article
2. Click 'Revisions'
3. You see all the revisions of this article
4. Click observe to see any of those
5. Click 'Restore this revision'
After restoring, you can always return back to the previous variant of an article, as a new revision is created.
Only KnowSystem Admin can restore and delete revisions.
You can translate your articles into various languages(). Then you will see the sign of the language, for example, 'EN', in the title and preview text of an article while editing. Click on the icon to manually translate it. Odoo users, who have a different platform language will see the manual translation of the title and the preview text. You can edit the article in your default language and the changes will be applied only to the article in this language. The same article in other languages will remain the same. Revisions of the same article in different languages are kept in one list, but it is impossible to restore an article to one of the versions of the article in another language.
There is a separate menu, where you can see and manage all revisions. For that, go to Configuration > Revisions. There you can see the list of revisions, group them (for example by an article), search, restore a revision and delete the ones you don't need.
To restore a revision, just open it, click the button 'Restore the revision' and confirm your decision.
To delete one or several revisions, you need to select them by ticking the box on the left side, then click on the gear icon 'Action' and choose the option 'Delete'. After that, the deleted revisions will be deleted permanently.
For security purposes, in order to access the menu 'Revisions', a user should be a 'KnowSystem Administrator'.
KnowSystem in use
Observe article content right from any Odoo object: there is no need to always switch to the KnowSystem advanced interface. All articles are available in a pop-up window with convenient navigation. Click on the KnowSystem icon above a document form or in the systray to access the articles. Send KnowSystem articles in messages by updating a message body or attaching a pdf file. Print all articles in a tag or section.
Set tags for the KnowSystem quick access. You can choose 'Apply to all documents' in the tag's settings if you want to be able to reach articles with this tag throughout the KnowSystem icon in the forms of other documents from anywhere in the Odoo. Or you can add filters to tags, to find suitable articles very fast. The articles will be accessible only if the document matches any of the set to the tag filters. Add filters to tags, to show particular articles only when they match ALL or ANY of them.
Documents by tags
Link knowledge tags to Odoo document types in order to simplify the search of articles. You can either choose to apply a tag to all available documents or choose a particular model and add filters.
As you apply a tag to all documents, the tag will be added by default to all quick search forms regardless of the interface and document type the user is working with. To apply a tag to all documents:
1. Start editing or creating a tag
2. Find the tab 'Applied to' and tick the box 'Apply to all documents'
3. Click 'Save'
As you apply a tag to one or several documents' modules, the tag will be added by default to the quick search forms according to the document type the user is working with. To apply a tag only to a particular document's models:
1. Start editing or creating a tag
2. Find the tab 'Applied to' and click 'Add a line'
3. In the pop-up window choose a model and click 'Save&New' to add one more, otherwise 'Save&Close'
4. Click 'Save'
You can also add filters to each chosen model. So, the order of the articles with this tag will also depend on particular documents' objects. For example, assign helpdesk tickets to the tag 'odoo/helpdesk': the latter would be entered by default for support requests objects.
How to add some filters to a document's model:
1. Start creating or editing a tag
2. Find the tab 'Applied to'
3. Click 'Add a line'
4. Choose a model
5. Click 'Add filter'
6. Choose filter options, by scrolling or typing the beginning in the search field and choose the filter options
7. Click on '+' on the right side of the rule you wrote to add one more filter, otherwise click 'Save&Close'
8. If you have more than one rule you can choose ANY or ALL button above, so only documents that match ANY of the rules or ALL rules will be shown
10. Click on '...' button, on the right side near '+' to add an even more complex rule
11. Here you can also choose to filter documents that match ALL or ANY rules
12. If you choose ALL or ANY both times, your rules will stand in one line and only one button will remain
Push the button 'Records' to see Odoo documents that match the rule terms.
Here are some examples of useful simple filters:
Total > = 1000 (Will show articles with this tag, if the order total is more than 1000 to understand how to work with such orders)
Currency = Euro (Will show articles with this tag, if a sale's order currency is Euro)
Product type = Storable product (Will show articles with this tag, if a product is storable to show articles about this kind of products and what to do with them)
Country > Country name = United States (Will show articles with this tag, if the contact's card states that he is from United States to keep articles and company policy about working with US companies)
Billing Status = Waiting Bills (Will show articles with this tag, if there are some pending bills)
Is Won = Won (Will show articles with this tag, if the opened opportunity has a status won)
Quick search from any interface
You can easily access KnowSystem from anywhere in Odoo. Quickly observe articles related to a current document discussion. Instantly reference one or a few ones. To add the quick entry for Knowledge base from any Odoo form view, go to Configuration > Configuration, find KnowSystem options, put a tick in the box 'Articles by Documents' and click 'Save'.
To see the KnowSystem icon () in the Odoo systray near activities and messages, go to Configuration > Configuration, find KnowSystem options, and put a tick in the box 'KnowSystem in systray' and click 'Save'.
As you click on the KnowSystem icon in the systray or above the document form you see a pop-up window with articles. Search articles by tags, section, or content in a few clicks for a quick overview. Click on an article to read it.
As you see your documents in the tree view and want to open quick access to KnowSystem, which will show you only filtered to chosen objects articles, click on the KnowSystem article icon that is located above the view. If you click on the KnowSystem icon in systray, it would show all tags that are applied to the particular model regardless of the chosen records.
Knowledge for messaging
To let users reference/cite Knowledge records in Odoo messages, go to configurations, turn on the option 'Articles in Email Composers'. After that, you will see the KnowSystem button (KNOWSYSTEM) as you click 'Send message' and open the full composer.
In the pop-up window, you can search articles by tags, sections, and contents. Here tags are always applied to the particular object, from which you compose a message.
Click on an article to read it, click 'Close' to return to the message composer. Click '+' at the right top corner of an article to choose an article. Open the tab 'Chosen articles' to remove some articles or to read them. There are three types of citing an article. You can:
1. Update the message body with knowledge content (it is added to the end of a current message)
2. Attach a PDF version of the referenced article
3. Share a public knowledge link with your colleagues or partners (the link is added as a clickable title of an article)
In order for the articles to be parsed correctly, it is necessary to use only backend styles. Some too complicated styles may be displayed incorrectly.
Knowledge for printing
In KnowSystem you can print one article or several articles at once. To print a single article just open an article and click 'Save as PDF'.
To print articles from the single view interface:
1. Choose one or several articles by putting a tick in the box in the top right corner of an article
2. In the right navigation panel, mass actions choose 'Save as PDF', the downloading will start automatically
3. You can also 'Select all found' articles and print them all at once in the same way.
It is also possible to print all articles of a specific tag or of a definite section. To print all articles in a tag or a section click on it with the right side of the mouse and choose 'Print'. If a tag or a section has subtags or subsections, the articles from there will also be printed.
Attach your articles to emails and messages as pdf, so the recipient will be able to print them.
For the correct mass print use Backend builder styles and avoid using Headline 1 in the body of an article.
You can allow portal and public users to print published articles (). For that go to Configuration > Configuration, fund section 'Portal and Website Views' and tick 'Print in Portal' (). After that as a user opens an article there will be the printer icon near the article's title, that will redirect straight to the printing wizard.
The styles for printing are applied from settings as for other Odoo printings. To configure styles, go to General Settings > Business Documents > Documents Layout. There you can change the paper format of the documents, add your company's logo, tagline, footer, choose font and colors.
Optionally, you can turn on the option to print articles without titles for the best printing layout. For example, it is useful, to avoid the situations, when the article's title is printed on one page and the body of the article on the other one. For that go to Configuration > Configuration, find section 'KnowSystem Options' and tick 'Print without titles'. After that only articles' content will be printed.
KnowSystem access rights
Access to articles is managed in a different way for different types of users. There are 3 types of users:
1. Odoo user or internal user
2. Portal user or registered user ()
3. Public user ()
By default, all articles are available to any internal user, if you don't restrict access only to particular user groups. You can restrict access either to particular sections, including subsections or to particular articles.
On the website (), public users see only published articles. Portal users can also see the articles they have access to. To give access to a particular user add this user or several users to the field 'Allowed partners' as you edit a tag and add this tag to articles that you want to allow the user to see.
Rights to administrate the Odoo knowledge management system belong to 2 user roles: KnowSystem Editor and KnowSystem Administrator. If you want a user to be able to create articles, he or she should belong to one of those groups.
Sections, tags, and types access for internal users
Different users may see different sets of navigation menu: sections, tags, and types ().
KnowSystem considers user groups that are defined per section. If the user groups are not defined, a section is considered 'global' and each internal user may read articles in it.
To grant access to a section for the whole user group:
1. Start creating or editing a section
2. Open the tab 'Restrict access'
3. Choose user groups that will see all articles in this section and its' sub-sections
Rights for a knowledge section are defined not only according to this section but also according to all its parents. For example, if a user can't access 'Sales', he/she would not be able to access 'Sales / CRM disregarding whether 'CRM' is available for his/her user group.
Internal users can see sections, even those that are empty if they have access to them.
Tags and types () are visible for all internal users disregarding their settings.
Internal access for articles
In KnowSystem articles' access for internal users is defined on 2 levels: per section and per article. In order to be able to read an article, a user should have both: access to an article and its' section.
To manage user groups for an article:
1. Open or start creating an article
2. Click 'Actions' in the right corner above the article's form and choose 'Restrict access'
3. Choose user groups that will see the article
If the user groups are not defined, an article is considered 'global' and each internal user may read it (if he/she has an access to its section).
Odoo user always may access an article if he/she is an author of that article disregarding further restrictions.
Access to edit articles
Rights to administrate Odoo knowledge management system belong to 2 user roles: KnowSystem Editor and KnowSystem Administrator. If you want a user to be able to create articles, he or she should belong to one of those groups. If an internal user has access to see an article and belongs to one of the stated groups, then he can also edit it.
All article versions are stored in revision, so there is always a way to return to one of the previous ones. Only KnowSystem Admin can restore and delete revisions (see. Article revision and history of changes). Thus, it helps to make the editing process more secure.
Public users access
Public users () - website visitors - may access KMS interfaces only if you explicitly allowed that. Thus, you can switch off the option 'Public KnowSystem' () to fully disable knowledge base for such users.
Public users () would see only those KMS objects, which are published and available for a website they are visiting.
Only sections that contain available for this user articles would be shown (thus, there would not be a filter by a section which would result in an empty list of articles).
An article would be available for a public user if its section and itself are published.
To publish () an article:
1. Chose one or several articles and choose 'Publish' in mass actions in the right navigation panel of the interface
2. Open an article, click 'Actions' in the functional line above the article title, and choose 'Publish'
You can share the link to an article with any user neglecting the access rights (). For that click on the 'Share' button at the bottom of the info page. The link with a special token will be generated. Copy the link and send it to a user. Anyone with the link will be able to see the article even if it is not published.
To make a tag visible on a website ():
1. Start creating or editing a tag
2. Tick the box 'Show Tag on Website'
3. If you leave the field 'Website' empty, then the tag will be seen on all available websites
To make a type () visible on a website ():
1. Start creating or editing article type
2. Tick the box 'Visible on current website'
3. If you leave the field 'Website' empty, then this type would be seen on all available websites
Portal users access
Portal users () have the same access rights as public users (), but you can also grant extra rights for particular partners. To that goal knowledge tags are used. You can assign those tags in two ways:
1. Start creating or editing a tag, choose a particular contacts in the field 'Allowed partners, and click 'Save'
2. Open contacts, find a particular user, start editing the profile card, in the field 'KnowSystem' tags choose the tag, click 'Save'
Thus, a portal user would have access to all published articles (see above) and all articles which have partner-related tags.
For example, create tag 'premium', 'standard', 'free' to manage knowledge base tariffs and assign the tags to corresponding articles. Or create a tag with a country to assign it to all articles available to the partners from it.
User rights comparison
Can read, create, edit, delete any articles, sections, tags, article types (), tours. May configure Misc options.
Can read, create, edit, archive related to him/her articles, sections, and any tags. Can also delete related to him/her tours. Can read any article type ().
Can read related to his/her user groups articles, sections, and tours. Can read any tags and article types (). May like/dislike, add to favorites, take part in discussions.
Portal user ()
Can read published and partner-related-by-tags articles, and related to those sections. Can also read published tags and article types (). May like/dislike articles.
Public user ()
Can read published articles, sections, tags, and article types ().
KnowSystem has a configuration page, where you can turn on and off some add-ons features and make necessary changes to make your work convenient.
Tours: allows you to organize learning tours, combining the articles of your choice. You can easily set the order of articles by drag&drop. Write notes to learners, that they will see on the first page of the tour. Track learners' progress (see. Managing learning tours).
Articles in Email Composers: adds a KnowSystem icon in the email composers, so you can choose articles to add to emails. You can either update the email body or attach an article as a pdf (see. Quick access to KnowSystem).
Articles by Documents: adds a KnowSystem icon above all documents' forms, so you can read an article without opening the KnowSystem app. You can also set different filters to documents' tags to see them in the first place when you access the KnowSystem from the matching documents (see. Quick access to KnowSystem).
KnowSystem in systray: adds a KnowSystem icon in the backend header, so you will be able to see it from any place and easy access articles (see. Quick access to KnowSystem).
Edit on website (): adds a button 'Edit on Website' to articles and allows you to edit your articles using Odoo standard Website builder (see. Website builder).
Turn off Backend Editor (): turns off the default Backend builder, showing the HTML code, that you can edit, instead (see. How to create an article and Code editor).
Print without titles: allows printing only content of the articles, without titles, for the better printing layout.
In the Extra Options section, you can see all the available add-ons and their pages. From here you can turn them on and off.
The add-on Portal and Website Views () has its' own configuration section. The extension supports multi-website, and it is required to apply them for each of your sites separately. To switch between sites' settings, select the website to configure in 'KnowSystem Website'. Here you also have a website link button ( ), that forwards you to the chosen website to see the result, but make sure you clicked 'Save' in the left corner on the top of the page.
Portal KnowSystem (): allows you to show the articles to portal users. You can give access to some articles, by assigning tags and stating the 'Allowed partners', or add KnowSystem tags to partners on the contact card (see. Managing tags).
Public KnowSystem (): allows you to publish your articles for all website visitors to see (see. Access Rights).
Custom Portal Filters (): allows you to set options to filter articles on the portal. You can add portal filters to various models, set action, and choose a person for which the filter will be available. You can also add automatic rules to filter objects.
Custom Portal Search (): allows you to set search options to find articles on the portal. You can add a field and name it, so it will be possible to search for the keywords in it on the portal.
Custom Portal Sorting (): allows you to add custom sorting criteria for portal/website KnowSystem. You can add sorting criteria based on a particular field, name them and set either ascending or descending order.
Turn on default sorting (): allows applying one of the sorting options by default as a user opens the KnowSystem page on website.
Default Sorting/Custom Default Sorting (): allows choosing a particular sorting option either default or a custom one as a user opens the KnowSystem page on website.
Print in Portal (): adds a possibility for portal and public users with access to the article to print it.
Portal Likes (): gives portal users an opportunity to like and dislike articles.
Social Sharing (): adds a social share bar, for quick share through various social media.
Sections and Tags Tooltips (): shows sections and tags description on the website as a user hovers over any of those.
Articles Per Page (): choose the number of articles that are shown per page.
The add-on Odoo Documentation Builder () has its' own configuration section. The extension supports multi-website, and it is required to apply them for each of your sites separately. To switch between sites' settings, select the website to configure in 'Documentation Website'. Here you also have a website link button ( ), that forwards you to the chosen website to see the result, but make sure you clicked 'Save' in the left corner on the top of the page.
Portal Documentation (): turns on portal documentation.
Public Documentation (): turns on public documentation.
Default Security Action (): in case when a user doesn't have access to only one or several articles of documentation, you can choose to either hide it, or show a warning, that the user has no access to it, or to neglect access rights and show it anyway, if a user has the access to the documentation itself (see. Odoo Documentation Builder: access rights).
Show Attachments (): includes article attachments to a documentation page. Otherwise, only articles' content will be shown.
Versioning (): allows you to introduce some changes in documentation for particular versions and leave the rest that refers to all versions to avoid double work. It adds a field, to state to which version an article refers (see. Odoo Documentation Builder: versioning).
KnowSystem: Website and Portal
KnowSystem: Website and Portal is an optional add-on () that allows you to add your articles to the portal and on your websites. The extension allows you to use the standard Odoo Website builder that provides with a wide variety of templates and tools for editing articles, making them presentable and user friendly, and customize your articles in the same way as website pages.
The main features of the app are:
Publish articles on your website
Give access to articles to portal users by tags
Edit your articles in Website builder
Print, like, or share articles
Turn on/off KnowSystem for portal users to let them observe published and especially delegated to them articles. Go to Configuration > Configuration, find section Portal and Website Views and tick the box 'Portal KnowSystem'.
Turn on/off KnowSystem for public users to let unauthorized website visitors read published articles. Go to Configuration > Configuration, find section Portal and Website Views and tick the box 'Public KnowSystem'.
Website and Portal: navigation & settings
Website and portal: article page & website builder
All features described in this article are related to the add-on KnowSystem: Website and Portal ().
It is possible to edit an article right from its website page, just click 'Edit' in the top right corner, to open the website builder. Or, you can return to editing in backend. To see this option, click on the down arrow on the right side of the 'Edit' button.
See a mobile preview by clicking on the phone icon in systray, to make sure an article looks good in both portrait and landscape modes. From the systray, you can also publish and unpublish articles.
Optionally, you can:
1. Allow partners to print knowledge pieces, like or share articles. Go to Configuration > Configuration find the Portal and Website Views section and put a tick by 'Print in Portal'. Then, by the article's headline, a printing icon will appear.
2. Allow partners to share articles. Go to Configuration > Configuration find the Portal and Website Views section and put a tick by 'Social sharing'. Then at the bottom, you will see social media icons.
3. Allow partners to like and dislike articles. Go to Configuration > Configuration find the Portal and Website Views section and put a tick by 'Portal likes'. Then at the bottom, you will see icons like and dislike.
From an article's view you can also switch back and forth between articles. Click on the arrows in the top right corner of an article.
To return back to the main articles' menu without losing the searching criteria, use the tool breadcrumbs on the left top corner of an article. For example, click on the previous step 'KnowSystem' to return to the main articles menu.
Website and Portal: public & portal users
All features described in this article are related to the add-on KnowSystem: Website and Portal ().
KnowSystem for public and for portal users can be turned on or off, depending on your goals.
Turn on/off KnowSystem for portal users to let portal users observe published and especially delegated to them articles. Go to Configuration > Configuration, find section Portal and Website Views and tick the box 'Portal KnowSystem'. After that, portal users will be able to read published and partner-related-by-tags articles and related to those sections, read published tags and article types (). They may also like/dislike articles.
Turn on/off KnowSystem for public users to let unauthorized website visitors read published articles. Go to Configuration > Configuration, find section Portal and Website Views and tick the box 'Public KnowSystem'. After that public users will be able to read published articles, sections, tags, and article types ().
The app supports multi websites, and therefore it is required to set the configuration for each available site separately. For example, you can turn on the KnowSystem Portal, KnowSystem Public, and allow printing on one website, but turn on only KnowSystem Portal on the other, or make it unavailable at all.
Here are all the options, that can be configured for each website:
1. Turn on/off Portal KnowSystem
2. Turn on/off Public KnowSystem
3. Add Custom Portal Filters
4. Add Custom Portal Search
5. Turn on/off Print in Portal
6. Turn on/off Portal Likes
7. Turn on/off Social Sharing
8. Turn on/off Section and Tags Tooltips
9. Set the number of articles per page
Odoo Documentation Builder
Odoo Documentation Builder is an add-on () to KnowSystem, that allows combining articles in advanced documentation to cover certain aspects of organizational or functional knowledge. The extension also depends on the add-on KnowSystem: Website and Portal ().
Each KMS article might be used several times for different documentations. You can add an unlimited number of documentation pages structured by categories. The idea is to have a single documentation website page that fully covers a definite issue or aspect. You can also modify the appearance of pages: show or hide introductions and footers, turn on/off the search bar and table of contents, add or remove preview images and texts.
You can turn on the option 'Portal Documentation' and 'Public Documentation' to make the documentation available for portal and public users respectively. The app generates website pages automatically. To update this documentation set you should only add or remove a required knowledge article.
Indicate to which version an article relates to. Share documentation categories and sections. Publish required documents to make them available for everybody, assign KnowSystem tags - to grant access for chosen Odoo partners. Define what to do if a documentation user does not have access to included articles: to neglect restrictions, not to show that knowledge pieces, or to show a security warning. The app fully supports standard Odoo features including multi websites.
Publish and share documentation
Modify documentation pages
Documentation Builder: managing documentation
All features described in this article are related to the add-on Odoo Documentation Builder ().
A documentation category is a tool, that helps you to structure your documentation. A category unites documentation sections. There are two ways to create a new category:
1. Go to Documentation > Documentations Categories and click create
2. Go to Documentation > Documentation Sections and click on + 'Add a column'
Drag&drop categories to change their sequence.
A Documentation section is a set of articles that together create documentation on a particular topic or for a particular object. There are two ways of creating a documentation section. You can go to Documentation > Documentations Sections, click create and add articles one by one, or you can add all required articles at once from the single view interface.
To add articles to a documentation section:
1. Go to Documentation > Documentations Sections and click create
2. Write a title of the section and manually translate it in other installed languages (), if you want
3. Choose a category and versions (see Documentation Builder: versioning)
4. Open KnowSystem and choose the articles by putting a tick in the top right corner of the articles
5. In the right navigation panel choose the mass action 'Add to documentation'
6. In the pop-up window choose the documentation section, to which you want to add articles
7. Choose a security action that will apply to all chosen articles (see Documentation Builder: access rights)
8. Click 'Save&Close' and you will be redirected to the documentation section card
9. Click 'Edit'
10. Click 'Add a line' to add one more article, that you can choose in the pop-up window.
11. Choose a security action for it
12. Click on the tab 'Settings' to add preview text and tags. From here you can also choose 'Header level for navigation', that is the number of headers that will be shown in the navigation panel, as a person reads a documentation section
13. Click 'Save'
The tags that you add to a documentation section, are the same tags that are applied to articles. Add a tag for quick search and easy navigation or to share a knowledge piece with the assigned to the tag partners (see Managing tags).
You can publish document section as you open it, and it isn't necessary to turn on the editing mode. It is possible to share document sections with any users, even when it isn't published yet. Click on the 'Share' button in the top right corner of a document section and a link with a special token will be created (see Documentation Builder: access rights).
Drag&drop documentation sections to change category.
From the backend, you can track, what articles are used in documentation. Such articles are marked by a paperclip icon on the kanban card. To find out in what documentation sections the article is used, click on the 'Info' button as you open an article and find the field 'Documentation sections'.
You can also filter the articles, that are used in documentations by applying the filter 'Used in documentation'.
To find all articles of a particular section, type the section's name and choose the searching criterion 'Documentation sections'.
Documentation Builder: customization
All features described in this article are related to the add-on Odoo Documentation Builder ().
As you turn on the 'Public Documentation' (in Configuration>Configuration> Documentation Builder), the page 'Docs' appears on the website and the tab Docs appears in the portal if the option 'Portal Documentation' is turned on. Both entries lead to the same page '/docs'. There you can see all published documentation categories and documentation sections.
Portal users, if allowed, see a new tab 'Documentation' which redirects them to the page with documentation (see Documentation Builder: Access rights).
If an article has a published title, then it will be used as the article's headers and in the navigation list instead of the article's title (see How to create an article).
On a website, the documentation is kept under the menu 'Docs'. Here you see documentation sections divided by categories. In the top left corner in systray click 'Customize' and click on the slider button to change the page's look.
The customization options are:
1. Cover Image
2. Preview Text
4. Search bar
Turn on the Introduction, to add an introductory block above the documentation. In this block, you can write some information about the page, so the visitors could understand what is it for. Click 'Edit' at the top right corner of the page to add and edit some building blocks and make the page more appealing.
Turn on the search bar for documentation. With the help of the search bar, you can search documentation sections by the matches in the title. The found documentation sections are shown together with their category. If there are no matches found, you see the alert 'No documentation found. You can click 'Edit' to change the alert text and customize it. To reset the search click on the cross on the right side of the search bar.
Turn on the documentation preview text to show the text on the document section's card. You can add a preview text in two ways:
1. In the backend as you create or edit a documentation section in the tab 'Settings'
2. In the frontend, by clicking on the 'Edit' button in the top right corner and clicking on a documentation section at the place where the preview text should be
Turn on the cover image to see pictures on a document section's card. You can add pictures in two ways:
1. In the backend as you create or edit a documentation section, click on the 'Pen' icon in the photo section
2. In the frontend, by clicking on the 'Edit' button in the top right corner and clicking twice above the title on a documentation section card
There are various types of cover images that you can add to a documentation section. It can be .jpeg, .png and even .gif.
Click on any documentation section on a website to open it. In the top left corner in systray click 'Customize' and click on the slider button to change the page's look.
The available customization options are:
4. Searchbar, including Searchbar printing, Searchbar search and Searchbar versioning (see Documentation Builder: versioning)
Adding Introduction and Footer allows you to add some building blocks before the documentation section and after it. You can add as many building blocks as you want and edit them the same way you edit the documentation section.
Don't add blocks with pictures (apart from background) in the Introduction or Footer of a documentation section, as it might affect the location of search bar and table of contents.
Add Navigation (Table of contents) to move between documentation section's articles conveniently. As you scroll down the page, the Navigation panel follows you and marks bold the content that you are at. To hide the Navigation panel click on the icon . Click to show it.
The table of contents consists of various Header levels. The article's title is marked as Header 1. To see other Header levels in the Navigation panel click on the 'Arrow' icon that appears near contents that have other Header levels.
It is up to you to decide how many Header levels do you want to see in the Navigation panel. To set the number of shown headers:
1. In the backend start creating or editing a documentation section
2. Open the tab 'Settings'
3. In the line 'Header Level for Navigation' put a number from 0 - 6
4. Click 'Save'
To assign a header to a title or subtitle:
1. Choose the text line
2. Click on the 'Style' icon on the editing tools panel
3. Assign a Header level
4. Click 'Save'
Another customization option is a Searchbar. As you turn on the Searchbar three other options, that you can turn on/off, appear. Those are Searchbar printing, Searchbar search and Searchbar versioning (see Documentation Builder: versioning).
The Searchbar search helps to conveniently search through a documentation section. There are three searching options:
1. Default Search (case insensitive, searches both in documentation section's body and headers)
2. Case Sensitive Search (minds the letter case, for example, 'A' does not equal 'a')
3. Search in Headers only (only in lines with applied Header level style)
As you apply search parameters, all matches will be counted and you can browse through them using the back and forth arrow icons in the search form. The search form will follow you as you look through the matching results. Click on the cross icon to reset the search.
To be able to print the documentation with all the included articles, turn on the option 'Searchbar printing'. After that, the button 'Save as PDF' will appear on the left side from the search bar. Click on it to start the downloading.
Keep in mind, that the website styles may not be parsed correctly for printing, so, for the best printing layout it is better to use the backend styles.
To be able to switch between versions, first of all, you need to turn on the feature. From the KnowSystem app, go to Configuration > Configuration, scroll down to the section 'Documentation Builder', tick the box 'Versioning'. Then, create some versions and apply them to some articles in a documentation section (see Documentation Builder: versioning). After that, you will be able to switch between versions and therefore will have a different set of articles in one documentation section.
To switch between versions click on the version on the left side of the search panel and choose the other one. As you choose one of the versions of a documentation section, only the articles for this version and the ones that go to any version are displayed.
All articles in a documentation section go one by one and are divided by the eye-catching Header 1. A person can see an article of a documentation section only if he/she has access to it. There are three options for how to deal with access rights of documentation section's articles: to skip an article, to show a warning instead, or to neglect access rights (see Documentation Builder: access rights).
If you want to make articles attachments visible under their content, you can turn on the option 'Show Attachments' in the KnowSystem Configuration, the section Documentation Builder.
The documentation section's body can be edited right from the frontend. It might be convenient to edit the whole documentation section instead of editing all articles separately. To edit a documentation section, just open one and click on the 'Edit' button in the top right corner. Edit documentation section in the same way as you edit separate articles with the help of website builder (see Website builder).
Documentation Builder: versioning
All features described in this article are related to the add-on Odoo Documentation Builder ().
Apply versioning for documentation to avoid double work in preparing specifications, user manuals, or software guidelines. As you create a document section you will be able to choose the versions to which it might refer to and state the versions for each article. For example, the whole documentation sections might be applicable to v.14 and v.15 and some articles only to v.15. To create a new version:
1. Go to Documentation > Documentation Versioning
2. Click 'Create'
3. Write a title
4. Click 'Save'
Documentation may look differently depending on the version. Apply versions to a documentation section. For that start creating or editing a section and in the field 'versions' choose available ones or create a new one and click save. In the editing mode, you can assign versions to particular articles. Click on an article and choose one or several versions. You can choose only among those versions, which you applied to the documentation section of the article. If you won't assign any versions to an article, then it will be shown on all versions that are applied to its documentation section.
You can switch between the documentation section's versions, as you click on the version title in the left top corner. After that, the list of articles will change and you will see only the ones that are assigned to the version you chose.
Documentation Builder: access rights
All features described in this article are related to the add-on Odoo Documentation Builder ().
The app lets flexibly share documentation categories and sections. Public users can see only published documentation categories and sections. Portal users have the same access rights as public users, but you can also grant extra rights for particular partners. Assign KnowSystem tags for documentation sections to grant access for chosen Odoo partners (see Managing tags).
To turn on/off Documentation Builder for portal users go to Configuration > Configuration, find section Documentation Builder and tick the box 'Portal KnowSystem'.
To turn on/off Documentation Builder for public users go to Configuration > Configuration, find section Documentation Builder and tick the box 'Public KnowSystem'.
To publish a documentation category going to Documentation > Documentation Categories, open any category, and click 'Publish' or 'Unpublish' in the top right corner of the category's form.
To publish or unpublish a documentation section just open any section and click 'Publish' or 'Unpublish' in the top right corner of the section's form. There is no need to start editing a section to do that, as the buttons above the form are available even in the read-only mode.
To assign a tag to a documentation section start creating or editing it, click on the tab 'Settings', find the field 'Tags', and add some.
Depending on user rights documentation section might look different. Define what to do if a documentation user does not have access to included articles: to neglect restrictions, not to show that knowledge pieces (omit them), or to show a security warning.
To choose the security action for an article in a documentation section:
1. Go to Documentation > Sections
2. Start editing a documentation section
3. Click on an article
4. Choose the security action
5. Click 'Save&Close'
To choose a security action for all included to a documentation section articles:
1. In the single view interface start choosing articles by ticking the box in the top right corner
2. In the right navigation panel choose the mass action 'Add to documentation'
3. Choose the documentation section or start typing a new title to create a new one
4. Choose a security action, that will be applied to all selected articles
To choose default security action for all articles in all documentations:
1. Go to Configuration > Configuration
2. Find the section 'Documentation Builder'
3. Find the field 'Default security action' and choose the action
4. Click 'Save'
KnowSystem: Custom Fields
KnowSystem: Custom Fields is an add-on () to KnowSystem that allows you to add custom fields to articles. The add-on doesn't work without the core module: Custom Fields: Core. You can place your custom fields in the backend article's form, or on the website, if you have: KnowSystem: Website and Portal (), and KnowSystem: Custom Fields for Website and Portal (see. KnowSystem: Custom Fields for Website and Portal).
In order to show a new property for knowledge base articles, go to Configuration > Custom article fields, click 'Create' to add a new field, and enter details. It is possible to add custom fields of the following types:
1. Single-line text (char)
2. Simple text without formatting (text)
3. Rich text (HTML-formatted text)
4. Integer or float numbers
5. Drop-down choice with your own options (selection)
6. Checkbox (boolean)
7. Date or date and time
8. Binary (a file to upload)
9. Reference to another Odoo document (e.g. for sale order, contact; many2one)
The tool lets you comfortably select an interface position of a custom field from a closed list of options. In the backend form of view you can place your custom fields: after article, to the left column, or to the right column.
Distinguish knowledge articles by types in order to show properties only for suitable ones. Thus set of attributes for 'user guidelines' and 'technical specifications' might be different.
Mark a custom field required to force users to enter values. In this case, a user will not be able to save an article, if the field left empty. For that, tick the box 'Required to enter a value' as you create or edit a custom field.
Custom knowledge system fields might be imported and exported (see KnowSystem import and export).
The rights to create custom fields belong only to KnowSystem administrators.
Extra fields for article's forms
Various form placement
Require to enter a value
Import and export custom fields
KnowSystem: Custom Fields for Website and Portal
KnowSystem: Custom fields for Website and Portal is a free KnowSystem add-on () that lets you show custom fields on the website. The add-on doesn't work without the core modules: KnowSystem: Website and Portal (), KnowSystem: Custom fields (), and Custom Fields: Core. The available fields types for your website articles are the same as in the backend (see KnowSystem: Custom fields).
To set a custom field, go to Configuration > Custom article fields and click 'Create'. To make a custom field visible on the website, choose its 'Portal Page Placement': at the end, left column, right column. You can also leave the field empty if you want to have a custom field only in the backend.
KnowSystem: Multi Languages
KnowSystem: Multi Languages is a KnowSystem add-on () that lets you translate articles into installed in Odoo languages. In such a way users might read and edit articles in a language from their preferences. The language switch sign is added to such fields as: title and preview text as you edit an article. Click on the language icon to manually translate to another language. You can also translate sections', tags' and tours' titles. The fields will be shown in the preferred user's language.
The work with articles in multi-language is not easy as it implies preparing an own body for each article for each language, what almost equals writing a brand new article.
Manually translate articles, titles, and preview text
Add translation for sections', tags' and learning tours' titles
Copy from another translation
See revisions independently for different languages
If you want to have only the title and preview text translated, there is no need to copy-paste the body as it will be in the default language if no other changes are made.
Click on the language icon to manually translate the field to another language. The language switch sign is added to such fields as:
1. Title and preview text as you edit an article.
2. Sections', tags' and tours' titles
In order to see the fields translated, you need to switch to the preferred language.
To update knowledge body translation you should change your user preferences to a required language, in which you want to apply changes. Then, go to an article and introduce changes as you just editing an article. All changes performed with an article will be applied to the version only in the currently preferred language. The article in the default language will not be changed.
Multi-language regime implies that all articles should be kept updated in all Odoo languages.
Article content also might be copied from another language.
To copy the content of article of one language to article in another language:
1. Change the preferred language in user's settings
2. Open an article and start editing it
3. In the left bottom corner of the article's body click on the button 'Copy from another translation'
4. Confirm your choice
5. Click 'Save'
The revisions of translated articles are kept separately depending on the article's language. You can't switch between revisions of the same article in different languages and, for example, restore a revision of an article in French to the article in German (see Article revision and history of changes).