TinyMCE und AjaxFileManager: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Download des AjaxFileManagers)
 
(8 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
 
}}
 
}}
 
[[Category:Admin HOWTOS]]
 
[[Category:Admin HOWTOS]]
Eine Anleitung, wie man den kostenlosen und durchaus brauchbaren "AjaxFileManager" in Contao einbindet.
+
Eine Anleitung, wie man den kostenlosen und durchaus brauchbaren "AjaxFileManager" in Contao einbindet.<br />
 +
Ein Hinweis aus dem Forenthread:<br />
 +
AjaxFileManager ist eine Erweiterung für TinyMCE und nicht speziell auf Contao zugeschnitten, d.h., contao-spezifische Einstellungen (z.B. Berechtigungen aus der Benutzerverwaltung, Einstellungen für Upload-Dateitypen und -größen) werden nicht unterstützt.
  
 
=Download des AjaxFileManagers=
 
=Download des AjaxFileManagers=
Das Paket "Ajax File and Image Manager Version 1.0 Final" von [http://www.phpletter.com/download_project_version.php?version_id=33 phpletter.com] downloaden.
+
Das Paket [http://www.phpletter.com/download_project_version.php?version_id=33 Ajax File and Image Manager Version 1.0 Final] downloaden.
  
 
=Dateien kopieren=
 
=Dateien kopieren=
Zeile 73: Zeile 75:
 
</source>
 
</source>
 
Wenn man als Grundeinstellung nicht thumbnail, sondern detail wünscht, kann man die Zeile mit var view = 'thumbnail' entsprechend anpassen.<br />
 
Wenn man als Grundeinstellung nicht thumbnail, sondern detail wünscht, kann man die Zeile mit var view = 'thumbnail' entsprechend anpassen.<br />
Im Forenthread befindet sich [http://www.contao-community.de/showthread.php?22358&p=149890&viewfull=1#post149890 in diesem Post (siehe Anhang)] meine tinyMCE.php mit allen Änderungen.
+
Im Forenthread befindet sich [http://www.contao-community.de/showthread.php?22358&p=149890&viewfull=1#post149890 in diesem Post] (s. Anhang) meine tinyMCE.php mit allen Änderungen.
  
 
==Nachtrag==
 
==Nachtrag==
Um die Änderungen updatesicher zu machen, kann AjaxFileManager auch so einbinden:<br />
+
Um die Änderungen updatesicher zu machen, kann man AjaxFileManager auch so einbinden:<br />
 
Die Datei ''system/config/tinyMCE.php'' kopieren und umbenennen in z.B. ''tinyCustom.php''.<br />
 
Die Datei ''system/config/tinyMCE.php'' kopieren und umbenennen in z.B. ''tinyCustom.php''.<br />
 +
''tinyCustom.php'' soll sich dann ebenfalls im Verzeichnis ''system/config/'' befinden.<br />
 
Dann alle angeführten Änderungen in ''tinyCustom.php'' eintragen.<br />
 
Dann alle angeführten Änderungen in ''tinyCustom.php'' eintragen.<br />
 
Zum Einbinden der ''tinyCustom.php'' folgende Zeile in ''system/config/dcaconfig.php'' eintragen:
 
Zum Einbinden der ''tinyCustom.php'' folgende Zeile in ''system/config/dcaconfig.php'' eintragen:
Zeile 83: Zeile 86:
 
$GLOBALS['TL_DCA']['tl_content']['fields']['text']['eval']['rte'] = 'tinyCustom';
 
$GLOBALS['TL_DCA']['tl_content']['fields']['text']['eval']['rte'] = 'tinyCustom';
 
</source>
 
</source>
 +
Im Forenthread wurde darauf hingewiesen, dass die updatesichere Methode einen weiteren Vorteil besitzt: AjaxFileManager wird auf diese Weise nur im Backend zur Verfügung gestellt.
  
 
=Deutsche Sprachdatei hinzufügen=
 
=Deutsche Sprachdatei hinzufügen=
Die deutsche Sprachdatei findet sich im Forenthread und kann als Anhang von diesem [http://www.contao-community.de/showthread.php?22358&p=149890&viewfull=1#post149890 Posting] herunter geladen werden.<br />
+
Die deutsche Sprachdatei findet sich im Forenthread und kann von diesem [http://www.contao-community.de/showthread.php?22358&p=149890&viewfull=1#post149890 Posting] (s. Anhang) herunter geladen werden.<br />
 
Diese Datei muss in das Verzeichnis ''plugins/tinyMCE/plugins/ajaxfilemanager/langs'' kopiert werden.
 
Diese Datei muss in das Verzeichnis ''plugins/tinyMCE/plugins/ajaxfilemanager/langs'' kopiert werden.
  
 
=Ordner- und Dateirechte setzen=
 
=Ordner- und Dateirechte setzen=
Wie ein Forumsmitglied bestätigte, ist dieser Abschnitt nur wichtig, wenn Contao im [[Safemode_Hack|Safe-Mode-Hack]]-Modus läuft.<br />
+
Wie ein Forumsmitglied bestätigte, ist dieser Abschnitt nur wichtig, wenn Contao mit dem [[Safemode_Hack|Safe-Mode-Hack]] läuft.<br />
Im SMH-Modus braucht der Ordner ''plugins/tinyMCE/plugins/ajaxfilemanager/session'' und die beiden darin enthaltenen Dateien die Dateirechte 0775, damit AjaxFileManager nicht die fehlenden Rechte moniert.
+
Bei Verwendung des Safe-Mode-Hack brauchen der Ordner ''plugins/tinyMCE/plugins/ajaxfilemanager/session'' und die beiden darin enthaltenen Dateien die Dateirechte 0775, damit AjaxFileManager nicht die fehlenden Rechte moniert.
  
 
=Dateirechte setzen für Dateien, die mit AjaxFileManager hochgeladen werden=
 
=Dateirechte setzen für Dateien, die mit AjaxFileManager hochgeladen werden=
(ebenfalls nur nötig für Installationen mit SafeMode-Hack)<br />
+
(ebenfalls nur nötig für Installationen mit Safe-Mode-Hack)<br />
 
AjaxFileManager bearbeitet Dateien nicht als ftp-user, sondern als Webserveruser. Das bedeutet u. U. Einschränkungen für AjaxFileManager bei Dateien, die dem ftp-user gehören, und umgekehrt.<br />
 
AjaxFileManager bearbeitet Dateien nicht als ftp-user, sondern als Webserveruser. Das bedeutet u. U. Einschränkungen für AjaxFileManager bei Dateien, die dem ftp-user gehören, und umgekehrt.<br />
 
Damit alle Vorgänge reibungslos funktionieren, brauchen die Dateien im ''tl_files/media''-Ordner (siehe Abschnitt [[#Konfigurationsdatei_bearbeiten|Konfigurationsdatei bearbeiten]]) und der Ordner selbst die Dateirechte 0775.<br />
 
Damit alle Vorgänge reibungslos funktionieren, brauchen die Dateien im ''tl_files/media''-Ordner (siehe Abschnitt [[#Konfigurationsdatei_bearbeiten|Konfigurationsdatei bearbeiten]]) und der Ordner selbst die Dateirechte 0775.<br />

Aktuelle Version vom 7. September 2011, 19:16 Uhr

betrifft
Contao Version 2.10.0

Eine Anleitung, wie man den kostenlosen und durchaus brauchbaren "AjaxFileManager" in Contao einbindet.
Ein Hinweis aus dem Forenthread:
AjaxFileManager ist eine Erweiterung für TinyMCE und nicht speziell auf Contao zugeschnitten, d.h., contao-spezifische Einstellungen (z.B. Berechtigungen aus der Benutzerverwaltung, Einstellungen für Upload-Dateitypen und -größen) werden nicht unterstützt.

Download des AjaxFileManagers

Das Paket Ajax File and Image Manager Version 1.0 Final downloaden.

Dateien kopieren

Aus dem heruntergeladenen Paket (s.o.) den Ordner ajaxfilemanager nach plugins/tinyMCE/plugins/ajaxfilemanager kopieren.
Alles andere aus der heruntergeladenen zip-Datei wird nicht gebraucht.

Konfigurationsdatei bearbeiten

Die Datei plugins/tinyMCE/plugins/ajaxfilemanager/inc/config.base.php öffnen, darin in den Zeilen 52/53 CONFIG_SYS_DEFAULT_PATH und CONFIG_SYS_ROOT_PATH folgendermaßen setzen:

define('CONFIG_SYS_DEFAULT_PATH', '../../../../tl_files/media'); //accept relative path only
define('CONFIG_SYS_ROOT_PATH', '../../../../tl_files/media');	//accept relative path only

Dabei /media nach eigenen Wünschen anpassen oder auch weglassen...

tinyMCE.php bearbeiten

Die Konfigurationsdatei system/config/tinyMCE.php folgendermaßen bearbeiten:

ajaxfilemanager hinzufügen

In der Zeile, die mit elements: beginnt, ajaxfilemanager hinzufügen. Dies sieht dann so aus:

elements : "<?php echo $this->rteFields; ?>,ajaxfilemanager",

file_browser_callback ergänzen

Hinter theme_advanced_resizing: true, folgende Zeile einfügen:

file_browser_callback : "ajaxfilemanager",

Ob es genau diese Position innerhalb der tinyMCE.php sein muss, weiß ich nicht, aber irgendwo stand diese Empfehlung und es funktioniert so bei mir.

Skript einfügen

Am Ende der Datei vor </script> folgendes einfügen:

// start ajaxfilemanager configuration
function ajaxfilemanager(field_name, url, type, win) {
            var ajaxfilemanagerurl = "plugins/tinyMCE/plugins/ajaxfilemanager/ajaxfilemanager.php";
            switch (type) {
                case "image":
                    break;
                case "media":
                    break;
                case "flash":
                    break;
                case "file":
                    break;
                default:
                    return false;
            }
	    var view='thumbnail'; //alternativ: 'detail'
	    var language='de';
            tinyMCE.activeEditor.windowManager.open({
                url: ajaxfilemanagerurl + '?view=' + view + '&language=' + language,
		title: "Ajax Dateimanager",
                width: 882,
                height: 540,
                inline : "yes",
                close_previous : "no"
            },{
                window : win,
                input : field_name,
		resizable: "yes"
            });
            return false;
        }
// end ajaxfilemanager configuration

Wenn man als Grundeinstellung nicht thumbnail, sondern detail wünscht, kann man die Zeile mit var view = 'thumbnail' entsprechend anpassen.
Im Forenthread befindet sich in diesem Post (s. Anhang) meine tinyMCE.php mit allen Änderungen.

Nachtrag

Um die Änderungen updatesicher zu machen, kann man AjaxFileManager auch so einbinden:
Die Datei system/config/tinyMCE.php kopieren und umbenennen in z.B. tinyCustom.php.
tinyCustom.php soll sich dann ebenfalls im Verzeichnis system/config/ befinden.
Dann alle angeführten Änderungen in tinyCustom.php eintragen.
Zum Einbinden der tinyCustom.php folgende Zeile in system/config/dcaconfig.php eintragen:

$GLOBALS['TL_DCA']['tl_content']['fields']['text']['eval']['rte'] = 'tinyCustom';

Im Forenthread wurde darauf hingewiesen, dass die updatesichere Methode einen weiteren Vorteil besitzt: AjaxFileManager wird auf diese Weise nur im Backend zur Verfügung gestellt.

Deutsche Sprachdatei hinzufügen

Die deutsche Sprachdatei findet sich im Forenthread und kann von diesem Posting (s. Anhang) herunter geladen werden.
Diese Datei muss in das Verzeichnis plugins/tinyMCE/plugins/ajaxfilemanager/langs kopiert werden.

Ordner- und Dateirechte setzen

Wie ein Forumsmitglied bestätigte, ist dieser Abschnitt nur wichtig, wenn Contao mit dem Safe-Mode-Hack läuft.
Bei Verwendung des Safe-Mode-Hack brauchen der Ordner plugins/tinyMCE/plugins/ajaxfilemanager/session und die beiden darin enthaltenen Dateien die Dateirechte 0775, damit AjaxFileManager nicht die fehlenden Rechte moniert.

Dateirechte setzen für Dateien, die mit AjaxFileManager hochgeladen werden

(ebenfalls nur nötig für Installationen mit Safe-Mode-Hack)
AjaxFileManager bearbeitet Dateien nicht als ftp-user, sondern als Webserveruser. Das bedeutet u. U. Einschränkungen für AjaxFileManager bei Dateien, die dem ftp-user gehören, und umgekehrt.
Damit alle Vorgänge reibungslos funktionieren, brauchen die Dateien im tl_files/media-Ordner (siehe Abschnitt Konfigurationsdatei bearbeiten) und der Ordner selbst die Dateirechte 0775.
AjaxFileManager vergibt beim Upload aber nur die Dateirechte 0755. Um dies abzuändern, muss man in der Datei plugins/tinyMCE/plugins/ajaxfilemanager/inc/class.upload.php den Wert 0775 für var $uploadFileMode eintragen (Zeile 30):

var $uploadFileMode = 0775;

Forenthread

Diskussionsthread im Forum

Wenn jemand etwas mit dieser Anleitung anfangen kann, dann würde es mich freuen.
Ulrike

Ansichten
Meine Werkzeuge

Contao Community Documentation

ich werde mir ein Aquarium kaufen...mit lauter Blowfishen..und die nenne ich dann bcrypt, sha1 und md5.

Leo Unglaub
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge