<h2>Editing File: /usr/local/sitepad/editor/site-data/plugins/documentor/includes/shortcode_functions.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php

// We need the ABSPATH
if (!defined('ABSPATH')) exit;

function pagelayer_sc_dm_sidebar(&amp;$el){

	$html = '';
	$current_doc_id = documentor()-&gt;get_current_doc_id();
	$current_hub_id = 0;

	$doc_hubs = wp_get_post_terms(
		$current_doc_id,
		'docs_hub',
		['fields' =&gt; 'ids']
	);

	// Check for explicit Hub assignments
	if(!empty($doc_hubs) &amp;&amp; !is_wp_error($doc_hubs)){
		$current_hub_id = $doc_hubs[0];
	} else{
		// If no explicit Hub, check its Categories for a mapped Hub
		$doc_cats = wp_get_post_terms(
			$current_doc_id,
			'docs_category',
			['fields' =&gt; 'ids']
		);
		if(!empty($doc_cats) &amp;&amp; !is_wp_error($doc_cats)){
			foreach($doc_cats as $cat_id){
				$mapped_hubs = get_term_meta($cat_id, 'documentor_associated_hubs', false);
				// Grab the first valid Hub mapped to this category
				if(!empty($mapped_hubs) &amp;&amp; is_array($mapped_hubs)){
					$current_hub_id = $mapped_hubs[0];
					break;
				}
			}
		}
	}

	// Fetch only the docs for that hub
	$include_ids = [];
	
	if($current_hub_id &gt; 0){
		// Find all categories that belong to this specific Hub
		$matching_cats = get_terms([
			'taxonomy' =&gt; 'docs_category',
			'meta_query' =&gt; [
				[
					'key'     =&gt; 'documentor_associated_hubs',
					'value'   =&gt; $current_hub_id,
					'compare' =&gt; '='
				]
			],
			'fields' =&gt; 'ids'
		]);

		$cat_count = (!empty($matching_cats) &amp;&amp; !is_wp_error($matching_cats)) ? count($matching_cats) : 0;
		$tax_query = ['relation' =&gt; 'OR'];

		// Always allow docs explicitly assigned to this Hub.
		$tax_query[] = array(
			'taxonomy' =&gt; 'docs_hub',
			'field' =&gt; 'term_id',
			'terms' =&gt; $current_hub_id
		);

		// Also allow docs with no explicit Hub if they belong to a mapped category.
		if($cat_count &gt; 0){
			$tax_query[] = array(
				'relation' =&gt; 'AND',
				array('taxonomy' =&gt; 'docs_category', 'field' =&gt; 'term_id', 'terms' =&gt; $matching_cats),
				array('taxonomy' =&gt; 'docs_hub', 'operator' =&gt; 'NOT EXISTS')
			);
		}

		// Run the database query to get just the matching document IDs
		$docs_query = new WP_Query(array(
			'post_type' =&gt; 'docs',
			'posts_per_page' =&gt; -1,
			'fields' =&gt; 'ids',
			'tax_query' =&gt; $tax_query
		));

		if(!empty($docs_query-&gt;posts)){
			$include_ids = $docs_query-&gt;posts;
		} else{
			$include_ids = array(0);
		}
	}

	$args = array(
		'title_li'  =&gt; '',
		'order'     =&gt; 'menu_order',
		'child_of'  =&gt; empty($el['atts']['hide_parent']) ? 0 : $current_doc_id,
		'echo'      =&gt; false,
		'post_type' =&gt; 'docs',
		'walker'    =&gt; new Documentor_Walker_Docs(),
	);

	if(!empty($include_ids)){
		$args['include'] = implode(',', $include_ids);
	}

	$nav_list = wp_list_pages($args);

	if($nav_list){
		$html  = '&lt;a class=&quot;documentor-sidebar-toggler&quot;&gt;&lt;i class=&quot;fas fa-times&quot;&gt;&lt;/i&gt;&lt;/a&gt;';
		$html .= '&lt;ul class=&quot;documentor-nav-list'.( $el['atts']['show_child'] ? ' documentor-nav-list-show-childs' : '' ) .'&quot;&gt;';
		$html .=  $nav_list;
		$html .= '&lt;/ul&gt;';
	} 

	$el['atts']['post_html'] = $html;
}

