TYPO3 Extension: Anleitung und Installation | TYPO3 Extension: Instructions and installation

Click here to see this guide in English

Über die TYPO3 Extension

Mit der pixx.io Extension für TYPO3 können Sie direkt aus dem Content Management System auf Ihren Medienpool bei pixx.io zugreifen und Mediendateien für Ihre Webseite auswählen.

Bitte beachten Sie: Die Version 1.0.4 der pixx.io Extension für TYPO3 ist erst ab Version 10 von TYPO3 kompatibel. Für ältere TYPO3 Versionen verwenden Sie bitte die Version 1.0.2. Diesen finden Sie ebenfalls im TYPO3 Extention Repository.

Die aktuelle Version der pixx.io Extension für Typo3 können Sie hier herunterladen.

Installation

• Loggen Sie sich als Administrator in TYPO3 ein
• Wählen Sie Admin Tools > Extensions
• Klicken Sie auf den Button Upload Extensions und wählen Sie die zuvor heruntergeladene Datei pixxio.zip von Ihrem Computer aus. Klicken Sie auf Upload.

• Nun sollten Sie den Eintrag pixx.io TYPO3 integration in der Liste unten (Installed Extensions) finden. 

Setup

• Konfiguration öffnen
  • TYPO3 Version 8: Bleiben Sie in der Liste Installed Extensions und klicken Sie auf den Configuration Button neben dem Eintrag pixx.io TYPO3 integration
  • TYPO3 Version 9: Wählen Sie Admin Tools > Settings > Extensions Configuration > pixxio

• Geben Sie Ihre pixx.io URL (z.B. firmenname.pixxio.media) und den Refresh Token ein.
• Wählen Sie nun das zu verwendende File Storage (Standard: 1) und auf Wunsch einen Subfolder, in dem die pixx.io-Daten gespeichert werden sollen
• Speichern nicht vergessen

So funktioniert die pixx.io Extension für TYPO3

Bild aus pixx.io übertragen

Sie wollen Bilder oder andere Mediendateien zu Ihrem Content hinzufügen, dann wählen Sie zunächst eine entsprechende Funktion (z.B. +Content > Text & Images > Images) und klicken Sie auf den Reiter Add Image(s) from pixx.io.

Sie können nun durch die Inhalte scrollen, aus Kollektionen wählen oder über das Suchfeld oben rechts nach Inhalten suchen.

Wählen Sie alle Dateien aus, die Sie einfügen möchten und klicken Sie auf Übernehmen.

Vorher haben Sie noch die Möglichkeit zu wählen, ob die Originaldatei übertragen oder die Bildbreite und die Qualität angepasst werden sollen.

Welche Metadaten werden übernommen?

Beim Übertragen eines Bildes aus pixx.io werden aktuell folgende Metadateninhalte in TYPO3 geschrieben:

• Filename (Dateiname in pixx.io)
• Title (Inhalt pixx.io Titel Feld oben rechts)
• Description (Inhalt aus pixx.io Beschreibungsfeld)

About the TYPO3 extension

The pixx.io extension for TYPO3 allows you to directly access your pixx.io media pool from your content management system and select files for your website.

Please note: Version 1.0.4 of the pixx.io extension for TYPO3 is only compatible with TYPO3 version 10. For older TYPO3 installations please download version 1.0.2. This can also be found in the TYPO3 Extention Repository.

Currently the extension user interface is only available in German. All UI parts are translated down below.

The current version of the pixx.io extension for Typo3 can be downloaded here.

Installation

• Log into TYPO3 as an administrator
• Select Admin Tools > Extensions
• Click on Upload Extensions and select the pixxio.zip file previously downloaded. Click on Upload
• You should now see the entry io TYPO3 integration in the list below (Installed Extensions). 

Setup

• Open the configuration
  • TYPO3 Version 8: Stay in the list of Installed Extensions and click on the Configuration button next to the io TYPO3 integration entry.
  • TYPO3 Version 9: Select Admin Tools > Settings > Extensions Configuration > pixxio

• Enter your pixx.io URL (e.g. company.pixxio.media) and the pixx.io APIrefresh Token.
• Now select the File Storage to be used (Default: 1) and a Subfolder if desired, where pixx.io data will be saved.
• Remember to save your changes.

How to use the pixx.io extension for TYPO3

To add images or other media files to your content, select a function (e.g. +Content > Text & Images > Images) and click on the Add Image(s) from pixx.io tab.

You can now scroll through content, select from collections, or use the search box on the top right to search for content. To access you pixx.io collections click the "Kollektionen" tab.

You have the option to select whether original files are used or if the image width and quality should be adjusted. To adjust image width and JPG quality deselect the "Originaldatei übertragen" (transfer original file) toggle. In the input field next to "Bildbreite" (image width) you can enter the width in pixel with which you want to transfer the marked images.

Select all files that you would like to add and click "Übernehmen" (apply).

Which metadata is transferred?

When transferring an image from pixx.io, the following metadata contents are currently written to TYPO3:

• Filename (file name in pixx.io)
• Title (content of pixx.io title field top right)
• Description (content from pixx.io description field)