SEO Roadmaps - Visual Task Management

Transform your SEO strategy into actionable tasks with ProRank's visual Kanban board. Organize projects, collaborate with your team, and track progress from start to finish - all in one intuitive interface.

SEO Roadmaps interface with drag-and-drop task management

✨ Key Features

🚀 Getting Started

Accessing SEO Roadmaps

1. Navigate to ProRank SEO → Agency Hub in your WordPress admin
2. Click on the SEO Roadmaps tab
3. The board loads with 9 sample SEO tasks to help you get started

First Time Setup

When you first access SEO Roadmaps, the system automatically:

• Creates the necessary database tables
• Sets up 4 task columns (Backlog, In Progress, Review, Done)
• Configures priority levels with color coding
• Loads 9 realistic sample SEO tasks across all columns
• Grants access permissions to administrators and editors

📋 The Kanban Board

Board Columns

Tasks move through four stages representing your SEO workflow:

Moving Tasks

Simply drag and drop tasks between columns:

• Click and hold on any task card
• Drag it to the desired column
• Drop to update the task status
• Changes save automatically
• Reorder tasks within columns by dragging up or down

📝 Task Management

Creating Tasks

1. Click the "New Task" button (blue button in top toolbar)
2. Fill in the task details:
   • Title: Clear, actionable task name
   • Description: Detailed information and requirements
   • Priority: Urgent (red), High (orange), Medium (green), or Low (blue)
   • Assignee: Team member responsible
   • Due Date: Target completion date and time
   • Target URL: Related webpage or resource
   • Tags: Keywords for categorization (e.g., "technical", "content", "backlinks")
3. Click "Save" to add the task to your backlog

Task Actions

Each task card has three action buttons:

• 👁️ View: Opens detailed task information in a read-only modal
• ✏️ Edit: Modify task details, reassign, or update priority
• 🗑️ Delete: Permanently remove the task (with confirmation)

Priority System

Tasks are color-coded by priority for quick visual reference:

• 🔴 Urgent - Critical tasks requiring immediate attention
• 🟠 High - Important tasks to complete soon
• 🟢 Medium - Standard priority tasks
• 🔵 Low - Tasks that can wait

✅ Bulk Task Operations

Entering Bulk Mode

1. Click the "Bulk Actions" button in the toolbar
2. Checkboxes appear on each task card
3. Select tasks by clicking their checkboxes
4. Use "Select All" to select all visible tasks

Available Bulk Actions

• Move to Column: Move all selected tasks to a different status
• Assign to User: Bulk assign tasks to a team member
• Delete Tasks: Remove multiple tasks at once
• Clear Selection: Deselect all tasks

Bulk Operation Tips

• Selected tasks are highlighted with a blue border
• The toolbar shows how many tasks are selected
• Combine with filters to bulk-manage specific task groups
• Exit bulk mode by clicking "Exit Bulk Mode"

📋 Task Templates

Using Templates

1. Click the "Templates" button in the toolbar
2. Browse the 5 available template categories
3. Click on a template to see its tasks
4. Click "Create X Tasks" to add them to your board

Available Templates

🔍 Search and Filtering

Text Search

Quickly find tasks using the search bar:

• Type keywords in the search box
• Searches across task titles, descriptions, tags, and URLs
• Results update instantly as you type
• Click the X button to clear search

Tag Filtering

Filter tasks by their tags:

1. Click the "Tags" button in the filter bar
2. A dropdown shows all available tags
3. Check the tags you want to filter by
4. Only tasks with selected tags will be shown
5. Click "Clear tag filters" to reset

User and Priority Filters

• User Filter: Show tasks assigned to specific team members
• Priority Filter: Display only tasks of certain priority levels
• Combined Filters: Use multiple filters together for precise views
• Clear Filters: Reset all filters with one click

📊 CSV Export

Exporting Tasks

1. Click the "Export CSV" button in the toolbar
2. A CSV file downloads automatically
3. File is named with today's date (e.g., seo-roadmap-2024-01-15.csv)

Exported Data

The CSV includes all task information:

• Task ID, Title, and Description
• Status and Priority
• Assignee name
• Due date and completion date
• Target URL
• Tags (semicolon-separated)
• Created, updated, and completed timestamps

Use Cases for Export

• Create reports for clients or management
• Backup your task data
• Analyze task metrics in spreadsheet software
• Share task lists with external teams
• Archive completed projects

