PrestaShop Modul

Allgemeine Merkmale

• Absolut responsive Mouseover-Bereich und Zoom-Fenster
• Zoom-Fenster Größe einstellbar um sich anderen responsiven Elementen anzupassen
• Optimal einstellbar für variierende und fixe Bildproportionen
• Permanentes oder automatisches Inner-Zoom abhängig von Auflösung und responsiven Design
• Unterstützung für die Bilder, welche über PrestaShop zur bestimmten Produktvariationen gebunden wurden
• Funktioniert bestens auf mobilen Geräten
• Optionale unterstützung für 360°/3D Objekte mit Pinch-Zoom und Vollbild Ansicht
• Inclusive optionalen Slider für Miniaturansichten (Thumbnails)
• Responsive Modale oder Vollbild Ansichten beim Klick mit AJAX-ZOOM
• Schnelles "progressives" Laden der Hochauflösenden Bilder
• Automatische Erstellung aller notwenigen Bildkacheln und weiteren Bildern
• Integriertes "pinterest" button
• 100+ weitere Optionen
• Alle Komponente können über das PrestaShop Module Konfigurationsmenü angepasst werden
• API für Entwickler
• Kontinuierlich Produktentwicklung und technischer Support

Back-Office Screenshots

Front-Office Screenshots

CMS Screenshots

Handhabung regulärer Bilder

Bei der Handhabung regilärer Bilder ergeben sich keine Änderungen. Man kann sie wie immer einfach über das Back-Office hochladen. Allerdings können bereits hochgeladene Bilder je nach Prestashop Version durch seine Methode nach dem Upload komprimiert worden sein. Nachdem Sie AJAX-ZOOM Modul aktiviert haben wird diese automatische Komprimierung der Originalbilder durch Prestashop abgeschaltet. Wenn Sie also mit der Qualität im AJAX-ZOOM player nicht zufrieden sind, dann sollten Sie versuchen Ihre hochauflösende Bilder nochmals hochzuladen.

Handhabung der 360°/3D

Um 360°/3D zu einem Produkt hinzuzufügen, wählen Sie zunächst im Menü 'Katalog' -> 'Produkte' ein Produkt aus. Unten sollte AJAX-ZOOM tab vorhanden sein, wo sie u.A. folgendes machen können:

• Eins oder mehrere 360° für ein Produkt einrichten.
• Direkt aus dem Back-Office 360° Bilder hochladen oder
• eine ZIP Datei mit 360° Bildern auswählen, welche zuvor auf den server hochgeladen wurde. Diese ZIP Dateien müssen in '/modules/ajaxzoom/zip/' hochgeladen werden und können nach dem Import wieder gelöscht werden.
• Nach dem Importieren oder hochladen der 360 grad Bilder ist es möglich individuelle Einstellungen vorzunehmen, beispielsweise die Rotationsgeschwindigkeit anpassen sowie viele andere optionen, die AJAX-ZOOM beinhaltet, für Ihr 360 ändern.
• Voransicht der 360° Objekte in einer Fancybox starten.
• Einzelne 360 aktivieren / deaktivieren
• 360° Objekte einzelnen Kombinationen, wie es mit den Bildern der Fall ist, zuweisen.
• Eine 360° Grad "Product Tour" mit Beschreibungen, Videos etc. kreieren. Keine Programmierkenntnisse notwendig.
• Einen Copy & Paste Code für beispielsweise CMS Seiten zu erhalten, damit die 360 Grad Animationen auch dort platziert werden können. Hier ein Beispiel.

Anforderungen

• PHP 5.2+
• PrestaShop ab Ver. 1.5.1, 1.6.x oder 1.7.x
• Ioncube Loaders oder Sourceguardian Loaders installiert auf dem Server
• AJAX-ZOOM Hauptscript Dateien müssen möglicherweise separat heruntergeladen werden (mit Modul Version 1.2.11+ wird versucht während der Installation des Moduls automatisch herunterzuladen)
• Wenn Sie hochauflösende Bilder über das Back-Office hochladen möchten, dann sollten Sie in php.ini die Werte für post_max_size and upload_max_filesize anpassen

