88 Commits

Author SHA1 Message Date
369870ef00 docs: add comprehensive CLAUDE.md for future AI assistance
Add detailed documentation covering plugin architecture, subsystems, workflows, and development practices. Includes GSD workflow requirement for all code changes.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-23 23:10:44 +09:00
1b41b72a3d feat(contact-form): implement modal contact form with AJAX submission
Replace mailto link with modal popup containing Formidable job application form. Modal stays open after submission to show success message.

Changes:
- Add modal popup with contact form on job detail pages
- Implement AJAX form submission to prevent page reload
- Auto-populate job_id field when modal opens
- Add field key compatibility for both job_id and job_id2
- Fix form ID comparison to use loose equality
- Keep modal open after submission to display success message
- Add modal styling and close functionality

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 22:56:57 +09:00
907b5a9924 fix(07-01): convert dates back to ISO format before form submission
Added form submit handler that converts DD.MM.YYYY dates back to YYYY-MM-DD format before submission. This fixes validation error "Bewerbungsfrist is invalid" by ensuring Formidable Forms receives dates in the expected format.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:59:39 +09:00
a87b48df68 fix(07-01): auto-convert date slashes to dots after picker selection
Added change event listener that automatically replaces forward slashes with dots in date fields after user makes a selection. This ensures consistent DD.MM.YYYY format throughout the form interaction.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:57:57 +09:00
f229af23f5 feat(07-01): improve date field prepopulation with format conversion
Added JavaScript to convert YYYY-MM-DD dates to DD.MM.YYYY format when prepopulating date fields. This is a partial fix for the date field issues - full fix requires Formidable Forms configuration.

Also updated ISSUES.md with detailed documentation of all three date field problems: initial format, picker display, and post-selection format.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:43:42 +09:00
18ddcd5e0a feat(07-01): add deadline and contact email to all notification emails
All three job notification emails (new submission, edit, deactivation) now include:
- Bewerbungsfrist (deadline) - formatted as DD.MM.YYYY
- Kontakt-E-Mail (contact email)

