newcity/newcity-timber-extensions

此包的最新版本(v0.3.5)没有可用的许可证信息。

安装: 2,561

依赖项: 0

建议者: 0

安全: 0

星标: 1

关注者: 5

分支: 0

开放问题: 0

类型:wordpress-plugin

v0.3.5 2018-11-30 21:38 UTC

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:页面/文章的帖子ID
    • url:页面/文章的永久链接