Feature: Update Campaign Donation Query

[alaca]

Description

This PR touches several places to update the CampaignDonationQuery class so that we are no longer using the give_campaign_forms lookup table to get donations. Since we don't have a donations table, the only fairly reasonable option was to add another meta field that will reference the campaign ID. The donation model is updated so that it is now possible to get a campaign from a donation object ($donation->campaign->id). The donation repository has also been updated to store the campaign ID as a donation meta. Also, Revenue DonationHandler is updated to insert the campaign ID on each donation, although I'm not entirely sure we need the campaign ID column in this table. It might be handy for reports.

Affects

Donation model
Donations repository
Donation meta
Give container
Revenue Donation Handler

Pre-review Checklist

• Relevant @unreleased tags included in DocBlocks
• Self Review of code and UX completed

[JasonTheAdams]

Seems like this could be accomplished as a single insert of many rows?

[alaca]

Yes, with SQL. With WPDB, not really. I would love to have that feature. Maybe we should consider updating the insert method to support that.

[JasonTheAdams]

Seems like a shame to knowingly have a nasty N+1 issue here that we could definitely circumvent just because of a lack of a WPDB feature. I think it's worth taking the moment to build the insert many feature for this.

[alaca]

@JasonTheAdams, I have been thinking about this in the past. Since data for inserting will probably be collected inside the loop, I thought having something like this might be handy:

        $qb = DB::table('give_donationmeta');

        foreach($data as $row) {
            $qb->set([
                'donation_id' => $row->id,
                'meta_key' => $row->key,
                'meta_value' => $row->value,
            ]);
        }

        $qb->insert();

This approach will require altering the insert method to be something like this:

    public function insert($data = [], $format = null)
    {
        // collection represents collected data for insert
        if ($this->collection instanceof Collection) {
            return DB::query($this->getInsertIntoSQL());
        }
        
        if (empty($data)) {
            throw new InvalidArgumentException('data cannot be empty');
        }
        
        return DB::insert(
            $this->getTable(),
            $data,
            $format
        );
    }

[alaca]

@JasonTheAdams @kjohnson @jonwaldstein I added two new methods (set, and insertMany) in QB to support inserting many rows at once.
The set method extracts the column names and collects the data that will be inserted.
The insertMany method is used to run the query.

Example https://github.com/impress-org/givewp/pull/7630/files#diff-d8a0d0bca549b7c6ef03bff4d585bad86d5640245557cd38e16803554d6f4561R71

[JasonTheAdams]

@alaca Do we have a polyfill for this somewhere? This is a PHP 8.1 function.

[alaca]

@JasonTheAdams Yeah. I installed and am using the stellarwp/arrays package now.