.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =============== EXT: WebGrabber =============== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Christoph Möller :Changed: 2003-02-17T13:30:32 :Author: Christoph Moeller :Email: chris@byters.de :Info 3: :Info 4: .. _EXT-WebGrabber: EXT: WebGrabber =============== Extension Key: **cm\_webgrab** Copyright 2000-2002, Christoph Moeller, 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: WebGrabber 1** **Introduction 1** What does it do? 1 Screenshots 1 **Users manual 2** FAQ 2 **Adminstration 2** FAQ 2 **Configuration 3** FAQ 3 Reference 3 **Tutorial 3** **Known problems 4** **To-Do list 4** **Changelog 4** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ WebGrabber is a small “proof of concept” extension that can be used to include external content into a regular T3 page. At its current state, it can be successfully used to include any external static content or dynamic scripts that don't make use of FORMs. It makes use of a GPL'ed PHP script named webGrab by Michael Brauchl (available at `http://www.phpcms.de `_ ). The WebGrabber extension is built as a frontend plugin and it is partly configurable via TS SETUP. As stated above, this is a proof of concept that needs some more work – for example, it doesn't yet work really well with HTML
fields. If you have any further ideas concerning this extension, feel free to email me at `chris@byters.de `_ . .. _Screenshots: Screenshots ^^^^^^^^^^^ Sorry, not yet! .. _Users-manual: Users manual ------------ This extension is not meant to be “used” in a classic way – it's supposed to include external content with its own useability and interface design. .. _FAQ: FAQ ^^^ Not yet :-) .. _Adminstration: Adminstration ------------- This extension is not meant to be administered in any way – it's supposed to just work ;) .. _FAQ: FAQ ^^^ Not yet :-) .. _Configuration: Configuration ------------- See below at the “Reference” and “Tutorial” sections! .. _FAQ: FAQ ^^^ Not yet :-) .. _Reference: Reference ^^^^^^^^^ **SETUP:** .. ### BEGIN~OF~TABLE ### .. _t3-root: t3\_root """""""" .. container:: table-row Property t3\_root Data type string Description The main absolute URL path of your Typo3 installation – **no trailing slash!** **Example:** if your page is accessible at `http://www.you.tld/your\_t3\_root\_utl `_ , put: :: plugin.tx_cmwebgrab_pi1.t3_root = /your_t3_root_url Default .. _webgrab-path: webgrab\_path """"""""""""" .. container:: table-row Property webgrab\_path Data type string Description The full URL of the script to be included. **Example:** You want to include `http://www.you.tld/some\_script/index.php `_ , then put: :: plugin.tx_cmwebgrab_pi1.webgrab_path = http://www.you.tld/some_script/index.php Default .. _wg-path: wg\_path """""""" .. container:: table-row Property wg\_path Data type string Description The full URL of the helper script wg.php. **Example:** You want to include `http://www.you.tld/some\_script/ `_ , then put wg.php into this directory on the webserver and add this SETUP line: :: plugin.tx_cmwebgrab_pi1.wg_path = http://www.you.tld/some_script/wg.php Default .. ###### END~OF~TABLE ###### .. _generated: ((generated)) """"""""""""" .. _Example: Example ~~~~~~~ Put this into your template's SETUP field: :: # cm_webgrab # short HOWTO: # -> put included webgrab/wg.php to the main dir of the script to be included # -> change $webgrab_path in wg.php to suit your full absolute path to webgrab_typo3.php # -> put included webgrab/wg_config.php to the main dir of the script to be included # -> change all appropriate settings in wg_config.php (parsing strings, etc.) - see documentation! # -> change the settings below to suit your needs # -> add a new content element on any T3 page of type "Insert Plugin", choose plugin "WebGrabber" # -> save, view and test your page :-) # # see included documentation for more info! # t3_root: root URL path to this T3 site - no trailing slash... plugin.tx_cmwebgrab_pi1.t3_root = /your_t3_root_url # webgrab_path: what to grab... plugin.tx_cmwebgrab_pi1.webgrab_path = http://your.host.tld/script_path/mainpage.php # wg_path: where is wg.php installed... plugin.tx_cmwebgrab_pi1.wg_path = http://your.host.tld/script_path/wg.php .. _Tutorial: Tutorial -------- This is just a short “walk-through” on how to configure this extension: - have a look inside the files included in your typo3conf/ext/cm\_webgrab/ directory!! - put included webgrab/wg.php to the main dir of the script to be included - change $webgrab\_path in wg.php to suit your full absolute path to webgrab\_typo3.php - put included webgrab/wg\_config.php to the main dir of the script to be included - change all appropriate settings in wg\_config.php (parsing strings, etc.) - see documentation in the file or on its author's homepage ( `http://www.phpcms.de `_ )! - change the settings below to suit your needs - add a new content element on any T3 page of type "Insert Plugin", choose plugin "WebGrabber" - save, view and test your page :-) .. _Known-problems: Known problems -------------- - Some variable passing between Typo3, this plugin and the external scripts included on our pages doesn't work yet.For example, HTML-FORMS are not working the way they should. I didn't have the time to investigate any further why. I suppose the included webgrab\_typo3.php file needs some more tweaking (make use of more HIDDEN form fields to get variables passed, etc.). Feel free to add in your dev-power ;) - At the time of this writing, there is no way known to me to include more than one instance of this plugin. .. _To-Do-list: To-Do list ---------- - add full support for HTML-FORMS, hidden-field transfer - better configuration options via TS - add the ability to run this extension more than once - much more testing!! .. _Changelog: Changelog --------- **0.0.1:** first available public version. I need feedback on how/if it works at all with your installation! Please email me at `chris@byters.de `_ . |img-1| EXT: WebGrabber - 4 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102