• Listless I’m counting my [li]bullets[/li].

[quote]… me like my landlord![/quote]

$1

$1

$1

' . _x( ' Show Image', 'Comment image consent wrapper button.', 'fictioneer' ) . '

' . _x( ' Show Image', 'Comment image consent wrapper button.', 'fictioneer' ) . '

` or `` tags!
   *
   * @since 5.4.0
   *
   * @param string $html  The HTML string to be minified.
   *
   * @return string The minified HTML string.
   */

  function fictioneer_minify_html( $html ) {
    return preg_replace( '/\s+/', ' ', trim( $html ) );
  }
}

// =============================================================================
// MINIFY CSS
// =============================================================================

if ( ! function_exists( 'fictioneer_minify_css' ) ) {
  /**
   * Minify CSS.
   *
   * @license CC BY-SA 4.0
   * @author Qtax https://stackoverflow.com/users/107152/qtax
   * @author lots0logs https://stackoverflow.com/users/2639936/lots0logs
   *
   * @since 4.7.0
   * @link https://stackoverflow.com/a/15195752/17140970
   * @link https://stackoverflow.com/a/44350195/17140970
   *
   * @param string $string  The to be minified CSS string.
   *
   * @return string The minified CSS string.
   */

  function fictioneer_minify_css( $string = '' ) {
    $comments = <<<'EOS'
    (?sx)
        # don't change anything inside of quotes
        ( "(?:[^"\\]++|\\.)*+" | '(?:[^'\\]++|\\.)*+' )
    |
        # comments
        /\* (?> .*? \*/ )
    EOS;

    $everything_else = <<<'EOS'
    (?six)
        # don't change anything inside of quotes
        ( "(?:[^"\\]++|\\.)*+" | '(?:[^'\\]++|\\.)*+' )
    |
        # spaces before and after ; and }
        \s*+ ; \s*+ ( } ) \s*+
    |
        # all spaces around meta chars/operators (excluding + and -)
        \s*+ ( [*$~^|]?+= | [{};,>~] | !important\b ) \s*+
    |
        # all spaces around + and - (in selectors only!)
        \s*([+-])\s*(?=[^}]*{)
    |
        # spaces right of ( [ :
        ( [[(:] ) \s++
    |
        # spaces left of ) ]
        \s++ ( [])] )
    |
        # spaces left (and right) of : (but not in selectors)!
        \s+(:)(?![^\}]*\{)
    |
        # spaces at beginning/end of string
        ^ \s++ | \s++ \z
    |
        # double spaces to single
        (\s)\s+
    EOS;

    $search_patterns  = array( "%{$comments}%", "%{$everything_else}%" );
    $replace_patterns = array( '$1', '$1$2$3$4$5$6$7$8' );

    return preg_replace( $search_patterns, $replace_patterns, $string );
  }
}

// =============================================================================
// GET CLEAN CURRENT URL
// =============================================================================

if ( ! function_exists( 'fictioneer_get_clean_url' ) ) {
  /**
   * Returns URL without query arguments or page number
   *
   * @since 5.4.0
   *
   * @return string The clean URL.
   */

  function fictioneer_get_clean_url() {
    global $wp;

    // Setup
    $url = home_url( $wp->request );

    // Remove page (if any)
    $url = preg_replace( '/\/page\/\d+\/$/', '', $url );
    $url = preg_replace( '/\/page\/\d+$/', '', $url );

    // Return cleaned URL
    return $url;
  }
}

// =============================================================================
// GET AUTHOR IDS OF POST
// =============================================================================

if ( ! function_exists( 'fictioneer_get_post_author_ids' ) ) {
  /**
   * Returns array of author IDs for a post ID
   *
   * @since 5.4.8
   *
   * @param int $post_id  The post ID.
   *
   * @return array The author IDs.
   */

  function fictioneer_get_post_author_ids( $post_id ) {
    $author_ids = get_post_meta( $post_id, 'fictioneer_story_co_authors', true ) ?: [];
    $author_ids = is_array( $author_ids ) ? $author_ids : [];
    array_unshift( $author_ids, get_post_field( 'post_author', $post_id ) );

    return array_unique( $author_ids );
  }
}

// =============================================================================
// DELETE TRANSIENTS THAT INCLUDE A STRING
// =============================================================================

if ( ! function_exists( 'fictioneer_delete_transients_like' ) ) {
  /**
   * Delete Transients with a like key and return the count deleted
   *
   * Note: The fast variant of this function is not compatible with
   * external object caches such as Memcached, because without the
   * help of delete_transient(), it won't know about the change.
   *
   * @since 5.4.9
   *
   * @param string  $partial_key  String that is part of the key.
   * @param boolean $fast         Optional. Whether to delete with a single SQL query or
   *                              loop each Transient with delete_transient(), which can
   *                              trigger hooked actions (if any). Default false.
   *
   * @return int Count of deleted Transients.
   */

  function fictioneer_delete_transients_like( $partial_key, $fast = false ) {
    // Globals
    global $wpdb;

    // Setup
    $count = 0;

    // Fast?
    if ( $fast ) {
      // Prepare SQL
      $sql = $wpdb->prepare(
        "DELETE FROM $wpdb->options WHERE `option_name` LIKE %s OR `option_name` LIKE %s",
        "%_transient%{$partial_key}%",
        "%_transient_timeout%{$partial_key}%"
      );

      // Query
      $count = $wpdb->query( $sql );
    } else {
      // Prepare SQL
      $sql = $wpdb->prepare(
        "SELECT `option_name` AS `name` FROM $wpdb->options WHERE `option_name` LIKE %s",
        "_transient%{$partial_key}%"
      );

      // Query
      $transients = $wpdb->get_col( $sql );

      // Build full keys and delete
      foreach ( $transients as $transient ) {
        $key = str_replace( '_transient_', '', $transient );
        $count += delete_transient( $key ) ? 1 : 0;
      }
    }

    // Return count
    return $count;
  }
}

// =============================================================================
// GET OPTION PAGE LINK
// =============================================================================

if ( ! function_exists( 'fictioneer_get_assigned_page_link' ) ) {
  /**
   * Returns permalink for an assigned page or null
   *
   * @since 5.4.9
   *
   * @param string $option  The option name of the page assignment.
   *
   * @return string|null The permalink or null.
   */

  function fictioneer_get_assigned_page_link( $option ) {
    // Setup
    $page_id = get_option( $option );

    // Null if no page has been selected (null or -1)
    if ( empty( $page_id ) || $page_id < 0 ) {
      return null;
    }

    // Get permalink from options or post
    $link = get_option( "{$option}_link" );

    if ( empty( $link ) ) {
      $link = get_permalink( $page_id );
      update_option( "{$option}_link", $link, true ); // Save for next time
    }

    // Return
    return $link;
  }
}

// =============================================================================
// MULTI SAVE GUARD
// =============================================================================

if ( ! function_exists( 'fictioneer_multi_save_guard' ) ) {
  /**
   * Prevents multi-fire in update hooks
   *
   * Unfortunately, the block editor always fires twice: once as REST request and
   * followed by WP_POST. Only the first will have the correct parameters such as
   * $update set, the second is technically no longer an update. Since blocking
   * the follow-up WP_POST would block programmatically triggered actions, there
   * is no other choice but to block the REST request and live with it.
   *
   * @since 5.5.2
   *
   * @param int $post_id  The ID of the updated post.
   *
   * @return boolean True if NOT allowed, false otherwise.
   */

  function fictioneer_multi_save_guard( $post_id ) {
    // Always allow trash action to pass
    if ( get_post_status( $post_id ) === 'trash' ) {
      return false;
    }

    // Block REST requests and unnecessary triggers
    if (
      ( defined( 'REST_REQUEST' ) && REST_REQUEST && ! get_option( 'fictioneer_allow_rest_save_actions' ) ) ||
      wp_is_post_autosave( $post_id ) ||
      wp_is_post_revision( $post_id ) ||
      get_post_status( $post_id ) === 'auto-draft'
    ) {
      return true;
    }

    // Pass
    return false;
  }
}

// =============================================================================
// GET TOTAL WORD COUNT FOR ALL STORIES
// =============================================================================

if ( ! function_exists( 'fictioneer_get_stories_total_word_count' ) ) {
  /**
   * Returns the total word count of all published stories
   *
   * Note: Does not include standalone chapters for performance reasons.
   *
   * @since 4.0.0
   * @since 5.22.3 - Refactored with SQL query for better performance.
   *
   * @return int The word count of all published stories.
   */

  function fictioneer_get_stories_total_word_count() {
    // Look for cached value (purged after each update, should never be stale)
    $transient_word_count_cache = get_transient( 'fictioneer_stories_total_word_count' );

    // Return cached value if found
    if ( $transient_word_count_cache ) {
      return $transient_word_count_cache;
    }

    global $wpdb;

    // Setup
    $words = 0;

    // Sum of all word counts
    $words = $wpdb->get_var(
      $wpdb->prepare(
        "
        SELECT SUM(CAST(pm.meta_value AS UNSIGNED))
        FROM $wpdb->postmeta AS pm
        INNER JOIN $wpdb->posts AS p ON pm.post_id = p.ID
        WHERE pm.meta_key = %s
        AND p.post_type = %s
        AND p.post_status = %s
        ",
        'fictioneer_story_total_word_count',
        'fcn_story',
        'publish'
      )
    );

    // Customize
    $words = fictioneer_multiply_word_count( $words );

    // Cache for next time
    set_transient( 'fictioneer_stories_total_word_count', $words, DAY_IN_SECONDS );

    // Return newly calculated value
    return $words;
  }
}

// =============================================================================
// REDIRECT TO 404
// =============================================================================

if ( ! function_exists( 'fictioneer_redirect_to_404' ) ) {
  /**
   * Redirects the current request to the WordPress 404 page
   *
   * @since 5.6.0
   *
   * @global WP_Query $wp_query  The main WP_Query instance.
   */

  function fictioneer_redirect_to_404() {
    global $wp_query;

    // Remove scripts to avoid errors
    add_action( 'wp_print_scripts', function() {
      wp_dequeue_script( 'fictioneer-chapter-scripts' );
      wp_dequeue_script( 'fictioneer-suggestion-scripts' );
      wp_dequeue_script( 'fictioneer-tts-scripts' );
      wp_dequeue_script( 'fictioneer-story-scripts' );
    }, 99 );

    // Set query to 404
    $wp_query->set_404();
    status_header( 404 );
    nocache_headers();
    get_template_part( 404 );

    // Terminate
    exit();
  }
}

// =============================================================================
// PREVIEW ACCESS VERIFICATION
// =============================================================================

if ( ! function_exists( 'fictioneer_verify_unpublish_access' ) ) {
  /**
   * Verifies access to unpublished posts (not drafts)
   *
   * @since 5.6.0
   *
   * @return boolean True if access granted, false otherwise.
   */

  function fictioneer_verify_unpublish_access( $post_id ) {
    // Setup
    $post = get_post( $post_id );
    $authorized = false;

    // Always let owner to pass
    if ( get_current_user_id() === absint( $post->post_author ) ) {
      $authorized = true;
    }

    // Always let administrators pass
    if ( current_user_can( 'manage_options' ) ) {
      $authorized = true;
    }

    // Check capability for post type
    if ( $post->post_status === 'private' ) {
      switch ( $post->post_type ) {
        case 'post':
          $authorized = current_user_can( 'edit_private_posts' );
          break;
        case 'page':
          $authorized = current_user_can( 'edit_private_pages' );
          break;
        case 'fcn_chapter':
          $authorized = current_user_can( 'read_private_fcn_chapters' );
          break;
        case 'fcn_story':
          $authorized = current_user_can( 'read_private_fcn_stories' );
          break;
        case 'fcn_recommendation':
          $authorized = current_user_can( 'read_private_fcn_recommendations' );
          break;
        case 'fcn_collection':
          $authorized = current_user_can( 'read_private_fcn_collections' );
          break;
        default:
          $authorized = current_user_can( 'edit_others_posts' );
      }
    }

    // Drafts are handled by WordPress
    return apply_filters( 'fictioneer_filter_verify_unpublish_access', $authorized, $post_id, $post );
  }
}

// =============================================================================
// ADD ACTION TO SAVE/TRASH/UNTRASH/DELETE HOOKS WITH POST ID
// =============================================================================

/**
 * Adds callback to save, trash, untrash, and delete hooks (1 argument)
 *
 * This helper saves some time/space adding a callback action to all four
 * default post operations. But only with the first argument: post_id.
 *
 * @since 5.6.3
 *
 * @param callable $function  The callback function to be added.
 * @param int      $priority  Optional. Used to specify the order in which the
 *                            functions associated with a particular action are
 *                            executed. Default 10. Lower numbers correspond with
 *                            earlier execution, and functions with the same
 *                            priority are executed in the order in which they
 *                            were added to the action.
 *
 * @return true Will always return true.
 */

function fictioneer_add_stud_post_actions( $function, $priority = 10 ) {
  $hooks = ['save_post', 'trashed_post', 'delete_post', 'untrash_post'];

  foreach ( $hooks as $hook ) {
    add_action( $hook, $function, $priority );
  }

  return true;
}

// =============================================================================
// CONVERT URL LIST TO ARRAY
// =============================================================================

/**
 * Turn line-break separated list into array of links
 *
 * @since 5.7.4
 *
 * @param string $list  The list of links
 *
 * @return array The array of links.
 */

function fictioneer_url_list_to_array( $list ) {
  // Already array?
  if ( is_array( $list ) ) {
    return $list;
  }

  // Catch falsy values
  if ( empty( $list ) ) {
    return [];
  }

  // Prepare URLs
  $urls = [];
  $lines = explode( "\n", $list );

  // Extract
  foreach ( $lines as $line ) {
    $tuple = explode( '|', $line );
    $tuple = array_map( 'trim', $tuple );

    $urls[] = array(
      'name' => wp_strip_all_tags( $tuple[0] ),
      'url' => fictioneer_sanitize_url( $tuple[1] )
    );
  }

  // Return
  return $urls;
}

// =============================================================================
// ARRAY OPERATIONS
// =============================================================================

/**
 * Unset array element by value
 *
 * @since 5.7.5
 *
 * @param mixed $value  The value to look for.
 * @param array $array  The array to be modified.
 *
 * @return array The modified array.
 */

function fictioneer_unset_by_value( $value, $array ) {
  if ( ( $key = array_search( $value, $array ) ) !== false ) {
    unset( $array[ $key ] );
  }

  return $array;
}

// =============================================================================
// RETURN NO FORMAT STRING
// =============================================================================

/**
 * Returns an unformatted replacement string
 *
 * @since 5.7.5
 *
 * @return string Just a simple '%s'.
 */

function fictioneer__return_no_format() {
  return '%s';
}

// =============================================================================
// TRUNCATE STRING
// =============================================================================

/**
 * Returns a truncated string without tags
 *
 * @since 5.9.0
 *
 * @param string      $string    The string to truncate.
 * @param int         $length    Maximum length in characters.
 * @param string|null $ellipsis  Optional. Truncation indicator suffix.
 *
 * @return string The truncated string without tags.
 */

function fictioneer_truncate( string $string, int $length, string $ellipsis = null ) {
  // Setup
  $string = wp_strip_all_tags( $string ); // Prevent tags from being cut off
  $ellipsis = $ellipsis ?? FICTIONEER_TRUNCATION_ELLIPSIS;

  // Return truncated string
  if ( function_exists( 'mb_strimwidth' ) ) {
    return mb_strimwidth( $string, 0, $length, $ellipsis );
  } else {
    return strlen( $string ) > $length ? substr( $string, 0, $length ) . $ellipsis : $string;
  }
}

// =============================================================================
// COMPARE WORDPRESS VERSION
// =============================================================================

/**
 * Compare installed WordPress version against version string
 *
 * @since 5.12.2
 * @global wpdb $wp_version  Current WordPress version string.
 *
 * @param string $version   The version string to test against.
 * @param string $operator  Optional. How to compare. Default '>='.
 *
 * @return boolean True or false.
 */

function fictioneer_compare_wp_version( $version, $operator = '>=' ) {
  global $wp_version;

  return version_compare( $wp_version, $version, $operator );
}

// =============================================================================
// CSS LOADING PATTERN
// =============================================================================

if ( ! function_exists( 'fictioneer_get_async_css_loading_pattern' ) ) {
  /**
   * Returns the media attribute and loading strategy for stylesheets
   *
   * @since 5.12.2
   *
   * @return string Media attribute script for stylesheet links.
   */

  function fictioneer_get_async_css_loading_pattern() {
    if ( FICTIONEER_ENABLE_ASYNC_ONLOAD_PATTERN ) {
      return 'media="print" onload="this.media=\'all\'; this.onload=null;"';
    }

    return 'media="all"';
  }
}

// =============================================================================
// GENERATE PLACEHOLDER
// =============================================================================

if ( ! function_exists( 'fictioneer_generate_placeholder' ) ) {
  /**
   * Dummy implementation (currently used a CSS background)
   *
   * @since 5.14.0
   *
   * @param array|null $args  Optional arguments to generate a placeholder.
   *
   * @return string The placeholder URL or data URI.
   */

  function fictioneer_generate_placeholder( $args = [] ) {
    return '';
  }
}

// =============================================================================
// FIND USER(S)
// =============================================================================

/**
 * Find (first) user by display name
 *
 * @since 5.14.1
 *
 * @param string $display_name  The display name to search for.
 *
 * @return WP_User|null The first matching user or null if not found.
 */

function fictioneer_find_user_by_display_name( $display_name ) {
  // No choice but to query all because the display name is not unique
  $users = get_users(
    array(
      'search' => sanitize_user( $display_name ),
      'search_columns' => ['display_name'],
      'number' => 1
    )
  );

  // If found, return first
  if ( ! empty( $users ) ) {
    return $users[0];
  }

  // Not found
  return null;
}

// =============================================================================
// JOIN ARRAYS IN SPECIAL WAYS
// =============================================================================

if ( ! function_exists( 'fictioneer_get_human_readable_list' ) ) {
  /**
   * Join string in an array as human readable list.
   *
   * @since 5.15.0
   * @link https://gist.github.com/SleeplessByte/4514697
   *
   * @param array $array  Array of strings.
   *
   * @return string The human readable list.
   */

  function fictioneer_get_human_readable_list( $array ) {
    // Setup
    $comma = _x( ', ', 'Human readable list joining three or more items except the last two.', 'fictioneer' );
    $double = _x( ' or ', 'Human readable list joining two items.', 'fictioneer' );
    $final = _x( ', or ', 'Human readable list joining the last two of three or more items.', 'fictioneer' );

    // One or two items
    if ( count( $array ) < 3 ) {
      return implode( $double, $array );
    }

    // Three or more items
    array_splice( $array, -2, 2, implode( $final, array_slice( $array, -2, 2 ) ) );

    // Finish
    return implode( $comma , $array );
  }
}

// =============================================================================
// PATREON UTILITIES
// =============================================================================

/**
 * Get Patreon data for a post
 *
 * Note: Considers both the post meta and global settings.
 *
 * @since 5.15.0
 *
 * @param WP_Post|null $post  The post to check. Default to global $post.
 *
 * @return array|null Array with 'gated' (bool), 'gate_tiers' (array), 'gate_cents' (int),
 *                    and 'gate_lifetime_cents' (int). Null if the post could not be found.
 */

function fictioneer_get_post_patreon_data( $post = null ) {
  // Static cache
  static $cache = [];

  // Post?
  $post = $post ?? get_post();
  $post_id = $post->ID;

  if ( ! $post ) {
    return null;
  }

  // Check cache
  if ( isset( $cache[ $post_id ] ) ) {
    return $cache[ $post_id ];
  }

  // Setup
  $global_tiers = get_option( 'fictioneer_patreon_global_lock_tiers', [] ) ?: [];
  $global_amount_cents = get_option( 'fictioneer_patreon_global_lock_amount', 0 ) ?: 0;
  $global_lifetime_amount_cents = get_option( 'fictioneer_patreon_global_lock_lifetime_amount', 0 ) ?: 0;
  $post_tiers = get_post_meta( $post_id, 'fictioneer_patreon_lock_tiers', true );
  $post_tiers = is_array( $post_tiers ) ? $post_tiers : [];
  $post_amount_cents = absint( get_post_meta( $post_id, 'fictioneer_patreon_lock_amount', true ) );
  $check_tiers = array_merge( $global_tiers, $post_tiers );
  $check_tiers = array_unique( $check_tiers );
  $check_amount_cents = $post_amount_cents > 0 ? $post_amount_cents : $global_amount_cents;
  $check_amount_cents = $post_amount_cents > 0 && $global_amount_cents > 0
    ? min( $post_amount_cents, $global_amount_cents ) : $check_amount_cents;
  $check_amount_cents = max( $check_amount_cents, 0 );

  // Compile
  $data = array(
    'gated' => $check_tiers || $check_amount_cents > 0,
    'gate_tiers' => $check_tiers,
    'gate_cents' => $check_amount_cents,
    'gate_lifetime_cents' => $global_lifetime_amount_cents
  );

  // Cache
  $cache[ $post_id ] = $data;

  // Return
  return $data;
}

// =============================================================================
// ENCRYPTION/DECRYPTION
// =============================================================================

/**
 * Encrypt data
 *
 * @since 5.19.0
 *
 * @param mixed $data  The data to encrypt.
 *
 * @return string|false The encrypted data or false on failure.
 */

function fictioneer_encrypt( $data ) {
  $key = wp_salt();

  $encrypted = openssl_encrypt(
    json_encode( $data ),
    'aes-256-cbc',
    $key,
    0,
    substr( hash( 'sha256', $key ), 0, 16 )
  );

  if ( $encrypted === false ) {
    return false;
  }

  return base64_encode( $encrypted );
}

/**
 * Decrypt data
 *
 * @since 5.19.0
 *
 * @param string $data  The data to decrypt.
 *
 * @return mixed The decrypted data.
 */

function fictioneer_decrypt( $data ) {
  $key = wp_salt();

  $decrypted = openssl_decrypt(
    base64_decode( $data ),
    'aes-256-cbc',
    $key,
    0,
    substr( hash( 'sha256', $key ), 0, 16 )
  );

  return json_decode( $decrypted, true );
}

// =============================================================================
// RANDOM USERNAME
// =============================================================================

/**
 * Returns array of adjectives for randomized username generation
 *
 * @since 5.19.0
 *
 * @return array Array of nouns.
 */

function fictioneer_get_username_adjectives() {
  $adjectives = array(
    'Radical', 'Tubular', 'Gnarly', 'Epic', 'Electric', 'Neon', 'Bodacious', 'Rad',
    'Totally', 'Funky', 'Wicked', 'Fresh', 'Chill', 'Groovy', 'Vibrant', 'Flashy',
    'Buff', 'Hella', 'Motor', 'Cyber', 'Pixel', 'Holo', 'Stealth', 'Synthetic',
    'Enhanced', 'Synth', 'Bio', 'Laser', 'Virtual', 'Analog', 'Mega', 'Wave', 'Solo',
    'Retro', 'Quantum', 'Robotic', 'Digital', 'Hyper', 'Punk', 'Giga', 'Electro',
    'Chrome', 'Fusion', 'Vivid', 'Stellar', 'Galactic', 'Turbo', 'Atomic', 'Cosmic',
    'Artificial', 'Kinetic', 'Binary', 'Hypersonic', 'Runic', 'Data', 'Knightly',
    'Cryonic', 'Nebular', 'Golden', 'Silver', 'Red', 'Crimson', 'Augmented', 'Vorpal',
    'Ascended', 'Serious', 'Solid', 'Master', 'Prism', 'Spinning', 'Masked', 'Hardcore',
    'Somber', 'Celestial', 'Arcane', 'Luminous', 'Ionized', 'Lunar', 'Uncanny', 'Subatomic',
    'Luminary', 'Radiant', 'Ultra', 'Starship', 'Space', 'Starlight', 'Interstellar', 'Metal',
    'Bionic', 'Machine', 'Isekai', 'Warp', 'Neo', 'Alpha', 'Power', 'Unhinged', 'Ash',
    'Savage', 'Silent', 'Screaming', 'Misty', 'Rending', 'Horny', 'Dreadful', 'Bizarre',
    'Chaotic', 'Wacky', 'Twisted', 'Manic', 'Crystal', 'Infernal', 'Ruthless', 'Grim',
    'Mortal', 'Forsaken', 'Heretical', 'Cursed', 'Blighted', 'Scarlet', 'Delightful',
    'Nuclear', 'Azure', 'Emerald', 'Amber', 'Mystic', 'Ethereal', 'Enchanted', 'Valiant',
    'Fierce', 'Obscure', 'Enigmatic'
  );

  return apply_filters( 'fictioneer_random_username_adjectives', $adjectives );
}

/**
 * Returns array of nouns for randomized username generation
 *
 * @since 5.19.0
 *
 * @return array Array of nouns.
 */

function fictioneer_get_username_nouns() {
  $nouns = array(
    'Avatar', 'Cassette', 'Rubiks', 'Gizmo', 'Synthwave', 'Tron', 'Replicant', 'Warrior',
    'Hacker', 'Samurai', 'Cyborg', 'Runner', 'Mercenary', 'Shogun', 'Maverick', 'Glitch',
    'Byte', 'Matrix', 'Motion', 'Shinobi', 'Circuit', 'Droid', 'Virus', 'Vortex', 'Mech',
    'Codex', 'Hologram', 'Specter', 'Intelligence', 'Technomancer', 'Rider', 'Ghost',
    'Hunter', 'Hound', 'Wizard', 'Knight', 'Rogue', 'Scout', 'Ranger', 'Paladin', 'Sorcerer',
    'Mage', 'Artificer', 'Cleric', 'Tank', 'Fighter', 'Pilot', 'Necromancer', 'Neuromancer',
    'Barbarian', 'Streetpunk', 'Phantom', 'Shaman', 'Druid', 'Dragon', 'Dancer', 'Captain',
    'Pirate', 'Snake', 'Rebel', 'Kraken', 'Spark', 'Blitz', 'Alchemist', 'Dragoon', 'Geomancer',
    'Neophyte', 'Terminator', 'Tempest', 'Enigma', 'Automaton', 'Daemon', 'Juggernaut',
    'Paragon', 'Sentinel', 'Viper', 'Velociraptor', 'Spirit', 'Punk', 'Synth', 'Biomech',
    'Engineer', 'Pentagoose', 'Vampire', 'Soldier', 'Chimera', 'Lobotomy', 'Mutant',
    'Revenant', 'Wraith', 'Chupacabra', 'Banshee', 'Fae', 'Leviathan', 'Cenobite', 'Bob',
    'Ketchum', 'Collector', 'Student', 'Lover', 'Chicken', 'Alien', 'Titan', 'Sinner',
    'Nightmare', 'Bioplague', 'Annihilation', 'Elder', 'Priest', 'Guardian', 'Quagmire',
    'Berserker', 'Oblivion', 'Decimator', 'Devastation', 'Calamity', 'Doom', 'Ruin', 'Abyss',
    'Heretic', 'Armageddon', 'Obliteration', 'Inferno', 'Torment', 'Carnage', 'Purgatory',
    'Chastity', 'Angel', 'Raven', 'Star', 'Trinity', 'Idol', 'Eidolon', 'Havoc', 'Nirvana',
    'Digitron', 'Phoenix', 'Lantern', 'Warden', 'Falcon'
  );

  return apply_filters( 'fictioneer_random_username_nouns', $nouns );
}

/**
 * Returns randomized username
 *
 * @since 5.19.0
 *
 * @param bool $unique  Optional. Whether the username must be unique. Default true.
 *
 * @return string Sanitized random username.
 */

function fictioneer_get_random_username( $unique = true ) {
  // Setup
  $adjectives = fictioneer_get_username_adjectives();
  $nouns = fictioneer_get_username_nouns();

  // Shuffle the arrays to ensure more randomness
  shuffle( $adjectives );
  shuffle( $nouns );

  // Build username
  do {
    $username = $adjectives[ array_rand( $adjectives ) ] . $nouns[ array_rand( $nouns ) ] . rand( 1000, 9999 );
    $username = sanitize_user( $username, true );
  } while ( username_exists( $username ) && $unique );

  // Return username
  return $username;
}


// =============================================================================
// STRING LENGTH
// =============================================================================

if ( ! function_exists( 'mb_strlen' ) ) {
  /**
   * Fallback function for mb_strlen
   *
   * @param string $string    The string to being measured.
   * @param string $encoding  The character encoding. Default UTF-8.
   *
   * @return int The number of characters in the string.
   */

  function mb_strlen( $string, $encoding = 'UTF-8' ) {
    if ( $encoding !== 'UTF-8' ) {
      return strlen( $string );
    }

    $converted_string = iconv( $encoding, 'UTF-16', $string );

    if ( $converted_string === false ) {
      return strlen( $string );
    } else {
      return strlen( $converted_string ) / 2; // Each character is 2 bytes in UTF-16
    }
  }
}

// =============================================================================
// GET ALL PUBLISHING AUTHORS
// =============================================================================

/**
 * Returns all authors with published posts
 *
 * Note: Qualified post types are fcn_story, fcn_chapter, fcn_recommendation,
 * and post. The result is cached for 12 hours as Transient.
 *
 * @since 5.24.0
 * @link https://developer.wordpress.org/reference/functions/get_users/
 *
 * @param array $args  Optional. Array of additional query arguments.
 *
 * @return array Array of WP_User object, stdClass objects, or IDs.
 */

function fictioneer_get_publishing_authors( $args = [] ) {
  static $authors = null;

  $key = 'fictioneer_publishing_authors_' . md5( serialize( $args ) );

  if ( ! $authors && $transient = get_transient( $key ) ) {
    $authors = $transient;
  }

  if ( $authors ) {
    return $authors;
  }

  $authors = get_users(
    array_merge(
      array( 'has_published_posts' => ['fcn_story', 'fcn_chapter', 'fcn_recommendation', 'post'] ),
      $args
    )
  );

  set_transient( $key, $authors, 12 * HOUR_IN_SECONDS );

  return $authors;
}

// =============================================================================
// GET POST LABELS
// =============================================================================

/**
 * Returns the translated label of the post status
 *
 * @since 5.24.5
 *
 * @param string $status  Post status.
 *
 * @return string Translated label of the post status or the post status if custom.
 */

function fictioneer_get_post_status_label( $status ) {
  static $labels = null;

  if ( ! $labels ) {
    $labels = array(
      'draft' => get_post_status_object( 'draft' )->label,
      'pending' => get_post_status_object( 'pending' )->label,
      'publish' => get_post_status_object( 'publish' )->label,
      'private' => get_post_status_object( 'private' )->label,
      'future' => get_post_status_object( 'future' )->label,
      'trash' => get_post_status_object( 'trash' )->label
    );
  }

  return $labels[ $status ] ?? $status;
}

/**
 * Returns the translated label of the post type
 *
 * @since 5.25.0
 *
 * @param string $type  Post type.
 *
 * @return string Translated label of the post type or the post type if custom.
 */

function fictioneer_get_post_type_label( $type ) {
  static $labels = null;

  if ( ! $labels ) {
    $labels = array(
      'post' => _x( 'Post', 'Post type label.', 'fictioneer' ),
      'page' => _x( 'Page', 'Post type label.', 'fictioneer' ),
      'fcn_story' => _x( 'Story', 'Post type label.', 'fictioneer' ),
      'fcn_chapter' => _x( 'Chapter', 'Post type label.', 'fictioneer' ),
      'fcn_collection' => _x( 'Collection', 'Post type label.', 'fictioneer' ),
      'fcn_recommendation' => _x( 'Rec', 'Post type label.', 'fictioneer' )
    );
  }

  return $labels[ $type ] ?? $type;
}

// =============================================================================
// LOGS
// =============================================================================

/**
 * Returns (or creates) secret log hash used to obscure the log file name
 *
 * @since 5.24.1
 *
 * @return string  The log hash.
 */

function fictioneer_get_log_hash() {
  $hash = strval( get_option( 'fictioneer_log_hash' ) );

  if ( ! empty( $hash ) ) {
    return $hash;
  }

  $hash = wp_generate_password( 32, false );

  update_option( 'fictioneer_log_hash', $hash, 'no' );

  return $hash;
}

/**
 * Logs a message to the theme log file
 *
 * @since 5.0.0
 *
 * @param string       $message  What has been updated
 * @param WP_User|null $user     The user who did it. Defaults to current user.
 */

function fictioneer_log( $message, $current_user = null ) {
  // Setup
  $current_user = $current_user ?? wp_get_current_user();
  $username = _x( 'System', 'Default name in logs.', 'fictioneer' );
  $log_hash = fictioneer_get_log_hash();
  $log_file = WP_CONTENT_DIR . "/fictioneer-{$log_hash}-log.log";
  $log_limit = 5000;
  $date = current_time( 'mysql', true );

  if ( is_object( $current_user ) && $current_user->ID > 0 ) {
    $username = $current_user->user_login . ' #' . $current_user->ID;
  }

  if ( empty( $current_user ) && wp_doing_cron() ) {
    $username = 'WP Cron';
  }

  if ( empty( $current_user ) && wp_doing_ajax() ) {
    $username = 'AJAX';
  }

  $username = empty( $username ) ? __( 'Anonymous', 'fictioneer' ) : $username;

  // Make sure the log file exists
  if ( ! file_exists( $log_file ) ) {
    file_put_contents( $log_file, '' );
  }

  // Read
  $log_contents = file_get_contents( $log_file );

  // Parse
  $log_entries = explode( "\n", $log_contents );

  // Limit (if too large)
  $log_entries = array_slice( $log_entries, -($log_limit + 1) );

  // Add new entry
  $log_entries[] = "[{$date} UTC] [{$username}] $message";

  // Concatenate and save
  file_put_contents( $log_file, implode( "\n", $log_entries ) );

  // Set file permissions
  chmod( $log_file, 0600 );

  // Security
  $silence = WP_CONTENT_DIR . '/index.php';

  if ( ! file_exists( $silence ) ) {
    file_put_contents( $silence, "
No log entries yet.
';
  }

  // Read
  $log_contents = file_get_contents( $log_file );

  // Parse
  $log_entries = explode( "\n", $log_contents );

  // Limit display to 250
  $log_entries = array_slice( $log_entries, -250 );

  // Reverse
  $log_entries = array_reverse( $log_entries );

  // Build list items
  foreach ( $log_entries as $entry ) {
    $output .= '
' . esc_html( $entry ) . '
';
  }

  // Return HTML
  return '
' . $output . '
';
}

/**
 * Retrieves the debug log entries and returns an HTML representation
 *
 * @return string The HTML representation of the log entries.
 */

function fictioneer_get_wp_debug_log() {
  // Setup
  $log_file = WP_CONTENT_DIR . '/debug.log';
  $output = '';

  // Check whether log file exists
  if ( ! file_exists( $log_file ) ) {
    return '
No log entries yet.
';
  }

  // Read
  $log_contents = file_get_contents( $log_file );

  // Parse
  $log_entries = explode( "\n", $log_contents );

  // Limit display to 250
  $log_entries = array_slice( $log_entries, -250 );

  // Reverse
  $log_entries = array_reverse( $log_entries );

  // Build list items
  foreach ( $log_entries as $entry ) {
    $output .= '
' . esc_html( $entry ) . '
';
  }

  // Return HTML
  return '
' . $output . '
';
}