Family Notebook v1.1.4

Family Notebook v1.1.4

Release Date: June 23, 2026

🛠️ Bug Fixes & Improvements

• WordPress Updater Compatibility: Added a native WordPress readme.txt file to the root directory. This resolves the "no valid readme file found" and "readme not compatible with your site" errors when using automatic updaters.
• Version Bump: Synchronized version numbers across family-notebook.php and readme.txt to properly trigger WordPress update notifications.

🚀 How to Update

If you successfully installed v1.1.3, you might see this update available in your Dashboard > Updates page (click "Check Again" to force a refresh).

If the update does not appear automatically (due to the missing readme in the previous version), please perform a quick manual update:

1. Download the family-notebook-v1.1.4.zip file attached to this release.
2. Go to your WordPress Admin dashboard.
3. Navigate to Plugins > Add New Plugin > Upload Plugin.
4. Upload the zip file and click "Replace current with uploaded" when prompted.

Moving forward, the updater now has everything it needs to handle future releases seamlessly!

Family Notebook v1.1.3

=== Family Notebook ===
Contributors: qrussell
Tags: family, notebook, notes, organization, productivity, react
Requires at least: 6.0
Requires PHP: 7.4
Tested up to: 7.0
Stable tag: 1.1.3
License: GPLv2 or later

Family Notebook v1.1.3

Release Date: June 23, 2026

🎉 New Features

• Automatic GitHub Updates: Say goodbye to manual zip uploads! The Family Notebook plugin is now fully integrated with WordPress's native update system. It automatically checks the qrussell/family-notebook GitHub repository for new releases and allows you to update with a single click directly from your WordPress dashboard.
• In-Dashboard Release Notes: You can now click "View version details" next to the plugin in your WordPress admin area to read the full changelog and release notes for upcoming versions directly from GitHub.

🚀 Installation Instructions (One Last Time!)

Since this is the version that introduces the automatic updater, you will need to manually install this update one final time.

1. Download the family-notebook-v1.1.3.zip file attached to this release.
2. Go to your WordPress Admin dashboard.
3. Navigate to Plugins > Add New Plugin > Upload Plugin.
4. Upload the zip file and click "Replace current with uploaded" when prompted.

From v1.1.3 onward, all future updates will appear automatically on your standard WordPress updates page!

Family Notebook v1.1.2

=== Family Notebook ===
Contributors: qrussell
Tags: family, notebook, notes, organization, productivity, react
Requires at least: 6.0
Tested up to: 6.4
Stable tag: 1.1.2
License: GPLv2 or later

A secure, mobile-first app experience that transforms your WordPress site into a private organization hub for families and small groups.

🎉 Release Notes: Version 1.1.2 - The Collaboration & iOS Update

This minor update brings major quality-of-life improvements to how families collaborate within the app, ensuring that you never accidentally overwrite someone else's notes again. It also introduces full native-feeling support for Apple iOS devices!

✨ New Features & Improvements

• Three-Way Deep Merge Engine (Smart Auto-Merge): The app now intelligently handles concurrent edits! If two users are editing the same checklist or chore chart at the exact same time, the app will automatically merge non-conflicting items seamlessly behind the scenes. (e.g., If User A adds "Apples" and User B adds "Oranges", the app saves both instead of throwing an error!)
• Conflict Resolution UI: In the event of a "hard conflict" (where two users edit the exact same text block simultaneously), the app gracefully prevents data loss by presenting a side-by-side "Merge View." This allows you to manually review the server's version alongside your version and choose how to proceed without losing your work.
• Real-time Background Polling: The Family Notebook now quietly syncs changes from the server every 15 seconds. This keeps multiple users on the exact same page automatically, drastically reducing the chance of edit conflicts occurring in the first place.
• Full iOS PWA Support & Install Modal: iPhone and iPad users now get a first-class app experience! We've added a helpful "Install App" button with a visual guide on how to add the notebook to your iOS Home Screen. Once installed, the app will natively strip away Safari UI components for a true full-screen, edge-to-edge app experience with proper high-resolution Apple Touch Icons.

🐛 Bug Fixes

• Fixed an issue where progressive web app (PWA) meta tags were not being properly recognized by older iOS Safari browsers.

---

📦 Installation Instructions

Download the family-notebook.zip file and upload it via your WordPress Admin dashboard under Plugins > Add New > Upload Plugin, replacing the previous version.

Family Notebook v1.1.1

🚀 What's New in v1.1.1

This release brings major enhancements to the mobile experience, robust data migration tools, and significant security patches.

✨ New Features

• Bundled Starter Kit: A predefined starter workspace is now natively bundled into the plugin. Upon activation, the plugin automatically provisions a complete starter kit with folders, checklists, and global templates to help new users get started immediately.
• Native iOS PWA Support: Bridged the gap for Apple users. Added specific iOS meta tags (apple-touch-icon, apple-mobile-web-app-capable) so the app installs seamlessly to the iPhone Home Screen and utilizes a native, full-screen standalone mode.
• Workspace Color Customization: Users can now edit their workspace names and theme colors natively. The UI automatically calculates perceived brightness to dynamically switch header text between dark and light for optimal contrast.

🛠 Improvements & Migration Tools

