Installation 

Requirements 

  • TYPO3 12.0 - 12.4 LTS
  • PHP 8.1 or higher

Classic Installation 

  1. Download the extension from the TYPO3 Extension Repository (TER) or GitHub
  2. Extract the archive to typo3conf/ext/nnfocalpoint
  3. Activate the extension in the Extension Manager

Database Update 

After installation, you need to update the database schema:

  1. Go to Admin Tools → Maintenance → Analyze Database Structure
  2. Apply the suggested changes to add the tx_nnfocalpoint_points field to sys_file_reference

Alternatively, run the following SQL manually:

ALTER TABLE sys_file_reference ADD tx_nnfocalpoint_points text;
Copied!

Verification 

After installation, verify the extension is working correctly:

  1. Go to any content element with an image (e.g., Text & Media)
  2. Edit the image reference
  3. You should see a "Fokus-Punkt bearbeiten" button below the crop options

Upgrading 

From earlier versions 

When upgrading from an earlier version:

  1. Update the extension files
  2. Clear all caches
  3. Run the Database Analyzer to apply any schema changes