This provides administrators with complete information about each job posting.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:36:43 +09:00
0c9ebb9e89 fix(07-01): fix job type dropdown not pre-populating on edit
Improved JavaScript to use case-insensitive matching for select fields, so 'vollzeit' matches 'Vollzeit'. Also normalized all job_type values to lowercase when saving to ensure consistency.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:27:49 +09:00
9142b56a9f docs(07-01): add issue for date field display format
Date field shows as '20260130' instead of German format '30.01.2026'. Documented as low priority cosmetic issue to be fixed later.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:23:59 +09:00
32a22e5fd6 fix(07-01): allow providers to edit published job offers
Added edit_published_job_offers capability to ddhh_provider role and created upgrade_roles function to automatically add this capability to existing provider accounts. Providers can now edit their published job offers from the dashboard.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 21:20:16 +09:00
7f2c5fa6a6 feat(07-01): add frontend display template for job offers
Created DDHH_JM_Template class to display full job details on single job offer pages. Shows logo, organization, location, type, deadline, description, and contact information in a styled layout.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 20:13:48 +09:00
90525cd0ea fix(07-01): fix timing issue in job notification emails
Moved job submission notifications from transition_post_status hook to custom ddhh_job_submitted/ddhh_job_edited hooks. This ensures metadata is saved before the email is sent, so location and type fields are populated correctly instead of showing "Nicht angegeben".

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 19:56:53 +09:00
737f3d6fe9 feat(07-01): implement complete job management workflow
Adds comprehensive job submission, editing, and deactivation functionality with proper form handling and permissions. Includes administrator capabilities for job_offer management and fixed dashboard navigation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 19:49:21 +09:00
1ed164aed0 fix(07-01): create missing form action for job submission
- Job submission form had 0 actions, posts weren't being created
- Manually created wppost action with proper field mappings
- Maps all 7 fields (title, description, location, type, deadline, email, logo)
- Discovered during provider flow testing (jobs not appearing in dashboard)
2026-01-15 23:03:30 +09:00
cadb7f6c01 docs(07-01): document issues discovered during provider flow testing
- Logo field misplaced on job form instead of provider profile
- Empty dropdown issue (fixed)
- Identified required changes for proper company logo implementation
2026-01-15 22:45:31 +09:00
969a7bad74 fix(07-01): prevent multiple redirect triggers causing server crash
- Added ddhhRedirectTriggered flag to ensure only one redirect
- Clear interval immediately when success message detected
- Removed MutationObserver which was causing duplicate events
- Simplified JavaScript to single interval-based check
2026-01-15 20:13:08 +09:00
7009d4c621 fix(07-01): use DOM monitoring for registration redirect
- Changed from event listener to MutationObserver
- Watches for success message text to appear in form
- Monitors form DOM for changes and redirects when success appears
- More reliable than waiting for custom events
2026-01-14 22:12:25 +09:00
36d0f0b2ef fix(07-01): add JavaScript redirect for registration form
- Added add_registration_redirect_script() method
- Listens for frmFormComplete event on registration form
- Redirects to /anbieter-dashboard/ after 1.5s delay
- Shows success message before redirect
- Replaces non-working frm_json_response filter approach
2026-01-14 22:08:44 +09:00
00cabcc178 fix(07-01): add filter to set redirect URL in registration form response
- Added set_registration_redirect() filter on frm_json_response
- Modifies Formidable's JSON response to include redirect_url
- Formidable JavaScript will then redirect to /anbieter-dashboard/
- Fixes registration redirect issue
2026-01-14 22:04:40 +09:00
d838b72ed8 fix(07-01): add redirect URL to registration form
- Registration form now redirects to /anbieter-dashboard/ after successful submission
- Configured via form options redirect_url setting
- Fixes missing redirect after registration
2026-01-14 22:01:32 +09:00
25666a2509 debug(07-01): add detailed field value logging to registration 2026-01-14 21:58:21 +09:00
d6304d934a fix(07-01): use loose comparison for form ID check in registration handler
- Changed !== to != to allow type coercion
- Fixes registration not working due to string vs int comparison
- Added type debugging to help diagnose similar issues
2026-01-14 21:55:15 +09:00
7286133bf4 debug(07-01): add debug logging to registration handler 2026-01-14 21:40:35 +09:00
a00e28702f fix(07-01): replace deprecated FrmFormAction static calls with FrmFormActionsController
- Changed FrmFormAction::create() to FrmFormActionsController::create_action()
- Updated class_exists checks to use FrmFormActionsController
- Fixes fatal error on plugin activation with modern Formidable Forms
- Discovered during provider flow testing (Plan 07-01)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 21:26:59 +09:00
433b83bd8f docs(07): create phase plan
Phase 07: Testing & Polish
- 3 plans created
- 9 total tasks defined (all verification checkpoints + 1 checklist creation)
- Ready for execution

Plan breakdown:
- 07-01: Provider flow E2E test (register → submit → deactivate)
- 07-02: Mentor flow E2E test (browse → apply → opt-in)
- 07-03: Admin flow test + deployment checklist

All plans independent (can run in parallel)
2026-01-14 21:14:42 +09:00
d305d8b149 docs(06-03): complete async mentor notifications plan
Phase 6 Plan 3 complete. Async batch email notifications to opted-in
mentors on job publish without blocking admin workflow. Integrated with
Action Scheduler for background processing in batches of 50 users.
German email templates with job details, rate limit delays, error
logging, and unsubscribe hints.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 21:09:37 +09:00
6a2914f5fc feat(06-03): implement async batch email processor callback
Add process_mentor_notification_batch() method to process Action
Scheduler callbacks. Sends German email notifications with job details
(title, location, type, permalink) to batches of opted-in mentors.
Includes rate limit delay (0.1s between emails), error logging for
failures, and unsubscribe hint in email body. Registered callback for
'ddhh_jm_send_mentor_notification_batch' hook.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 21:09:01 +09:00
e24b4fa7f0 feat(06-03): add job publish hook to schedule mentor notifications
Add notify_mentors_on_job_publish() method to trigger async batch
notifications when jobs transition to publish status. Only triggers on
initial publish (not updates). Queries opted-in mentors via User
Preferences class and schedules batches via Scheduler class. Logs
notification scheduling with mentor count and batch count.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 21:08:23 +09:00
b87ac203fe docs(06-01): complete mentor notification opt-in plan
Tasks completed: 2/2
- User preferences class with notification opt-in meta
- Helper method to query opted-in mentors

