=== CauseMissions ===
Contributors: causemissions
Tags: nonprofit, donation, fundraising, charity, donate button
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let supporters unlock free donations for your nonprofit without leaving your site.

== Description ==

CauseMissions turns quick tasks into donations. A supporter does a mission, like trying an app or a game, our partner pays us, and CauseMissions donates to your nonprofit. It's free for you and for your supporters, and there's nothing to sign up for: every US nonprofit is already listed.

This plugin adds CauseMissions to your WordPress site:

* **A block** for any page, post or block widget area, with a live preview.
* **A widget** for sidebars and footers on classic themes.
* **A shortcode**, `[causemissions]`, for page builders and the classic editor.

Pick a button, a banner, or a card that features one mission. Clicking it opens CauseMissions in a popup, so visitors stay on your site. A featured mission shows its own name, image and donation amount, and hides itself if it ends, so there's never a dead button.

= Shortcode options =

* `type`: `button` (default), `banner`, `card` or `missions`
* `label`: your own text, e.g. `label="Unlock a free donation"`
* `mission`: a mission ID to feature one mission
* `color`: a hex color for cards and mission banners, e.g. `color="#7c3aed"`
* `size`: `lightbox` or `takeover` (full screen)
* `align`: `left`, `center` or `right`
* `desktop_devices`: `all` to offer phone missions to desktop visitors too
* `cause`: another nonprofit's EIN (defaults to the one in Settings)

Example: `[causemissions type="banner" label="Each mission unlocks a donation"]`

== External services ==

This plugin connects to CauseMissions (https://causemissions.com) to show your placements.

* On pages with a placement, visitors' browsers load the CauseMissions embed script from https://causemissions.com/embed/v1.js. It fetches your nonprofit's name and missions from the CauseMissions API and, when a visitor clicks, opens CauseMissions in a popup on your page. No data is sent until the page with a placement loads.
* On Settings → CauseMissions, your site looks up the nonprofit name for the EIN you entered (https://causemissions.com/api/cause/{EIN}). Only the EIN is sent.

CauseMissions Terms of Use: https://causemissions.com/terms
CauseMissions Privacy Policy: https://causemissions.com/privacy

== Installation ==

1. In WordPress, go to Plugins → Add New Plugin → Upload Plugin, choose the zip file and click Install Now, then Activate.
2. Go to Settings → CauseMissions and enter your nonprofit's EIN.
3. Add the CauseMissions block to a page, a CauseMissions widget to a sidebar, or the `[causemissions]` shortcode anywhere.

== Frequently Asked Questions ==

= Does it cost anything? =

No. There's no fee for you or your supporters. Our partners pay us for completed missions, and CauseMissions makes the donation.

= Where do I find my EIN? =

Search for your nonprofit on https://causemissions.com. Your EIN is on your page there, and on your IRS paperwork.

= A placement doesn't show up. Why? =

A placement hides itself when the nonprofit or the featured mission isn't available, for example when a mission has ended or isn't offered on the visitor's device. Logged-in editors see a note when no EIN is set.

== Changelog ==

= 1.0.0 =
* First release: block, widget, shortcode and settings page.
