【UCHome二次开发】资料整理<上>
目录
【UCHome二次开发】uchome文件体系介绍
【UCHome二次开发】基础
【UCHome二次开发】common.php文件解析
【UCHome二次开发】 不同于Manyou的开发模式
【UCHome二次开发】模板机制
【UCHome二次开发】数据字典|数据库结构
【UCHome二次开发】模板解析
【UCHome二次开发】缓存机制解析
【UCHome二次开发】模板语法说明
【UCHome二次开发】模板页面说明
【UCHome二次开发】主要文件说明
【UCHome二次开发】模板修改
【UCHome二次开发】功能修改
【UCHome二次开发】全局变量
【UCHome二次开发】与UCenter的交互解析
【UCHome应用】增加sns人气的客服秘籍
【UCHome二次开发】uchome文件体系介绍
站点结构图
UCHOME安装后的主要目录与文件介绍：
|
目录 |
文件介绍 |
|
admin/ |
管理后台 |
|
api/ |
API函数[插件开发与模板等的修改不需要动此文件] |
|
attachment/ |
附件目录 |
|
data/ |
缓存目录，此目录要有777权限，系统相关缓存基本上都在这里了 |
|
data/tpl_cache/ |
模板缓存目录，注意，如果你的UCH白屏了，无法进入后台跟新缓存，通过FTP手工删除此目录下的所有文件即可相当于模板缓存的更新 |
|
image/ |
图片目录 |
|
language/ |
语言目录 ，跳转提示语言等 |
|
source/ |
PHP源程序目录 |
|
template/ |
模板目录 |
|
theme/ |
个人主页目录 |
|
uc_client/ ucenter |
客户端 [插件开发与模板等的修改不需要动此文件] |
|
Install |
安装时用到，安装完毕建议删除 |
|
|
|
以下是UCHOME根目录下常用文件【不常用的不在介绍】
|
常用文件 |
文件介绍 |
|
admincp.php |
后台管理入口文件 |
|
common.php |
通用文件，所有的文件都要包含这个文件 |
|
config.php |
基本配置文件 |
|
cp.php |
编辑日志、相册、活动等等相关编辑操作基本上都从这个文件入口 |
|
do.php |
登录、注册、找回密码、相册批量上传、在需要密码的情况下才能查看日志相册、验证码、发送邮件、统计、邮件验证等行为的入口文件 |
|
editor.php |
编辑器的入口文件，强烈建议您不用动他 |
|
magic.php |
道具入口文件 |
|
network.php |
随便看看等入口文件 |
|
space.php |
个人空间、日志、相册、活动等入口文件 |
数据调用图示
我们一般修改UCH主要涉及的入口文件有space.php network.php do.php cp.php 这四个，那么我们如何根据你访问的URL判断涉及到那些PHP文件和模板文件，方便您的进一步修改！
好了，现在我们以最简单的do.php入口文件来分析下，
举个例子，如果我们使用找回密码功能，通常链接如下：do.php?ac=lostpasswd，而注册的链接一般分两种，一种是do.php?ac=后台自定义登录识别名
另一种是do.php?ac=随机
好了，我们进入do.php文件中继续看看：
//这个是公用文件，在上篇已详细解释了内容
include_once(’./common.php’);
//获取方法 获取do.php?ac中ac的值
$ac = empty($_GET['ac'])?”:$_GET['ac'];
//自定义登录
if($ac == $_SCONFIG['login_action']) {
//这里的全局变量$_SCONFIG['login_action']就是ac=自定义标示名或那个随机串，如果相同则把原来的do.php?ac=XXXX抓换成类似效果do.php?ac=login
$ac = ‘login’;
} elseif($ac == ‘login’) {
ac = ‘’;
}
if($ac == $_SCONFIG['register_action']) {
//这里的全局变量$_SCONFIG['register_action']
//就是ac=就是后面的自定义标示名或那个随机串，如果相同则把原来的do.php?ac=XXXX抓换成类似效果do.php?ac=register
$ac = ‘register’;
} elseif($ac == ‘register’) {
$ac = ”;
}
//允许的方法
//这里很重要，login对应的是登录，register定义的是注册,lostpasswd定义的是找回密码，与上面访问的URL是否是对应上了
//对应上面的do.php?ac=login,do.php?ac=register,do.php?ac=lostpasswd,其他类似！如果ac后的参数不在下面的数组中，则为非法。跳转到首页
$acs = array(’login’, ‘register’, ‘lostpasswd’, ’swfupload’, ‘inputpwd’,‘ajax’, ’seccode’, ’sendmail’, ’stat’, ‘emailcheck’);
if(empty($ac) || !in_array($ac, $acs)) {
showmessage(’enter_the_space’, ‘index.php’, 0);
}
//链接
$theurl = ‘do.php?ac=’.$ac;
//这是包含文件的意思，继续执行一下文件的意思，
//其中S_ROOT是UCHOME安装目录的常量
//根据下面的语句，我们可以这样判断，如果链接是do.php?ac=lostpasswd的话，程序继续执行source/do_lostpasswd.php文件！
include_once(S_ROOT.’./source/do_’.$ac.’.php’);
不知道大家是否能理解，不理解多看几遍！
好了，我们找到source/do_lostpasswd.php文件看下，这个文件代码较多，我们不用管他，最主要的是我们要找到其对应的模板，
查找下include template这个语句【注：在其他php文件中可能有多个结果，那是因为不同条件下包含不同的模板】。你就会发现在末尾找到
include template(’do_lostpasswd’);
这就是模板名，这个记住规则，do_lostpasswd对应的模板是do_lostpasswd.htm名。那么这个文件在哪个位置呢？
我们系统目录template/下有 默认的default,blue,green这三个文件夹，对应不同的风格，如果你安装了其他风格，可能还有其他目录。
系统是如何查找do_lostpasswd.htm呢？
大家记得在后台有一个模板选择的下拉表吗？系统会在你选择的模板风格文件夹下查找do_lostpasswd.htm，如果找不到则在去default目录下查找。
注意: 为了提供效率，模板并不是每次都编译的，严格的来说，UCHOME会先判断对应的模板是否被解析过了【查找data/tpl_cache/目录下是否有对应的模板缓存】
如果没有的话才会去按上面的规则去查找。
基本上，按照以上思路就可以根据链接找到匹配的程序文件和模板文件了
下节我们将会介绍几个制作模板中实用的诀窍及模板的解析原理。如如何修改程序让UCHOME每次都重新解析模板，而不生成缓存！
【UCHome二次开发】基础
本文将就UCH二次开发这个核心主题，以各种实现的代码为主，辅助部分说明概略的讲解如何针对UCH进行二次开发。过段时间UCH就开源了，准备到时候再详细的写篇UCH机制分析。
顺便说下，这篇文件写在大约两周以前，但是一直没有时间整理发布，今天听说UCH会在最近一段时间开源，到时候再发反而对大家帮助不大，所以决定不再整理，虽然文中一些说明还不详细，但是已经基本成文。
数据调用
这里的数据调用是使用UCenter Home内置的数据调用，在后台的“高级应用”里有“数据调用”管理，以下代码都是在模板中添加，然后调用数据。
1.站内数据调用
<!–{template data/blocktpl/1}–>
2.站外JS调用
<script language=”javascript” type=”text/javascript” src=”http://www.ccvita.com/js.php?id=1″></script>
block的使用
这个block数据调用和前面的讲的数据调用，从数据来源和生成来说是基本类似的。
<!–block模块调用演示–>
<!–{block/sql/SELECT * FROM uchome_blog ORDER BY dateline DESC LIMIT 0，8/cachename/test/cachetime/0}–>
<!–{loop $_SBLOCK['test'] $value}–>
<li><a href=”space.php?uid=$value[uid]&do=blog&id=$value[blogid]“>$value[subject]</a></li>
<!–{/loop}–>
eval的使用
合理的使用Ucenter Home模板语法中的eval语法，会在一定程序上降低二次开发的难度。比如：
1.通过eval语法在模板内执行PHP语句
<!–eval用法演示–>
<!–{eval echo ‘<li><a href=”do.php?ac=demo”>最新日志演示</a> ‘;}–>
2.通过eval语法引入一个外部PHP文件
引入外部文件
<!–用eval来include外部文件–>
<!–{eval include ‘demo.php’}–>
备注：通过在模板中引入外部文件，你可做任何你想做的事情。
直接外部文件
do.php的扩展
1.首先，在do.php文件中添加允许的新方法，即在
$acs = array(’login’, ‘comment’, ‘wall’, ‘register’, ‘lostpasswd’, ’swfupload’, ‘inputpwd’,’sns’, ‘viewspace’, ‘relatekw’, ‘ajax’, ’seccode’);
之后添加
$acs[] = ‘demo’;
2.然后，在source目录下新建do_demo.php文件，调用地址就是do.php?ac=demo虽然UCH发布的文件是加密信息，但是我们从其已经开源的文件中可以得出进行UCH二次开发宝贵的信息。
比如/source/cron这个目录下以及source/class_mysql.php文件都是开源的，我们可以从中找出，对UCH进行二次开发非常有用的一些信息，比如如何进行SQL查询，通过分析，我们可以写出以下文件。
< ?php
!defined(’IN_UCHOME’) && exit(’Access Denied’);
$query = $_SGLOBAL['db']->query(’SELECT * FROM ‘.tname(’blog’).’ ORDER BY dateline DESC LIMIT 10′);
$bloglist = array();
while ($value = $_SGLOBAL['db']->fetch_array($query)) {
$bloglist[] = $value;
}
include template(’do_demo’);
?>
模板文件templates/default/do_demo.htm内容为
<!–{template header}–>
<div>
<div>
<div>
<ul>
<!–{loop $bloglist $value}–>
<li>
<div>
<h4><a href=”space.php?uid=$value[uid]&do=blog&id=$value[blogid]“>$value[subject]</a></h4>
<a href=”space.php?uid=$value[uid]“>$value[username]</a> <span><!–{date(’Y-m-d H:i’,$value[dateline])}–></span>
</div>
<div>
<!–{if $value[viewnum]}–><a href=”space.php?uid=$value[uid]&do=blog&id=$value[blogid]“>$value[viewnum] 次阅读</a><span>|</span><!–{/if}–>
<!–{if $value[replynum]}–><a href=”space.php?uid=$value[uid]&do=blog&id=$value[blogid]#comment”>$value[replynum] 个评论</a><!–{else}–>没有评论<!–{/if}–>
</div>
</li>
<!–{/loop}–>
</ul>
</div>
</div>
</div>
<!–{template footer}–>
总结
当前的UCH是在模板界面完全可修改，合理利用上述数据调用机制的情况下，鲜有我们不能实现的页面效果和数据调用要求。
【UCHome二次开发】common.php文件解析
使用UCHome插件的用户越来越多，但所有的站都使用同样的同样的程序，没有自己的特色是很难推广开的。同时不同的站需要不同的功能，同时同一个站在不同的时期也有不同的功能需求，鉴于此，本人通过多款插件的开发经验，对UCHome程序也有了一定的认识。为了感谢广大站长对我的插件的关心，本人开贴，对UCHome程序进行全面解析。主要分为程序篇和模板篇。请希望学习UCHome的会员关注此贴。
今天晚上准备第一章，
index.php文件第一行就是包含了
include_once(’./common.php’);
文件所以先对common.php文件解析：
<?php
/*
[UCenter Home] (C) 2007-2008 Comsenz Inc.
$Id: common.php 10981 2009-01-14 03:05:20Z liguode $
*/
//定义一个常量，用来在其他页面中，防止被恶意用户直接调用其他PHP文件。
@define(’IN_UCHOME’, TRUE);
//定义一个常量，这个常量表示版本号
define(’X_VER’, ‘1.5′);
//这个也是一个常量，次版本号
define(’X_RELEASE’, ‘20090114′);
/*定义程序的调试模式，在我们调试程序的时候将常量值设为1，这样程序出错的时候会在页面显示错误信息。
在调试完毕正常投入使用后设为0，这样程序出错不会显示给用户。
*/
define(’D_BUG’, ‘0′);
//通过D_BUG常量值指定错误报告类型。其中error_reporting()的参数是错误报告类型，相关参数可查询PHP手册
D_BUG?error_reporting(7):error_reporting(0);
//这下面都是定义的全局变量。具体的会在后面使用的时候一一介绍
$_SGLOBAL = $_SCONFIG = $_SBLOCK = $_TPL = $_SCOOKIE = $_SN = $space = array();
//定义程序目录常量。其中DIRECTORY_SEPARATOR是路径分隔符，linux上就是’/’ windows上是’\’
define(’S_ROOT’, dirname(__FILE__).DIRECTORY_SEPARATOR);
//加载基本的配置文件，用了@符号，达到找不到该文件时在页面不提示错误信息
if(!@include_once(S_ROOT.’./config.php’)) {
//如果找不到的话则重定向到安装文件
header(”Location: install/index.php”);
exit();
}
//通用函数文件，具体函数在介绍时间会一一解释
include_once(S_ROOT.’./source/function_common.php’);
//时间microtime()获取含毫秒的时间
$mtime = explode(’ ‘, microtime());
$_SGLOBAL['timestamp'] = $mtime[1];
//$mtime[0]为UNIX时间戳（整形）， $mtime[0]为毫秒
$_SGLOBAL['supe_starttime'] = $_SGLOBAL['timestamp'] + $mtime[0];
//get_magic_quotes_gpc检测PHP.INI配置中的魔术引号功能是否打开
$magic_quote = get_magic_quotes_gpc();
if(empty($magic_quote)) {
//如果自动过滤每打开，则对传入的参数进行转义
$_GET = saddslashes($_GET);
$_POST = saddslashes($_POST);
}
//货主站点的URL，其中getsiteurl()是用来获取当前站点的域名
if(empty($_SC['siteurl'])) $_SC['siteurl'] = getsiteurl();
//链接数据库
dbconnect();
//打开缓存文件
foreach (array(’config’, ‘app’, ‘userapp’, ‘ad’) as $value) {
if(!@include_once(S_ROOT.’./data/data_’.$value.’.php’)) {
//如果缓存文件打开失败重建缓存，function_cache.php是包含建立缓存的函数文件
include_once(S_ROOT.’./source/function_cache.php’);
$cache_func = $value.’_cache’;
//调用相应的函数来生成缓存。
$cache_func();
}
}
//获取COOKIE前缀的长度，$_SC['cookiepre']是在config.php中定义的COOKIE函数的前缀名称，$_COOKIE是存放COOKIE的数据全局变量数组
$prelength = strlen($_SC['cookiepre']);
foreach($_COOKIE as $key => $val) {
//判断当前域名下的COOKIE中属于UCHome的COOKIE
if(substr($key, 0, $prelength) == $_SC['cookiepre']) {
//对COOKIE值进行转义
$_SCOOKIE[(substr($key, $prelength))] = empty($magic_quote) ? saddslashes($val) : $val;
}
}
//是否启用GIP压缩传输，这个是用来提高PHP传输速度的。
if ($_SC['gzipcompress'] && function_exists(’ob_gzhandler’)) {
ob_start(’ob_gzhandler’);
} else {
ob_start();
}
//初始化
$_SGLOBAL['supe_uid'] = 0; //初始化当前用户的UID
$_SGLOBAL['supe_username'] = ”; //初始化当前用户的用户名
//这个是用来在页面中控制一些弹出框，在模板篇会介绍
$_SGLOBAL['inajax'] = empty($_GET['inajax'])?0:intval($_GET['inajax']); $_SGLOBAL['ajaxmenuid'] = empty($_GET['ajaxmenuid'])?”:$_GET['ajaxmenuid'];
//获得上一页的URL，用来跳转
$_SGLOBAL['refer'] = empty($_SERVER['HTTP_REFERER'])?”:$_SERVER['HTTP_REFERER'];
//登录注册防灌水机
/*
在登录或者注册的时候看到形如：do.php?ac=750e45d29d276b2f86f1445627c08f99的链接
后面的750e45d29d276b2f86f1445627c08f99就是用下面的来获取的。
*/
if(empty($_SCONFIG['login_action'])) $_SCONFIG['login_action'] = md5(’login’.md5($_SCONFIG['sitekey']));
if(empty($_SCONFIG['register_action'])) $_SCONFIG['register_action'] = md5(’register’.md5($_SCONFIG['sitekey']));
//整站风格，检查站点模板的路径。此处是default目录，就是我们常用黄色风格的模板路径
if(empty($_SCONFIG['template'])) {
$_SCONFIG['template'] = ‘default’;
}
//在首页由下角可以自行选择风格的实现就是通过这段。
if($_SCOOKIE['mytemplate']) {
$_SCOOKIE['mytemplate'] = str_replace(’.',”,trim($_SCOOKIE['mytemplate']));
if(file_exists(S_ROOT.’./template/’.$_SCOOKIE['mytemplate'].’/style.css’)) {
$_SCONFIG['template'] = $_SCOOKIE['mytemplate'];
} else {
ssetcookie(’mytemplate’, ”);
}
}
//处理REQUEST_URI，查询（query）的字符串（URL 中第一个问号 ? 之后的内容）。 如为空则为当前页面。
if(!isset($_SERVER['REQUEST_URI'])) {
$_SERVER['REQUEST_URI'] = $_SERVER['PHP_SELF'];
if(isset($_SERVER['QUERY_STRING'])) $_SERVER['REQUEST_URI'] .= ‘?’.$_SERVER['QUERY_STRING'];
}
//判断用户登录状态
checkauth();
//用户菜单
getuserapp();
//处理UC应用，这个是漫游相关菜单，在此不用解释
$_SGLOBAL['appmenus'] = $_SGLOBAL['appmenu'] = array();
if($_SGLOBAL['app']) {
foreach ($_SGLOBAL['app'] as $value) {
if($value['open']) {
if(empty($_SGLOBAL['appmenu'])) {
$_SGLOBAL['appmenu'] = $value;
} else {
$_SGLOBAL['appmenus'][] = $value;
}
}
}
}
?>
本文链接:http://witmax.cn/uchome-function-modify.html
http://wyoojune.blog.163.com/blog/static/5709332520107245941477/
浙公网安备 33010602011771号