TinyMCE und AjaxFileManager

2011-09-05T07:25:19Z

Andi: /* Download des AjaxFileManagers */

{{AppliesTo
|Version=2.10.0
}}
[[Category:Admin HOWTOS]]
Eine Anleitung, wie man den kostenlosen und durchaus brauchbaren "AjaxFileManager" in Contao einbindet.

=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.

=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:
<source lang="php">
define('CONFIG_SYS_DEFAULT_PATH', '../../../../tl_files/media'); //accept relative path only
define('CONFIG_SYS_ROOT_PATH', '../../../../tl_files/media'); //accept relative path only
</source>
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:
<source lang="php">
elements : "<?php echo $this->rteFields; ?>,ajaxfilemanager",
</source>

==file_browser_callback ergänzen==
Hinter theme_advanced_resizing: true, folgende Zeile einfügen:
<source lang="php">
file_browser_callback : "ajaxfilemanager",
</source>
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:
<source lang="php">
// 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
</source>
Wenn man als Grundeinstellung nicht thumbnail, sondern detail wünscht, kann man die Zeile mit var view = 'thumbnail' entsprechend anpassen. 
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.

==Nachtrag==
Um die Änderungen updatesicher zu machen, kann AjaxFileManager auch so einbinden: 
Die Datei ''system/config/tinyMCE.php'' kopieren und umbenennen in z.B. ''tinyCustom.php''. 
Dann alle angeführten Änderungen in ''tinyCustom.php'' eintragen. 
Zum Einbinden der ''tinyCustom.php'' folgende Zeile in ''system/config/dcaconfig.php'' eintragen:
<source lang="php">
$GLOBALS['TL_DCA']['tl_content']['fields']['text']['eval']['rte'] = 'tinyCustom';
</source>

=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. 
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 im [[Safemode_Hack|Safe-Mode-Hack]]-Modus läuft. 
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.

=Dateirechte setzen für Dateien, die mit AjaxFileManager hochgeladen werden=
(ebenfalls nur nötig für Installationen mit SafeMode-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|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):
<source lang="php">
var $uploadFileMode = 0775;
</source>

=Forenthread=
[http://www.contao-community.de/showthread.php?22358-Contao-tinyMCE-und-AjaxFileManger-HowTo Diskussionsthread im Forum]

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

Contao Community Documentation - Benutzerbeiträge [de]

TinyMCE und AjaxFileManager