Description
Features
Include URL is a WordPress plugin for seamless inclusion of data from remote urls, optionaly passing GET parameters to it..
- Get remote url content
- Pass given GET params to url
- Cache fetched content localy in WordPress DB (for extremely slow sources)
Usage
[include-url href="<URL>" params="param1,param2,param3..." timeout="seconds" cache="seconds" allow-file="1" allow-shortcode="1"]
- href – url starting with https:// or https:// (required)
- params – list of comma separated GET parameters, that should be passed to include url
- timeout – request timeout in seconds
- cache – cache request data localy in wordpress database (default = 0 seconds / disabled)
- allow-file – allow file:// urls in href (default = 0 / disabled, 1 = prepend file with document root, 2 = use absolute path)
- allow-other – allow any other protocol supported by cURL
- allow-shortcode – allow and process wordpress shortcodes in included content
Examples
-
Search frontend page for SOLR
[include-url href=”https://localhost:8080/solr/core1/select?wt=xslt&wt=results.xslt” params=”q,fq” cache=”1800″]
This requests data from local SOLR instance, that will return search results formated as HTML (ie. table) via its XSLT handler, optionally passing q (query) and fq (filter) params to it. Data will be cached for 1800 seconds in WordPress database.
-
Read file from document_root
[include-url href=”file://robots.txt” allow-file=”1″]
-
Read file specified by absolute path
[include-url href=”file:///var/www/html/robots.txt” allow-file=”2″]
Installation
- Make sure you are using WordPress 4.0 or later and that your server is running PHP 5.2.4 or later (same requirement as WordPress itself)
- Install and activate the plugin as usual from the ‘Plugins’ menu in WordPress.
- Use shortcode in page or post
Contributors & Developers
“Include URL” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Include URL” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.3.5 (2020-07-28)
- Fix some undefined warnings and add timeout to file_get_contents() call (Thanks Marco Baumgartl for reporting it)
0.3.4 (2019-05-22)
- Improve shortcode attributes processing
0.3.2 (2018-05-17)
- Add allow-shortcode option
0.3.1 (2017-04-03)
- Fix cached content processing
0.3.0 (2016-12-15)
- Allow file:// urls if allow-file=”1″ or allow-file=”2″ param is given
- Allow all cURL protocols if allow-other=”1″ param is given
0.2.1 (2016-08-26)
- Restrict urls to https:// and https://
0.2.0 (2016-08-25)
- Initial release