93devs / terra

此类有助于通过Ajax过滤文章分类

dev-master 2022-06-14 15:16 UTC

This package is auto-updated.

Last update: 2024-09-19 14:06:22 UTC


README

v1.0.1

Terra是93digital Lama实用类的重写。该类在WordPress中实现了动态过滤功能,允许用户通过分类和其他自定义过滤器快速过滤自定义文章类型的索引/存档页面。

注意:需要php >= 7.2,不支持更早的版本。

安装

Composer

从您的主题根目录,在终端中运行以下命令以使用Composer安装Terra

$ composer require 93devs/terra:dev-master

然后,在您的functions.php中添加以下内容

$GLOBALS['terra'] = new \Nine3\Terra();

如果您已在项目中使用Lama,您需要将其删除以及任何针对它的初始化,特别是\Nine3\Lama::init();,因为这两个工具不能同时使用。

Luna

当前Luna主题默认实例化了Terra,因此您无需做任何事情。如果您需要添加Terra钩子,请在此处操作:/inc/hooks/class-luna-terra-hooks.php

如果您使用的是未内嵌Terra的较旧版本的Luna,您需要在/inc中创建一个新的类文件(您也将在此处添加任何Terra操作或过滤器),例如:

class Luna_Terra {
	public function __construct() {
		$GLOBALS['terra'] = new \Nine3\Terra();
	}
}

然后在/inc/class-luna.php中实例化该类,如下所示:$this->terra = new Luna_Terra();

开发

需要npm来编译JS文件。

npm install

构建JS

npm run build

调试

当在WordPress中启用调试时,Terra会自动在debug.log文件中输出以下信息

  • 传递给WP_Query的$args数组参数(当执行Ajax请求时)
  • 正在尝试加载的每个找到的元素的模板

或者,您可以将常量TERRA_DEBUG设置为true以在wp-content/terra.log文件中输出该信息,将以下行添加到您的启动主题/插件中

define( 'TERRA_DEBUG', true );