创建自定义站务目录布局

如需为站务目录页面创建自定义布局，您需要使用 HTML 编写模板，因此为此您需要熟悉 HTML 以及基本的 PHP 逻辑。

登录管理面板，前往 定制 -> 主题 并点击默认主题的 "编辑 HTML 和 CSS" 按钮。再点击 "新建" 按钮并选择 "HTML 模板"。您可以根据自己的喜好命名模板，并使用以下详细信息填写表格的其余部分：

变量：$users 位置：添加现有位置 现有位置：front 分组：添加现有分组 现有分组：staffdirectory 应用：系统

然后，您需要在左侧的模板列表中导航到新创建的模板（位于 core -> front -> staffdirectory）。您可以在此处为模板编写 HTML 代码。模板将传递一个 $users 变量，它是一个 \IPS\core\StaffDirectory\User 对象的数组。您的代码可以包含模板逻辑和模板标签您可以使用现有模板之一作为示例。

在此之后，您还需要创建另一个具有相同名称（设置也与上述相同）但名称附加 “_preview” 的模板（例如，如果您刚刚创建的模板称为 “myCustomLayout”，那么您现在创建的模板将是 “myCustomLayout_preview” ），其中包含在管理面板中创建站务目录组时要在表单上显示的 HTML。由于您已经知道布局的样子，因此可以将其变得非常简单。

您需要为安装的每个主题重复这些步骤（子主题除外，它们将继承其父主题的模板）。

创建完成后，之后在创建站务目录时，您将看到您创建的模板是可用选项之一。