Download the PHP package ssnepenthe/hestia without Composer
On this page you can find all versions of the php package ssnepenthe/hestia. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ssnepenthe/hestia
More information about ssnepenthe/hestia
Files in ssnepenthe/hestia
Package hestia
Short Description This plugin introduces the following shortcodes: [ancestors], [attachments], [children], [siblings], [sitemap].
License GPL-2.0
Homepage https://github.com/ssnepenthe/hestia
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package hestia
hestia
This WordPress plugin introduces a number of shortcodes for listing related posts based on post hierarchy.
Requirements
PHP 5.6 or greater and Composer.
Installation
Install using Composer:
Usage
Once the plugin has been activated you will have access to the following shortcodes:
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 ofget_the_ID().order: one ofASCorDESC. Sets the sort order of found posts. Defaults toASC.thumbnails:trueorfalse. Whether or not to include featured images in post list. Defaults tofalse.
Example: [ancestors order="DESC" thumbnails="true"]
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 ofget_the_ID().link: one ofPAGEorFILE. Sets whether to link to the attachment page or the actual attachment file. Defaults toPAGE.max: integer between 1 and 100. Sets the maximum number of attachments to display. Defaults to20.order: one ofASCorDESC. Sets the sort order of found posts. Defaults toASC.thumbnails:trueorfalse. Whether or not to include thumbnails in list. Defaults tofalse.
Example: [attachments link="FILE" max="50" order="DESC" thumbnails="true"]
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 ofget_the_ID().max: integer between 1 and 100. Sets the maximum number of children to display. Defaults to20.order: one ofASCorDESC. Sets the sort order of found posts. Defaults toASC.thumbnails:trueorfalse. Whether or not to include featured images in post list. Defaults tofalse.
Example: [children max="35" order="DESC" thumbnails="true"]
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 ofget_the_ID().max: integer between 1 and 100. Sets the maximum number of siblings to display. Defaults to20.order: one ofASCorDESC. Sets the sort order of found posts. Defaults toASC.thumbnails:trueorfalse. Whether or not to include featured images in post list. Defaults tofalse.
Example: [siblings max="65" order="DESC" thumbnails="true"]
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 to20.order: one ofASCorDESC. Sets the sort order of found posts. Defaults toASC.thumbnails:trueorfalse. Whether or not to include featured images in post list. Defaults tofalse.
Example: [sitemap max="100" order="DESC" thumbnails="true"]
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:
These templates do not work the same as a standard WordPress loop - They are rendered using the Plates template system 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
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:
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
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.
All versions of hestia with dependencies
composer/installers Version ^1.0
league/plates Version ^3.0
ssnepenthe/metis Version ^0.7
ssnepenthe/wp-requirements Version ^0.1