Kundendokumentation Magento-Erweiterung BCP - Better Configurable Products

Transkript

1 Kundendokumentation Magento-Erweiterung BCP - Better Configurable Products Diese Dokumentation beschreibt die Installation, Konfiguration und Benutzung der Erweiterung BCP - Better Configurable Products für das ecommerce-system Magento. Hinweis: Auch wenn wir Ihnen möglichst detailliert alle Schritte zum erfolgreichen Einsatz beschreiben, sollten Sie bereits ausreichend Erfahrung im administrativen Umgang mit Ihrem Magento-System sowie dem Gebrauch von Erweiterungen besitzen. Evaluieren Sie diese zunächst auf einer Testumgebung, bevor Sie diese auf Ihrem produktiven System installieren. So vermeiden Sie eventuelle Konflikte mit anderen Systemerweiterungen. Voraussetzungen: Magento: Community Edition 1.3, 1.4, 1.5, 1.6, 1.7 Enterprise Edition 1.10, 1.11, 1.12

2 Inhalt Einführung Was ist die Erweiterung BCP - Better Configurable Products? Funktionsumfang Installation Konfiguration Grundeinstellungen Erweiterte Funktionen Erweiterte Einstellungen Caching Tools / Standard Simple Product Deinstallation Updates Aktualisierung für Versionen > Bekannte Probleme Fehlende Optionsauswahl bei Custom Options in Magento CE 1.7 Backend Order mit Konfigurierbaren Produkten Support Impressum

3 Einführung Was ist die Erweiterung BCP - Better Configurable Products? Mit BCP konfigurierbare Produkte in Magento erstellen! Dazu einfach alle Simple Products anlegen und dann als verknüpfte Produkte hinterlegen. Den Rest wie Preiskalkulation, Textbeschreibungen etc. erledigt BCP vollautomatisch. So könnte es in Ihrem Shop aussehen:

4 Funktionsumfang Anzeige der Bilder des ausgewählten Simple Products Anzeige der Attribute des ausgewählten Simple Products Anzeige der Textbeschreibung des ausgewählten Simple Products Anzeige des Endpreises einer Produktvariante in den Dropdowns Preiskalkulation des ausgewählten Simple Products wird verwendet Optionale Anzeige einer Lade-Rotors während des Ajax Updates Weitere Konfigurations-Optionen im AdminPanel um die Erweiterung Ihren Bedürfnissen gerecht anzupassen Unterstützt individueller Optionen für konfigurierbare Produkte und verknüpfte einfache Produkte Keine Anpassung des Templates nötig (wenn das Template valides XHTML generiert)

5 Installation Bitte entpacken Sie das DerModPro_BCP-*.*.*.zip Archiv im Magento Verzeichnis, löschen Sie den Cache und bauen Sie die Flat Product Catalog Tabellen neu auf (in Magento 1.3 unter System > Cache Management, unter Magento 1.4 unter System > Index Management). Dann loggen Sie sich bitte einmal aus dem Admin Interface aus und wieder ein. Dann können Sie mit der Konfiguration fortfahren (siehe unten).

6 Konfiguration Die Konfiguration der Erweiterungen BCP - Better Configurable Products erfolgt über die Administrationsoberfläche Ihrer Magento-Installation. Grundeinstellungen Die Konfiguration kann unter System > Konfiguration > Better Configurable Product > Einstellungen gefunden werden. Option Wählen Sie das Design aus, auf dem Ihr Theme aufgebaut ist Die Media Sektion der Produktansicht aktualisieren Nur das Haupt-Bild aktualisieren Verwendung Die BCP Erweiterung benutzt Xpath und CSS Selektoren, um die zu aktualisierenden Sektionen zu holen. Aus diesem Grund muss das Ihrer Website zugrundeliegende Theme konfiguriert werden. Wenn Sie nicht wissen, welches die richtige Auswahl ist, testen Sie einfach eine Option nach der Anderen, bis Sie eine finden, die möglichst gut funktioniert. Sollte Ihr Theme stark von dem Original abweichen, kann es sein, dass Sie die Selektoren von Hand angeben müssen. Mehr Informationen dazu finden Sie in dem Abschnitt ERWEITERTE EINSTELLUNGEN. Wenn Sie "Nein" wählen, wird der Media Block des konfigurierbaren Produkts beibehalten, unabhängig von der aktuell ausgewählten Option. Wählen Sie "Ja", wird immer der Media Block des ausgewählten Simple Product angezeigt. Setzen Sie diese Option auf "Ja", wenn Sie das Haupt-Bild des ausgewählten Simple Product anzeigen möchten und

