Skip to content
Home » News » SWJ ACF Single-Field Editor & WPForms Audit — Implementation Guide

SWJ ACF Single-Field Editor & WPForms Audit — Implementation Guide

Tags:

StayWithJay · Web Development · Technical Operations

SWJ ACF Single-Field Editor & WPForms Audit

Implementation record · November 13, 2026 · WordPress / ACF / WPForms / WPCode

Verified demonstration: P3769R4 · Post #18120 · 3 WPForms audit entries across two posts.

1. Overview

This operating record documents the SWJ single-field ACF editing workflow and its WPForms audit trail. It covers the room and property record selection, the ACF value update, the read-only metadata display, and the audit history. The confirmed example is P3769R4, WordPress post #18120.

2. System map

Editor → ACF save → read-back verification → WPForms audit entry → room/property display. The custom editor is separate from WPForms. WPForms serves as the audit ledger rather than the editing interface.

3. Working example: P3769R4

Open the P3769R4 room record. The room page displays the last-365-days amount and lifetime amount in its Owner/Guest interface. The supplied page capture shows totalrevenue = 9990.52, life_time_revenue = 29834.73, and totalbookednights = 180. The same capture identifies 204 read-only metadata rows. These values describe the captured state, not live financial reconciliation.

4. Where the editor appears

The room page includes a tab/button interface and an embedded SWJ Room & Property ACF Editor. The editor lets an authorized user choose a record type, an existing record, and an ACF field, then review and change one value. The screenshot shows P3769R4 (#18120) selected. The exact snippet responsible for the tab buttons and their ACF-driven labels remains to be verified.

5. Read-only metadata panel

The room content includes <div id="swj-room-metadata-slot" style="display:none"></div>. Its shortcode renders a read-only inventory of stored post metadata. The slot begins hidden; separate display logic determines when it is revealed. The capture documents 204 rows, including empty-string values and ACF field-key reference rows.

6. Audit log in WPForms

The form is titled SWJ ACF Single-Field Change Audit. The supplied WPForms screenshot shows three audit entries: two for post 18120 and one for post 17800. Visible columns include Post ID, ACF Field Key, Previous Value, Date, and Actions. WPForms supports viewing individual entries and exporting the audit data. Open WPForms Entries.

7. The PHP-to-WPForms connection

swjafe_form_id() locates or creates the dedicated audit form and stores its ID in the WordPress option swjafe_form_id. After the ACF save and read-back check, the custom PHP assembles an entry payload and calls wpforms()->entry->add($entry). This writes directly to the WPForms entry system without displaying or submitting a conventional WPForms form. update_field() performs the ACF write; get_field() verifies the saved value.

8. Editor implementation

The independent editor is rendered by shortcode

Administrator access required.

. Its JavaScript calls the WordPress AJAX action swjafe for record lists, field lists, reading current values, and saving. The code checks an administrator capability and a nonce, and uses a value fingerprint to detect changes made after the editor loaded. Some complex ACF field types are not supported by this editor.

9. Other related implementations

The separate contextual WPForms pilot uses WPForms #20371 and WPCode #20372. It recognizes the current post, but its field selector was still showing only the placeholder in the supplied room-page capture. Do not confuse this pilot with the independent editor and its WPForms audit form.

10. Record and verification boundaries

The P3769R4 PDF capture documents the public room page, 204 metadata rows, two editor interfaces, and the Owner/Guest tab area. The WPForms screenshot documents three existing audit records. Those captures do not independently establish the source snippet IDs for the tab controls, nor do they prove that every ACF field type can be safely updated. No live WordPress data was modified as part of this documentation beyond publishing this documentation post.

11. Reference links

P3769R4 live room page · WPForms audit entries · WPCode snippets · ACF field groups.

Document control: web-based technical journal. Browser Print → Save as PDF preserves a printable copy. Audit data and field values are point-in-time observations.

Leave a Reply