Troubleshooting

Fixes for the problems people hit most often.

A user can't see the Kanbanz menu

The menu needs the kanbanz_staff capability. Give the user the Kanban Staff or Kanban Manager role under Users. Administrators and Editors get access automatically. If you use a role-editor plugin that removed the capabilities, re-add kanbanz_staff (and kanbanz_manager for managers).

A user can't see a board

The board has team members, so it is private. Add the user under Board Settings → Team & access, or assign them a task on that board. A board with no team members is visible to every Kanbanz user. See Roles & Capabilities.

A user is missing from the assignee list

The picker lists Administrators, Editors, Kanban Managers, Kanban Staff, Deskuss Managers and Deskuss Staff, plus anyone else with the kanbanz_staff capability. When Deskuss is active, it also lists Deskuss department members. Give the user one of these roles.

Someone can't move a task into the last column

The board's Task completion setting is Admins & board managers only or Selected staff only. Change it under Board Settings → Task completion, add the person as a board manager, or tick them in the selected staff list.

Someone can't edit a task

Kanban Staff can only edit tasks they are assigned to or created. Assign them to the task, or give them the Kanban Manager role.

Deskuss tickets aren't showing up as tasks

1. Make sure the Deskuss plugin is active. The Deskuss Integration settings tab only appears when it is.
2. Make sure the ticket's department has a board. Click Run Sync Now to create any missing boards and tasks.
3. Check that Auto-sync from Deskuss is on and that WP-Cron is running. See Cron Jobs & Sync.

The hourly sync doesn't run

WP-Cron only runs when the site gets visits, or not at all if DISABLE_WP_CRON is set and no server cron is configured. Check with wp cron event list | grep kanbanz and run it with wp cron event run kanbanz_sync_cron. Then set up a real server cron.

Email notifications don't arrive

1. Check that Enable email notifications is ticked under Settings → Notifications. It is off by default.
2. Click Send Test Email.
3. If the test fails or lands in spam, your server can't deliver wp_mail() reliably. Install an SMTP plugin.

The board looks out of date after an update

Kanbanz versions its scripts by file modification time, so browsers pick up new files on their own. If a page cache or CDN serves wp-admin assets, purge it and hard-reload with Ctrl/⌘ + Shift + R.