Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Titel: Versand

Exponential hat keine Versandfunktionen, obwohl viele Webshops sie brauchen.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/features/3.8/improved_shipping.txt

This page is a translation. Read the English original

*Titel: Versand

*Anlass:

Exponential hat keine Versandfunktionen, obwohl viele Webshops sie brauchen.

*Grundlagen:

Eigene Versandoptionen müssen sich definieren lassen; die Versandkosten können von Eigenschaften
eines bestimmten Produkts abhängen. Dafür gibt es eine Schnittstelle für sogenannte
"Versand-Handler", die die Versandoptionen einer Produktsammlung (Warenkorb oder Bestellung)
verwalten und deren Versandkosten berechnen. Exponential bringt selbst keinen Versand-Handler mit.

*Einzelheiten der Umsetzung:

Fragt Exponential den Handler nach den Versandinformationen, erhält es:

- (Text)   Zusammenfassung der Versandoptionen.
- (Zahl)   Versandkosten.
- (Text)   Link zur Seite, auf der der Benutzer die Versandoptionen ändern kann.

Ein Versand-Handler ist eine Datei mit einer Klasse, die diese Methoden implementiert:

    /**
     * Invoked to get shipping information for given product collection.
     * \public
     * \static
     */
    function getShippingInfo( $productCollectionID );

    /**
     * Invoked when shopping basket contents are changed
     * to update shipping info/cost appropriately.
     * \public
     * \static
     */
    function updateShippingInfo( $productCollectionID );

    /*
     * Invoked when the associated product collection is removed
     * to clean up shipping information.
     * \public
     * \static
     */
    function purgeShippingInfo( $productCollectionID );

Ein Handler wird über die Klasse eZShippingManager aufgerufen, die dieselben Methoden hat.

Die von getShippingInfo() zurückgegebenen Versandinformationen sind ein Array mit diesen
Pflichtschlüsseln: 'cost', 'description', 'management_link' (siehe Beispiele unten).

Diese Informationen werden [teilweise] an diesen Stellen angezeigt:

.-----------------+-------------------------------------------------.
| Seite           | Was angezeigt wird                              |
+=================+=================================================+
| Warenkorb       | Versandbeschreibung (Zusammenfassung der        |
|                 | Optionen), Versandkosten, Link zur Seite, auf   |
|                 | der der Benutzer die Optionen ändern kann.      |
+-------------------------------------------------------------------+
| Bestellung      | Zusammenfassung: Versandbeschreibung, Kosten;   |
| bestätigen      | die Gesamtsumme enthält die Versandkosten.      |
+-----------------+-------------------------------------------------+
| Bestellansicht  | <wie oben>                                      |
`-----------------+-------------------------------------------------'

*Neue Einstellungen:

###############################################################################
[ShippingSettings]
# Specifies shipping handler class/file name. For example, if the value is
# "ezcustom", then the handler class should be named
# eZCustomShippingHandler (case does not matter) and placed to file
# ezcustomshippinghandler.php residing in a directory specified by
# "RepositoryDirectories" and "ExtensionDirectories" settings.
Handler=ezcustom

# Directories where shippping handlers should be searched for.
RepositoryDirectories[]=kernel/classes/shippinghandlers

# If you are going to implement your shipping handler in an extension
# then you should add the extension name to the list below.
# In that case shipping handlers will be searched for
# in the following (hardcoded) directory:
# extension/<your_extension>/shippinghandlers
# beside directories specified in 'RepositoryDirectories' setting.
ExtensionDirectories[]
###############################################################################


*Beispiele:

Wir implementieren einen ganz einfachen Versand-Handler, um zu sehen, wie das Ganze funktioniert.

1. In das Verzeichnis von Exponential wechseln.
2. Das Verzeichnis "extension/ezvoidshipping" anlegen und hineinwechseln.
3. Die Verzeichnisse "settings" und "shippinghandlers" anlegen.
4. Im Verzeichnis "shippinghandlers" die Datei "ezvoidshippinghandler.php"
   mit diesem Inhalt anlegen:

==============================================================
<?php
class eZVoidShippingHandler
{
    function getShippingInfo( $productCollectionID )
    {
        return array(
                'description'     => 'Manual',
                'cost'            => 10,
                'management_link' => '/shop/basket/' // dummy
                );
    }

    function purgeShippingInfo( $productCollectionID )
    {
        // nothing to purge
    }

    function updateShippingInfo( $productCollectionID )
    {
        // nothing to update
    }
}
?>
==============================================================

5. Im Verzeichnis "settings" die Datei "shop.ini.append" mit diesem Inhalt anlegen:

========================================================
[ShippingSettings]
Handler=ezvoid
ExtensionDirectories[]=ezvoidshipping
========================================================

6. In der Administrationsoberfläche "Setup -> Erweiterungen" öffnen und die Erweiterung
   "ezvoidshipping" einschalten.

Jetzt sehen Sie feste Versandkosten bei den Produkten, die auf Ihrer Website gekauft werden.


Ein ausführlicheres Beispiel lag früher in den Community-Beiträgen des damaligen Herstellers;
diese Seite gibt es nicht mehr.

Something wrong on this page? Report an error

Documentation license

This page was inherited from the documentation of the original software. It is not covered by the GNU Free Documentation License; it is distributed under the GNU General Public License, version 2.

Copyright (C) 1999 - 2014 eZ Systems AS and contributors