=== Journal Keeper ===
Tags: journal, diary, notes, members, privacy
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A personal front-end journal for every member: private entries, dates, formatting, categories, tags, photos, search, export, and deletion.

== Description ==

Journal Keeper by The Buddy Foundry gives registered members their own place to write, organize, and revisit ideas and experiences.

Your thoughts. Your memories. Your private space.

* Add the My Journal block or [journal_keeper] shortcode to a page.
* Use [journal_keeper mode="button"] for an overlay that leaves the current page in place.
* Create dated entries with titles, basic formatting, categories, and tags.
* Search your own entries, including categories and tags.
* Attach up to five private photos per entry.
* Automatic saving, unsaved-text draft recovery, and conflict handling between tabs.
* Export saved entries and photos as JSON; delete an entry or the whole journal.
* Administrators control writing roles, entry/storage limits, and available features.
* WordPress personal-data export/erasure and account deletion include journal data.

0.1.0 is an early release. Test your theme, hosting, caching, and member-account workflow before a public rollout. It uses WordPress's bundled editor and existing member accounts. It requires no external service, payment, license key, or My Brewing Buddy code.

= Privacy =

Entries are private to their owner through the plugin. Administrators cannot browse other members' journals through its normal journal interface. Authorized database/server/backup operators and administrators performing WordPress privacy exports can access stored data. This is access control, not end-to-end encryption.

The plugin stores user IDs, titles, dates, entry text, categories, tags, timestamps, and optional photo bytes in two site-specific database tables. Photos are NOT public Media Library attachments. Authenticated owner requests retrieve them. Uploaded photos are re-encoded to remove image metadata; visual orientation should be checked before saving important photos. Photos are JPEG/PNG/WebP, at most 2 MB and 12 megapixels each; PHP GD is required. Some WebP photos may be converted to PNG.

Unsaved text drafts may be stored in this tab's sessionStorage, scoped to the site and account. Browser storage restrictions or closing the tab may remove them. This is not offline synchronization. Uploaded photos are not retained in draft storage. Photos must finish uploading before leaving.

No tracking, external fonts, analytics, AI service, email, or journal transmission to The Buddy Foundry is included. Hosting, backups, other installed plugins, and the site's general privacy practices remain the website owner's responsibility. Use HTTPS and exclude signed-in pages and /wp-json/journal-keeper/v1/ from host/CDN caches.

Deletion removes active entries and photos. Backup copies follow the host's retention policy. Deactivation and deleting the plugin preserve its tables and settings to protect members from accidental loss. Account deletion and WordPress privacy cleanup require the plugin to be active. After deactivation or removal, retained data needs deliberate cleanup. Before permanent site removal, use member deletion or WordPress's personal-data eraser and deliberately remove retained tables/settings with database administration tools after a current backup.

== Installation ==

1. Upload journal-keeper-0.1.0.zip in Plugins > Add New Plugin > Upload Plugin.
2. Activate Journal Keeper on the individual website. Network-wide activation is not supported in 0.1.0.
3. Open Settings > Journal Keeper. Review roles, feature switches, and quotas.
4. Choose Create or edit My Journal page, then preview and publish the draft. Or add the My Journal block / [journal_keeper] shortcode to your own page.
5. Add that page to your navigation. For an overlay button, use [journal_keeper mode="button"] or choose the block's overlay display option.
6. Sign in as a normal member, create a test entry, and wait for Saved. Check a second member cannot see it. Test your theme at desktop and phone sizes.
7. Review the plugin's suggested privacy-policy text and your backup retention. Clear caches and keep private endpoints/signed-in pages uncached.

Requires WordPress 6.5+, PHP 8.2+, and InnoDB tables (including the WordPress users table). GD is needed only for photo upload. Defaults: 1,000 entries and 25 MB of saved text/photos per member. A single entry permits 160 title characters, 80 category characters, 20 tags (40 characters each), and 200,000 bytes of HTML. Changing limits never deletes existing entries.

== Frequently Asked Questions ==

= Can this work on a gardening, brewing, travel, or membership site? =

Yes. Entries have no subject-specific fields or recipe dependency. Categories and tags belong to each entry, visible only to its owner. Theme styling is scoped to the journal. Test your specific theme and page builder before launch; universal theme compatibility has not been established.

= Do subscribers need WordPress administrator access? =

No. All registered roles can write by default, including subscribers. Members use the front-end journal. Administrators can restrict writing by role. Members whose writing permission is removed can still read, export, and delete their stored journal.

= Can other members read my journal? =

No. The plugin checks the signed-in owner on every entry/photo operation. It does not publish entries as posts, expose them in public search/feeds/sitemaps, or provide sharing links. See Privacy above for authorized operator and backup access.

= What happens if a save fails or another tab edits the entry? =

The unsaved text remains in the tab with retry and download options. A conflicting saved version is not overwritten. Save draft as new entry preserves your text as a separate entry; it does not duplicate photos. Load saved entry asks before discarding local changes. Wait for Saved before leaving.

= How do I export? =

Open Your privacy & data and choose Export my journal. The JSON download includes formatted entry HTML, metadata, and Base64 photo data. It can be read with a text editor or processed by another tool. A built-in import or PDF exporter is not included in 0.1.0. Large journals may need time and browser memory to export. WordPress's administrator privacy-export tool is also supported.

= Does this synchronize across websites? =

No. The journal belongs to the account on the website that hosts it. Signing in to that same website on another device retrieves the saved entries. Other websites are separate.

= What happens when I disable photos or formatting? =

Existing photos remain readable and can be removed. Disabling photo uploads prevents new photos. Disabling formatting provides plain-text editing; unchanged saved rich text is preserved, while text edited in that mode is saved without rich formatting. Disabling categories or tags hides their controls and preserves existing values.

= What is stored in backups? =

Entries and photos are in the website database, so database backups contain private journal information and can grow with photo use. Do not offer public database backup downloads. Apply the site's existing retention and access controls.

== Screenshots ==

1. A member’s private journal dashboard with formatting, categories, tags, and a photo.
2. Administrator controls for writing roles, entry/storage limits, and available features.

== Changelog ==

= 0.1.0 =
* Initial standalone Journal Keeper release by The Buddy Foundry.
* Private multiuser journal, dashboard/overlay, rich text, search, categories/tags, and private photos.
* Role/feature/storage settings, export/erasure, autosave recovery, and optimistic version checks.

== Upgrade Notice ==

= 0.1.0 =
First standalone release. This does not replace or import the existing My Brewing Buddy journal. Test on staging before public use.
