Systemvoraussetzungen:

mind. 500 MB Arbeitsspeicher (1 GB empfohlen)
PHP >= 7.2, <= 8.0
PHP allow_url_fopen
symlinks
Git
Composer
Lese-/Schreibrechte im Installationsordner

we2p Ordner

Ordner namens “we2p” auf oberster Ebene erstellen und einen darauf zeigenden Symlink (“we2p”) im Web-Root erstellen, falls dieses von der obersten Ebene abweicht.

mkdir we2p
cd public
ln -s ../we2p we2p
cd ..

Falls das Typo3 in einem git-Repository verwaltet wird, sollten folgende Einträge in der .gitignore ergänzt werden:

/we2p
/public/we2p

we2p Installer

In den “we2p”-Ordner wird nun das we2p-Installer Projekt geklont (we2p:U91J9fWhqzcJxEyR3Tts):

cd we2p
git clone https://we2p:U91J9fWhqzcJxEyR3Tts@gitlab.venus-werbung.de/we2p-software/webmodules.git .

Um den Installer freizuschalten muss eine Datei “FIRST_INSTALL” im “we2p”-Ordner erstellt werden.

Anschließend kann im Browser die Seite www.example.com/we2p/install.php aufgerufen werden und man wird durch die Installation geführt. Der dafür benötigte Token wird von uns bereitgestellt.

Sie müssen dabei nur den ersten Schritt abschließen. Der Punkt “Konfiguration” wird von uns zu einem späteren Zeitpunkt übernommen.

composer.json

Die Installation der Module sollte auch auf den lokalen Entwicklungsumgebungen erfolgen, da es sonst zu Problemen mit composer kommen kann.

Das Core-Plugin der we2p® WebModule wird durch den Installer im “we2p” Ordner abgelegt und aktualisiert. Die Typo3 Extension wird direkt aus einem Git-Repository bezogen.
Entsprechend müssen folgende “repositories” im composer.json der Typo3 Installation ergänzt werden:

"repositories": [
  {
      "type": "path",
      "url": "we2p/components/*"
  },
  {
	  "type": "vcs",
	  "url": "https://we2p:pwE-cj6nhhy-XFwsWMfz@gitlab.venus-werbung.de/we2p-software/we2p-typo3adapter.git"
  }
]

Außerdem muss vorübergehend die minimum-stability im composer.json auf “dev” gesetzt werden, da sich manche der Pakete noch in einem Entwicklungsstand befinden.

"minimum-stability": "dev",
"prefer-stable": true,

Danach kann die Typo3 Extension mit Composer installiert werden:

composer req we2p/webmodules-core "*"
composer req we2p/we2p-typo3adapter

Typo3 Site-Config:

In der Sitekonfiguration “config.yaml” müssen folgende routeEnhancers ergänzt werden um die Funktionalität der dynamisch generierten Listen/Detailseiten zu gewährleisten:

routeEnhancers:
  we2pWebModules:
    type: 'we2pWebModules'
    partNames:
      - 'module'
      - 'section'
      - 'value-01'
      - 'value-02'

Im Typo3 Backend:

Extension “we2p WebModule” im Extension-Manager installieren
Typoscript im site-template inkludieren
Im Typo3 Seitenbaum müssen ein paar eigene Seiten für die dynamischen Modul-Seiten angelegt werden. Die Seiten können zum Beispiel in einen Ordner “we2p” gelegt werden, müssen aber über folgende absolute Pfade erreichbar sein:
1. “/maps”
2. “/listing”
3. “/detail”
4. “/listing-maps”
5. “/bookmarks”
6. “/grid”
7. “/slide“
In jede dieser Seiten muss das Element “System-Socket“ eingefügt werden, welches sich im Reiter “Venus” der Content-Elemente befindet.

Beispiel:

Pflege im Backend:

Der Redakteur kann durch das Content-Element “Venus Auflistung” ein dynamisch gefiltertes Listing in einem beliebigen CMS-Artikel ergänzen und im Backend konfigurieren.

Die Schulung der Redakteure erfolgt in der Regel durch uns.

Endbenutzerdokumentation

Installation (Typo3)