=== Gratora - Give Importer ===
Tags: givewp, migration, import, donations, fundraising
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Move donors, donations, campaigns and recurring donations from GiveWP into Gratora, on the same site.

== Description ==

A free add-on for the Gratora donation platform. It needs Gratora 1.0.0 or newer, active on the site that holds your GiveWP data. It needs no license key and sends nothing to Gratora.

A wizard under Fundraising, Give Import reads GiveWP's tables in this site's database and copies what it finds into Gratora. Your GiveWP data is only read, never changed, and GiveWP can be active or deactivated while you import.

What comes across:

* Donors and their donations. Completed and refunded donations always; pending, failed, canceled and abandoned ones, and test-mode donations, if you choose.
* Campaigns and donation forms, and funds when GiveWP's funds data is present.
* Recurring subscriptions, as Gratora recurring donations that keep their gateway subscription ids.
* With Gratora Peer-to-Peer 1.2.0 or newer active: fundraisers, teams and sponsors, and each campaign's peer-to-peer settings.

Imported donations send no receipts or emails to donors. When the run ends, a report counts what came across and what was skipped, and why.

= Running it again =

Run the import again whenever you like. It brings across what is new in GiveWP since the last run and skips everything it already copied, so nothing is duplicated.

Records it already copied are not updated. A refund, a canceled subscription or an edited donor recorded in GiveWP after that record came across stays in GiveWP, so do your final run right before you switch.

= Stripe subscriptions =

Stripe keeps billing an imported subscription on the same Stripe account. For Gratora to record the renewals, connect that Stripe account in Gratora and set up its webhook, then press Run adoption on the Give Import screen: Gratora checks each subscription with Stripe and marks the ones Stripe has canceled. Subscriptions on other gateways come across as records, and their renewals are not tracked.

== Installation ==

1. Download gratora-give-importer.zip from https://gratora.net/add-ons/.
2. In WordPress, go to Plugins, Add New Plugin, Upload Plugin, choose the zip and activate it.
3. Open Fundraising, Give Import. The screen appears when this site's database holds GiveWP data.

== Frequently Asked Questions ==

= How do I update it? =

The importer does not check for updates. Download the new zip from https://gratora.net/add-ons/ and upload it under Plugins, Add New Plugin, Upload Plugin, then choose to replace the installed version.

= What happens when I delete it? =

Deleting the plugin removes its run state and report, and the parts of its import map that point at GiveWP donors and subscriptions. Everything it imported stays in Gratora.

== Changelog ==

= 1.0.0 =
* Initial release.
