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.

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.

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.

FAQ

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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Curlest” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Curlest” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.