WHmcs中的插件开发

技术QQ交流群:294088839。

QQ：870422471

包含文件

包含模板是由多个页面共享和使用的模板。它们位于子目录内。/includes/

通用于所有页面

• head.tpl - 定义页面部分中包含的CSS和Javascript文件
• navbar.tpl - 控制主导航栏菜单项的输出
• sidebar.tpl - 控制边栏菜单项的输出

按需要使用

• captcha.tpl - 用于在任何地方输出验证码验证图像
• pwstrength.tpl - 用于在任何地方输出密码强度计和工具提示
• tablelist.tpl - 控制整个客户区的所有可过滤数据列表表的输出

编辑这些模板文件中的任何一个都会影响使用各个元素的地方。一个地方可以编辑，另一个地方可以在升级期间维护，这将有助于更轻松地应用和保留自定义设

CSS样式

在/css/custom.css文件中进行这些自定义。

此文件包含在styles.css之后，允许您覆盖其中定义的任何CSS，并且不会受到WHMCS软件未来更新的影响。

变量

在Smarty模板语言中，模板变量采用格式。{$variable_name}

以下模板参数可用于所有页面。

参数	描述
{$ BASE_PATH_CSS}	常用CSS资产的基本网址。
{$ BASE_PATH_FONTS}	通用字体资产的基本URL。
{$ BASE_PATH_IMG}	常见图像资产的基本URL。
{$ BASE_PATH_JS}	通用Javascript资源的基本网址。
{$字符集}	已配置的字符集。
{$}客户端	当前登录的客户端;如果客户端未登录，则返回null。
{$}公司名称	已配置的公司名称。
{$ date_day}	当前日历日。
{$ date_month}	当前日历月。
{$ date_year}	当前日历年。
{$文件名}	Web浏览器请求的当前文件的基本名称。
{$语言}	要显示给用户的语言的名称。
{$}的loggedIn	取决于客户端是否登录，是true或false。
{$标志}	配置的徽标图像的路径。
{$ PAGETITLE}	当前页面的标题。
{$ reCaptchaPublicKey}	已配置的reCAPTCHA站点密钥。如果WHMCS安装不使用Google reCAPTCHA，则这可以是一个空字符串。
{$ systemNonSSLURL}	已配置的非SSL网址。
{$ systemsslurl}	已配置的SSL URL。
{$ systemurl}	WHMCS系统的URL。SSL或非SSL URL取决于当前页面是否通过HTTPS加载。
{$模板}	用于显示的模板的名称。
{$ todaysdate}	当前日期以“l，jS FY”格式显示。
{$令牌}	用于POST表单的CSRF令牌。
{$ WEB_ROOT}	您的WHMCS系统的基本URL。

要获取给定模板文件中可用的所有变量的完整列表，请将以下行添加到模板文件中，然后访问通过浏览器调用模板的页面，以接收列出所有可用模板数据的弹出窗口。

功能

更换

这是该str_replace函数的简写版本。用它来替换字符串中的值。

{$variable_name|replace:'hello':'world'}

计数

使用此来计算数组中的条目数。

{$variable_name|count}

条件语句

在满足特定条件时通常需要显示文本或消息。

Smarty中的{if}语句与PHP if语句具有相同的灵活性。

每个{if}都必须与匹配的{/ if}配对。{else}和{elseif}也是允许的。

所有PHP条件语句和功能的认可，比如||，or，&&，and，，等。is_array()

例

{if $filename eq "announcements.php"}
    This is the announcements page
{else}
    This is not the announcements page
{/if}

调试

模板文件中的语法错误可能导致页面无法完全呈现。

其他常见原因包括：

• 使用上游Smarty包中已删除的Smarty功能
• 自定义或第三方模块不兼容
• 未启用允许Smarty PHP标记设置的情况下在模板中使用PHP代码块（转到设置>常规设置>安全启用它）

故障排除

如果在对模板文件进行更改后看到空白页面，请查看“ 实用程序”>“日志”中的“ 活动日志”以查看任何记录的错误消息。

以下模板在Github上提供。

六个客户区域模板

WHMCS中的默认客户区模板。

https://github.com/WHMCS/templates-six

标准卡订购表格模板

WHMCS中的默认购物车模板。

https://github.com/WHMCS/orderforms-standard_cart