首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Genesis框架从入门到精通(9): 函数介绍

Genesis框架从入门到精通(9): 函数介绍

作者头像
丘壑
发布2019-03-13 10:18:56
4820
发布2019-03-13 10:18:56
举报
文章被收录于专栏:一丘一壑一丘一壑

原文

Genesis Explained Functions

In previous parts of the Genesis Explained series I talked about actions and filters, but Genesis is so much more than that. One of the great things about Genesis is all the helper functions. Today…

Designs By Nick the Geek

译文

本系列的前几部分中,我谈到了动作过滤器 ,但Genesis的优势之处远不止于此。Genesis内含的辅助函数是它的又一个巨大优点。今天我们先快速总览一下全貌,然后我将带你深入研究每个函数的细节。

首先,还是看看文件结构。照例,通过文件夹的名字和文件的名字可以帮助我们快速找到需要的内容,请查看 genesis/lib/functions/ 文件夹。

  • genesis/lib/functions/
    • breadcrumb.php (面包屑导航)
    • compat.php (截取字符串长度)
    • deprecated.php (不再使用的函数,因为它们已被新函数替换)
    • feed.php (将url重定向到Feed的地址)
    • formatting.php (格式化文本或返回其他函数值的函数)
    • general.php (杂七杂八的设置)
    • head.php(处理网站头部信息的函数)
    • image.php (用于获取缩略图)
    • layout.php (用于更改站点的布局/布局选项的函数)
    • markup.php(封装了html代码和对HTML5的支持)
    • menu.php (genesis导航菜单的函数)
    • onboarding.php (用于引导性的内容设置)
    • options.php (用于获取选项值和自定义字段的函数)
    • requirements.php(检查系统要求)
    • seo.php (与主题SEO相关的函数)
    • toolbar.php(用来编辑自定义存档页的工具栏)
    • upgrade.php (升级用)
    • widgetize.php (处理默认侧边栏,页脚侧边栏的创建、注册)

斜体部分为原文中没有的内容,译者丘壑根据最新版Genesis 2.8添加

好的,现在你已经大致了解了文件中的内容。我们将在本系列的后续文章中讨论其中的大多数文件和函数,现在让我们先从一些最常用的函数开始介绍一下。更详细的内容将在稍后发布,现在先大致的看几个函数:

genesis_get_image()

此函数和 genesis_image() 用于获取特色图像。实际上它还可以做得更多。如果你没有设置特色图像,它还会取出文中的第一张图片。稍后将详细讨论可以传递给它的参数。genesis_image()会把 genesis_get_image() 取到的图片显示出来,这是它们的不同之处。这意味着你在使用该函数时不必输入“echo”。由于这种特性,你可以使用很多巧妙的技巧。

genesis_get_custom_field()

同样的,genesis_custom_field() 函数会把 genesis_get_custom_field( )获取到的值打印出来。它会自动使用 $post-> ID,只需要传入字段名即可。

get_the_content_limit()

get_the_content_limit() 函数使用 get_the_content()来获取完整内容,然后对其进行长度限制。the_content_limit()可以直接用来显示限制过长度的部分文章。这类似于the_excerpt(),但有几个高级参数可以设置,可以更轻易的调整要显示的内容长度,甚至更精确的(字符数、字数),并且自动内置好了“read more”的链接。

这些只是想激起你的兴趣而已,很快就会深入研究这些函数的具体功能,可选参数以及怎样用过滤器来调整输出。

写在后面

这是最短的一篇没想到却是最费时的,因为太久远了。。作者写的日期距离现在已经快8年了。。。里面写到的好多都和现在不一样了,有的没了,有的移走了,有的新添加了,估计博客上也懒得更新了,但愿书中应该更新了吧。。

由于手边还是没有书,只好一个个文件打开看看里面是啥内容,人肉确认一下。不过也正好借此机会一窥Genesis的内部代码组织,确实井然有序的,而且也是在不断迭代更新的,是一个有生命力的框架,值得好好研究一下。

ps:本文文件树的样式参考了这里:https://codepen.io/khoama/pen/hpljA

See the Pen Pure CSS Directory Tree by Khoa Ma (@khoama) on CodePen.

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2019-02-26,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 原文
  • 译文
  • genesis_get_image()
  • genesis_get_custom_field()
  • get_the_content_limit()
  • 写在后面
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档