Handbuch
Aus OL-Commerce
Inhaltsverzeichnis |
Handbuch
Geschichte OL – COMMERCE
Im Jahre 2004 erklärten die Betreiber der Shopsoftware XT-COMMERCE, daß Sie eine kostenpflichtige Version des Online – Shops, herausbringen wollen. Da der Support im Forum dadurch eingestellt wird, traten einige Forenuser an mich heran, die alte Version 2.0 in einem neuen Fork weiter zu führen. Auf die schnelle wurde dann ein neues Projekt erstellt, wobei ich einen Fehler begangen habe, der leider sehr kostspielig für mich wurde. Es wurde ein Prozess nach dem anderen gegen mich geführt, um zu Geld zu kommen, denn anders konnte die Hartnäckigkeit, mit der die ganze Sache verfolgt wurde nicht erklärt werden. Da ja XT-COMMERCE in Ihrer Gründungsphase den gleichen Fehler gemacht hat und dabei nur symbolisch verklagt wurde, konnte ich das ganze nicht nachvollziehen, ausser, daß hier mit allen Mitteln versucht werden sollte von mir Geld zu bekommen. Durch diese ganzen Aktionen, habe ich mich aber nicht beirren lassen und mit einer Hand voll User versucht das ganze trotzdem in einem Korrekten, der GNU/GPL entsprechenden Regeln weiter zu führen. Die User im Forum und ich wurden dadurch zwar immer wieder angegriffen, was wir aber einfach ignorierten, denn wir wollten nur ein kostenloses Shopsystem weiterentwickeln und kostenlosen Support bieten. Der Support wird wie auch auf den Bezahlseiten, in den meisten Fällen von den Forenusern geliefert, so wie es auch bei freier Software üblich ist. Trotz des hohen Kostenanteils von mir, durch die Rechtsstreitigkeiten, wird für die Nutzung und für Support kein Geld genommen. Leider ist das Spendenaufkommen auch nicht so groß, so daß eine Neuprogrammierung und Verbesserung, nur durch einige wenige, mit viel Zeitaufwand erstellt werden kann. Dadurch dauert es halt auch wenig länger, bis neue Versionen rauskommen Als im Jahr 2006, nach langem Rechtsstreit, endlich alles bereinigt ist, können wir uns endlich auf das wesentliche konzentrieren. Durch die Mithilfe einiger konnte es sogar erreicht werden, daß wir einige Module und Templates gesponsert bekamen, die normalerweise kostenpflichtig sind, da wir diese nicht direkt für XT-COMMERCE zum Download bereitstellten, sondern für OL-COMMERCE umarbeiteten.
Im Jahr 2007 wollte ein Forenuser das ganze System umstellen auf Ajax, was aber nicht so ganz funktionierte. Der User hatte sehr viel Zeit und Arbeit in das ganze investiert, was aber wenig geschätzt wurde. Der User wurde ständig angegriffen, so daß er schliesslich das Interesse verlor und das ganze Projekt fallen lies. Aber das ist nun mal so der Lauf, wenn man nur auf Mithilfe aus dem Forum und auf Freiwillige angewiesen ist. Ein Open Source Projekt ist halt nur so gut wie seine Nutzer und die die Mithelfen, aus dem Projekt ein gutes Projekt zu machen.
Es wird auch nach wie vor ein kostenloses Shopsystem bleiben, jedenfalls so lange ich die Leitung darüber habe, auch wenn mich das ganze nur Geld kostet und nichts einbringt.
Mitlerweile ist ein neues Forum erstellt worden, in dem mehr Möglichkeiten existieren, aktiv mit zu arbeiten. Auch eine Liste, in dem die laufenden Shops eingetragen werden können existiert jetzt, so daß jeder der einen Shop mit OL-COMMERCE laufen hat, sich eintragen kann und dadurch noch ein wenig mehr Aufmerksamkeit bekommt.
Es sollte auch nicht vergessen werden zu erwähnen woraus XT-COMMERCE und damit auch OL-COMMERCE entstanden sind. Der Ursprung des ganzen liegt in osCommerce, welches ja immer noch kostenlos ist und das ist mein großes Vorbild.
Ich wünsche allen Nutzern der Shopsoftware viel Erfolg.
Voraussetzungen
OL-Commerce v2.1.1 Release Datum:23.01.2008 ------------------------------------------------------------------------ Dieses Programm ist freie Software. Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 2 der Lizenz oder (nach Ihrer Option) jeder späteren Version. Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, daß es Ihnen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License. Sie sollten eine Kopie der GNU General Public License zusammen mit diesem Programm erhalten haben. Falls nicht, schreiben Sie an die Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
Infos: ------------------------------------------------------------------------ OL-Commerce ist eine Weiterentwicklung der bekannten Shop-software osCommerce. Der OL-Commerce Shop legt ein besonderes Augenmerk auf Sicherheitsrelevante Aspekte, und ist durch einen neuen professionellen Aufbau gekennzeichnet. OL-Commerce ist auf jedem System lauffähig, welches eine PHP Umgebung (ab PHP 4.1.3) und mySQL zur Verfügung stellt, wie zum Beispiel Linux, Solaris, BSD, und Microsoft Windows. Weiters sollte am Server installiert sein:
GDlib2+ PDFlib
Installation
Kurzanleitung
Installation von OL - COMMERCE
Alle Dateien aus dem Ordner olcommerce per FTP - Programm, auf den Server kopieren. Sollte eine Installation vorhanden sein, die nicht gelöscht werden soll, dann vorher Datenbank und configuration sichern. Anschliessend die Rechte wie nachfolgend aufgeführt vergeben:
Backup der Konfiguration Anmerkung: Rechte 777 bedeutet Lesen/Schreiben/Ausführen für Besitzer/Gruppe/Andere.
Rechtevergabe für Installation /cache 777
Rechtevergabe für Installation /export 777
Cache Dateien von Smarty /templates_c 777
Smarty Verzeichnis /images 777
Produkt-Info-Bilder /images/categories 777
Produkt-Info-Bilder /images/maufactures 777
Bilderverzeichnis /images/content 777
Bilderverzeichnis /images/Banner 777
Bilder aus Spaw Editor /images/product_images/info_images 777
Info-Bilder /images/product_images/original_images 777
Original-Bilder /images/product_images/popup_images 777
Popup-Bilder /images/product_images/product_info_images 777
Produkt-Info-Bilder /images/product_images/thumbnail_images 777
Thumbnail-Bilder /media/content 777
Dateien aus Content-Manager /media/products 777
Dateien aus Produkt-Manager /admin/backups 777
Datenbank Backups /admin/images/icons 777
Kundengruppen Icons /admin/rss 777 hier auch alle unterdateien
PDF - Export /lang/german 777 inklusive unterordner /lang/english 777 inklusive unterordner
Banner admin/graphs 777
RSS admin/rss 777 (Dateien im Verzeichnis auch mit 777 versehen)
Dateien aus Admin Info /includes/configure.php 777 (nur zur Installation) anschließend wieder auf 444
Konfigurationsdatei Shop /includes/configure.org.php 777 (nur zur Installation) anschließend wieder auf 444
Backup der Konfiguration /admin/includes/configure.php 777 (nur zur Installation) anschließend wieder auf 444
Konfigurationsdatei Admin /admin/includes/configure.org.php 777 (nur zur Installation) anschließend wieder auf 444
Nachdem die Rechte vergeben wurden, können Sie die Installation starten. http://www.DeineDomain/olc_installer
Nach der Installation das Verzeichnis olc_installer löschen, oder umbenennen und die config - Dateien mit Rechten 444 (nur lese - Zugriff) versehen. Anschliessend mit dem Admin - Zugang einloggen. Um Fehlermeldungen bei einigen Providern aus dem Weg zu gehen, sollte im Verzeichnis für den Cache und für tmp der richtige Pfad eingetragen werden. Bei den meisten Providern ist es nicht zulässig, den Pfad tmp auf dem Server zu nutzen. Aus diesem Grund die Fehlermeldung mit der Pfadangabe nehmen und den Teil, der vor der Fehlermeldung steht, vor den Pfad /tmp und /cache, kopieren. Damit schreibt man alle Daten in sein eigenes Verzeichnis. Dieses kann vor dem überlaufen aus dem Admin - Bereich geleert werden (Cache löschen).
Das dürfte alles gewesen sein und nun gute Geschäfte.
Für eventuelle Schäden wird keine Haftung übernommen.
Module installieren
Zahlungsmodule
Sofortüberweisung
* * * @version Sofortüberweisung 1.9 05.06.2007 * @author Henri Schmidhuber info@in-solution.de * @copyright 2006 - 2007 Henri Schmidhuber * @link http://www.in-solution.de * @link http://www.xt-commerce.com * @link http://www.sofort-ueberweisung.de * @license http://opensource.org/licenses/gpl-license.php GNU Public License * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; version 2 of the License * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * USA * *********************************************************************************** * this file contains code based on: * (c) 2000 - 2001 The Exchange Project * (c) 2001 - 2003 osCommerce, Open Source E-Commerce Solutions * (c) 2003 nextcommerce (account_history_info.php,v 1.17 2003/08/17); www.nextcommerce.org * (c) 2003 - 2006 XT-Commerce * Released under the GNU General Public License *********************************************************************************** *
Überblick:
Die Contribution stellt Module zum Einbinden des Zahlungssystem Sofortüberweisung ( http://www.sofort-ueberweisung.de ) zur Verfügung.
- Modul "Bezahlen mit Sofortüberweisung"
Während des Zahlungsprozesses wird der Kunde über anpassbare Texte und Bilder über das Zahlungssystem informiert und nach Abschluss des Bestellvorgangs zur Sofortüberweisung Webseite geleitet. Die Bestellung wird immer in die Datenbank geschrieben, auch wenn der Kunde den Bezahlvorgang abbricht
- Modul "Vorkasse / Überweisung"
Das Modul "Vorkasse / Überweisung" entspricht dem aus dem Shop bekannten "moneyorder" Modul. Nach Abschluss der Bestellung bekommt der Kunde in der Checkout Success Seite jedoch zusätzlich Information und einen Link zum Bezahlen via Sofortüberweisung angezeigt. Die Bestellung wird immer in die Datenbank geschrieben, auch wenn der Kunde den Bezahlvorgang abbricht
- Modul "Direktes Bezahlen mit Sofortüberweisung"
Während des Zahlungsprozesses wird der Kunde über anpassbare Texte und Bilder
über das Zahlungssystem informiert und vor Abschluss des Bestellvorgangs zur
Sofortüberweisungseite geleitet. Mit Abschluss der Bezahlung wird die Bestellung
in die Shopdatenbank geschrieben. Bricht der Kunde ab kommt er zurück zur
Zahlungsausswahlseite des Shops.
Hinweis zu diesem Modul:
- Bei gleichzeitiger Verwendung mit einem der anderen Sofortüberweisungsmodule
muß ein eigenes Projekt bei Sofortüberweisung angelegt werden.
- Schliest der Kunde bei Sofortüberweisung den Browser,
bzw. scheitert der Rücksprung wird keine Bestellung im Shop aufgenommen.
Update:
- individuelle Anpassungen in den alten ModulFiles in die neuen Files übertragen. - Modul im Admin deinstallieren (Werte bitte davor notieren) - Files hochspielen - Modul im Admin installieren und neu konfigurieren
Installation:
Alle Dateien in die dazu gehörigen Ordner des Shops kopieren.
Konfiguration im Shop
Im Admin sollten nun unter Module -> Zahlungsoptionen drei neue Module erscheinen:
- Bezahlen mit Sofortüberweisung - Vorkasse / Überweisung - Direktes Bezahlen mit Sofortüberweisung
Die gewünschten Module einfach aktivieren. Bei Verwendung des Autoinstallers werden die benötigten Daten Sofortüberweisung automatisch übergeben und nach Rücksprung ins Modul eingetragen.
Beschreibung relevanten Parameter:
- Bestellstatus festlegen
Der Order Status den die Bestellung nach Eingang der Erfolgsbenachrichtigung via Tracking-Script erhält. (empfohlen: in bearbeitung, bzw neuer Status: Zahlungseingang via Sofortüberweisung) bei "Direktes Bezahlen mit Sofortüberweisung" Status der Bestellung nach Bestelleingang
- Kundennummer:
Ihre Kundennummer bei der Sofortüberweisung
- Projektnummer:
Die verantwortliche Projektnummer bei der Sofortüberweisung, zu der die Zahlung gehört
- Inputpasswort
Das Inputpaswort welches im Sofortüberweisungsadmin eingestellt ist (siehe Konfiguration (Nicht änderbare Parameter / Input-Passwort) bei Sofortüberweisung)
- Benachrichtigungspasswort nur "Bezahlen mit Sofortüberweisung" und "Vorkasse / Überweisung"
Das Benachrichtigungspasswort welches im Sofortüberweisungsadmin eingestellt ist (siehe Konfiguration (Benachrichtigungen) bei Sofortüberweisung) - Contentpasswort "Direktes Bezahlen mit Sofortüberweisung") Das Contentpasswort welches im Sofortüberweisungsadmin eingestellt ist (siehe Konfiguration (Content-Passwort) bei Sofortüberweisung)
- Sofortige Weiterleitung
Nach Abschluss der Bestellung wird der Kunde sofort zu Sofortüberweisung weitergeleitet, ansonsten wird die checkout_success Seite angezeigt und der Kunde muß durch Klick die Weiterleitung auslösen.
- Transactiondetails speichern
Transactionsdetails bei Benachrichtigung in das Kommentarfeld speichern (zum debuggen). Ist dann in der Bestellhistory für den Kunden einsehbar.
Konfiguration bei Sofortüberweisung:
(Bei dem ausgewählten Project unten unter Administration)
Folgende Links (Links zu Ihren Shop anpassen) sollten bei Sofortüberweisung beim Projekt hinterlegt werden (falls kein SSL existiert http verwenden):
-> sollte ihre Session nicht OLCsid heißen bitte entsprechend anpassen
Bereich: Benachrichtigungen festlegen (nicht "Direktes Bezahlen mit Sofortüberweisung")
- Passwort für Benachrichtigungen
Frei festlegbar, solte aus Sicherheitsgründen mindestens 8 Zeichen umfassen. Hier bitte nur Buchstaben und Zahlen ohne Sonderzeichen / Umlaute verwenden Dieses Passort muß in der Modulkonfiguration verwendet werden.
- HTTP(S) Script Aufruf aktivieren Url zum Script: https://URL_ZUM_SHOP/sofortueberweisung_tracking.php Methode: POST Variablenname für Passwort: pw
Zusätzlich können auch andere Benachrichtigungen (email, SMS) aktiviert werden.
Bereich Backlink / Abortlink / Weiter-Button / Weiterleitung:
- Weiter-Button und Header-Weiterleitung Automatische Header-Weiterleitung aktivieren -> Hacken setzen.
- bei "Bezahlen mit Sofortüberweisung" und "Vorkasse / Überweisung": https://URL_ZUM_SHOP/checkout_success.php?OLCsid=-KUNDEN_VAR_2-
- bei "Direktes Bezahlen mit Sofortüberweisung": https://URL_ZUM_SHOP/checkout_process.php?OLCsid=-KUNDEN_VAR_2-&sovar3=-KUNDEN_VAR_3-&sovar4=-KUNDEN_VAR_3_MD5_PASS-&betrag=-BETRAG-
- Abortlink - bei "Bezahlen mit Sofortüberweisung" und "Vorkasse / Überweisung": https://URL_ZUM_SHOP/sofortueberweisung_abort.php?OLCsid=-KUNDEN_VAR_2-
- bei "Direktes Bezahlen mit Sofortüberweisung": https://URL_ZUM_SHOP/checkout_payment.php?payment_error=sofortueberweisungredirect&OLCsid=-KUNDEN_VAR_2-
Bereich Nicht änderbare Parameter / Input-Passwort
- Nicht änderbare Parameter Betrag, Verwendungszweck 1 (1. Zeile), Verwendungszweck 2 (2. Zeile), Kunden-Variable 0 - 5 sollten gesetzt werden, da sonst die Kunden z.B. den vom Shop übermittelten Betrag verändern können.
- Input-Passwort Aktivieren. Frei festlegbar, solte aus Sicherheitsgründen mindestens 8 Zeichen umfassen. Hier bitte nur Buchstaben Zahlen ohne Sonderzeichen / Umlaute verwenden Dieses Passort muß in der Modulkonfiguration verwendet werden.
Anpassung im Shop:
Es müßen unbedingt die Texte mit den Kontoverbindungsdaten abgepasst werden!
-Sprachfiles der Module
in catalog\includes\lang\german\modules\payment\ liegen die sofortueberweisung...php Sprachdateien. Hier können Texte für Email, Verwendungszweck... angepasst werden
- Templates in catalog\templates\...\module\
sofortueberweisung_checkout_success.html: Dies ist eine veränderte checkout_sucess welche dem Kunden nach Abschluss der Bestellung entweder zu Sofortüberweisung weiterleitet oder eine Erfolgsseite mit Link zu Sofortüberweisung anzeigt sofortueberweisung_abort.phtml: Die Seite sofortueberweisung_abort.php entspricht einer Standard Informations Seite und muß mit ihren Daten angepasst werden, um Kunden die die Zahlung abbrechen alternative Zahlungsmöglichkeiten zu geben. Sprachfile: catalog\includes\lang\german\sofortueberweisung_abort.php
- Optional: Einbau einer Box zum Bewerben der Zahlungsmöglichkeit Sofortueberweisung.
in den Sprachfiles z.B.: in \lang\german\lang_german.conf im Bereich [boxes] (ca Zeile 456) folgende Zeile einfügen:
heading_sofortueberweisung = 'Sofortüberweisung'
(sinnvollerweise nach Zeile 473 unter heading_search)
in templates\IHR_TEMPLATE\source\boxes.php
vor $smarty->assign('tpl_path','templates/'.CURRENT_TEMPLATE.'/');
folgende Zeile einfügen:
include(DIR_WS_BOXES . 'sofortueberweisung.php');
in templates\IHR_TEMPLATE\index.html an gewünschter Stelle:
{$box_SOFORTUEBERWEISUNG}
einfügen (z.B. nach {$box_MANUFACTURERS} )
Probleme mit vorhandenen OL-Commerce Bugs:
- keine Bankverbindungsdaten / individuelle Zahlungstexte in der Bestell-Email :
Ursache: Da der Parameter "email_footer" der Zahlungsmodule derzeit kein Wirkung mehr hat,
muß wenn man die Email manuell erweitern.
Lösung:
-> File send_order.php
ca Zeile 111:
// MONEYORDER
if ($order->info['payment_method']=='moneyorder') {
$smarty->assign('PAYMENT_INFO_HTML',MODULE_PAYMENT_MONEYORDER_TEXT_DESCRIPTION);
$smarty->assign('PAYMENT_INFO_TXT',str_replace("
","\n",MODULE_PAYMENT_MONEYORDER_TEXT_DESCRIPTION));
}
danach analog für die verwendeten Module erweitern
z.B.:
// SOFORTUEBERWEISUNGVORKASSE
if ($order->info['payment_method']=='sofortueberweisungvorkasse') {
$smarty->assign('PAYMENT_INFO_HTML',MODULE_PAYMENT_SOFORTUEBERWEISUNGVORKASSE_TEXT_EMAIL_FOOTER);
$smarty->assign('PAYMENT_INFO_TXT',str_replace("
","\n",MODULE_PAYMENT_SOFORTUEBERWEISUNGVORKASSE_TEXT_EMAIL_FOOTER));
}
// SOFORTUEBERWEISUNG
if ($order->info['payment_method']=='sofortueberweisung') {
$smarty->assign('PAYMENT_INFO_HTML',MODULE_PAYMENT_SOFORTUEBERWEISUNG_TEXT_EMAIL_FOOTER);
$smarty->assign('PAYMENT_INFO_TXT',str_replace("
","\n",MODULE_PAYMENT_SOFORTUEBERWEISUNG_TEXT_EMAIL_FOOTER));
}
// SOFORTUEBERWEISUNGREDIRECT
if ($order->info['payment_method']=='sofortueberweisungredirect') {
$smarty->assign('PAYMENT_INFO_HTML',MODULE_PAYMENT_SOFORTUEBERWEISUNGREDIRECT_TEXT_EMAIL_FOOTER);
$smarty->assign('PAYMENT_INFO_TXT',str_replace("
","\n",MODULE_PAYMENT_SOFORTUEBERWEISUNGREDIRECT_TEXT_EMAIL_FOOTER));
}
- Übergebener Betrag stimmt nicht
Ursache: im checkout process hat im Funktionsaufruf $payment_modules->after_process()
die Variable $order->info['total'] plötzlich einen anderen Typ / Wert.
Lösung: aktuelles Modul installieren, da die hier ein Workaround über die Session implemeniert ist
Sprachen:
die englischen Sprachfiles enthalten die deutschen Texte. Bei Bedarf bitte anpassen und bitte uns zukommen lassen ;)
- CREDITS
IN-Solution Henri Schmidhuber info@in-solution.de http://www.in-solution.de
Versandmodule
UPS mit XML Script
UPS XML RSS v1.00 deutsch für OL - Commerce
Original Copyright (c) 2003 Torin Walker, torinwalker@rogers.com Insurance Support 2005 Joe McFrederick, jomcfred@oldeparsonage.com
Modifikation 2005 René Nicolai 2005, mail@rennic.de Demoshop und Downloads: http://ups.web-pro.biz
Modifikation 2005 Manfred Tomanik, mtomanik@ol-commerce.de
Dieses Programm ist freie Software, Sie können es unter Beachtung der GNU General Public License (Version 2 oder später)
weitergeben und/oder modifizieren. Dieses Programm wurde veröffentlicht in der Hoffnung, dass es nützlich für Sie ist, aber
ohne jegliche Garantie für eventuell mögliche Schäden an Ihrer Soft- oder Hardware. Bitte lesen Sie sich die GNU General
Public License für weitere Details durch!
Sollte Ihnen keine Kopie der GNU General Public License vorliegen, so können Sie eine Kopie unter folgender Adresse anfordern:
The Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Beschreibung
Dieses Modul erweitert den OL - Commerce Shop um den Gateway für das XML-Tool "Rates & Service Selection" von UPS. Anhand der Zustelladresse bekommt der Käufer mögliche UPS-Services angeboten sowie den aktuellen Transporttarif angezeigt. Der Shop- Administrator kann im Admin-Bereich die Servicearten auswählen, die angeboten werden sollen sowie einen prozentualen Zuschlag auf diese veröffentlichten UPS-Tarife erheben.
Einstellungen können im Administratormenü unter
Admin->Modules->Shipping->United Parcel Service (XML)
vorgenommen werden.
Im Administrator-Interface können Versender-spezifische Variablen, z.B. Paketart und Abholmodus, hinterlegt werden. Außerdem müssen die Zugangsdaten für das UPS Tool (Username, Password, Accesskey) hinterlegt werden. Diese Angaben erhält der Shopbetreiber direkt auf der UPS-Homepage unter http://www.ups.com!
INSTALLATION
SCHRITT 1
Sichern Sie Ihre Datenbank sowohl alle Dateien auf Ihrem Webserver, um notfalls der ursprünglichen Zustand wiederherstellen zu können.
SCHRITT 2
Extrahieren Sie die Dateien aus dem ZIP-Archiv und laden Sie diese auf Ihren Webserver. Vorhandene Dateien müssen dabei über- schrieben werden. Die Dateien sind:
olcommerce/admin/includes/classes/xmldocument.php olcommerce/includes/classes/xmldocument.php olcommerce/includes/languages/english/modules/shipping/upsxml.php olcommerce/includes/languages/german/modules/shipping/upsxml.php olcommerce/includes/modules/shipping/upsxml.php
Die weiteren Dateien sind schon aus der neuen Version und sind mit den untenstehenden Erweiterungen ergänzt, so daß bei einem Shop in dem diese Dateien noch nicht geändert wurden, diese direkt überschrieben werden können.
SCHRITT 3
In olcommerce/admin/modules.php
FINDEN SIE DIESEN CODE (CA. ZEILE 51):
if (olc_not_null($action)) {
switch ($action) {
case 'save':
while (list($key, $value) = each($HTTP_POST_VARS['configuration'])) {
FÜGEN SIE FOLGENDEN CODE NACH DIESER ZEILE EIN:
if( is_array( $value ) ){
$value = implode( ", ", $value);
$value = ereg_replace (", --none--", "", $value); }
ES SOLLTE JETZT SO AUSSEHEN:
if (olc_not_null($action)) {
switch ($action) {
case 'save':
while (list($key, $value) = each($HTTP_POST_VARS['configuration'])) {
if( is_array( $value ) ){
$value = implode( ", ", $value);
$value = ereg_replace (", --none--", "", $value); }
olc_db_query("update " . TABLE_CONFIGURATION . " set configuration_value = '" . $value . "' where configuration_key = '" . $key . "'");
}
olc_redirect(olc_href_link(FILENAME_MODULES, 'set=' . $set . '&module=' . $HTTP_GET_VARS['module']));
break;
case 'install':
SCHRITT 4
In olcommerce/admin/includes/functions/general.php
FINDEN SIE DIESEN CODE (CA. ZEILE 957):
//// // Alias function for module configuration keys
function olc_mod_select_option($select_array, $key_name, $key_value) {
reset($select_array);
while (list($key, $value) = each($select_array)) {
if (is_int($key)) $key = $value;
$string .= '
<input type="radio" name="configuration[' . $key_name . ']" value="' . $key . '"';
if ($key_value == $key) $string .= ' CHECKED';
$string .= '> ' . $value;
}
return $string; }
FÜGEN SIE FOLGENDEN CODE NACH DIESER ZEILE EIN:
// UPSXML // Alias function for Store configuration values in the Administration Tool
function olc_cfg_select_multioption($select_array, $key_value, $key = ) {
for ($i=0; $i<sizeof($select_array); $i++) {
$name = (($key) ? 'configuration[' . $key . '][]' : 'configuration_value');
$string .= '
<input type="checkbox" name="' . $name . '" value="' . $select_array[$i] . '"';
$key_values = explode( ", ", $key_value);
if ( in_array($select_array[$i], $key_values) ) $string .= ' CHECKED';
$string .= '> ' . $select_array[$i];
}
$string .= '<input type="hidden" name="' . $name . '" value="--none--">';
return $string;
}
ES SOLLTE JETZT SO AUSSEHEN:
//// // Alias function for module configuration keys
function olc_mod_select_option($select_array, $key_name, $key_value) {
reset($select_array);
while (list($key, $value) = each($select_array)) {
if (is_int($key)) $key = $value;
$string .= '
<input type="radio" name="configuration[' . $key_name . ']" value="' . $key . '"';
if ($key_value == $key) $string .= ' CHECKED';
$string .= '> ' . $value;
}
return $string; }
// UPSXML // Alias function for Store configuration values in the Administration Tool
function olc_cfg_select_multioption($select_array, $key_value, $key = ) {
for ($i=0; $i<sizeof($select_array); $i++) {
$name = (($key) ? 'configuration[' . $key . '][]' : 'configuration_value');
$string .= '
<input type="checkbox" name="' . $name . '" value="' . $select_array[$i] . '"';
$key_values = explode( ", ", $key_value);
if ( in_array($select_array[$i], $key_values) ) $string .= ' CHECKED';
$string .= '> ' . $select_array[$i];
}
$string .= '<input type="hidden" name="' . $name . '" value="--none--">';
return $string;
}
//// // Retrieve server information
function olc_get_system_information() {
global $HTTP_SERVER_VARS;
SCHRITT 5
Der "configuration key", welcher das Auswählen der Servicearten dem Kunden anzeigt, ist vom Typ "VARCHAR(255), und reicht damit nicht aus um alle Servicearten zu Speichern.
Sie haben deshalb 2 Möglichkeiten:
1) Gehen Sie in die Tabelle "configuration" Ihrer Datenbank und ändern Sie den Datentyp von VARCHAR(255) auf TEXT.
Diese Änderung können Sie z.B. mit dem Datenbank-Tool PHPmyadmin durchführen.
-- ODER --
2) In olcommerce/includes/modules/shipping/upsxml.php (ca. Zeile 291):
Finden Sie den Schlüssel MODULE_SHIPPING_UPSXML_TYPES
und löschen Sie mindestens 2 der aufgelisteten Versandarten um das Feld auf weniger als 255 Zeichen zu reduzieren
Wenn Sie diesen Schritt 5 nicht durchführen, dann erhalten Sie beim Aufrufen des Modules im Admin-Bereich folgende Fehler- meldung: "Parse error: parse error, unexpected ';' in ....../admin/modules.php(235): eval()'d code on line 1" Führen Sie deshalb eine der beiden Möglichkeiten durch, gehen Sie dann in den Admin-Bereich und entfernen Sie das UPS XML-Modul. Danach installieren Sie es nochmals.
SCHRITT 6
Im Administrationbsbereich, wählen Sie Module -> Versandmodule und aktivieren Sie das neue United Parcel Service (XML) Modul. Editieren Sie das Modul und setzen Sie Ihre Serviceoptionen:
UPS Access Key (erhalten Sie von UPS -> www.ups.com) UPS Username (erhalten Sie von UPS -> www.ups.com) UPS Password (erhalten Sie von UPS -> www.ups.com) Abholmethode Paketart UPS Kundenklassifizierungscode Versandherkunftsland Herkunftsort (für manche Läner erforderlich) Herkunftsprovinz/Bundesland (ISO-Code, 2 Buchstaben), für Deutschland nicht erforderlich Herkunftsland (ISO-Code, 2 Buchstaben), für Deutschland: DE Test- oder Produktionsmodus Maßeinheit Gewicht Maßeinheit Länge Privat- oder Geschäftszustellung Zuschlag für Verpackung und Versand in % Steuerklasse Versandzone Sortierung UPS Servicearten Versandverzögerung
Wenn Sie Fragen zu diesen Einstellungen haben, wenden Sie sich bitte an UPS. Schauen Sie bitte außerdem in das Diskussions- forum von OL - Commerce zu diesem Tool unter: http://www.ol-commerce.de
SCHRITT 7
Testen Sie das Tool mit verschiedenen Empfangsadressen (z.B. innerdeutsch, EU, Außengebiete) und vergleichen Sie die angegebenen Tarife mit den Werten auf der UPS Homepage unter "Laufzeit und Kosten berechnen" (http://wwwapps.ups.com/calTimeCost?loc=de_DE).
Wenn Ihnen Fehler angezeigt werden, ändern Sie die Einstellungen im Admin-Bereich. Eventuell sind die ISO-Code für das Herkunftsland falsch eingegeben.
In dieser Version sind schon alle Änderungen eingebaut, basierend auf der letzten Version von OL - Commerce. Die Dateien brauchen nur überschrieben werden. Eine leere Log - Datei, die in den tmp Ordner kopiert werden kann, um die Versendung mitzuloggen ist auch in dem Paket enthalten. Dabei ist zu beachten, daß die Datei: include/modules/shipping/upsxml.php in der Zeile: ca. 98 angepasst werden muss.
Wenn Sie Fragen haben, wenden Sie sich bitte an die technische Kundendienstabteilung von UPS oder per Email an mail@rennic.de.
Demoshop: http://ups.web-pro.biz
Erweiterungsmodule
Download - Artikel
Um Downloadprodukte in OL-COMMERCE anzulegen und dem Käufer erst nach erfolgter Bezahlung zur Verfügung zu stellen gehen Sie wie folgt vor.
-> Login zu Ihrem Admin Menü
-> Artikelkatalog -> Artikelmerkmale -
legen Sie eine neue Option an : " Downloads " und weisen dieser Option ein Merkmal zu; z.B. PDF Download
-> Artikelkatalog -> Kategorien/Artikel
legen Sie nun wie gewohnt Ihren Artikel an
Speichern Sie das Download Produkt nun per FTP in Ihrem Shopverzeichnis / download
wechseln Sie zu Ihrer Kategorie/Artikel Übersicht , markieren den gewünschten Artikel und klicken rechts im Menü auf " Attribute editieren "
Hier können Sie nun Ihren Artikel auswählen und auswählen, ob der Download zeitlich oder per Stückzahl begrenzt sein soll.
Jetzt ist Ihr Downloadprodukt erstellt
-> Konfiguration -> Bestellstatus
erstellen Sie einen neuen Bestellstatus : " Download aktiviert "
klicken Sie den neuen Bestellstatus an, damit der grüne Pfeil rechts erscheint und lesen in Ihrer Browserzeile oben den Status ab ( /admin/orders_status.php?page=1&oID= xxx );
die xxx stehen für Ihre neue Status ID - Bitte merken
-> Konfiguration -> Download Optionen
stellen Sie den Schalter von : "Download von Artikeln erlauben" auf TRUE und ändern "Min. Bestellstatus" auf den Wert Ihres Bestellstatus "Download aktiviert"
Die Kunden können nun Ihre Produkte bestellen und Sie als Admin bestimmen, ab wann der Kunde den Artikel downloaden kann.
Sobald Sie nun die Bestellübersicht aufrufen und der Bestellung " x " den Versandstatus " Download aktiviert " zuweisen, kann der Kunde in seinem persönlichen Menü die Datei downloaden; bis dahin ist der Download gesperrt.
HINWEIS ! - jeder neu angelegte Bestellstatus nach "Download aktiviert" führt automatisch dazu, dass der Downloadlink aktiviert ist. Wenn Sie das nicht wollen, legen Sie Ihren Download Status immer zuletzt an und weisen dann in den Download Optionen auf die entsprechende ID hin.
eBay - Schnittstelle
Im Script findest Du bei Zeile 72: // Your Ebay Member Name $ebayid = "ebayname"; <- hier den ebay-usernamen eintragen
darunter gibt es noch einige selbsterklärende Variablen.
Zum Anpassen des layouts einfach die entsprechenden html-tags editieren.
Die .html datei anschliessend hochladen nach /media/content/ und im Admin Content-Manager einbinden, fertig.
Viel Spass und Erfolg damit
Technical Parameters Table Ver. 2.0
RMA - Modul
JTL - Wawi (eazySales)
eazySales Connector für OL-COMMERCE
eazySales Connector ist ein kostenloses Modul für den Shop OL-COMMERCE, um automatische Synchronisation zwischen der kostenlosen Warenwirtschaft eazySales und OL-COMMERCE zu ermöglichen.
Informationen zu eazySales gibt es hier: http://www.jtl-software.de/eazysales.php Informationen zu eazySales Connector gibt es hier: http://www.jtl-software.de/eazysales_connector.php Fragen und Support finden man im Forum unter: http://www.jtl-software.de/forum/index.php
EAZYSALES CONNECTOR FÜR OSCOMMERCE / ZEN CART
eazySales Connector für osCommerce, Zen Cart finden man unter http://www.jtl-software.de/eazysales_connector.php
EIGENES RISIKO
Dieses Modul wird - wie jede andere Contribution - auf eigens Risiko betrieben. JTL-Software übernimmt keinerlei Haftung für die Installation und Nutzung von eazySales Connector. Insbesondere haftet JTL-Software nicht für evtl. durch eazySales Connector entstandene Schäden.
LIZENZ
Dieses Modul wurde unter der GPL veröffentlicht - siehe hierzu LICENSE.txt. Urheber des Moduls ist JTL-Software.
INSTALLATION
Die neusten Installationsanleitung findet man stets hier: http://www.jtl-software.de/eazysales_connector.php
1. Erstellen Sie als Erstes eine Sicherheitskopie Ihrer Shopdatenbank und evtl. eazySales Datenbank!
2. Uploaden Sie das gesamte Verzeichnis eazySales_Connector mit einem FTP-Programm in Ihren Shop unter admin/includes/modules/.
3. Rufen Sie mit einem Browser http://IhreShopDomain.de/admin/includes/modules/eazySales_Connector/install/index.php auf, treffen Sie dort Ihre Einstellungen und drücken auf Installieren. Notieren Sie sich die Einstellungen, die Sie in eazySales eintragen müssen unter Einstellungen->Shop-Einstellungen.
4. Führen Sie die Einstellungen in eazySales unter Shop-Einstellunegn durch. Fertig.
Ideen, Kritik und Verbesserungsvorschläge werden im Forum berücksichtigt.
Hilfe zu Templates
Templates installieren
Um ein neues Template in dem Shop zu integrieren, muss nur das neue Template per FTP - Programm auf den Server kopiert werden. Das Template sollte dann in dem Verzeichnis /DeinShop/templates/ liegen. Anschliessend kannst Du im Admin - Bereich unter Konfiguration, Mein Shop, Templateset, das entsprechende Template aussuchen.
Templates erstellen
Hier kommt noch die Anleitung zum erstellen von Templates rein.
