MY.TOWN Blogger Help Center

Quick start

Add your WP site URL + application password; we store credentials encrypted per tenant.

Save your API key in the dashboard, then hit the test endpoint to confirm connectivity.

Use the Option 2 workflow—generate drafts via /content/generate.php, share preview, then call approve.

What they are

App passwords are scoped credentials for REST APIs; they avoid storing your main WP login.

How to create

Go to Users → Profile → Application Passwords, enter a label like “MY.TOWN Blogger”, and copy the generated password.

Common errors

Obtain

Generate an API key in your OpenAI account, then paste it into the tenant dashboard.

Save/test

The dashboard calls /openai/test.php to decrypt and validate the key—you must see `ok: true` before generating drafts.

Rotate

Overwrite the saved key anytime and rerun the test; old drafts continue to work since tokens are independent.

Preview link

Generated drafts produce a preview URL (`/content/preview.php?ref=&draft=&token=`). The link honors token expiry (7 days by default).

Approve link

POST to `/content/approve.php` with the tenant ref, draft ID, and approve token. This call publishes the WP post.

After publish

Approve tokens are invalidated immediately; subsequent approve calls just return the stored WP link and ID.

Tenant env folder missing—ensure `.env` exists under `tenants/{ref}`.
SMTP not configured (email optional) so preview invites may skip.
403 token expired—generate a new draft or extend TTL via env.
WordPress authentication error—confirm app password and WP URL.
OpenAI request 401/403—rotate or re-test the API key.
WordPress 500/403 when publishing—check WP REST accessibility.
Missing `YOCO_SECRET_KEY`/`YOCO_WEBHOOK_SECRET`—set in `.env` before activating.
Drafts dir not writable—set tenant storage permissions to 0750.
`content/generate.php` returns `OpenAI key not configured`—save a key first.
`content/approve.php` returns `Tenant not active`—run the Yoco webhook or ensure `active.json` is valid.

If the files do not yet exist, place them under `/docs/` as part of the deployment so this page links to them.

Need help? Reach us on WhatsApp or email us your tenant ref for faster support.

WhatsApp: Message support

Email: support@app.javabeans.co.za