knowledgeroot

knowledgeroot 示例站点

www.globaladmin.cn

Knowledgeroot可用于文档管理，知识库管理。

1.基于php开发,支持linux ,windows.
2.支持mysql ,sqlite, postgreSQL
3.支持任意类型附件（目前版本使用数据库base64后保存文件,需要调整mysql 参数max_allowed_packet，否则大于1M文件不能保存），使用数据库保存附件这个特性，如果附件很多，很大的情况，会是个问题。需要改造。
4.支持插件功能,官方网站下载插件，后台管理import，然后install， enable。
5.官方插件CKEditor (当前版本 2.6.2) 可与KCFinder 2.5.1 配合实现文件上传（已经支持中文）
6.官方插件ContentHistory 实现版本历史功能,类似diff查看版本,以及系统全部 last changes
7.支持中文,如需要修改原始翻译，可使用 msgfmt 可自主转换 po to mo.
8.tips:针对每个page.可以在edit page时设定content是否在点击page时自动展开还是只列title。创建时不能指定？
9.编辑冲突问题解决：原始版本编辑content时，首先在content_open表插入数据。然后打开content内容。第二个用户编辑时，也是先写入到content_open表，然后检查是否有其他用户打开数据，如果有，在打开内容上方显示警告。如果强制编辑，会出现一方修改信息被另一方覆盖的问题。
解决方法是采用排他编辑模式，如果内容被编辑中，其他人再试图编辑，直接提示有其他人编辑，返回。不能进入编辑。提示信息中有正在编辑此内容的user id。以方便协调。
主要修改2个文件：
  class-knowledgeroot-content.php 
    function edit_content
 class-knowledgeroot.php
    function openContent

10.注意插件多不支持中文，修改插件的language.php参照 en_US 增加zh_CN配置,(UTF-8 no bom )
11. 使用CKEditor 时，配合KCFinder支持文件上传
修改CKEditor目录下config.js  指向KCFinder
CKEDITOR.editorConfig = function( config )
{
        // Define changes to default configuration here. For example:
        // config.language = 'fr';
        // config.uiColor = '#AADC6E';

config.filebrowserBrowseUrl = '/kcfinder/browse.php?type=files';
      config.filebrowserImageBrowseUrl = '/kcfinder/browse.php?type=images';
      config.filebrowserFlashBrowseUrl = '/kcfinder/browse.php?type=flash';
      config.filebrowserUploadUrl = '/kcfinder/upload.php?type=files';
      config.filebrowserImageUploadUrl = '/kcfinder/upload.php?type=images';
      config.filebrowserFlashUploadUrl = '/kcfinder/upload.php?type=flash';
};

修改kcfinder 中config.php ，加入：
$_SESSION['KCFINDER']['disabled'] = false, 
完成。
注意如果在linux系统中使用了软链接www root，需要配置kcfinder的uploadurl地址。
12. 升级CKEditor .
出于安全考虑， CKEditor使用 新版本  3.6.6.1替换原始版本3.6.2。
直接替换原始extension/ckeditor/ckeditor，然后修改config.js 同11.

13.修改email 发送为异步发送方式方法：

需求：由于远程邮件服务器访问缓慢，打开邮件提醒功能后，操作缓慢，影响用户体验。

数据库增加表：

DROP TABLE IF EXISTS mail_queue;
CREATE TABLE mail_queue (
  id int(11) unsigned NOT NULL auto_increment,
  subject varchar(255) NOT NULL,
  bodytext text ,
  bodyhtml text ,
  emailto  varchar(255) not null,
  createtime timestamp NOT NULL default CURRENT_TIMESTAMP,
  PRIMARY KEY  (id)
 
  ) ENGINE=MyISAM  DEFAULT CHARSET=utf8

 

修改：class-email-notification.php 文件的函数：

 function sendEmail($config, $subject, $bodyText, $bodyHtml = null) {
             
                  $emailto = $config->to;      
             $sql =  sprintf("INSERT into mail_queue (subject, bodytext,bodyhtml,emailto) VALUES( '%s', '%s', '%s', '%s')",
                               addslashes($subject),addslashes($bodyText),addslashes($bodyHtml),$emailto);
                  $this->CLASS['db']->query($sql );
           return true;       
       }

 

建立一个读取mail_queue表中数据然后通过SMTP发送邮件的php文件。

mailqueue_send_job.php
<?php
// mailqueue_send_job.php
// tank add 2013.
$timer = microtime();
$starttime = ((double)strstr($timer, ' ') + (double)substr($timer,0,strpos($timer,' ')));

if (!is_file("config/app.ini")) {
    echo "No configuration file found! ";
    exit();
}
// load requiered files
require_once ('include/init.php');
$config = $CLASS['config']->email;
$res = $CLASS['db']->query("SELECT id, subject,bodytext,bodyhtml,emailto  FROM mail_queue order by id ");
$cnt = $CLASS['db']->num_rows($res);
while($row = $CLASS['db']->fetch_assoc($res)) {
   $id =  $row['id'];
   $res2 = $CLASS['db']->query(sprintf("delete  FROM mail_queue where id = %d ",$id));
  sendEmail($config,$row['emailto'], $row['subject'], $row['bodytext'], $row['bodyhtml']) ;
}
function sendEmail($config, $emailto,$subject, $bodyText, $bodyHtml = null) {
        try {
            $transport = null;

if($config->host != '') {
                $smtpConfig = array();
                if($config->auth != '') {
                    $smtpConfig['auth'] = $config->auth;
                    $smtpConfig['username'] = $config->username;
                    $smtpConfig['password'] = $config->password;
                }

if($config->port != '') {
                    $smtpConfig['port'] = $config->port;
                }

if($config->ssl != '') {
                    $smtpConfig['ssl'] = $config->ssl;
                }

$transport = new Zend_Mail_Transport_Smtp($config->host, $smtpConfig);
            }
            $mail = new Zend_Mail('UTF-8');                     
                        $mail->addHeader('X-MailGenerator', 'Knowledgeroot');
            $mail->setBodyText($bodyText);
            if($bodyHtml != null) $mail->setBodyHtml($bodyHtml);
            $mail->setFrom($config->from, $config->from_name);
            foreach(explode(",", $emailto) as $value) {
                if(trim($value) != "") {
                    $mail->addTo($value);
                }
            }
            $mail->setSubject($config->subject_prefix . $subject);
            $mail->send($transport);
                        echo  'Sent OK\n';
            return true;
        } catch(Zend_Mail_Transport_Exception $e) {
               $ErrorMsg = $e->getMessage();
                           echo  '\nError 1:' .$ErrorMsg;
            return false;
        } catch(Exception $e) {
                         $ErrorMsg = $e->getMessage();
                           echo '\nsError 2:' . $ErrorMsg;           
            return false;
        }
    } 
