There are several logical steps in the request, so defining a new function is necessary.
When activated, the shortcode plugin defined below will accept any of the following formats if the taxonomy is named taxonomy_name:
[terms-with-same-parent] to output a default template for taxonomy taxonomy_name[terms-with-same-parent template="Taxonomy Terms"] if there is a Pods template of that name[terms-with-same-parent taxonomy="taxonomy_name"] if there is a taxonomy of that name
or…
[terms-with-same-parent]<a href="{@permalink}">{@name}</a>[/terms-with-same-parent]
…to define a Pods template inline.
The below shortcode can be added as a plugin to wp-content/plugins/terms-with-same-parent/terms-with-same-parent.php
Please see comments in the code for options to add headers, restrict to one parent, or wrap in tags.
<?php
/**
* Plugin Name: Shortcode - Terms with Same Parent
* Description: <code>[terms-with-same-parent]</code>
*/
add_shortcode(
'terms-with-same-parent',
function( $atts, $content, $tag ) {
// Query taxonomy set as taxonomy="taxonomy_name"
// or use default of 'taxonomy_name' if not specified.
$taxonomy = 'taxonomy_name';
if ( array_key_exists( 'taxonomy', $atts ) ) {
$taxonomy = $atts['taxonomy'];
}
// Assigned terms.
$terms = (array) get_the_terms( get_the_ID(), $taxonomy );
if ( empty( $terms ) ) {
return '';
}
ob_start();
// Assigned term and parent IDs.
$parent_ids = [];
$assigned_child_ids = [];
foreach ( $terms as $term ) {
if ( 0 !== intval( $term->parent ) ) {
$parent_ids[] = $term->parent;
$assigned_child_ids[] = $term->term_id;
}
}
$parent_ids = array_unique( $parent_ids );
// Terms with the same parent.
// See https://developer.ww.wp.xz.cn/reference/classes/wp_term_query/__construct/
foreach( (array) $parent_ids as $parent_id ) {
$terms_with_same_parent = get_terms(
[
'taxonomy' => $taxonomy,
'parent' => $parent_id, // Must be one parent ID.
'hide_empty' => true,
'orderby' => 'name',
'order' => 'ASC',
'exclude' => $assigned_child_ids,
'number' => 0,
]
);
if ( ! empty( $terms_with_same_parent ) ) {
// Uncomment to show name of parent.
// printf( '<h3>%s</h3>', get_term( $parent_id )->name );
// Uncomment to wrap terms in a <p> tag.
// echo '<p>';
}
foreach( (array) $terms_with_same_parent as $term ) {
if ( array_key_exists( 'template', $atts ) ) {
// If a Pods template is specified by template="Template Name".
echo pods( $taxonomy, $term->term_id )->template( $atts['template'] );
} else if ( ! empty( $content ) ) {
// If a template is specified in shortcode content like:
// [terms-with-same-parent]<a href="{@permalink}">{@name}</a>[/terms-with-same-parent]
echo pods( $taxonomy, $term->term_id )->template( null, $content );
} else {
// If no template specified, default to links.
printf(
'<a href="%s">%s</a> ',
get_term_link( $term ),
$term->name
);
}
}
if ( ! empty( $terms_with_same_parent ) ) {
// Uncomment if wrapped terms in a <p> tag.
// echo '</p>';
}
// Uncomment to only show children of the first found parent.
// break;
}
return ob_get_clean();
}
);
Note the only thing in this code specific to Pods is the use of magic tag templates. An example of a generic template is used for the default template and parent term header.
