DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

LumoNet PHP Include

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Thomas Off
Changed:2006-04-25T14:15:39
Author:Thomas Off, LumoNet oHG

LumoNet PHP Include

Extension Key: lumophpinclude

Copyright 2005, 2006, Thomas Off, LumoNet oHG, <Thomas Off, LumoNet oHG>

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

Content

Introduction 1

What does it do? 1

Requirements 1

Installation 1

Screenshot 2

Usage 2

Intergration of the Plugin 2

Known Bugs 3

ToDo 3

Changelog 3

Introduction

What does it do?

This extension let you include complete external PHP solutions (e.g. message boards or image galleries) into TYPO3. With this extension you are able to select a local PHP script as well as a PHP script that resides on an external server via URL.LumoNet PHP Include collects all data sent to the page where the plugin is used and transfers it to the called script. The user can choose to make POST and GET available as well as cookie data (e.g. to empower the called application to use authentication mechanisms based on cookies). Local script can access this data via three arrays $postvars, $getvarsand $cookievars. For remote scripts all parameters are added to the URL of the script before calling it.

LumoNet PHP Include also provides the ability to strip the resulting content of a called remote app so one can use the PHP app stand-alone as well as integrated in a Typo3 website.

Requirements

none

Installation

No special installation is required.

For the inclusion of remote PHP scripts it is required, that the PHP installation on your server allows URLs to be opened with fopen and similar functions. This means you have to make sure, that there's a line in your php.ini file that reads

allow_url_fopen = On

Otherwise remote inclusion of PHP scripts via HTTP won't work.

Screenshot

img-1

Usage

Intergration of the Plugin

Create an ordinary page.

Add a content element „PHP Include“ to this page.

Now you can choose the type what kind of parameters the plugin collects the data. Spimply check the provided fields.

Choose the type of the script to include ether if it's in the local filesystem or an external URL.

Dependend on what you have chosen in step 4 you can now select a local file via the fileadmin or the URL or a remote PHP script.

If you include a script that returns a full HTML page, you can set „Strip non-body parts“ and have only displayed everything between opening and closing body tag.

If only a part of the called remote PHP script should be included use the two marker-fields to set the start-marker and the end-marker to do this. In the resulting content the marker mus be set as<!-- MARKER --> (Info: These markers do have nothing in common with the TYPO3 markers!)

To adjust the display of the included code you can use „Wrap output with div“ and have another div tag wrapped around the content to apply additional CSS directives on it.

You can also replace the marker ###PID### with the actual page id to make forms work again.

Known Bugs

No bugs known so far.

ToDo

Nothing to do for now.

Changelog

2006-04-24

Fixed erroneus behaviour when including locaL files (thanks to Peter Klein <peter@umloud.dk>

Uses XML instead of PHP files for language string now

Added options to strip non-body parts and wrap script's output with div

Updated documentation

2005-12-23

Initial release.

img-2 LumoNet PHP Include - 3