Lesson 100 – Admin Transfer Manager (Transaction Workflow Management)
Objective
In Lesson 99, we created a professional Buyer Purchase Details page. However, the transfer timeline and checklist are still driven by static arrays. In this lesson, we will make the transfer process administrator-controlled, allowing the Flipnzee admin to update website transfer progress directly from the Transaction Details page.
Although Flipnzee.com currently sells only its own in-house websites, this architecture is intentionally designed so that developers using the open-source Flipnzee Auctions plugin can later extend it into a full multi-vendor marketplace.
Why This Lesson?
A completed payment does not mean the transaction is finished.
Website sales typically involve multiple stages:
- Payment received
- Website files shared
- Database delivered
- Domain transfer initiated
- Buyer verification
- Transaction completed
These stages should be manageable from the admin panel rather than being hard-coded.
Objectives
By the end of this lesson we will:
- Add a Transfer Manager section to Transaction Details.
- Allow administrators to update transfer progress.
- Save transfer progress securely.
- Automatically update the Buyer Purchase Details page.
- Prepare the plugin for future notifications and email updates.
Current Workflow
Auction Ends
│
▼
Transaction Created
│
▼
Buyer Purchase Page
│
▼
Static Timeline
New Workflow
Auction Ends
│
▼
Transaction Created
│
▼
Admin Transfer Manager
│
▼
Transfer Progress Saved
│
▼
Buyer Purchase Details
│
▼
Dynamic Timeline
Database Strategy
Rather than adding numerous columns to the transactions table, we will use WordPress transaction meta (or a dedicated metadata layer in future lessons).
Each transaction will eventually store values such as:
payment_confirmed
website_files_delivered
database_delivered
domain_transfer_completed
buyer_verified
purchase_completed
This keeps the system extensible without modifying the main transaction table whenever new workflow steps are introduced.
Admin Interface
Inside:
Flipnzee Auctions → Transactions → Transaction Details
we will introduce a new card:
Transfer Manager
☑ Payment Confirmed
☐ Website Files Delivered
☐ Database Delivered
☐ Domain Transfer Completed
☐ Buyer Verified
☐ Purchase Completed
[ Save Progress ]
Only administrators will have permission to modify these values.
Buyer Experience
The buyer page will automatically reflect the saved progress.
Instead of displaying a static checklist, buyers will see:
✓ Payment Confirmed
✓ Website Files Delivered
✓ Database Delivered
○ Domain Transfer Pending
○ Buyer Verification
○ Completed
No manual edits to frontend templates will be required.
Security
This lesson introduces several important security practices:
- Administrator capability checks
- Nonce verification
- Sanitization
- Validation of transaction IDs
- Secure saving of transfer data
Only authorized administrators will be able to update transfer progress.
Why This Fits Flipnzee
Because Flipnzee currently sells only its own websites, the transfer workflow is managed entirely by the site administrator.
Typical workflow:
Auction Won
│
Payment Received
│
Website ZIP Sent
│
Database Sent
│
Domain Transfer
│
Buyer Confirms
│
Completed
This closely matches how professional website acquisitions are handled.
Benefits for Marketplace Developers
Developers using the open-source Flipnzee Auctions plugin can later replace the administrator with individual sellers.
The exact same workflow can become:
Seller uploads files
↓
Buyer downloads files
↓
Seller starts domain transfer
↓
Buyer verifies
↓
Transaction completed
No redesign of the buyer interface will be necessary.
Files Planned for Modification
This lesson will primarily work with:
includes/class-transaction-manager.php
includes/class-my-purchase-details.php
includes/class-loader.php
assets/css/admin.css
Additional helper methods may be introduced if required.
Skills Covered
- WordPress admin forms
- Secure POST handling
- Nonce verification
- Capability checks
- Updating transaction metadata
- Dynamic frontend rendering
- Admin workflow design
- Separation of presentation and business logic
Expected Outcome
By the end of Lesson 100, administrators will have a dedicated Transfer Manager that controls the progress of every website sale. Buyers will immediately see real-time updates to their purchase page, replacing the static checklist introduced in Lesson 99.
This lesson marks an important transition in the Flipnzee Auctions plugin—from presenting purchase information to actively managing the post-sale website transfer process. It establishes the foundation for future enhancements such as automated notifications, secure file delivery, domain transfer tracking, and Escrow.com integration while remaining fully compatible with Flipnzee’s current in-house sales model and future marketplace implementations.
