LumoNet PHP Include¶

What does it do?¶

This extension lets 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 call a script written in any language on a remote server via a real HTTP request.

LumoNet PHP Include collects all data sent to the page where the plugin is used and transfers it to the called script (this only applies to remote calls as local scripts are just included ans thus have access to all GET, POST and other server data anyway). The user can choose to have GET data transferred to the called remote script (the transfer of POST data, cookies and even the handling of file uploads will be realized in future versions).

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¶

This extensions does not rely on other extensions.

Installation¶

No special installation process is required, just use the normal way via the TYPO3 extension manager.

Integration of the Plugin¶

Add a new content element of type plugin „PHP Include“ to the desired page.

Choose the type of included script, enter the URL or select/upload a local file and set the desired parameters.If you call a remote script, you might want to check the „Strip non-body parts“ marker to get a valid HTML result page.If you even have markers set in the script, you can use the „Strip content outside markers“ option along with the input field labeled „Marker for stripping“. The marker must be of the form<!-- MARKER --> (Info: This marker is not related in any way to the commonly used markes in extension or page templates!)

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. The class of the div tag istx_lumophpinclude_<MD5 hash of included file name>

Call the page in the frontend and check the results.

Explanation of processing options¶

The following processing options are available for all types of included scripts:

• Strip non-body parts : Remove everything outside the body tag (including the tag itself) from the fetched script result
• Strip content outside markers : Strip everything outside the set markers from the fetched script result
• Marker for stripping : Marker for stripping; must be of the form<!-- MARKER -->
• Wrap output into div : have another div tag wrapped around the content to apply additional CSS directives on it. The class of the div tag istx_lumophpinclude_<MD5 hash of included file name>

The following options are only available for remote scripts:

• Rewrite internal links : Change the URL of internal links (i.e. links whose URL does not have a host specified) to point to the same TYPO3 page; the new URL is the added as the URL parametertx_lumophpinclude_url; this way, you can include a whole website.
• Rewrite local resources (e.g. of images) : Change the URL of all „src“ attriubutes in the fetched script result to point to the original server to have images displayed correctly though the HTML is displayed on your own page