PHPackages                             ssnepenthe/hestia - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ssnepenthe/hestia

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

ssnepenthe/hestia
=================

This plugin introduces the following shortcodes: \[ancestors\], \[attachments\], \[children\], \[siblings\], \[sitemap\].

0.4.1(8y ago)0106[7 issues](https://github.com/ssnepenthe/hestia/issues)GPL-2.0PHPPHP >=5.6

Since Mar 28Pushed 8y ago1 watchersCompare

[ Source](https://github.com/ssnepenthe/hestia)[ Packagist](https://packagist.org/packages/ssnepenthe/hestia)[ Docs](https://github.com/ssnepenthe/hestia)[ RSS](/packages/ssnepenthe-hestia/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (7)Used By (0)

hestia
======

[](#hestia)

This WordPress plugin introduces a number of shortcodes for listing related posts based on post hierarchy.

Requirements
------------

[](#requirements)

PHP 5.6 or greater and Composer.

Installation
------------

[](#installation)

Install using Composer:

```
$ composer require ssnepenthe/hestia

```

Usage
-----

[](#usage)

Once the plugin has been activated you will have access to the following shortcodes:

### ancestors

[](#ancestors)

Lists all post ancestors of the current post.

Accepts the following attributes:

- `id`: ID of the post for which you would like to display ancestors. Defaults to the return value of `get_the_ID()`.
- `order`: one of `ASC` or `DESC`. Sets the sort order of found posts. Defaults to `ASC`.
- `thumbnails`: `true` or `false`. Whether or not to include featured images in post list. Defaults to `false`.

**Example:** `[ancestors order="DESC" thumbnails="true"]`

### attachments

[](#attachments)

Lists all media that has been directly attached to the current post.

Accepts the following attributes:

- `id`: ID of the post for which you would like to display attachments. Defaults to the return value of `get_the_ID()`.
- `link`: one of `PAGE` or `FILE`. Sets whether to link to the attachment page or the actual attachment file. Defaults to `PAGE`.
- `max`: integer between 1 and 100. Sets the maximum number of attachments to display. Defaults to `20`.
- `order`: one of `ASC` or `DESC`. Sets the sort order of found posts. Defaults to `ASC`.
- `thumbnails`: `true` or `false`. Whether or not to include thumbnails in list. Defaults to `false`.

**Example:** `[attachments link="FILE" max="50" order="DESC" thumbnails="true"]`

### children

[](#children)

Lists all child posts of the current post.

Accepts the following attributes:

- `id`: ID of the post for which you would like to display children. Defaults to the return value of `get_the_ID()`.
- `max`: integer between 1 and 100. Sets the maximum number of children to display. Defaults to `20`.
- `order`: one of `ASC` or `DESC`. Sets the sort order of found posts. Defaults to `ASC`.
- `thumbnails`: `true` or `false`. Whether or not to include featured images in post list. Defaults to `false`.

**Example:** `[children max="35" order="DESC" thumbnails="true"]`

### siblings

[](#siblings)

Lists sibling posts of the current post.

Accepts the following attributes:

- `id`: ID of the post for which you would like to display siblings. Defaults to the return value of `get_the_ID()`.
- `max`: integer between 1 and 100. Sets the maximum number of siblings to display. Defaults to `20`.
- `order`: one of `ASC` or `DESC`. Sets the sort order of found posts. Defaults to `ASC`.
- `thumbnails`: `true` or `false`. Whether or not to include featured images in post list. Defaults to `false`.

**Example:** `[siblings max="65" order="DESC" thumbnails="true"]`

### sitemap

[](#sitemap)

Lists the most recent posts of each public post type.

Accepts the following attributes:

- `max`: integer between 1 and 100. Sets the maximum number of posts to display per post type. Defaults to `20`.
- `order`: one of `ASC` or `DESC`. Sets the sort order of found posts. Defaults to `ASC`.
- `thumbnails`: `true` or `false`. Whether or not to include featured images in post list. Defaults to `false`.

**Example:** `[sitemap max="100" order="DESC" thumbnails="true"]`

Custom Output
-------------

[](#custom-output)

Shortcode output can be overridden within a theme or child theme. To do so, create the following PHP files either in your theme root or in a templates subdirectory:

```
hestia-ancestors.php
hestia-attachments.php
hestia-children.php
hestia-siblings.php
hestia-sitemap.php

```

These templates do not work the same as a standard WordPress loop - They are rendered using the [Plates template system](http://platesphp.com/) with an array of `WP_Post` objects.

View the existing plugin templates to get an idea of what data will be available in a given file.

### A Note About Custom Templates And Post Meta

[](#a-note-about-custom-templates-and-post-meta)

By default, all queries are performed **WITHOUT** updating the meta cache unless thumbnails are enabled. It is done this way to minimize the number of database queries performed.

However - if you need to create a custom shortcode template that does access post meta, the result will be an extra database query **PER POST!**

This is obviously not desirable, so the following filters are provided to force a meta cache update:

```
hestia_ancestors_preload_meta
hestia_attachments_preload_meta
hestia_children_preload_meta
hestia_siblings_preload_meta
hestia_sitemap_preload_meta

```

Return `true` to any of these and all post meta will be loaded in a single query up front rather than a query per post.

Caching
-------

[](#caching)

No caching is done by this plugin.

For the most part, these shortcodes run very basic queries and you should not notice any performance impact.

The possible exception is the sitemap shortcode which runs **AT LEAST** two queries per public post type.

If you have a large number of post types I do not recommend using the sitemap shortcode without a solid caching strategy in place.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~142 days

Total

5

Last Release

3124d ago

PHP version history (3 changes)0.1.0PHP >=5.4

0.2.0PHP >=5.6

0.3.0PHP >=7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/acf42baca29dd8d1ffaf61009a3000068423a84db153c5cb864ef6fde64a1b87?d=identicon)[ssnepenthe](/maintainers/ssnepenthe)

---

Top Contributors

[![ssnepenthe](https://avatars.githubusercontent.com/u/10903810?v=4)](https://github.com/ssnepenthe "ssnepenthe (133 commits)")

---

Tags

phppost-hierarchyshortcodeswordpresswordpress-plugin

### Embed Badge

![Health badge](/badges/ssnepenthe-hestia/health.svg)

```
[![Health](https://phpackages.com/badges/ssnepenthe-hestia/health.svg)](https://phpackages.com/packages/ssnepenthe-hestia)
```

###  Alternatives

[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/builder-plugin

Builder plugin for October CMS

17147.2k1](/packages/rainlab-builder-plugin)[pfefferle/wordpress-activitypub

The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.

5671.4k1](/packages/pfefferle-wordpress-activitypub)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[humanmade/lottie-lite

A lightweight Lottie Animations Extension for WordPress

374.3k](/packages/humanmade-lottie-lite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)