How to publish content to a remote website

KMP has a built-in publication feature. It allows you to post certain parts of your KB to other web pages, for example on your website. The posted (published) content gets updated automatically, i.e. if you have published an article to a remote web page, and this article has been changed in KMP, it will be also changed on the remote web page.

You can include parts of the knowledge base (separate articles, categories, the whole knowledge base, or auto related widget) to your existing website (they work without iframes).

You may want to use publications, if:

• You have a multilingual website and you want to put an FAQ or KB on each version o the website. Each KB must have articles and user interface in certain language.
• You have several websites with information about different products or services. You want to put different parts of the knowledge base on different websites.

Publication Guide

1. To start creating a publication, go to Administration > General Settings > Publishing > Publications.
   
   
2. Click "Publish Knowledgebase" and walk through the simple wizard to specify what you want to publish and customize the look and feel.
3. Step 1: General
   On the first step you can enter a name for the publication. It won't be shown to end users, it will just identify this publication in KMP admin interface. Also you can pick language, date, and time format for publication and select a time zone of the target web site.
   Next, you need to select what type of publication you would like to create.
   
   Knowledgebase - publish full knowledge base with all public articles and categories.
   Single Article - publish one article by your choice.
   Auto Related Widget - this profile analyzes a content of a page on your website, where you will put generated code, and displays a list of related articles from the knowledgebase.
   Category - publish one category (with or without subcategories, you can select this on the next step) and its child articles.
   
   
4. On the next step you can select what items (search bar, captcha, quick jump menu) you want to show on published page. Note that this page may have several tabs, for example Article View (it allows you to change look of the page with an article), and Categories View (it allows you to change a category page look).
   
   
   
5. On the next step you can select on of the existing styles, or create your own style.
   
   
   
6. After saving of the new publication profile, click the respective "Get Code" button.
   
   
   
7. Here you can see five parts of code that you need to insert to the target web page to publish this profile.
   
   
   
8. Here is a sample of basic HTML page for better understanding of where these parts must be inserted.
   
   
   <?php if(get_magic_quotes_gpc()){function stripslashes_deep($value){$value = is_array($value)?array_map('stripslashes_deep', $value) :stripslashes($value);return $value;}$_POST = array_map('stripslashes_deep',$_POST);$_GET = array_map('stripslashes_deep',$_GET);$_COOKIE=array_map('stripslashes_deep',$_COOKIE);$_REQUEST = array_map('stripslashes_deep',$_REQUEST);} $post_data = array('gatewayAddr' => "http://".$_SERVER['HTTP_HOST'] . $_SERVER['SCRIPT_NAME']);$action = (empty($_GET['action']) ? "index" : $_GET['action']);$getData = (empty($_GET['data']) ? "" : $_GET['data']);$url = "http://demo/ed-kmp-pack-531/admin/index.php?/gateway_main/$action/3/133e82ff47fbc3bcce818d3af67d6710/$getData";$cookies = "";if (!empty($_COOKIE)) {foreach ($_COOKIE as $k=>$cook) {$cookies .= "$k=$cook;";}}$ch = curl_init($url); if (is_resource($ch)) {curl_setopt($ch, CURLOPT_POST, 1);curl_setopt($ch, CURLOPT_HEADER, 1);curl_setopt($ch, CURLOPT_HTTPHEADER,array("Expect:"));curl_setopt($ch, CURLOPT_NOBODY, 0);curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);curl_setopt($ch, CURLOPT_POSTFIELDS, array('data' => base64_encode(serialize(array_merge((array)$post_data, @$_POST)))));curl_setopt($ch, CURLOPT_COOKIE, $cookies);$kmp_result = curl_exec($ch);curl_close($ch);} else {curl_close($ch);}$kmp_result = explode("<!--__KMP_content_separator__-->", $kmp_result);if (!empty($kmp_result[0])) {$kmp_result[0] = explode("\n", $kmp_result[0]);foreach ($kmp_result[0] as $res) {if (!empty($res)) {if ((strpos($res, "Set-Cookie:") === 0) || (strpos($res, "Location:") === 0) || (strpos($res, "Content-Type:") === 0)) {header($res);if (strpos($res, "image/jpeg")) {echo $kmp_result[2]; exit();}}}}}  if (!empty($kmp_result[1])) {$kmp_arr = explode("\n", $kmp_result[1]);$kmp_meta_data = array();foreach ($kmp_arr as $kmp_arr_row) {$kmp_tmp_key = substr($kmp_arr_row, 0, 9);$kmp_tmp_value = substr($kmp_arr_row, 10);$kmp_meta_data[$kmp_tmp_key] = $kmp_tmp_value;}$kmp_title = @$kmp_meta_data['art_title'];} ?>

   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

   <html xmlns="http://www.w3.org/1999/xhtml">

   <head>

   <title><?php echo @$kmp_title;?></title>

   <meta name='keywords' content='<?php echo @$kmp_meta_data['meta_kwds'];?>' />

   <meta name='Description' content='<?php echo @$kmp_meta_data['meta_dscr'];?>' />

   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

   </head>

   <body>

   <?php if (!empty($kmp_result[2])) {echo $kmp_result[2];} ?>

   </body>

   </html>

    

   UTF without BOM
   

   If you're creating the publication page in a text editor in UTF encoding, make sure that it is "UTF without BOM" encoding option rather than just "UTF". Otherwise you might get "Cannot modify header information - headers already sent" error.

   
   
   What if publication doesn't work?
   

   It may happen that you would get a page with source code junk instead of published content.
   

   
   
   Publishing to CMS
   

   If you're publishing content on a CMS or any other website which is not static, you still need to put the first long part of the code at the very beginning of the page. That usually is done by editing page templates.