7 die Galerie des konfigurierbaren Produktes beibehalten wollen. Die Kurzbeschreibung der Produktansicht aktualisieren Die zusätzlichen Informationen der Produktansicht aktualisieren Simple Product Bilder vorausladen Die lange Beschreibung des konfigurierbaren Produktes beibehalten Produkte die nicht auf Lager sind anzeigen Nicht auf Lager befindliche Produkte im Drop-Down auswählbar Preis Block aktualisieren Rotor-Grafik anzeigen während Ajax- Anfrage Mit "Ja" wird immer die Kurzbeschreibung des gerade ausgewählten Simple Products angezeigt. Die "zusätzlichen Informationen" enthalten die Produkt-Attribute und die lange Beschreibung. Setzen Sie die Option auf "Ja", um die Daten des aktuellen Simple Products anzuzeigen. Wenn aktiviert, werden die Bilder der Simple Products vorausgeladen, sodass der Wechsel, wenn eine Option ausgewählt wird, flüssiger vonstatten geht. Setzen Sie das Dropdown auf "Ja", um die lange Beschreibung des konfigurierbaren Produktes beizubehalten. Sofern aktiviert, werden auch einfache Produkte, die nicht auf Lager sind, im Drop-down der Produktoptionen auf der Produktdetailseite angezeigt. Als Referenz für Out-of-Stock / Nicht auf Lager gilt die Magento-Logik $product- >issaleable() welche je nach Magento- Versionen verschiedene Parameter (z.b. Qty) abfragt. Bei dieser Option kann gewählt werden ob Produkte, welche nicht auf Lager sind, im Drop-Down ausgewählt werden können oder deaktiviert und damit ausgegraut dargestellt werden. Zeigt die Preis-Informationen des ausgewählten Simple Products an, inklusive der Staffelpreise (wenn vorhanden). Sie können eine Rotor-Grafik anzeigen lassen, während eine Ajax Anfrage läuft. Das Aussehen der Grafik kann angepasst werden, indem Sie das Template

8 dermodpro/bcp/catalog/product/view/typ e/configurable.phtml und die Grafikdermodpro/bcp/images/spinner.gi f im Skin Verzeichnis bearbeiten (wie immer, nachdem Sie die Dateien zuerst von dem default Verzeichnis in Ihr Theme kopiert haben). Preiswertesten Artikel als Standard verwenden Präfix für die Preis-Anzeige bei Optionen Suffix für die Preis-Anzeige bei Optionen Suffix für Drop-Down-Optionen nicht im Lager befindlicher Produkte Preise für Optionen auch anzeigen, wenn es der selbe ist wie der aktuell angezeigte Produkt-Preis Option Preis-Anzeige wenn noch nicht genügend Attribute gewählt wurden, um den Produkt Preis zu bestimmen Wenn Sie die Option auf "Ja" setzen, wird das günstigste Simple Product automatisch als Standard angezeigt, sowohl in der Listenansicht als auch in der Produktdetailseite. Das Präfix für die Preisanzeige bei den Optionen im Dropdown. Das Suffix für die Preisanzeige bei den Optionen im Dropdown. Diese Einstellung legt den Suffix von Produktoptionen nicht im Lager befindlicher Produkte fest. Wählen Sie "Ja", wenn Sie den Preis für die Optionen auch dann im Select- Dropdown anzeigen möchten, wenn er dem des aktuell ausgewählten Simple Product entspricht. Die Beschreibung, welche in dem Select hinter Optionen angezeigt werden soll, wenn durch die aktuelle Auswahl noch kein eindeutiger Preis bestimmt werden kann). Wenn Sie das Bild des ausgewählten Simple Products im Warenkorb anzeigen lassen wollen (statt dem Bild des konfigrierbaren Produkts), können Sie die Einstellung dafür unter System > Konfiguration > Checkout > Shopping Cart finden. Diese Einstellung ist Teil von Magento, nicht der BCP Erweiterung.

