=== Include URL ===
Tags: include, url
Requires at least: 4.0
Tested up to: 4.7
Stable tag: 0.3.0
Contributors: SamSK
Donate link: https://devel.dob.sk/include-url
License: GPLv3 or later

Include URL allows to include any URL in posts or pages.

== 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"]`

* *href* - url starting with http:// or https:// (required)
* *params* - list of comma separated GET parameters, that should be passed to include url
* *timeout* - request timeout in seconds (honored only if CURL PHP extension is installed, default = 10 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

= Examples =

* Search frontend page for [SOLR](https://lucene.apache.org/solr/)

`
[include-url href="http://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 ==

1. 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)
1. Install and activate the plugin as usual from the 'Plugins' menu in WordPress.
1. Use shortcode in page or post

== Changelog ==

= 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 http:// and https://

= 0.2.0 (2016-08-25) =

* Initial release