* @license GPL-3.0+
* @link https://anspress.io
* @copyright 2014 Rahul Aryan
*/
// If this file is called directly, abort.
if ( ! defined( 'WPINC' ) ) {
die;
}
/**
* Output question categories
*
* @param array $args Arguments.
* @return string
*/
function ap_question_categories_html( $args = [] ) {
$defaults = array(
'question_id' => get_the_ID(),
'list' => false,
'tag' => 'span',
'class' => 'question-categories',
'label' => __( 'Categories', 'categories-for-anspress' ),
'echo' => false,
);
if ( ! is_array( $args ) ) {
$defaults['question_id'] = $args;
$args = $defaults;
} else {
$args = wp_parse_args( $args, $defaults );
}
$cats = get_the_terms( $args['question_id'], 'question_category' );
if ( $cats ) {
$o = '';
if ( $args['list'] ) {
$o .= '';
} else {
$o .= $args['label'];
$o .= '<' . $args['tag'] . ' class="' . $args['class'] . '">';
foreach ( $cats as $c ) {
$o .= '' . $c->name . '';
}
$o .= '';
}
if ( $args['echo'] ) {
echo $o; // WPCS: xss okay.
}
return $o;
}
}
/**
* Get category details.
*/
function ap_category_details() {
$var = get_query_var( 'question_category' );
$category = get_term_by( 'slug', $var, 'question_category' );
echo '';
echo '
';
echo '
';
echo '' . $category->count . ' ' . __( 'Questions', 'categories-for-anspress' ) . '';
echo '';
echo '
';
echo '
' . $category->description . '
';
$child = get_terms(
array( 'taxonomy' => 'question_category' ), array(
'parent' => $category->term_id,
'hierarchical' => false,
'hide_empty' => false,
)
);
if ( $child ) :
echo '';
endif;
}
function ap_sub_category_list( $parent ) {
$categories = get_terms(
array( 'taxonomy' => 'question_category' ), array(
'parent' => $parent,
'hide_empty' => false,
)
);
if ( $categories ) {
echo '';
}
}
function ap_question_have_category( $post_id = false ) {
if ( ! $post_id ) {
$post_id = get_the_ID();
}
$categories = get_the_terms( $post_id, 'question_category' );
if ( ! empty( $categories ) ) {
return true;
}
return false;
}
/**
* Check if anspress categories page.
*
* @return boolean
* @since 1.0
*/
if ( ! function_exists( 'is_question_categories' ) ) {
function is_question_categories() {
if ( 'categories' === ap_current_page() ) {
return true;
}
return false;
}
}
/**
* Check if current page is question category.
*
* @return boolean
* @since 4.0.0
*/
function is_question_category() {
if ( 'category' === ap_current_page() ) {
return true;
}
return false;
}
/**
* Return category for sorting dropdown.
*
* @param string|boolean $search Search value.
* @return array|boolean
*/
function ap_get_category_filter( $search = false ) {
$args = array(
'hierarchical' => true,
'hide_if_empty' => true,
'number' => 10,
);
if ( false !== $search ) {
$args['search'] = $search;
}
$terms = get_terms( 'question_category', $args );
$selected = ap_get_current_list_filters( 'category' );
if ( ! $terms ) {
return false;
}
$items = array();
foreach ( (array) $terms as $t ) {
$item = [
'key' => 'category',
'value' => (string) $t->term_id,
'label' => $t->name,
];
// Check if active.
if ( $selected && in_array( $t->term_id, $selected, true ) ) {
$item['active'] = true;
}
$items[] = $item;
}
return $items;
}
/**
* Output category filter dropdown.
*/
function ap_category_sorting() {
$filters = ap_get_category_filter();
$selected = isset( $_GET['ap_cat_sort'] ) ? (int) $_GET['ap_cat_sort'] : '';
if ( $filters ) {
echo '';
}
}
/**
* Return category image.
*
* @param integer $term_id Category ID.
* @param integer $height image height, without PX.
*/
function ap_get_category_image( $term_id, $height = 32 ) {
$option = get_term_meta( $term_id, 'ap_category', true );
$color = ! empty( $option['color'] ) ? ' background:' . $option['color'] . ';' : 'background:#333;';
$style = 'style="' . $color . 'height:' . $height . 'px;"';
if ( ! empty( $option['image']['id'] ) ) {
$image = wp_get_attachment_image( $option['image']['id'], array( 900, $height ) );
return $image;
}
return '';
}
/**
* Output category image.
*
* @param integer $term_id Category ID.
* @param integer $height image height, without PX.
*/
function ap_category_image( $term_id, $height = 32 ) {
echo ap_get_category_image( $term_id, $height ); // WPCS: xss okay.
}
/**
* Return category icon.
*
* @param integer $term_id Term ID.
* @param string $attributes Custom attributes.
*/
function ap_get_category_icon( $term_id, $attributes = '' ) {
$option = get_term_meta( $term_id, 'ap_category', true );
$color = ! empty( $option['color'] ) ? ' background:' . $option['color'] . ';' : '';
$style = 'style="' . $color . $attributes . '"';
if ( ! empty( $option['icon'] ) ) {
return '';
}
}
/**
* Output category icon.
*
* @param integer $term_id Term ID.
* @param string $attributes Custom attributes.
*/
function ap_category_icon( $term_id, $attributes = '' ) {
echo ap_get_category_icon( $term_id, $attributes ); // xss okay.
}
/**
* Slug for categories page.
*
* @return string
* @since 4.1.0 Use new option categories_page_id.
*/
function ap_get_categories_slug() {
return ap_opt( 'categories_page_id' );
}
/**
* Slug for category page.
*
* @return string
*/
function ap_get_category_slug() {
return apply_filters( 'ap_category_slug', ap_get_page_slug( 'category' ) );
}
/**
* Check if category have featured image.
*
* @param integer $term_id Term ID.
* @return boolean
* @since 2.0.2
*/
function ap_category_have_image( $term_id ) {
$option = get_term_meta( $term_id, 'ap_category', true );
if ( ! empty( $option['image']['id'] ) ) {
return true;
}
return false;
}
/**
* Output tags html.
*
* @param array $args Arguments.
* @return string
*
* @since 1.0
*/
function ap_question_tags_html( $args = [] ) {
$defaults = array(
'question_id' => get_the_ID(),
'list' => false,
'tag' => 'span',
'class' => 'question-tags',
'label' => __( 'Tagged', 'anspress-question-answer' ),
'echo' => false,
'show' => 0,
);
if ( ! is_array( $args ) ) {
$defaults['question_id '] = $args;
$args = $defaults;
} else {
$args = wp_parse_args( $args, $defaults );
}
$tags = get_the_terms( $args['question_id'], 'question_tag' );
if ( $tags && count( $tags ) > 0 ) {
$o = '';
if ( $args['list'] ) {
$o .= '';
} else {
$o .= $args['label'];
$o .= '<' . $args['tag'] . ' class="' . $args['class'] . '" itemprop="keywords">';
$i = 1;
foreach ( $tags as $t ) {
$o .= '' . $t->name . ' ';
$i++;
}
$o .= '';
}
if ( $args['echo'] ) {
echo $o; // xss okay.
}
return $o;
}
}
function ap_tag_details() {
$var = get_query_var( 'question_tag' );
$tag = get_term_by( 'slug', $var, 'question_tag' );
echo '';
echo '
';
echo '
';
echo '' . $tag->count . ' ' . __( 'Questions', 'anspress-question-answer' ) . '';
echo '';
echo '
';
echo '
' . $tag->description . '
';
}
function ap_question_have_tags( $question_id = false ) {
if ( ! $question_id ) {
$question_id = get_the_ID(); }
$tags = wp_get_post_terms( $question_id, 'question_tag' );
if ( ! empty( $tags ) ) {
return true; }
return false;
}
function is_question_tag() {
if ( ap_get_tag_slug() == get_query_var( 'ap_page' ) ) {
return true;
}
return false;
}
function is_question_tags() {
if ( ap_get_tags_slug() == get_query_var( 'ap_page' ) ) {
return true;
}
return false;
}
/**
* Return category for sorting dropdown.
*
* @return array|boolean
*/
function ap_get_tag_filter( $search = false ) {
$args = array(
'hierarchical' => true,
'hide_if_empty' => true,
'number' => 10,
);
if ( false !== $search ) {
$args['search'] = $search;
}
$terms = get_terms( 'question_tag', $args );
$selected = ap_get_current_list_filters( 'qtag' );
if ( ! $terms ) {
return false;
}
$items = array();
foreach ( (array) $terms as $t ) {
$item = [
'key' => 'qtag',
'value' => (string) $t->term_id,
'label' => $t->name,
];
// Check if active.
if ( $selected && in_array( $t->term_id, $selected, true ) ) {
$item['active'] = true;
}
$items[] = $item;
}
return $items;
}
/**
* Slug for tag page.
*
* @return string
*/
function ap_get_tag_slug() {
return apply_filters( 'ap_tag_slug', ap_get_page_slug( 'tag' ) );
}
/**
* Slug for tag page.
*
* @return string
*/
function ap_get_tags_slug() {
return apply_filters( 'ap_tags_slug', ap_get_page_slug( 'tags' ) );
}