Title: Hydrogen Directory
Author: LBell
Published: <strong>2021 年 6 月 29 日</strong>
Last modified: 2026 年 2 月 18 日

---

搜索插件

![](https://ps.w.org/hydrogen-directory/assets/icon.svg?rev=2556034)

# Hydrogen Directory

 作者：[LBell](https://profiles.wordpress.org/lbell/)

[下载](https://downloads.wordpress.org/plugin/hydrogen-directory.1.3.0.zip)

 * [详情](https://cn.wordpress.org/plugins/hydrogen-directory/#description)
 * [评价](https://cn.wordpress.org/plugins/hydrogen-directory/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/hydrogen-directory/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/hydrogen-directory/#developers)

 [支持](https://wordpress.org/support/plugin/hydrogen-directory/)

## 描述

Finally!

A ridiculously light, stupidly-simple plugin to manage and display a directory of
anything: production cast, blog contributors, businesses, collectors items, church
members, books, club officers, chickens in your flock, departmental employees, students,
bowling league teams… you get the point.

Most “directory” plugins out there are way too complicated. One of the more popular
ones weighs in at 30 MB! That’s almost as much code as WordPress Core. That’s uranium
heavy. Be careful of meltdowns…

_Enter Hydrogen Directory._

This plugin is light and simple, just like hydrogen. Weighing just 62kb zipped, 
it’s so tiny it might float away.

Whether you need to just list the 3 members on your team, are looking to showcase
the 200 cars in your pinewood derby league, or need to import 10,000 employees, 
Hydrogen Directory manages it all with ease, speed, and predictable grace.

Highlights:

 1. Quickly add or updated listings in wordpress using familiar interface.
 2. Organize entries into buckets using taxonomies.
 3. Display your directories anywhere on your site.

That’s it! Get on to more important things in your life.

### Gutenberg Block

The Hydrogen Directory block provides a visual way to add directory listings to 
your pages and posts.

**Block Features:**

 * Live preview in the editor
 * Visual controls for all settings
 * Layout Settings: Display style (list/card/text), columns (1-6), show/hide headers
 * Content Settings: Content mode (excerpt/full/none), excerpt length
 * Filter Settings: Taxonomy selection, term filtering, show entries filter

Simply search for “Hydrogen Directory” in the block inserter, add the block, and
configure using the sidebar controls.

**Shortcode Arguments:**

**tax:** use to display entries from a single taxonomy
 **term:** use to display
entries from a single term in a taxonomy **style:** display style (default “list”)**
columns:** number of columns to display (default 1) **headers:** whether to include
tax / term headers in the output (default 1 = yes) **content:** content display 
mode – “excerpt” (truncated, default), “full” (all content), or “none” (hide content)**
excerpt_length:** number of words to show when content=”excerpt” (default 20)

Example:
 [hydrogen_directory tax=”role” term=”Alter Boy” style=”card” columns=3][
hydrogen_directory tax=”role” term=”Staff” style=”list” content=”excerpt” excerpt_length
=”30″] [hydrogen_directory tax=”department” content=”none”]

## 屏幕截图

 * [[
 * Included “list” style.
 * [[
 * Included “card” style.
 * [[
 * Included “text” style.
 * [[
 * Custom avatar style.
 * [[
 * Settings page (There isn’t one. It’s that simple.)

## 区块

该插件提供了 1 个区块.

 *   Hydrogen Directory Display directory entries with customizable layout options.

## 安装

 1. Upload the `hydrogen-directory` folder to the `/wp-content/plugins/` directory.
 2. Activate `Hydrogen Directory` through the ‘Plugins’ menu in WordPress dashboard.
 3. Use the “Hydrogen Directory” block in the Gutenberg editor, or use the shortcode`[
    hydrogen_directory]` in classic editor or anywhere shortcodes work.

## 常见问题

### Can I import entries from a CSV?

Yes – you can import using standard CSV import pathways. Although WordPress does
not offer CSV import function natively, there are a number of plugins that will 
add this feature. This plugin has been tested successfully with the “Really Simple
CSV Importer” plugin. (Note, entries in the file must be **comma** separated.)

### How do I theme the output?

You have several options:

 1. Add custom css to your theme to tweak the look.
 2. Override the default templates by copying any of the `directory-list-entry-{type}.
    php` files into your theme, and modifying it there.
 3. Use the plugin hooks (filters / actions) to customize specific parts.

### Can this plugin do X,Y or Z?

Probably not. But it could!

Hydrogen Directory is purposefully simple and easy. But it can extended in powerful
ways. Contact me for requests for additional functionality.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Hydrogen Directory」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ LBell ](https://profiles.wordpress.org/lbell/)

[帮助将「Hydrogen Directory」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/hydrogen-directory)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/hydrogen-directory/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/hydrogen-directory/)，或通过[RSS](https://plugins.trac.wordpress.org/log/hydrogen-directory/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/hydrogen-directory/)。

## 更新日志

#### 1.3.0

 * Fix: Less opinionated css for better theming and to prevent conflicts with themes
   and other plugins

#### 1.2.1

 * Fix: removed css from text template

#### 1.2.0

 * Add: Gutenberg Block with live preview and visual controls
 * Add: REST API endpoint for block preview
 * Add: Block editor styles for accurate preview rendering
 * Add: More filter hooks for customizing output

#### 1.1.0

 * Fix: CSS structure for better theming
 * Add: schema.org markup
 * Add: shortcode options for content display mode and excerpt length

#### 1.0.4

 * Tested to WordPress 6.9
 * Fix: escaping output
 * Fix: namespacing and global variables
 * Fix: post sanitization
 * Security: prevent direct access
 * Fix: template errors
 * Fix: corrected filter/action usage

#### 1.0.3

 * Bugfix: activation error (submenu permission)
 * Tested to WP 5.9.3

#### 1.0.2

 * CSS Fix

#### 1.0.1

 * Position Meta Box fix
 * Code cleanup

#### 1.0.0

 * Initial Release

## 额外信息

 *  版本 **1.3.0**
 *  最后更新：**2 月前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 3.0 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  语言
 * [English (US)](https://wordpress.org/plugins/hydrogen-directory/)
 * 标签
 * [church](https://cn.wordpress.org/plugins/tags/church/)[club](https://cn.wordpress.org/plugins/tags/club/)
   [directory](https://cn.wordpress.org/plugins/tags/directory/)[employee](https://cn.wordpress.org/plugins/tags/employee/)
   [people](https://cn.wordpress.org/plugins/tags/people/)
 *  [高级视图](https://cn.wordpress.org/plugins/hydrogen-directory/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/hydrogen-directory/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/hydrogen-directory/reviews/)

## 贡献者

 *   [ LBell ](https://profiles.wordpress.org/lbell/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/hydrogen-directory/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://github.com/sponsors/lbell)