README.md 2.07 KB
Newer Older
JonGold's avatar
JonGold committed
1
2
# forcedtribute

3
![Screenshot](/images/screenshot-01.png)
JonGold's avatar
JonGold committed
4

megaphonetech-dennis's avatar
megaphonetech-dennis committed
5
When indicating that a contribution page allow in honor/memory of contributions, this extension shows an additional field that allows you to specify a particular contact. All gifts made through the page will automatically soft credit this person with the preferred tribute type.
JonGold's avatar
JonGold committed
6
7
8
9
10
11
12
13

The extension is licensed under [AGPL-3.0](LICENSE.txt).

## Requirements

* PHP v7.0+
* CiviCRM (*FIXME: Version number*)

14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
## Installation (CLI, Zip)

Sysadmins and developers may download the `.zip` file for this extension and
install it with the command-line tool [cv](https://github.com/civicrm/cv).

```bash
cd <extension-dir>
cv dl forcedtribute@https://lab.civicrm.org/extensions/forcedtribute/-/archive/master/forcedtribute-master.zip
```

## Installation (CLI, Git)

Sysadmins and developers may clone the [Git](https://en.wikipedia.org/wiki/Git) repo for this extension and
install it with the command-line tool [cv](https://github.com/civicrm/cv).

```bash
git clone git@lab.civicrm.org:extensions/forcedtribute.git
cv en forcedtribute.git
```


JonGold's avatar
JonGold committed
35
36
## Usage

37
38
39
40
Upon installation, if your contribution pages have the *Honoree Section Enabled* checkbox enabled, you can then use a drop-down menu to select a contact that will receive a soft credit of the tribute/honor type that you specify. You may only select one tribute/honor type.

All gifts made through this contribution page will automatically assign a soft credit to this person with the preferred tribute type.

JonGold's avatar
JonGold committed
41
42
43
44
45
46
47
48
49
50

## Known Issues

This extension works by pre-filling the user's first name, last name and email, then hiding the "IHO/IMO" area on the contribution page.

This extension assumes that:
* Your "IHO/IMO" profile has a first name, last name, and email field;
* Your unsupervised dedupe rule will dedupe someone with the same first/last/email;
* Your tribute contact has enough of that info filled in to make a dedupe possible.

megaphonetech-dennis's avatar
megaphonetech-dennis committed
51
In other words - if your dedupe rule doesn't match on first/last name alone, and the tribute user doesn't have an email address, a duplicate record will be created each time.