* @package doc * @version $Id: control.php 933 2010-07-06 06:53:40Z wwccss $ * @link http://www.zentao.net */ class doc extends control { /** * Construct function, load user, tree, action auto. * * @access public * @return void */ public function __construct() { parent::__construct(); $this->loadModel('user'); $this->loadModel('tree'); $this->loadModel('action'); $this->loadModel('product'); $this->loadModel('project'); } /** * Go to browse page. * * @access public * @return void */ public function index() { $products[] = $this->lang->doc->systemLibs['product']; unset($this->lang->doc->menu->index); $this->doc->setMenu($products); $products = $this->doc->getLimitLibs('product'); $projects = $this->doc->getLimitLibs('project'); $customLibs = $this->doc->getLimitLibs('custom'); $subLibs['product'] = $this->doc->getSubLibGroups('product', array_keys($products)); $subLibs['project'] = $this->doc->getSubLibGroups('project', array_keys($projects)); $this->view->title = $this->lang->doc->index; $this->view->position[] = $this->lang->doc->index; $this->view->products = $products; $this->view->projects = $projects; $this->view->customLibs = $customLibs; $this->view->subLibs = $subLibs; $this->display(); } /** * Browse docs. * * @param string|int $libID product|project or the int id of custom library * @param int $moduleID * @param int $productID * @param int $projectID * @param string $orderBy * @param int $recTotal * @param int $recPerPage * @param int $pageID * @access public * @return void */ public function browse($libID = 0, $browseType = 'all', $param = 0, $orderBy = 'id_desc', $recTotal = 0, $recPerPage = 20, $pageID = 1) { $this->loadModel('search'); /* Set browseType.*/ $browseType = strtolower($browseType); if(($this->cookie->browseType == 'bymenu' or $this->cookie->browseType == 'bytree') and $browseType != 'bysearch') $browseType = $this->cookie->browseType; $queryID = ($browseType == 'bysearch') ? (int)$param : 0; $moduleID = ($browseType == 'bymodule' or $browseType == 'bymenu') ? (int)$param : 0; $type = 'custom'; if($libID) { $lib = $this->doc->getLibByID($libID); if($lib->product or $lib->project) $type = $lib->product ? 'product' : 'project'; } if(empty($libID)) $type = 'product'; $this->libs = $this->doc->getLibs($type); if(empty($libID)) { $libID = key($this->libs); $lib = $this->dao->select('*')->from(TABLE_DOCLIB)->where('id')->eq($libID)->orderBy('id')->fetch(); } /* Set menu, save session. */ $this->doc->setMenu($this->libs, $libID, $type); $this->session->set('docList', $this->app->getURI(true)); /* Set header and position. */ $this->view->title = $this->lang->doc->common . $this->lang->colon . $this->libs[$libID]; $this->view->position[] = $this->libs[$libID]; /* Load pager. */ $this->app->loadClass('pager', $static = true); $pager = new pager($recTotal, $recPerPage, $pageID); /* Append id for secend sort. */ $sort = $this->loadModel('common')->appendOrder($orderBy); /* Get docs by browse type. */ $docs = $this->doc->getDocsByBrowseType($libID, $browseType, $queryID, $moduleID, $sort, $pager); /* Build the search form. */ $actionURL = $this->createLink('doc', 'browse', "lib=$libID&browseType=bySearch&queryID=myQueryID"); $this->doc->buildSearchForm($libID, $this->libs, $queryID, $actionURL, $type); $this->view->fixedMenu = false; foreach(customModel::getModuleMenu('doc') as $item) { if($item->name == "custom$libID" and empty($item->hidden)) $this->view->fixedMenu = true; } if($this->cookie->browseType == 'bymenu') { $this->view->modules = $this->doc->getDocMenu($libID, $moduleID); $this->view->parents = $this->loadModel('tree')->getParents($moduleID); } elseif($this->cookie->browseType == 'bytree') { $this->view->tree = $this->doc->getDocTree($libID); } else { $this->view->moduleTree = $this->loadModel('tree')->getTreeMenu($libID, $viewType = 'doc', $startModuleID = 0, array('treeModel', 'createDocLink')); } $this->view->libID = $libID; $this->view->libName = $this->libs[$libID]; $this->view->moduleID = $moduleID; $this->view->docs = $docs; $this->view->pager = $pager; $this->view->users = $this->loadModel('user')->getPairs('noletter'); $this->view->orderBy = $orderBy; $this->view->browseType = $browseType; $this->view->param = $param; $this->view->type = $type; $this->display(); } /** * Create a library. * * @access public * @return void */ public function createLib() { if(!empty($_POST)) { $libID = $this->doc->createLib(); if(!dao::isError()) { $this->loadModel('action')->create('docLib', $libID, 'Created'); die(js::locate($this->createLink($this->moduleName, 'browse', "libID=$libID"), 'parent.parent')); } else { echo js::error(dao::getError()); } } $this->view->groups = $this->loadModel('group')->getPairs(); $this->view->users = $this->user->getPairs('nocode'); $this->view->products = $this->product->getPairs('nocode'); $this->view->projects = $this->project->getPairs('nocode'); die($this->display()); } /** * Edit a library. * * @param int $libID * @access public * @return void */ public function editLib($libID) { if(!empty($_POST)) { $changes = $this->doc->updateLib($libID); if(dao::isError()) die(js::error(dao::getError())); if($changes) { $actionID = $this->loadModel('action')->create('docLib', $libID, 'edited'); $this->action->logHistory($actionID, $changes); } die(js::locate($this->createLink($this->moduleName, 'browse', "libID=$libID"), 'parent.parent')); } $lib = $this->doc->getLibByID($libID); if(!empty($lib->product)) $this->view->product = $this->dao->select('id,name')->from(TABLE_PRODUCT)->where('id')->eq($lib->product)->fetch(); if(!empty($lib->project)) $this->view->project = $this->dao->select('id,name')->from(TABLE_PROJECT)->where('id')->eq($lib->project)->fetch(); $this->view->lib = $lib; $this->view->groups = $this->loadModel('group')->getPairs(); $this->view->users = $this->user->getPairs('nocode'); $this->view->libID = $libID; die($this->display()); } /** * Delete a library. * * @param int $libID * @param string $confirm yes|no * @access public * @return void */ public function deleteLib($libID, $confirm = 'no') { if($libID == 'product' or $libID == 'project') die(); if($confirm == 'no') { die(js::confirm($this->lang->doc->confirmDeleteLib, $this->createLink('doc', 'deleteLib', "libID=$libID&confirm=yes"))); } else { $lib = $this->doc->getLibByID($libID); if(!empty($lib->product) or !empty($lib->project)) { $type = !empty($lib->product) ? 'product' : 'project'; $count = $this->dao->select('count(*) as count')->from(TABLE_DOCLIB)->where($type)->eq($lib->$type)->fetch('count'); if($count == 1)die(js::alert($this->lang->doc->errorEmptySysLib)); } $this->doc->delete(TABLE_DOCLIB, $libID); die(js::locate($this->createLink('doc', 'browse'), 'parent')); } } /** * Create a doc. * * @param int|string $libID * @param int $moduleID * @param int $productID * @param int $projectID * @param string $from * @access public * @return void */ public function create($libID, $moduleID = 0, $productID = 0, $projectID = 0, $from = 'doc') { if(!empty($_POST)) { $docResult = $this->doc->create(); if(!$docResult or dao::isError()) die(js::error(dao::getError())); $docID = $docResult['id']; $lib = $this->doc->getLibByID($this->post->lib); if($docResult['status'] == 'exists') { echo js::alert(sprintf($this->lang->duplicate, $this->lang->doc->common)); die(js::locate($this->createLink('doc', 'view', "docID=$docID"), 'parent')); } $this->action->create('doc', $docID, 'Created'); if($from == 'product') $link = $this->createLink('product', 'doc', "productID={$lib->product}"); if($from == 'project') $link = $this->createLink('project', 'doc', "projectID={$lib->project}"); if($from == 'doc') { $vars = "libID=$libID&browseType=byModule&moduleID={$this->post->module}"; $link = $this->createLink('doc', 'browse', $vars); } die(js::locate($link, 'parent')); } $lib = $this->doc->getLibByID($libID); $type = $lib->product ? 'product' : ($lib->project ? 'project' : 'custom'); $this->libs = $this->doc->getLibs($type); /* According the from, set menus. */ if($from == 'product') { $this->lang->doc->menu = $this->lang->product->menu; $this->lang->doc->menuOrder = $this->lang->product->menuOrder; $this->product->setMenu($this->product->getPairs(), $lib->product); $this->lang->set('menugroup.doc', 'product'); } elseif($from == 'project') { $this->lang->doc->menu = $this->lang->project->menu; $this->lang->doc->menuOrder = $this->lang->project->menuOrder; $this->project->setMenu($this->project->getPairs('nocode'), $lib->project); $this->lang->set('menugroup.doc', 'project'); } else { $this->doc->setMenu($this->libs, $libID); } $libs = $this->libs; if($productID) { $libs = $this->doc->getLibsByObject('product', $productID, 'onlylib'); } elseif($projectID) { $libs = $this->doc->getLibsByObject('project', $projectID, 'onlylib'); } $this->view->title = $this->libs[$libID] . $this->lang->colon . $this->lang->doc->create; $this->view->position[] = html::a($this->createLink('doc', 'browse', "libID=$libID"), $this->libs[$libID]); $this->view->position[] = $this->lang->doc->create; $this->view->libID = $libID; $this->view->libs = $libs; $this->view->moduleOptionMenu = $this->tree->getOptionMenu($libID, 'doc', $startModuleID = 0); $this->view->moduleID = $moduleID; $this->view->type = $type; $this->view->groups = $this->loadModel('group')->getPairs(); $this->view->users = $this->user->getPairs('nocode'); $this->display(); } /** * Edit a doc. * * @param int $docID * @access public * @return void */ public function edit($docID) { if(!empty($_POST)) { $result = $this->doc->update($docID); if(dao::isError()) die(js::error(dao::getError())); $changes = $result['changes']; $files = $result['files']; if($this->post->comment != '' or !empty($changes) or !empty($files)) { $action = !empty($changes) ? 'Edited' : 'Commented'; $fileAction = ''; if(!empty($files)) $fileAction = $this->lang->addFiles . join(',', $files) . "\n" ; $actionID = $this->action->create('doc', $docID, $action, $fileAction . $this->post->comment); $this->action->logHistory($actionID, $changes); } die(js::locate($this->createLink('doc', 'view', "docID=$docID"), 'parent')); } /* Get doc and set menu. */ $doc = $this->doc->getById($docID); $libID = $doc->lib; if($doc->type == 'markdown') { $this->config->doc->markdown->edit = array('id' => 'content,digest'); $this->config->doc->editor->edit['id'] = 'comment'; } $lib = $this->doc->getLibByID($libID); $type = $lib->product ? 'product' : ($lib->project ? 'project' : 'custom'); $this->libs = $this->doc->getLibs($type); $this->doc->setMenu($this->libs, $libID); $this->view->title = $this->libs[$libID] . $this->lang->colon . $this->lang->doc->edit; $this->view->position[] = html::a($this->createLink('doc', 'browse', "libID=$libID"), $this->libs[$libID]); $this->view->position[] = $this->lang->doc->edit; $this->view->doc = $doc; $this->view->libs = $this->libs; $this->view->moduleOptionMenu = $this->tree->getOptionMenu($libID, 'doc', $startModuleID = 0); $this->view->type = $type; $this->view->groups = $this->loadModel('group')->getPairs(); $this->view->users = $this->user->getPairs('nocode'); $this->display(); } /** * View a doc. * * @param int $docID * @access public * @return void */ public function view($docID, $version = 0) { /* Get doc. */ $doc = $this->doc->getById($docID, $version, true); if(!$doc) die(js::error($this->lang->notFound) . js::locate('back')); if($doc->type == 'markdown') { $hyperdown = $this->app->loadClass('hyperdown'); $doc->content = $hyperdown->makeHtml($doc->content); $doc->digest = $hyperdown->makeHtml($doc->digest); } /* Check priv when lib is product or project. */ $lib = $this->doc->getLibByID($doc->lib); $type = $lib->product ? 'product' : ($lib->project ? 'project' : 'custom'); $this->libs = $this->doc->getLibs($type); /* Set menu. */ $this->doc->setMenu($this->libs, $doc->lib, $type); $this->view->title = "DOC #$doc->id $doc->title - " . $this->libs[$doc->lib]; $this->view->position[] = html::a($this->createLink('doc', 'browse', "libID=$doc->lib"), $this->libs[$doc->lib]); $this->view->position[] = $this->lang->doc->view; $this->view->doc = $doc; $this->view->lib = $lib; $this->view->type = $type; $this->view->version = $version ? $version : $doc->version; $this->view->actions = $this->loadModel('action')->getList('doc', $docID); $this->view->users = $this->user->getPairs('noclosed,noletter'); $this->view->preAndNext = $this->loadModel('common')->getPreAndNextObject('doc', $docID); $this->view->keTableCSS = $this->doc->extractKETableCSS($doc->content); $this->display(); } /** * Diff doc. * * @param int $docID * @param int $newVersion * @param int $oldVersion * @access public * @return void */ public function diff($docID, $newVersion, $oldVersion = '') { if(empty($oldVersion)) $oldVersion = $newVersion - 1; if(empty($oldVersion) or empty($newVersion)) die(js::error($this->lang->doc->versionNotFound) . js::locate('back')); $newDoc = $this->doc->getById($docID, $newVersion, true); $oldDoc = $this->doc->getById($docID, $oldVersion, true); if(!$newDoc) die(js::error($this->lang->notFound) . js::locate('back')); /* Merge files in doc. */ $dbOldDocFiles = $this->dao->select('files')->from(TABLE_DOCCONTENT)->where('doc')->eq($docID)->andWhere('version')->eq($oldVersion)->fetch('files'); $dbOldDocFiles = explode(',', $dbOldDocFiles); sort($dbOldDocFiles); $oldDocFiles = array(); foreach($dbOldDocFiles as $fileID) { $file = isset($oldDoc->files[$fileID]) ? $oldDoc->files[$fileID] : ''; $oldDocFiles[$fileID] = 'File #' . $fileID; if($file) $oldDocFiles[$fileID] .= ' ' . $file->title . '.' . $file->extension; } $oldDoc->files = join("\n", $oldDocFiles); $dbNewDocFiles = $this->dao->select('files')->from(TABLE_DOCCONTENT)->where('doc')->eq($docID)->andWhere('version')->eq($newVersion)->fetch('files'); $dbNewDocFiles = explode(',', $dbNewDocFiles); sort($dbNewDocFiles); $newDocFiles = array(); foreach($dbNewDocFiles as $fileID) { $file = isset($newDoc->files[$fileID]) ? $newDoc->files[$fileID] : ''; $newDocFiles[$fileID] = 'File #' . $fileID; if($file) $newDocFiles[$fileID] .= ' ' . $file->title . '.' . $file->extension; } $newDoc->files = join("\n", $newDocFiles); /* Get diff. */ $diff = new stdclass(); $diff->content = $this->doc->diff($oldDoc->content, $newDoc->content); $diff->digest = $this->doc->diff($oldDoc->digest, $newDoc->digest); $diff->files = $this->doc->diff($oldDoc->files, $newDoc->files); /* Check priv when lib is product or project. */ $lib = $this->doc->getLibByID($newDoc->lib); $type = $lib->product ? 'product' : ($lib->project ? 'project' : 'custom'); $this->libs = $this->doc->getLibs($type); /* Set menu. */ $this->doc->setMenu($this->libs, $newDoc->lib, $type); $this->view->title = "DOC #$newDoc->id $newDoc->title - " . $this->libs[$newDoc->lib]; $this->view->position[] = html::a($this->createLink('doc', 'browse', "libID=$newDoc->lib"), $this->libs[$newDoc->lib]); $this->view->position[] = $this->lang->doc->view; $this->view->newDoc = $newDoc; $this->view->oldDoc = $oldDoc; $this->view->docID = $docID; $this->view->lib = $lib; $this->view->type = $type; $this->view->newVersion = $newVersion; $this->view->oldVersion = $oldVersion; $this->view->diff = $diff; $this->display(); } /** * Delete a doc. * * @param int $docID * @param string $confirm yes|no * @access public * @return void */ public function delete($docID, $confirm = 'no') { if($confirm == 'no') { die(js::confirm($this->lang->doc->confirmDelete, inlink('delete', "docID=$docID&confirm=yes"))); } else { $this->doc->delete(TABLE_DOC, $docID); /* if ajax request, send result. */ if($this->server->ajax) { if(dao::isError()) { $response['result'] = 'fail'; $response['message'] = dao::getError(); } else { $response['result'] = 'success'; $response['message'] = ''; } $this->send($response); } die(js::locate($this->session->docList, 'parent')); } } /** * Ajax get drop menu. * * @param int $productID * @param string $module * @param string $method * @param string $extra * @access public * @return void */ public function ajaxGetDropMenu($libID, $module, $method, $extra) { $this->view->link = $this->doc->getDocLink($module, $method, $extra); $this->view->libID = $libID; $this->view->module = $module; $this->view->method = $method; $this->view->extra = $extra; $this->view->libs = $this->doc->getLibs($extra); $this->display(); } /** * The results page of search. * * @param string $keywords * @param string $module * @param string $method * @param mix $extra * @access public * @return void */ public function ajaxGetMatchedItems($keywords, $module, $method, $extra) { $libs = $this->dao->select('*')->from(TABLE_DOCLIB)->where('deleted')->eq(0) ->andWhere('name')->like("%$keywords%") ->beginIF($extra == 'product' or $extra == 'project')->andWhere($extra)->ne(0)->fi() ->orderBy('`id` desc') ->fetchAll(); foreach($libs as $key => $lib) { if(!$this->doc->checkPriv($lib)) unset($libs[$key]); } $this->view->link = $this->doc->getDocLink($module, $method, $extra); $this->view->libs = $libs; $this->view->keywords = $keywords; $this->display(); } /** * Ajax get modules by libID. * * @param int $libID * @access public * @return void */ public function ajaxGetModules($libID) { $moduleOptionMenu = $this->tree->getOptionMenu($libID, 'doc', $startModuleID = 0); die(html::select('module', $moduleOptionMenu, 0, "class='form-control'")); } /** * Ajax fixed menu. * * @param int $libID * @param string $type * @access public * @return void */ public function ajaxFixedMenu($libID, $type = 'fixed') { $customMenus = $this->loadModel('setting')->getItem("owner={$this->app->user->account}&module=common§ion=customMenu&key=doc"); if($customMenus) $customMenus = json_decode($customMenus); if(empty($customMenus)) { if($type == 'remove') die(js::reload('parent')); $i = 0; foreach($this->lang->doc->menu as $name => $item) { if($name == 'list') continue; $customMenu = new stdclass(); $customMenu->name = $name; $customMenu->order = $i; $customMenus[] = $customMenu; $i++; } } foreach($customMenus as $i => $customMenu) { if(isset($customMenu->buildLink) and strpos($customMenu->buildLink, "|libID=$libID") !== false) unset($customMenus[$i]); } $lib = $this->doc->getLibByID($libID); $customMenu = new stdclass(); $customMenu->name = "custom{$libID}"; $customMenu->buildLink = "$lib->name|doc|browse|libID=$libID"; $customMenu->order = count($customMenus); if($type == 'fixed') $customMenus[] = $customMenu; $this->setting->setItem("{$this->app->user->account}.common.customMenu.doc", json_encode($customMenus)); die(js::reload('parent')); } /** * Show all libs by type. * * @param string $type * @param string $extra * @param int $recTotal * @param int $recPerPage * @param int $pageID * @access public * @return void */ public function allLibs($type, $extra = '', $recTotal = 0, $recPerPage = 21, $pageID = 1) { $libName = isset($this->lang->doc->systemLibs[$type]) ? $this->lang->doc->systemLibs[$type] : $this->lang->doc->custom; $this->doc->setMenu(array($libName), 0, $type); $this->view->title = $libName; $this->view->position[] = $libName; /* Load pager. */ $this->app->loadClass('pager', $static = true); $pager = new pager($recTotal, $recPerPage, $pageID); $libs = $this->doc->getAllLibs($type, $pager, $extra); $subLibs = array(); if($type == 'product' or $type == 'project') $subLibs = $this->doc->getSubLibGroups($type, array_keys($libs)); if($extra) { parse_str($extra); if(isset($product)) $this->view->product = $this->product->getById($product); } $this->view->type = $type; $this->view->libs = $libs; $this->view->subLibs = $subLibs; $this->view->pager = $pager; $this->view->extra = $extra; $this->display(); } /** * Show files for product or project. * * @param int $type * @param int $objectID * @access public * @return void */ public function showFiles($type, $objectID) { $uri = $this->app->getURI(true); $this->app->session->set('taskList', $uri); $this->app->session->set('storyList', $uri); $this->app->session->set('docList', $uri); $table = $type == 'product' ? TABLE_PRODUCT : TABLE_PROJECT; $object = $this->dao->select('id,name')->from($table)->where('id')->eq($objectID)->fetch(); $this->doc->setMenu(array($this->lang->doclib->files), 0, $type); $this->view->title = $object->name; $this->view->position[] = $object->name; $this->view->type = $type; $this->view->object = $object; $this->view->files = $this->doc->getLibFiles($type, $objectID); $this->display(); } }