function pagelayer_sc_dm_feedback(&amp;$el){
	
	$show_counts = $el['atts']['show_counts'];
	$positive_title = $el['atts']['positive_title'];
	$negative_title = $el['atts']['negative_title'];
	$el['atts']['pcount'] = '';
	$el['atts']['ncount'] = '';
	$no_votes = $el['atts']['no_votes'];
	$positive = (int) get_post_meta( get_the_ID(), 'positive', true );
	$negative = (int) get_post_meta( get_the_ID(), 'negative', true );

	if($show_counts){
		$el['atts']['positive_title'] = $positive ? sprintf( '%s %s', number_format_i18n( $positive ), $positive_title ) : $no_votes;
		$el['atts']['negative_title'] = $negative ? sprintf( '%s %s', number_format_i18n( $negative ), $negative_title ) : $no_votes;
	}

	if($positive){ 
		$el['atts']['pcount'] = '&lt;span class=&quot;badge&quot;&gt;'. esc_html( number_format_i18n( $positive ) ) .'&lt;/span&gt;';
	} 

	if($negative){ 
		$el['atts']['ncount'] = '&lt;span class=&quot;badge&quot;&gt;'. esc_html( number_format_i18n( $negative ) ) .'&lt;/span&gt;';
	}
	
}

function pagelayer_sc_dm_article(&amp;$el){

	$children = wp_list_pages( 'title_li=&amp;order=menu_order&amp;child_of=' . get_the_ID() . '&amp;echo=0&amp;depth=1&amp;post_type=' . get_post_type() );

	if(!$children &amp;&amp; (pagelayer_is_live() ||  wp_doing_ajax())){
		$children = '&lt;li class=&quot;page_item&quot;&gt;&lt;a href=&quot;javascript_void(0)&quot;&gt;Sub Category 1&lt;/a&gt;&lt;/li&gt;&lt;li class=&quot;page_item&quot;&gt;&lt;a href=&quot;javascript_void(0)&quot;&gt;Sub Category 2&lt;/a&gt;&lt;/li&gt;';
	}

	if(!$children){
		$el['atts']['heading'] = '';	
	}
	 
	$el['atts']['post_html'] = $children;
}
function pagelayer_sc_dm_title(&amp;$el){

	global $post;

	$title =  pagelayer_is_live() ? &quot;Title&quot; : get_the_title( );

	$el['atts']['title'] = $title;
}

function pagelayer_sc_dm_breadcrumbs(&amp;$el){
	
	$breadcrumbs = documentor()-&gt;get_breadcrumbs_array();
	$html = '';
	
	foreach( $breadcrumbs as $k =&gt; $crumb ){
		if( $k &gt; 0 ){ 
			$html .= '&lt;li class=&quot;delimiter&quot;&gt;'. $el['atts']['separator'].'&lt;/li&gt;';
		}
		
		$html .= '&lt;li itemprop=&quot;itemListElement&quot; itemscope itemtype=&quot;http://schema.org/ListItem&quot;&gt;';
		
		if(isset($crumb['url'])) $html .= '&lt;a itemprop=&quot;item&quot; href=&quot;'. esc_url( $crumb['url'] ).'&quot;&gt;';
		
		$html .= '&lt;span itemprop=&quot;name&quot;&gt;'. esc_html( $crumb['label'] ) .'&lt;/span&gt;';
		
		if(isset($crumb['url'])) $html .= '&lt;/a&gt;';
		
		$html .= '&lt;meta itemprop=&quot;position&quot; content=&quot;'. esc_attr( $k + 1 ) .'&quot; /&gt;';
		$html .= '&lt;/li&gt;';
	}

	$el['atts']['post_html'] = $html;
}

