EXT: GSA Shop¶

GSA Shop¶

GSA Standalone Database¶

GSA Socket¶

GSA User Registration¶

GSA Admin¶

GSA Article Lists¶

GSA Article Categories¶

GSA Dunning¶

GSA Stock¶

Heidelpay ePayment¶

VR-ePay ePayment¶

[TER/SVN Status of GSA related extensions]

Other add-on extensions of the “GSA extension family” should follow step by step to TER ( http://typo3.org/extensions/ ) and/or Forge SVN ( http://forge.typo3.org/ ). All related extensions will be open source.

The following add-on extensions for GSA Shop are already developed and in use for projects, but most of them are not completely finished and all are lacking documentation. The public release of these extensions depends on time, sponsoring and/or internal need for further development, documentation etc.

Sponsoring and serious help offers for outstanding todos are welcome!

• GSA Related Articles (Ext. pt_gsarelatedarticles)
• GSA Related Files for Articles (Ext. pt_gsarelatedfiles)
• GSA Related Content for Articles (Ext. pt_gsarelatedcontent)
• GSA Article Indexer (Ext. pt_gsasearch): Indexing GSA articles for indexed search
• GSA Accounting extensions (Ext. pt_gsaaccounting, pt_gsahbci, pt_gsamatching) - these extensions include:
  • Online accounting interface for outstanding items (payment, credit notes)
  • Generation of files for direct debiting (DTA: standardized German money transactions exchange information file format)
  • Accounting of payments from bank transfer, debiting via HBCI import (bank-independent standardized German online banking protocol)
  • automatic matching of incoming payments to outstanding items; GUI for booking
• GSA Doc Order (Ext. pt_gsadocorder): enables downloadable articles
• GSA PDF Documents (Ext. pt_gsapdfdocs): automatic creation of PDF files for all document types (order confirmation, invoice etc.)
• GSA Partners (Ext. pt_gsapartners): registering advertising partners, giving commission for sales generated via partner links
• GSA Vouchers (Ext. pt_gsavoucher): different types of vouchers (discount vouchers, gift certificates)
• GSA Barcode (Ext. pt_gsabarcode): allows using a barcode scanner for selling articles manually in combination with the shop system

The original author of GSA Shop core (and of some related extensions), Rainer Kuhn, transfers the further development of GSA Shop and all related GSA extensions to punkt.de GmbH ( http://punkt.de/ ) at the end of 2009, since he meets new challenges from 2010 on. Please contact the email address “t3extensions<at>punkt.de” for development versions of the extensions, for further information and for questions about GSA Shop.

TS configuration PID¶

PID of the page where to find the main typoscript configuration of GSA¶

Timezone (PHP)¶

The timezone identifier (see http://php.net/manual/en/timezones.php)¶

Production Environment¶

Check this box if the extension is used in production environment,¶

Now you have to create your page tree with plugin pages and sysfolders (see next chapter), Don't forget the sysfolders for article images and for cached articles. The PIDs of these sysfolders have to be set in the extension configuration in Constant Editor. (see chapter “Configuration”).

Page (“page tree example name”)¶

General Storage Folder¶

FE User¶

Article Cache (“Artikel (Cache)”)¶

Article Images (“Artikel-Bilder”)¶

Orders (“Bestellungen”) [ optional ]¶

Categories (“Kategorien”) [ optional ]¶

Login/Logout¶

Product pages (“Produktseite n”)¶

Article single view (“Artikel-Einzelansicht (pi2)”)¶

Shopping cart (“Warenkorb”)¶

Order overview (“Bestellung”)¶

Order submitted (“Bestellung abgeschickt”)¶

Credit Card Payment (“Kreditkarten-Zahlung”)[ optional ]¶

Payment ok(“Zahlung erfolgt”) [ optional ]¶

Payment failed(“Zahlung fehlgeschlagen”[ optional ]¶

Workflow (“Workflow (Customer/Operator)”)[ optional ]¶

Order archive (“Bestellarchiv”)[ optional ]¶

Personal data (“Persönliche Daten”)¶

Customer data (“Kundendaten”)¶

Bank data (“Bankdaten”)¶

User data (“Benutzerdaten”)¶

Delivery addresses (“Adressen”)¶

Terms and conditions (“AGB”)¶

Right of withdrawal (“Widerrufsrecht”)¶

[Usage of pages and plugins]

* GSA customer group = see description directly above this table

Category: PT_GSASHOP::PAGES¶

Category: PT_GSASHOP::GENERAL¶

Category: PT_GSASHOP::GSA SETTINGS¶

Category: PT_GSASHOP::PAYMENT¶

Category: PT_GSASHOP::SMARTY TEMPLATES¶

Category: PT_GSASHOP::ARTICLE DISPLAY¶

Category: PT_GSASHOP::CARTBOX¶

Category: PT_GSASHOP::WORKFLOW¶

Reference (TypoScript)¶

imageConf {
    file {
        width = 200m
        height = 200m
        format = jpg
        # backColor = #FBE59C
        quality = 95
    }
    imageLinkWrap = 1
    imageLinkWrap {
        enable = 1
        JSwindow = 1
        bodyTag = <body bgColor="#cccccc" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
        width = 600m
        height = 600m
        # title = pt_gsashop
        JSwindow.expand = 0,0
        wrap = <a href="javascript:close();"> | </a>
    }
}

IMPORTANT hook changes in v0.14.0 (Dec. 2008):¶

As a side effect of the code refactoring of the order processing (after submitting an order) in version 0.14.0 of pt_gsashop (for details please refer to that version's changelog below), some hooks have changed, in terms of:

• the "identifier key" in the $GLOBALS['TYPO3_CONF_VARS']['EXTCONF'] array
• the available parameters in the hook
• and the way the hook is called and the parameters are passed

These 3 hooks identifier keys have changed:

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['pt_gsashop']['pi3_hooks][' processOrderSubmission_fixFinalOrderHook']has changed to:$GLOBALS['TY PO3_CONF_VARS']['EXTCONF']['pt_gsashop']['orderProcessor_hooks]['f ixFinalOrderHook']

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['pt_gsashop']['pi3_hooks][' processOrderSubmission_alternativeOrderConfirmPage']has changed to:$G LOBALS['TYPO3_CONF_VARS']['EXTCONF']['pt_gsashop']['orderProcessor_hooks]['redirectToConfirmationPageHook']

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['pt_gsashop']['pi3_hooks][' getEpaymentDescrHook']has changed to:$GLOBALS['TYPO3_CONF_VARS']['EX TCONF']['pt_gsashop']['orderProcessor_hooks]['getEpaymentDescrHook']

In the case of the "fixFinalOrderHook" and the "redirectToConfirmationPageHook" the way they are called has changed as well: From now you register a TYPO3-userfunction in your ext_localconf.php and not only an objects name. You're free to choose any class name and method name that should process the hook.

Example:

$TYPO3_CONF_VARS['EXTCONF']['pt_gsashop']['orderProcessor_hooks']['fixFinalOrderHook'][] = 'EXT:pt_gsapdfdocs/res/pt_gsashop_hooks/class.tx_ptgsapdfdocs_hooks_ptgsashop_orderProcessor.php:tx_ptgsapdfdocs_hooks_ptgsashop_orderProcessor->fixFinalOrderHook';

In this case there is no need to include the class file, e.g. by require_once(). This will be done automatically be TYPO3 when calling the hook.

Each hook method called in this way will get two parameters:

an array of parameters – please refer to the appropriate hook's code for individual details (the array of parameters currently contains for the "fixFinalOrderHook" the current orderWrapper object $orderWrapperObj, and for the "redirectToConfirmationPageHook" it contains the original redirect target $redirectTarget...)

a reference to the calling object

Aktivierung der Workflow Engine¶

Die Workflow-Engine ist Teil der Extension pt_gsashop und kann im Constant Editor, Category: “PT_GSASHOP: WORKFLOW” aktiviert und individuell konfiguriert werden. Zur Aktivierung muß mindestens der Wert plugin.tx_ptgsashop.enableOrderWorkflow auf 1 gesetzt werden.

Konfiguration der Workflow Status im Backend¶

Anwendung: Web->Liste->im Seitenbaum die Seite mit der PID 1 („Home/Login“) markieren->im Bereich „Workflow“ (s. Abb. 12 mitte/rechts: rosafarbene Blatt-Symbole) die einzelnen Stati individuell bearbeiten.

Diese Werte werden in die Datenbanktabelle „tx_ptgsashop_workflow“ der TYPO-Installation geschrieben.

Erweiterte Workflow-Konfiguration über Konfigurationsklassen¶

Zusätzlich können für einzelne Workflow Stati über Konfigurationsklassen noch Bedingungen und Aktionen in einer eigenen Extension definiert werden. Diese Extension muß im Constant Editor, Category: “PT_GSASHOP: WORKFLOW” bei plugin.tx_ptgsashop.workflowExtensionKey der Workflow Engine bekannt gemacht werden.

Die Konfigurationsklassen müssen das Interface tx_ptgsashop_iWfsConfigurator (typo3conf/ext/pt_gsashop/res/class.t x_ptgsashop_iWfsConfigurator.php) implementieren und sind innerhalb der eigenen Extensionim Verzeichnis res/pt_gsashop_workflow/ zu platzieren.

Die Namen der Konfigurationsklassen müssen dem Schema tx_<Ext.Key der implementierenden Ext. ohne Unterstrich>_wfsConfig_<n> folgen, wobei <n> für den Status Code des Workflow Status steht (Bsp. für Status 3 in der Extension myext: tx_myext_wfsConfig_3 ). Daraus ergibt sich dann mit vorgestelltem „class.“-Prefix und angehängtem „.php“-Suffix der Dateiname (im Bsp. class.tx_myext_wfsConfig_3.php ).:underline:ACHTUNG : Weichen Klassen- oder Dateiname von diesem Schema ab, wird die Konfigurationsklasse nicht gefunden und es werden Fehlermeldungen verursacht !

Innerhalb der Konfigurationsklasse müssen folgende Methoden mit dem jeweils vom Interface vordefinierten Methodennamen implementiert werden (optional mit eigenen Inhalten oder dem default “return true;”), für die bei Implementierung mit eigenen Inhalten jeweils in der Backend-Konfiguration eines Workflow Status (s.o.) die entsprechende Checkbox zu setzen ist:

v1.0.1¶

updated chapter “GSA extension overview” of this manual, fixed some documentation errors

v1.0.0¶

• updated extension dependencies and this manual to the current state of things
• changed extension state to ''stable'' after successful usage in several production environment websites
• added new hook 'mainControllerHook' to tx_ptgsashop_pi2::main()
• added some getter methods to tx_ptgsashop_pi2

v0.14.1¶

• bugfix in tx_ptgsashop_orderProcessor: added missing inclusion of class tx_ptgsashop_orderPresentator
• added new hooks:
  • 'postOrderProcessingHook' in tx_ptgsashop_orderProcessor::processPostOrderProcessingHooks() (called from tx_ptgsashop_orderProcessor::processSubmission())
  • 'updateArtDistrQtyChangesConsequencesHook' in tx_ptgsashop_pi3::updateArtDistrQtyChangesConsequences()
• refactoring of article box template articlebox.tpl.html: added new marker $additionalArticleData, reformatted HTML code

v0.14.0¶

This version contains lots of improvements and revisions of historically grown configurations and behaviours. In the course of getting rid of these legacy structures and to support future concepts of GSA Shop some things have been changed incisive. This results in changed behaviour, changed default configurations (Typoscript/Constant Editor) and changed hooks – so **please read the changelog notes and instructions carefully when updating an existing instance of this extension** :

• adaptation for new optional "2-in-1" database concept (see extension manuals of pt_gsaminidb and pt_gsasocket): this allows the import of the required GSA database tables into an existing TYPO3 database (e.g. for users who do not have have the privileges to create an additional database on their database server) – requires updated dependencies, see below!
• **IMPORTANT** : addedextension pt_mail as new dependency requirement; dependency version update for pt_tools (version 0.4.1-), pt_gsasocket )version 0.3.0-), pt_gsauserreg version )0.1.0-)
• complete refactoring of the order submission process (processing was done within tx_ptgsashop_pi3 before):
  • added new class tx_ptgsashop_orderProcessor: based on refactored code of former tx_ptgsashop_pi3::processOrderSubmission()
  • **IMPORTANT** : static/setup.txt: moved several Typoscript configuration options from plugin.tx_ptgsashop_pi3 to config.tx_ptgsashop: orderConfirmPage, paymentPage, workflowPage, useAutomaticInvoiceBooking (this means these are removed in plugin.tx_ptgsashop_pi3, adapt your Typoscript if you've used them!)
  • static/setup.txt: added several configuration options from plugin.tx_ptgsashop_pi3 to config.tx_ptgsashop: orderEmailSender, orderEmailRecipient, orderConfirmationEmailBcc, orderConfirmationEmailReplyTo, sendFinalOrderEmailToCustomer, enableOrderWorkflow
  • **IMPORTANT** :tx_ptgsashop_pi3: returnWrapperForArchivedOrder() and sendFinalOrderEmail() marked as DEPRECATED now (both may be removed in one of the upcoming versions); moved class constant WORKFLOWPLUGIN_CLASS_NAME from tx_ptgsashop_pi3 to new class tx_ptgsashop_orderProcessor; refactored processOrderSubmission()
  • tx_ptgsashop_orderWrapper: added miscellaneous new methods and properties
  • moved appropriate pi3 locallang labels from pi3/locallang.xml res/locallang_res_classes.xml ("log_initial_workflow" is now "tx_ptgsashop_orderProcessor.logentryWorkflowInitial", "log_final_order" is now "tx_ptgsashop_orderProcessor.logentryFinalOrder", "orderEmail_subject" is now "tx_ptgsashop_orderProcessor.orderEmailSubject"
  • **IMPORTANT** : changed workflow example doc/class.tx_example_wfsConfig_1.php.txt: re-written execApprovalAction() example using new tx_ptgsashop_orderProcessor now – please adapt your workflow classes if you've used the old example with now deprecated pi3 methods!
  • **IMPORTANT** : three former Hooks of the $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['pt_gsashop']['pi3_hooks] array have been renamed (change of the hook identifier) and the way they are called has changed – please refer to the new chapter of this manual “Hook usage” for details on how to adapt your existing code using these hooks
• major revision of email dispatch, usage of new dependency extension 'pt_mail' to send all shop related emails:
  • **IMPORTANT** : extension “pt_mail” has to installed on your server (seedependency update note above)
  • **IMPORTANT** : added new TypoScript template 'GSA Shop: pt_mail Config'in static/pt_mail_config/setup.txt – this template has to included additionally to your TypoScript template. Please note: the “ptmail Config” template has to be included after the “Basic Config” template (please refer to the adapted chapter of this manual “Installation and Extension Manager Settings” for details).
  • added new Constant Editor/TypoScript config option "shopName"
  • **IMPORTANT** : changed behaviour of Constant Editor/TypoScript config option "orderEmailSender": this will be used as sender address for _all_ shop emails now (e.g. the order confirmation and payment result emails of the the shop core, but intented for emails from other GSA extensions as well!). NOTE: Please ignore the historically grown (and for backwards compatibility reasons unchanged) option name "orderEmailSender", it's value will be used as general email sender and not for order emails only!
  • **IMPORTANT** : changed behaviour of Constant Editor/TypoScript config option ""sendFinalOrderEmailToCustomer": uncheck this if you do not want the final order to be sent as an auto- generated confirmation email - this setting affects the CC: and BCC: settings as well (no order confirmation email is sent at all if this one is disabed).
• added new tx_ptgsashop_baseArticle property $artrelApplIdentifier and appropriate processing, including new database fields in ext_tables.sql - **IMPORTANT** : this requires a database update in the Extension Manager
• added order confirmation email template in English language (res/smarty_tpl/finalorder_utf8_en.tpl.txt)
• changes to “Payment sum” display (new feature since v0.13.0): new Constant Editor/Typoscript configuration option “displayPaymentSumByDefault” (see chapter “Configuration” above), added display condition in default templates for order overview and order confirmation email, minor layout changes for templates
• added current order object as additional parameter to all (temporary) “processShopOrderTransactionStorage_manipulate* hook” hooks in tx_ptgsashop_gsaTransactionHandler – **IMPORTANT** : please adapt your hook methods if you're using these hooks
• fixed bug in tx_ptgsashop_gsaTransactionHandler: delivery confirmation document ID is now passed to the call of both "processShopOrderTransactionStorage_manipulateDelNote*RecordHook" hooks (was order confirmation document ID before)
• fixed bug in tx_ptgsashop_sessionOrder::createFromOrderObj() (caused type hint error with value NULL in tx_ptgsashop_order::set_paymentModifierCollObj())
• fixed error display if the 'GSA Cache' button was pressed without any articles being existent in the GSA database
• fixed 'no config' exception' when selecting plugin articles in the backend: article selection without configuration of the “description source field name” possible now
• fixed backend tax description display if the “old” ERP tax table "STEUER" is not existent
• tx_ptgsashop_iPaymentModifierCollection: added missing parameter $orderId for storeToOrderArchive()
• tx_ptgsashop_orderWrapper: added missing require for tx_pttools_assert
• tx_ptgsashop_order: added the possibility to force an uid when saving an order to the order archive (added optional parameter "uid" in saveToOrderArchive() and insertOrder())
• tx_ptgsashop_baseArticle: marked all "old" image processing (of GSA database-internal stored binary images) methods and properties as DEPRECATED (due to "new" TYPO3 database based multiple image processing)
• ext_emconf.php: changed 'createDirs' to the default smarty extension directories 'typo3temp/smarty_cache,typo3temp/smarty_compile'
• miscellaneous minor internal improvements (revision of general exception handling; tx_ptgsashop_orderProcess::bookOrderConfirmationToInvoice(): changed/added internal checks of related doc numbers and already processed invoice transformation; tx_ptgsashop_gsaTransactionAccessor: added checks to assure that only 1 row is found; etc.)

v0.13.0¶

• major performance improvements due to usage of a configuration registry for all classes using Typoscript configuration (new method tx_ptgsashop_lib::getGsaShopConfig(), changes in all appropriate classes) – **IMPORTANT** : this requires the extension pt_tools version 0.4.0 or higher
• added several shop core additions to process arbitrary payment modifiers (e.g. voucher, credit balances etc.):
  • added new interface tx_ptgsashop_iPaymentModifierCollection
  • added new property tx_ptgsashop_order::paymentModifierCollObj and the appropriate handling in all related functionality
  • added new method property tx_ptgsashop_order::getPaymentSumTotal() - this method's return is passed to epayment requests now
  • **IMPORTANT** : added “Payment sum” display in default templates for order overview and order confirmation email
• **IMPORTANT** : added cookie check in tx_ptgsashop_pi1::main() and tx_ptgsashop_pi2::exec_addArticleToCart()
• **IMPORTANT** : Bugfix in ext_tables.sql: added missing database field "tx_ptgsashop_orders.applSpecDataClass" - this requires a database update in the Extension Manager
• **IMPORTANT** : tx_ptgsashop_articleAccessor::selectOnlineArticles() throws exceptions now if query failed or returned empty result (the later can be suppressed with a new optional parameter)
• shopping cart changes: empty cart message is displayed with a message box now, article sorting now shows articles changed in quantity at the end of the list, article images available in shopping cart now (see tx_ptgsashop_pi1::displayShoppingCart())
• added handling of EAN numbers (European Article Number is a barcoding standard) to articles: new property tx_ptgsashop_baseArticle::eanNumber, new method tx_ptgsashop_articleAccessor::selectArticleDataByEAN()
• added miscellaneous new additional data marker hooks (in tx_ptgsashop_pi3::displayOrderOverview_MarkerArrayHook(), tx_ptgsashop_orderPresentator::getPlaintextPresentation(), tx_ptgsashop_pi4::displayOrdersList() and tx_ptgsashop_pi4::displaySingleView())
• added appropriate template markers for additional data (in templates orderoverview.tpl.html, orderslist.tpl.html, ordersingleview.tpl.html, finalorder_utf8.tpl.txt)
• added new "mainControllerHook" in tx_ptgsashop_pi3::main()
• added TS option “config.tx_ptgsashop.orderPage” to default TS setup
• tx_ptgsashop_gsaTransactionHandler::continueOrderConfirmationToInvoi ce(): added special treatment for invoices with sum total equals zero, these are marked as settled (ERP: "erledigt") now
• miscellaneous minor internal improvements

v0.12.2¶

• added new scale price quantity tolerance setting (for detailsplease refer to the description of the setting in Constant Editor category PT_GSASHOP::GENERAL, option “scalePriceQtyTolerance”)
• added new customer specific price handling setting for mixed calculation/combined costing (for details please refer to the description of the setting in Constant Editor category PT_GSASHOP::GENERAL, option “custSpecPriceOverridesDefaultPrice”)
• improvements of plugin tx_ptgsashop_pi2 (article display) for integration via Typoscript (no missing flexform configuration exception thrown anymore, added stdWrap handling of $this->conf['article_uid'])
• changed scale price related locallang labels of pi2: new labels "pricescales_qty" and "pricescales_price" are used from now on
• added additional parameter $orderWrapperObj to hook “processOrderSubmission_fixFinalOrderHook” in tx_ptgsashop_pi3

v0.12.1¶

• added update warning in extension manager display to inform users updating previous versions via the extension manager
• changed sorting in Constant Editor category PT_GSASHOP::PAYMENT
• revision of this manual: used new 2008 manual template, format corrections for online display, minor updates

v0.12.0¶

This version contains lots of improvements and revisions of historically grown configurations and behaviours. In the course of getting rid of these legacy structures and to support future concepts of GSA Shop some things have been changed incisive. This results in changed default configurations (Typoscript/Constant Editor) and changed behaviour – so **please read the changelog notes and instructions carefully when updating an existing instance of this extension** :

• **IMPORTANT** :dependency changes: raised TYPO3 version dependency to version 4.1; raised pt_tools library dependency to version 0.3.0, removed dependency for CC clearing extension pt_heidelpay (now suggestion only)
• new features and elements:
  • added views of complete orders including all sub-elements in the backend by restructuring the order related TCA entries using IRRE,
  • submitted orders can be stored in a sysfolder now by using the new TS/CE config “orderStoragePid” (see below),
  • added new individual backend icons for all appropriate TCA elements, plugins and modules of GSA Shop (replaced default icons, added new passive article icon for article cache, adapted appropriate TCA configuration, SQL definitions etc.)
  • **IMPORTANT** : these additions require a database update in the extension manager after updating the extension
  • **IMPORTANT** : to display existing orders correctly in the new backend view, use the “UPDATE!” option in the upper right selectorbox of the Extension Manager to convert your existing order database records for usage with IRRE
• major revision of article linking (links from article to their appropriate detail/single view pages):
  • complete revision of tx_ptgsashop_baseArticle::getFePageLink() (changed internal logic, adopted typolink functionality for the linking functions, removed method parameter), appropriate removal of method parameter in all calls of this method
  • **IMPORTANT** : Constant Editor category PT_GSASHOP::GENERAL: option “displayCartArticleLinks” (CE header “Enable cart article linking”) is now re-used for it's original purpose only (a flag whether:underline:cart article should be linked to detail pages or not) and it's default value has been changed from 0 to 1 now; appropriate changes to displayShoppingCart() und displayArticleConfirmation() in pi1
  • **IMPORTANT** : the former additional link configuration values of the “displayCartArticleLinks” TS/CE config option on:underline:how to create detail pages links for articles in general have been removed now, the linking of articles to their detail pages is now:underline:always based on former setting “(2) Link to pid or alias set in field "Webadresse" in GSA-Admin or ERP-GUI (GSA- DB: ARTIKEL.WEBADRESSE)”!
  • **IMPORTANT** : the internal logic of processing the contents of the GSA-DB field “ARTIKEL.WEBADRESSE” (field "Webadresse" in GSA-Admin or ERP-GUI) has been switched vice versa to improve future handling of articles: an empty field (null) now means “Link to the shop's default article single view page”, value “-1” now means “do not link article at all”! This relates to all article links if they are switched on, e.g. articles in cart (CE category PT_GSASHOP::GENERAL, option “displayCartArticleLinks”) and pi2-articles in “article display” content elements or article lists (CE category PT_GSASHOP::ARTICLE DISPLAY, option “articleDisplayUrl”).This incisive changes requires a manual update of your articles in the GSA-DB table “ARTIKEL” - execute the following SQL query to perform the update:“UPDATE `ARTIKEL` SET `WEBADRESSE` = '-2' WHERE `WEBADRESSE` LIKE '-1'; UPDATE `ARTIKEL` SET `WEBADRESSE` = '-1' WHERE (ISNULL(`WEBADRESSE`) OR `WEBADRESSE` LIKE ''); UPDATE `ARTIKEL` SET `WEBADRESSE` = NULL WHERE `WEBADRESSE` LIKE '-2';”
  • changes to TS config in static/setup.txt: moved former setting config.tx_ptgsashop.displayCartArticleLinks to plugin.tx_ptgsashop_pi1.displayCartArticleLinks now; added new typolink configuration option config.tx_ptgsashop.articleSingleViewTypoLink for links to article single view
• revision of payment handling: Constant Editor category PT_GSASHOP::PAYMENT - changed defaults and renamed TS options (please refer to the appropriate Constant Editor descriptions for details):
  • renamed former option “enableCCpayment” to “enableSimpleCcPaymentChoice” and changed it's default value from 1 to 0 (since pt_heidelpay is no dependency anymore),
  • renamed former option “useGsaPaymentChoice” to “enableExtendedPaymentChoice” and changed it's default value from 0 to 1
  • **IMPORTANT** : adapt any individual TS setup using the mentioned options, set “enableSimpleCcPaymentChoice” to your previous entry for “enableCCpayment” and set “enableExtendedPaymentChoice” to your previous entry for “useGsaPaymentChoice”
• revision of email handling for order confirmations and payment results (refer to the appropriate Constant Editor descriptions for details):
  • Constant Editor category PT_GSASHOP::GENERAL: added new config options “orderConfirmationEmailBcc” and “orderConfirmationEmailReplyTo”, made option “orderEmailRecipient” optional, revised CE email options descriptions;
  • CE category PT_GSASHOP::PAYMENT: removed option “sendEpaymentResultEmail”, added new option “epaymentResultRecipient” instead
  • **IMPORTANT** : please add your former email address entry at option “orderEmailRecipient” to the new option “epaymentResultRecipient”, adapt any individual TS setup using the mentioned options and check your email configuration in the mentioned CE categories after updating!
• revision of page/sysfolder settings in TS configuration (Constant Editor category PT_GSASHOP::PAGES):
  • all pages and sysfolder settings now allow a PID or an alias;
  • added new option “orderStoragePid” to store shop orders in a sysfolder different from the order page; added default aliases for former PID- only settings
• corrected behaviour of TS config options "enableXssSecurityForArticleText" and "enableRteForArticleText" in article display (pi2/article lists) according to their CE descriptions: RTE content is now devaluated as well if both configs are set to 1
• removed the admin restriction for the “GSA Cache” module – it is now available for non-admin users as well
• tx_ptgsashop_orderPresentator: removed TSFE dependency of class constructor, added new method getMarkerArray()
• added new TS config parameters “shopOperatorBankName”, “shopOperatorBankCode”, “shopOperatorBankAccountNo”, “shopOperatorBankBic”, “shopOperatorBankIban” to Constant Editor category PT_GSASHOP::PAYMENT and TS setup config.tx_ptgsashop. - added new parameters to template marker array of tx_ptgsashop_orderPresentator::getMarkerArray()
• added article userfields (“Freifelder” in GSA-Admin or ERP-GUI) to template marker array of tx_ptgsashop_pi2::getMarkerArrayFromArticle()
• added new Hook “processOrderSubmission_alternativeOrderConfirmPage” in tx_ptgsashop_pi3::processOrderSubmission()
• changed extension status to “beta”
• major revision and extension of this manual, re-written chapter “Example shop setup: Overview of pages & plugins”
• miscellaneous minor internal improvements

v0.11.0¶

• GSA Shop is -combined with some other extensions- available as a TYPO3 standalone version now (disengagement of the ERP software): extended tx_ptgsashop_taxAccessor for usage with new extension pt_gsaadmin, extended and adapted this manual for the TYPO3 standalone version
• renamed all “display_*”settings to “articleDisplay*” in Constant Editor/TS configuration options, in articlebox template markers and in template /smarty_tpl/articlebox.tpl.html. **IMPORTANT** : please adapt your TypoScript template (if you've used the “display_*” settings) & your cartbox HTML template accordingly
• default template for final order email converted to UTF8 and renamed to res/smarty_tpl/finalorder_utf8.tpl.txt; new Constant Editor/TS configuration option “templateCharsetFinalOrderMail”; adapted charset handling in tx_ptgsashop_pi3::sendFinalOrderEmail()
• fixed bug for backend article search in list view and TBE popup window of pi2's article selection
• fixed bug for “return to last order page” link: stored value is not overwritten anymore in article single view now
• fixed bug for article relations/required articles: shop stays on cart page now after pressing the special required article order button (if configured accordingly in Constant Editor option “addToCartAction”)
• improvement of PHP's date_default_timezone_set() handling in all plugins (previous value is stored & re-set on execution end now)
• order button for article view now configurable in pi2's backend flexform
• Constant Editor cleanup: new categories 'pages', 'payment', 'cartbox' and 'article display', new order and category sorting for configuration options, changed data type for all “img*” options from type file to type string, correction of labels and descriptions
• changes to Constant Editor/TS configuration options: new option “sendEpaymentResultEmail” (for pi6), changed defaults for “feUserRegPage” and “userAccountPage”
• added additional optional net/gross template markers (independent from default pt_gsashop templates) for article view (tx_ptgsashop_pi2::getMarkerArrayFromArticle()), cart (tx_ptgsashop_pi1::displayShoppingCart()) and order overview (tx_ptgsashop_pi3::displayOrderOverview())
• extended “displayArticleInfobox_MarkerArrayHook” hook in with 3rd parameter (in tx_ptgsashop_pi2::getMarkerArrayFromArticle())
• changed visibility of miscellaneous object properties and methods from “private” to “protected” for better support of OOP inherintance
• general cleanup: removed all doc/px_*.sql files (partially moved to extension pt_gsasocket), moved all extension icons to res/img/, removed obsolete file class.tx_ptgsashop_tt_content_tx_ptgsashop_article_uid.php
• minor improvements, TCA corrections (incl. bugfix for field “tx_ptgsashop_amendmentlog”), standardization of locallang labels and source code comment cleanup

v0.10.0¶

• backend configuration of plugin “Article Display” (pi2) extended and changed to flexform **IMPORTANT** : choose 'pt_gsashop' in the TYPO3 extension manager and use the “UPDATE!” option in the upper right selectorbox to convert your existing installation to flexform; the defaults are configurable via Typoscript now
• plugin “Article Single View” (pi5) removed – functionality now integrated in plugin “Article Display” (pi2): pi2 inserted without any article selected works as “Article Single View” now (template articlebox.tpl.html now set as default for TS templateFileArticleSingleView, too)
• new backend module “Tools->GSA Cache” implemented – this should be used by the admin once the articles have been imported/entered into the GSA DB: create a new sysfolder “GSA Article Cache”, enter this sysfolder's PID in Constant Editor of your pt_gsashop template (“Article cache storage PID“), clear the TYPO3 cache and hit the “Tools->GSA Cache” button
• backend article choice of plugin “Article Display” (pi2) now works with a “Element Browser” popup wizard (instead of former selectorbox) to improve usability for large article amounts; the wizard requires the article cache to be filled using the “GSA Cache” module (s. above)
• overhaul of the authentication concept – pt_gsauserauth dependency removed, authentication checks implemented in pt_gsashop now
• plugin “Article Display” (pi2) is enabled to render RTE content and to display price scales now (appropriate Constant Editor/TS config required for both new features), article linking to the “Article Single View” page is now enabled by default
• handling and display of article images implemented (BE module ext. pt_gsaadmin needed to add images to articles); the usage of the former database internal image storage of GSA is deprecated now
• overhaul of the address handling in orders and deliveries: deleted or deprecated addresses from orders opened from the archive will be replaced by the appropriate default address of the user now, API changes (method parameters) for tx_ptgsashop_address::__construct() and tx_ptgsashop_delivery::updateDelivery()
• general cleanup: converted all locallang-files from php to xml, removed dispensable “insert content element” wizards for all all plugins except for pi2/”Article display” (other plugins have to be inserted using the “General Plugin” option in the TYPO3 backend now)
• new extension category “General Shop Applications” created for bundled display of all extension of the “pt_gsa* family” in TYPO3's Extension Manager
• miscellaneous internal enhancements, new hooks etc.

v0.9.7 (not published in TER)¶

miscellaneous internal enhancements, especially for usage in combination with the new backend modules extension pt_gsadmin

v0.9.6¶

• automatic invoice booking in ERP activated by default (new TS/Constant Editor config option “useAutomaticInvoiceBooking”)
• reorganization of the article structure to use a scale price collection now
• bugfixes for article fixed costs incl. harmonisation of fixed cost handling with GSA's way to handle this (always net)
• enhancements in article and tax classes for usage with the upcoming backend data administration extension "pt_gsaadmin"
• minor code improvements, overhaul of inline doc comments for IDE code completion usage

v0.9.5¶

• overhaul of the GSA DB storage of shop order confirmations and invoices (massive changes to the gsaTransaction* classes) for seamless integration into GSA ERP: allows to make credit notes for shop orders now etc.
• fixed bank account holder name bug for automatically created DTA records

v0.9.4¶

• internal change of processing 4 decimal places including the complete conversion of all float calculations to BCMath functions - **IMPORTANT** : This requires PHP to be configured with '--enable-bcmath' (see www.php.net/bc)
• improvements and bugfixes of order storage in TYPO3 DB, article fixed costs, tax calculation, workflow and GSA invoice creation
• new TS/Constant Editor config options: usePricesWithMoreThanTwoDecimals, gsaCreateDeliveryReceipt
• tx_ptgsashop_pi3::processOrderOverview(): new Hook processOrderOverview_checkoutHook
• update of this manual, format changes due to faulty online display in TER

v0.9.3¶

• complete revision of the workflow engine (new engline logic for automaticadvance handling, enhanced configuration possibilities for workflow status, massive code improvements for plugin pi4, enhanced workflow list view, localisation for workflow status labels etc.)
• fixed costs for articles implemented (one-time/non-recurring fixed costs for an article independently of its ordered quantity)
• supplier control for article purchases implemented (requires the DB table 'pt_gsashop_supplierControl' to be existent in the GSA DB)
• improvements and bugfixes of GSA transaction handling and of the article factory class
• Miscellaneous changes and enhancements, including changed TYPO3 database structure (the 'UNIQUE key(s) on 'status_code' of an eventually existing database table 'tx_ptgsashop_workflow' have to be deleted manually!)

v0.9.2¶

• revision and extension of GSA transaction (“Vorgang”) handling (new classes tx_ptgsashop_gsaTransactionAccessor, tx_ptgsashop_gsaTransactionHandler), new invoice booking methods including German DTA
• Plugin pi4 changed to a configurabe flexform plugin: allows different workflow views on multiple pages now
• Miscellaneous changes and enhancements (XHTML fixes, new pi1 hook, enhanced handling of applSpecDataObjects, conversion of GSA Paradox database tables, enhanced articles and article storage, workflow improvements, resource classes locallang etc.)

v0.9.1¶

• integration of new pt_heidelpay ext. version including changed API and WPF-Interface (ePayment popup window provided by Heidelpay)
• complete revision and improvements of workflow engine (including automatic order archive database updates and replacement of general workflow config 'workflowDynamicOrder' with individual update config for each workflow status)
• GSA-based special customer related special prices implemented (GSA: “kundenspezifische Preise”)
• miscellaneous internal changes, improvements and bugfixes (especially database error after credit card payment)

EXT: GSA Shop - 35