tjm/wp-base-theme

WordPress主题,可作为父主题方便主题开发

v1.0.0 2015-02-14 03:58 UTC

This package is auto-updated.

Last update: 2024-09-13 16:20:02 UTC


README

这是一个主要用作构建另一个主题基础的WordPress主题。它几乎完全未样式化。它包含带有小部件和导航位置的模板,以覆盖大多数情况,并使用类名钩子来处理大多数样式情况,因此您可以仅通过编辑样式来走得很远。它使用我的WPThemeHelper项目和其他便利功能来帮助简化开发。

WPThemeHelper

这有助于抽象出一些在开发WordPress主题时常见的无聊或重复性任务。例如,我使用其SettingHelper通过简单的JSON文件(settings.json)设置大多数主题设置。我使用其缓冲管理/模板渲染功能来帮助保持模板输出组织化和DRY。

骨架

我喜欢将我的网站“骨架”(在WordPress中指头部和尾部)放在一个文件中。我发现这样做可以更容易地看到正在发生的事情并维护。为此,我将“主要”页面内容(即get_header()get_footer()get_sidebar()之间的内容)捕获到输出缓冲区中,然后将其放入骨架文件(skeleton.html.php)的中间。我通过在get_header()之前启动输出缓冲区,并在get_footer()之后结束它并渲染骨架模板,来保持与get_header()get_footer()函数的兼容性。

我还喜欢能够将我的内容加载到一个JSON包装器中而不是完整的HTML包装器中。这对于如果您使用历史API来处理页面更改,通过AJAX拉取内容并将其粘贴到“主要”区域而无需进行完整的页面刷新非常有用。为此,我设置了在通过AJAX请求时加载“skeleton.json.php”而不是HTML版本的开关。

模板片段

使用WPThemeHelper的渲染器,我可以从片段文件夹中渲染可重用代码片段。与get_template_part()不同,我可以将这些模板传递数据。这也允许我轻松加载用于主题功能(如自定义头部和自定义背景)的标记片段的回调函数中使用的模板文件。我见过其他主题将此标记直接放入回调函数中,这使得它们难以查找、查看、修改和维护。

通用

我试图保持事情的组织化和DRY。我使用相当少量的基本WordPress模板和条件来处理细微差别。该主题配置为用作父主题。它很容易覆盖任何模板,包括由渲染器渲染的内容。我使用composer来处理维护分开的依赖项(即WPThemeHelper)。

用法

克隆此主题项目并将其放入您的主题文件夹中。运行bin/composer install以设置依赖项。然后您可以激活此主题并随意修改。或者,更理想的是,您可以创建一个子主题并覆盖您需要的内容。为此,您需要在子主题的顶部注释中放入“Template: tjmbase”。要修改传递给WPThemeHelper的设置,您可以在您的'functions.php'文件中创建一个$tjmThemeHelper数组。此数组将传递给WPThemeHelper的构造函数。