feat(donation): Add company name fields in donation form #2453

[raftaar1191]

Description

PR to fix #2453

How Has This Been Tested?

• Added global Company Donations radio buttons setting with Disabled|Required|Optional options where the Default option will be Disabled
• Added form Company Donations radio buttons setting with Disabled|Required|Optional|Global options. where the Default option will be Global
• Include description Do you want a Company field to appear after First Name and Last Name?
• Ensure Company field appears on the front-end form if the setting is enabled. The Company field should be a full-width field that appears below First Name and Last Name. The name fields must always be present even if a company field is displayed, too.
• Save Company field to payment meta as _give_donation_company so it is permanently preserved.
• Save Company field to donor meta as _give_donor_company and update the donor meta if a company was previously entered for that donor.
• Display Company field in Donor details screen if it is populated.
• Display Company field in Donation details screen if it is populated.
• Add company for the field on donor profile shortcode page.
• Add feature to show company name on a receipt ( by default hide )
• Add feature to show company name in email receipts.
• "Donor Details" meta box UI updates ( feat(donation): Add company name fields in donation form #2453 #2926 (comment) )
• Add company field to donation history export CSV
• Hide company name field when clicking on Create New Donor on donation detail screen

Video/Screenshots (jpeg or gifs if applicable):

Video Link: https://screencast-o-matic.com/watch/cFeqq9Dusj (deprecated)

Types of changes

New feature (non-breaking change which adds functionality)

Checklist:

• My code is tested.
• My code follows the WordPress code style.
• My code follows has proper inline documentation.

[ravinderk]

@raftaar1191 Please use save fn, for now, to save company name in donation meta as we discussed.

[ravinderk]

@raftaar1191 Please add the following issue.

1. Autofill company name if any.
2. Save company name if updates from profile editor ( not working currently)
3. Read my all commit to this PR. I found lots of issues which I already fixed. Make sure you always create Pr with standard code.

[raftaar1191]

@ravinderk PR updates as you have suggested in the following comment.

Kindly review it again and merge it

[DevinWalker]

Review Findings

Nice work on this feature. Please see the following

1. Move Global Settings

Move the settings from it's own subtab to the main "Display" tab:

2. Arrange Donation Fields Better

3. Fix issue when clicking "Create a donor"

When you click "create donor" all fields hide except this new field:

4. The "Donation History" export need to have the "Company" column

[ravinderk]

@raftaar1191

@DevinWalker @mehul0810 and I discussed Donor detail metabox UI and this is the final mockup.

[DevinWalker]

Looks good @ravinderk 👍

[raftaar1191]

@ravinderk @DevinWalker

This menu here is used to show the Donor Details not the Donation Details

Does it sound good are we showing the Donation Company Name in Donor Details section and one more thing we can change the donor from the Dropdown as well this result in changing all the value like donor name donor email donor id but not the Donor Company Name

Video Link: https://screencast-o-matic.com/watch/cFe31KDxwc

[raftaar1191]

@ravinderk @DevinWalker
Should I add Donation Company option in CSV at the time of importing the Donation

CSV Link: https://docs.google.com/spreadsheets/d/1FZkxJDtvhAfUZYtL0HA2awfYvnuhOWbEcAK1egV0zxM/edit#gid=1089390285

[raftaar1191]

@DevinWalker @ravinderk

This PR is ready for review I have updated the Code as the comment made over to PR

Comment

• feat(donation): Add company name fields in donation form #2453 #2926 (comment)

• feat(donation): Add company name fields in donation form #2453 #2926 (comment)

[DevinWalker]

@raftaar1191 good call on allowing Company Name to be importable as well. Please proceed with adding that functionality.

[nguyenrom]

@DevinWalker , The 'Company name' didn't update when I changed the donor. Is this bug?

[ravinderk]

@nguyenrom thank you for reporting this. I created an issue for this.

ref: #4483