# Boofers of Butler v5 Payment, Owner Portal, and Launch Setup

## What this package can do

This package is ready for a Hostinger site that supports PHP. It includes:

- Public website pages
- Product/inventory page
- Wells Woodwork mini-site
- Gallery with all uploaded JPG media and referenced UVP PNG images
- Secure external payment links for Square, PayPal, and Cash App
- Checkout request form that records order requests
- Owner login portal
- Owner username/password reset after login
- Exportable CSV order sheet
- Shipping tools page with USPS, UPS, and FedEx links

## Important limitation

A static HTML-only Hostinger plan cannot safely provide private owner login, password resets, server-side order storage, payment webhooks, or shipping-label API automation. This v5 build includes PHP files for those features. Make sure PHP is enabled on the hosting plan.

## First owner setup

1. Upload the full v5 package to the domain folder.
2. Visit: `https://YOURDOMAIN.com/setup-owner.php`
3. This creates the initial owner user requested for the pilot.
4. Visit: `https://YOURDOMAIN.com/owner-login.php`
5. Log in and immediately change the username and password.
6. After setup, delete `setup-owner.php` from the public site folder or rename it to something private.

## Payment setup

The site does not store customer card data. Customers are sent to Square, PayPal, or Cash App to complete payment securely.

Edit this file after upload:

`private/payment-settings.php`

Replace:

- `square_shop_url`
- `paypal_url`
- `cashapp_url`
- `store_email`

Recommended safe launch order:

1. Create/confirm Square account.
2. Create Square Online checkout links or product payment links.
3. Create/confirm PayPal Business account or PayPal.me link.
4. Create/confirm Cash App business profile / cashtag.
5. Replace the placeholders in `private/payment-settings.php`.
6. Place test orders.
7. Confirm payment notifications arrive in the correct client accounts.
8. Verify payment manually before shipping.

## Shipping labels

The owner portal includes:

- Export order CSV
- USPS Click-N-Ship link
- UPS shipping link
- FedEx shipping link

For automatic label creation, connect a service such as Shippo, ShipStation, EasyPost, Pirate Ship, or the individual carrier APIs. Do not paste shipping API keys into public HTML or JavaScript.

## Gallery upload

Upload the PNG files listed in `UVP_Images/README_UPLOAD_GALLERY_IMAGES_HERE.txt` into the `UVP_Images` folder. The gallery already references those filenames. Missing images will show a placeholder until uploaded.