---
phase: 03-job-management-core
plan: 04
type: execute
depends_on: []
files_modified: [includes/class-admin-ui.php, includes/class-ddhh-job-manager.php, ddhh-job-manager.php]
---
Enhance WordPress admin interface for job moderation with custom columns, filters, and quick actions.
Purpose: Give admins efficient tools to moderate job submissions. Better visibility = faster moderation = core value delivered.
Output: Admin job listing with pending count badge, status filters, and provider info columns.
~/.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-02-SUMMARY.md
@.planning/phases/01-foundation-setup/01-03-SUMMARY.md
@includes/class-post-types.php
@includes/class-acf-fields.php
**Tech stack available:** WordPress admin hooks, job_offer CPT, ACF fields
**Established patterns:** German labels for admin UI
**Constraining decisions:**
- Admin moderation is core workflow (PROJECT.md)
- Jobs start as pending (Phase 01-03)
- ACF fields available: job_location, job_type, job_contact_email
Task 1: Add custom admin columns for job moderation
includes/class-admin-ui.php
Create new file `includes/class-admin-ui.php` with class `DDHH_JM_Admin_UI`.
**Custom Columns for job_offer post type:**
Hook into `manage_job_offer_posts_columns` filter to add columns:
1. **Anbieter** (Provider) - Organization name + contact person
2. **Standort** (Location) - job_location ACF field
3. **Art** (Type) - job_type ACF field
4. **Eingereicht am** (Submitted) - Post creation date
Remove default columns if cluttering:
- 'date' (replaced by custom "Eingereicht am")
- 'author' (replaced by custom "Anbieter" with org name)
Hook into `manage_job_offer_posts_custom_column` action to populate column data:
- **Anbieter:** Display `{org_name}
{contact_person}` where org_name is user meta 'ddhh_org_name'
- **Standort:** get_field('job_location', $post_id)
- **Art:** get_field('job_type', $post_id)
- **Eingereicht am:** get_the_date('d.m.Y H:i', $post_id)
Make columns sortable via `manage_edit-job_offer_sortable_columns` filter (at minimum: Eingereicht am, Standort, Art).
AVOID cluttering admin with too many columns - remove non-essential defaults.
WHY: Admins need to see moderation-relevant info at a glance, not every detail.
1. Class file created with proper structure
2. Custom columns registered via manage_*_columns hooks
3. Column data populated correctly
4. Sortable columns work
5. php -l includes/class-admin-ui.php (no errors)
- Admin columns added: Anbieter, Standort, Art, Eingereicht am
- Column data populated from user meta and ACF fields
- Sortable columns functional
- No PHP syntax errors
Task 2: Add status filters and pending count badge
includes/class-admin-ui.php
Add status filter links and pending count badge to admin job listing.
**Status Filters:**
Hook into `views_edit-job_offer` filter to add custom view links:
- All
- Pending (Ausstehend)
- Published (Veröffentlicht)
- Draft (Entwurf)
Each link should include count of posts in that status.
**Pending Count Badge:**
Add visual badge to "Pending" link using CSS class 'count':
```php
$pending_count = wp_count_posts('job_offer')->pending;
$views['pending'] = sprintf(
'%s (%d)',
admin_url('edit.php?post_type=job_offer&post_status=pending'),
__('Ausstehend', 'ddhh-job-manager'),
$pending_count
);
```
Make "Pending" link prominent if count > 0 - admins should see it immediately.
**Quick Actions:**
Keep default WordPress quick actions (Edit, Quick Edit, Trash) - don't remove.
Consider adding custom "Approve" quick action that publishes post directly:
- Link: wp_nonce_url with action 'approve_job'
- Handler: Check nonce, verify user is admin, update post_status to 'publish'
- Optional but helpful for one-click approval
AVOID removing WordPress's built-in quick actions - admins expect them.
WHY: Standard WordPress UX, admins are familiar with Edit/Trash.
1. Status filter links present in admin
2. Pending count badge shows correct number
3. Filters work correctly when clicked
4. Quick actions functional
5. php -l includes/class-admin-ui.php (no errors)
- Status filter links added with counts
- Pending badge visible and accurate
- Filters functional
- Quick actions preserved (Edit, Trash, etc.)
- No PHP syntax errors
Task 3: Integrate admin UI enhancements into plugin
includes/class-ddhh-job-manager.php, ddhh-job-manager.php
**File 1: ddhh-job-manager.php**
Add require statement:
```php
require_once plugin_dir_path( __FILE__ ) . 'includes/class-admin-ui.php';
```
**File 2: includes/class-ddhh-job-manager.php**
Initialize admin UI hooks (admin-only):
```php
if ( is_admin() ) {
add_action( 'init', array( 'DDHH_JM_Admin_UI', 'setup_hooks' ) );
}
```
Create `setup_hooks()` static method in DDHH_JM_Admin_UI class that registers all admin hooks:
- manage_job_offer_posts_columns
- manage_job_offer_posts_custom_column
- manage_edit-job_offer_sortable_columns
- views_edit-job_offer
AVOID loading admin hooks on frontend - check is_admin().
WHY: Performance - frontend doesn't need admin column logic.
1. Require statement added to main plugin file
2. Admin UI hooks initialized only in admin
3. setup_hooks() method exists in DDHH_JM_Admin_UI
4. php -l on both files (no errors)
- Admin UI class required
- Hooks initialized (admin-only)
- Integration complete
- No PHP syntax errors
Before declaring plan complete:
- [ ] Custom admin columns visible in job_offer listing
- [ ] Column data accurate (provider org, location, type, date)
- [ ] Status filters functional
- [ ] Pending count badge shows correct number
- [ ] Sortable columns work
- [ ] Only loads in admin (not frontend)
- [ ] No PHP syntax errors
- All tasks completed
- Admin moderation UI enhanced
- Custom columns provide visibility
- Status filters aid workflow
- Phase 3 complete - ready for Phase 4