https://github.com/in2code-de/fetchurl
Extension fetchurl for TYPO3: Fetch and display remote content in a TYPO3 instance, via iframe or inline
https://github.com/in2code-de/fetchurl
contentreplace iframe typo3 typo3-cms-extension
Last synced: about 1 year ago
JSON representation
Extension fetchurl for TYPO3: Fetch and display remote content in a TYPO3 instance, via iframe or inline
- Host: GitHub
- URL: https://github.com/in2code-de/fetchurl
- Owner: in2code-de
- Created: 2016-05-23T16:12:20.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2025-02-17T14:56:12.000Z (over 1 year ago)
- Last Synced: 2025-04-24T01:16:16.779Z (about 1 year ago)
- Topics: contentreplace, iframe, typo3, typo3-cms-extension
- Language: PHP
- Homepage:
- Size: 506 KB
- Stars: 2
- Watchers: 10
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TYPO3 Extension fetchurl
## Purpose
The task of this extension is to fetch an URL from the internet and display it on a website.
## Features
* The fetched URLs can be display inline or as an iframe.
* If the URLs is displayed in an iframe, it is possible to activate an "IFrame-Switch" to ensure privacy
## Installation
### via composer
`composer require in2code/fetchurl`
### via the TYPO3 Extension Manager
* go to the TYPO3 Module "Admin Tools" => "Extensions"
* search for "fetchurl"
* import and activate the extension
or
* download the extension from https://extensions.typo3.org/extension/fetchurl
* go to the TYPO3 Module "Admin Tools" => "Extensions"
* upload the extension (if it's already installed, set the checkmark for "overwrite")
* activate the extension
## Configuration
### Templating
Copy the folder contents from EXT:fetchurl/Resources/Private/Templates/ to any location and set the new path via
TypoScript setup:
```
plugin.tx_fetchurl {
view {
templateRootPaths.1 = EXT:myextension/Resources/Private/Templates/Fetchurl/
}
}
```
### Activate Features
Activate the iframe switch and link to your privacy page
```
plugin.tx_fetchurl_pi1 {
settings {
useIframeSwitch = 1 // <- default is "1"
pidPrivacy = 8945 // replace with your own pid
}
}
```
### Append additional parameters
It is possible to attach additional parameters to all requests of EXT:fetchurl.\
This is done with the TypoScript keys "**additionalParameter.static**" and "**additionalParameter.iframe**".
Existing parameters and the original fragment are kept.
```
plugin.tx_fetchurl_pi1 {
settings {
additionalParameter {
static {
# a static value
foo = bar
# value with TypoScript stdWrap
foo2 = TEXT
foo2.value = bar2
}
iframe {
# a static value
foo = bar
# value with TypoScript stdWrap
foo2 = TEXT
foo2.value = bar2
}
}
}
}
```
**Note:**
If a parameter is specified in the url and also set by TypoScript, the value in the original url is overwritten and the
value from TypoScript is used.
See the example below (for `parameterName=parameterValue`):
| flexform url | final url |
|---------------------------------------------------|--------------------------------------------------------------|
| https://example.com/ | https://example.com/?parameterName=parameterValue |
| https://example.com/#c123 | https://example.com/?parameterName=parameterValue#c123 |
| https://example.com/?id=12#c123 | https://example.com/?id=12¶meterName=parameterValue#c123 |
| https://example.com/?id=12¶meterName=abc#c123 | https://example.com/?id=12¶meterName=parameterValue#c123 |
## Events
| Signal class name | Event name | information |
|------------------------------------------------|---------------------|-------------------------------------------------------|
| \In2code\Fetchurl\Domain\Service\FetchService | AfterUrlBuildEvent | after the protocol and additional parameter are added |
| \In2code\Fetchurl\Domain\Service\FetchService | AfterHtmlFetchEvent | after the content fetched |
| \In2code\Fetchurl\Domain\Service\IframeService | AfterUrlBuildEvent | after the protocol and additional parameter are added |
## Screenshots
Frontend example:
Plugin for editors in backend:
Example for a privacy save 2-click-solution:
## Changelog
| Version | Date | State | Description |
|---------|------------|---------|-----------------------------------------------------------------------------------------------------------------------|
| 6.0.0 | 2025-02-17 | Feature | Support TYPO3 13 / 12 and drop 11 support |
| 5.0.3 | 2023-11-26 | Bugfix | Tiny bugfix |
| 5.0.2 | 2023-11-25 | Bugfix | Fix GH action for TER release |
| 5.0.1 | 2023-11-25 | Bugfix | two tiny bugfixes |
| 5.0.0 | 2023-07-07 | Feature | TYPO3 V12 compatibility, switchable controller actions to CTypes, upgrade wizards added, replaced signals with events |
| 4.5.2 | 2021-03-17 | Bugfix | Add extension key to composer.json, small development updates |
| 4.5.1 | 2021-03-05 | Bugfix | Adjust composer.json |
| 4.5.0 | 2021-03-05 | Feature | Support TYPO3 11 |
| 4.4.2 | 2021-03-04 | Task | First TER release by @in2code-de |
| 4.4.1 | 2021-02-22 | Bugfix | Allow urls starting with "//" |
| 4.4.0 | 2020-08-19 | Task | Don't add empty values to additionalparameters |
| 4.3.0 | 2020-08-18 | Feature | Allow typoscript stdwrap for additionalparameters |
| 4.2.0 | 2020-08-13 | Feature | Add typoscript option to add additional parameter to the flexform url, add "afterUrlBuild" signals |
| 4.1.1 | 2020-08-13 | Bugfix | Replace signalSlogDispatcher phpDoc injection with method injection |
| 4.1.0 | 2020-04-24 | Feature | Declare extension compatible with TYPO3 V10 |
| 4.0.2 | 2020-03-10 | Bugfix | Remove sandbox-attribute of the iframe |
| 4.0.1 | 2020-03-02 | Bugfix | Fix small typo in template file |
| 4.0.0 | 2020-02-27 | Feature | Add a 2-click solution for iframes |
| 3.5.0 | 2019-07-29 | Task | Use subtree split in composer for TYPO3 core |
| 3.4.0 | 2017-02-18 | !!!Task | Small refactoring, allow url without protocol |
| 3.3.1 | 2017-02-16 | Bugfix | Show additional fields if plugin mode == iframe |
| 3.3.0 | 2017-02-01 | Feature | Set iFrame width and scrollbars in FlexForm |
| 3.2.0 | 2017-02-01 | Feature | Set iFrame height in FlexForm |
| 3.1.0 | 2016-12-22 | Task | Remove refactor ext_tables.php for T3 8.5 and newer |
| 3.0.2 | 2016-12-02 | Bugfix | Remove version from composer.json |
| 3.0.1 | 2016-12-02 | Bugfix | Hide not needed tt_content fields |
| 3.0.0 | 2016-11-28 | Task | Add iframe feature |
| 2.0.0 | 2016-05-23 | Initial | Initial release of the fork of typo3-ter/fetch-url |