Overview
The Blog Marketing Platform provides a comprehensive post creation workflow with a 4-step wizard, real-time SEO optimization, and role-based publishing capabilities. This guide walks you through creating and publishing posts effectively.Creating a New Post
Access the Post Creation Wizard
Navigate to the Admin Dashboard and click the “Create Post” button in the header or Quick Actions section.
You need the
crear_post permission to access post creation. Authors and higher roles have this permission by default.Step 1: Basic Information
Fill in the essential post details:
- Title: Enter an SEO-friendly title (recommended 50-70 characters)
- Category: Select from active categories in your blog
- Excerpt: Write a summary (recommended 150-160 characters)
- Featured Image: Either provide a URL or upload an image file
- URL Method: Paste an image URL from sources like Pexels
- Upload Method: Click “Upload Image” to select a file from your computer
Step 2: Content Creation
Write your post content using the advanced MDX editor:Editor Features:
- Live preview mode
- Markdown formatting support
- Syntax highlighting for code blocks
- Real-time word count and reading time calculation
- Word count
- Character count
- Estimated reading time (based on 200 words/minute)
- Add relevant tags to categorize your content
- Use popular tag suggestions
- Tags help with content discovery and SEO
Minimum content length is 100 characters. For better engagement, aim for at least 300 words.
Step 3: SEO Optimization
Optimize your post for search engines:SEO Fields:
- Meta Title: Customized title for search results (50-60 characters)
- Meta Description: Search result description (150-160 characters)
- Focus Keyword: Primary keyword for the post
- Title (20 points): 10+ characters
- Meta Title (15 points): 30-60 characters
- Meta Description (15 points): 120-160 characters
- Focus Keyword (10 points): Defined
- Content Length (20 points): 300+ words for 10 points, 800+ words for full 20 points
- Featured Image (10 points): Present
- Tags (10 points): At least 3 tags
Step 4: Publication Settings
Configure how and when your post will be published:Status Options:
- Draft: Save for later editing
- Pending Approval: Submit for editorial review (if you lack publish permissions)
- Published: Publish immediately (if you have
publicar_postpermission) - Scheduled: Set a future publication date
- Allow Comments: Enable/disable comments on the post
- Featured Post: Mark as featured (appears in special sections)
- Notify Subscribers: Send email notification to subscribers
Post Status Workflow
Understanding the post lifecycle:Status Types
| Status | Description | Who Can Set |
|---|---|---|
| Draft | Post is being written, not visible publicly | All authors |
| Pending | Submitted for editorial review | Authors, Editors, Admins |
| Published | Live and visible to public | Editors, Admins |
| Rejected | Needs revisions before publication | Editors, Admins |
Workflow by Role
Author Workflow
Author Workflow
Editor/Admin Workflow
Editor/Admin Workflow
- Create post
- Can publish immediately OR save as draft
- Can review pending posts from authors
- Can approve, reject, or request changes
Editing Existing Posts
Quick Edit from Dashboard
- Navigate to Admin > Posts
- Find your post in the table
- Click the edit icon (pencil) in the Actions column
Full Editor Features
Header Actions:- Save: Save current changes
- Preview: View post as it will appear publicly
- Publish Now: Quick publish action (editors/admins only)
- Send to Review: Submit for approval (authors)
- 🟡 Saving…
- 🟢 Saved automatically
- 🔴 Error saving
- Full-screen editor for content
- Word count and reading time statistics
- Markdown syntax support
Post Configuration
Post Configuration
- Status: Change publication status
- Category: Reassign to different category
- Featured Image: Update or upload new image
SEO Settings
SEO Settings
- Meta Title: Update search result title
- Meta Description: Update search result description
- Focus Keyword: Set or change primary keyword
Tags Management
Tags Management
Best Practices
Content Quality
Recommended Post Length:
- Minimum: 300 words
- Ideal: 800-1200 words
- Long-form: 1500+ words for in-depth topics
SEO Optimization Tips
-
Title Optimization
- Include focus keyword near the beginning
- Keep under 70 characters for full display in search results
- Make it compelling and click-worthy
-
Meta Description
- Write unique descriptions for each post
- Include a call-to-action
- Use 150-160 characters for optimal display
-
Content Structure
- Use clear headings (H2, H3)
- Include relevant keywords naturally
- Add internal links to other posts
- Use bullet points and numbered lists
-
Images
- Always include a featured image
- Use high-quality images (minimum 1200x630px)
- Optimize file size for fast loading
- Use descriptive file names
Publishing Strategy
Troubleshooting
Common Issues
Can't publish post immediately
Can't publish post immediately
Cause: You don’t have the
publicar_post permission.Solution: Submit the post for approval (status: Pending). An editor or admin will review and publish it.Image upload fails
Image upload fails
Causes:
- Post hasn’t been saved yet (need a post ID)
- File size too large
- Unsupported image format
- Save the post as draft first
- Compress images before upload
- Use supported formats: JPG, PNG, WebP
- Try URL method as alternative
SEO score is low
SEO score is low
Quick fixes:
- Add meta title and description
- Include focus keyword
- Add at least 3 relevant tags
- Increase content length to 300+ words
- Add featured image
Auto-save not working
Auto-save not working
Check:
- Internet connection is stable
- You’re editing an existing post (not a new unsaved post)
- Browser console for error messages
Related Resources
- Managing Users - Learn about user roles and permissions
- Content Moderation - Understand the approval process
- Admin Dashboard - Navigate the admin interface
Technical Reference
Source Code References:- Post Creation Wizard:
src/components/admin/CreatePostWizard.tsx:42 - Post Editor:
src/components/admin/PostEditor.tsx:20 - Status Workflow:
src/components/admin/PostStatusWorkflow.tsx:23 - Posts Service:
src/services/postsService.ts:542