9 Erweiterte Funktionen Anzeige des billigsten Preises im List/Grid-View Bei dem Setzen des billigsten Produktes als Default in der List-/Grid-View haben Sie die Möglichkeit den Preis als "Price From/Preis ab:" mit dem Preis des billigsten Produktes anzuzeigen. Um dies zu erreichen ist folgendes Vorgehen nötig. Sie müssen in app/design/frontend/base/default/template/dermodpro/bcp/catalog/product/list.phtml nach den Zeilen mit Zeilen-Nummer: 58 und 102 folgendes Snippet Einfügen: <?php if ($bcppricefrom = Mage::helper('bcp')->getBcpPricePrefix($_product)):?> <span class="bcp_price_from_prefix"><?php echo $bcppricefrom;? ></span> <?php endif;?> Des weiteren erscheint der Text ungestylt, sie können den Style des Textes über die CSS-Klasse bcp_price_from_prefix" nach Ihren Bedürfnissen gestalten. Erweiterte Einstellungen Wenn Ihr Theme stark individualisiert ist, kann es sein, dass die Standard BCP Theme Selektoren nicht mehr funktionieren. In dem Fall können Sie die DOM und CSS Selektoren für die zu aktualisierenden Teile der Seite von Hand angeben. Dazu ist es hilfreich, wenn Sie sich etwas mit xpath und CSS auskennen. Schauen Sie sich am besten die Beispiele am unteren Ende der Datei app/code/community/dermodpro/ BCP/etc/config.xml im <default> Konfigurations-Knoten an. Sie können mehrere Selektoren in ein Feld mit &&& getrennt zusammenfassen. Es ist möglich auch ein Javascript Callback zum re-initialisieren des Media Zooms angeben. Einträge unter "Erweiterte Einstellungen" überlagern die entsprechenden Einträge aus der Standard Theme Auswahl. Die meisten Einstellungen können auf Produkt-Ebene überschrieben werden. Die entsprechenden Optionen finden Sie im Reiter "Gestaltung" des konfigurierbaren Produktes. Sie können dort auch ein zugeordnetes Simple Product als Standard für die Anzeige auswählen, dieses wird dann gleich beim Laden der Produktansicht angezeigt.

10 Caching In den Erweiterten Einstellungen können Sie die "Serverseitiger Ajax-Response Cache Lebenszeit" (in Sekunden) angeben. Wenn ein Wert größer 0 angegeben wird, ist das client-seitige Response Caching (durch Javascript) aktiv. Wenn ein Wert größer 0 angegeben wird und zusätzlich HTML Block Caching in der Magento Cache Konfiguration angeschaltet ist, wird auch Serverseitig gecached. Tools / Standard Simple Product Preiswertesten Artikel als Standart festlegen: Hier haben Sie die Möglichkeit den preiswertesten Artikel für alle konfigurierbaren Produkte als Standard-Artikel zu setzen. Dabei wird der Wert Default Simple Product auf das günstigste einfache Produkt gesetzt. Seit Release-Version wird statt der Product- ID die Product-SKU gespeichert. Preiswertesten Artikel als Standart zurücksetzen: Hier haben Sie die Möglichkeit die Änderungen, die durch preiswertesten Artikel als Standart festlegen durchgeführt wurden sind, rückgängig zu machen und die gespeicherten Werte von Default Simple Product zu entfernen. Preiswerteste Artikel migrieren: Seit Version wird für das Attribut Default Simple Product anstatt der Product-ID, die Produkt SKU verwendet. Somit wird sichergestellt, dass bei einem Produktimport das Attribut befüllt werden kann. Sie haben hier die Möglichkeit Ihre bestehenden Produktwerte von Product-ID zu Product-SKU zu migrieren. Sofern BCP in Version > in einem Shop neu installiert wird, ist keine Migration erforderlich.

