=== Curlest ===
Contributors: fulfillmentglobal
Tags: curlest
Requires at least: 6.2
Tested up to: 6.5
Stable tag: 1.2
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Curlest

== Third party service description ==

This plugin does not make use of any third party services. No data is collected or submitted by this plugin.

This plugin's source code may be verified for confirmation.

== Description ==

This plugin provides a shortcode (called "curlest") that fetches and displays the raw content of a given HTTP URL as the shortcode's output.

== Usage ==

Install and activate the plugin.

Use the Curlest shortcode inside a WordPress post or page:

`[curlest url="" cache="" timeout="" selector=""]`

- Valid values for `url`:
  - e.g. `https://example.com/index.html`

- Valid values for `cache`:
  - `nocache`: No caching, i.e. always fetch new URL contents fresh during each shortcode request
  - The following will always respond with cached URL contents if available, and only fetches new URL data asynchronously, if the cached data has expired based on the given interval, where `N` is a number:
    - `N s` or `N seconds`
    - `N m` or `N minutes`
    - `N h` or `N hours`
    - `N d` or `N days`
  - The following may respond with cached URL contents, if the cached data has not expired yet based on the given interval. The difference with the above is that, in the above, if the cached data is stale (expired), it will still be responded, but with the below (the added `fresh` option), stale data will never be responded, new data will first be fetched during the shortcode request before it is responded, where `N` is a number:
    - `N s fresh` or `N seconds fresh`
    - `N m fresh` or `N minutes fresh`
    - `N h fresh` or `N hours fresh`
    - `N d fresh` or `N days fresh`

- Valid values for `timeout`:
  - Any number, e.g. `30` for 30 seconds. This parameter indicates how long to wait for a response when fetching the URL, before responding with an empty string.

- Valud values for `selector`:
  - Any CSS selector, for example `div.a div.b.c .d-e` to return the inner HTML, as per a given CSS selector, from the contents of a fetched HTML document. This assumes that the fetched URL contents is valid HTML, otherwise, the shortcode's output will be blank.
  
== Frequently Asked Questions ==

Is this plugin free to use?

Yes, this plugin is free to use. The source code is available for you to examine what the plugin does and how it works.

== Screenshots ==

1. No screenshots at present.

== Upgrade Notice ==

No upgrade notice at present.
