تفصیل
The Ardent Africa plugin lets you show live content from 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+.
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.
انسٹالیشن
- Install and activate the plugin.
- Create a free API key at your Ardent developer dashboard: https://ardent.africa/dashboard/developer
- Go to Settings Ardent and paste your key.
- Add an Ardent block to any page or post, or use a shortcode.
عمومی سوالات
-
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).
جائزے
There are no reviews for this plugin.
شراکت دار اور ڈیویلپرز
“Ardent Africa” اوپن سورس سافٹ ویئر ہے۔ مندرجہ ذیل لوگوں نے اس پلگ ان میں حصہ لیا:
شراکت دار
“Ardent Africa” کا اپنی زبان میں ترجمہ کریں۔
ڈویلپمینٹ میں دلچسپی ہے؟
کوڈ براؤز کریں، ایس این وی ریپوزیٹری کو چیک کریں یا ڈویلپمینٹ لاگ کو سبسکرائب کریں بذریعہ آر ایس ایس۔
چینج لاگ
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.