11 Deinstallation Sollten Sie die Erweiterung nicht mehr benötigen, können Sie diese aus Ihrer Magento-Installation entfernen. Um das Modul zu deinstallieren, löschen Sie alle BCP-Dateien: - app/code/community/dermodpro/bcp - app/etc/modules/dermodpro_bcp.xml - app/design/adminhtml/default/default/template/bcp - app/design/frontend/base/default/layout/bcp.xml - app/design/frontend/default/default/layout/bcp.xml - app/design/frontend/base/default/template/dermodpro/bcp - app/design/frontend/default/default/template/dermodpro/bcp - skin/frontend/base/default/dermodpro/bcp - skin/frontend/default/default/dermodpro/bcp - js/dermodpro/bcp - app/locale/de_de/dermodpro_bcp.csv und führen Sie folgende SQL-Befehle aus: DELETE FROM `eav_attribute` WHERE `attribute_code`='bcp_update_images' LIMIT 1; DELETE FROM `eav_attribute` WHERE `attribute_code`='bcp_update_short_desc' LIMIT 1; DELETE FROM `eav_attribute` WHERE `attribute_code`='bcp_update_collateral' LIMIT 1; DELETE FROM `eav_attribute` WHERE `attribute_code`='bcp_default_product' LIMIT 1; DELETE FROM `eav_attribute` WHERE `attribute_code`='bcp_default_product_sku' LIMIT 1; DELETE FROM `eav_attribute` WHERE `attribute_code`='bcp_default_override' LIMIT 1; DELETE From core_config_data where CONVERT( `path` USING utf8 ) LIKE '%bcp %'; DELETE FROM core_resource where code='bcp_setup'; Anschließend sollten alle Caches geleert und alle Indizes neu erstellt werden.

12 Updates Aktualisierung für Versionen > Attributname vor v Attributname nach v Attributcode Werte Default Simple Product Default Simple Product (deprecated) bcp_default_product Product IDs - Default Simple Product bcp_default_product_sku SKUs Nach der Version gab es ein Update in Bezug auf das Attribut Default Simple Product. Dieses wurde von Product-ID-basierten Werten zu SKU-basierten Werten umgestellt, um das Attribut bei einem Produktimport befüllen zu können. Sofern BCP in Version > in einem Shop neu installiert wird, ist keine Migration erforderlich. Andernfalls können die Product-ID-basierten Werte unter: System -> Werkzeuge -> Better Configurable Products -> Default Simple Product -> Migrate cheaptest Products zu SKU-basierten Werten migriert werden.

13 Bekannte Probleme Fehlende Optionsauswahl bei Custom Options in Magento CE 1.7 In Magento CE 1.7 wird die Optionsauswahl für konfigurierbare Produkte auf der Produktdetailseite nicht angezeigt, wenn alle dem konfigurierbaren Produkt zugewiesenen einfachen Produkte Custom-Options besitzen, die Pflichtfelder sind. Setzt man die bzw. eine Custom-Option(s) auf optional sollten keine Probleme auftreten. Backend Order mit Konfigurierbaren Produkten Wenn an den einfachen Produkten eines konfigurierbaren Produktes Custom Options sind, muss bei einer Backend-Order das entsprechende einfache Produkt ausgewählt werden, ansonsten kann man die Custom Option nicht auswählen.

14 Support Bei der Installation, Konfiguration und dem Einsatz dieser Erweiterung für Ihr Magento-System helfen Ihnen unsere hochqualifizierten Mitarbeiter des Kundensupports gerne weiter. Bevor Sie eine Anfrage an uns richten, vergewissern Sie sich bitte, dass Ihr Anliegen nicht bereits durch die vorliegende Dokumentation oder unsere Wissensdatenbank auf beantwortet wird. So tragen Sie dazu bei, dass wir unseren Kunden auch weiterhin hochwertige Supportdienstleistungen erbringen können und jedem Anliegen mit der nötigen Zeit und Aufmerksamkeit begegnen können. Zur Kontaktaufnahme nutzen Sie bitte unser Kontaktformular auf de.nr-apps.com. Bitte geben Sie dabei Ihre Bestellnummer an. Wir werden uns schnellstmöglich um Ihr Anliegen kümmern.

15 Impressum Netresearch App Factory AG Nonnenstraße 11c Leipzig Registergericht: AG Leipzig HRB Vorstand: Vorsitzender des Aufsichtsrats: Telefon: Telefax: Michael Ablass Thomas Fleck Thomas Goletz Martin Saurer (0341) (0341)