Files
VITEC-website/packages/fe_comment
orasche 872c6e715c fe_comment v2: FE-user feedback tickets with summary, uploads and API
- Replace the v1 submit endpoint with a full JSON API under
  /api/fe-comment/ (state, feedback create/update/delete, uploads,
  summary notes/recipients, submit), guarded by frontend login and a
  configurable FE user group; unauthorized callers get {"allowed":false}
- New models: tx_fecomment_summary (one open ticket per user, status
  open/sent) and tx_fecomment_feedback (url, RTE note, FAL attachments),
  both editable in the backend on the ticket storage page
- FeedbackApiMiddleware registered after frontend authentication (the
  frontend.user attribute does not exist earlier); uploads land in
  fileadmin/fe_comment/summary-<uid>/ with mime/extension check, 20 MB cap
- Submit sends one HTML mail (author block, items with attachment links,
  reply-to = FE user mail) to selected recipients with mailTo fallback,
  then closes the summary
- felogin wired React-compatible: felogin.pid=520 plus headless FeLogin
  JSON templates via site settings - felogin v14 and EXT:headless both
  claim templateRootPaths.10, the felogin.view.* settings feed exactly
  that index, so the structured JSON form (incl. __RequestToken) wins
- Read the sys_file_reference insert id before syncAttachmentCount():
  DBAL throws "no identity value" once the count UPDATE has run
- migrations: drop_fecomment_tables.php (repairs the no-uid tables,
  only drops when empty), check_feuser.php (login diagnosis),
  fec_login_test.sh / fec_api_test.sh (curl chains incl. CSRF token flow)
2026-10-02 16:37:01 +02:00
..

EXT:fe_comment — page feedback widget

A floating button at the right edge of every page lets reviewers (e.g. the customer) comment on the page they are looking at. Notes collect on a local note pad (localStorage, survives navigation and SPA route changes); the pad lists every note with its URL and editable text and submits them all in one mail.

Framework-agnostic: the whole UI is one vanilla-JS file served by the extension itself — it works on a React/SPA front end and on classic TYPO3-rendered pages alike.

Endpoints (middleware, active on every site with the extension installed)

URL Purpose
/api/fe-comment/widget.js the widget (injects its own CSS)
/api/fe-comment/widget.css widget styles
/api/fe-comment/submit POST {"entries":[{"url","comment"}]} → sends the mail

Configuration (Settings → Extension Configuration → fe_comment)

  • mailTo (required) / mailCc / mailBcc — comma-separated lists. Without a valid mailTo, submissions are rejected (HTTP 503), nothing is lost silently.
  • subject — subject line, host and entry count are appended.
  • jsonOutput — 1 (default): headless mode, TYPO3 injects nothing; the front end embeds the widget itself: <script src="/api/fe-comment/widget.js" defer></script> 0: classic TYPO3 site, the extension injects the script into every rendered frontend page automatically (AssetCollector, no TypoScript).

The sender address is TYPO3's system default ($GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress']).

Notes for SPA setups

  • The page URL is read at SAVE time (location.pathname + search), so client-side route changes are captured correctly.
  • If page URLs are rewritten to an SPA fallback (like the vitec .htaccess phase B block), /api/ paths must stay excluded from the fallback so the endpoints keep reaching TYPO3.

Labels

UI labels are German and live in the T object at the top of Resources/Public/JavaScript/fe-comment.js.