Silverstripe 模板问题

Question

我正在掌握 Silverstripe 框架，但遇到了一个奇怪的错误。

例如，我想创建一个新的“会员”页面。在 mysite/code 中，我设置了一个如下的 members.php 页面：

class Membership extends Page {

}

class Membership_Controller extends Page_Controller {

}

然后我在我的模板/布局文件夹中创建了一个 members.ss 文件，其中包含一些测试输出。然后我进行开发构建并在“会员”类型的 CMS 中创建一个页面。在前端，如果我单击导航栏成员的新页面，我看不到测试文本，所以似乎没有阅读模板？

有什么想法吗？

谢谢。

艾伦。

Answer 1

关于模板有几个常见的陷阱：

• 在过去的版本中，刷新的工作方式已经改变了好几次。
  我不会在这里解释细节，因为这些可能很快就会再次发生变化。
  但是，当前版本 (3.1) 中有两件事与此相关：

  1. /dev/build 根本不刷新
  2. /dev/build?flush=1 仅刷新清单和配置（无模板）

  （开发构建不使用模板，因此没有刷新模板）
  这意味着您必须在普通页面上执行 ?flush=1，不仅仅是在 dev/build

• 模板文件的名称必须与类完全相同（我认为它区分大小写）
• 检查模板文件没有被另一个位置的另一个模板文件覆盖。 （例如，如果您有 moduleName/templates/Foo.ss 和 Themes/simple/templates/Foo.ss 则主题的模板将覆盖模块模板
• 确保模板不为空（这会导致 SilverStripe 出现错误，至少在 3.1 版中）

• 控制器上的操作可以覆盖模板使用。这里有一些例子：

  // this will not use a template at all, it will just print "some string"
  public function index() { return "some string"; } 
  
  // this will not use a template at all, it will output an empty string
  public function index() { return; } 
  
  // this will use template named "Bar.ss"
  public function index() { return $this->renderWith(array('Bar')); } 
  

---

SilverStripe 还提供了一个调试选项来查看使用了哪些模板。 您可以通过 2 种方式激活它：

1. 在你的 yml 配置中设置 source_file_comments：

   SSViewer:
     # display template filenames as comments in the html output
     source_file_comments: true
   

2. 使用“URL Variable Tools”：查看您的网站时只需添加 ?showtemplate=1

启用后，查看页面的 HTML 源代码（在 firefox 中为 CTRL+u）
silverstripe 会添加 cmets 让你知道使用了哪些模板。

Answer 2

确保您的类具有正确声明和命名的 Page_Controller 扩展名。我最近遇到了这个问题。页面控制器扩展有错字，因此没有使用模板文件。

例如，如果您的页面类是 RidiculouslyNamedPage

class RidiculouslyNamedPage extends Page {

}

class RidiculouslyNamedPage_Controller extends Page_Controller {

}

然后在您的themes/[theme-name]/templates/Layout/ 文件夹中，您将拥有您的RidiculouslyNamedPage.ss。

如果你拼错了RidiculouslyNamedPage_Controller，模板将不会被调用。

Answer 3

我找到了问题的答案。

我的 .php 缺少以下内容：

function getInfo() {
return $this->renderWith('Media');
}

否则，将不会使用 Media.ss 文件！希望这将帮助其他可能正在掌握 SS 的人！