function pagelayer_sc_dm_adjacent_links(&amp;$el){
	
	$html = '';
	$prev_post_id = documentor()-&gt;get_previous_adjacent_doc_id();
	$next_post_id = documentor()-&gt;get_next_adjacent_doc_id();

	if($prev_post_id || $next_post_id){
		
		$html = '&lt;nav class=&quot;documentor-single-adjacent-nav&quot;&gt;';
	  
		if( $prev_post_id ){
			$html .= '&lt;span class=&quot;nav-previous&quot;&gt;';
			$html .= '&lt;a href=&quot;'.esc_url( get_the_permalink( $prev_post_id ) ) .'&quot; class=&quot;documentor-btn documentor-btn-md&quot;&gt;'. esc_html( get_the_title( $prev_post_id ) ) .'&lt;/a&gt;';
			$html .= '&lt;/span&gt;';
		}
	  
		if( $next_post_id ){
			$html .= '&lt;span class=&quot;nav-next&quot;&gt;';
			$html .= '&lt;a href=&quot;'.esc_url( get_the_permalink( $next_post_id ) ) .'&quot; class=&quot;documentor-btn documentor-btn-md&quot;&gt;'. esc_html( get_the_title( $next_post_id ) ) .'&lt;/a&gt;';
			$html .= '&lt;/span&gt;';
		}
	  
		$html .= '&lt;/nav&gt;';
	}

	$el['atts']['post_html'] = $html;
}

function pagelayer_sc_dm_archive_box(&amp;$el){
	global $wp_query;

	$is_editor = (pagelayer_is_live() || wp_doing_ajax());

	// Check if current page is a a linked Hub
	$is_hub_page = false;
	if(is_page()){
		$linked_hub = get_post_meta(get_the_ID(), '_documentor_linked_hub_id', true);
		if(!empty($linked_hub)){
			$is_hub_page = true;
		}
	}

	//Check if we are on the Main Documentation Archive Page
	$is_main_docs_page = (!is_tax('docs_hub') &amp;&amp; !$is_hub_page &amp;&amp; !is_search() &amp;&amp; !$is_editor);
	$html = '';
	$show_hub_grid = false;
	$hub_grid_html = '';

	if(pagelayer_is_live() || wp_doing_ajax()){
		$args = array(
				'post_type'		=&gt; 'docs',
				'posts_per_page' =&gt; -1, // phpcs:ignore
				'post_parent'	 =&gt; 0,
				'orderby'		  =&gt; array(
				'menu_order' =&gt; 'ASC',
				'date'		 =&gt; 'DESC',
				),
		);

		$wp_query = new WP_Query( $args );
	}

	// Fetch the Hub ID from either the Taxonomy OR the Page
	$selected_hub_id = 0;
	if(is_tax('docs_hub')){
		$selected_hub_id = get_queried_object_id();
	} elseif(is_page()){
		$linked_hub = get_post_meta(get_the_ID(), '_documentor_linked_hub_id', true);
		if(!empty($linked_hub)){
			$selected_hub_id = intval($linked_hub);
		}
	}

	$matching_cats = array();
	if($selected_hub_id &gt; 0){
		$matching_cats = get_terms(array(
			'taxonomy' =&gt; 'docs_category',
			'meta_query' =&gt; array(
				array(
					'key'     =&gt; 'documentor_associated_hubs',
					'value'   =&gt; $selected_hub_id,
					'compare' =&gt; '='
				)
			),
			'fields' =&gt; 'ids'
		));
		if(is_wp_error($matching_cats)) $matching_cats = array();
	}

	$current_term = false;

	if( have_posts()){
		while ( have_posts() ){
			// Set up global $post data for the current document
			the_post(); 
			
			$terms = wp_get_post_terms( get_the_ID(), 'docs_category' );
			$hubs = wp_get_post_terms(get_the_ID(), 'docs_hub');
			$display_term_name = false;

			if(empty($selected_hub_id) &amp;&amp; !empty($hubs)){
				continue;
			} elseif(!empty($selected_hub_id)){
				$has_selected_hub = false;

				if(!empty($hubs) &amp;&amp; !is_wp_error($hubs)){
					foreach($hubs as $hub){
						if(!empty($hub-&gt;term_id) &amp;&amp; $selected_hub_id === intval($hub-&gt;term_id)){
							$has_selected_hub = true;
							break;
						}
					}
				}

				if(!$has_selected_hub &amp;&amp; !empty($hubs)){
					continue;
				}

				if($terms &amp;&amp; !empty($terms)){
					if(!empty($matching_cats)){
						foreach($terms as $t){
							if(in_array($t-&gt;term_id, $matching_cats)){
								$display_term_name = $t-&gt;name;
								break;
							}
						}
					}

					if(!$has_selected_hub &amp;&amp; !$display_term_name){
						continue;
					}
				} elseif(!$has_selected_hub){
					continue;
				}
			}

			if($terms &amp;&amp; !empty($terms) &amp;&amp; !$display_term_name){
				// Look through the doc's categories and find the one that belongs to this Hub
				$display_term_name = $terms[0]-&gt;name;
			}
			
			// Print the Correct Header
			if($display_term_name &amp;&amp; $current_term !== $display_term_name){
				$current_term = $display_term_name;
				$html .= '&lt;li class=&quot;documentor-archive-list-category&quot;&gt;';
				$html .= esc_html($current_term);
				$html .= '&lt;/li&gt;';
			}

			$html .= '&lt;li class=&quot;documentor-archive-list-item&quot;&gt;';
			$html .=  documentor_loop_title($el['atts']);
			$html .=  documentor_loop_articles($el['atts']);
			$html .= '&lt;/li&gt;';
		}
	} elseif(pagelayer_is_live() || wp_doing_ajax()){
		$html .= '&lt;li class=&quot;documentor-archive-list-item&quot;&gt;';
		$html .=  documentor_loop_title($el['atts']);
		$html .=  documentor_loop_articles($el['atts']);
		$html .= '&lt;/li&gt;';
	 }

	$el['atts']['post_html'] = $html;
}