Installation

1. Gehen Sie sicher, dass die Server und PrestaShop Voraussetzungen getroffen sind!
2. Entpacken Sie den Ordner 'ajaxzoom' aus dem Archiv in das Verzeichnis '/modules/' Ihrer PrestaShop-Installation.
3. Laden Sie die neueste Version von AJAX-ZOOM herunter von www.ajax-zoom.com/index.php?cid=download and entpacken nur den 'axZm' Ordner in '/modules/ajaxzoom/'. Dieser Schritt ist unter Umständen nicht erforderlich, wenn Sie das Modul von unserer Website heruntergeladen haben. Sollten Sie nach der Installation das Verzeichnis '/modules/ajaxzoom/axZm' nicht finden, führen Sie bitte diese Schritt doch manuell durch.
4. Setzen Sie die Berecjtigungen (chmod) für '/modules/ajaxzoom/pic' Verzeichnis auf für PHP schreibbar.
5. Aktiviere das Modul über das Menü 'Module' im PrestaShop Backoffice.
6. Klicken Sie auf "Configure" und speichern Sie die Einstellungen mit den Standardwerten einmalig.
7. Die Installation ist fertig. Jetzt können Sie das Modul konfigurieren, wobei es sofort funktionieren sollte. Ggf. Template Cache löschen.
8. Falls es nicht wie erwartet funktioniert, lesen Sie bitte die Anweisungen in der Modul-Konfigurations-Seite.
9. Sollten Sie es nicht schaffen, AJAX-ZOOM perfekt in ein Thema einzubringen, wenden Sie sich bitte an den AJAX-ZOOM-Support.

Störungsbeseitigung

"TECHNICAL ERROR" Alert im Backend

Meistens resultieren diese Fehler wegen der Cross-Origin Politik der Browser für AJAX Requests. Wir müßten inzwischen alle diese Probleme beseitigt haben, außer, dass wenn Sie für Frontend eine Umleitung eingerichtet haben, z.B. von www.youdomain.com zu yourdomain.com (ohne www), dann loggen Sie sich bitte auch unter yourdomain.com/admin1235 ins Backend ein. Das gleiche gilt für http und https. Sofern z.B. fürs Frontend alles auf https umgeleitet wird, dass loggen Sie sich ins backend auch über https ein.

Hochgeladene Bilder werden nicht angezeigt

Bitte vergewissern Sie sich, dass Ioncube Loader richtig installiert ist. Wenn Sie Ioncube Loader über "lokale" php.ini eingerichtet haben, dann muss diese php.ini bzw. sowas, wie zend_extension=/vrmd/webserver/php56/lib/ioncube_loader.so auch in /modules/ajaxzoom/axZm/php.ini vorhanden sein.

RewriteBase (e.g. Bitnami / Prestashop / XAMPP)

Ver. 4.2.11+ if RewriteBase is set in .htaccess or app config file or similar you might need to change some settings in AJAX-ZOOM config file (/modules/ajaxzoom/axZm/zoomConfig.inc.php) to make things work properly. Having tested AJAX-ZOOM extension on PC (localhost) with Prestashop package from "Bitnami" (default settings) we were able to get AJAX-ZOOM working under these conditions: the url path to Prestashop was http://192.168.178.27/prestashop, whereby the document root on PC was C:/xampp/apps/prestashop/htdocs and not C:/xampp/apps/prestashop/htdocs/prestashop as one would expect. This is due to RewriteBase which is enabled on default. Also the document root here changed from standard XAMPP root which is C:/xampp/htdocs; so as of now all these settings need to be set manually in /modules/ajaxzoom/axZm/zoomConfig.inc.php for AJAX-ZOOM this way:

