在 x2.0 中增加了关联链接，可以在指定范围内把 指定的文字 加上链接。
在 后台->运营->关联链接 处设置。
这里可以直接 添加、删除、更新 关联链接，并且可以选择该链接分别在 文章、论坛主题、群组主题、日志 中是否启用。
我们分析下这个代码的执行过程。
首先这个功能的路径是 /admin.php?action=misc&operation=relatedlink ，
我们根据这个链接可以定位到代码在 /source/admincp/admincp_misc.php 中，打开这个文件，搜 relatedlink
} elseif($operation == 'relatedlink') {
if(!submitcheck('linksubmit')) {
?>
<script type=text/javascript>
var rowtypedata = [
[
[1,'', 'td25'],
[1,'<input type=text class=txt name=newname[] size=15>'],
[1,'<input type=text name=newurl[] size=50>'],
[1,'<input class=checkbox type=checkbox value=1 name=newarticle[]>'],
[1,'<input class=checkbox type=checkbox value=1 name=newforum[]>'],
[1,'<input class=checkbox type=checkbox value=1 name=newgroup[]>'],
[1,'<input class=checkbox type=checkbox value=1 name=newblog[]>']
]
]
</script>
<?php
shownav('extended', 'misc_relatedlink');
showsubmenu('nav_misc_relatedlink');
/*search={misc_relatedlink:action=misc&operation=relatedlink}*/
showtips('misc_relatedlink_tips');
/*search*/
showformheader('misc&operation=relatedlink');
showtableheader();
showsubtitle(array('', 'misc_relatedlink_edit_name', 'misc_relatedlink_edit_url', '<input class=checkbox type=checkbox name=articleall>'.cplang('misc_relatedlink_extent_article'), '<input class=checkbox type=checkbox name=forumall>'.cplang('misc_relatedlink_extent_forum'), '<input class=checkbox type=checkbox name=groupall>'.cplang('misc_relatedlink_extent_group'),'<input class=checkbox type=checkbox name=blogall>'.cplang('misc_relatedlink_extent_blog')));
$query = db::query(select * from .db::table('common_relatedlink'). order by id desc);
while($link = db::fetch($query)) {
$extent = sprintf('%04b', $link['extent']);
showtablerow('', array('class=td25', '', '', 'class=td26', 'class=td26', 'class=td26', ''), array(
'<input type=checkbox class=checkbox name=delete[] value='.$link['id'].' />',
'<input type=text class=txt name=name['.$link[id].'] value='.$link['name'].' size=15 />',
'<input type=text name=url['.$link[id].'] value='.$link['url'].' size=50 />',
'<input class=checkbox type=checkbox value=1 name=article['.$link[id].'] '.($extent[0] ? checked : '').'>',
'<input class=checkbox type=checkbox value=1 name=forum['.$link[id].'] '.($extent[1] ? checked : '').'>',
'<input class=checkbox type=checkbox value=1 name=group['.$link[id].'] '.($extent[2] ? checked : '').'>',
'<input class=checkbox type=checkbox value=1 name=blog['.$link[id].'] '.($extent[3] ? checked : '').'>',
));
}
echo '<tr><td></td><td colspan=6><div><a href=### class=addtr>'.$lang['misc_relatedlink_add'].'</a></div></td></tr>';
showsubmit('linksubmit', 'submit', 'del');
showtablefooter();
showformfooter();
} else {
if($_g['gp_delete']) {
db::delete('common_relatedlink', id in (.dimplode($_g['gp_delete']).));
}
if(is_array($_g['gp_name'])) {
foreach($_g['gp_name'] as $id => $val) {
$extent_str = intval($_g['gp_article'][$id]).intval($_g['gp_forum'][$id]).intval($_g['gp_group'][$id]).intval($_g['gp_blog'][$id]);
$extent_str = intval($extent_str, '2');
db::update('common_relatedlink', array(
'name' => $_g['gp_name'][$id],
'url' => $_g['gp_url'][$id],
'extent' => $extent_str,
), array(
'id' => $id,
));
}
}
if(is_array($_g['gp_newname'])) {
foreach($_g['gp_newname'] as $key => $value) {
if($value) {
$extent_str = intval($_g['gp_newarticle'][$key]).intval($_g['gp_newforum'][$key]).intval($_g['gp_newgroup'][$key]).intval($_g['gp_newblog'][$key]);
$extent_str = intval($extent_str, '2');
db::insert('common_relatedlink', array(
'name' => $value,
'url' => $_g['gp_newurl'][$key],
'extent' => $extent_str,
));
}
}
}
updatecache('relatedlink');
cpmsg('relatedlink_succeed', 'action=misc&operation=relatedlink', 'succeed');
} 当直接打开这个页面的时候，就是显示默认的已经存在的关联链接。
当点击 提交 的时候，会做三个处理。
1.删除处理
如果提交之前，把某些关联链接前的 删除 勾打上的话，那么这里会先处理 删除 的操作。
代码为：
if($_g['gp_delete']) {
db::delete('common_relatedlink', id in (.dimplode($_g['gp_delete']).));
}
2.更新操作
如果在操作之前，已经存在的关联链接被修改过，那么在提交的时候，这些链接会先做下更新。
对应的代码为：
if(is_array($_g['gp_name'])) {
foreach($_g['gp_name'] as $id => $val) {
$extent_str = intval($_g['gp_article'][$id]).intval($_g['gp_forum'][$id]).intval($_g['gp_group'][$id]).intval($_g['gp_blog'][$id]);
$extent_str = intval($extent_str, '2');
db::update('common_relatedlink', array(
'name' => $_g['gp_name'][$id],
'url' => $_g['gp_url'][$id],
'extent' => $extent_str,
), array(
'id' => $id,
));
}
}
3.新添加的操作
在提交前，如果有新添加的管链链接，则会执行相应的代码插入到数据中。
对应的代码为：
if(is_array($_g['gp_newname'])) {
foreach($_g['gp_newname'] as $key => $value) {
if($value) {
$extent_str = intval($_g['gp_newarticle'][$key]).intval($_g['gp_newforum'][$key]).intval($_g['gp_newgroup'][$key]).intval($_g['gp_newblog'][$key]);
$extent_str = intval($extent_str, '2');
db::insert('common_relatedlink', array(
'name' => $value,
'url' => $_g['gp_newurl'][$key],
'extent' => $extent_str,
));
}
}
} 需要注意的时候，不管是更新还是新添加， 关联链接 在进入数据库之前，关于在那些模块启用的地方，都用了二进制形式来控制在那里显示，然后再变为 10 进制存的。
存储完以后，紧跟着做了缓存的更新，对应的代码是：
updatecache('relatedlink'); 关于的缓存的更新，需要查看 /source/function/function_cache.php
然后调用了 /source/function/cache/cache_relatedlink.php
function build_cache_relatedlink() {
global $_g;
$data = array();
$query = db::query(select * from .db::table('common_relatedlink'));
while($link = db::fetch($query)) {
if(substr($link['url'], 0, 7) != 'http://') {
$link['url'] = 'http://'.$link['url'];
}
$data[] = $link;
}
save_syscache('relatedlink', $data);
}
从这里能看到，最后缓存存到了 pre_common_syscache 中，其中 cname 就是 relatedlink 。
我们在看下前台发帖子等时候，使用我们刚刚添加的 关联链接的情况。
当我们查看帖子的时候，执行的文件是 /source/module/forum/forum_viewthread.php 文件。
在这个文件中，先得到设置在帖子中显示的关联链接，相应的代码是：
if(!defined('in_archiver')) {
$post['message'] = discuzcode($post['message'], $post['smileyoff'], $post['bbcodeoff'], $post['htmlon'] & 1, $_g['forum']['allowsmilies'], $_g['forum']['allowbbcode'], ($_g['forum']['allowimgcode'] && $_g['setting']['showimages'] ? 1 : 0), $_g['forum']['allowhtml'], ($_g['forum']['jammer'] && $post['authorid'] != $_g['uid'] ? 1 : 0), 0, $post['authorid'], $_g['cache']['usergroups'][$post['groupid']]['allowmediacode'] && $_g['forum']['allowmediacode'], $post['pid']);
if($post['first']) {
if(!$_g['forum_thread']['isgroup']) {
$_g['relatedlinks'] = getrelatedlink('forum');
} else {
$_g['relatedlinks'] = getrelatedlink('group');
}
}
}
把得到的 关联链接 存放到了全局变量 $_g 中，然后在 模板文件 中使用。
显示帖子的时候调用的模板文件是：/template/default/forum/viewthread.htm 文件。
这个文件相关的代码为：
<!--{if $_g['relatedlinks']}-->
<div style=display: none>
<ul>
<!--{loop $_g['relatedlinks'] $key $link}-->
<li><a id=relatedlink_$key href=$link[url]>$link[name]</a></li>
<!--{/loop}-->
</ul>
</div>
<script type=text/javascript>relatedlinks('postmessage_$_g[forum_firstpid]');</script>
<!--{/if}-->
然后执行了 js 的 relatedlinks 函数，该函数在 /static/js/common.js
通过这个文件中的 js 方法，使得 关联链接 在页面中显示。