Fehler im Handbuch und Verbesserungsvorschlag

[eXcite]

Hallo,

mir ist beim überfliegen vom Handbuch 4.0.1 von DokuMan aufgefallen, dass die SSL Einstellungen nicht korrekt angegeben werden. Bei beiden configure.php Dateien wird true bzw. false gleich geschrieben, das ist aber nicht so.

Bitte bei er nächsten Version anpassen, nicht das deshalb noch mehr Fragen oder Probleme bei der Einrichtung auftauchen. Danke.

includes/configure.php

Code: PHP  [Auswählen]

define('ENABLE_SSL', true); // secure webserver for checkout procedure?
define('USE_SSL_PROXY', false); // using SSL proxy?

admin/includes/configure.php

Code: PHP  [Auswählen]

define('ENABLE_SSL_CATALOG', 'true'); // secure webserver for catalog module
define('USE_SSL_PROXY', 'false'); // using SSL proxy?

Falls es noch nicht drin steht, könnte man noch erwähnen, dass Filezilla die Passwörter ja im Klartext speichert und man das beachten sollte.

Weiterhin finde ich es wichtig, dass darauf hingewiesen wird, dass die configure.php Dateien den Datenbankbenutzer und das Passwort im Klartext enthalten. Diese sollten nach dem Editieren entweder sicher von der Festplatte gelöscht oder die Daten entfernt werden. Somit ist bei evtl. Virenbefall des Rechners keine Gefahr mehr für den Shop gegeben.

Falls es schon im Handbuch erwähnt wurde kann meine Anmerkung für das Handbuch ignoriert werden. Shop Neulinge sollten es dennoch beachten.

Linkback: https://www.modified-shop.org/forum/index.php?topic=26832.0

[DokuMan]

Danke für den Hinweis - das wird in der nächsten Version berücksichtigt sein.

[Roberto]

Hallo,

da ich keinen neuen Thread eröffnen möchte, schreibe ich mein Anliegen zum Handbuch hier rein - ich hoffe das ist okay.
Im Handbuch (Version 4.1 vom August 2013) steht auf Seite 18 unter Punkt 1.3.2 E-Mail Dateianhänge personalisieren:

Mit modified werden standardmäßig die Dateien
• "signatur.txt",
• "signatur.html",
• "widerruf.txt",
• "widerruf.html"
im   Verzeichnis....

Die Dateien widerruf.txt und widerruf.html sind aber in der aktuellen Version v1.06 rev 4642 SP3 nicht vorhanden. Entweder müsste das Handbuch korrigiert oder die Dateien in den Shopsoftware wieder integriert werden. Ich denke, dass könnte sonst Anwender verwirren.

Grüße
Roberto

[awids]

In der aktuellen Version werden AGB und Widerrufstext (Code anbei) nicht mehr aus Dateien sondern aus der Datenbank ausgelesen. Das Handbuch komplett umzuschreiben oder zur veralteten Funktion zurück zu kehren sind allerdings die falschen Wege, da derzeit viele Shopversionen im Einsatz sind. Ich lese hier immer öfter was von Shopversionen wie 1.05 SP1d etc.. Vielmehr sollte man vielleicht einen Zusatz a la "Ab Version XYZ: ..." ergänzen.

Code: XML  [Auswählen]

{if $REVOCATION_HTML neq ''}
<br />
<font size="1" face="Arial, Helvetica, sans-serif">{$REVOCATION_HTML}</font>
<br />
{/if}

[Roberto]

Hallo,

soeben habe ich einen weiteren Fehler entdeckt:
Im Handbuch (Version 4.1 vom August 2013) steht auf Seite 42 unter Punkt 3.10 Versandoptionen:

...Wenn   Sie   mehrere   Versandzonen   für
unterschiedliche   Versandkosten   benötigen,   müssen   Sie   im   ersten   Schritt   die   Datei
/includes/modules/shipping/zones.php editieren. Die Zeile

Code: PHP  [Auswählen]

$this->num_zones = 1;

ändern und die Zahl auf die gewünschte Anzahl an Zonen erhöhen. Definieren Sie anschließend die
Länder und die Versandkosten für die Zonen...

Das ist falsch, denn in der Datei /includes/modules/shipping/zones.php steht

Code: PHP  [Auswählen]

//BOF - 29.07.2009 - Dokuman - up to 9 zones possible, no changes in langfile needed
      //$this->num_zones = 1;
      $this->num_zones = 9;
//EOF - 29.07.2009 - Dokuman - up to 9 zones possible, no changes in langfile needed

Das bedeutet, dass bereits im Jahr 2009 der Quelltext angepasst wurde und eine Änderung nur dann notwendig ist, wenn man mehr als Neun Zonen benötigt.

