简单明了的TestLink配置手册

　 4、产生的文档

　　下面的字符串被用来在打印文档的首页，左边空白就是无效。

　　$tlCfg->document_generator->company_name = 'Your Company';

　　$tlCfg->document_generator->company_copyright = '2008 (c) TestLink Community';

　　$tlCfg->document_generator->confidential_msg = 'GPL';

　　打印的文档有自己的设计模板，你可以修改CSS模板为你自己的，

　　$tlCfg->document_generator->css_template = $tlCfg->theme_dir .'css/tl_documents.css';

　　测试用例版本可以被包含在产生的文档中，带着测试用例标题。

　　$tlCfg->document_generator->tc_version_enabled = FALSE;

　 　5、发送Email

　　Testlink已经整合了邮件系统，支持发送报告和通知，你必须设置下列值：

　　SMTP服务器发送产生的Email，值‘localhost’在大多数例子里都足够了。

　　$g_smtp_host = 'localhost';

　　管理员和发送者的Email地址也是强制性字段。

　　$g_tl_admin_email = 'your.name@your_company.com'; # for problem/error notification

　　$g_from_email = 'no_replay@testlink.test_team'; # email sender (showed to recipient)

　　$g_return_path_email = 'your.name@your_company.com';

　　你可以选择性的设置Email的优先级，5是默认的。

　　# Urgent = 1, Not Urgent = 5, Disable = 0

　　$g_mail_priority = 5;

　　你的SMTP服务器应该需要登录来relayemali。在多数case里值是空的。

　　$g_smtp_username = '';

　　$g_smtp_password = '';

　　 6、用户认证

　　Testlink支持两种验证方式， ‘MD5′ – 使用存储在内部数据库中的加密口令。’LDAP’ – 使用来自目录服务器的口令。

　　$tlCfg->authentication['method']= 'MD5';（默认，也可设置为‘’，‘md5’,’ldap’）

　 　使用ldap验证的相关字段:

　　$tlCfg->authentication['ldap_server'] = 'localhost';

　　$tlCfg->authentication['ldap_port'] = '389';

　　$tlCfg->authentication['ldap_version'] = '3';

　　$tlCfg->authentication['ldap_root_dn'] = 'dc=mycompany,dc=com';

　　$tlCfg->authentication['ldap_organization'] = ''; // e.g.

　　'(organizationname=*Traffic)'

　　$tlCfg->authentication['ldap_uid_field'] = 'uid';

　　$tlCfg->authentication['ldap_bind_dn'] = '';

　　$tlCfg->authentication['ldap_bind_passwd'] = '';

　 　登录相关配置：

　　Testlink允许新用户创建默认角色的帐号，通过在登录页面的“New User”的链接。它加速了用户的管理步骤，管理员可以通过设置下列字段为false，来使这个特性为无效，以完全在系统中控制用户。

　　$tlCfg->user_self_signup = TRUE;

　　注意：如果你改变了这个字段，你肯想要更新$TLS_valid_user_name_format字符串，它在语言文件中，来解释你在页面上使用的规则。

　　$tlCfg->validation_cfg->user_login_valid_regex='/^[\w \-]+$/';

　　常规表达式也被用来在有效用户的email地址：

　　$tlCfg->validation_cfg->user_email_valid_regex = "/^([\w]+)(.[\w]+)*@([\w-]+\.){1,5}([A-Za-z]){2,4}$/";

　　配置下列字段来显示配置检查的结果：

　　$tlCfg->show_config_check_warning = FALSE;

　　True：消息显示在登录和testlink桌面上

　　False：一个两行的消息显示，以文件的检查结果的形式指示。

　　 7、GUI 定制

　　7.1、树形菜单

　　可能值有：’EXTJS’, ‘LAYERSMENU’,'DTREE’, ‘JTREE’，EXTJS是默认值，我们推荐它。这个组件有最好的性能，因为他使用的是异步通信。

　　$tlCfg->treemenu_type = 'EXTJS';

　　所有类型的节点（test case，test suite）被加入以排序号码“0”，当创建一个树节点时。它的最初显示顺序是根据节点ID来的。一个父test suite拥有下个默认值来分割子test suite 和test case。这些值必须是>=0.

　　$tlCfg->treemenu_default_testsuite_order = 1;

　　$tlCfg->treemenu_default_testcase_order = 100;

　　在树形菜单中显示或隐藏test case 的唯一ＩＤ：

　　$tlCfg->treemenu_show_testcase_id = TRUE;

　　允许在树形菜单上，根据状态计数test case。

　　$tlCfg->exec_cfg->enable_tree_testcase_counters = ENABLED;

　　 7.2、GUI 布局

　　gui/themes/default/.——主题目录，包含css和图片文件。

　　你应该拷贝默认目录，修改内容和设置下列字段指向它。

　　$tlCfg->theme_dir = 'gui/themes/your_theme/';

　　你可以通过写你自己的CSS文件来改变testlink外观。

　　testlink.css (主风格定义)

　　tl_print.css (打印页面的风格设置)

　　tl_documents.css (用于产生的文档，像测试规约)

　　tl_treemenu.css (树形菜单的特殊设置)

　　这些文件名被作为常量定义在const.inc.php文件中，你可以根据需要修改。

