Public Visibility Guide ​

Share projects and tasks publicly with Task Manager Pro's powerful public visibility system. Create client portals, public project showcases, and team dashboards without requiring user authentication.

🎯 Overview ​

Public Visibility allows you to share tasks and projects publicly on your website using shareable URLs and shortcodes. This feature is perfect for creating client portals, public project showcases, and stakeholder dashboards.

Key Benefits ​

• 🌐 Shareable URLs: Create public links that work without login
• 🎨 Client Portals: Beautiful client-facing dashboards
• 📊 Public Showcases: Display completed projects publicly
• 🔗 Custom Slugs: SEO-friendly URLs with custom slugs
• 📱 Responsive Design: Perfect viewing on all devices
• ⚡ Fast Performance: Optimized for quick loading

🚀 Getting Started ​

Understanding Visibility Levels ​

Task Manager Pro supports three visibility levels:

1. 🔒 Private: Only assigned users and project members (default)
2. 👥 Project Members: All project members can view
3. 🌐 Public: Anyone with the link can view

Accessing Public Visibility ​

1. Navigate to Task/Project

   • Go to Work → Tasks → All Tasks or Work → Projects → All Projects
   • Select a task or project to edit

2. Set Visibility

   • Edit the task or project
   • Find the Visibility field
   • Select "Public" from the dropdown

3. Add Public Slug (optional but recommended)

   • Enter a custom slug (e.g., "demo-task")
   • Slugs should be lowercase, hyphenated (e.g., "website-redesign-task-1")
   • Save the task or project

🔗 Public URLs ​

Public Task URLs ​

Tasks marked as public can be accessed via shareable URLs:

https://yoursite.com/task/{public_slug}/

Example URLs ​

• https://yoursite.com/task/demo-task
• https://yoursite.com/task/website-redesign-homepage
• https://yoursite.com/task/integration-task-2024

How to Create Public Task URL ​

1. Edit a task
2. Set visibility to "Public"
3. Add a public slug (e.g., "demo-task")
4. Save the task
5. Copy the public URL: yoursite.com/task/demo-task

Public Project URLs ​

Projects marked as public can be accessed via shareable URLs:

https://yoursite.com/project/{public_slug}/

Example URLs ​

• https://yoursite.com/project/demo-project
• https://yoursite.com/project/ecommerce-platform-redesign
• https://yoursite.com/project/mobile-app-development-2024

📝 Shortcodes for Public Visibility ​

Board View Shortcode ​

Display a Kanban-style board view for a public project:

[tmp_board_view project_id="123" show_assignees="true" show_priority="true" height="600px"]

Parameters:

• project_id (required): Project ID to display
• board_id: Specific board to show (optional)
• show_assignees: Show task assignees (true/false)
• show_priority: Show priority indicators (true/false)
• show_due_dates: Show due dates (true/false)
• height: Container height (CSS value)
• theme: light/dark theme

Example:

[tmp_board_view project_id="101" show_assignees="true" show_priority="true" height="800px" theme="light"]

Task List Shortcode ​

Display a list of tasks from a public project:

[tmp_task_list project_id="123" status="all" priority="high" limit="20" show_filters="true"]

Parameters:

• project_id (required): Project ID to display
• status: Filter by status ID (optional)
• priority: Filter by priority ID (optional)
• limit: Number of tasks to show (default: 20)
• show_filters: Show filter controls (true/false)
• show_pagination: Show pagination (true/false)

Example:

[tmp_task_list project_id="101" limit="30" show_filters="true" show_pagination="true"]

Single Task Shortcode ​

Display a single public task:

[tmp_task task_id="456" show_details="true" show_comments="false"]

Parameters:

• task_id (required): Task ID to display
• show_details: Show task description (true/false)
• show_comments: Show task comments (true/false)
• show_attachments: Show file attachments (true/false)

Example:

[tmp_task task_id="6001" show_details="true" show_comments="true" show_attachments="true"]

Project Overview Shortcode ​

Display project statistics and recent tasks:

[tmp_project_overview project_id="123" show_stats="true" show_recent_tasks="5"]

