Skip to content

Commit 0c815cb

Browse files
author
Jon Waldstein
committed
refactor: use react for settings and add donation forms tab
1 parent b201493 commit 0c815cb

19 files changed

Lines changed: 6264 additions & 1782 deletions

README.md

Lines changed: 50 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,21 @@
11
# GiveWP - Data Generator
22

3-
A WordPress plugin that generates test data for GiveWP including donations, donors, and more. This add-on is designed for testing and development purposes only.
3+
A WordPress plugin that generates test data for GiveWP including donations, donors, campaigns, donation forms, and more. This add-on is designed for testing and development purposes only.
44

55
## Features
66

7-
- Generate test donations using the GiveWP Donation Model
7+
- **Generate test campaigns** with customizable goals, colors, and descriptions
8+
- **Generate test donations** using the GiveWP Donation Model
9+
- **Generate test donation forms** for specific campaigns with various designs and settings
10+
- **Generate test subscriptions** with different billing periods and statuses
811
- Generate test donor data with realistic information
912
- Choose between creating new donors, using existing donors, or a mix of both
1013
- Select specific campaigns for donation generation
1114
- Configure the number of donations to generate (1-1000)
1215
- Set custom date ranges for when donations should be created
1316
- Automatically creates realistic test donor data
1417
- Generates random donation amounts, billing addresses, and other donation details
18+
- **Clean up tools** to remove test data when needed
1519

1620
## Installation
1721

@@ -22,6 +26,15 @@ A WordPress plugin that generates test data for GiveWP including donations, dono
2226

2327
## Usage
2428

29+
### Campaigns Tab
30+
Generate test campaigns with:
31+
- Customizable goal types (amount, donations, donors, subscriptions)
32+
- Random color schemes or themed colors
33+
- Campaign descriptions and images
34+
- Various campaign durations
35+
- Automatic form creation
36+
37+
### Donations Tab
2538
1. Go to **Donations > Data Generator** in your WordPress admin
2639
2. Select a campaign from the dropdown
2740
3. Choose your donor creation method:
@@ -38,6 +51,36 @@ A WordPress plugin that generates test data for GiveWP including donations, dono
3851
- Custom Range (specify start and end dates)
3952
7. Click "Generate Test Data"
4053

54+
### Donation Forms Tab
55+
Generate test donation forms for specific campaigns with:
56+
- **Campaign Selection** - Choose which campaign to associate forms with
57+
- **Form Count** - Generate 1-20 forms per campaign
58+
- **Form Status** - Published, Draft, or Private
59+
- **Goal Settings** - Enable/disable goals with various types:
60+
- Inherit from Campaign
61+
- Custom Amount
62+
- Number of Donations
63+
- Number of Donors
64+
- **Form Designs** - Randomly assign or use specific designs:
65+
- Multi-step Form Design
66+
- Classic Form Design
67+
- Two Panel Form Design
68+
- **Campaign Colors** - Inherit primary/secondary colors from campaign
69+
- **Title Prefix** - Optional custom prefix for form titles
70+
71+
### Subscriptions Tab
72+
Generate test subscriptions with:
73+
- Various billing periods (daily, weekly, monthly, quarterly, yearly)
74+
- Different subscription statuses
75+
- Custom frequency and installment settings
76+
- Renewal payment generation
77+
78+
### Clean Up Tab
79+
Remove test data with:
80+
- Delete all test mode donations
81+
- Delete all test mode subscriptions
82+
- Archive all active campaigns
83+
4184
## Requirements
4285

4386
- WordPress 4.9+
@@ -49,12 +92,16 @@ A WordPress plugin that generates test data for GiveWP including donations, dono
4992
This add-on follows the GiveWP domain-driven architecture with:
5093

5194
- `src/Addon/` - Plugin activation, environment checks, and WordPress integration
52-
- `src/TestDonationGenerator/` - Main business logic for generating test donations
95+
- `src/DataGenerator/` - Main business logic for generating test data
5396

5497
### Key Classes
5598

5699
- `AdminSettings` - Handles the admin interface and form rendering
57100
- `DonationGenerator` - Core logic for creating test donations and donors
101+
- `CampaignGenerator` - Logic for creating test campaigns
102+
- `DonationFormGenerator` - Logic for creating test donation forms for campaigns
103+
- `SubscriptionGenerator` - Logic for creating test subscriptions
104+
- `CleanUpManager` - Handles removal of test data
58105
- `ServiceProvider` - Registers services and hooks with GiveWP
59106

60107
## Generated Data

0 commit comments

Comments
 (0)