.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ==================== EXT: paypal2commerce ==================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2009-04-05T20:31:55 :Author: Martin Holtz :Email: paypal2commerce@martinholtz.de :Info 3: :Info 4: .. _EXT-paypal2commerce: EXT: paypal2commerce ==================== Extension Key: **tx\_paypal2commerce** Copyright 2000-2002, Martin Holtz, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: paypal2commerce 1** **Introduction 1** What does it do? 1 Screenshots 1 **Users manual 1** **Adminstration 1** FAQ 2 **Configuration 2** FAQ 2 Reference 2 **Tutorial 3** **Known problems 3** **To-Do list 3** **Changelog 3** **Important guidelines 4** **Issues with Open Office documentation for TYPO3 4** Inserting images 4 Paragraph styles 4 Linking 5 Meta data and updates 5 .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension enables the payment-method with paypal. It use the paypal-express-checkout feature (implemented using the Name-Value Pair API) enable CURL – the server interacts with Paypal via CURL. Your customer will be send in the last checkout-step to the paypal- site, where he logs in and send you the money. After that, he will be redirected to your site. This extension was sponsored by `http://www.kennziffer.com `_ via bugs.typo3.org (http://bugs.typo3.org/view.php?id=5311) – thanks! Many enhancements were made by Marcus Krause. Initially developed by Martin Holtz `http://www.martinholtz.de/ `_ .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-1| Editing database field “classname” in table “tx\_commerce\_articles”: |img-2| Configuration of the extension. You have to put your paypal- account information in. You should test paypal via the paypal sandbox. ( `https://developer.paypal.com `_ ) You are able to select, which currency your shop should support. The “ **Payment error PID** ” defines the page-id where you customer should be redirected to, if there was an error. .. _Users-manual: Users manual ------------ Users should not change the paypal-article, because of the hidden “classname” field. .. _Adminstration: Adminstration ------------- You need an paypal-Payment-Article with an price (maybe 0 Euro). Then you have to set the database-field “classname” to “paypal” in the table “tx\_commerce\_articles”. If you install the extension you are should change some settings like your paypal-account. You should test your SHOP via `https://developer.paypal.com `_ first! **Your API-Key in the sandbox is different from the API-Key in your live-system** .. _FAQ: FAQ ^^^ - Error Message: MAIN:FATAL! No payment possible because I don't know how to handle it! (class not set!:, file not found!:)Create an article "Paypal", set a price for it (may be set it to 0). Now you have to edit the field "classname" of the "Paypal"-Article in "tx\_commerce\_articles" and set it to "paypal". - Empty Browserwindow/white page:You should check your curl-settings – there is an php-script “test\_curl.php” in the extension-directory. Please check, it that works – if not, you have to check your curl configuration. - Some other questions? Feel free to ask:) .. _Configuration: Configuration ------------- If config.baseURL is not set, t3lib\_div::getIndpEnv('TYPO3\_SITE\_URL') will be used. Maybe there could some curl-options configurated in future, if somebody needs, tell me. You have to enable CURL in Install-Tool too: [SYS][curlUse] = 1 .. _Tutorial: Tutorial -------- To be done. .. _Known-problems: Known problems -------------- - There is no address validation between paypal and commerce yet. - If the payment-amount of paypal is different to the actuall amount of the basket (btw. Via “hacking”), the checkout is stopped but the payment is not rejected at all. .. _To-Do-list: To-Do list ---------- - Writing an short tutorial - maybe: changing status of order? - Adding an percentage fee for paying with paypal - the paypal-login page could be customized - an address from paypal could be taken, instead of adding the address in commerce .. _Collobarate: Collobarate ----------- If you want to enhance this extension, or you have small or larger pieces for this documentation, feel free and join the project “paypal2commerce” on forge: `http://forge.typo3.org/projects/show /extension-paypal2commerce `_ Or you can fill up an issue on forge – but all development for this extension happens in my spare time – so perhaps you could join the project and do it yourself. .. _Changelog: Changelog --------- 09-04-05 Martin Holtz - Integrated Changes from Marcus Krause - Error-handling was added - requires PHP5 - code-refactoring - added currencies - delivery address from commerce is now shown in paypal 07-12-23 Martin Holtz \* Writing the manual \* if config.baseUrl is not set, t3lib\_div::getIndpEnv('TYPO3\_SITE\_URL') is be used \* some documentation inside the code 07-12-12 Martin Holtz \* Quick Security-Bug-Fix: the amount of the basket has to be the same, which is payed via paypal, otherwise the checkout is canceld (the payment not!) 07-06-05 Martin Holtz \* Wie should use &useraction=commit 07-06-04 Martin Holtz \* Get the URL via config.baseURL \* deleted some debug-Code \* corrected error in ext\_localconf.php 07-05-29 Martin Holtz \* Initial release |img-3| EXT: paypal2commerce - 4 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 125 .. :id: Grafik1 .. :name: Grafik1 .. :width: 669 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 448 .. :id: Grafik2 .. :name: Grafik2 .. :width: 669 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102