Phoca PDF installieren und benutzen

Dieser Artikel beschreibt, die Installation der Phoca PDF Komponente in Joomla! v2.5

In Joomla! v1.7 & v2.5 ist das PDF Feature nicht mehr enthalten. Wenn Sie PDF Dokumente aus Ihren Artikeln erstellen möchten, sollten Sie die Phoca PDF Komponente und das Phoca PDF Content Plugin installieren. Wie auch immer, es ist nicht so einfach wie es aussieht. Joomla v1.7 & v2.5 enthält in der Artikelansicht keine Links zu PDF und es gibt kein Ereignis das erlaubt, einen PDF Link durch ein Plugin einzufügen. Das bedeutet, einige Joomla! 1.6 Dateiein müssen verändert werden (das Nutzen eines System Plugins, um eine geeignete Stelle in Joomla zum Einfügen eines PDF Links zu finden, erwies sich als nicht effektiv).

Download

Laden Sie die Phoca PDF Komponente von der Phoca PDF Download-Seite herunter. Sie erhalten eine ZIP-Datei. Loggen Sie sich in Ihre Joomla! v1.7 & v2.5 Administrationsseite (Backend) ein und folgen Sie diesen Schritten:

Gehen Sie zu Erweiterungen (Erweiterungen - Erweiterungen: Installieren). Sie können:

Paketdateien hochladen - wählen Sie die Phoca PDF Komponente ZIP-Datei auf Ihrer Festpatte aus und klicken Sie auf Hochladen & Installieren
Aus Verzeichnis installieren - Sie können die Phoca PDF Komponente ZIP-Datei in ein Verzeichnis Ihres Servers hochladen und von dort aus installieren
Von Webadresse installieren - Sie können auch von einer anderen URL aus installieren

Nachdem Sie die ZIP-Datei hochgeladen haben, sehen Sie ein Fenster mit folgenden Optionen:

Vollinstallation

Wählen Sie diese Methode, wenn das Phoca PDF Content-Plugin benutzt werden soll. Der Phoca PDF Installation wird die folgenden Aktionen versuchen:

Installation der Phoca PDF Kern Komponente
Backup der folgenden Joomla! Kern Inhalte:
- components/com_content/views/article/tmpl/default.php nach components/com_content/views/article/tmpl/default.php.bak
- components/com_content/views/category/tmpl/blog_item.php nach components/com_content/views/category/tmpl/blog_item.php.bak
- components/com_content/views/featured/tmpl/default_item.php nach components/com_content/views/featured/tmpl/default_item.php.bak
Kopieren der folgenden Phoca PDF Inhalts- und Dokumentdateien:
- von administrator/components/com_phocapdf/files/pdf/pdf.php nach libraries/joomla/document/pdf/pdf.php
- von administrator/components/com_phocapdf/files/com_content/views/article/view.pdf.php nach components/com_content/views/article/view.pdf.php
- von administrator/components/com_phocapdf/files/com_content/views/article/tmpl/default.php nach components/com_content/views/article/tmpl/default.php
- von administrator/components/com_phocapdf/files/com_content/views/category/tmpl/blog_item.php nach components/com_content/views/category/tmpl/blog_item.php
- von administrator/components/com_phocapdf/files/com_content/views/featured/tmpl/default_item.php nach
  components/com_content/views/featured/tmpl/default_item.php

Diese Methode wird die Joomla! Dateien überschreiben. Dies kann nur erfolgreich sein, wenn die Berechtigungen und der Besitz von Dateien und Ordnern korrekt auf dem Server eingerichtet ist. Nach der Installation überprüfen Sie bitte, ob die aufgeführten Dateien erstellt wurden. Wenn das Template, anzuzeigende Inhalte überschreibt, muss der Inhalt der Dateien des Templates selbst geändert werden. Siehe folgende Installationsmethode "Benutzerdefinierte Installation". Es ist ein Backup der Joomla! Dateien empfohlen, bevor diese Methode angewendet wird.

Benutzerdefinierte Installation

