🎯 What is RitzyWriter?
RitzyWriter is an AI-powered automated content creation and publishing platform. Using OpenAI's GPT, it generates human-like, natural blog posts and automatically publishes them to WordPress sites.
✨ Key Features:
1. Humanized AI Writing
- • Content with emotion and personality
- • Natural conversation flow
- • Various tones and styles
- • SEO optimized
2. WordPress Automation
- • Multi-site management
- • Auto-publishing
- • Category management
- • Auto image upload
3. Affiliate Marketing
- • Amazon product reviews
- • Auto affiliate link insertion
- • High-resolution images
- • Real-time price scraping
4. Smart Scheduling
- • Auto scheduled publishing
- • Unlimited campaigns
- • Background processing
- • Cron job automation
🚀 Step 1: Sign Up
Visit Signup Page
Go to /auth/signup or click "Get Started" button
Enter Your Information
- • Name: Your real name or nickname
- • Email: For login and notifications
- • Password: Min 8 characters (letters, numbers, symbols recommended)
Verify Email & Login
Click verification link in your email, then sign in
📊 Dashboard Overview
Your personalized dashboard shows your usage, limits, and quick actions.
📝 Monthly Posts
Track your monthly post usage including deleted posts. Shows current posts vs plan limit.
🚀 Active Campaigns
Number of running campaigns. All plans support unlimited campaigns.
🌐 Connected Sites
WordPress sites connected. Limit varies by plan: Free(1), Starter(1), Pro(5).
💳 Plans & Pricing
| Plan | Price | Posts/Month | Sites | Affiliate |
|---|---|---|---|---|
| Free | $0 | 10 | 1 | ❌ |
| Starter | $9.99 | 100 | 1 | ✅ (addon) |
| Pro | $19.99 | 500 | 5 | ✅ (addon) |
💡 Add-ons available: Extra posts, sites, and affiliate programs
⚙️ Profile Settings
Go to Dashboard → Settings to manage:
- • Name & Email: Update your personal information
- • Password: Change your account password
- • Profile Image: Upload your avatar
🤖 OpenAI API Connection
⚡ Required for AI Content Generation
You need your own OpenAI API key. This allows transparent cost management and unlimited usage (within OpenAI limits).
Step 1: Get OpenAI API Key
- 1. Visit OpenAI API Keys page
- 2. Sign in or create OpenAI account
- 3. Click "Create new secret key"
- 4. Name it "RitzyWriter" and copy immediately
- 5. Add at least $5 credit to your OpenAI account
Step 2: Add to RitzyWriter
- 1. Go to Dashboard → Integrations
- 2. Find "OpenAI API Configuration"
- 3. Paste your API key
- 4. Click "Test Connection"
- 5. Save settings
📝 WordPress Integration
🔐 What is Application Password?
A secure password specifically for REST API access. It cannot be used to log into WordPress dashboard.
- ✅ More secure than regular password
- ✅ Can be revoked anytime
- ✅ Each app gets its own password
- ✅ Built into WordPress 5.6+
Step 1: Create Application Password in WordPress
- 1. Log into your WordPress admin dashboard
- 2. Go to Users → Profile
- 3. Scroll to "Application Passwords" section
- 4. Enter name:
RitzyWriter - 5. Click "Add New Application Password"
- 6. Copy password immediately (you won't see it again!)
AbCd EfGh IjKl MnOp (spaces included)Step 2: Connect to RitzyWriter
- 1. Go to Dashboard → Integrations
- 2. Click "Connect New Site" in WordPress Sites section
- 3. Enter:
- • Site Name: Any name for identification
- • Site URL:
https://yoursite.com - • Username: WordPress username or email
- • Application Password: The password you copied
- 4. Click "Test Connection"
- 5. If successful, click "Connect Site"
👤 Important: User Role Requirements
Your WordPress user must have sufficient permissions to create posts:
- • Required Roles: Editor or Administrator
- • Contributor: Can create posts but cannot publish (posts will be in "Pending" status)
- • Author: Can create and publish posts, but with limited capabilities
- • Subscriber: Cannot create posts (connection will fail)
✅ Recommended: Use an Administrator or Editor account for full functionality.
❌ Troubleshooting
Connection Failed?
- • Check URL format (include https://)
- • Verify your user role (Editor or Administrator required)
- • Verify Application Password (no typos)
- • Ensure WordPress 5.6 or higher
- • Check if REST API is enabled
💰 Amazon Affiliate Setup
💳 Add-on Required
Subscribe to Amazon Affiliate Add-on ($9.99/mo) or Retail Bundle ($19.99/mo)
Step 1: Join Amazon Associates
- 1. Visit Amazon Associates
- 2. Sign up and wait for approval (1-3 days)
- 3. Get your Associate ID (e.g.,
yoursite-20)
Step 2: Configure in RitzyWriter
- 1. Go to Dashboard → Integrations
- 2. Find "Amazon Affiliate Settings"
- 3. Enter your Associate ID
- 4. Select region (US, UK, etc.)
- 5. Save settings
🎯 What is a Campaign?
A campaign is a project that automatically generates and publishes multiple blog posts based on your settings.
📝 Blog Campaign
General blog content on any topic. Uses your keywords to generate informative, engaging articles.
💰 Affiliate Campaign
Amazon product reviews with affiliate links. Scrapes product info and generates detailed reviews.
🚀 Creating a Blog Campaign
Step 1: Basic Information
- • Campaign Name: "Tech Tips 2025"
- • Campaign Type: Blog Content
- • Keywords: "tech tips, technology tutorial, how to tech" (5-10 keywords)
Step 2: Content Settings
- • Language: English or Korean
- • Tone: Professional / Casual / Friendly
- • GPT Model: gpt-4o (recommended)
- • Word Count: 2500-3500 words
- • Images: 3-5 per post
Step 3: WordPress Settings
- • Select WordPress Site from dropdown
- • Choose Categories (optional)
Step 4: Scheduling
- • Number of Posts: 10
- • Publishing Schedule: "30 minutes" (posts every 30 min)
- • First post generates immediately
- • Remaining posts auto-schedule
💰 Creating Affiliate Campaign
⚠️ Requires: Starter/Pro Plan + Amazon Affiliate Add-on ($9.99/mo)
Key Differences
- • Campaign Type: Amazon Affiliate Review
- • Search Keywords: Product keywords (e.g., "wireless headphones")
- • Auto-scrapes Amazon product info
- • GPT Model auto-selects to gpt-4o
- • Min 2500 words (detailed reviews)
- • Auto-inserts affiliate buttons
- • Uses Amazon product images directly
📊 How It Works
- 1. Cron Job Runs (every 5 minutes)
- 2. Checks Scheduled Posts → Finds posts ready to generate
- 3. Calls OpenAI GPT → Generates title, content, meta tags
- 4. Generates Images → DALL-E or Amazon product images
- 5. Publishes to WordPress → Uploads images, assigns categories
- 6. Marks Complete → Status: PUBLISHED
⏱️ Average time: 2-5 minutes per post
Loading tutorials...
💰 Available for Starter Plan and Above (+ Add-on)
Amazon Affiliate Add-on: $9.99/mo or Retail Bundle: $19.99/mo
🛍️ How Affiliate Marketing Works
Automatic Product Scraping
RitzyWriter automatically scrapes Amazon product information:
- ✅ Product title & ASIN
- ✅ Real-time price (with discounts)
- ✅ High-resolution images (1500x1500)
- ✅ "About this item" descriptions
- ✅ Ratings & review count
AI-Generated Reviews
GPT-4o creates detailed product reviews:
- • 2500-3500 word comprehensive reviews
- • Feature analysis and expert insights
- • Honest pros and cons
- • Buying guide and recommendations
- • 2-3 affiliate buttons strategically placed
⏰ Campaign Scheduling System
RitzyWriter uses an intelligent scheduling system that ensures your content is published exactly when you want it, without manual intervention.
📅 How Campaign Scheduling Works
1. Set Your Publishing Settings
- • Set the interval between posts (e.g., 30 minutes, 2 hours, 1 day)
- • Define the total number of posts to create
- • Note: You don't choose when the first post is published—it starts immediately
2. Immediate & Scheduled Posts
When you create a campaign, RitzyWriter works as follows:
- • Post 1: Generated immediately upon campaign creation (no delay)
- • Post 2: Scheduled for (current time + interval)
- • Post 3: Scheduled for (current time + 2 × interval)
- • Post N: Scheduled for (current time + (N-1) × interval)
Example:
If you create a campaign at 2:00 PM with 30-minute intervals and 5 posts:
- • Post 1: Starts generating at 2:00 PM (immediate)
- • Post 2: Scheduled for 2:30 PM
- • Post 3: Scheduled for 3:00 PM
- • Post 4: Scheduled for 3:30 PM
- • Post 5: Scheduled for 4:00 PM
3. Automated Processing
A cron job runs every 5 minutes to check for scheduled posts and process them automatically.
🤖 Cron Job & Background Processing
Cron Job Frequency
- • Runs every: 5 minutes
- • Checks: All scheduled posts with status "SCHEDULED"
- • Processes: Posts where scheduled time ≤ current time
- • Concurrency: Up to 20 campaigns processed in parallel for efficiency
Post Generation Timing
⚠️ Important: Content is NOT generated all at once during campaign creation. Instead:
- • Each post is generated only when its scheduled time arrives
- • For Affiliate campaigns: Amazon product scraping happens one product at a time per post to avoid bot detection
- • This staggered approach ensures sustainable, undetectable automation
Scalability & Reliability
- • Dynamic throughput: Processes 100-500 posts per run (adjusts based on backlog)
- • Atomic claiming: Uses database transactions to prevent duplicate processing
- • Lock system: Prevents multiple cron instances from running simultaneously
- • Auto-retry: Failed posts automatically retry with exponential backoff
✅ Best Practices for Scheduling
Optimal Intervals
- • Blog posts: 1-3 hours between posts (or daily for high-quality blogs)
- • Affiliate reviews: 30-60 minutes minimum to avoid Amazon scraping rate limits
- • Bulk posting: Space posts out over days/weeks to appear natural
Timing Your Campaign Creation
- • Create campaigns during peak hours: The first post generates immediately, so create your campaign when your audience is most active
- • Consider your WordPress timezone: Ensure your server time matches your target audience
- • First post takes 2-5 minutes: The first post starts generating immediately and will be published as soon as it's ready
- • Plan your intervals: Subsequent posts will follow your chosen interval (e.g., every 30 minutes, 1 hour, etc.)
Monitoring Scheduled Posts
- • Check the Content page to see all scheduled times
- • Posts show "Scheduled for [time]" or "in X hours/minutes"
- • Green badge indicates successfully published posts
- • You can pause campaigns anytime to stop new posts from being generated
⚠️ Important Notes
- • 5-minute window: Scheduled posts are processed within 5 minutes of their scheduled time (not to the exact second)
- • Generation time: Content generation takes 2-5 minutes per post depending on length and complexity
- • Affiliate scraping: Adds 30-60 seconds per product for safe Amazon scraping
- • High load: During peak times, posts might be delayed by a few minutes but will always be processed
- • Pausing campaigns: Already-scheduled posts will NOT be generated if you pause the campaign before their scheduled time
🔄 Campaign Management
▶️ Active Campaigns
- • Automatically generates posts on schedule
- • Shows "Active" status badge
- • Posts published to WordPress in real-time
- • Can be paused anytime
⏸️ Paused Campaigns
- • No new posts generated
- • Already-scheduled posts are cancelled
- • Resume anytime to continue
- • Useful for testing or adjustments
📊 Dashboard Metrics
Your dashboard provides real-time insights into your content production and usage limits.
📝 Monthly Posts Tracking
Tracks your content creation for the current billing cycle:
- • Cumulative count: Includes ALL posts created this month (even deleted ones)
- • Current posts: Shows existing posts in your account
- • Deleted posts: Displays how many were removed but still count toward your limit
- • Plan limit: Based on your subscription + any post add-ons
Example:
15 / 100 posts (5 deleted this cycle)
This means you've created 15 posts total, 10 exist, 5 were deleted, and you have 85 posts remaining this month.
🚀 Active Campaigns
Monitor your campaign activity:
- • All plans: Unlimited campaigns (no restrictions)
- • Active status: Campaigns currently generating and publishing posts
- • Paused status: Campaigns temporarily stopped
- • Quick actions: View details, edit, pause/resume, or delete campaigns
🌐 Connected Sites
Track your WordPress site connections:
- • Free plan: 1 site
- • Starter plan: 1 site (upgradeable with add-ons)
- • Pro plan: 5 sites
- • Add-ons available: +5 sites, +10 sites, or unlimited sites
- • Admin accounts: Unlimited sites (∞)
📈 Content Performance Tracking
Monitor your published content and analyze its performance on your WordPress sites.
Content Page Features
Status Tracking
- • Scheduled: Waiting for scheduled time + countdown timer
- • Generating: AI creating content right now
- • Published: Live on WordPress
- • Failed: Error occurred (with retry options)
Post Information
- • Title: Full post title
- • Site: WordPress site name
- • Campaign: Source campaign name
- • Created: Generation date/time
- • Scheduled for: Publish time with countdown
Quick Actions
- • View Live: Opens the published post on your WordPress site (new tab)
- • Delete: Removes from RitzyWriter list only (does NOT delete from WordPress)
- • WordPress Post ID: Reference number for finding the post on your WP admin
⚠️ Note: Deleting a post from the Content page only removes it from your RitzyWriter list. The post remains live on your WordPress site. To delete it permanently, go to your WordPress admin panel.
🎯 Optimization Strategies
Content Quality Optimization
GPT Model Selection
- • GPT-4o: Best quality, most human-like, recommended for affiliate reviews
- • GPT-4 Turbo: Excellent quality, faster, great for long-form content
- • GPT-3.5 Turbo: Fast and economical, good for bulk blog posts
- • Auto-selection: Affiliate campaigns default to GPT-4o automatically
Content Settings for Better Results
- • Language: Choose your target audience's language
- • Tone: Professional, Casual, or Friendly (match your brand)
- • Point of View: First person for personal blogs, third person for authoritative content
- • Keywords: Include 2-5 target keywords for SEO optimization
SEO Best Practices
- • Keyword density: AI naturally integrates your keywords (2-3% density)
- • H2/H3 structure: Content includes semantic heading hierarchy
- • Min 2500 words: Blog and affiliate posts are 2500-3500 words for better SEO
- • Images: Include 2-5 AI-generated or scraped images per post
- • Meta descriptions: Auto-generated from first 160 characters
- • Internal linking: Consider adding links to related posts manually on WordPress
Affiliate Conversion Optimization
Maximize earnings from Amazon affiliate reviews:
- • Strategic button placement: 2-3 affiliate buttons per review (intro, middle, conclusion)
- • Real prices: Displays current Amazon price on buttons (increases trust)
- • High-res images: Automatically scraped 1500px Amazon product images
- • Detailed reviews: 2500+ word reviews with pros/cons, specs, buying guides
- • "About this item": Scrapes and expands on Amazon's feature bullets
- • Natural language: Human-like writing avoids AI detection
Publishing Strategy Tips
- • Consistency: Schedule posts at regular intervals (daily, every 2 days, weekly)
- • Peak times: Publish when your audience is most active (check Google Analytics)
- • Batch creation: Create multiple campaigns targeting different niches
- • Test and iterate: Try different keywords, tones, and post lengths
- • Monitor WordPress: Use WordPress analytics plugins (Jetpack, MonsterInsights) for traffic data
- • Track conversions: Use Amazon Associates dashboard to monitor affiliate earnings
💡 Advanced Tips
Cost Optimization
- • Use GPT-3.5 for bulk blog posts (lower OpenAI costs)
- • Reserve GPT-4o for high-value affiliate reviews
- • Monitor OpenAI API usage via their dashboard
- • Set usage limits on your OpenAI account
Scaling Up
- • Upgrade to Pro plan for 500 posts/month
- • Add site connections for multi-site management
- • Use post add-ons for unlimited content creation
- • Create multiple campaigns for different topics
❓ Common Issues
❌ OpenAI API Issues
"API connection failed"
- • Check API key is correct
- • Verify OpenAI credit balance ($5+ recommended)
- • Try regenerating API key
❌ WordPress Connection Issues
"Connection failed"
- • URL format:
https://yoursite.com - • Verify your user role (Editor or Administrator required)
- • Verify Application Password (no spaces/typos)
- • WordPress 5.6+ required
- • Check REST API enabled
❌ Content Generation Issues
Post stuck in "GENERATING"
- • Wait 5-10 minutes (auto-retry)
- • Check OpenAI API credits
- • Pause and resume campaign if needed
❌ Amazon Affiliate Issues
"No products found"
- • Use specific product keywords
- • Verify products exist on Amazon.com
- • Try different keywords
- • Wait 30 min if bot detected
💬 Getting Support
🤖 AI Chatbot
Get instant help (bottom-right corner).
- • Available 24/7
- • Instant responses
- • Common issue resolution
📧 Email Support
support@ritzywriter.com
- • Free: 48h response
- • Starter: 24h response
- • Pro: 12h priority support
📚 Additional Resources
- • Full Documentation:
DETAILED_DOCUMENTATION.mdin project root - • Video Tutorials: See "Video Tutorials" section above
- • AI Chatbot: Bottom-right corner for instant help