全局属性与方法
最后更新: | 浏览次数: 387|前端开发
在模板中调用相应的属性和方法时,需严格区分大小写,具体语法请阅读系统模板语法文章
全局属性与全局方法可在任意模板页面中使用,返回当前站点的相应信息,如果系统有配置多个站点,当前模板页为站点A使用,则返回的值为站点A的配置信息,全局属性和方法以@Cms.开头,例如:
<div>
<!--调用站点名称-->
<h1>@Cms.SiteName</h1>
<!--调用站点Logo-->
<a href="@Cms.Domain"><img src="@Cms.Logo" alt="@Cms.SiteName"/></a>
</div>
全局属性
| 属性名称 | 属性说明 | 返回类型 | 对应设定(返回)值 |
|---|---|---|---|
| SiteName | 站点名称 | String | 站点设置->站点名称 |
| Domain | 站点域名 | String | 站点管理->站点编辑 |
| CdnDomain | CDN加速域名 | String | 站点设置 -> CDN配置 |
| Logo | 站点图片Logo路径 | String | 站点设置->站点Logo |
| Ico | 站点图标URL路径 | String | 站点设置->站点Ico |
| Direction | 文字方向 | String | 站点管理->站点编辑 |
| Language | 站点语言 | String | 站点管理->语言标识 |
| Lic | 客户端授权码 | String | 用户客户端授权判断 |
| Theme | 站点模板目录URL | String | 域名(CDN域名)/theme/模板名称 |
| RealTheme | 站点模板目录Url路径 | String | 域名/theme/模板名称 |
| PageName | 页面类型标识 | String | 值:home/category/product/article/shoppingcart |
| ClientIp | 客户端IP地址 | String | 访客IP地址 |
| StatusCode | 页面状态码 | int | 页面状态数据 |
| ConstMode | 意见征求模式 | Int | 站点设置->隐私设置 |
| IsMobile | 是否为移动设备 | Boolean | |
| IsTablet | 是否为平板设备 | Boolean | |
| IsDesktop | 是否为桌面设备 | Boolean | |
| DisableContextMenu | 是否屏蔽右键菜单 | Boolean | 站点设置->阅读&询盘 |
| IsEnableBasket | 是否允许购物车 | Boolean | |
| IsEnableInquiry | 是否允许询盘 | Boolean | 站点->站点设置->阅读&询盘 |
| IsRequiredCaptcha | 留言是否需要验证 | Boolean | 站点设置->阅读&询盘 |
| Version | 系统版本号 | String | 系统当前程序版本号 |
| IsLogin | 会员是否登录 | Boolean | 会员是否已登录 |
| MemberName | 会员登录名 | String | 会员名称 |
| Structured | 结构化对象数据 | Object | 详见:Structured属性 |
| Soical | 社媒对象数据 | Object | 详见Social属性 |
| Verify | 搜索引擎验证 | Object | 详见:Verify属性 |
Structured属性
Structured数据对应管理后台:站点->站点设置->结构化数据
调用电子邮件示例
<a href="mailto:@Cms.Structured.Email">@Cms.Structured.Email</a>
| 属性名称 | 属性说明 | 返回类型 | 备注 |
|---|---|---|---|
| OrganizationName | 机构/商家名称 | String | |
| Logo | 机构/商家Logo | String | |
| Image | 机构/商家对应的店招图片 | String | |
| Country | 机构/商家所在国家 | String | 返回为国家代码,非具体国家名称 |
| Locality | 机构/商家所在城市 | String | |
| Address | 机构/商家详细地址 | String | |
| PostalCode | 邮政编码 | String | |
| TelePhone | 联系电话 | String | |
| 电子邮件 | String | ||
| whatsapp号码 | String | ||
| Skype | skype号码 | String | |
| QQ号码 | String | ||
| 微信二维码图片 | String |
Social对象
| 属性名称 | 返回类型 | 属性说明 |
|---|---|---|
| Youtube | String | 对应组织/商家/个人的社交媒体主页 |
| String | ||
| String | ||
| String | ||
| String | ||
| String | ||
| String | ||
| TikTok | String | |
| OnlineShop | String | |
| LiveUrl | String |
Verify对象
用于搜索引擎管理员验证,
| 名称 | 返回类型 | 说明 |
|---|---|---|
| String | Google管理员控制台验证字符串 | |
| Baidu | String | 百度站长平台验证字符串 |
| Bing | String | Bing管理员控制台验证字符串 |
| Yandex | String | Yandex管理员控制台验证字符串 |
| GoogleAnalyticsId | String | Google Analaytics Tag Id |
| MetricaId | String | Yandex Metrica Tag Id |
全局方法
| 方法名称 | 描述 | 说明 |
|---|---|---|
| 局部调用 | ||
| 如果网站所有页面中有大量公共的内容(例如网站顶部/底部区域等),可将这部分内容独立出来,采用局部调用的方式 | ||
| Load(string partialViewName) | 调用局部模板 | @Cms.Load("header") |
| Load(string partialViewName, T arg) | 调用局部模板 | |
| Load(string partialViewName, T arg, T2 arg2) | 调用局部模板 | |
| Load(string partialViewName, T arg, T2 arg2, T3 arg3) | 调用局部视图 | |
| 分类获取 | ||
| HasChilds(int categoryId) | 判断分类Id下是否有子类 | |
| HasChilds(string categoryAlias) | 判断分类别名下是否有子类 | |
| ColAll(int categoryId=0) | 按分类Id获取其所有子类 | |
| ColAll(string alias) | 按分类别名获取其下所有子类 | |
| Col(int categoryId) | 按分类Id获取其分类信息 | |
| Col(string alias) | 按分类别名获取其分类信息 | |
| ColChilds(int categoryId=0) | 按分类Id获取其下直接子类 | |
| ColChilds(string alias) | 按分类Id获取其下直接子类 | |
| GetGroup(string groupName) | 按分组获取分类列表 | |
| 链接生成 | ||
| Link(Content content,string cssClass=null)例 | 生成内容链接 | |
获取
@foreach(var item in Model.List)
{
@Cms.link(item)
}
|
||
| Link(CategoryBase category,string cssClass=null) | 生成分类链接 | |
| Link(Content content,string fragment,object htmlAttributes) | 生成内容链接 | |
| Link(CategoryBase category,string fragment,object htmlAttributes) | 生成分类链接 | |
| Url(Content content,string fragment=null) | 生成内容Url地址 | |
| Url(CategoryBase category,string fragment=null) | 生成分类链接地址 | |
| Url(string categoryAlias) | 生成分类链接(如分类不存在,则返回#) | |
| 获取内容 | ||
| Top(ProductAttr attr,int top,string categoryAlias=null,bool child=true) | 按分类别名和属性取前N条商品 | |
| Top(ProductAttr attr,int top,int categoryId=0,bool child=false) | 按分类id和属性取N条商品 | |
| Top(ArticleAttr attr,int top,string alias,bool child=false) | 按分类别名和属性取前N条文章 | |
| Top(ArticleAttr attr,int top,int categoryId,bool child=false) | 按分类id和属性取前N条文章 | |
| 社交媒体与其它 | ||
| SocialFollow(string cssClass = null) | 社交媒体个人主页 | |
| SocialShare(string cssClass = null) | 社交分享按钮 | |
| Filesize(string virtualFilePath) | 生成文件路径 | |
| ConvertUrl(string virtualUrl) | 转换Url | |
| SubString(string str, int length) | 截取字符串 | |
| Raw(string str) | 输出原生HTML | |
| Format(string str) | 将字符串中的换行符替换为<br/>标签 | |
| Banner(string identName,string viewPath=null) | 调用广告 | |
| GetAdvert(string identName,string viewPath=null) | 调用广告(v5版本将弃用) | |