Wählen Sie diese Methode, wenn das Phoca PDF Plugin nicht benutzt werden soll, oder Sie selbständig die Joomla! Kerndateien bearbeiten möchten. (z.B. weil Ihr Template die Inhaltsansicht-Dateien überschreibt. Mit dieser Methode werden keine Joomla! Kerndateien überschrieben und es werden folgende Aktionen durchgeführt:

Installation der Phoca PDF Kern Komponente
Kopieren der folgenden Phoca PDF Dokumentdateien:
- von administrator/components/com_phocapdf/files/pdf/pdf.php nach libraries/joomla/document/pdf/pdf.php
- von administrator/components/com_phocapdf/files/com_content/views/article/view.pdf.php nach components/com_content/views/article/view.pdf.php

Wenn Sie diese Methode verwenden wollen und Sie wollen auch das Phoca PDF Content Plugin verwenden, müssen die Joomla! Kerndateien angepasst werden.

Joomla! Kern-Inhaltsdateien anpassen:

Bearbeiten Sie folgende Datei (wenn Ihr Template die Joomla! Kern-Inhaltsdateien überschreibt, müssen Sie diese Datei im Verzeichnis Ihres Templates anpassen):

components/com_content/views/article/tmpl/default.php

Zirka Zeile 34

VON:

<?php if ($params->get('access-edit') ||  $params->get('show_print_icon') || $params->get('show_email_icon')) : ?>
		<ul class="actions">
		<?php if (!$this->print) : ?>

ZU:

<?php
$phocaPDF = false;
if (JPluginHelper::isEnabled('phocapdf', 'content')) {
	include_once(JPATH_ADMINISTRATOR.DS.'components'.DS.'com_phocapdf'.DS.'helpers'.DS.'phocapdf.php');
	$phocaPDF = PhocaPDFHelper::getPhocaPDFContentIcon($this->item, $params);
}
?>

<?php if ($params->get('access-edit') ||  $params->get('show_print_icon') || $params->get('show_email_icon') || $phocaPDF) : ?>
		<ul class="actions">
		<?php echo $phocaPDF; ?>
		<?php if (!$this->print) : ?>

Bearbeiten Sie folgende Datei (wenn Ihr Template die Joomla! Inhaltsdateien überschreibt, müssen Sie diese Datei im Verzeichnis Ihres Templates anpassen):

components/com_content/views/category/tmpl/blog_item.php

components/com_content/views/featured/tmpl/default_item.php

Zirka Zeile 31

VON:

<?php if ($params->get('show_print_icon') || $params->get('show_email_icon') || $canEdit) : ?>
	<ul class="actions">
		<?php if ($params->get('show_print_icon')) : ?>

ZU:

&tt;?php
$phocaPDF = false;
if (JPluginHelper::isEnabled('phocapdf', 'content')) {
	include_once(JPATH_ADMINISTRATOR.DS.'components'.DS.'com_phocapdf'.DS.'helpers'.DS.'phocapdf.php');
	$phocaPDF = PhocaPDFHelper::getPhocaPDFContentIcon($this->item, $params);
}
?>
&tt;?php if ($params->get('show_print_icon') || $params->get('show_email_icon') || $canEdit || $phocaPDF) : ?>
	&tt;ul class="actions">
		&tt;?php echo $phocaPDF; ?>
		&tt;?php if ($params->get('show_print_icon')) : ?>

Aktualisierung

Wählen Sie diese Methode, falls Sie die Phoca PDF Komponente Dateien aktualisieren wollen. Es werden keine Modifikationen an Joomla Kerndateien vorgenommen.

Keine dieser oben erwähnten Methoden installiert das Phoca PDF Content Plugin. Das Phoca PDF Content Plugin muß in: Erweiterungen - Plugins - Erweiterungen: Plugins installiert und aktiviert werden.

Beachten Sie, einige von Templates überschriebene Inhaltsdateien, also die Dateien, die benötigt werden um Inhalt (Artikel) anzuzeigen, werden nicht aus dem com_content Bereich, sondern aus dem Template Bereich verwendet. Zum Beispiel:

components/com_content/views/article/tmpl/default.php

ist gespeichert in:

templates/your-template/html/com_content/article/default.php

Dann muß die Template-Datei überschrieben werden.

Das Joomla! Cache System Plugin benutzen

Falls das Joomla! Cache System Plugin auf Ihrer Seite eingeschaltet ist, setzen Sie bitte den Parameter PDF Ziel nicht auf den Wert Inline Browser in den Phoca PDF Content Plugin Einstellungen. Benutzen Sie stattdessen Inline Browser (Popup) (Das ist der Standardwert). Das Cache System Plugin erzeugt keine korrekten Cache (Zwischenspeicher) Dateien, wenn der Inline Browser Wert gesetzt ist.