2. Installation

Das Modul selbst wird wie jedes andere auch über "Module verwalten" installiert und aktiviert. Dort können dann auch die Einstellungen vorgenommen werden.

Darüber hinaus müssen einige der original ConPresso-Dateien bearbeitet werden, da das Modul direkt in die Originalfunktionen eingreift. Für unveränderte Originalinstallationen bzw. Neuinstallationen liegen dem Modul sog. pre-modded files bei, die nur in den ConPresso-Ordner kopiert werden müssen und die Originale ersetzen.

Bei bereits bearbeiteten Installationen sollten folgende Änderungen besser von Hand durchgeführt werden:

=== OPEN / ÖFFNEN ===

_cfg/global_header.php(.dist)

=== FIND / FINDE ===

</head>

=== BEFORE, ADD / DAVOR, EINFÜGEN ===

<!-- Imagetool-Mod -->
<?php echo $mod_imagesize_js; ?>
<!-- Imagetool-Mod -->

Bei einer 4.1.x-Installation und Nutzung der Seitentemplates oder Verzicht auf PHP-Funktionen kann der HTML-Code auch direkt in das Template eingegeben werden:

<script language="javascript" src="../MODULVERZEICHNIS/includes/ZoomImage.js" type="text/javascript"></script>

Oder es kann eine Seitentemplatefunktion benutzt werden:

<!-- Function: ImagesizeJS; -->

=== OPEN / ÖFFNE ===

_include/parser.php

=== FIND / FINDE === (ganz am Ende)

?>

=== BEFORE, ADD / DAVOR, EINFÜGEN ===

// Imagetool-Mod
if (array_key_exists('Imagetool', $activeModules))
{
  include(CPO_BASEDIR . $activeModules['Imagetool']['directory'] . '/includes/click_images.inc.php');
}
// Imagetool-Mod 

=== OPEN / ÖFFNE ===

_includesite/i_file_upload.php

=== FIND / FINDE === (dies ist nur ein Teil einer ganzen Zeile!)

<input type="file" name="uppedFiles[]" size="80" /><?php echo help

=== AFTER, ADD / DANACH, EINFÜGEN ===

<?php
// Imagetool-Mod
if (array_key_exists('Imagetool', $activeModules))
{
  include(CPO_BASEDIR . $activeModules['Imagetool']['directory'] . '/includes/inc_form.php');
}
// Imagetool-Mod
?>

=== FIND / FINDE === (dies ist nur ein Teil einer ganzen Zeile!)

printf(__('The file is an image of type <em>%s</em> and is suitable for webpages.').'<br />',

=== BEFORE, ADD / DAVOR, EINFÜGEN ===

// Imagetool-Mod
if (array_key_exists('Imagetool', $activeModules))
{
  include(CPO_BASEDIR . $activeModules['Imagetool']['directory'] . '/includes/inc_resize.php');
}
// Imagetool-Mod

=== OPEN / ÖFFNEN ===

_includesite/i_manage_files.php

=== FIND / FINDE ===

@unlink (CPO_BASEDIR.'_data/'.$_GET['file']);

=== AFTER, ADD / DANACH, EINFÜGEN ===

// Imagetool-Mod
if (array_key_exists('Imagetool', $activeModules))
{
  include(CPO_BASEDIR . $activeModules['Imagetool']['directory'] . '/includes/inc_del.php');
}
// Imagetool-Mod

Wie geht es weiter?

  1. Das Modul wird in einen Unterordner des Conpresso-Verzeichnisses kopiert.
  2. Nach Einloggen ins Backend kann das Modul über "Module"-"Module verwalten" installiert werden.
    Hierzu werden die untenstehenden Aktionen zur Verfügung gestellt.

Installation
Durch Klick auf wird das Modul installiert und die notwendigen Tabellen erstellt sowie alle Einstellungen vorgenommen.

Aktivierung
Durch Klick auf wird das Modul aktiviert und ab sofort die zugehörige Navigation angezeigt, mit der alle weiteren modulspezifischen Aktionen durchgeführt werden.

Deaktivierung
Durch Klick auf wird das Modul deaktiviert und die Navigation wieder entfernt. Es wird dabei nichts gelöscht oder geändert, auch das Frontend bleibt erreichbar!

Deinstallation
Durch Klick auf wird das Modul nach einer Sicherheitsabfrage deinstalliert und damit die getätigten Einstellungen gelöscht!
Um das Modul vollständig zu entfernen, müssen Sie jetzt nu?r noch das Modul-Verzeichnis löschen.

Modulspezifische Funktionen

Einstellungen
Durch Klick auf wird das Menü für die Moduleinstellungen aufgerufen.

Verwendung von Lightbox v2

Statt des moduleigenen Pop-Up-Fensters können Sie auch Fremdprodukte wie Lightbox oder dessen Derivate benutzen.

Dazu müssen Sie diese nach Anleitung installieren und ein das Code-Template anpassen.

Nehmen wir mal an, Sie haben Lightbox in einem Unterverzeichnis "lightbox" im ConPresso-Verzeichnis installiert und die Pfade im CSS- und JS-File laut Lightbox-Anleitung angepasst.

Dann muß ins Seitentemplate bzw. global_header statt dem Modul-JS-Code der Lightbox-Code

<head>
...
<script type="text/javascript" src="../lightbox/js/prototype.js"></script>
<script type="text/javascript" src="../lightbox/js/scriptaculous.js?load=effects,builder"></script>
<script type="text/javascript" src="../lightbox/js/lightbox.js"></script>
<link rel="stylesheet" href="../lightbox/css/lightbox.css" type="text/css" media="screen" />
</head>

Nun nur noch das Code-Template in den Moduleinstellungen ändern zu

<a href="### ZOOM_FILE ###" rel="lightbox" title="### IMG_ALT ###">### IMG_TAG ###</a>

 

Update auf Version 4.3

Um ein Update auf die Version 4.3 von älteren Versionen des Moduls vorzunehmen sollten Sie vorsichtshalber alle Einstellungen zuerst notieren!

Dann einfach die bisherigen Dateien im Modulverzeichnis mit den aus dem neuen Archiv überschreiben. An den Codeteilen in den ConPresso-Dateien hat sich nichts geändert.

Es gibt aber zwei neue Einstellungen, ohne die das Modul im Frontend ohne Funktion ist, daher sind diese von Hand nachzutragen:

IMG Attribute:

align,alt,border,height,hspace,ismap,longdesc,name,src,usemap,vspace,width,class,id,style,title,dir,lang

Code Vorlage:

<a href="### ZOOM_FILE ###" onclick="ZoomImageFenster(this.href,### ZOOM_WIDTH ###,### ZOOM_HEIGHT ###,'### CLOSE_TEXT ###\n### IMG_ALT ###'); return false" title="### ENLARGE_TEXT ###
### IMG_ALT ###">### IMG_TAG ###</a>

Diese neuen Einstellungen erlauben eine völlig freie Definition des erzeugten Codes und der auszulesenden Attribute, so daß auch andere systemfremde Bildtools wie z.B. Lightbox ohne weitere Codeeingriffe benutzt werden können.