Grüße
Roberto

[Roberto]

Hallo,

Im Handbuch (Version 4.1 vom August 2013) steht auf Seite 26 unter Punkt 3.15 Hilfsprogramme als erster Menüpunkt Rundschreiben.
In der aktuellen Modified Version v1.06 rev 4642 SP3 ist dieser Menüpunkt jedoch mit Newsletter betitelt.
Den gleichen Fehler findet man auch aus Seite 57 unter Punkt 4.9 Rundschreiben.

Grüße
Roberto

[Bonsai]

Das ist eigentlich ein Fehler in der Sprachdatei des Shops..... oder ist "Newsletter" deutsch? Rundschreiben ist völlig richtig! Ich kann ja verstehen, wenn Anglizismen eingesetzt werden wenn es kein deutsches Wort gibt .... (Was ist eine Mutterkarte ) das gibt es ja auch umgedreht (Kindergarden) aber Rundschreiben ist völlig in Ordnung.
Ich kann hier ein Buch empfehlen aus dem Nikol Verlag:
https://www.j-k-fischer-verlag.de/Gesellschaft/Speak-German--2323.html

[Roberto]

Mein Hinweis bezog sich ganz allgemein auf Unstimmigkeiten von Handbuch und Software, die man ggf. bei der nächsten Überarbeitung berücksichtigen sollte.
In Bezug auf Anglizismen gebe ich dir aber völlig recht! Da haben sich leider noch ganz andere Begriffe eingebürgert...

[Roberto]

Im Handbuch (Version 4.1 vom August 2013) ist auf Seite 30 unter Punkt 3.1.7 Konfiguration der Menüpunkt "Suchverknüpfungen" aufgeführt. Diesen Menüpunkt gibt es jedoch in der aktuellen Version v1.06 rev 4642 SP3 nicht.

[Roberto]

Einen nicht kleinen Fehler habe ich auf Seite 65 gefunden: Hier wird die SMTP-Methode für den Mail-Versand anhand des HostEurope-Kontos erklärt. Dort wird unter Punkt 3 die Adresse des SMTP Servers mit folgendem Beispiel angegeben: mailout. example.org
Diese Angabe ist falsch.
Korrekt ist: wpXXXX.webpack.hosteurope.de (XXXX - Nummer ist im KIS nachzuschlagen)
Der Rest in korrekt. (Soeben getestet)

Siehe auch:
https://faq.hosteurope.de/view.php?mode=open_image&content_id=10617

[Roberto]

Auf Seite 73 im Handbuch (Version 4.1 vom August 2013) wird der Vorgang zur Datenbanksicherung beschrieben.
In der aktuellen Shopsoftware Version v1.06 rev 4642 SP3 gibt es die dort beschriebene Option "Nur herunterladen" nicht! Stattdessen findet man die Option "Vollständige 'INSERT's". Selbst die Beschreibung im Backend "Feldnamen werden in jede INSERT-Zeile eingetragen (vergrössert das Backup)" ist nicht aussagekräftig in Bezug auf die Notwendigkeit dieser Option.
Man könnte verunsichert sein, welche Auswirkungen diese Option für eine Wiederherstellung haben kann.

[Fakrae]

Einen nicht kleinen Fehler habe ich auf Seite 65 gefunden: Hier wird die SMTP-Methode für den Mail-Versand anhand des HostEurope-Kontos erklärt. Dort wird unter Punkt 3 die Adresse des SMTP Servers mit folgendem Beispiel angegeben: mailout. example.org
Diese Angabe ist falsch.
Korrekt ist: wpXXXX.webpack.hosteurope.de (XXXX - Nummer ist im KIS nachzuschlagen)
Der Rest in korrekt. (Soeben getestet)

mailout.example.org ist schon in Ordnung, das ist eine geläufige Bezeichnung. Hosteurope hat viele verschiedene Syntaxen (Syntaxi? ka^^) - bspw gibt es auch noch vwpXXXX... für managed Webserver und diverse andere für die verschiedensten Produkte.

[Roberto]

Hosteurope hat viele verschiedene Syntaxen

Da bin ich mir gar nicht so sicher, da ich das Bild hier aus der FAQ von Hosteurope habe.
Wie dem auch sei, ich denke wpXXXX.webpack.hosteurope.de ist besser als mailout. example.org (Das steht tatsächlich mit Leerzeichen so in der Anleitung...)
PS: Syntaxen ist korrekt

[Roberto]

