Help

Frequently Asked Questions

📦 AI Story Maker Plugin 🏢 Hayan Mamoun / Exedotcom

Contents

  1. Getting Started
  2. AI Story Generation
  3. AI Story Enhancer
  4. Subscriptions & API Keys
  5. Shortcodes & Display
  6. Social Media Integration
  7. Analytics & Performance
  8. Troubleshooting
  9. Advanced Usage
1

Getting Started

What is AI Story Maker?
A WordPress plugin that uses OpenAI to generate stories, enhance content, fetch Unsplash images, and auto-publish to social media.
What are the system requirements?
  • WordPress 5.8+
  • PHP 7.4+
  • Modern browser with JavaScript enabled
  • Active internet connection
How do I install AI Story Maker?
Either install via the WordPress Plugin Directory, or upload the ZIP manually via Plugins → Add New → Upload Plugin.
Is AI Story Maker free?
Yes. Story generation requires either a subscription or your own API keys. The Enhancer feature is fully free.
Where do I start after installation?
  1. Open AI Story Maker in WP Admin
  2. Set up a subscription or enter API keys
  3. Configure your preferences
  4. Create a prompt template
  5. Generate your first story
2

AI Story Generation

How does AI story generation work?
It sends your prompt to OpenAI and generates a WordPress post based on your defined categories, tone, length, and image placeholders.
What is a prompt template?
A reusable instruction set that defines the story’s style, structure, categories, and image settings — saved for repeated use.
How do I write effective prompts?
  • Be specific about the topic
  • Specify desired length
  • Define target audience and tone
  • Use image placeholders: {img_unsplash:keyword}
Can I schedule automatic story generation?
Yes — daily, weekly, or custom schedules are supported.
How long does generation take?
Typically 10–30 seconds, depending on story length, API latency, and image fetching.
Can I edit generated stories?
Yes — all stories are saved as drafts so you can review, edit, and publish at your own pace.
What happens if generation fails?
Check the plugin logs, verify your API keys or subscription status, confirm server connectivity, and check OpenAI’s status page.
Can I generate multiple stories at once?
Yes — batch generation and scheduled generation are both supported.
3

AI Story Enhancer

What is AI Story Enhancer?
A free tool for rewriting and improving existing post content — no subscription or API key required.
How do I access it?
Go to Posts → All Posts and click AI Story Enhancer under any post title.
How does it work?
  1. Select the text you want to improve
  2. Enter enhancement instructions
  3. Click “Improve”
  4. Review and apply the changes
What can be enhanced?
  • Post body content
  • Tags & keywords
  • SEO meta descriptions
Is the Enhancer free?
Yes — fully free with no usage limits.
4

Subscriptions & API Keys

What’s the difference between a subscription and API keys?
A subscription includes pre-paid credits managed by us. API keys use your own OpenAI and Unsplash accounts — you pay those providers directly.
How do subscriptions work?
  1. Select a plan on the plugin settings page
  2. Verify your email
  3. Complete payment if required
  4. Credits load automatically
How do I set up API keys?
Go to API Keys in the plugin settings and enter your OpenAI and Unsplash keys.
Can I switch between subscription and API keys?
Yes — subscription credits take priority; API keys act as the fallback when credits are unavailable.
What if I run out of credits?
Upgrade your subscription plan, or the plugin will automatically fall back to your API keys if configured.
5

Shortcodes & Display

What shortcodes are available?
Posts gadget usage examples
Can I customize the display?
Yes — via CSS overrides, your theme styles, or the plugin’s built-in settings.
6

Social Media Integration

What platforms are supported?
Facebook Pages are currently supported. Additional platforms are planned for future releases.
How do I connect Facebook?
  1. Go to Social Media Integration in plugin settings
  2. Click Add Facebook Account
  3. Authenticate via Facebook
What gets posted automatically?
Story title, excerpt, link back to your site, and relevant hashtags.
7

Analytics & Performance

What analytics does the plugin provide?
  • Page views per story
  • Click-through rates (CTR)
  • Heatmaps
  • Content trends
Does it affect site performance?
Minimal impact — all analytics and generation tasks run fully asynchronously.
8

Troubleshooting

Stories are not generating — what should I check?
  • API keys are entered and valid
  • Subscription is active with available credits
  • Plugin logs for specific error messages
  • Server can reach external APIs (no firewall blocks)
Images are missing from generated stories
  • Verify your Unsplash API key is entered
  • Check placeholder syntax: {img_unsplash:keyword}
  • Review plugin logs for fetch errors
Shortcodes are not rendering
  • Clear your site and page cache
  • Verify shortcode syntax is correct
  • Ensure published posts exist in the assigned category
9

Advanced Usage

Can I customize prompts or output via code?
Yes — use the provided WordPress filters:
  • aistma_story_prompt — modify the prompt before sending
  • aistma_generated_content — modify raw AI output
  • aistma_post_data — modify post data before saving
Can I generate content in other languages?
Yes — specify the target language in your prompt template.
How do I back up my prompt templates?
Prompts are stored in the wp_options table — a standard WordPress database backup covers them.

Additional Resources

Website
storymakerplugin.com
GitHub
github.com/hmamoun/ai-story-maker
Support Email
support@exedotcom.ca
💡 Still stuck? Check the plugin logs first — most issues include a specific error message that points to the cause.