README

将HTML5 Boilerplate的.htaccess添加到您的WordPress安装中。

安装

您可以通过命令行或WordPress管理面板安装此插件。

通过命令行

如果您使用Composer来管理WordPress，请将wp-h5bp-htaccess添加到您项目依赖项中。

composer require roots/wp-h5bp-htaccess 2.0.1

然后通过wp-cli激活插件。

wp plugin activate wp-h5bp-htaccess

通过WordPress管理面板

1. 下载此存储库的最新zip文件。
2. 在您的WordPress管理面板中，转到插件->添加新插件
3. 点击上传插件
4. 上传您下载的zip文件。

配置

插件将直接使用，但我们为希望微调生成的.htaccess文件的开发者提供了一些选项。

!!! 警告 !!!

使用这些配置选项可能会导致意外、不期望的甚至破坏性的行为。您必须理解，更改此插件输出将更改WordPress放入您的.htaccess文件的内容。错误配置的.htaccess文件可能导致服务器错误。请确保您有在必要时删除.htaccess文件的方法。

使用自定义服务器配置（server_configs.conf）

您可以使用自己的服务器配置而不是H5BP包含的Apache服务器配置。通过在主题目录的根目录中放置名为server_configs.conf的文件来实现。

/
├── wp-admin/
├── wp-content/
│   └── themes/
│       └── your-theme-here/
│           └── server_configs.conf
└── wp-includes/

钩子

开发者可以将其钩子插入几个WordPress过滤器中，以修改生成的.htaccess文件。以下规则按代码中应用的顺序列出。

roots/h5bp-htaccess-filters

此钩子传递一个关联数组，其中包含要应用于规则的修改过滤器，数组的键代表要搜索的字符串，数组的值代表替换。

用于简单字符串替换，例如注释掉行。

add_filter('roots/h5bp-htaccess-filters', function($rules_filters) {
  // comments out all `RewriteRule`s
  $rules_filters['RewriteRule'] = '# RewriteRule';
  return $rules_filters;
});

roots/h5bp-htaccess-rules

此钩子传递一个字符串，其中包含此插件将要添加到您的 .htaccess 文件中的所有规则。

add_filter('roots/h5bp-htaccess-rules', function($server_config_rules) {
  // Removes all comments and whitespace
  return preg_replace(['/#.*/', '/(^[\r\n]*|[\r\n]+)[\s\t]*[\r\n]+/'], ['',PHP_EOL], $server_config_rules);
});

变更日志

2.0.1: 2015年4月29日

• 修复引用错误（#12）
• 更新到 h5bp 服务器配置仓库的链接（#13）

2.0.0: 2015年4月11日

• 更新到 Apache 服务器配置 v2.14.0
• 将插件重写为类
• 重写逻辑，以便仅在插件被积极使用时检查服务器和 WordPress 配置
• 添加过滤器，使用户能够更多地控制正在应用的规则
• 在 h5bp-htaccess 的底部添加了专门的 WordPress 部分

1.1.0: 2014年6月7日

• 更新到 Apache 服务器配置 v2.4.1

1.0.0: 2013年4月30日

• 从 Roots Theme 中移除，移至插件

许可证

• Apache 服务器配置：MIT 许可证
• 其余所有内容：MIT 许可证