function documentor_loop_title($atts){
	$html = '';
	$articles = get_pages(
		array(
			'child_of'  =&gt; get_the_ID(),
			'post_type' =&gt; 'docs',
		)
	);
	$articles_count = count( $articles );	 

	$html .= '&lt;a href=&quot;'. get_the_permalink().'&quot; class=&quot;documentor-archive-list-item-title&quot;&gt;';
	
	if($atts['hicon']){
		$html .= '&lt;i class=&quot;'. $atts['hicon'].'&quot;&gt;&lt;/i&gt;';
	}
	
	$html .= get_the_post_thumbnail( '','documentor_archive' ); 
	$html .= '&lt;span&gt;';
	$html .= '&lt;span&gt;';
	$html .= sprintf( esc_html( _n( '%s Article', '%s Articles', $articles_count, 'documentor' ) ), esc_html( $articles_count ) );
	$html .= '&lt;/span&gt;';
	$html .= '&lt;h2&gt;'. get_the_title() .'&lt;/h2&gt;';
	$html .= '&lt;/span&gt;';
	$html .= '&lt;/a&gt;';
	
	return $html;
}

function documentor_loop_articles($atts){
	
	$html ='';
	$show = $atts['show_articles'];
	$articles_number = $atts['articles_depth'];

	if ( -1 === $articles_number ) {
		$articles_number = 9999;
	}

	if ( ! $show || $articles_number &lt; 1 ) {
		return;
	}

	$top_articles = new WP_Query(
		array(
			'post_type'		=&gt; 'docs',
			'posts_per_page' =&gt; -1, // phpcs:ignore
			'post_parent'	 =&gt; get_the_ID(),
			'orderby'		  =&gt; array(
				'menu_order' =&gt; 'ASC',
				'date'		 =&gt; 'DESC',
			),
		)
	);
	
	$parent_link  = get_permalink();
	$count = 0;

	$nav_list = wp_list_pages(
		array(
			'title_li'  =&gt; '',
			'order'	  =&gt; 'menu_order',
			'child_of'  =&gt; documentor()-&gt;get_current_doc_id(),
			'echo'		=&gt; false,
			'post_type' =&gt; 'docs',
			'icon'		=&gt; $atts['icon'],
			'depth'	  =&gt; $articles_number,
			'walker'	 =&gt; new Documentor_Walker_Docs(),
		)
	);

	if(!$nav_list &amp;&amp; (pagelayer_is_live() || wp_doing_ajax())){
		$nav_list = '&lt;li class=&quot;page_item&quot;&gt;&lt;a href=&quot;&quot;&gt;List&lt;/a&gt;&lt;/li&gt;';
	}

	if ($nav_list) {
		$show_childs = documentor()-&gt;get_option( 'sidebar_show_nav_childs', 'documentor_single', false );
		$html .= '&lt;div class=&quot;home_page_cats slimscroll-virt&quot;&gt;';
		$html .= '&lt;ul class=&quot;documentor-nav-list'. ( $show_childs ? ' documentor-nav-list-show-childs' : '' ).'&quot;&gt;';
		$html .=  $nav_list; 
		$html .= '&lt;/ul&gt;';
		$html .= '&lt;/div&gt;';
	} 
	
	wp_reset_postdata(); 
	return $html;
}

