'recent_posts_handler', 'categories' => 'categories_handler', 'menu' => 'menu_handler', 'site_logo' => 'site_logo_handler', 'site_title' => 'site_title_handler', 'site_tagline' => 'site_tagline_handler', ); foreach ( $map as $tag => $handler ) { add_shortcode( 'lq_' . $tag, array( $this, $handler ) ); // Friendly unprefixed alias when no other plugin claimed it. if ( ! shortcode_exists( $tag ) ) { add_shortcode( $tag, array( $this, $handler ) ); } } } /** * Recent posts grid — category filter, columns, thumbnail, badge, * excerpt, date. Reuses the same .post-card hooks as the archive grid. */ public function recent_posts_handler( $atts ) { $atts = shortcode_atts( array( 'limit' => 6, 'category' => '', // slug or comma-separated slugs 'columns' => 3, // 1..6 'offset' => 0, 'show_excerpt' => 1, 'show_date' => 1, 'show_category' => 1, 'class' => 'posts-grid', ), $atts, 'lq_recent_posts' ); $limit = max( 1, min( 24, (int) $atts['limit'] ) ); $columns = max( 1, min( 6, (int) $atts['columns'] ) ); $query_args = array( 'post_type' => 'post', 'post_status' => 'publish', 'posts_per_page' => $limit, 'offset' => max( 0, (int) $atts['offset'] ), 'orderby' => 'date', 'order' => 'DESC', ); if ( ! empty( $atts['category'] ) ) { $slugs = array_filter( array_map( 'trim', explode( ',', $atts['category'] ) ) ); if ( ! empty( $slugs ) ) { $query_args['category_name'] = implode( ',', $slugs ); } } $posts = get_posts( $query_args ); if ( empty( $posts ) ) { return ''; } $wrapper_class = esc_attr( $atts['class'] ) . ' ' . esc_attr( $atts['class'] ) . '--cols-' . $columns; $html = '

'; foreach ( $posts as $p ) { $thumb = get_the_post_thumbnail_url( $p, 'large' ) ?: ''; $cats = get_the_category( $p->ID ); $primary_cat = ! empty( $cats ) ? $cats[0] : null; $html .= '

'; $html .= ''; if ( $thumb ) { $html .= '

'; if ( (int) $atts['show_category'] && $primary_cat ) { $html .= '' . esc_html( $primary_cat->name ) . ''; } $html .= '

'; } $html .= '

'; $html .= '

' . esc_html( get_the_title( $p ) ) . '

'; if ( (int) $atts['show_date'] ) { $html .= '' . esc_html( get_the_date( '', $p ) ) . ''; } if ( (int) $atts['show_excerpt'] ) { $excerpt = wp_strip_all_tags( get_the_excerpt( $p ) ); if ( $excerpt ) { $html .= '

' . esc_html( wp_trim_words( $excerpt, 22, '…' ) ) . '

'; } } $html .= '

'; $html .= ''; $html .= '

'; } $html .= '

'; return $html; } /** * Categories grid — real WordPress categories, no custom tables. */ public function categories_handler( $atts ) { $atts = shortcode_atts( array( 'limit' => 8, 'show_count' => 1, 'show_description' => 0, 'class' => 'category-list', ), $atts, 'lq_categories' ); $cats = get_categories( array( 'hide_empty' => true, 'number' => max( 1, min( 24, (int) $atts['limit'] ) ), 'orderby' => 'count', 'order' => 'DESC', ) ); if ( empty( $cats ) ) { return ''; } $html = '

'; foreach ( $cats as $cat ) { $html .= ''; } $html .= '

'; return $html; } /** * Navigation menu by theme location (falls back to the page list so a * fresh site without menus still renders a usable nav). */ public function menu_handler( $atts ) { $atts = shortcode_atts( array( 'location' => 'primary', 'menu' => '', 'class' => 'nav-menu', ), $atts, 'lq_menu' ); $args = array( 'container' => 'nav', 'container_class'=> esc_attr( $atts['class'] ), 'menu_class' => esc_attr( $atts['class'] ) . '-list', 'echo' => false, 'fallback_cb' => false, 'depth' => 2, ); if ( ! empty( $atts['menu'] ) ) { $args['menu'] = $atts['menu']; } elseif ( has_nav_menu( $atts['location'] ) ) { $args['theme_location'] = $atts['location']; } else { // Use the first menu that exists, whatever its location. $menus = wp_get_nav_menus(); if ( ! empty( $menus ) ) { $args['menu'] = $menus[0]->term_id; } } $out = wp_nav_menu( $args ); if ( $out ) return $out; // Last-resort fallback: pages list. $pages = wp_list_pages( array( 'echo' => false, 'title_li' => '' ) ); if ( ! $pages ) return ''; return ''; } /** * Customizer logo as , or linked site title fallback. */ public function site_logo_handler( $atts ) { $atts = shortcode_atts( array( 'class' => 'site-logo', 'width' => '', 'height' => '', ), $atts, 'lq_site_logo' ); $logo_id = get_theme_mod( 'custom_logo' ); if ( $logo_id ) { $url = wp_get_attachment_image_url( $logo_id, 'full' ); if ( $url ) { $dims = ''; if ( $atts['width'] ) $dims .= ' width="' . esc_attr( $atts['width'] ) . '"'; if ( $atts['height'] ) $dims .= ' height="' . esc_attr( $atts['height'] ) . '"'; return '' . ' ' . esc_attr( get_bloginfo( 'name' ) ) . '

' . esc_attr( get_bloginfo( 'name' ) ) . '

' . ''; } } return '' . esc_html( get_bloginfo( 'name' ) ) . ''; } public function site_title_handler( $atts ) { $atts = shortcode_atts( array( 'class' => 'site-title' ), $atts, 'lq_site_title' ); return '' . esc_html( get_bloginfo( 'name' ) ) . ''; } public function site_tagline_handler( $atts ) { $atts = shortcode_atts( array( 'class' => 'site-description' ), $atts, 'lq_site_tagline' ); $tagline = get_bloginfo( 'description' ); if ( ! $tagline ) return ''; return '' . esc_html( $tagline ) . ''; } }