---
phase: 03-job-management-core
plan: 03
type: execute
depends_on: ["03-01"]
files_modified: [includes/class-notifications.php, includes/class-ddhh-job-manager.php, ddhh-job-manager.php]
---
Send email notification to site admin when a provider submits a new job listing for moderation.
Purpose: Alert admins immediately when new jobs require review, ensuring timely moderation (core value: admin approval before publication).
Output: Automated email notifications to admin on every new job submission.
~/.claude/get-shit-done/workflows/execute-plan.md
~/.claude/get-shit-done/templates/summary.md
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/STATE.md
@.planning/phases/01-foundation-setup/01-03-SUMMARY.md
@.planning/phases/03-job-management-core/03-01-SUMMARY.md
@includes/class-formidable.php
@includes/class-post-types.php
**Tech stack available:** WordPress wp_mail(), Formidable post creation hooks, job_offer CPT
**Established patterns:** German text for user-facing content
**Constraining decisions:**
- Jobs submit to pending status (Phase 01-03)
- Admin moderation is core value (PROJECT.md)
- Email may be disabled in Local WP dev (PROJECT.md context)
Task 1: Create notification class with admin alert on job submission
includes/class-notifications.php
Create new file `includes/class-notifications.php` with class `DDHH_JM_Notifications`.
**Method:** `send_admin_new_job_notification( $post_id )`
Hook into `transition_post_status` action to detect when a job_offer transitions to 'pending':
- Check: $new_status === 'pending' && $old_status !== 'pending' && $post->post_type === 'job_offer'
- Avoid sending on every save - only on initial submission to pending
**Email Content (German):**
- **To:** get_option('admin_email')
- **Subject:** "Neues Stellenangebot zur Prüfung: {job_title}"
- **Body:**
```
Ein neues Stellenangebot wurde eingereicht und wartet auf Ihre Prüfung.
Titel: {job_title}
Anbieter: {author_name} ({author_organization})
Standort: {job_location}
Art: {job_type}
Eingereicht am: {submission_date}
Prüfen Sie das Stellenangebot hier:
{edit_link}
---
Diese E-Mail wurde automatisch gesendet.
```
**Email Details:**
- Use wp_mail() for sending
- Headers: 'Content-Type: text/html; charset=UTF-8'
- Edit link: get_edit_post_link( $post_id, '' ) - direct admin edit URL
- Author org: get_user_meta( $post->post_author, 'ddhh_org_name', true )
- ACF fields: get_field('job_location'), get_field('job_type')
- Date: get_the_date( 'd.m.Y H:i', $post_id )
**Setup method:** `setup_hooks()`
- Hook into 'transition_post_status' with priority 10, accepts 3 params
AVOID sending emails on every post update - only initial pending submission.
WHY: Prevents spam when admins save/update pending posts.
AVOID failing silently if wp_mail() fails - log errors.
WHY: Email issues are common (Local WP disables email), admins need visibility.
1. Class file created with proper structure
2. Hook registered in setup_hooks() method
3. Email sends only on new → pending transition
4. Email includes all required fields (title, author, location, type, edit link)
5. php -l includes/class-notifications.php (no errors)
- Notification class created
- Admin email sent on new job submission
- Email content in German with all job details
- Transition hook properly configured
- No PHP syntax errors
Task 2: Integrate notifications into plugin initialization
includes/class-ddhh-job-manager.php, ddhh-job-manager.php
**File 1: ddhh-job-manager.php**
Add require statement for notifications class:
```php
require_once plugin_dir_path( __FILE__ ) . 'includes/class-notifications.php';
```
**File 2: includes/class-ddhh-job-manager.php**
In the `__construct()` or initialization method, add hook for notifications:
```php
add_action( 'init', array( 'DDHH_JM_Notifications', 'setup_hooks' ) );
```
Pattern should match existing hook registrations (e.g., how DDHH_JM_Access_Control::setup_hooks is called from Phase 2).
AVOID hooking too early - use 'init' action for consistency with other classes.
WHY: Ensures all WordPress functions (wp_mail, ACF) are available when notification runs.
1. Require statement added to main plugin file
2. setup_hooks() called via init action in main class
3. Pattern consistent with other class initializations
4. php -l on both modified files (no errors)
- Notifications class required in main plugin file
- Hooks initialized via init action
- Integration consistent with existing pattern
- No PHP syntax errors
Before declaring plan complete:
- [ ] DDHH_JM_Notifications class exists
- [ ] Hook registered on transition_post_status
- [ ] Email sent only on new pending job submissions
- [ ] Email includes job title, author, location, type, edit link
- [ ] Email text in German
- [ ] Class integrated into plugin initialization
- [ ] No PHP syntax errors
- All tasks completed
- Admin email notification functional
- Email triggers only on new submissions (not updates)
- Email content complete and in German
- Ready for Plan 03-04 (admin UI)