?>

 此php脚本只能使用wget访问执行，在cron 中增加执行shell
#!/bin/sh
wget -O result http://localhost/mailqueue_send_job.php >> log.txt

14.官方插件CKEditor  对于尖括号 <> 不兼容问题修复：

 修改 class-ckeditor.php  ：

function show($text="") {
            $texthtml = htmlspecialchars($text);
            $texthtml = $text;
        return "<textarea class="ckeditor" id="content" name="content">".$texthtml."</textarea>";
    }

 

15. 增加首页显示last changes功能：

 

a. 在include目录中创建类：class-lastchanges.php

   var $CLASS;
    function start(&$CLASS) {
        $this->CLASS =& $CLASS;
    }

function  getlastchanges() {

...  参考class-history.php类中：function showLastChanges() 方法。

}

-----------------------------------------------------------

b.修改init.php

在最后增加:

require_once($base_path."include/class-lastchanges.php");

//
$CLASS['lastchanges'] = new lastchanges();
$CLASS['lastchanges']->start($CLASS);

------------------------------------------------------------

 

c.修改：class-knowledgeroot_content.php

1650行附近：

echo "<div class="welcome">".$this->CLASS['translate']->_('Welcome to Knowledgeroot')."</div>\n";

修改为：

 

               $out =  $this->CLASS['lastchanges']->getlastchanges();

               echo $out;

=========================================

 

 

 

 

 

 

 

knowledgeroot 的配置与优化

首先下载 KnowledgeRoot 的安装包，就是一个压缩文件，解压缩后放到 WebRoot 下面

在浏览器中打开网站，自动提示进行安装，安装的过程很简单，安装结束后即可以使用。

安装包创建的数据库默认使用瑞典语，这个很不好，可以打开 dumps/mysql.sql 文件进行修改，将

ENGINE=MyISAM AUTO_INCREMENT=1

全部替换为

ENGINE=MyISAM AUTO_INCREMENT=1 CHARACTER SET utf8 COLLATE utf8_unicode_ci

即可保证所有的表创建为 UTF-8 格式的。

如果需要修改 admin 账号的密码，也可以在脚本中直接修改，如下所示：

INSERT INTO `users` ( `id` , `name` , `password` , `enabled` , `defaultgroup` , `defaultrights` , `admin` , `rightedit` , `treecache` )
VALUES ( '1', 'Admin', MD5('1qA2wS3eD$'), '1', '1', '210', '1', '1', '' );

默认的登录界面是英文的（en_US.UTF8），可以在 config/app.ini 文件中修改

[base]
version = "1.0.3"
title = "知识库"
cryptkey = "yourcryptkeyhere"
base_path = "D:\Web\Domains\knowledge/"
base_url = "http://localhost/"
charset = "UTF-8"
locale = "zh_CN"
showlogo = "1"
theme = "green"

如上文所示，将 local 修改为 zh_CN 则默认的语言就是中文的了，另外网站的标题也可以修改，如果修改为中文记得将文件编码设置为 UTF8

showlogo 为 1 则在页面左上方显示 logo , 为 0 则显示title 的内容

在内容标题的下方有一排菜单，鼠标移动到菜单项上时会出现菜单项超出菜单条的问题，这是因为直接设置了菜单条的高度，去掉元素的高度，让 dojo 自动计算高度就不会有这个问题，找到 include/class-default-menu.php，定位到 201 行（针对 1.0.3 版本），去掉 height: 24px; 这个属性，就可以了

$this->defaultmenu['content']['config']['wrap'] = '<div style="border-left:0px; border-right:0px;" dojoType="dijit.MenuBar" region="top">|</div>';

如果觉得内置的编辑器功能太弱，可以到KNOWLEDGEROOT官方网址上下载 CKEditor 插件（或者 FCKEditor 插件），在后台管理界面中导入 ckeditor.krx ，然后在扩展里面安装(install)并启用(enable)这个插件就可以了，该编辑插件在 FireFox 中可以直接从计算机里面拖图片到编辑框中，非常方便（该功能在 Chrome 和 IE 不好用，因为这些浏览器会打开你拖进来的图片，而不是放到编辑区里面)

最后如果觉得字体和文字的大小不合适那么可以修改 css 来进行调整，例如把 system/themes/green/green.css 中字体调整为

font-family: "微软雅黑", "新宋体", "宋体", Arial;
font-size: 10pt;

字体大小在不同的地方需要根据原来的大小等比例的调整，目录树、菜单、正文等系统默认 12px，对中文来说太小不方便阅读，所以统一调整为 10pt，就美观多了。