function pagelayer_sc_dm_hub_list(&amp;$el){
	$hubs = get_terms([
		'taxonomy' =&gt; 'docs_hub',
		'hide_empty' =&gt; false,
	]);

	if(empty($hubs)){
		$el['atts']['hub_list_html'] = !empty($el['no_hub']) ? $el['no_hub'] : __('No Doc Hub created yet', 'documentor');
		return;
	}
	
	if(is_wp_error($hubs)){
		$el['atts']['hub_list_html'] = $hubs-&gt;get_error_message();	
		return;
	}

	$active_hubs_count = 0;
	$boxes_html = '';

	foreach($hubs as $hub){
		$hub_id = $hub-&gt;term_id;

		$sections = get_posts([
			'post_type' =&gt; 'docs',
			'post_status' =&gt; 'publish',
			'posts_per_page' =&gt; -1,
			'fields' =&gt; 'ids',
			'post_parent' =&gt; 0,
			'tax_query'      =&gt; [
				[
					'taxonomy' =&gt; 'docs_hub',
					'field'    =&gt; 'term_id',
					'terms'    =&gt; $hub_id,
				],
			],
		]);

		if(empty($sections)) {
			continue;
		}

		$query = new \WP_Query([
			'post_type' =&gt; 'docs',
			'post_status' =&gt; 'publish',
			'post_parent__in' =&gt; $sections,
			'posts_per_page' =&gt; -1,
			'fields' =&gt; 'ids',
		]);

		$section_count = count($sections);
		$doc_count = (int) $query-&gt;found_posts;
		
		// Now we need to get all the sub child docs id
		if(!empty($query-&gt;posts) &amp;&amp; is_array($query-&gt;posts)){
			$query = new \WP_Query([
				'post_type' =&gt; 'docs',
				'post_status' =&gt; 'publish',
				'post_parent__in' =&gt; $query-&gt;posts,
				'posts_per_page' =&gt; -1,
				'fields' =&gt; 'ids',
			]);
			
			$doc_count += (int) $query-&gt;found_posts;
		}

		if($section_count === 0 &amp;&amp; $doc_count === 0){
			continue; 
		}

		$active_hubs_count++;

		// Robustly find the linked Page URL (Check Term Meta, then Post Meta)
		$page_url = get_term_link($hub);

		// Format text grammar
		$section_text = $section_count === 1 ? '1 Section' : $section_count . ' Sections';
		$doc_text = $doc_count === 1 ? '1 Doc' : $doc_count . ' Docs';

		$boxes_html .= '&lt;a href=&quot;' . esc_url($page_url) . '&quot; class=&quot;documentor-hub-box&quot;&gt;';
		$boxes_html .= '&lt;span class=&quot;documentor-hub-title&quot;&gt;' . esc_html($hub-&gt;name) . '&lt;/span&gt;';
		$boxes_html .= '&lt;span class=&quot;documentor-hub-meta&quot;&gt;' . $section_text . ' &amp;bull; ' . $doc_text . '&lt;/span&gt;';
		$boxes_html .= '&lt;/a&gt;';
	}

	if($active_hubs_count &lt;= 0){
		$el['atts']['hub_list_html'] = !empty($el['no_hub']) ? $el['no_hub'] : 'No Doc Hub found';
		return;
	}
	
	$el['atts']['hub_list_html'] = $boxes_html;
}</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fsitepad%2Feditor%2Fsite-data%2Fplugins%2Fdocumentor%2Fincludes'>Back to Directory</a>