　　如果你要设计你自己的logo，那么拷贝图片到gui/themes/default/images/目录，

　　$tlCfg->company_logo = ‘company_logo.png’;

　　 注意：这个logo将被用在所有的GUI和产生的文档中。

　　登录页面可以显示信息文本，以html格式，这个值默认是空的。

　　$tlCfg->login_info = 'Please, contact administrator G. B. Shaw if you have any question.';

　　你可以修改弹头图标的文件名，默认包含arrow_org.gif and slide_gripper.gif。

　　$tlCfg->bullet_image = 'slide_gripper.gif';

　　指定test project背景颜色：

　　$tlCfg->gui->testproject_coloring = 'background';

　　打开页面，编辑test project到指定的特殊颜色，默认值是“none”（没有背景颜色的改变是允许的）。默认背景颜色是：

　　$tlCfg->gui->background_color = '#9BD';

　　设置显示姓名来代替只显示login，指定一种显示格式：

　　$tlCfg->username_format = '%login%';

　　Examples:

　　'%first% %last%' -> John Cook

　　'%last%, %first%' -> Cook, John

　　'%first% %last% %login%' -> John Cook [ux555]

　　配置默认导航框在窗口左边的宽。

　　$tlCfg->frame_workarea_default_width = "30%";

　　Test project复选框在顶部菜单的顺序是可以配置的了，值必须是SQL支持的。

　　$tlCfg->gui->tprojects_combo_order_by='ORDER BY nodes_hierarchy.id DESC';

　　Examples:

　　'ORDER BY name'

　　'ORDER_BY nodes_hierarchy.id DESC' -> similar effect to order last created first

　　管理者可以配置在主页导航主题的配置：

　　$tlCfg->gui->layoutMainPageLeft = array( 'testProject' => 1,

　　'userAdministration' => 2 , 'requirements' => 3, 'testSpecification' => 4);

　　$tlCfg->gui->layoutMainPageRight = array( 'testPlan' => 1, 'testExecution' => 2 ,'testPlanContents' => 3);

　　配置度量的仪表盘上的圆的百分比：

　　$tlCfg->dashboard_precision = 2;

　　控制一些GUI元素的有效性，你可以使他们无效来提高页面描述性能，

　　$tlCfg->gui->round_corners->exec_history = ENABLED;

　　$tlCfg->gui->round_corners->tc_title = ENABLED;

　　$tlCfg->gui->round_corners->tc_spec = ENABLED;

　　7.3、文本域编辑

　　文本数据编辑通过Javascript编辑器解决，它在文本域的工具栏，配置被下列数组定义

　　$tlCfg->gui->text_editor = array();

　　FCKeditor组件默认被使用，这是一个很有特色的组件，可以很容易的通过配置提高。

　　$tlCfg->gui->text_editor['all'] = array(

　　'type' => 'fckeditor',

　　'toolbar' => 'tl_default',

　　'configFile' => 'cfg/tl_fckeditor_config.js',

　　);

　　如果在这个结构中没有带搜索键的元素被发现，那么这个配置将被使用。每个元素与下列配置关键字对应：

　　字段’type’ = ‘fckeditor’, ‘tinymce’ 或是’none’ -> 使用文本域输入字段

　　下面这行修改用于所有地方的文本域：

　　$tlCfg->gui->text_editor['all'] = array( 'type' => 'none');

　　FCKeditor工具栏定义了在文本域菜单是否允许或是失效图标，我们推荐研究它。

　　默认的testlink工具栏定义是‘tl_default’。自定义工具栏的‘tl_default’定义在/cfg/tl_fckeditor_config.js文件中。你可以向对其他配置字段一样修改工具栏内容，（像templates, styles, spell checker等）。

　　字段‘configFile’只对type = ‘fckeditor’的应用有效，例如，下面的属性就是被这些字段定义的：

　　'height': FCKEditor的高

　　'width':  FCKEditor的宽

　　'cols':    tinymce and none的列数量

　　'rows':   tinymce and none的行数量

　　提示：在做了配置修改后，清你的浏览器cookies和缓存

　　// $tlCfg->gui->text_editor['execution'] = array( 'type' => 'none'); // BETTER

　　Performance with a lot of testcases

　　//

　　// This configuration is useful only if default type is set to 'fckeditor'

　　// $tlCfg->gui->text_editor['design'] = array('toolbar' => 'tl_mini');

　　//

　　// $tlCfg->gui->text_editor['testplan'] = array( 'type' => 'none');

　　// $tlCfg->gui->text_editor['build'] = array( 'type' => 'fckeditor','toolbar' =>

　　'tl_mini');

　　// $tlCfg->gui->text_editor['testproject'] = array( 'type' => 'tinymce');

　　// $tlCfg->gui->text_editor['role'] = array( 'type' => 'tinymce');

　　// $tlCfg->gui->text_editor['requirement'] = array( 'type' => 'none');

　　// $tlCfg->gui->text_editor['requirement_spec'] = array( 'type' => 'none');

　　性能警告：问题是fckeditor使用iframe，并且每个iframe需要下载fckeditor文件，所以可能会有一些页面有装在问题。

　　在fckeditor中打开图片装载

　　这个指导面向FCKEditor 2.3.2，但对别的版本也是有效的。

　　打开FCKEditor/fckconfig.js，确定默认的php连接被选择。