=== Tendersift — Live UK Contract Alerts ===
Contributors: dawleywebdesign
Tags: tenders, procurement, public sector, contracts, uk
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display live UK public-sector contract opportunities on your site, matched to your readers' interests. Free, no account needed.

== Description ==

**This plugin is for sites whose readers bid for public contracts** — trade associations, chambers of commerce, bid consultancies, procurement advisers, and business-support sites.

UK procurement notices are published openly, but there are thousands of them across several portals and the useful ones get buried. Keyword email alerts are little better: they fire on any notice containing the word, so a reader gets a long list of near-misses and stops opening them.

This plugin puts a short, relevant list in front of your readers instead. It pulls live notices from the UK Government's Find a Tender and Contracts Finder services, scores each one against keywords you set once, and shows the closest matches — with the buyer, the value, and the time left to bid.

= What your readers see =

Each entry shows the contract title, the buying organisation, the contract value, and the days remaining, and links straight through to the official notice. Nothing is invented, rewritten, or re-hosted.

= Features =

* Live notices from the two official UK sources — Find a Tender and Contracts Finder.
* Ranked against your own keywords, or by closing date if you prefer.
* Optional minimum contract value, to keep out the small notices.
* Added anywhere with one shortcode: `[tendersift count="5"]`
* Cached for six hours, so your visitors never wait on an external service.
* Keeps working during an outage — it serves the last copy it fetched.
* No account, no API key, and no tracking of your visitors.
* Removes every trace of itself when you delete it.

= Where to use it =

* A "Live opportunities" section on a construction, IT, or facilities-services website.
* A members' area for a trade association or chamber of commerce.
* A resources page for a bid-writing or business-advice site.
* A sidebar or newsletter page, via a shortcode block or a widget.

= Shortcode =

`[tendersift count="5" min_value="20000" mode="value" title="Live contracts"]`

* `count` — how many tenders to show (1–20, default 5).
* `min_value` — minimum contract value in pounds, e.g. `20000`. Default 0 (no minimum).
* `mode` — `value` ranks by relevance to your keywords; `closing` ranks by nearest deadline.
* `title` — heading shown above the list. Pass an empty title to hide it.

= Where the data comes from =

The notices are published by the UK Government under the Open Government Licence v3.0:

* Find a Tender Service — https://www.find-tender.service.gov.uk/
* Contracts Finder — https://www.contractsfinder.service.gov.uk/

The plugin requests a prepared feed from https://tenderai.uk/tenders.json and caches it on your site. That is the only external request it makes, and it is a plain server-side HTTPS GET that sends nothing about you or your visitors.

This plugin is developed and maintained by Manuel Greenwood (WordPress.org user dawleywebdesign). It fetches its data from tenderai.uk, a service he operates. It is not connected to, or endorsed by, any other tender platform.

This plugin is not affiliated with, endorsed by, or connected to the UK Government. "Find a Tender" and "Contracts Finder" are UK Government services, and the notices belong to the buyers who published them.

= About the connected service =

The plugin fetches its data from tenderai.uk, a tender-brief service run by the plugin author. This plugin is free and works on its own — no account is needed, and no attribution link appears on your site unless you switch it on in Settings.

The service the plugin connects to is documented here, with links to its terms and privacy policy:

* Terms of Use — https://tenderai.uk/terms/
* Privacy Policy — https://tenderai.uk/privacy/

= What the plugin stores on your site =

Two settings, in your own database: your keyword list, and whether you want the attribution link.

Plus a cached copy of the tender list, so pages load quickly and keep working during a brief outage — the current copy for six hours, and the last working copy for up to seven days.

Nothing else. Deleting the plugin removes all of it.

= What the plugin sends, and to whom =

One request, server-side, to https://tenderai.uk/tenders.json, to fetch the public list of notices. That is the only external request the plugin makes.

The request carries no information about you, your site, or your visitors — no URL, no email address, no user data, no site statistics. It is a read of a public data file.

The plugin sets no cookies. It loads no third-party scripts, fonts or images on your pages. It contains no analytics, no advertising and no tracking, and it sends nothing to the plugin author.

The plugin also registers suggested wording under **Settings → Privacy** in WordPress, so you can drop an accurate paragraph into your own privacy policy without writing one from scratch.

== Installation ==

1. Install through the Plugins screen, or upload the folder to `/wp-content/plugins/`.
2. Activate the plugin.
3. Go to **Settings → Tender Alerts** and enter your keywords, one per line.
4. Add `[tendersift]` to any page, post, or widget.

That is the whole setup. The list starts populating immediately.

== Frequently Asked Questions ==

= Who is this for? =

Sites with an audience of UK businesses that bid, or want to bid, for public contracts — trade bodies, chambers of commerce, bid consultancies, and business-support sites. If your readers sell to the public sector, they will find this useful.

= Do I need an account? =

No. The plugin works on its own and is free. There is no sign-up, no API key, and no usage limit.

= Will it slow my site down? =

No. The feed is fetched in the background and cached for six hours, and the stylesheet only loads on pages that actually display the widget. Your visitors never wait on an external service.

= Does this track my visitors? =

No. The plugin makes one server-side request to fetch the tender list. No information about you or your visitors is sent with it, and no third-party scripts are added to your pages.

It sets no cookies and contains no analytics, advertising or tracking of any kind.

= Which external service does this connect to, and why? =

It requests **https://tenderai.uk/tenders.json**, a feed operated by the plugin author, which is where the prepared list of notices comes from. That is the only external request the plugin makes. It is a plain HTTPS GET on the server side, and no data about you or your visitors is transmitted.

The service's terms and privacy policy are here:

* Terms of Use — https://tenderai.uk/terms/
* Privacy Policy — https://tenderai.uk/privacy/

= What does the plugin store on my site? =

Two settings in your own database (your keywords, and the attribution-link preference) and a cached copy of the tender list. The cache is what lets pages load quickly and keep working if the feed is briefly unavailable. Deleting the plugin removes all of it.

= Do I need to add anything to my privacy policy? =

Probably not, but it is worth a moment. The plugin collects nothing, so in most cases there is nothing to disclose. To make that easy, it registers suggested wording under **Settings → Privacy → Policy Guide**, which you can copy into your policy or ignore.

= What happens if that feed is unavailable? =

The plugin keeps serving the last copy it fetched, for up to seven days, so the list does not vanish during a temporary outage. Your page still loads normally and no error is shown to visitors.

= What if no tenders match my keywords? =

The widget says so plainly rather than printing an error or an empty box. You can lower the minimum value or broaden your keywords to see more.

= Do the notices link to the real source? =

Yes. Every entry links directly to the official notice on the UK Government portal, so readers can read the full documentation and bid there.

= Does it work in the block editor and in widgets? =

Yes. Use a Shortcode block in the editor, or the shortcode in a text widget. It also works inside page builders that accept shortcodes.

= Can I change how it looks? =

Yes — the markup uses simple `.tendersift` classes, and the stylesheet is a normal plugin asset you can override from your theme.

= Does it work on multisite? =

Yes. Settings are per-site, and deleting the plugin clears every site's data.

= What is removed when I delete the plugin? =

Everything it created: its settings and both cached copies of the feed. Deleting it leaves nothing behind in your database.

= Can I change where the data comes from? =

Yes — developers can filter `tendersift_feed_url`.

== Screenshots ==

1. The shortcode rendered on a normal WordPress page — live UK contracts with buyer, value and days remaining.
2. The settings screen: enter your keywords once, and optionally switch on the attribution link.

== Changelog ==

= 1.0.0 =
* First release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