SUMMARY: .planning/phases/06-email-notifications/06-01-SUMMARY.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 21:06:32 +09:00
2bfc666ddf docs(06-02): complete Action Scheduler integration plan
Tasks completed: 2/2
- Download and include Action Scheduler library
- Create scheduler helper class for email batch actions

SUMMARY: .planning/phases/06-email-notifications/06-02-SUMMARY.md
2026-01-14 21:05:31 +09:00
cae10e113c feat(06-02): create scheduler helper class for email batch actions
- Created DDHH_JM_Scheduler class with static setup_hooks() method
- Added schedule_mentor_notification_batch() method with 50-user batching
- Uses as_enqueue_async_action() with unique flag and email-notifications group
- Initialized in main plugin file and job manager class
- Ready for Phase 06-03 to register async action callbacks
2026-01-14 21:04:26 +09:00
48f270f6a5 chore(06-02): download and include Action Scheduler library
- Downloaded Action Scheduler 3.9.3 from GitHub
- Placed in vendor/action-scheduler/ directory
- Included in main plugin file before other code for proper initialization
- Library will auto-initialize itself when required
2026-01-14 21:03:48 +09:00
fd88dcf025 docs(06): create Phase 6 email notifications plans
Phase 6: Email Notifications
- 3 plans created
- 6 total tasks defined
- Parallel execution: 06-01 and 06-02 in Wave 1, 06-03 in Wave 2
- Ready for execution

Plans:
- 06-01: Mentor notification opt-in (2 tasks)
- 06-02: Action Scheduler integration (2 tasks)
- 06-03: Async batch email processing (2 tasks)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:59:56 +09:00
464e3d9a41 docs(roadmap): mark Phase 5 complete
All 4 plans completed:
- 05-01: Archive access control
- 05-02: Application form
- 05-03: Logo auto-crop
- 05-04: Single job post protection

Phase 5 complete - mentor job board backend infrastructure ready

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:52:26 +09:00
4f33f88d59 docs(05-04): complete job detail page plan
Summary documents single job post access control implementation,
completing Phase 5 backend infrastructure. Elementor template creation
is manual UI work through WordPress admin.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:51:17 +09:00
2e8bef56b8 feat(05-04): protect single job posts from public access
Add protect_single_job() method to access control class following the
same pattern as job archive protection. Non-logged-in users are
redirected to /anbieter-login/ when attempting to access individual
job_offer posts. Logged-in users (any role) can view job details.

Completes backend infrastructure for Phase 5 mentor job board. All ACF
fields and application form ready for Elementor template integration.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:51:11 +09:00
dd83b676b4 docs(05-04): create job detail page plan
Phase 05-04: Job Detail Page Protection
- 1 plan created
- 2 tasks defined (1 auto, 1 checkpoint:human-verify)
- Ready for execution

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:45:08 +09:00
64227dd6f6 docs(05-03): complete logo auto-crop plan
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:32:02 +09:00
26bac29074 docs(05-02): complete job application form plan
Created SUMMARY.md documenting:
- Job application form with email notification system
- Pre-filled email for logged-in mentors
- Provider receives full applicant context
- Direct reply capability for providers

Updated STATE.md:
- Phase 5 Plan 2 complete
- Added 4 decisions to accumulated context
- Updated velocity metrics

Updated ROADMAP.md:
- Marked 05-02 complete
- Updated progress to 2/4 for Phase 5

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:31:35 +09:00
87f07ba14a docs(05-01): complete archive access control plan
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:30:57 +09:00
318e00e2f9 feat(05-02): add application notification to providers
Add send_provider_application_notification() method:
- Hooks to frm_after_create_entry for job application form submissions
- Extracts applicant details (name, email, message) and job_id
- Fetches job details (title, location, type) from post and ACF fields
- Sends email to provider contact email (job_contact_email ACF field)
- Email includes full applicant info and job context
- Provider can reply directly to applicant email
- Error logging for missing contact email or wp_mail failures