• Selective Export Engine: Upgraded the backup tool from a simple download link to a fully selectable checklist. Administrators can now choose specific workspaces to export rather than being forced to back up the entire database.
• Smart Data Import & Relinking: When importing a .json backup to a new WordPress site, the engine now dynamically maps and re-links imported notes and workspaces to existing WordPress users by matching their email addresses.
• Emergency Workspace Reassignment: Added an administrative tool to quickly assign orphaned workspaces to a new user email if the original owner is deleted from the WordPress site.
• Cross-Platform Build Script: Added a build-zip.ps1 script to the repository utilizing the .NET framework to ensure plugin builds map forward-slashes (/) correctly, preventing extraction bugs on Linux-based WordPress servers.

🔒 Security & Bug Fixes

• Patched IDOR Vulnerabilities: Added strict fn_is_user_authorized_for_workspace() checks across user management and template API endpoints to prevent unauthorized scraping or modification of private workspaces.
• Fixed JSON Corruption (Slashes Bug): Protected rich-text blocks and templates with wp_slash() before database insertion, preventing WordPress core functions from stripping slashes and corrupting the React JSON payload.
• Workspace Member Deletion: Fixed an issue where the fn_api_remove_workspace_user endpoint was missing its backend PHP callback, allowing users to be successfully removed from workspaces.

Family Notebook v1.1.0

📝 Family Notebook v1.1 Changelog

✨ New Features & Polish

• Dynamic Workspace Customization: Owners can now easily edit workspace names and choose custom theme colors via a native color picker.
• Smart UI Contrast: The app now mathematically calculates the perceived brightness of your chosen workspace color and automatically switches text and icons between dark slate and white to ensure perfect readability.
• Seamless Data Migration: Completely overhauled the Export/Import engine. When moving the app to a new WordPress site, the system now automatically re-links users to their workspaces and restores their proper roles (Owner, Organizer, User, Viewer) using their email addresses.
• Refined Workspace Dashboard: The main dashboard now reflects your custom workspace colors with the new smart-contrast text to make your home screen pop.

🔒 Security & Bug Fixes

• Security (Critical): Patched Insecure Direct Object Reference (IDOR) vulnerabilities on user management and template endpoints, ensuring strict permission checks are enforced.
• Data Integrity: Fixed a severe JSON corruption bug where WordPress would strip slashes from rich-text blocks, permanently breaking note data.
• Bug Fix: Fixed an issue where the backend endpoint to remove a user from a workspace was missing, allowing users to be successfully removed.
• UI Fix: Replaced native emojis in the header with clean text glyphs to ensure they respect the dynamic contrast colors.

Family Notebook v1.0.0

Family Notebook v1.0.0 - Initial Release

We are thrilled to announce the initial release of Family Notebook! This plugin turns your WordPress site into a private, mobile-first organization hub designed to keep families and small groups in sync.

🌟 Overview

Family Notebook is a decoupled React Single Page Application (SPA) that delivers a native "app-like" experience directly inside your WordPress site. It is designed for maximum privacy, allowing you to manage shared shopping lists, chore charts, and family information without relying on third-party SaaS platforms.

🆕 Key Features

• Isolated Workspaces: Manage multiple, private environments (e.g., "Parent's Notebook," "Kids' Chore Chart") with dedicated theme colors for quick visual identification.

• Modern Block-Based Editor:

• Rich Text: Full formatting support for documents.

• Checklists: Interactive task management.

• Chore Charts: Gamified weekly task tracking with a responsive design that keeps task labels visible even on small mobile screens.

• Role-Based Permissions: Granular access control including Owner, Organizer, User, and Viewer roles to keep your data secure.

• Progressive Web App (PWA): Installable directly to mobile home screens for a seamless, edge-to-edge experience without theme header/footer distractions.

• Data Portability: Complete JSON-based Import/Export tools for templates, folders, and notes.

🛡️ Security & Performance Enhancements

• IDOR Protection: Comprehensive security checks on all REST API endpoints ensure users cannot access or manipulate workspaces they do not belong to.
• JSON Integrity: Optimized backend saving functions ensure rich-text content remains intact and corruption-free.
• Smart Sync Engine: Implemented browser-based visibility tracking to reduce server load by pausing background polling when the app is inactive, while ensuring instant sync the moment a user returns to the tab.

📦 What's Included

• Core Plugin Logic: Custom Post Types (fn_note_page, fn_template) and custom database tables for secure, relational membership management.
• Admin Settings: Global control for your app's login URL and a "Starter Kit" provisioning system to automatically populate new workspaces.
• User Migration: Built-in tool to re-link workspace members to new site users via email lookup after site migrations.

🚀 Installation & Usage

1. Download: Get the latest .zip file from the [Releases page](https://www.google.com/search?q=https://github.com/qrussell/family-notebook/releases).
2. Upload: Navigate to Plugins > Add New > Upload Plugin in your WordPress dashboard.
3. Deploy: Place the shortcode [family_notebook_app] onto any page.
4. Configure: Visit Family Notebook > Settings to set your primary login URL and starter workspace.

📝 Roadmap & Future Updates

This is our initial stable release. Future updates will focus on:

• Advanced Chore Chart Logic: Adding recurring assignment automation.
• Notification Integration: Automated email alerts for new notes or shared list updates.
• Direct File Uploads: Integrated media library support for image attachments within notes.

---

Thank you for using Family Notebook! If you encounter issues, please open an issue on our [GitHub Repository](https://www.google.com/search?q=https://github.com/qrussell/family-notebook/issues).