• Tetrakern released this 2024-04-25 19:00:17 +08:00 | 1695 commits to main since this release

    This is a huge one and brings a lot of new customization options, new page templates, and general improvements. Make sure to purge the theme caches after you update.

    Please consider supporting me on Ko-fi, Patreon, or via crypto donation if you like the theme.

    Highlight: New Shortcode Parameters

    You can now customize the output of shortcodes even further with new parameters. You can find examples in the documentation and on the demo page for shortcodes.

    • lightbox: If set to false/0, card images act like links instead of being opened in the lightbox (if enabled).
    • thumbnail: Whether the thumbnail should be rendered. Default true/1.
    • vertical: If set to true/1, card images are rendered on top and cover the entire card content width.
    • seamless: If set to true/1, this removes the gap between the card image and frame for vertical cards.
    • aspect_ratio: Changes the aspect ratio of vertical cards. Must be a valid width/height CSS value (e.g. "1/2").

    image

    Highlight: New (Story) Shortcodes

    When Fictioneer was first conceived, it was to support one author with many stories. Hence the small card shortcodes. But this does not necessarily work for all authors, especially those with only one large story, such as Katalepsis. While the theme is centered around chapters first, which is where visitors spend 90+ percent of their time, you still need some presentation around that. WordPress can be bend in any direction, but unless you have the technical expertise, this might prove difficult.

    Generic one-fits-all themes will always have limitations, no matter how many options. If you want to truly stand out, you need to invest into a custom child theme. But I believe with the new story shortcodes, you will be able to make a decent site with some creativity.

    Here is an example based on Katalepsis for a single-story front page. Really simple, far from what is actually possible. You can find a guide on how to do this in the updated documentation.

    New Shortcodes

    • fictioneer_subscribe_button: Displays the subscribe button.
    • fictioneer_font_awesome: Displays a Font Awesome icon.
    • fictioneer_story_actions: Displays the action row of a story (share button, RSS links, Follows, etc.)
    • fictioneer_story_section: Displays the chapter list and tabs of a story.
    • fictioneer_story_comments: Displays the collective comment loader of a story.
    • fictioneer_story_data: Displays a specific datum of a story (word count, chapter count, etc.).

    Release Notes

    • Fixed: The chapter index and navigation buttons now skip non-published posts
    • Fixed: No more errant em dashes on small chapter cards
    • Improved: Added shortcode params lightbox, vertical, seamless, thumbnail, and aspect_ratio
    • Improved: Added redirect URL meta field to stories (use with care)
    • Improved: Suggestion quotes now have a scroll anchor
    • Improved: Better compatibility with third-party comment plugins (tested for wpDiscuz)
    • New: Added option to change the comment form CSS selector
    • New: Added minimum and maximum words filter to search form
    • New: Added [fictioneer_subscribe_button] shortcode
    • New: Added [fictioneer_font_awesome] shortcode
    • New: Added [fictioneer_story_actions] shortcode
    • New: Added [fictioneer_story_section] shortcode
    • New: Added [fictioneer_story_comments] shortcode
    • New: Added [fictioneer_story_data] shortcode
    • New: Added "Story Page", "Index", and "Index (Advanced)" page templates
    • New: Added ascending/descending order toggle to comment section
    • New: Added customizer option for global placeholder image
    • Dev: fictioneer_get_support_links() function is no longer pluggable (use filter instead)
    • Dev: Added fictioneer_filter_get_support_links filter
    • Dev: Added fictioneer_filter_media_buttons filter
    • Dev: Fixed typo in the fictioneer_story_comments() function name
    • Dev: Merged _share-buttons.php into fictioneer_get_media_buttons() function
    • Dev: Merged _story-comments.php into fictioneer_story_comments() function
    • Dev: Removed unused fictioneer_the_author_node() function
    • Dev: Removed IDs from the comment form inputs to avoid collisions
    Downloads