Anleitung für das Modul MITS ImageSlider

Modul-Download: MITS_ImageSlider

1. Installation

Systemvoraussetzung: Funktionsfähige modified eCommerce Shopsoftware ab der Version 2.0.0.0 rev 9678

Vor der Installation des Moduls sichern sie bitte komplett ihre aktuelle Shopinstallation (Dateien und Datenbank)!
Für eventuelle Schäden übernehmen wir keine Haftung!
Die Installation und Nutzung des Moduls MITS ImageSlider erfolgt auf eigene Gefahr!

Die Installation des Moduls MITS ImageSlider ist in der aktuellen Shopversion 2.x ziemlich einfach.

1. Wenn ihr Template bereits Anpassung für den Imageslider v1.5 enthalten hat, so entfernen Sie bitte diese Anpassungen vor der Installation! Dazu müssen Sie nur die Anweisungen für die Templateanpassungen aus der Installationsanleitung für die Version v1.5 rückgängig machen.
2. Falls der admin-Order des Shops unbenannt wurde, dann entsprechnd auch den Ordner admin im Verzeichns shoproot des Moduls vor dem Hochladen ebenfalls entsprechend umbenennen!
3. Kopieren Sie anschließend einfach alle Dateien in dem Verzeichnis shoproot aus dem Modulpaket MITS_ImageSlider in das Hauptverzeichnis ihrer bestehenden modified eCommerce Shopsoftware 2.x Installation. Es werden dabei keine Dateien überschrieben!
4. Nachdem sie alle Dateien in den Shop übertragen haben melden sie sich bitte im Shop mit einemm gültigen Adminzugang an, der die Berechtigung besitzt auch Systemmodule zu installieren.
5. Wechseln sie in den Administrationsbereich und rufen sie den Menüpunkt Module -> System-Module auf.
6. Markieren sie dort den Eintrag MITS ImageSlider © by Hetfield (MerZ IT-SerVice) und klicken sie dann auf der rechten Seite auf den Button Installieren. Das Modul wird nun komplett installiert. Sollten sie von einer früheren Version updaten, erledigt das Modul die Anpassung der Datenbank komplett für sie. Aktivieren sie dazu im Bearbeitungsmodus bei Modulaktualisierung die Checkbox für Datenbankaktualisierung für den MITS ImageSlider durchführen? und klicken sie auf speichern.
7. Konfigurieren sie nun das Modul nach ihren Wünschen. Die verschiedenen Einstellmöglichkeiten sind im Modul erklärt.
8. Rufen sie den Menüpunkt Hilfsprogramme -> MITS ImageSlider v2.04 auf. Dort können sie Einträge anlegen, bearbeiten oder löschen.

2. Den MITS ImageSlider im Template verfügbar machen

Um einen ImageSlider im Template anzuzeigen gibt es in der neuen Version verschiedene Möglichkeiten.

Variante 1: Per Smarty-Variable in der index.html des verwendeten Templates

Fügen Sie für den Aufruf des Standard-ImageSlider-Gruppe MITS_IMAGESLIDER einfach folgende Smarty-Variable an die gewünschte Stelle in ihrer index.html ein:

        {if isset($MITS_IMAGESLIDER)}{$MITS_IMAGESLIDER}{/if}
      

Möchten sie z.B. eine andere ImageSlider-Gruppe anzeigen lassen, dann fügen Sie für den Aufruf der anderen ImageSlider-Gruppe (in diesem Beispiel mit dem Gruppennamen ANDRER_IMAGESLIDER) einfach folgende Smarty-Variable an die gewünschte Stelle in ihrer index.html ein:

        {if isset($ANDERER_IMAGESLIDER)}{$ANDERER_IMAGESLIDER}{/if}
      

Verwenden Sie das Slider-Plugin "NivoSlider", dann stehen ihnen insgesamt 4 verschieden Themes (Designs) zur Auswahl. Folgende 4 Themes stehen ihnen beim NivoSlider zur Verfügung:

• theme-bar
• theme-dark
• theme-default (Standard-Theme, kein besonderer Aufruf notwendig)
• theme-light

Diese können Sie durch Anpassung der Smarty-Variable per replace-Befehl wechseln. Im folgenden Beispiel wird das Theme von theme-default auf theme-bar gewechselt:

        {if isset($MITS_IMAGESLIDER)}
        {$MITS_IMAGESLIDER|replace:'slider-wrapper theme-default':'slider-wrapper theme-bar'}
        {/if}
      

Hier ein weiteres Beispiel, diesmal wird das Theme von theme-default auf theme-light gewechselt:

        {if isset($ANDERER_IMAGESLIDER)}
        {$ANDERER_IMAGESLIDER|replace:'slider-wrapper theme-default':'slider-wrapper theme-light'}
        {/if}
      

