 |
VOOZH | about |
|
VOOZH | about |
This page documents the administrative interfaces for bulk synchronization operations and sync history monitoring. These features allow administrators to synchronize multiple posts at once and track the status of synchronization operations across all content.
For individual post synchronization controls in the post list, see Admin Columns. For per-post dev.to syndication settings, see Post Meta Box.
The Bulk Operations and Sync History functionality provides two admin interfaces:
These interfaces are implemented in the Settings class and rely on the Queue_Manager for actual sync orchestration.
Sources: admin/class-settings.php1273-1304
Both interfaces are registered as separate menu pages under the AJC Bridge menu. The bulk operations page is admin-only, while the sync history page is accessible to any user with publish_posts capability.
Sources: admin/class-settings.php1273-1285 admin/class-settings.php1292-1304
The bulk operations page provides a single-button interface to enqueue all published posts for synchronization. It includes real-time progress tracking and queue statistics.
Sources: admin/class-settings.php1311-1371 admin/class-settings.php1572-1595
The synchronization button triggers a JavaScript confirmation dialog before executing the bulk operation.
| Element | Implementation |
|---|---|
| Button ID | atomic-jamstack-bulk-sync-button |
| Confirmation Text | "Are you sure you want to synchronize all published posts? This may take several minutes." |
| AJAX Action | ajc_bridge_bulk_sync |
| Nonce Key | ajc-bridge-bulk-sync |
| Required Capability | manage_options |
Sources: admin/class-settings.php1315-1318 admin/class-settings.php103
The bulk sync interface includes a progress bar that displays the enqueue status in real-time.
The progress updates are handled client-side based on the AJAX response from ajax_bulk_sync(), which returns:
Sources: admin/class-settings.php1325-1329 admin/class-settings.php1580-1594
The statistics table displays real-time counts of posts in various sync states.
The statistics are populated by calling ajax_get_stats(), which delegates to Queue_Manager::get_queue_stats(). This method performs WordPress meta queries to count posts by _ajc_sync_status value.
| Statistic | Meta Query | Display Element ID |
|---|---|---|
| Total Posts | Count all published posts/pages | stat-total |
| Successfully Synced | _ajc_sync_status = 'success' | stat-success |
| Pending | _ajc_sync_status = 'pending' | stat-pending |
| Processing | _ajc_sync_status = 'processing' | stat-processing |
| Errors | _ajc_sync_status = 'error' | stat-error |
| Not Synced | No _ajc_sync_status meta | stat-not-synced |
Sources: admin/class-settings.php1331-1364 admin/class-settings.php1602-1612
The sync history table displays the 20 most recent posts that have sync metadata, ordered by last sync timestamp.
Sources: admin/class-settings.php1393-1414
The sync history implements two viewing modes based on user capabilities:
| User Role | View Scope | Author Column |
|---|---|---|
| Administrator | All posts from all authors | Visible |
| Author/Editor | Only their own posts | Hidden |
Sources: admin/class-settings.php1380-1411
Each sync status is represented by a colored icon in the history table:
The status display logic uses a switch statement to map meta values to visual indicators:
Sources: admin/class-settings.php1472-1498
The sync history table includes the following columns:
| Column | Data Source | Notes |
|---|---|---|
| Post Title | get_the_title() | Linked to edit page |
| ID | get_the_ID() | Post ID |
| Author | get_post_field('post_author') | Admin view only |
| Type | get_post_type() | post or page |
| Status | _ajc_sync_status meta | With icon |
| Last Sync | _ajc_sync_last meta | Formatted with human_time_diff() |
| Commit | _ajc_last_commit_url meta | External link button |
| Actions | Sync Now button | Disabled if processing |
Sources: admin/class-settings.php1427-1456
Last sync timestamps are stored as Unix timestamps and formatted as relative time:
Sources: admin/class-settings.php1501-1507
For GitHub-synced posts, the history table displays a link to the commit on GitHub:
The _ajc_last_commit_url meta is set by Git_API::create_commit() after successful GitHub operations.
Sources: admin/class-settings.php1536-1543
The "Sync Now" button in the history table triggers immediate synchronization for a specific post.
Sources: admin/class-settings.php1643-1664
The ajax_sync_single() method validates permissions and delegates to Queue_Manager:
The method enqueues the post with priority 5 (high priority) to ensure it processes before bulk-enqueued posts (default priority 10).
Sources: admin/class-settings.php1643-1664
The settings JavaScript file is enqueued on all AJC Bridge admin pages:
Sources: admin/class-settings.php65-91
JavaScript handlers receive configuration through wp_localize_script():
Sources: admin/class-settings.php94-114
Both interfaces rely on post meta keys set by Queue_Manager and Sync_Runner:
| Meta Key | Set By | Purpose |
|---|---|---|
_ajc_sync_status | Queue_Manager | Current sync state: pending, processing, success, error |
_ajc_sync_last | Sync_Runner | Unix timestamp of last sync attempt |
_ajc_retry_count | Queue_Manager | Number of retry attempts (max 3) |
_ajc_last_commit_url | Git_API | GitHub commit URL for verification |
Sources: admin/class-settings.php1399 admin/class-settings.php1463-1465
When no sync history exists, the interface displays an informational notice:
This occurs when:
_ajc_sync_status meta exists)Sources: admin/class-settings.php1416-1423
All AJAX operations implement WordPress security best practices:
| Operation | Nonce Action | Required Capability | Validates |
|---|---|---|---|
| Bulk Sync | atomic-jamstack-bulk-sync | manage_options | None (all published posts) |
| Single Sync | atomic-jamstack-sync-single | publish_posts | post_id via absint() |
| Get Stats | atomic-jamstack-get-stats | manage_options | None (aggregate counts) |
Sources: admin/class-settings.php1573 admin/class-settings.php1644 admin/class-settings.php1603
Refresh this wiki