Zum Hauptinhalt springen
ProductsInAction lebt davon, dass Kunden eigene Fotos einsenden. Das Formular dafür steht in einem eigenen Template, das Sie in der Shopkonfiguration shop.config im Abschnitt <ProductsInAction> beim Parameter Upload eintragen. Eingebunden wird es über WS-ExternInclude, der Inhalt steht dort innerhalb der Klammerung WS-Include. Diese Seite beschreibt die Tags, die nur in diesem Template zur Verfügung stehen. Wegweiser: ProductsInAction anbieten
Das Upload-Template wird nur ausgegeben, wenn der Aufruf einen Produktindex mitbringt. Fehlt er, liefert ProductsInAction eine leere Seite zurück. Der Link zum Formular gehört deshalb immer mit &pi=~PR-ProdIndex~ in das Produkt-Template.

​
Darf dieser Besucher überhaupt hochladen

E-PIA_UPLOAD-ALLOWED ist die erste Entscheidung im Template. Nur innerhalb dieser Klammerung ist es sinnvoll, ein Formular aufzubauen.
Der Bereich greift nur, wenn alle vier Bedingungen erfüllt sind. Der negative Bereich ist deshalb kein Randfall, sondern der Normalfall für jeden nicht angemeldeten Besucher. Geben Sie dort E-PIA_ErrorMsg aus, dann erfährt der Besucher auch, woran es liegt, und Sie können zusätzlich auf die Anmeldung verlinken.

​
Das Formular

E-PIA_UploadLink liefert die Adresse absichtlich ohne http: oder https:. Schreiben Sie davor // und nicht das Protokoll. Ein fest eingetragenes http:// bricht im gesicherten Bestellprozess den Upload ab, weil der Browser den Wechsel auf eine ungesicherte Adresse blockiert.Ohne E-PIA_HiddenTags(upload) schlägt der Upload fehl. Das Tag setzt nicht nur Shop-, Mall- und Subshopkennung, sondern auch den Sitzungsschlüssel. Fehlt er, weist ProductsInAction den Versand mit der Meldung LimitExceeded ab.
Der Parameter von E-PIA_HiddenTags() benennt die Aktion. Für das Upload-Formular ist das upload, für das Bewertungsformular in der Detailansicht rating. Ohne Parameter schreibt das Tag nur die Kennungen und den Sitzungsschlüssel, was für ein Formular ohne eigene Aktion genügt, etwa für die Sortierung in der Galerie.

​
Die Auswahlliste für den Namen

E-PIA_UserNameList() baut eine Auswahlliste mit bis zu zwei Einträgen: dem vollständigen Namen aus dem Kundenkonto und, sofern der Name ein Leerzeichen enthält, der abgekürzten Form nach dem Muster “Vorname N.”. Damit entscheidet der Kunde selbst, wie viel von seinem Namen unter dem Foto steht. Das senkt die Hemmschwelle spürbar und ist der Grund, warum es hier eine Auswahlliste und kein einfaches Eingabefeld gibt.
Setzen Sie um E-PIA_UserNameList(), E-PIA_FileInput() und E-PIA_CommentTextarea() kein eigenes select-, input- oder textarea-Element. Die Tags bringen das vollständige Element samt Feldnamen mit. Was Sie in die Klammern schreiben, wird als zusätzliches Attribut übernommen, also etwa eine CSS-Klasse oder eine Kennung.
E-PIA_FileMaxSize gibt nur die konfigurierte Zahl aus. Die Einheit schreiben Sie im Template dahinter.

​
Meldungen und Bestätigung

Innerhalb von E-PIA_UPLOAD-SUCCESSFULL sind auch die Bilddaten-Tags gefüllt, also etwa E-PIA_FileName oder E-PIA_CreateDate. Vorher beziehen sie sich auf kein Bild und bleiben leer. Referenz: E-PIA_ (Bilddaten)
Alle Texte der Meldungen stehen in der Shopkonfiguration shop.config im Abschnitt <ProductsInAction-Txt> und nicht im Template. Ein dort fehlender Eintrag führt zu einer leeren Meldung, der Besucher sieht dann einen Fehler ohne Begründung.
Referenz: Abschnitt ProductsInAction-Txt

​
Der Upload per AJAX

E-PIA_AJAX klammert die Marker ein, mit denen die mitgelieferte JavaScript-Bibliothek die Rückmeldung nach dem Absenden in die Seite einsetzt. Die Marker erscheinen nur beim AJAX-Aufruf, im normalen Seitenaufbau bleiben sie weg.
Öffnender und schließender Marker gehören jeweils in eine eigene E-PIA_AJAX-Klammer. Der Inhalt dazwischen steht außerhalb, denn er soll auch ohne AJAX in der Seite stehen.Die CSS-Klassennamen box_info_hinweis und text_gross sowie die Kennungen ws_actimg_info_div, ws_actimg_error_div und ws_actimg_uploadForm sind in der JavaScript-Bibliothek fest hinterlegt. Benennen Sie sie nicht um, sonst findet das Skript die Container nicht mehr.
Das Skript erwartet außerdem eine Variable actimgVar im Kopf der Seite, in der die erlaubten Formate aus E-PIA_FileFormatList und die Fehlertexte aus den FMSG-Tags stehen. Der Wegweiser zeigt den vollständigen Block. Materialien: WEBSALE JavaScript-Bibliothek

​
Die Tags im Überblick

E-PIA_HiddenTags(), E-PIA_ErrorMsg und E-PIA_InfoMsg sind in allen drei ProductsInAction-Templates zulässig. Die übrigen Tags dieser Seite gelten nur im Upload-Template.

​
Verwandte Themen