Recht verwirrend fand ich im aktuellen Handbuch Version 4.1 vom August 2013 auf Seite 103 unter Punkt 9.19 [DEV] Das Wort "Katalog" und/oder „Startseite“ aus der Breadcrumb Navigation entfernen die Angabe Entfällt mit Version 1.06.
Hier lief wohl etwas schief, denn dass ist in der aktuellen Shopsoftware Version v1.06 rev 4642 SP3 leider nicht der Fall.

Die Lösung müsste lauten:
In der Datei includes/modules/create_breadcrumb.php folgenden Abschnitt suchen:

Code: PHP  [Auswählen]

if (DIR_WS_CATALOG == '/') {
  $breadcrumb->add(HEADER_TITLE_TOP, xtc_href_link(FILENAME_DEFAULT));
  $link_index = HEADER_TITLE_TOP;
} else {
  $breadcrumb->add(HEADER_TITLE_TOP, xtc_href_link('../'));
  $breadcrumb->add(HEADER_TITLE_CATALOG, xtc_href_link(FILENAME_DEFAULT));
  $link_index = HEADER_TITLE_CATALOG;
}

Um das Wort Katalog zu entfernen, muss der Abschnitt damit ersetzt werden:

Code: PHP  [Auswählen]

if (DIR_WS_CATALOG == '/') {
  $breadcrumb->add(HEADER_TITLE_TOP, xtc_href_link(FILENAME_DEFAULT));
  $link_index = HEADER_TITLE_TOP;
} else {
  $breadcrumb->add(HEADER_TITLE_TOP, xtc_href_link('../'));
  //$breadcrumb->add(HEADER_TITLE_CATALOG, xtc_href_link(FILENAME_DEFAULT));
  //$link_index = HEADER_TITLE_CATALOG;
}

Um das Wort Startseite zu entfernen, muss der Abschnitt damit ersetzt werden:

Code: PHP  [Auswählen]

if (DIR_WS_CATALOG == '/') {
  $breadcrumb->add(HEADER_TITLE_TOP, xtc_href_link(FILENAME_DEFAULT));
  $link_index = HEADER_TITLE_TOP;
} else {
  //$breadcrumb->add(HEADER_TITLE_TOP, xtc_href_link('../'));
  $breadcrumb->add(HEADER_TITLE_CATALOG, xtc_href_link(FILENAME_DEFAULT));
  $link_index = HEADER_TITLE_CATALOG;
}

Funktioniert beides aber bitte trotzdem prüfen ob korrekt!

[Fakrae]

Hosteurope hat viele verschiedene Syntaxen

Da bin ich mir gar nicht so sicher, da ich das Bild hier aus der FAQ von Hosteurope habe.

Und ich bin bei Hosteurope, und bei mir ist die Adresse anders

[Roberto]

Mein Vorschlag für das Problem mit der E-Mail-Kontobezeichnung bei HostEurope lautet:

XXXX.webpack.hosteurope.de (XXXX ist im KIS nachzuschlagen)

Das sollte alle Eventualitäten einschließen

Ansonsten habe ich keine weiteren Fehler im Handbuch gefunden, wobei ich nicht jeden Punkt geprüft habe. Aber ich denke, dass die in diesem Thread angesprochenen Dinge bei der nächsten Überarbeitung einfließen sollten, um Probleme für Neueinsteiger zu vermeiden.

Nachtrag: Noch eine kleine Sache: Die Beschreibungen für das Admin-Backend ab Punkt 3.1.7 Konfiguration im Handbuch sollte man noch mal mit der Realität vergleichen - hier fehlen etliche Punkte und andere sind in anderen Menüs integriert. Das verwirrt teilweise sehr!
Anregung: Die Beschreibung der einzelnen Menüpunkte könnte auch entfallen, da sie im Backend eigentlich aussagekräftig beschrieben sind.

Ich hoffe, dass meine Fehlersuche nicht umsonst war 

[Bonsai]

example.org ist eine Standarddomain die eigens für Handbücher gedacht ist, damit Anfänger nicht irgendwelche produktiven Server mit unsinnigen Requests belasten. Jeder der schon ein paar Systeme konfiguriert hat, dem ist example.org schon mal in irgendeiner Doku über den Weg gelaufen.
Die Domain gibt es übrigens:
example.org
Hier ein Wikipedia Eintrag dazu:
https://de.wikipedia.org/wiki/Beispieldomains

Mich würde mal deren Zugriffsstatistik interessieren

[esoversum]

Hallo zusammen,

nach erstmaligem Überfliegen des neuen Handbuchs für 2.0.7.X fielen mir ziemlich viele Rechtschreibfehler auf.

Hab jetzt die genauen Seitenzahlen nicht mehr im Kopf, aber ich denke, gerade bei einem Buch sollte das korrekturgelesen werden, oder ist dies im Jahre 2022 kein Ding mehr?

Schöne Grüße,
eso