..  include:: /Includes.rst.txt

..  _installation:

============
Installation
============

..  _requirements:

Requirements
============

-  TYPO3 12.4 LTS or TYPO3 13.x
-  PHP 8.2 or higher

..  _installation-composer:

Installation via Composer (recommended)
=======================================

For Composer-based TYPO3 installations, run:

..  code-block:: bash

    composer require nng/nnfocalpoint

..  _installation-classic:

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:

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:

..  code-block:: sql

    ALTER TABLE sys_file_reference ADD tx_nnfocalpoint_points text;

..  _verification:

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

..  _upgrade:

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

..  note::

    Existing focal point data is preserved during upgrades. The JSON format is
    backward compatible.