OpenOffice-Dokumente in papaya CMS importieren

Mit dem von Martin Kelm entwickelten Importmodul für das Oasis-Dokumentenformat kann man OpenOffice-Dokumente in papaya CMS importieren. Dies ist möglich, da der Inhalt eines OpenOffice-Dokuments intern als XML-Datei vorliegt. Durch ein XSLT-Stylesheet lässt sich das OpenOffice-Format in ein durch papaya CMS lesbares Importformat umwandeln.

Papaya CMS bietet eine entsprechende API-Schnittstelle für Importfilter an, sodass man sich als Programmierer allein auf die Umwandlung des Dokumentenformats konzentrieren kann.

Importfilter installieren

Um den Importfiler zu installieren, sind nur wenige Schritte notwendig:

1. Zuerst muss das Paket heruntergeladen und in einem lokalen Verzeichnis entpackt werden.
2. Anschließend muss das Verzeichnis oasis/, das das XSLT-Stylesheet enthält, in das Templateverzeichnis kopiert werden.
3. Schließlich muss das Importmodul in ein Verzeichnis innerhalb von papaya-lib kopiert werden.
   

Nachdem alle Dateien kopiert worden sind, muss in der Modulverwaltung von papaya CMS ein Modulscan durchgeführt werden. Wenn das neue Modul im Paket OASIS richtig erkannt worden ist, kann der Filter eingerichtet werden.

Importfilter einrichten

Um den Importfilter einzurichten, muss unter Ansichten in den Bereich Importfiler gewechselt werden. Dieser Bereich ist standardmäßig jedoch deaktiviert und muss erst in der Systemkonfiguration aktiviert werden. Dazu stellt man vorher die Option PAPAYA_IMPORTFILTER_USE in der Optionsgruppe „System“ auf „on“.

Im folgenden Schritt ist es nun möglich, den Importfilter einzurichten. Dazu geht ihr wie folgt vor:

1. Klickt im Bereich Importfiler auf Filter hinzufügen. Die Eingabemaske „Importfilter“ wird dargestellt.
2. Gebt in das Feld „Dateiendung“ die Endung der Office-Dateien ein. Standardmäßig ist dies odt.
3. Wählt aus der Drop-Down-Liste „Filtermodul“ das Modul [OASIS] ODT import aus.
4. Übernehmt eure Eingaben mit Hinzufügen. In der linken Spalte des Content-Bereichs wird nun der Abschnitt „Importfilter“ dargestellt:

Importfilter mit Seiten verknüpfen

Um den Filter nutzen zu können, muss der Importfilter nun mit entsprechenden Seiten veknüpft werden. Das aktuelle Import-Stylesheet wandelt dabei den Content so um, das eine Vielzahl an Seitenmodulen unterstützt werden. Folgende papaya-Basismodule werden auf jeden Fall unterstützt:

• Topic with image
• Category with image

Um Ansichten, die einen dieser Module benutzen, mit dem Importfilter zu verknüpfen, geht ihr wie folgt vor:

1. Wechselt in der Ansichtenverwaltung wieder in den Bereich Ansichten.
2. Wählt in der Liste „Ansichten“ die Ansicht aus, die ihr mit dem Importfilter verknüpfen möchtet. In der rechten Spalte des Content-Bereichs werden die Listen „Ausgabefilter“ und „Importfiler“ dargestellt.
3. Klickt in der Liste „Importfilter“ auf die Checkbox „verknüpfen“, um den Importfilter mit der ausgewählten Ansicht zu verknüpfen:
   Die Eingabemaske „Filtereigenschaften bearbeiten“ wird dargestellt:
4. Wählt aus der Drop-Down-Liste XSL-Stylesheet die Datei import_odt.xsl aus. (Im Augenblick enthält die Drop-Down-Liste auch nur diese eine Datei.)
5. Übernehmt eure Auswahl mit Speichern. Der Importfilter ist jetzt eingerichtet und steht allen Seiten zur Verfügung, die mit dieser Ansicht verknüpft sind.

Office-Dokumente importieren

Der Import von OpenOffice-Dokumenten ist spielend einfach. In der Seitenansicht wird bei jeder ausgewählten Seite, die mit der entsprechend eingerichteten Ansicht verknüpft worden ist, der Punkt Importieren im Bearbeitungsmenü dargestellt.

Um einen Artikel aus einer OpenOffice-Datei zu importieren, gehst du wie folgt vor:

1. Klicke im Bearbeitungsmenü auf Importieren. Die Eingabemaske „Importieren“ wird dargestellt:
2. Klicke auf den Button Durchsuchen im Feld „Datei“. Die Dateiauswahlfunktion des Browsers wird dargestellt.
3. Suche über die Dateiauswahlfunktion des Browsers die OpenOffice-Datei aus, die du in den Artikel importieren möchtest. Der Dateiname wird mit dem kompletten Verzeichnispfad im Feld „Datei“ dargestellt.
4. Klicke in der Eingabemaske „Importieren“ auf den Button Importieren. Ein Infodialog wird dargestellt, der den erfolgreichen Import der Datei meldet.

Quellen

Den Importfilter für OpenOffice-Dokumente könnt ihr unter folgender URL herunterladen:

• http://idxsolutions.de/