cmssys.txt

为我们学校开发的一个住房货币化补贴工作的专题网站

注意：
1、PHP对大小写敏感，请注意本系统中的类名和函数名。
2、本系统中，并未对使用者的身份进行检查，用户自行在页面中加入或者直接填写入类中 。如果用户将相关功能添加到类中，请发送给作者本人一份（[e-mail]），修改者可以将自己的信息加入到文件头的系统版本说明之后（原有内容，请勿修改）。
3、因为新闻显示的可能性多种多样，所以本系统没有加入新闻显示的功能。不过用户依然可以通过Mysql类来简化此功能编写。

类说明：
这个CMSSYS系统主要三个类，FrontData，AdminData，Upload。其中FrontData类负责将数据库中的数据读出并在前台显示；AdminData类则负责后台管理系统的生成；特别的，上传功能较为特别，作为Upload类独立出来，可以同时在前台和后台中使用。

方法说明（方法说明将按照类的顺序列出，并给出其原型）：
FrontData类：
	FrontData($sql,$NumLimit=0)
		构造函数，初始化类，其中的$sql参数提供查询数据库的SQL语句（不能含Limit子句）
		$NumLimit参数提供显示信息的数量限制，默认为0,代表无限制

	SetPrefixString($PrefixString)
		设置在前台输出的每条记录前面，加修饰字符，以字符串形式传递

	SetPrefixImage($PrefixImage)
		设置在前台输出的每条记录前面，加修饰图片，以图片的URL地址传递，必须是HTML支持的格式

	SetNumLimit($NumLimit)
		可以在对象初始化之后，用来更改数量限制

	SetSQL($sql)
		可以在对象初始化之后，更改SQL语句

	SetLink($Field,$LinkHref,$DistinctField)
		为数据库记录中的字段，在前台显示时，加入超链接
		$Field为需要加入链接的字段名
		$LinkHref为超链接的URL
		$DistincField为制定的需要作为超链接表示的字段名（一般显示文章列表时的ID字段）

	SetTablePara($TablePara)
		设置输出格式中，关于表格中<Table>标识符的参数说明

	SetTdPara($Field,$TdPara)
		设置输出格式中，关于表格的<Td>标识符的参数说明，$Field指数据库中字段名匹配的<Td>标识符

	SetPageLimit($PageNumLimit,$PageNum=1)
		设置分页参数，$PageNumLimit表示每页的记录数，$PageNum表现显示哪一页，默认$PageNum=1

	PageControl()
		输出页面控制的选项到页面，一般由系统自己调用

	Output()
		将前台显示输出，只有这个函数调用了，才能实现此类的所有功能

AdminData类：
	AdminData($sql="select * from admin",$IdentifyField="id",$NewHref="new.php",$ModifyHref="modify.php",$OperateHref="operate.php")
		此类的构造函数
		$sql表示查询的SQL语句
		$IdentifyField表示系统将会采用表中的哪个字段作为处理标志
		$NewHref参数，用来提供添加信息操作文件的URL地址
		$ModifyHref用来提供更改信息操作文件的URL地址
		同理OperateHref则提供诸如删除，显示，隐藏等操作的操作文件URL地址（默认全部操作都在一个文件中处理）

	SetIdentifyField($IdentifyField)
		重新设置标志字段

	SetModifyHref($ModifyHref)、SetOperateHref($OperateHref)
		两个函数都是用来重新设置相应页面URL地址的

	SetAdditionOperate($Operate,$Link,$OperateAll)
		本函数用来添加除了添加、删除、修改之外的管理操作功能
		$Operate是操作名
		$Link是操作页面的URL地址
		$OperateAll是一个布尔值，代表是否支持群操作

	!!!与FrontData的相同方法不再介绍

	DataInput($TableName,$Fields,$Values,$SourceField="aid",$UploadTable="upload")
		本函数主要是将表单内的数据插入数据库中
		$TableName指定要插入的表名。$Fields是需要写入数据的字段名，用小括号括起来
		$Values是插入的数据，同样也要用小括号括起来，建议数据包含在单引号中
		$SourceField指定了那个字段作为上传表中的外键
		$UploadTable自然是上传表的表名。

	DataModify($TableName,$Fields,$Values,$IdentifyField,$IdentifyFieldValue)
		本函数主要是用来将表单中的数据更新到数据库中
		$TableName指定需要修改数据所在表名
		$Fields指定需要修改的字段名（此参数不需要添加小括号）
		$Values是插入的数据，建议数据包含在单引号中（此参数不需要添加小括号）
		$IdentifyField指定了标志字段的名称
		$IdentifyFieldValue指定了标志字段的内容

	DataDelete($TableName,$BackHref,$IdentifyField="")
		本函数主要用来删除数据库中的数据
		$TableName指定需要删除数据所在表名
		$BackHref是本页面删除操作完毕之后，返回页面的URL
		$IdentifyField指定作为标志字段的字段名，默认为空时就用构造函数所提交的$IdentifyField

	DataOperate($sql,$BackHref,$IdentifyField="")
		本函数主要用来实现由用户所添加的新操作
		$sql指定了操作的SQL语句
		$BackHref是本页面操作完毕之后，返回页面的URL
		$IdentifyField指定作为标志字段的字段名，默认为空时就用构造函数所提交的$IdentifyField

	GenerateUploadHref($TableName,$SourceField,$PathField,$SourceFieldValue="",$UploadPage="upload.php")
		本函数用来产生链接到上传页面的超链接，并同时删除上次新闻发布中所上传却未发表的临时上传文件
		$TableName用来指定上传表表名
		$SourceField用来指定上传表当中的外键
		$PathFile用来指定上传表当中，用于记录上传文件的地址的字段名
		$SourceFieldValue如果为空表示上传的是临时文件，在新闻发布才成为正式文件；不为空则代表外键的内容
		$UploadPage用来指定上传页面的URL地址
	
Upload类：
	Upload($SourceFieldValue,$FileLimit,$TableAndField,$SourceField="aid",$IdentifyField="id")
		类的构造函数
		$SourceFieldValue上传表中的外键值，如果小于0则是一个随机值，上传的是临时文件
		$FileLimit是指定上传文件的格式限制，将可以上传的文件格式后缀名作为参数值，多个限制的时候用|分开
		$TableAndField指定上传表极其对应的字段，顺序为文件地址、文件名、外键值
		$SourceField外键字段名
		$IdentifyField标志字段名

	SetPath($Path)
		设置上传文件夹URL，默认是生成类实例页面所在路径下的upload下

	SetFileNameMethod($FileNameMethod)
		设置上传后文件的命名方式，默认有两种命名，一种是UNIX元纪年方式，另外一种是按照目前的年月日时分秒的方式

	UploadFile()
		本函数应在各种设置完成之后调用，真正将文件上传并把相关信息写入数据库

	DeleteFile()
		本函数是用来删除已经上传的文件。特别地，临时文件就算不手工删除，也会在下次调用上传功能的时候自动删除