- Compatibile XF2 versions
- 2.3
Create interactive checklists, task lists, to-do lists, and progress trackers directly inside XenForo posts and other rich-text messages.
Checklists BB Code adds a visual checklist builder to the editor and turns [CHECKLIST] BB code into interactive task lists after publication.
Checklists BB Code adds a visual checklist builder to the editor and turns [CHECKLIST] BB code into interactive task lists after publication.
Features:
Interactive Checklist BB Code: Embed structured checklists and task lists directly inside supported messages using [CHECKLIST].
Visual Checklist Builder: Create, edit, remove, complete, and reorder checklist items through an integrated editor.
Rich-Text Editor Preview: Display checklist items as movable cards while composing or editing a message.
AJAX Checklist Updates: Mark tasks complete or incomplete directly from published content without reloading the page.
Synchronized Updates: Automatically update every visible copy of the same checklist on the current page after an item changes.
Plain BB Code Storage: Store checklist items directly in the message as [ ] Task and [x] Task.
Progress Tracking: Use [CHECKLIST=progress] to display a bordered checklist with a completion counter.- ↳ Nested Checklists: Create subtasks and hierarchical task lists by placing checklist blocks inside other checklists.
Configurable Nesting Depth: Control how deeply checklists can be nested.
Content Copy Support: Checklists automatically follow supported XenForo content copy and merge operations because their state is stored directly in the message.
Optional Interactivity: Disable published-message toggling to use checklists as read-only task lists.
Separate Permissions: Independently control who can create checklists and who can update checklist items.
Supported Add-ons and Content Types:
Posts, profile posts, conversation messages
XenForo Resource Manager: Resource updates
[XB] Lessons: Classrooms, comments, homework submissions, lessons, ratings
[XB] Quizzes: Comments, feedback, questions, quizzes, ratings
[XB] Thread Notes: Notes, note comments
[XB] Toplists: Comments, ratings
[XB] Thread Ratings: Ratings
[XB] Verification Badges: Badge requests
[XB] XFRM: Resource Questions: Questions, answers
[XB] XFRM: Review Comments: Review comments
[XB] XFRM: Update Comments: Update comments
[XB] Book Database: Books, comments, ratings
[XB] Donations: Campaigns, comments, donations
[XB] Game Database: Games, comments, ratings
[XB] Movie & TV Database: Titles, episodes, comments, ratings
[XB] Music Database: Albums, comments, ratings
[XB] Quote Book: Quotes, comments
[XB] Recipes: Comments, ratings
[XB] User Reputation: Ratings
[XB] User Vouches: Vouches
[XB] XFRM Resource Docs: Documentation pages
Permissions:
Use Checklists BB Code: Control who can create and insert interactive checklists.
Toggle Checklist Items: Control who can mark tasks complete or incomplete in published content.
Requirements:
XenForo 2.3.0+
PHP 7.4+
Useful for:
To-Do Lists: Create interactive to-do lists directly inside forum posts and messages.
Project Tracking: Track project tasks, implementation steps, and completed work inside discussions.
Shared Task Lists: Let permitted members collaborate on a common checklist.
Guides & Tutorials: Add interactive steps and progress tracking to instructions and procedures.
Event Planning: Coordinate preparation tasks inside threads or conversations.
Release Planning: Maintain development, testing, release, or publication checklists in resource updates.
Support Workflows: Track troubleshooting steps or actions that still need to be completed.
FAQ:
Can I create interactive checklists in XenForo posts?
Yes. Add a checklist through the editor and publish it as [CHECKLIST] BB code inside a supported message.
Can checklist items be changed after a message is published?
Yes. Members with the toggle permission can mark tasks complete or incomplete through AJAX without reloading the page.
Can published checklists be read-only?
Yes. Disable AJAX toggling in the add-on options. Checklists remain visible while their item controls become read-only.
Can a checklist show completion progress?
Yes. Enable Show progress in the checklist editor or use [CHECKLIST=progress] to display a completion counter.- ↳ Can I create nested checklists or subtasks?
Yes. Checklist blocks can be nested, with administrators controlling the maximum nesting depth.
What does the stored BB code look like?
Items use standard [ ] Task and [x] Task lines inside a [CHECKLIST] block. No internal item IDs are stored.
What happens when content containing a checklist is copied or merged?
The checklist is stored directly in the message, so it follows supported XenForo content copy and merge operations.
What happens when content containing a checklist is deleted?
No separate checklist data needs to be managed because its state is stored as part of the message itself.
What will happen when XenForo 2.4 and the new TipTap editor are released? We do not yet know when XF 2.4 will be released and how their final APIs will work, or whether checklist support will be included out of the box. If XenForo includes native checklists, we will evaluate the built-in implementation and provide the most appropriate compatibility or migration path. If it does not, we will adapt this add-on to the new editor and parser once their final implementation is available.
Screenshots:
Published Checklists
| Display interactive checklists, progress counters, and multiple nesting levels inside published messages. |
Rich-Text Editor
| Open the visual checklist builder directly from the XenForo rich-text editor toolbar. |
| Create, reorder, complete, indent, and outdent checklist items in the visual editor dialog. |
Permissions
| Control checklist creation and published-item toggling with separate XenForo permissions. |