👁️ Task Details View

Viewing Task Details

Click the eye icon on any task to see comprehensive information:

• Task Information: ID, creation date, last update, completion date
• Assignment: Assignee details with avatar and email
• Status & Priority: Visual badges showing current state
• Description: Full task description and requirements
• Tags: All associated tags for categorization
• Target URL: Clickable link to related resource
• Due Date: With visual indicator if overdue

Detail View Actions

• Edit Task: Switch to edit mode from the detail view
• Close: Return to the board view

🤖 AI Task Suggestions

Getting AI-Powered Suggestions

1. Click the "AI Suggestions" button
2. Enter your website URL or describe your SEO goals
3. Choose suggestion type:
   • Quick audit (5-7 tasks)
   • Comprehensive analysis (10-15 tasks)
   • Technical focus
   • Content focus
4. Review generated tasks
5. Select tasks to add to your board

👥 Team Collaboration

User Assignment

Assign tasks to team members for clear accountability:

• All WordPress users appear in the assignee dropdown
• Users see their avatar on assigned tasks
• Filter by assignee to see individual workloads
• Bulk assign multiple tasks to one person

Permission Levels

• Administrators: Full access to all features
• Editors: Can manage all tasks
• Other roles: Can be granted access via capabilities

💡 Best Practices

Task Creation

• ✅ Use action verbs in titles ("Optimize", "Fix", "Create")
• ✅ Include measurable goals in descriptions
• ✅ Set realistic due dates
• ✅ Use consistent tag naming
• ✅ Break large projects into smaller tasks

Board Management

• ✅ Review the board daily during team standups
• ✅ Keep "In Progress" limited to active work
• ✅ Move completed tasks promptly
• ✅ Use filters to focus on priorities
• ✅ Export and archive completed projects monthly

Workflow Tips

• Start with templates for new projects
• Use bulk operations for routine updates
• Tag tasks consistently for better filtering
• Set priority based on business impact
• Review and clean up "Done" column weekly

⌨️ Keyboard Shortcuts

🔧 Troubleshooting

Common Issues and Solutions

🔌 API Reference

REST API Endpoints

# List all tasks
GET /wp-json/prorank-seo/v1/seo-roadmaps/tasks

# Create new task
POST /wp-json/prorank-seo/v1/seo-roadmaps/tasks
{
 "title": "Optimize homepage meta tags",
 "description": "Update title and description",
 "priority": "high",
 "status": "backlog",
 "tags": ["seo", "meta", "homepage"]
}

# Update task
PUT /wp-json/prorank-seo/v1/seo-roadmaps/tasks/{id}

# Delete task
DELETE /wp-json/prorank-seo/v1/seo-roadmaps/tasks/{id}

# Move task (drag and drop)
POST /wp-json/prorank-seo/v1/seo-roadmaps/tasks/reorder
{
 "task_id": 123,
 "status": "in_progress",
 "position": 0
}

# Get users for assignment
GET /wp-json/prorank-seo/v1/seo-roadmaps/users

# Get AI suggestions
POST /wp-json/prorank-seo/v1/seo-roadmaps/suggest-tasks
{
 "url": "https://example.com",
 "type": "comprehensive"
}

💾 Database Structure

Tasks are stored in the wp_prorank_roadmap_items table:

-- Table structure
CREATE TABLE wp_prorank_roadmap_items (
 id bigint(20) unsigned PRIMARY KEY,
 title varchar(255) NOT NULL,
 description text,
 status varchar(50) DEFAULT 'backlog',
 priority varchar(20) DEFAULT 'medium',
 assignee_id bigint(20) unsigned,
 due_date datetime,
 url_target varchar(2048),
 tags_json text,
 position int(11) DEFAULT 0,
 created_by bigint(20) unsigned,
 created_at datetime DEFAULT CURRENT_TIMESTAMP,
 updated_at datetime ON UPDATE CURRENT_TIMESTAMP,
 completed_at datetime
)

❓ Frequently Asked Questions

🔗 Integration with Other Features

Works Great With:

• Site Audit: Create tasks from audit findings
• Rank Tracking: Generate tasks for underperforming keywords
• Content AI: Turn content suggestions into actionable tasks
• Collaboration: Real-time updates when working with teams
• White Label: Brand the interface for client access

🎯 Next Steps