• $zoom['config']['fpPP'] = 'C:/xampp/apps/prestashop/htdocs';
• $zoom['config']['installPath'] = '/modules/ajaxzoom';
• $zoom['config']['urlPath'] = '/prestashop/modules/ajaxzoom';
• $zoom['config']['rewriteBase'] = '/prestashop';

product.tpl problems

In some themes in product.tpl the {if isset($HOOK_PRODUCT_FOOTER) && $HOOK_PRODUCT_FOOTER}{$HOOK_PRODUCT_FOOTER}{/if} might be missing or "hidden" inside a different "if" statement. This is not something we could do about over our module, so in case there are no JS errors and there are no changes on product detail page, please make sure that the above HOOK code is present and does not depend on any other conditions.

Uploaded images are compressed

Update: this issue seems to be fixed in AJAX-ZOOM module for Prestashop Ver. 1.1.3 Unlike other ecommerce software we know Prestashop compresses original uploaded images which reduces image quality. The solution to prevent this is to override "resize" method in "ImageManagerCore". The problem we did not solve yet is that overriding this method over our module causes incompatibility issues across different Prestashop versions, especially if developer mode is enabled. So if you want to prevent Prestashop to compress your originally uploaded images you can override the "resize" method on your own just about like this:

	public static function resize(
		$src_file, 
		$dst_file, 
		$dst_width = null, 
		$dst_height = null, 
		$file_type = 'jpg', 
		$force_type = false, 
		&$error = 0
	) {
		if(Configuration::get('AZ_UPLOADNOCOMPRESS') == 'true' && $dst_width == null && $dst_height == null) {
			return copy($src_file, $dst_file);
		} else {
			return parent::resize(
				$src_file, 
				$dst_file, 
				$dst_width, 
				$dst_height, 
				$file_type, 
				$force_type, 
				$error
			);
		}
	}

The above code would work in 1.6.0.x versions. However e.g. in 1.5.x there is no $error argument. In Prestashop 1.6.1.x however there are many other arguments in "resize" method. Open /classes/ImageManager.php, find public static function resize( method and adjust the above code in your override according to the argumets present in this class. Make sure that the arguments in public static function resize( match the argumets in return parent::resize(

Some images in products show correctly, others do not (blank)

Update: this issue was fixed in AJAX-ZOOM Ver. 4.2.18; please update /modules/ajaxzoom/axZm folder!

In short: use only first option "Use JPEG" under PREFERENCES->Images as there are no better alternatives in Prestashop so far. If you encounter this issue on some products, you should set "Use JPEG" and reupload the images.

Prestashop saves all images uploaded by the admin as JPG even if they are PNG. On default (first option) which can be found at PREFERENCES->Images, the png images are converted to JPG which is somewhat acceptable, although not optimal (see issue above). Other than that there are two Prestashop "exclusive" options for handling images (at least we did not see it somewhere else used extensively). The second "Use PNG only if the base image is in PNG format" keeps png format only for images, which are in real PNG images but still saves them as JPG. The third and the last one "Use PNG for all images" converts all images into PNG but again, saves them as JPG in file system.

Most third party scripts which use GD get confused if PNG image is saved as JPG without converting it. It is also said in the Prestashop settings - "WARNING: This feature may not be compatible with your theme, or with some of your modules. In particular, PNG mode is not compatible with the Watermark module. If you encounter any issues, turn it off by selecting "Use JPEG"." So does AJAX-ZOOM at the moment gets confused if GD and not ImageMagick is used. ImageMagick has to be explicitly enabled for AJAX-ZOOM in config file and also installed on the server as it is mostly not included in standard server installations.

Sonstiges

Sollten andere, als die hier beschriebene Störungen auftreten, dann kontaktieren Sie bitte den Support. Wir weden diese umgehend beseitigen und dokumentieren.

Download

Changelog

Comments (1)

Leave a Comment