|
楼主 |
发表于 2003-5-7 04:05:57
|
显示全部楼层
[code:1]· mainfile.php中的函数与用途
· is_admin()函数
站长安全检核函数,只要在其他程式中以is_admin($admin)叫用即可检查是否登入为站。
回传值∶真(1)、伪(0)
使用前,记得该程式已宣告global $admin;
· is_user()函数
这个函数即为判别是否登入会员,使用前先宣告global $user;
常见的用法:
global $user;
if (is_user($user)) {
do_something;
}
可做为自制外挂php网页的存取权限管制.或者加上某些模组index.php前头,管制module区分使用者开放与否.
· message_box()函数
产生首页上方正中间的 message, 翻译上有说"通知"、"公告",它的管理程式虽把资料写入到资料库中.
可是网页输出上并非交由theme 来负责,所以,如果,你必须修改以配合theme的色调或显示表格大小的话,必须直接到此函数中来修改.
· selectlanguage()函数
产生语系选择区块,它会自动搜寻 languages目录中的语系档,建立语系资料以供选择.
PHP-Nuke 6.0 起这个语系选择区块改成档案型区块, 置於 blocks/block-Language.php, 供不需支援多语系者可关闭或删除之.
· get_lang($module) 函数
get_lang($module) 函数是每一个功能模组的共用函数, 它会根据选用语系, 依当时执行或传入参数的模组名称, 自动去含括 modules/......../language/lang-xxxx.php
[ 回到顶端 ]
· title($text) 函数
此函数仅供传入 $text 产生一行置中的标题之用, 做为每个功能模组呼叫使用.
如果改变这个函数内容,对全站的小标题都产生效果.(前提: 模组中都叫用这个函数来产生小标题, 有些旧模组还没有全部改用此函数, 就要自己改一下了)
· is_active($module) 函数
is_active($module) 函数依参数检查 $module 这一个功能模组是否处於启用状态
很实用的函数,例如在会员首页要不要秀出 WebMail 和 Private Message 图示供会员使用, 就要使用 is_active() 函数检查这两个模组是否启用.
is_active() 回传布林真伪值.
· online() 函数
在网站根目录的 header.php 中叫用此 online() 函数, 用途在取得 30 分钟内的站上人数(会员与非会员) , 写入到 nuke_session 资料表中.
这项资料也是 Who's Online 区块所显示资料的来源.
如果要改变线上人数的计算时间由 30 分钟缩短为 5 分钟, 就可以修改此函数中的 $past = time()-1800; 为 $past = time()-300;
· getusrinfo($user) 函数
会员登入之後会产生一个 cookie , 此一函数读取会员的 cookie 比对资料库中的会员帐号与密码, 正确後取出会员的帐号资料, 再以阵列传回会员资料.
这里的会员资料当然就包括 选用 theme , comment 显示与否, 首页新闻显示篇数 , 会员自订区块等等
· check_words($Message) 函数
脏话过滤, 依据 config.php 中的 $CensorList 阵列检查, 并过滤以其他字元替代.
· check_html() 函数
过滤网友张贴文字内的 html 标签, 用於 Submit News 和 comment 时.
允许使用的 html 标签定义在 config.php 档中的 $AllowableHTML 阵列.
· filter_text() 函数
叫用前述两个函数, 接连做脏话过滤与 html 标签过滤
· formatTimestamp($time) 函数
转换 unix timestamp 为日期字串, 传回型如 Mar, 09 2003 的格式, 格式来自於 language/lang-xxxx.php 中的设定.[/code:1] |
|