Directorist Divi Builder Integration 目录页面可视化构建 WordPress 插件[更至v1.1.4]

核心定位

Directorist Divi Integration 是一款将目录功能深度集成至 Divi 5 的扩展工具。用户可在 Divi Builder 中通过可视化方式构建目录的各个部分——包括列表归档页、搜索表单、分类/地区模块、单条详情页以及作者主页。所有布局、间距、字体、颜色和响应式行为均通过 Divi 设计控件统一管理。

适用场景

• 已有 Divi 5 环境，需在网站中搭建目录型业务（餐饮黄页、房产、招聘等）
• 希望使用 Divi 的设计逻辑统一整个站点的视觉风格，而非采用 Directorist 默认主题
• 需要为不同目录类型、分类甚至单条列表定制差异化卡片模板

版本与依赖说明

• 专为 Divi 5 构建，无需迁移，无版本兼容顾虑
• 必须安装 Divi Builder 或 Divi 主题方可使用该扩展

主要功能模块

目录全链路可视化控制

Search Form、Listing Results、Sort Controls、Category Grid、Filter Sidebar 等目录核心组件均为独立 Divi 模块，可自由拖拽定位，通过 Divi 面板统一控制间距、字体及响应式布局。

单条详情页设计

每个详情字段（图片轮播、价格、评分、地图、联系方式等）均为独立模块，按需拖入并使用 Divi 行列布局编排。例如酒店类可采用全宽轮播图配合并排价格/评分，再加两栏布局展示地图/联系信息；招聘类可突出职位名称、薪资、工作类型，随后展示描述、截止日期和申请表单。

列表卡片模板

Archive 页面中每个列表卡片是出现最频繁的元素。Listing Card Template 模块支持逐字段控制卡片内容，可针对不同目录类型、分类甚至单条列表创建独立卡片设计，全部通过可视化操作完成，无需触碰模板文件。

Directorist 专用模块组

主题构建器集成

在 Divi Theme Builder 中创建一套布局，可直接指派给所有 Directorist 列表页，列表数据自动填充，设计一次全局生效。

常见问题

是否支持为不同目录类型配置独立卡片？ 支持。Listing Card Template 模块可按目录类型和视图模式分别构建卡片设计。 筛选和排序操作是否会刷新页面？ 不会。归档页使用 AJAX 异步加载，搜索、筛选、排序、视图切换和分页均无刷新完成。 部分模块未显示如何处理？ 部分模块依赖特定扩展，例如 Booking 模块需要 Directorist Booking 插件、Claim Listing 模块需要 Directorist Claim Listing 插件。确认对应扩展已安装并激活后，模块将正常出现。

Divi 兼容性概览

Directorist 与 Divi 主题及其构建器实现了深度集成，涵盖了短代码、Theme Builder 模板、自定义字段显示以及目录类型过滤等核心功能。以下是各功能模块的兼容性说明。

短代码在 Divi 中的使用

所有 Directorist 短代码均可正常嵌入 Divi Code 模块中运行。对于添加 Listing 表单、用户仪表盘和结账页面等场景，这种方式尤为便捷——单个短代码即可完整渲染整个页面内容，无需依赖额外的视觉模块设计。

主题与构建器兼容性

Directorist 全面支持三种 Divi 使用方式：

• Divi 原生主题
• 基于 Divi 的子主题
• 在非 Divi 主题上安装的 Divi Builder 插件

Theme Builder 模板支持

可创建 Theme Builder 模板并将其分配至 Directorist 的 listing 文章类型。通过添加目录类型条件规则，不同的目录类型可对应不同的单条 Listing 展示模板，实现灵活的页面设计。

自定义字段模块

针对各类自定义字段类型，Directorist 提供了专属模块支持：

• 文本、数字、URL
• 日期、时间
• 下拉菜单、单选按钮、复选框
• 颜色选择器、文件上传

在模块设置中选择对应字段后，系统会自动提取并显示当前 Listing 中该字段的值。

缓存与 JavaScript 优化

Divi 模块和预设布局与主流缓存插件兼容。但若页面启用了激进的 JavaScript 优化设置，AJAX 驱动的归档功能可能受到影响，导致搜索或筛选结果无法正常更新。遇到此类问题时，可尝试以下步骤：

1. 暂时禁用 JavaScript defer 或延迟加载设置
2. 清空页面缓存
3. 刷新页面验证功能是否恢复

目录类型过滤

Listing Loop 模块支持按目录类型筛选内容，并可设置默认显示的目录类型。配合 Directory Type 模块，访问者可在不同目录类型之间自由切换。Theme Builder 的条件规则同样支持针对特定目录类型分配独立模板，实现差异化的展示效果。