Elements
The purpose of this HTML is to help determine what default settings are with CSS and to make sure that all possible HTML Elements are included in this HTML so as to not miss any possible Elements when designing a site.
Shortcodes
Demonstration of all shortcodes and some possible configurations. See documentation for more details.
Story Actions Shortcode
Renders the action row of the specified story. All buttons and links will work as if on the story post, aside from the sharing modal which always refers to the current page. This only works on pages with the “Story Page” template set and is intended to create a single-story-centric front page.
- story_id (*): The ID of the story.
- class: Additional CSS classes, separated by whitespace.
- follow: Whether to render the Follow button (if enabled). Default true.
- reminder: Whether to render the Reminder button (if enabled). Default true.
- subscribe: Whether to render the Subscribe button (if enabled). Default true.
- download: Whether to render the ePUB/eBook download button (if enabled). Default true.
- rss: Whether to render the RSS link (if enabled). Default true.
- share: Whether to render the Share modal button (if enabled). Default true.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_story_actions story_id="106" follow="false" reminder="false"][fictioneer_story_actions story_id="182" follow="false" reminder="false" share="false" subscribe="false"]Story Section Shortcode
Renders the chapters, groups, and tabs of the specified story. It will look just as if on the story post. This only works on pages with the “Story Page” template set and is intended to create a single-story-centric front page.
- story_id (*): The ID of the story.
- class: Additional CSS classes, separated by whitespace.
- tabs: Whether to render the tabs (if any). Default false.
- blog: Whether to render the blog tab. Default false.
- pages: Whether to render the custom page tabs. Default false.
- scheduled: Whether to render the scheduled chapter note. Default false.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_story_section story_id="106"]- End’s Beginning and The Carriage that took us there 806 Words
- The Mansion 2,590 Words
- The Little Girl 2,424 Words
- Empty Cups and Empty Chairs 901 Words
- In Loving Memory 1,192 Words
- A Fancy Fleur 2,161 Words
- Redwood Grass 1,314 Words
- The Class 2,942 Words
- The Fairy in the Garden 1,685 Words
- The Third Big Question 1,196 Words
- Living After Death 2,087 Words
- Leap of Faith 7,403 Words
- A Reflection on God 319 Words
[fictioneer_story_section story_id="182" tabs="true" pages="true" blog="true"]This is an extra page attached to the story. You can add up to four pages with any content here, provided you also fill out the Short Name property. As you can see, there is not much space for the tabs, so take that into account. Although they can wrap without breaking the layout, it does not quite look as good.
Ideas:
- Artworks (or memes)
- Lore and history
- Character portfolios (meh)
- Timeline
- Glossary
- Related works
- Of Bridges and Buses Warning: Spooky Ghosts! Wooooo 4,865 Words
- Blog Post – The Last Resort: This is a test post to show the Blog tab in the The Last Resort story. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur luctus mattis…
Story Comments Shortcode
Renders the button to load the collective comments made on chapters in the story. Not to be confused with the comments you can make on the page, which are completely separate. This only works on pages with the “Story Page” template set and is intended to create a single-story-centric front page.
- story_id (*): The ID of the story.
- class: Additional CSS classes, separated by whitespace.
- header: Whether to render the heading with count. Default true.
[fictioneer_story_comments story_id="13" header="false"]Story Data Shortcode
Renders a single datum from the specified story, such as the word count or age rating. You can use this to show your own self-updating statistics. Just omit the shortcode block and write it directly into the text.
- data (*): The requested data, singular. Choose between word_count, chapter_count, status, icon (status), age_rating, rating_letter, comment_count, id, date, time, datetime, categories, tags, genres, fandoms, characters, and warnings.
- story_id: The ID of the story. Defaults to current post ID.
- format: Special formatting for some data. Mostly used for counts, use “short” or “raw”.
- date_format: Formatting string for the date. Defaults to your WordPress settings.
- time_format: Formatting string for the time. Defaults to your WordPress settings.
- separator: String between list items, such as tags. Defaults to “, ” (comma + whitespace).
- tag: Wrapping HTML tag. Defaults to “span”.
- class: Additional CSS classes, separated by whitespace.
- inner_class: Additional CSS classes for nested elements (if any), separated by whitespace.
- style: Inline CSS style applied to the wrapping element.
- inner_style: Inline CSS style applied to nested elements (if any).
The example story Katalepsis has [fictioneer_story_data story_id="13" data="chapter_count"] chapters featured on this site, containing a total of [fictioneer_story_data story_id="13" data="word_count"] words.The example story Katalepsis has 17 chapters featured on this site, containing a total of 95,765 words.
You can format the word count with "raw" ([fictioneer_story_data story_id="13" data="word_count" format="raw"]) or "short" ([fictioneer_story_data story_id="13" data="word_count" format="short"]).You can format the word count with “raw” (95765) or “short” (95.8 K).
Katalepsis has the following tags: [fictioneer_story_data story_id="13" data="tags" separator=" | " inner_style="color: var(--red-500);"].Katalepsis has the following tags: Drugs|Magic|Mental Illness|Polyamory.
Subscribe Button Shortcode
Renders a subscribe button for the specified story.
- story_id (*): The ID of the story the button is for.
- class: Additional CSS classes, separated by whitespace.
[fictioneer_subscribe_button story_id="228"]Font Awesome Shortcode
Renders a free Font Awesome icon, which you could technically do manually in the code editor as well. Somewhat more convenient, I guess? Just omit the shortcode block and write it directly into the text.
- class (*): Font Awesome CSS classes, separated by whitespace. You can custom ones, too.
Have some [fictioneer_fa class="fa-solid fa-mug-hot"]Have some
Tooltip Shortcode & Footnotes
Includes a tooltip modal for the wrapped content, indicated by a dotted underline. Just omit the shortcode block and write it directly into the text. This shortcode also works if your role lacks the shortcode capability. If you enable the footnotes feature under Fictioneer > General > Features, the tooltips will also be appended to the content as footnotes.
Formatting: You can use HTML in the shortcode content attribute, as far as the post sanitizer and user role allows. However, be cautious of nested quotation marks and square brackets, as they can break the shortcode — use HTML entities instead.
Footnotes: There is no difference in use to append the tooltips as footnotes, complete with anchor link. Just enable the rendering globally. You can disable individual footnotes with the footnote="false" parameter (but not the other way around).
[fcnt header="Are you dense?" content="This <em>typically</em> refers to forms that are either literal <strong>skeletons</strong> or the underlying bearing *structure* of objects."]skeletal shapes[/fcnt]I was trying very hard not to look at the twitching skeletal shapes1 descending from the ridge, creeping toward us through the mist.
Article Cards Shortcode
Renders a multi-column grid of paginated medium cards ordered by publishing date, descending. Unless you provide the count parameter, only add this once per page since it uses the main query page argument. The thumbnail is either the Landscape Image or Cover Image, depending on the aspect ratio and availability, with chapters defaulting to the parent story.
- post_type: Comma-separated list of post types to query. Default post.
- post_ids: Limit query to a comma-separated list of post IDs.
- per_page: Number of posts per page. Defaults to theme settings.
- count: Limit the number of items. Default -1 (all).
- order: Either DESC (descending) or ASC (ascending). Default DESC.
- orderby: The default is date (published), but you can also use modified and more.
- ignore_sticky: Whether sticky posts should be ignored or not. Default false.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- fandoms: Limit query to a comma-separated list of fandom names (case-insensitive).
- genres: Limit query to a comma-separated list of genre names (case-insensitive).
- characters: Limit query to a comma-separated list of character names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- seamless: Whether to remove the gap between the image and frame. Default false (Customizer).
- thumbnail: Whether to show the thumbnail/cover image. Default true (Customizer).
- aspect_ratio: CSS aspect-ratio value for the image (X/Y). Default “3/1”.
- terms: Either inline, pills, or none. Default inline.
- max_terms: Maximum number of shown taxonomies. Default 10.
- date_format: String to override the date format. Default empty.
- footer: Whether to show the footer (if any). Default true.
- footer_author: Whether to show the author. Default true.
- footer_date: Whether to show the date. Default true.
- footer_comments: Whether to show the comment count (not in lists). Default true.
- class: Additional CSS classes, separated by whitespace.
- splide: Configuration JSON to turn the grid into a slider. See Slider.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_article_cards post_type="post" per_page="2" ignore_sticky="true"]-
Elements
The purpose of this HTML is to help determine what default settings are with CSS and to make sure that all possible HTML Elements are included in this HTML so as to not miss any possible Elements when designing a site. -
Blog Post – The Sapphire Shadow
This is a test post to show the Blog tab in the The Sapphire Shadow story. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur luctus mattis sapien, sed consectetur nulla ullamcorper id. Nullam vehicula massa vel ultrices accumsan. Vivamus faucibus purus a nisl vehicula maximus. In rutrum convallis dolor id ornare. In aliquam mollis lectus molestie pulvinar. Duis tristique maximus nibh bibendum pretium. Pellentesque habitant…
[fictioneer_article_cards post_type="story, chapter" count="2" orderby="rand" cache="false" seamless="true" aspect_ratio="4/1"]-
02 – Pilot Run
There wasn’t much happening in the fashion district at four in the morning. Nadia had parked her scooter some blocks away and calmly walked down small alleys and side streets without seeing a soul. If she had run into someone, all they would have seen was a young woman with a black turtleneck peeking out over the collar of a white trench coat. “Voice… -
Katalepsis
Nightmares and hallucinations have plagued Heather Morell all her life, relics of schizophrenia and childhood bereavement. Until she meets Raine and Evelyn, that is — self-proclaimed bodyguard and bad-tempered magician — and learns she’s not insane at all. The spirits and monsters she sees are all too real, the god-thing in her nightmares is teaching her how to surpass human limits, and her twin…
[fictioneer_article_cards post_type="story, chapter" count="4" orderby="rand" cache="false" seamless="true" aspect_ratio="4/1" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 2, 'breakpoints': {'767': {'perPage': 1}}}"]-
providence or atoms – 2.7
The mitten saved me. Raine helped. The Dark Hand gripped my wrist, but simple screaming terror wrapped around my heart. No need for paralysing supernatural force to immobilise me. Here was an unspoken fear from the darkest nights of my ruined childhood: Wonderland reaching out to snatch me away. Bone-freezing cold soaked through the mitten and into my flesh. The Dark Hand pulled. Raine… -
corpus – 1.5
Elpida had made sure that every member of the cadre was trained in close-quarters combat — unarmed or otherwise. Even the few who had no natural aptitude, like Bug, or Shade. At thirteen years old she’d spent six painstaking months personally coaching Shade every day, both of them black and blue all over, sleeping together in each others’ scent, until Shade could last five… -
corpus – 1.1
A blossom of alchemical fire grew in quiet flesh; a spark took hold in the wet crimson darkness of muscle and marrow and memory. And Elpida choked back to life inside her own coffin. Blank grey steel, inches from her nose. Eyes aching like spent coals, lids rasping like sandpaper. A shallow layer of cold, greasy fluid clung to her back, her buttocks, the… -
corpus – 1.2
Elpida scrambled out of her coffin and landed on cold metal. The drop to the floor was a greater distance than she’d expected, her joints were stiff as fresh-drawn wire, and her soles were slicked with that thin, greasy fluid. Lances of red light strobed and stabbed, a flicker of electric blood in the air; the alarm pulsed out a moaning dirge; voices screamed…
Blog Shortcode
Renders paginated blog posts akin to the main blog page, but with options. Only add this once per page since it uses the main query page argument, avoid combining it with the Article Cards shortcode.
- per_page: Number of posts per page. Defaults to theme settings.
- ignore_sticky: Whether sticky posts should be ignored or not. Default false.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Comma-separated list of required categories.
- tags: Comma-separated list of required tags.
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- class: Additional CSS classes, separated by whitespace.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_blog class="inner-blog something-else" per_page="1" categories="uncategorized"]Search Form Shortcode
Renders the search form with advanced options (if not disabled in the settings).
- simple: Set true if you want to hide the advanced form. Default false.
- placeholder: Change the placeholder text of the input field.
- type: Preselect either any, story, chapter, recommendation, collection, or post.
- expanded: Whether the advanced form is expanded. Default false.
- tags: Preselect tags as comma-separated list of term IDs.
- genres: Preselect genres as comma-separated list of term IDs.
- fandoms: Preselect fandoms as comma-separated list of term IDs.
- characters: Preselect characters as comma-separated list of term IDs.
- warnings: Preselect warnings as comma-separated list of term IDs.
[fictioneer_search][fictioneer_search type="story"][fictioneer_search simple="true" placeholder="What are you looking for?"]Chapter List Shortcode
Renders a list of chapters identical to those on story pages, ordered by sequence in the source. Must have either the story_id or chapter_ids parameter, but not both.
- story_id (*): ID of a single story. Use either this or chapter_ids.
- chapter_ids (*): Comma-separated list of chapter IDs. Use either this or story_id.
- count: Limit the number of items. Default -1 (all).
- offset: Skip a number of chapters, which can make sense if you query all.
- heading: Show a heading as collapsible toggle above the list.
- group: Only show chapters with a specific group name. Beware, this can jump stories.
- class: Additional CSS classes, separated by whitespace.
no-auto-collapseprevents default group collapsing (if set). - cache: Whether the shortcode should be cached. Default true.
[fictioneer_chapter_list story_id="13" count="3" offset="1"]- mind; correlating – 1.2 5,949 Words
- mind; correlating – 1.3 5,242 Words
- mind; correlating – 1.4 4,509 Words
[fictioneer_chapter_list story_id="228" group="rapax" heading="Arc 2 from Necroepilogos"]- rapax – 2.1 3,220 Words
- rapax – 2.2 3,376 Words
[fictioneer_chapter_list chapter_ids="292,236,195,109,29" heading="Chapters from several stories"]- 01 – Compulsive 3,143 Words
- corpus – 1.1 2,388 Words
- Of Bridges and Buses Warning: Spooky Ghosts! Wooooo 4,865 Words
- End’s Beginning and The Carriage that took us there 806 Words
- mind; correlating – 1.1 8,040 Words
Latest Stories Shortcode
Renders a multi-column grid of small cards, showing the latest four stories ordered by publishing date, descending. Note that the list type behaves a bit different with the parameters.
- count: Limit the number of items. Default 4.
- type: Either default or compact. The compact variant is smaller with less data.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- order: Either DESC (descending) or ASC (ascending). Default DESC.
- orderby: The default is date (published), but you can also use modified and more.
- post_ids: Limit query to a comma-separated list of story post IDs.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- fandoms: Limit query to a comma-separated list of fandom names (case-insensitive).
- genres: Limit query to a comma-separated list of genre names (case-insensitive).
- characters: Limit query to a comma-separated list of character names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- source: Set false to hide the author node. Default true.
- vertical: Whether to render the cards with the image on top. Default false.
- seamless: Whether to remove the gap between the image and frame. Default false (Customizer).
- thumbnail: Whether to show the thumbnail/cover image. Default true (Customizer).
- infobox: Whether to show the info box and toggle on compact versions. Default true.
- aspect_ratio: CSS aspect-ratio value for the image (X/Y; vertical only). Default “3/1”.
- terms: Either inline, pills, or none. Default inline.
- max_terms: Maximum number of shown taxonomies. Default 10.
- date_format: String to override the date format. Default empty.
- footer: Whether to show the footer (if any). Default true.
- footer_author: Whether to show the author. Default true.
- footer_chapters: Whether to show the chapter count (not in lists). Default true.
- footer_words: Whether to show the word count. Default true.
- footer_date: Whether to show the date. Default true.
- footer_status: Whether to show the status. Default true.
- footer_rating: Whether to show the age rating. Default true.
- class: Additional CSS classes, separated by whitespace.
- splide: Configuration JSON to turn the grid into a slider. See Slider.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_latest_stories count="2"]-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes. -
Necroepilogos
Nothing walks the black cinder of Earth except the undead leftovers, reanimated by science so advanced it may as well be magic. Twisted into unimaginable forms by flesh-shaping and machine-grafting, the undead are the only remnant of a civilization reduced to bitter ash and organic slurry.
[fictioneer_latest_stories count="2" author="Hungry" seamless="true"]-
Necroepilogos
Nothing walks the black cinder of Earth except the undead leftovers, reanimated by science so advanced it may as well be magic. Twisted into unimaginable forms by flesh-shaping and machine-grafting, the undead are the only remnant of a civilization reduced to bitter ash and organic slurry. -
Katalepsis
Nightmares and hallucinations have plagued Heather Morell all her life, relics of schizophrenia and childhood bereavement. Until she meets Raine and Evelyn, that is — self-proclaimed bodyguard and bad-tempered magician — and learns she’s not insane at all. The spirits and monsters she sees are all too real, the god-thing in her nightmares is teaching her how to surpass human limits, and her twin sister who supposedly never existed could still be alive, somewhere Outside, beyond the walls of reality.
[fictioneer_latest_stories count="2" type="compact" orderby="rand" order="asc" author="Monochromatic"]-
Crimson Lips
Amidst the beautiful and unforgiving city of Canterlot, where prejudice is rampant and passion even more so, two women forge an unlikely bond and explore the answer to a simple question: is selling your body the same as selling yourself? -
The Last Resort
Finding herself at the end of her rope, the broke and directionless Sophia Majorelle decides to take a skeevy job offer to work at a hotel she’s never heard of. Sure, she didn’t expect its owner to be a pseudo-Grim Reaper and for the hotel itself to be in the afterlife but, well, it’s not like she had anything better waiting for her.
[fictioneer_latest_stories count="2" type="compact" orderby="rand" vertical="true" aspect_ratio="3/2"]-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes. -
Necroepilogos
Nothing walks the black cinder of Earth except the undead leftovers, reanimated by science so advanced it may as well be magic. Twisted into unimaginable forms by flesh-shaping and machine-grafting, the undead are the only remnant of a civilization reduced to bitter ash and organic slurry.
[fictioneer_latest_stories count="6" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 2, 'breakpoints': {'767': {'perPage': 1}}}"]-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes. -
Necroepilogos
Nothing walks the black cinder of Earth except the undead leftovers, reanimated by science so advanced it may as well be magic. Twisted into unimaginable forms by flesh-shaping and machine-grafting, the undead are the only remnant of a civilization reduced to bitter ash and organic slurry. -
The Last Resort
Finding herself at the end of her rope, the broke and directionless Sophia Majorelle decides to take a skeevy job offer to work at a hotel she’s never heard of. Sure, she didn’t expect its owner to be a pseudo-Grim Reaper and for the hotel itself to be in the afterlife but, well, it’s not like she had anything better waiting for her. -
Crimson Lips
Amidst the beautiful and unforgiving city of Canterlot, where prejudice is rampant and passion even more so, two women forge an unlikely bond and explore the answer to a simple question: is selling your body the same as selling yourself? -
Katalepsis
Nightmares and hallucinations have plagued Heather Morell all her life, relics of schizophrenia and childhood bereavement. Until she meets Raine and Evelyn, that is — self-proclaimed bodyguard and bad-tempered magician — and learns she’s not insane at all. The spirits and monsters she sees are all too real, the god-thing in her nightmares is teaching her how to surpass human limits, and her twin sister who supposedly never existed could still be alive, somewhere Outside, beyond the walls of reality.
[fictioneer_latest_stories count="2" type="list"][fictioneer_latest_stories count="2" type="list" footer_status="false" footer_rating="false" terms="pills" aspect_ratio="2/3"]Latest Updates Shortcode
Renders a multi-column grid of small cards, showing the latest four updated stories ordered by date of the last chapter change, descending. Note that the list type behaves a bit different with the parameters.
- count: Limit the number of items. Default 4.
- type: Either default, simple, single, or compact. The other variants are smaller with less data.
- single: Whether to show only one chapter item. Default false.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- order: Either DESC (descending) or ASC (ascending). Default DESC.
- post_ids: Limit query to a comma-separated list of post IDs.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- fandoms: Limit query to a comma-separated list of fandom names (case-insensitive).
- genres: Limit query to a comma-separated list of genre names (case-insensitive).
- characters: Limit query to a comma-separated list of character names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- source: Set false to hide the author node. Default true.
- vertical: Whether to render the cards with the image on top. Default false.
- seamless: Whether to remove the gap between the image and frame. Default false (Customizer).
- thumbnail: Whether to show the thumbnail/cover image. Default true (Customizer).
- lightbox: Whether clicking on the thumbnail/cover image opens the lightbox or post link. Default true.
- infobox: Whether to show the info box and toggle on compact versions. Default true.
- aspect_ratio: CSS aspect-ratio value for the image (X/Y; vertical only). Default “3/1”.
- words: Whether to show the word count of chapter items. Default true.
- date: Whether to show the date of chapter items. Default true.
- terms: Either inline, pills, or none. Default inline.
- max_terms: Maximum number of shown taxonomies. Default 10.
- date_format: String to override the date format. Default empty.
- nested_date_format: String to override any nested date formats. Default empty.
- footer: Whether to show the footer (if any). Default true.
- footer_author: Whether to show the author. Default true.
- footer_chapters: Whether to show the chapter count (not in lists). Default true.
- footer_words: Whether to show the word count. Default true.
- footer_date: Whether to show the date. Default true.
- footer_status: Whether to show the status. Default true.
- footer_rating: Whether to show the age rating. Default true.
- class: Additional CSS classes, separated by whitespace.
- splide: Configuration JSON to turn the grid into a slider. See Slider.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_latest_updates count="2"]-
Crimson Lips
Amidst the beautiful and unforgiving city of Canterlot, where prejudice is rampant and passion even more so, two women forge an unlikely bond and explore the answer to a simple question: is selling your body the same as selling yourself?- 319 • Jan 9
- 7.4 K • Jan 9
-
-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes.- 7.6 K • Jan 15
- 3.5 K • Jan 15
-
[fictioneer_latest_updates count="2" type="simple" order="asc" author="Hungry"]-
Katalepsis
Nightmares and hallucinations have plagued Heather Morell all her life, relics of schizophrenia and childhood bereavement. Until she meets Raine and Evelyn, that is — self-proclaimed bodyguard and bad-tempered magician — and learns she’s not insane at all. The spirits and monsters she sees are all too real, the god-thing in her nightmares is teaching her how to surpass human limits, and her twin sister who supposedly never existed could still be alive, somewhere Outside, beyond the walls of reality.- 4.7 K • Jan 9
- 5.1 K • Jan 9
-
-
Necroepilogos
Nothing walks the black cinder of Earth except the undead leftovers, reanimated by science so advanced it may as well be magic. Twisted into unimaginable forms by flesh-shaping and machine-grafting, the undead are the only remnant of a civilization reduced to bitter ash and organic slurry.- 3.4 K • Jan 14
- 3.2 K • Jan 14
-
[fictioneer_latest_updates type="compact" order="asc" post_ids="13,106" seamless="true" words="false"]-
Katalepsis
Nightmares and hallucinations have plagued Heather Morell all her life, relics of schizophrenia and childhood bereavement. Until she meets Raine and Evelyn, that is — self-proclaimed bodyguard and bad-tempered magician — and learns she’s not insane at all. The spirits and monsters she sees are all too real, the god-thing in her nightmares is teaching her how to surpass human limits, and her twin sister who supposedly never existed could still be alive, somewhere Outside, beyond the walls of reality.- Jan 9
-
-
Crimson Lips
Amidst the beautiful and unforgiving city of Canterlot, where prejudice is rampant and passion even more so, two women forge an unlikely bond and explore the answer to a simple question: is selling your body the same as selling yourself?- Jan 9
-
[fictioneer_latest_updates type="compact" genres="cyberpunk, slice of life" vertical="true" seamless="true"]-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes.- 7.6 K • Jan 15
-
-
The Last Resort
Finding herself at the end of her rope, the broke and directionless Sophia Majorelle decides to take a skeevy job offer to work at a hotel she’s never heard of. Sure, she didn’t expect its owner to be a pseudo-Grim Reaper and for the hotel itself to be in the afterlife but, well, it’s not like she had anything better waiting for her.- 4.9 K • Jan 16
-
[fictioneer_latest_updates type="single" count="2" date="false"]-
Crimson Lips
Amidst the beautiful and unforgiving city of Canterlot, where prejudice is rampant and passion even more so, two women forge an unlikely bond and explore the answer to a simple question: is selling your body the same as selling yourself?- 319
-
-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes.- 7.6 K
-
[fictioneer_latest_updates type="single" count="4" date="false" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 2, 'breakpoints': {'767': {'perPage': 1}}}"]-
Crimson Lips
Amidst the beautiful and unforgiving city of Canterlot, where prejudice is rampant and passion even more so, two women forge an unlikely bond and explore the answer to a simple question: is selling your body the same as selling yourself?- 319
-
-
The Sapphire Shadow
Nadia was born the heiress to a corporate empire, destined for a life of wealth and privilege in what used to be America. But she would rather spend her time committing high-tech heists, aided and abetted by her oldest friend, Tess. Tess is a technical genius, a snarky hacker who designed and built her own right arm, and together, they pull off a series of daring crimes.- 7.6 K
-
-
Necroepilogos
Nothing walks the black cinder of Earth except the undead leftovers, reanimated by science so advanced it may as well be magic. Twisted into unimaginable forms by flesh-shaping and machine-grafting, the undead are the only remnant of a civilization reduced to bitter ash and organic slurry.- 3.4 K
-
-
The Last Resort
Finding herself at the end of her rope, the broke and directionless Sophia Majorelle decides to take a skeevy job offer to work at a hotel she’s never heard of. Sure, she didn’t expect its owner to be a pseudo-Grim Reaper and for the hotel itself to be in the afterlife but, well, it’s not like she had anything better waiting for her.- 4.9 K
-
[fictioneer_latest_updates type="list" count="2" nested_date_format="m/d/Y"][fictioneer_latest_updates type="list" count="2" seamless="true" date="false" words="false" footer_rating="false" terms="pills"]Latest Chapters Shortcode
Renders a multi-column grid of small cards, showing the latest four chapters ordered by publishing date, descending. Note that the list type behaves a bit different with the parameters.
- count: Limit the number of items. Default 4.
- type: Either default, simple, or compact. The other variants are smaller with less data.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- order: Either DESC (descending) or ASC (ascending). Default DESC.
- orderby: The default is date (published), but you can also use modified and more.
- post_ids: Limit query to a comma-separated list of chapter post IDs.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- spoiler: Set true if you do not want to obfuscate the excerpt. Default false.
- source: Set false to hide the author and story nodes. Default true.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- fandoms: Limit query to a comma-separated list of fandom names (case-insensitive).
- genres: Limit query to a comma-separated list of genre names (case-insensitive).
- characters: Limit query to a comma-separated list of character names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- vertical: Whether to render the cards with the image on top. Default false.
- seamless: Whether to remove the gap between the image and frame. Default false (Customizer).
- thumbnail: Whether to show the thumbnail/cover image. Default true (Customizer).
- lightbox: Whether clicking on the thumbnail/cover image opens the lightbox or post link. Default true.
- infobox: Whether to show the info box and toggle on compact versions. Default true.
- aspect_ratio: CSS aspect-ratio value for the image (X/Y; vertical only). Default “3/1”.
- date_format: String to override the date format. Default empty.
- footer: Whether to show the footer (if any). Default true.
- footer_author: Whether to show the author. Default true.
- footer_words: Whether to show the word count. Default true.
- footer_date: Whether to show the date. Default true.
- footer_comments: Whether to show the comment count (not in lists). Default true.
- footer_status: Whether to show the status. Default true.
- footer_rating: Whether to show the age rating. Default true.
- class: Additional CSS classes, separated by whitespace.
- splide: Configuration JSON to turn the grid into a slider. See Slider.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_latest_chapters count="2" order="asc" spoiler="true"]-
1.2 – mind; correlating
in Katalepsis — “Can’t miss it” turned out to be a typically Raine-like oversight. The Medieval Metaphysics Department was hidden away in the furthest corner of Sharrowford University’s “new” building, Willow House, a snaking four-story structure of Brutalist… -
1.3 – mind; correlating
in Katalepsis — Slipping was never the same twice. Once, when I was twelve years old, it gripped me as I stepped into the shower. A jerk and a twist and another world bloomed around me; I crept naked for hours through a rotting jungle beneath a throbbing black sun. My…
[fictioneer_latest_chapters count="2" type="simple"][fictioneer_latest_chapters count="2" type="compact" author="james_wake" orderby="rand"][fictioneer_latest_chapters type="compact" post_ids="272,302" source="false" seamless="true"][fictioneer_latest_chapters orderby="rand" count="2" source="false" vertical="true" seamless="true" aspect_ratio="5/1"]
[fictioneer_latest_chapters orderby="rand" count="4" source="false" vertical="true" seamless="true" aspect_ratio="5/1" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 2, 'breakpoints': {'767': {'perPage': 1}}}"][fictioneer_latest_chapters type="list" count="2"][fictioneer_latest_chapters type="list" orderby="rand" count="2" source="false" footer_status="false"]Latest Recommendations Shortcode
Renders a multi-column grid of small cards, showing the latest four recommendations ordered by publishing date, descending.
- count: Limit the number of items. Default 4.
- type: Either default or compact. The compact variant is smaller with less data.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- order: Either DESC (descending) or ASC (ascending). Default DESC.
- orderby: The default is date (published), but you can also use modified and more.
- post_ids: Limit query to a comma-separated list of post IDs.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- fandoms: Limit query to a comma-separated list of fandom names (case-insensitive).
- genres: Limit query to a comma-separated list of genre names (case-insensitive).
- characters: Limit query to a comma-separated list of character names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- vertical: Whether to render the cards with the image on top. Default false.
- seamless: Whether to remove the gap between the image and frame. Default false (Customizer).
- thumbnail: Whether to show the thumbnail/cover image. Default true (Customizer).
- lightbox: Whether clicking on the thumbnail/cover image opens the lightbox or post link. Default true.
- infobox: Whether to show the info box and toggle on compact versions. Default true.
- aspect_ratio: CSS aspect-ratio value for the image (X/Y; vertical only). Default “3/1”.
- terms: Either inline, pills, or none. Default inline.
- max_terms: Maximum number of shown taxonomies. Default 10.
- class: Additional CSS classes, separated by whitespace.
- splide: Configuration JSON to turn the grid into a slider. See Slider.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_latest_recommendations count="2" order="asc" author="Tetrakern"]-
The Sapphire Shadow
Rebellious corporate heiress and her genius friend commit high-tech heists in a doomed city on the edge of the future. -
The Emerald Haven
Sequel. Heiress turned thief, her tech-genius partner, and vengeful ex-cop against the hyper-capitalist future.
[fictioneer_latest_recommendations type="compact" count="2" orderby="rand" post_ids="326,327" seamless="true"]-
The Sapphire Shadow
Rebellious corporate heiress and her genius friend commit high-tech heists in a doomed city on the edge of the future. -
The Emerald Haven
Sequel. Heiress turned thief, her tech-genius partner, and vengeful ex-cop against the hyper-capitalist future.
[fictioneer_latest_recommendations count="2" orderby="rand" vertical="true" seamless="true"]-
The Emerald Haven
Sequel. Heiress turned thief, her tech-genius partner, and vengeful ex-cop against the hyper-capitalist future. -
Vigor Mortis
Girl from the slums discovers her talent for necromancy and learns to love the existential terror she becomes.
[fictioneer_latest_recommendations count="4" orderby="rand" vertical="true" seamless="true" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 2, 'breakpoints': {'767': {'perPage': 1}}}"]-
The Emerald Haven
Sequel. Heiress turned thief, her tech-genius partner, and vengeful ex-cop against the hyper-capitalist future. -
Vigor Mortis
Girl from the slums discovers her talent for necromancy and learns to love the existential terror she becomes. -
Necroepilogos
Reanimated girls from different epochs roam the ruins of civilizations on the scarred corpse of Earth. -
Katalepsis
Haunted student discovers her nightmares of gods and horrors from beyond reality are no hallucinations after all.
Cookie Buttons Shortcode
Renders two buttons to deal with cookies, “Reset Consent” and “Clear Cookies”. Best used in the Cookies section of your Privacy Policy.
[fictioneer_cookie_buttons]Showcase Shortcode
Renders dynamic grid of thumbnails with title, showing the latest eight posts of the specified type ordered by publishing date, descending. The thumbnail is either the Landscape Image (if available) or Cover Image, with chapters defaulting to the parent story.
- for (*): Required. Either chapters, stories, collections, or recommendations.
- count: Limit the number of items. Default 8.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- order: Either DESC (descending) or ASC (ascending). Default DESC.
- orderby: The default is date (published), but you can also use modified and more.
- post_ids: Limit query to a comma-separated list of post IDs.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- fandoms: Limit query to a comma-separated list of fandom names (case-insensitive).
- genres: Limit query to a comma-separated list of genre names (case-insensitive).
- characters: Limit query to a comma-separated list of character names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- no_cap: Set true if you want to hide the captions. Default false.
- aspect_ratio: CSS aspect-ratio value for the item (X/Y).
- quality: Either snippet, thumbnail, cover, medium, medium_large, large, or full. Default medium.
- height: Override the item height. Superseded by aspect_ratio.
- min_width: Override the item minimum width (it will be stretched to fill the space).
- class: Additional CSS classes, separated by whitespace.
- splide: Configuration JSON to turn the grid into a slider. See Slider.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_showcase for="stories" count="3" order="asc" orderby="rand" cache="false" no_cap="true"]
[fictioneer_showcase for="chapters" count="8" author="Monochromatic"]
[fictioneer_showcase for="stories" count="4" aspect_ratio="2/3" min_width="150px"][fictioneer_showcase for="chapters" count="8" aspect_ratio="2/3" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 4, 'breakpoints': {'767': {'perPage': 3}, '479': {'perPage': 2}}}"]Slider
Any shortcode with the splide parameter can be turned into a slider. Splide is a flexible and lightweight slider that comes with many options for customization, although applying them may be challenging if you are not familiar with JSONs. You can look up the details yourself.
The splide parameter only accepts JSON strings, such as splide="{'type':'loop','perPage':3}". Note that you need to use single quotes due to the shortcode syntax. If there is even a minor error, the JSON will be rejected with a note, and the shortcode will default to its standard layout. Not all parameter combinations have been tested with Splide, so custom CSS may be required in some cases.
If you do not want to initialize a slider on page load, you can add the no-auto-splide CSS class via the class parameter in the shortcode or custom HTML (where the splide class is). Normally, Splide’s assets are only enqueued when a shortcode with the necessary parameter is found in the post content, but you can enable Splide globally under Fictioneer > General > Compatibility.
[fictioneer_showcase for="chapters" orderby="rand" count="18" aspect_ratio="2/3" splide="{'type': 'loop', 'gap': '1.5rem', 'autoplay': true, 'perPage': 6, 'breakpoints': {'767': {'perPage': 4}, '479': {'perPage': 3}}}"]-
Redwood Grass -
2.2 – providence or atoms -
1.3 – corpus -
03 – Law of the Land -
02 – Pilot Run -
The Little Girl -
1.2 – corpus -
04 – La Garrud -
1.6 – corpus -
2.11 – providence or atoms -
2.9 – providence or atoms -
2.8 – providence or atoms -
Of Bridges and Buses -
1.4 – mind; correlating -
2.3 – providence or atoms -
2.10 – providence or atoms -
1.5 – corpus
Vertical sliders are possible, albeit their usefulness is dubious.
[fictioneer_latest_chapters type="list" count="8" footer_status="false" splide="{'type': 'loop', 'direction': 'ttb', 'height': '280px', 'autoHeight': true, 'focus': 'center', 'gap': '4px', 'autoplay': true, 'paginationDirection': 'ttb', 'arrows': true, 'breakpoints': {'767': {'arrows': false}}}"]Custom HTML Slider
If you enable Splide globally (or have a slider shortcode on the same page), you can use the HTML block to create your own Slider. Just copy the base structure and add any slides you like, although you will need to style them yourself using custom CSS. Initialize the slider with the data attribute JSON, but this time with double quotes as shown in the example. Unlike with shortcodes, navigation arrows are enabled by default but can be turned off with "arrows:" false.
<style>
.example-side {
display: grid;
place-content: end;
aspect-ratio: 4/2;
background: var(--fg-900);
color: var(--fg-inverted);
padding: 8px;
}
</style>
<section class="splide" data-splide='{"type": "loop", "interval": 3000, "gap": "1.5rem", "autoplay": true, "perPage": 3, "breakpoints": {"767": {"perPage": 2, "arrows": false}, "479": {"perPage": 1}}}'>
<div class="splide__track">
<ul class="splide__list">
<li class="splide__slide example-side">Slide 01</li>
<li class="splide__slide example-side">Slide 02</li>
<li class="splide__slide example-side">Slide 03</li>
<li class="splide__slide example-side">Slide 04</li>
<li class="splide__slide example-side">Slide 05</li>
<li class="splide__slide example-side">Slide 06</li>
</ul>
</div>
</section>Latest Posts Shortcode
Renders the last blog post or a list of blog posts, ignoring sticky posts, ordered by publishing date, descending.
- count: Limit the number of items. Default 4.
- author: Limit posts to a specific author nice_name. Make sure to write it right.
- author_ids: Limit posts to a comma-separated list of author IDs.
- post_ids: Limit query to a comma-separated list of post IDs.
- ignore_protected: Whether protected posts should be ignored or not. Default false.
- only_protected: Whether to query only protected posts or not. Default false.
- exclude_author_ids: Comma-separated list of author IDs to exclude.
- exclude_cat_ids: Comma-separated list of category IDs to exclude.
- exclude_tag_ids: Comma-separated list of tag IDs to exclude.
- categories: Limit query to a comma-separated list of category names (case-insensitive).
- tags: Limit query to a comma-separated list of tag names (case-insensitive).
- rel: Whether a post must fulfill all (AND) or either (OR) taxonomy requirements. Default AND.
- class: Additional CSS classes, separated by whitespace.
- cache: Whether the shortcode should be cached. Default true.
[fictioneer_latest_posts count="1" author="Tetrakern" post_ids="473"]Elements
The purpose of this HTML is to help determine what default settings are with CSS and to make sure that all possible HTML Elements are included in this HTML so as to not miss any possible Elements when designing a site.
Bookmarks Shortcode
Renders a multi-column grid of small bookmark cards, ordered by date of creation. The bookmarks are stored in the browser and appended to the document via JavaScript. You can combine this with the show-if-bookmarks hidden additional CSS classes, displaying a headline or other element only if bookmarks are present.
- count: Limit the number of items. Default -1 (all).
- show_empty: Set true if you want a “No bookmarks” note if empty. Default false.
- seamless: Whether to remove the gap between the image and frame. Default false (Customizer).
- thumbnail: Whether to show the thumbnail/cover image. Default true (Customizer).
[fictioneer_bookmarks count="2" show_empty="true" seamless="true"]No bookmarks.
Contact Form Shortcode
Renders a contact form with various (optional) fields. Submissions are validated, sanitized, have basic spam protection, and are checked against the WordPress disallow list under Settings > Discussions. If valid, the submission is sent to the email addresses listed under Fictioneer > General > Contact Form Receivers. If the list is empty, the admin email address is used instead.
- title: Title of the form shown in emails. Defaults to “Nameless Form”.
- submit: Label of the submit button. Defaults to “Submit”.
- privacy_policy: Set true if the privacy policy must be accepted. Default false.
- required: Set true if all fields must be filled out. Default false.
- email: Add placeholder text if you want an email field to show up.
- name: Add placeholder text if you want a name field to show up.
- text_[1-6]: Custom text fields 1 to 6, e.g. text_1 to text_6.
- check_[1-6]: Custom checkboxes 1 to 6, e.g. check_1 to check_6.
- class: Additional CSS classes, separated by whitespace.
[fictioneer_contact_form email="Email Address (optional)" name="Your Name (optional)" text_1="Topic (optional)" title="Privacy Policy Contact Form" privacy_policy="true" submit="This Form Leads Nowhere"]Sidebar Shortcode
Renders the theme sidebar (not displayed anywhere by default). Requires the “Disable all widgets” theme setting to be off. Note that the sidebar has next to no styling.
- name: Name of the sidebar in case you add some. Defaults to “fictioneer-sidebar”.
[fictioneer_sidebar]This comment can be loaded on the story page, together with comments from all other chapters! To avoid spoilers, you…
This comment can be loaded on the story page, together with comments from all other chapters! To avoid spoilers, you…
[fictioneer_sidebar name="other-sidebar"]