Sie können die Einstellung des ImagSlider-Moduls zur Anzeige start (nur auf der Startseite verfügbar) auch anders lösen. Stellen sie dazu die Anzeigedes Imagesliders auf general um. Anschließend können Sie dann zur Beschränkung der Anzeige auf die Startseite auch folgenden Smarty-Code in der index.html verwenden:

        {if strstr ($smarty.server.PHP_SELF, 'index')}
          {if !strstr ($smarty.server.PHP_SELF, 'checkout')}
            {if $smarty.get.cPath==null and $smarty.get.manufacturers_id==''}
              {if isset($MITS_IMAGESLIDER)}
                {$MITS_IMAGESLIDER|replace:'slider-wrapper theme-default':'slider-wrapper theme-dark'}
              {/if}
            {/if}
          {/if}
        {/if}
      

Variante 2: Als Smarty-Plugin überall im Template verwenden

Neu seit dem MITS ImageSlider v2.03 ist die Nutzung des ImageSliders als Smarty-Plugin. Damit können Sie den ImageSlider in jeder beliebigen HTML-Template-Datei aufrufen. Vorraussetzung dafür ist die Einstellung der Anzeigeart general. Der Standardaufruf mit der Gruppe MITS_IMAGESLIDER sieht wie folgt aus:

        {getImageSlider slidergroup=mits_imageslider}
      

Der Aufruf mit einer anderen Gruppe (hier z.B. die ImageSlider-Gruppe ANDERER_IMAGESLIDER) sieht wie folgt aus:

        {getImageSlider slidergroup=anderer_imageslider}
      

Durch die Erweiterung des Aufrufs um den Parameter nivotheme können sie bei der Verwendung des Slider-Plugins "NivoSlider" das Theme wechseln. Im folgenden Beispiel wird das Theme von theme-default auf theme-bar gewechselt:

        {getImageSlider slidergroup=mits_imageslider nivotheme=theme-bar}
      

Hier ein weiteres Beispiel, diesmal wird das Theme von theme-default auf theme-dark gewechselt:

        {getImageSlider slidergroup=anderer_imageslider nivotheme=theme-dark}
      

Optional können Sie seit der Version 2.03 auch bei Produkten und Kategorien jeweils eine Slidergruppe zuweisen. Damit können Sie für Produkte und Kategorien einfach eigene Slider erstellen und pflegen ohne viel Aufwand. Zur Nutzung dieser Funktion müssen Sie allerdings einige Templateanpassungen vornehmen.

Für die Anpassung zur Slideranzeige bei Produkten müssen Sie in den gewünschten Templatevorlagen für ihre Produkte(dazu gehören alle Template-Dateien im Ordner module/product_info ihres Templates, z.B. shoproot/templates/tpl_modified_responsive/module/product_info/product_info_tabs_v1.html) einfach an gewünschter Stelle folgende Zeile einfügen:

        {if isset($MITS_PRODUCTS_IMAGESLIDER)}{$MITS_PRODUCTS_IMAGESLIDER}{/if}
      

Für die Anpassung zur Slideranzeige bei Kategorien müssen Sie die Templatevorlagen für ihre Kategorien(dazu gehören alle Template-Dateien im Ordner module/product_listing und module/categorie_listing ihres Templates, z.B. shoproot/templates/tpl_modified_responsive/module/product_listing/product_listing_v1.html oder shoproot/templates/tpl_modified_responsive/module/categorie_listing/categorie_listing.html) anpassen. Dazu einfach in der jeweiligen Datei an gewünschter Stelle folgende Zeile einfügen:

        {if isset($MITS_CATEGORIES_IMAGESLIDER)}{$MITS_CATEGORIES_IMAGESLIDER}{/if}
      

Für die Anpassung zur Slideranzeige bei Content-Seiten müssen Sie in die Templatevorlage für die Content-Seiten content.html im Ordner module ihres Templates (z.B. shoproot/templates/tpl_modified_responsive/module/content.html) einfach an gewünschter Stelle folgende Zeile einfügen:

        {if isset($MITS_CONTENT_IMAGESLIDER)}{$MITS_CONTENT_IMAGESLIDER}{/if}
      

3. Fertig

Wir hoffen, der neue MITS ImageSlider für die modified eCommerce Shopsoftware 2.x gefällt ihnen! Benötigen sie Unterstützung bei der indivduellen Anpassung des Modul oder haben sie eventuell doch Probleme beim Einbau? Gerne können sie unseren kostenpflichtigen Support in Anspruch nehmen. Kontaktieren sie uns einfach unter info@merz-it-service.de