';
echo '
' . esc_html__( 'Dashboard', '4wp-faq' ) . '
';
if ( isset( $_GET['forwp_faq_scan_done'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
echo '
';
echo esc_html__( 'Registry scan completed.', '4wp-faq' );
echo '
';
}
echo '
';
echo '';
if ( ! empty( $data['last_scan_label'] ) ) {
echo esc_html(
sprintf(
/* translators: %s: date/time */
__( 'Last scan: %s', '4wp-faq' ),
$data['last_scan_label']
)
);
} else {
echo esc_html__( 'Not scanned yet.', '4wp-faq' );
}
echo '';
if ( current_user_can( 'manage_options' ) ) {
echo '';
}
echo '
';
}
/**
* Which language the numbers are for; per-language breakdown when "All languages" is selected.
*
* @param array $data Dashboard data.
*/
public static function render_language_note( $data ) {
$name = isset( $data['language']['name'] ) ? (string) $data['language']['name'] : '';
if ( '' === $name ) {
return;
}
echo '';
echo esc_html(
sprintf(
/* translators: %s: language name or "All languages" */
__( 'Language: %s', '4wp-faq' ),
$name
)
);
echo '
';
$rows = isset( $data['by_language'] ) && is_array( $data['by_language'] ) ? $data['by_language'] : [];
if ( empty( $rows ) ) {
return;
}
echo '';
echo '| ' . esc_html__( 'Language', '4wp-faq' ) . ' | ';
echo '' . esc_html__( 'Questions', '4wp-faq' ) . ' | ';
echo '' . esc_html__( 'Categories', '4wp-faq' ) . ' | ';
echo '' . esc_html__( 'Uncategorized', '4wp-faq' ) . ' | ';
echo '' . esc_html__( 'Pages with FAQ', '4wp-faq' ) . ' | ';
echo '
';
foreach ( $rows as $row ) {
echo '';
echo '| ' . esc_html( (string) ( $row['name'] ?? '' ) ) . ' | ';
foreach ( [ 'questions', 'categories', 'uncategorized', 'pages' ] as $key ) {
echo '' . esc_html( number_format_i18n( (int) ( $row[ $key ] ?? 0 ) ) ) . ' | ';
}
echo '
';
}
echo '
';
}
/**
* Category slice widget — saved parent → child order, collapsible.
*/
public static function render_by_category() {
$data = self::data();
$items = isset( $data['by_category'] ) && is_array( $data['by_category'] ) ? $data['by_category'] : [];
if ( empty( $items ) ) {
self::render_empty( __( 'No FAQ categories yet.', '4wp-faq' ) );
return;
}
echo '';
self::render_category_rows( $items );
echo '
';
}
/**
* Render category rows recursively — collapsible when children exist.
*
* @param list> $items Tree nodes.
* @param int $depth Nesting depth.
*/
private static function render_category_rows( $items, $depth = 0 ) {
foreach ( $items as $item ) {
if ( ! is_array( $item ) ) {
continue;
}
$name = isset( $item['name'] ) ? (string) $item['name'] : '';
$count = isset( $item['count'] ) ? (int) $item['count'] : 0;
$url = isset( $item['url'] ) ? (string) $item['url'] : '';
$children = isset( $item['children'] ) && is_array( $item['children'] ) ? $item['children'] : [];
$term_id = isset( $item['id'] ) ? (int) $item['id'] : 0;
if ( ! empty( $children ) ) {
echo '';
echo '';
echo '';
if ( $url ) {
echo '' . esc_html( $name ) . '';
} else {
echo '' . esc_html( $name ) . '';
}
echo '' . esc_html( number_format_i18n( $count ) ) . '';
echo '
';
echo '';
self::render_category_rows( $children, $depth + 1 );
echo '
';
echo ' ';
echo '';
} else {
echo '';
if ( $url ) {
echo '' . esc_html( $name ) . '';
} else {
echo '' . esc_html( $name ) . '';
}
echo '' . esc_html( number_format_i18n( $count ) ) . '';
echo '';
}
}
}
/**
* Persist collapsed/expanded category state in the browser.
*
* @return string
*/
private static function category_tree_script() {
return <<<'JS'
jQuery(function($){
const storageKey = 'forwpFaqDashboardCategoryState';
const $details = $('#forwp_faq_by_category details[data-term-id]');
if (!$details.length) {
return;
}
let state = {};
try {
state = JSON.parse(window.localStorage.getItem(storageKey) || '{}') || {};
} catch (e) {
state = {};
}
$details.each(function(){
const termId = String($(this).data('term-id') || '');
if (!termId) {
return;
}
if (Object.prototype.hasOwnProperty.call(state, termId)) {
this.open = !!state[termId];
} else {
this.open = false;
}
});
$details.on('toggle', function(){
const termId = String($(this).data('term-id') || '');
if (!termId) {
return;
}
state[termId] = this.open;
try {
window.localStorage.setItem(storageKey, JSON.stringify(state));
} catch (e) {
// Ignore storage failures.
}
});
});
JS;
}
/**
* Most reused questions.
*/
public static function render_top_reused() {
$data = self::data();
$items = isset( $data['top_reused'] ) && is_array( $data['top_reused'] ) ? $data['top_reused'] : [];
if ( empty( $items ) ) {
self::render_empty( __( 'No reused questions yet.', '4wp-faq' ) );
return;
}
echo '';
foreach ( $items as $item ) {
$title = isset( $item['title'] ) ? (string) $item['title'] : '';
$count = isset( $item['count'] ) ? (int) $item['count'] : 0;
$url = isset( $item['edit_url'] ) ? (string) $item['edit_url'] : '';
echo '- ';
if ( $url ) {
echo '' . esc_html( $title ) . '';
} else {
echo '' . esc_html( $title ) . '';
}
echo '' . esc_html( number_format_i18n( $count ) ) . '';
echo '
';
}
echo '
';
}
/**
* Questions with no category.
*/
public static function render_uncategorized() {
$data = self::data();
$items = isset( $data['uncategorized'] ) && is_array( $data['uncategorized'] ) ? $data['uncategorized'] : [];
if ( empty( $items ) ) {
self::render_empty( __( 'Every question has a category.', '4wp-faq' ) );
return;
}
echo '';
foreach ( $items as $item ) {
$title = isset( $item['title'] ) ? (string) $item['title'] : '';
$url = isset( $item['edit_url'] ) ? (string) $item['edit_url'] : '';
echo '- ';
if ( $url ) {
echo '' . esc_html( $title ) . '';
} else {
echo '' . esc_html( $title ) . '';
}
echo '
';
}
echo '
';
}
/**
* Native empty-state block for dashboard widgets.
*
* @param string $message Empty copy.
* @param string $action Optional HTML (already escaped).
*/
private static function render_empty( $message, $action = '' ) {
echo '';
echo '
' . esc_html( $message ) . '
';
if ( '' !== $action ) {
echo '
' . $action . '
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built from escaped markup.
}
echo '