=== Ardent Africa ===
Contributors: deyoungdoer
Tags: fundraising, petitions, events, nonprofit, donations
Requires at least: 6.1
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed live Ardent Africa campaigns, petitions, events, jobs, and TrustScore with blocks, shortcodes, or Elementor widgets.

== Description ==

The Ardent Africa plugin lets you show live content from [Ardent Africa](https://ardent.africa) on your own site. Use the block editor, a shortcode, or, if you build with **Elementor**, a native Ardent widget, and your page shows a campaign's progress, a petition's signatures, upcoming events, a grid of causes, marketplace listings, open jobs, an entity's TrustScore, or a supporter's impact badge, always up to date.

It is **read-only and safe**:

* No payments happen on your site. Donate, Sign, and Get-tickets buttons link visitors to ardent.africa, where the secure on-platform flow runs.
* No private data is fetched, only the public information already shown on ardent.africa.
* Your API key is stored on your server and never exposed to visitors.

= Blocks and shortcodes =

* Campaign: `[ardent_campaign slug="clean-water-for-tamale"]`
* Petition: `[ardent_petition slug="pass-the-bill"]`
* Donation progress: `[ardent_donation_progress slug="clean-water-for-tamale"]`
* Causes grid: `[ardent_causes limit="6" category="Education"]`
* Events: `[ardent_events limit="5"]`
* Marketplace: `[ardent_marketplace limit="6" q="photography"]`
* Jobs: `[ardent_jobs limit="5" location="Accra"]`
* TrustScore: `[ardent_review slug="accra-clinic"]`
* Impact badge: `[ardent_badge username="ama"]`

Each block also auto-renders when you paste an ardent.africa link into the editor (oEmbed).

= Elementor =

If you use Elementor, the same items are available as native widgets under an **Ardent Africa** category in the widget panel: drag one in, set the slug/options in the sidebar, and see a live preview. Requires Elementor 3.5+.

== Installation ==

1. Install and activate the plugin.
2. Create a free API key at your Ardent developer dashboard: https://ardent.africa/dashboard/developer
3. Go to **Settings → Ardent** and paste your key.
4. Add an Ardent block to any page or post, or use a shortcode.

== Frequently Asked Questions ==

= Do I need an Ardent account? =

Yes, a free account, to create an API key. Sign in at ardent.africa and open Dashboard → Developer API.

= Does the plugin take donations on my site? =

No. The plugin only displays public content. All donations and sign-ups happen on ardent.africa.

= Is my API key visible to visitors? =

No. The key stays on your server; the plugin fetches data server-side and caches it.

= Does it work with Elementor? =

Yes. With Elementor active, find the Ardent widgets under the **Ardent Africa** category in the Elementor widget panel (Elementor 3.5+). They render the same cards as the blocks and shortcodes.

= Can I change how a card looks? =

Yes. Campaign and petition widgets/blocks have a **Style** option, Card (image on top), Overlay (an image hero with the title over it), or Compact (no image). The Causes and Marketplace grids have a **Columns** option (Auto, 2, 3, or 4).

== External services ==

This plugin connects to the Ardent Africa public API to display content you choose to embed.

* Public API: `https://api.ardent.africa/public/v1`, fetched server-side with your API key to render campaigns, petitions, events, causes, marketplace listings, jobs, reviewed entities, and profiles. See https://docs.ardent.africa/docs/developers and the terms at https://docs.ardent.africa/docs/developers/terms.
* oEmbed provider: `https://ardent.africa/api/oembed`, used by WordPress to render a pasted Ardent link.
* Embedded widgets (optional fallback): `https://docs.ardent.africa/embed/…`, sandboxed iframes for the same content.

No visitor data is sent to Ardent by the plugin.

== Changelog ==

= 1.3.0 =
* New **Jobs** block, shortcode (`[ardent_jobs]`), and Elementor widget: a live list of open job postings.
* New **TrustScore** block, shortcode (`[ardent_review]`), and Elementor widget: an entity's review TrustScore badge.
* Pasting a `/jobs/…` or `/reviews/…` Ardent link into the editor now auto-embeds it (oEmbed).

= 1.2.0 =
* New **card styles** for campaign and petition (blocks, shortcodes, and Elementor): Card, Overlay (image hero), and Compact.
* **Columns** option (Auto / 2 / 3 / 4) for the Causes and Marketplace grids.
* Petition cards now show their image (when set), matching campaigns.

= 1.1.0 =
* Add native **Elementor** widgets for all seven content types (Ardent Africa category, live preview).

= 1.0.0 =
* Initial release: campaign, petition, donation-progress, causes-grid, events, marketplace, and impact-badge blocks + shortcodes; server-side rendering with caching; oEmbed auto-embed; Settings → Ardent.
