FICTBASE Documentation
Installation
Requirements
- WordPress 6.3+
- PHP 8.1+
- MySQL 5.7+ / MariaDB 10.4+
Step 1 — Download the plugin
Download the latest fictbase.zip from the WordPress.org plugin directory or from your customer portal.
Step 2 — Upload and activate
- In your WordPress admin, go to Plugins → Add New Plugin
- Click Upload Plugin and select the zip file
- Click Install Now, then Activate
FICTBASE creates its database tables automatically on activation.
Step 3 — Start writing
After activation, the FICTBASE menu appears in your WordPress admin sidebar. Go to FICTBASE → Stories → Add New to create your first story.
Create a Story
- Go to FICTBASE → Stories → Add New
- Enter the Title
- Write a Description (shown on the story landing page)
- Upload a Cover Image (optional, but recommended)
- Choose a Genre and Status (Draft / Ongoing / Completed / Hiatus)
- Click Create Story
Your story is now accessible at /story/your-story-slug/. Readers can discover it via the [fictbase_list] shortcode.
Add Chapters
- Open a story and click Manage Chapters
- Click Add Chapter
- Enter a Title
- Write the Content using the full TinyMCE editor
- Set Status to Published when ready to go live
- Click Add Chapter
Word count and estimated read time are calculated automatically. Chapters are numbered in order of creation. Drag-and-drop reordering coming in a future update.
Reader URLs
FICTBASE creates clean URLs automatically — no page setup needed:
| URL | What it shows |
|---|---|
/story/my-story/ | Story landing page (cover, description, chapter list) |
/story/my-story/chapter/1/ | Chapter 1 reader |
/story/my-story/chapter/2/ | Chapter 2 reader |
If the URLs return 404, go to Settings → Permalinks in WordPress and click Save Changesto flush rewrite rules.
Shortcodes
Use these shortcodes on any WordPress page or post:
| Shortcode | Output |
|---|---|
[fictbase_list] | Grid of all your stories with covers and descriptions |
[fictbase_story id="5"] | Single story landing page embedded inline |
[fictbase_chapters story_id="5"] | Chapter list for a story |
Find a story's ID in the URL when editing it: ?page=fictbase&action=edit&id=5.
Settings
Go to FICTBASE → Settings to customize the reading experience:
- Font Size — Small / Medium / Large
- Reading Width — Narrow (600px) / Medium (740px) / Wide (900px)
- Theme — Light / Dark / Auto (follows system preference)
- Custom CSS — Add CSS that applies only to the reader pages
Pro License
- Purchase a Pro license at fictbase.io/pricing
- Check your email for the license key (format:
FB-XXXX-XXXX-XXXX) - In WordPress, go to FICTBASE → License
- Paste your license key and click Save License Key
- Pro features activate automatically
Your license is valid for one WordPress installation for one year. Renew via the customer portal.
Changelog
v1.0.0
- Initial release
- Story and chapter CRUD
- TinyMCE chapter editor
- Clean reader URLs
- Reading progress bar
- Prev/next navigation
- Author bio block
- REST API (5 endpoints)
- Light/dark/auto themes
- Font size, reading width, custom CSS settings
- Shortcodes: fictbase_list, fictbase_story, fictbase_chapters