README

添加功能以协助开发 SilverStripe 网站。

依赖项

• SilverStripe 3.1+
• Betterbuttons

功能

• 页面加载性能
• 当前站点状态的可视化（开发/测试/生产）
• 管理员可以模拟任何其他用户
• IconSelectField 在 CMS 中使用图标库
• 在生产模式下自动重定向到开发域名
• LogJam 记录系统错误日志
• BugHerd 集成

安装

1. 将以下命令添加到您的 composer 需求中 composer require jaedb/dev-tools
2. 编辑您主题的 templates/Page.ss 模板，并在 </body> 标签之前立即添加 $DebugTools
3. 运行 /dev/build?flush=1
4. 通过将您的站点设置为开发或测试模式来切换调试工具（出于明显的原因，在生产站点上禁用）
5. 在 config.yml 中设置站点的 BugHerd 项目密钥。有关示例，请参阅 config/dev-tools.yml

使用方法

主域名重定向

当您在 live 网站上设置 SS_PRIMARY_DOMAIN 属性时，我们将自动重定向到此主域名。这避免了需要庞大的 .htaccess 重定向，并允许在环境级别进行控制。

• 在 _ss_environment.php 中设置您的首选域名
• 考虑您是否需要 http 或 https，并将其包含在域名中（但不包括尾随斜杠！）。
• 示例：将 define('SS_PRIMARY_DOMAIN', 'https://plasticstudio.co.nz'); 将将 http://www.plasticstudio.co.nz/some-section/subpage 重定向到 https://plasticstudio.co.nz/some-section/subpage。
• 要完全禁用此功能，请在项目的 config.yml 中设置 disable_primary_domain_redirection: true

调试工具

• 在 CMS 中管理调试工具的可见性，在 设置 下
• 在 设置 下管理模拟用户的能力

IconSelectField

• 将您的 $db 字段设置为类型 Icon（例如 'PageIcon' => 'Icon'）
• IconSelectField::create($name, $title, $iconFolder)
• $name 是您在类中定义的数据库字段
• $title 是此字段的标签
• $iconFolder（可选）定义了图标所在的目录。默认为 /site/icons。
• 在模板中使用您的图标，就像使用任何其他属性一样（例如 $PageIcon）。如果您的图标是 SVG，则 SVG 图像数据将被注入到模板中。要防止这种情况，您可以使用 $PageIcon.IMG 来强制使用 <img> 标签。

LogJam

• LogJam::Log($message, $environment)
• $message 您想要记录的字符串
• $environment （可选）应记录此消息的环境类型（例如 测试，开发，生产）。默认为 开发。

1. 在 _config.php 中启用 LogJam，通过添加 LogJam::EnableLog();
2. 检查您的日志文件位置。在 _ss_environment.php 中设置如下：

ini_set('log_errors','on');
ini_set('error_log','/home/mywebsite/logs/php.log');