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

1. Activate the extension
2. Run Database Analyzer (Maintenance > Analyze Database)
3. Clear all caches
4. Optionally configure AgencyDesk API key in Settings > Extension Configuration > T3ClickMark

Usage

1. Log in to the TYPO3 backend
2. Open a frontend page — the feedback widget appears as a floating button
3. Click the button, then click any content element on the page
4. A screenshot is captured automatically — annotate it with the drawing tools
5. Fill in the feedback form (title, description, priority, category) and submit
6. View submitted feedback in the backend module under Web > Feedback

Configuration

In Admin Tools > Settings > Extension Configuration > T3ClickMark:

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.