Programatically add new donor sans donation

[craig02445]

I am looking to programmatically add a couple of donors who have not yet donated. I believe I need this function create, is that the only one I need? Can I get a simple example of calling it from my own form? I can create the array, just not sure of the syntax of calling the function from my own snippet. Thanks!
Also, where can I find the source code for the IMPORT tool / function?

[jonwaldstein]

Yup you can use the Donor model to create a new one like this:

$donor = Give\Donors\Models\Donor::create([
    'name' => trim("$firstName $lastName"),
    'firstName' => $firstName,
    'lastName' => $lastName,
    'email' => $donorEmail,
    'userId' => $userId ?: null
]);

// once created, it is inserted into the database and you can access the ID and other properties.
$donor->id

[craig02445]

Perfect, THANK YOU.

[craig02445]

What happens if I do this call and the donor already exists?
And I guess the other question is, what is the easiest way to see if a donor already exists?
THANKS.

[kjohnson]

Also, where can I find the source code for the IMPORT tool / function?

I wasn't sure myself, so I did a quick dive to document it here, but I would recommend using the new Donor Model factory that @jonwaldstein mentions.

It starts in the Give_Import_Donations, which triggers give_donation_import_callback, which calls give_save_import_donation_to_db, which finally calls creates a new donor.

[craig02445]

Great, thanks for the help.