README

为开发 SilverStripe 网站添加额外功能。

依赖

• SilverStripe 3.1+
• Betterbuttons

特性

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

安装

1. 将以下代码添加到您的 composer 需求中 composer require jaedb/dev-tools
2. 编辑您的主题的 templates/Page.ss 模板，并在 </body> 标签之前立即添加 $DebugTools
3. 运行 /dev/build?flush=1
4. 通过将您的网站转换为 DEV 或 TEST 模式来切换调试工具（出于明显的原因，在 LIVE 网站上禁用）
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

调试工具

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

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（可选）应记录此消息的环境类型（例如 test、dev、live）。默认为 dev。

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

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