Parameters:

• project_id (required): Project ID to display
• show_stats: Show project statistics (true/false)
• show_recent_tasks: Number of recent tasks to show (0-20)

Example:

[tmp_project_overview project_id="101" show_stats="true" show_recent_tasks="10"]

💼 Use Cases ​

1. Client Portals ​

Create beautiful client-facing dashboards to share project progress:

<!-- Client Portal Page -->
<h2>Project Dashboard</h2>
[tmp_project_overview project_id="101" show_stats="true" show_recent_tasks="10"]

<h2>Task Board</h2>
[tmp_board_view project_id="101" show_assignees="true" show_priority="true"]

<h2>Task List</h2>
[tmp_task_list project_id="101" limit="20" show_filters="true"]

2. Public Project Showcases ​

Display completed projects publicly on your website:

<!-- Portfolio/Showcase Page -->
[tmp_project_overview project_id="103" show_stats="true" show_recent_tasks="5"]
[tmp_board_view project_id="103" show_assignees="true"]

3. Stakeholder Dashboards ​

Share project status with stakeholders using public URLs:

• Share public task URL: yoursite.com/task/demo-task
• Share public project URL: yoursite.com/project/demo-project
• Embed shortcodes in stakeholder emails

4. Team Dashboards ​

Create public team dashboards for collaboration:

<!-- Team Dashboard -->
[tmp_project_overview project_id="102" show_stats="true"]
[tmp_task_list project_id="102" limit="15" show_filters="true"]

🎨 Customization ​

Styling Public Views ​

All public visibility shortcodes use consistent CSS classes:

/* Main containers */
.tmp-board-view
.tmp-task-list
.tmp-task-view
.tmp-project-overview

/* Public visibility indicators */
.tmp-public-badge
.tmp-public-label

/* Responsive design */
@media (max-width: 768px) {
  .tmp-board-view {
    /* Mobile-specific styles */
  }
}

Custom Themes ​

Shortcodes support custom theming:

[tmp_board_view project_id="101" theme="dark"]
[tmp_task_list project_id="101" theme="light"]

🔒 Security & Privacy ​

Public Visibility Security ​

• No Login Required: Public tasks/projects don't require authentication
• Read-Only by Default: Public views are read-only (no editing)
• Custom Slugs: Use unique, hard-to-guess slugs for security
• View Tracking: Track who views public tasks/projects
• Access Logging: All public access is logged for security

Best Practices ​

1. Use Unique Slugs: Don't use predictable slugs (e.g., avoid "task-1", "task-2")
2. Regular Updates: Review public tasks regularly and remove when no longer needed
3. Client Portals: Use public visibility for client portals with unique project slugs
4. SEO Optimization: Use descriptive slugs for better SEO (e.g., "ecommerce-platform-redesign")

📊 Public View Statistics ​

Public tasks and projects track view statistics:

• View Count: Number of times the public link was accessed
• View History: Track when public links were accessed
• Geographic Data: Track location of views (if enabled)

🆘 Troubleshooting ​

Common Issues ​

Public URL Not Working ​

Problem: Public task/project URL returns 404 error

Solution:

1. Ensure the task/project is marked as "Public"
2. Check that a public slug is set
3. Flush WordPress rewrite rules: Settings → Permalinks → Save Changes
4. Verify the slug is lowercase and hyphenated

Shortcode Not Displaying ​

Problem: Shortcode displays as plain text

Solution:

1. Ensure Task Manager Pro is activated
2. Check that the project/task ID is correct
3. Verify the task/project is marked as "Public"
4. Check for JavaScript errors in browser console

Styling Issues ​

Problem: Public views don't match site design

Solution:

1. Add custom CSS to match your theme
2. Use theme parameter in shortcodes
3. Check for CSS conflicts with theme
4. Review responsive breakpoints

📚 Additional Resources ​

• Shortcodes Reference - Complete shortcode documentation
• Permission Guide - Permission system overview
• Quick Start Guide - Get started with Task Manager Pro
• FAQ - Frequently asked questions