Help

Built-in help, file placement guidance, workflow notes, and quick links for managing the 4 P’s platform.

Detected Core Tables
9
Core Pages Listed
14
Pages Found On Disk
14
Pages Missing On Disk
0

Core Guidance

Where these files should go

These 4 P’s pages are written to live in the same main app folder as claims.php, plans.php, invoices.php, payments.php, customer-add.php, and property-edit.php. They are not written for an admin subfolder unless the paths are rewritten.

Database connection rule

Each page uses require_once __DIR__ . '/app/db.php'; so the app/db.php file should be directly under your 4 P’s root folder.

Navigation include rule

Each page expects includes/fourps-nav.php to be a partial include file and loads it from the main app folder.

Schema-tolerant behavior

The pages detect either base table names or fourps_* table names and try alternate column names before reading or writing data.

Dashboard safety rule

Do not overwrite your existing fourps-dashboard.php unless you intentionally want it rewritten. Keep separately generated dashboard-style files separate unless the filename is explicitly requested.

How to add new pages

Place the new PHP file beside your existing 4 P’s pages, then add a matching link in your navigation include if you want it visible in the menu.

Recommended Workflow

  1. Create or edit customers first, then connect properties to the customer.
  2. Attach plans to the correct customer and property.
  3. Create inspections tied to the customer, property, and plan when possible.
  4. Open claims after an issue is reported and connect them to inspection and plan records when available.
  5. Create invoices for approved work or covered billing events.
  6. Record payments against invoices and use reports or notifications to watch balances due.

Troubleshooting

A page shows blank sections or missing linked data

Check whether the matching table exists, whether the foreign key column exists, and whether the linked record actually has a value saved in that column.

A page gives path errors

Make sure the file is in the same main folder as the other 4 P’s pages and that app/db.php and includes/fourps-nav.php exist in the expected locations.

A table or column name is different from what you expected

Use system-status.php and settings.php to see which tables and columns are actually being detected by the schema-tolerant helpers.

A detail page opens but shows record not found

Confirm the URL id value is correct and that the matching table has a record with that id.

Search does not find something you know exists

Check whether the searched text is stored in one of the supported search columns for that page type, and verify the table actually exists.

Page Presence Check

Page File Status
Dashboard fourps-dashboard.php Found
Customers customers.php Found
Properties properties.php Found
Plans plans.php Found
Inspections inspections.php Found
Claims claims.php Found
Invoices invoices.php Found
Payments payments.php Found
Reports reports.php Found
Search search.php Found
Notifications notifications.php Found
Settings settings.php Found
System Status system-status.php Found
Activity Log activity-log.php Found

Detected Core Tables

Area Resolved Table Status
Customers customers Found
Properties properties Found
Plans plans Found
Inspections inspections Found
Inspection Items inspection_items Found
Claims claims Found
Claim Items claim_items Found
Invoices invoices Found
Payments payments Found