bytebuilders / t3clickmark
Visual website feedback for TYPO3 agencies. Content element recognition, backend edit links, screenshot capture, and annotation tools.
Maintainers
Package info
github.com/ByteBuildersGmbH/t3clickmark
Type:typo3-cms-extension
pkg:composer/bytebuilders/t3clickmark
Requires
- php: ^8.1
- typo3/cms-core: ^12.4 || ^13.4
- typo3/cms-extbase: ^12.4 || ^13.4
- typo3/cms-fluid: ^12.4 || ^13.4
README
A feedback widget for TYPO3 agencies. Editors browse their site, click a content element, write feedback, and the system captures a screenshot with the TYPO3 content element UID and a direct backend edit link. The agency receives this as a structured ticket.
Features
- Visual feedback widget — floating button on the frontend for authenticated backend users
- Screenshot capture — automatic screenshot of the selected content element with annotation tools (freehand drawing, arrows, rectangles, text)
- TYPO3 context — captures content element UID, page ID, content type, and generates a direct backend edit link
- Backend module — feedback list with filters (status, priority), detail view with screenshot lightbox, comments, status management
- AgencyDesk integration — optional sync to ClickMark AgencyDesk for Jira, Slack, Teams, and email notifications
- Access control — restrict the widget to specific backend users via extension configuration
- Dark mode — full dark mode support in the backend module
Requirements
- TYPO3 v12 LTS or v13 LTS
- PHP 8.1+
Installation
Via Composer (recommended)
composer require bytebuilders/t3clickmark
Via TYPO3 Extension Manager
Search for t3clickmark under Admin Tools > Extensions > Get Extensions, or download from the TYPO3 Extension Repository.
After installation
- Activate the extension
- Run Database Analyzer (Maintenance > Analyze Database)
- Clear all caches
- Optionally configure AgencyDesk API key in Settings > Extension Configuration > T3ClickMark
Usage
- Log in to the TYPO3 backend
- Open a frontend page — the feedback widget appears as a floating button
- Click the button, then click any content element on the page
- A screenshot is captured automatically — annotate it with the drawing tools
- Fill in the feedback form (title, description, priority, category) and submit
- View submitted feedback in the backend module under Web > Feedback
Configuration
In Admin Tools > Settings > Extension Configuration > T3ClickMark:
| Setting | Description |
|---|---|
| API Key | AgencyDesk API key for sync (leave empty for local-only mode) |
| Allowed Backend Users | Comma-separated usernames to restrict access (empty = all users) |
| Public Widget | Enable widget for all visitors without backend login |
Links
- Website: clickmark.it
- Documentation: clickmark.it/docs
- TER: extensions.typo3.org/extension/t3clickmark
- Packagist: packagist.org/packages/bytebuilders/t3clickmark
- Issues: GitHub Issues
License
GPL-2.0-or-later — see LICENSE for details.