Viktor Miller
8b296cefbe
Phase 01: Foundation & Setup - 3 plans created (all independent, can run parallel) - 7 total tasks defined - Ready for execution Plans: - 01-01: Plugin structure and activation hooks - 01-02: Register job_offer CPT with capabilities - 01-03: Register ddhh_provider role and ACF fields Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
147 lines
4.9 KiB
Markdown
147 lines
4.9 KiB
Markdown
---
|
|
phase: 01-foundation-setup
|
|
plan: 03
|
|
type: execute
|
|
depends_on: []
|
|
files_modified: [includes/class-roles.php, includes/class-acf-fields.php]
|
|
---
|
|
|
|
<objective>
|
|
Register custom role `ddhh_provider` with restricted capabilities and ACF field groups for job_offer CPT.
|
|
|
|
Purpose: Define provider permissions and job listing data structure.
|
|
Output: Provider role with correct capabilities, ACF fields for job metadata.
|
|
</objective>
|
|
|
|
<execution_context>
|
|
~/.claude/get-shit-done/workflows/execute-plan.md
|
|
./summary.md
|
|
</execution_context>
|
|
|
|
<context>
|
|
@.planning/PROJECT.md
|
|
@.planning/ROADMAP.md
|
|
@.planning/STATE.md
|
|
|
|
**From PROJECT.md:**
|
|
- ACF fields: job_location (text), job_type (select), job_deadline (date), job_contact_email (email), job_logo (image), job_deactivation_reason (textarea - internal)
|
|
- Providers: restricted capabilities, no WP-Admin access except profile
|
|
|
|
**Tech stack:** ACF Pro available
|
|
</context>
|
|
|
|
<tasks>
|
|
|
|
<task type="auto">
|
|
<name>Task 1: Register ddhh_provider role with restricted capabilities</name>
|
|
<files>includes/class-roles.php</files>
|
|
<action>
|
|
Create `DDHH_JM_Roles` class with static add_roles() method.
|
|
|
|
Register role 'ddhh_provider' with add_role():
|
|
- Display name: 'Anbieter' (German for Provider)
|
|
- Capabilities:
|
|
- read: true (basic WordPress access)
|
|
- edit_job_offers: true (can edit own job_offers)
|
|
- publish_job_offers: false (jobs go to pending, admin publishes)
|
|
- delete_job_offers: true (can delete own)
|
|
- upload_files: true (needed for logo upload)
|
|
|
|
- Explicitly DENY:
|
|
- edit_others_job_offers: false (cannot edit others' jobs)
|
|
- edit_posts: false (no access to regular posts)
|
|
- edit_pages: false (no access to pages)
|
|
- manage_categories: false (no admin functions)
|
|
|
|
Hook add_roles() to activation (via Activator class), not 'init' (roles persist in DB).
|
|
|
|
Also create static remove_roles() method for deactivation cleanup.
|
|
|
|
DO NOT give 'edit_posts' capability — this would grant access to regular blog posts.
|
|
</action>
|
|
<verify>Role appears in WordPress users > Add New > Role dropdown</verify>
|
|
<done>ddhh_provider role registered with correct capabilities for job management only</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 2: Register ACF field group for job_offer metadata</name>
|
|
<files>includes/class-acf-fields.php</files>
|
|
<action>
|
|
Create `DDHH_JM_ACF_Fields` class with static register_fields() method.
|
|
|
|
Use acf_add_local_field_group() to register field group:
|
|
- Title: 'Job Details'
|
|
- Location: post_type == 'job_offer'
|
|
- Position: 'normal'
|
|
- Style: 'default'
|
|
|
|
Fields:
|
|
1. job_location (type: text, label: 'Standort', required: true)
|
|
2. job_type (type: select, label: 'Art', choices: ['vollzeit' => 'Vollzeit', 'teilzeit' => 'Teilzeit', 'ehrenamt' => 'Ehrenamt'], required: true)
|
|
3. job_deadline (type: date_picker, label: 'Bewerbungsfrist', return_format: 'Y-m-d', required: false)
|
|
4. job_contact_email (type: email, label: 'Kontakt-E-Mail', required: true)
|
|
5. job_logo (type: image, label: 'Logo', return_format: 'id', preview_size: 'thumbnail', required: false)
|
|
6. job_deactivation_reason (type: textarea, label: 'Deaktivierungsgrund (intern)', rows: 3, required: false, conditional_logic: show only when post_status != 'publish')
|
|
|
|
Hook register_fields() to 'acf/init' action.
|
|
|
|
Use acf_add_local_field_group() not acf_register_field_group() — local fields are code-defined, not DB-stored.
|
|
</action>
|
|
<verify>ACF fields appear on job_offer edit screen in WordPress admin</verify>
|
|
<done>ACF field group registered with all required metadata fields</done>
|
|
</task>
|
|
|
|
</tasks>
|
|
|
|
<verification>
|
|
Before declaring plan complete:
|
|
- [ ] Provider role exists with correct capabilities
|
|
- [ ] Provider CANNOT edit regular posts/pages
|
|
- [ ] Provider CAN upload files (for logos)
|
|
- [ ] ACF fields appear on job_offer edit screen
|
|
- [ ] All required fields marked as required
|
|
</verification>
|
|
|
|
<success_criteria>
|
|
|
|
- All tasks completed
|
|
- Provider role restricts access appropriately
|
|
- ACF fields capture all job metadata
|
|
- Ready for Formidable form integration in Phase 2
|
|
</success_criteria>
|
|
|
|
<output>
|
|
After completion, create `.planning/phases/01-foundation-setup/01-03-SUMMARY.md`:
|
|
|
|
# Phase 1 Plan 3: Roles & Fields Summary
|
|
|
|
**Provider role and ACF field group for job metadata registered**
|
|
|
|
## Accomplishments
|
|
|
|
- Custom role 'ddhh_provider' with job-only capabilities
|
|
- ACF field group with 6 metadata fields
|
|
- Proper capability restrictions (no posts/pages access)
|
|
- Logo upload support
|
|
|
|
## Files Created/Modified
|
|
|
|
- `includes/class-roles.php` - Role registration and cleanup
|
|
- `includes/class-acf-fields.php` - ACF field group definition
|
|
|
|
## Decisions Made
|
|
|
|
- Jobs submit to 'pending' status (admin approval required)
|
|
- German field labels: Standort, Art, Bewerbungsfrist, etc.
|
|
- Logo as image ID (not URL) for better media library integration
|
|
- Deactivation reason field conditional on non-published status
|
|
|
|
## Issues Encountered
|
|
|
|
None
|
|
|
|
## Next Step
|
|
|
|
Phase 1 complete — all 3 plans done. Ready for Phase 2.
|
|
</output>
|