newcity / newcity-timber-extensions
此包的最新版本(v0.3.5)没有可用的许可证信息。
v0.3.5
2018-11-30 21:38 UTC
Requires
- php: >=5.4.0
- composer/installers: ^v1.3.0
README
此Wordpress插件为Timber和Twig预设了一些常见的配置选项。它还创建了一个新的文章类,NC_TimberPost
,该类扩展了默认的TimberPost
类,添加了常用的函数和属性。在编写新的TimberPost类时,应该使用NC_TimberPost
而不是默认的TimberPost
类。
设置
- 启用Timber缓存并将缓存目录移动到
wp-content/uploads/timber-cache
(在Pantheon上需要文件系统写入权限) - 扩展Timber将寻找Twig模板和片段的位置。放置在
/templates
或/partials
目录内的任何.twig
文件都将被检测到,无论其目录深度如何。
过滤器
|quoteswap( $mode[可选] )
将所有花括号双引号更改为花括号单引号。对于嵌套引号很有用。
您还可以传递一个$mode
参数为s_to_d
来将单引号更改为双引号。通常不建议这样做,因为过滤器目前无法区分单引号和撇号。|print_r
模仿PHP的print_r
函数,返回一个包含在<pre>
标签内的格式化数组或对象,以便更容易阅读。
NC_TimberPost
post.ancestors
返回一个数组,包含当前(分层)页面或文章的所有祖先文章ID,从顶级祖先开始,以直接父级结束。如果文章没有祖先,则返回false
。post.ancestors( $pos )
将整数传递给post.ancestors
将返回当前文章从当前文章起$pos
步长的祖先文章ID。例如,post.ancestors(1)
将返回当前文章的父级,而post.ancestors(2)
将返回其祖父母。0
的位置将返回顶级祖先,传递任何大于祖先总数值的值也将返回顶级祖先。post.top_ancestor
是post.ancestors(0)
的简写post.breadcrumbs
返回一个包含有关当前文章祖先信息的对象数组,适用于构建面包屑导航列表。每个对象包含以下值title
:页面/文章的标题ID
:页面/文章的帖子IDurl
:页面/文章的永久链接