Search by

bytebuilders / t3clickmark

ByteBuilders-Admin

Visual website feedback for TYPO3 agencies. Content element recognition, backend edit links, screenshot capture, and annotation tools.

Package info

github.com/ByteBuildersGmbH/t3clickmark

Homepage

Type:typo3-cms-extension

pkg:composer/bytebuilders/t3clickmark

Statistics

Installs: 25

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.3.61 2026-10-27 14:06 UTC

This package is auto-updated.

Last update: 2026-10-27 14:10:23 UTC


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:

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

Scheduled synchronisation

With an API key set, add a scheduler task (System > Scheduler > "Execute console commands") for clickmark:sync, running every 5 minutes (or a cron entry vendor/bin/typo3 clickmark:sync). It delivers feedback that has not reached the platform yet (e.g. after an outage) and pulls status changes, new tickets and comments back into TYPO3 — without anyone having to open the backend module. A failed run (platform unreachable, delivery errors) is reported as failed in the scheduler; -v lists the error per feedback item.

Links

License

GPL-2.0-or-later — see LICENSE for details.