Hook registered in setup_hooks() method

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:30:14 +09:00
75c2969c88 feat(05-01): create archive query helper for Elementor integration
Add DDHH_JM_Archive class to modify job archive queries. Ensures
Elementor Loop Grid displays only published jobs sorted by date
(newest first) with no pagination limit.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:30:00 +09:00
061a41033d feat(05-02): create job application form in Formidable class
Add create_job_application_form() method with 4 fields:
- applicant_name (text, required)
- applicant_email (email, required, pre-filled for logged-in users)
- applicant_message (textarea, required)
- job_id (hidden)

Form title: "Jetzt bewerben"
Submit button: "Bewerbung absenden"
Success message: "Ihre Bewerbung wurde versendet. Der Anbieter wird sich bei Ihnen melden."

Added get_job_application_form_id() helper method
Registered form creation in setup_registration_hooks()

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:29:39 +09:00
c8b911bd6b feat(05-03): register 200x200px cropped image size for job logos
Add register_image_sizes() method to DDHH_JM_Post_Types class that
registers 'job-logo' image size (200x200px with hard crop). Hook
method to after_setup_theme action for proper WordPress timing.

This enables Elementor templates to request consistent logo sizing
via wp_get_attachment_image() using size 'job-logo'. Auto-generates
cropped version when logos uploaded via ACF field.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:29:27 +09:00
e21de5a9e9 feat(05-01): add job archive access control
Protect job archive from public access by redirecting non-logged-in users
to /anbieter-login/. Only authenticated users (mentors/subscribers) can
browse the /jobangebote/ archive.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:29:18 +09:00
ac60de5d99 docs(05): create phase plan
Phase 05: Mentor Job Board
- 3 plans created (parallel-ready)
- 5 total tasks defined
- Ready for execution

Plans:
- 05-01: Archive access control and query setup
- 05-02: Job application form with provider notification
- 05-03: Logo auto-crop to 200x200px

All plans independent (depends_on: []), can execute in parallel.
2026-01-14 20:22:35 +09:00
4e407b3fe0 docs(04-02): complete deactivation notifications plan
Tasks completed: 1/1
- Add deactivation notification method to notifications class

Phase 4 complete - job deactivation system fully functional.

SUMMARY: .planning/phases/04-job-deactivation-system/04-02-SUMMARY.md
2026-01-14 20:08:59 +09:00
4a1c05c421 feat(04-02): add deactivation notification method to notifications class
- Added send_admin_job_deactivation_notification() method
- Hooks transition_post_status with guards: draft status AND old publish
- Extracts deactivation reason from ACF field job_deactivation_reason
- Email subject: "Stellenangebot deaktiviert: {job_title}"
- Email includes job details, provider info, and deactivation reason
- Sends to admin_email with edit link for review
- Error logging for missing admin_email or wp_mail failure

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:07:08 +09:00
639050279c docs(04-01): complete job deactivation form plan
Create SUMMARY.md documenting completed plan 04-01: job deactivation form with required reason field, ownership validation, and dashboard integration. Update STATE.md to reflect Phase 4 Plan 1 completion (12 plans total, 48% progress). Update ROADMAP.md to mark 04-01 as complete.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:04:52 +09:00
fbbd44a07b feat(04-01): add deactivate action to provider dashboard
Add deactivate mode detection alongside existing edit mode checking for action=deactivate_job and job_id parameter. When in deactivate mode, render deactivation form section similar to edit section structure with heading "Stellenangebot deaktivieren", back link to dashboard, and form shortcode with id_param={job_id}. In job listings table, add "Deaktivieren" button in Actions column only for published jobs (status === 'publish'). Deactivate button uses warning/destructive color (red background) to differentiate from edit/view buttons. Follow same conditional rendering pattern as edit mode showing deactivation form OR listings, not both.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:03:09 +09:00
e29a3e507f feat(04-01): create job deactivation form with reason field
Add create_job_deactivation_form() method following established pattern from create_job_edit_form(). Form includes deactivation_reason textarea (required, German label) and hidden job_id field. Configure Update Post action to set post_status='draft' removing job from public view. Map deactivation_reason to ACF meta field 'job_deactivation_reason'. Add ownership validation hook validate_job_deactivation_ownership() following same pattern as validate_job_ownership() to prevent URL tampering. Submit button: "Stellenangebot deaktivieren". Success message: "Ihr Stellenangebot wurde deaktiviert." Redirect to /anbieter-dashboard/. Add get_job_deactivation_form_id() helper following established pattern.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 20:02:23 +09:00