PHPackages subugoe/xmlinclude - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. subugoe/xmlinclude ActiveTypo3-cms-extension subugoe/xmlinclude ================== Loads, transforms and includes XML in TYPO3 3.0.0(8y ago)23222[1 PRs](https://github.com/subugoe/typo3-xmlinclude/pulls)GPL-2.0-or-laterHTML Since May 9Pushed 6y ago9 watchersCompare [ Source](https://github.com/subugoe/typo3-xmlinclude)[ Packagist](https://packagist.org/packages/subugoe/xmlinclude)[ RSS](/packages/subugoe-xmlinclude/feed)WikiDiscussions master Synced 2mo ago READMEChangelogDependenciesVersions (4)Used By (0) xmlinclude TYPO3 extension ========================== [](#xmlinclude-typo3-extension) A TYPO3 extension for loading and transforming XML that is inserted into a content element. 2012-2013 by [Sven-S. Porst](http://earthlingsoft.net/ssp/), [SUB Göttingen](http://www.sub.uni-goettingen.de)<[porst@sub.uni-goettingen.de](mailto:porst@sub.uni-goettingen.de?subject=xmlinclude%20TYPO3%20Extension)> If you have questions or remarks please send in comments or contribute improvements. You can fork the extension’s [repository at github](https://github.com/subugoe/xmlinclude). Requirements ------------ [](#requirements) To run this extension you need: - TYPO3 ≥ 6.2.0 Description ----------- [](#description) This extension enables inclusion of remote XML content into TYPO3 content elements. It does so in a 3 step process: ### 1. Fetch the data [](#1-fetch-the-data) The base URL data is fetched from can be set in the Plug-In’s FlexForm. The URL given there can be changed in two ways: 1. a path given in the tx\_xmlinclude\_xmlinclude\[URL\] parameter will be appended to the base URL; when [used with RealURL](#realurl) this can be appended to the page’s path 2. parameters set in the `plugin.tx_xmlinclude.settings.URLParameters`TypoScript array will be merged into the existing parameters of the URL By default fetching the file will fail if it cannot be parsed as XML. In case you want to fetch non-XML files like broken HTML, or JSON you can [configure](#configuration) a more lenient or different parsing mode. When a blank no URL is given, no data is loaded and XSL processing is started with a document containing just a »xmlinclude-root« node. ### 2. Transform the XML [](#2-transform-the-xml) After reading and parsing the data, it can be transformed by XSL stylesheets. Paths to those stylesheets are set in the `plugin.tx_xmlinclude.settings.XSL` TypoScript array. Stylesheets will be applied in the order of the keys in the array. A scenario this works well for is the following: given an XHTML webpage you can supply a stylesheet which extracts the content you are interested in and removes the rest. Then you can apply another stylesheet which transforms the links inside the XHTML to links pointing to your TYPO3 page. This lets you include other web resources in the design and context of your web site. A facility to parse additional XML which may be entered by the user in a form field is provided as an XSL function. It is called like `php:function('XmlUtility::parseXML', string($xml-string))` ### 3. Insert the transformed XML into the web page [](#3-insert-the-transformed-xml-into-the-web-page) The xmlinclude content element creates a `div.xmlinclude` and puts the transformed XML in there. In case there were errors during the conversion `h4.error` and `p.error` elements are inserted at the beginning of that div to indicate the problem. Usage ----- [](#usage) - Include the »Include XML« content element in your page - Set the start URL for your page - Add the »xmlinclude Settings« template to your page - (if necessary) adjust the TypoScript settings for XSL conversion, CSS or JavaScript Configuration ------------- [](#configuration) A number of settings can be adjusted with TypoScript values inside `plugin.tx_xmlinclude.settings`: - `parser` \[`xml`\]: The parse type used. Allowed settings are `xml` for proper XML parsing, `html` for unreliable HTML parsing which tolerates errors and `json` for JSON parsing followed by conversion to an XML document. - `XSL`\[`{50 = EXT:xmlinclude/Resources/Private/XSL/rewrite-urls.xsl}`\]: Array of paths of stylesheets that are applied to the downloaded XML. See below for a description of the stylesheet used in the default setting. All values set in TypoScript will be passed to the stylesheet as XSL parameters. - `URLParameters` \[`{}`\]: Array of parameters that are added to the request URL. For example you could set `plugin.tx_xmlinclude.settings.URLParameters.format = XML` if the service you are reading needs a format=XML parameter that to deliver XML format. - `headCSS` \[`{}`\]: Array of paths or URLs of CSS files that should be included in the page’s head using style tags. - `headJavaScript` \[`{}`\]: Array of paths or URLs of stylesheets that should be included in the page’s head using script tags. - `rewriteOnClass` \[`rewrite-on`\]: String with a class name used in the default stylesheet to detect a tags whose links must be rewritten. - `rewriteOffClass` \[`rewrite-off`\]: String with a class name used by the default stylesheet to detect a tags whose links must not be rewritten. - `cookiePassthrough` \[`{}`\]: List of strings. Cookies with those names are passed between the connection to load the XML file and the connection to the browser. - `cookiePath` \[`.`\]: String. If `.` the current TYPO3 page’s path is used for the cookie. If set to a string, that string is used for the cookie path. - `useRealURL` \[`0`\]: Use RealURL to pass URLs to the extension. Read the section on RealURL for further instructions. The default stylesheet rewrite-urls.xsl --------------------------------------- [](#the-default-stylesheet-rewrite-urlsxsl) The rewrite-urls.xsl stylesheet is included in the XSL processing by default. It expects to find XHTML (with the namespace) or non-namespaced content in the XML it receives and will rewrite the URLs for `a`, `form`, `img`, `script` and `link`tags in various ways: - URLs for `a` and `form` tags: - are rewritten to go through TYPO3 if they are - without a `target` attribute AND - not marked with the class name set in the `rewriteOffClass`TypoScript variable \[defaults to `rewrite-on`\] AND - relative links OR http(s) links whose host name is the same as our target site’s - are *not* rewritten to go through TYPO3 if they - do not satisfy the conditions above OR - are marked with the class set in the `rewriteOffClass`TypoScript variable \[defaults to `rewrite-off`\] - URLs in `img`, `link` and `script` tags are prepended with the content of the base URL to create absolute links. The baseURL is determined using the baseURL setting as well as the content of `html/head/base/@href`, in case it exists. XSL Parameters -------------- [](#xsl-parameters) A number of parameters are passed to each XSL that is called by default: - `argument-*`: arguments passed to the xmlinclude extension with name where `*` is a dash separated list of the key hierarchy (e.g. `tx_xmlinclude_xmlinclude[formParameters][xml]` is passed as `argument-formParameters-xml`) - `setting-*`: TypoScript settings in `plugin.tx_xmlinclude.settings.` where `*` is a dash separated list of the key hierarchy - `fullPageURL`: the full URL of the page without parameters - `basePageURL`: the URL of current base page (RealURL corresponding to page ID) - `hostName`: the host name in the `basePageURL` - `sitePath`: full path to the site’s folder in the host’s file system (can be useful for loading external files from XSL) - custom: all parameters configured in `plugin.tx_xmlinclude.settings.XSLParameters` RealURL ------- [](#realurl) You can use RealURL to transparently include the path on the remote server into the URLs on your site. This is a bit unusual as we need to pass a full path through RealURL which usually splits up the path components. To deal with that, this setup will use *all* remaining path components and may cause problems if other extensions add their rewritten path components as well. To use RealURL support, first turn it on in TypoScript using: ``` plugin.tx_xmlinclude.settings.useRealURL = 1 ``` Then add the following array to the (or a relevant) `fixedPostVars`entry of your RealURL configuration (e.g. `$TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT']['fixedPostVars']`): ``` array ( 'xmlinclude' => array ( array( 'GETvar' => 'tx_xmlinclude_xmlinclude[URL]', 'userFunc' => 'EXT:xmlinclude/Classes/RealURL/tx_xmlinclude_realurl.php:&tx_xmlinclude_realurl->main' ) ), '2' => 'xmlinclude', ) ``` This creates a setup `xmlinclude` which is only used on page ID 2. Add further lines ``` '3' => 'xmlinclude', '73' => 'xmlinclude', … ``` to enable the same rewriting for page IDs 3, 73, …. Version History --------------- [](#version-history) 2.0.1 (2013-07-30):- fix bug in loading file:/// URLs 2.0.0 (2013-03-08):- support parsing JSON (convert it to XML) - output as HTML instead of XML - allow usage without loading external data, driven just by XSL - **replace the »parseAsHTML« TypoScript setting by »parser«**: this may break existing configurations - **re-name XSL parameters: prefix arguments with »argument-« and settings with »setting-«**: this may break existing stylesheets - pass full file system path to site as parameter - provide XML parsing as an XSL function - use Fluid for showing debug messages - add icon - convert documentation to ReST - add fake StarOffice manual file 1.2.0 (2012-11-21):- allow longer URLs in FlexForm - fix problem with erroneously inserted slashes in URL rewriting 1.1.0 (2012-09-24):- make cookie path configurable - improve RealURL support - fewer superfluous slashes after rewrite-urls.xsl - do not depend on the fed extension 1.0.0 (2012-05-02):- improve RealURL support - fix configuration - improve URLs - call it 1.0 0.9.3 (2012-03-12):- improve URL rewriting - include set up for RealURL 0.9.2 (2012-03-08):- add cookie handling - add form handling for GET and POST - work around encoding issues for HTML content 0.9.1 (2012-03-07):- iron out problems with HTML vs XML parsing 0.9.0 (2012-03-01):- initial beta License ------- [](#license) MIT License to keep the people happy who need it. Copyright (C) 2012-2013 by Sven-S. Porst Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. License for Array2XML.php class ------------------------------- [](#license-for-array2xmlphp-class) This extension includes the [Array2XML](http://www.lalit.org/lab/convert-php-array-to-xml-with-attributes/)PHP class by Lalit Patel. It is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0). ### Health Score 32 — LowBetter than 72% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community15 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 90.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~182 days Total 3 Last Release 2924d ago Major Versions 3.0.0 → 8.x-dev2018-05-08 ### Community Maintainers ![](https://www.gravatar.com/avatar/b66e7711b4ec5bfb6ae525e2d0d04a510afb69a7073aaee926087af21219897f?d=identicon)[ipf](/maintainers/ipf) --- Top Contributors [![ssp](https://avatars.githubusercontent.com/u/40549?v=4)](https://github.com/ssp "ssp (67 commits)")[![asajedi](https://avatars.githubusercontent.com/u/6713801?v=4)](https://github.com/asajedi "asajedi (4 commits)")[![ipf](https://avatars.githubusercontent.com/u/557076?v=4)](https://github.com/ipf "ipf (3 commits)") ### Embed Badge ![Health badge](/badges/subugoe-xmlinclude/health.svg) ``` [![Health](https://phpackages.com/badges/subugoe-xmlinclude/health.svg)](https://phpackages.com/packages/subugoe-xmlinclude) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)