CHANGELOG

1.7.38 - 2026-02-15

Fix Ecto.ChangeError in entities by using DateTime instead of NaiveDateTime
Fix infinite recursion risk in category circular reference validation
Add DateTime inconsistency audit report with phased migration plan

1.7.37 - 2026-02-15

Fix UUID PR review issues: aliases, dashboard_assigns, and naming issues
Fix V56 migration: add subscription_plans to uuid column setup lists
Add admin edit buttons and improve shop catalog UX
Add registry-driven admin navigation system
Fix localized field validation in Shop forms
And bunch of bugs and optimizations

1.7.36 - 2026-02-13

Add storefront sidebar filters, category grid, and dashboard shop integration
- New CatalogSidebar component: reusable sidebar with collapsible filter sections and category tree navigation
- New FilterHelpers module: filter data loading, URL query string building, price/vendor/metadata filtering
- Storefront filter configuration in admin settings: enable/disable filters, edit labels, add metadata option filters
- Auto-discovery of filterable product metadata options (e.g., Size, Color) with one-click filter creation
- Price range filter with min/max inputs and range display
- Vendor and metadata option filters with checkbox selection and active count badges
- Filter state persisted in URL query params for shareable filtered views
- "Show Categories in Shop" setting: displays category card grid above products on main shop page
- Sidebar category navigation always visible in sidebar (decoupled from grid setting)
- Dashboard layout integration: shop filters and categories rendered in dashboard sidebar for authenticated users
- sidebar_after_shop slot in dashboard layout for injecting custom sidebar content
- Product detail page updated to use shared sidebar and filter context for consistent navigation
- Mobile filter drawer with toggle button and active filter count badge
- Category page filters scoped to category products
- Fix phx-value-value collision on filter checkboxes: renamed to phx-value-val to avoid HTML checkbox value="on" overwrite
- Known issue: metadata option filters (e.g., Size) may not filter correctly in all cases; needs further investigation
Add file upload field type to Entities module
- New file field type with configurable max entries, file size, and accepted formats
- FormBuilder renders file upload UI with drag-and-drop zone (admin entity forms, placeholder)
- New :advanced field category
Fix 3 remaining UUID migration bugs in billing forms
Fix 8 UUID migration bugs found in PR #330 post-merge review
Add UUIDv7 migration V56 with dual-write support

1.7.35 - 2026-02-12

Rewrite Sitemap module to sitemapindex architecture with per-module files
- /sitemap.xml now returns a <sitemapindex> referencing per-module files at /sitemaps/sitemap-{source}.xml
- Dual mode support: "Index mode" (per-module files, default) and "Flat mode" (single urlset when Router Discovery enabled)
- New Source behaviour callbacks: sitemap_filename/0 and sub_sitemaps/1 for per-group file splitting
- New Generator.generate_all/1 and generate_module/2 with auto-splitting at 50,000 URLs
- FileStorage rewrite with save_module/2, load_module/1, delete_module/1, list_module_files/0
- Cache rewrite supporting {:module_xml, filename} and {:module_entries, source} keys
- Per-module stats stored as JSON in Settings with get_module_stats/0
- Per-module regeneration via SchedulerWorker.regenerate_module_now/1 (Oban)
- Settings UI overhaul: per-module sitemap cards with stats, regeneration buttons, mode indicators
- Publishing source: per-blog sub-sitemaps via sitemap_publishing_split_by_group setting
- Entities source: per-entity-type sub-sitemaps
- Static source: login page excluded, registration conditionally included
- Router Discovery default changed to false (index mode is new default)
- Removed "cards" XSL style; added sitemap-index-minimal.xsl and sitemap-index-table.xsl
- Sitemap routes no longer go through :browser pipeline (public XML endpoints)
Add PDF support for Storage module
- New PdfProcessor module using poppler-utils (pdftoppm, pdfinfo)
- First page rendered to JPEG thumbnail at configurable DPI
- PDF metadata extraction (page count, title, author, creator, creation date)
- VariantGenerator extended for document/PDF MIME types
- Media UI: inline PDF viewer on detail page, PDF badges on thumbnails, metadata display
- New system dependency checks for poppler in Dependencies module
Fix option price display for options with all-zero modifiers
- New has_nonzero_modifiers?/1 filters out option groups where all price modifiers are zero
- Price modifiers displayed as badges on option buttons (e.g., "+$5.00")
- Cart saves all selected specs including non-price-affecting options (e.g., Color)
- build_cart_display_name/3 includes all selected specs in display name
Fix category icons fallback to legacy product images
- Category.get_image_url/2 falls back to featured_product.featured_image (legacy URL)
- Product detail respects shop_category_icon_mode setting for category subtab icons
- Guard clauses tightened for Storage vs legacy URL handling
Add ImportConfig filtering at CSV preview stage
- Config filters applied during CSV analysis/preview, not just during import
- Import wizard shows skipped product count with warning badge
- Category creation uses language normalization for consistent JSONB slug keys
- Imported option labels use _option_slots metadata for proper display names
Fix admin sidebar full-page reload after upstream merge
- Comments and Sync routes merged into main admin live_session
Add runtime sitemaps directory to gitignore

1.7.34 - 2026-02-11

Extract Comments into standalone reusable module (V55 migration)
- New PhoenixKit.Modules.Comments context with polymorphic resource_type + resource_id associations
- New tables: phoenix_kit_comments, phoenix_kit_comments_likes, phoenix_kit_comments_dislikes
- Reusable CommentsComponent LiveComponent that can be embedded in any resource detail page
- Threaded comments with configurable max depth and content length
- Like/dislike system with atomic counter cache
- Moderation admin UI at {prefix}/admin/comments with filters, search, and bulk actions
- Module settings page at {prefix}/admin/settings/comments
- Resource handler callback system for notifying parent modules (e.g., Posts) of comment changes
- "comments" permission key added (25 total permission keys, 20 feature modules)
- Posts module refactored to consume Comments module API instead of inline implementation
- Legacy phoenix_kit_post_comments tables preserved for backward compatibility
Add shop enhancements, sitemap sources, and admin navigation fix
- Shop module improvements: product options toggle, import configs, drag-and-drop reordering, catalog language redirects
- Sitemap module: shop source (categories, products, catalog), data source toggles in settings UI
- Admin sidebar seamless navigation (consolidate live_sessions)
- Migration fixes and V54 addition
Fix preview-to-editor round-trip state and data loss bugs
- Fix 8 bugs in the preview_token handle_params path that had diverged from the other editor entry points as features were added over time
- Merge disk metadata into preview post to prevent silent data loss when saving after a preview round-trip
- Add error logging to enrich_from_disk for observability
Add module-level permission system for role-based admin access control
- Custom roles can now be granted granular access to specific admin sections and feature modules. Permissions are managed through a new interactive matrix UI, enforced at both route and sidebar level, and update in real-time across all admin tabs via PubSub.

1.7.33 - 2026-02-04

Add module-level permission system (V53 migration)
- phoenix_kit_role_permissions table with allowlist model (row present = granted)
- 24 permission keys: 5 core sections + 19 feature modules
- Owner bypasses all checks; Admin seeded with all 24 keys by default
- Custom roles start with no permissions, assigned via matrix UI or API
- PhoenixKit.Users.Permissions context for granting, revoking, and querying role permissions
- Interactive permission matrix at {prefix}/admin/users/permissions
- Inline permission editor in Roles page with grant/revoke all
- Route-level enforcement via phoenix_kit_ensure_admin and phoenix_kit_ensure_module_access
- Sidebar nav gated per-user based on granted permissions
- Real-time PubSub updates: permission changes reflect across all admin tabs
- Backward compatible: pre-existing Admins retain full access before V53 migration
Add PubSub events for real-time updates in Tickets and Shop modules
- Tickets.Events module with broadcast for ticket lifecycle (created, updated, status changed, assigned, priority changed)
- Comment and internal note events for ticket discussions
- Shop.Events extension with product, category, inventory events
- LiveViews subscribe to events for real-time UI updates
Add User Deletion API with GDPR-compliant data handling
- delete_user/2 with cascade delete for related data (tokens, OAuth, billing profiles, carts)
- Anonymization strategy for orders, posts, comments, tickets, email logs, files
- Protection: cannot delete self, cannot delete last Owner
- Admin UI with delete button, confirmation modal, and real-time list updates
- Broadcast :user_deleted event for multi-admin synchronization
Fix compilation errors in auth.ex (pin operator with dynamic Ecto queries)
Update core PhoenixKit schemas and Referrals to new UUID standard
Update Shop module with localized slug support and unified image gallery
Add PubSub events for Tickets and Shop modules, User Deletion API
Added support for uuid to referral module
Add markdown rendering and bucket access types
Update Sync module to new UUID standard pattern
Update billing module to use DB-generated UUIDs
Update entities module to UUID standard matching AI module

1.7.32 - 2026-02-03

Storage Module: Smart file serving with bucket access types (V50 migration)
- Add access_type field to buckets: "public", "private", "signed"
- Local files are now served directly without temp file copying (performance improvement)
- Public cloud buckets redirect to CDN URL (faster, reduces server load)
- Private cloud buckets proxy files through server (for ACL-protected storage)
- Add retry logic for bucket cache race conditions during file access
⚠️ BREAKING CHANGE: Cloud Bucket Access Type
Cloud buckets (S3, B2, R2) now default to access_type = "public", which redirects users directly to the bucket's public URL instead of proxying through the server.
If you have private/ACL-protected buckets:
- Go to Storage → Buckets → Edit your bucket
- Set "Access Type" to "Private"
- Files will be proxied through the server using credentials (previous behavior)
If you have public buckets (redirect mode):
For redirect to work, your bucket must be publicly accessible:
1. Enable Public Access in your cloud provider settings:
  - AWS S3: Disable "Block all public access" and set bucket policy
  - Backblaze B2: Set bucket to "Public"
  - Cloudflare R2: Configure public access or use Custom Domain
2. Configure CORS if serving files cross-origin (required when your site domain differs from bucket domain):
  AWS S3 / R2 CORS configuration example:
```
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedOrigins": ["https://yourdomain.com"],
    "ExposeHeaders": ["ETag", "Content-Length"],
    "MaxAgeSeconds": 3600
  }
]
```
  Replace https://yourdomain.com with your actual domain, or use "*" for any origin (less secure but simpler for testing).
See AWS documentation: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enabling-cors-examples.html

1.7.31 - 2026-01-29

Refactor publishing module into submodules and improve URL slug handling
- Storage module refactoring:
  - Split storage.ex into specialized submodules: Paths, Languages, Slugs, Versions, Deletion, and Helpers for better organization and maintainability
  - Move controller logic into submodules: Fallback, Language, Listing, PostFetching, PostRendering, Routing, SlugResolution, Translations
  - Move editor logic into submodules: Collaborative, Forms, Helpers, Persistence, Preview, Translation, Versions
- Listing page improvements:
  - Show live version's translations and statuses instead of latest version
  - Fetch languages from filesystem when version_languages cache is empty
  - Fix paths to point to live version files when clicking language buttons
  - Add "showing vN" badge that combines with version count display
  - Fix public URL to always use post's primary language
- URL slug priority system:
  - Directory slugs now have priority over custom url_slugs
  - Prevent setting url_slug that conflicts with another post's directory name
  - Auto-clear conflicting url_slugs instead of blocking saves
  - Show info notice when url_slugs are auto-cleared due to conflicts
  - Clear conflicting url_slugs from ALL translations, not just current one
  - Clear conflicting custom url_slugs when new post is created

1.7.30 - 2026-01-28

Posts Module
- Add likes and dislikes system for post comments (V48 migration)
- Post body field is no longer required
User Management
- Add dropdown field type support for user custom fields
Shop Module (E-commerce)
- Fix JSONB search queries and add defensive guards for robustness
- Fix JSONB localized fields consistency across product/category operations
- Add shop import enhancements with V49 migration
- Fix image migration robustness and catalog display issues
- Add language selection dropdown to CSV import for localized content
- Add variant image mapping support for Shop products
- Add legacy image support for backward-compatible variant mappings
Bug Fixes
- Fix UUID column error for auth tables during upgrade - Users upgrading from PhoenixKit < 1.7.0 no longer get "column uuid does not exist" error when logging in. Added auth tables (users, tokens, roles, role_assignments) to UUIDRepair module.

1.7.29 - 2026-01-26

Add primary language improvements and AI translation progress tracking
- Real-time translation progress - Added progress bars to editor and listing pages showing AI translation status
- Primary language improvements - Posts now store their primary language for isolation from global setting changes
- Language handling fixes - Fixed base code to dialect mapping (e.g., en → en-US) across public URLs and editor
- UI polish - Updated language switcher colors, modal text, and added prominent primary language display in editor
- Documentation - Added comprehensive README for the Languages module

1.7.28 - 2026-01-24

Major improvements to the Publishing module's multi-language workflow: renamed "master" to "primary" terminology, fixed URL routing with locales, added language migration tools, improved cache performance, and fixed several UI/UX issues in settings and admin pages.
- Multi-Language System Improvements
  - Rename master to primary terminology - Updated all references from "master language" to "primary language" for consistency and clarity
  - Fix language in URL breaking navigation - Resolved issues where locale prefixes in URLs caused routing problems
  - Isolate posts from global primary_language changes - Posts now store their own primary language, preventing drift when global settings change
  - Add "Translate to This Language" button - Quick translation action for non-primary languages in the editor
  - Sort languages in dropdowns - Consistent alphabetical sorting across all language selectors
- Migration Tools
  - Add version structure migration UI - Visual indicators and migration buttons throughout the publishing module
  - Fix legacy post migration - Resolved "post not found" errors when migrating from legacy to versioned structure
  - Handle dual directory structures - Fixed migration when both publishing/ and blogging/ directories exist
  - Add primary language migration system - Tools to migrate posts to use isolated primary language settings
- Performance
  - Improve listing performance - Read from cache when possible, reducing database/filesystem hits
  - Language caching with WebSocket transport - Faster language resolution with proper cache invalidation
  - Add Create Group shortcut - Quick access button on publishing overview page
- Settings & Admin UI Fixes
  - Fix General settings content language glitch - Resolved weird UI behavior when changing content language
  - Fix settings tab highlighting - General and Languages tabs now properly highlight on child pages
  - Fix admin header dropdowns - Theme and language dropdowns in admin header now work correctly
  - Update Entities module description - Clearer description on the Modules page
Updated the languages module added front and backend tabs for languages
Add localized routes for Shop module
- Add locale-prefixed routes (/:locale/shop/...) for multi-language Shop module support
- Add language validation to only allow enabled languages in URLs
- Add language preview switcher for admin product detail page

1.7.27 - 2026-01-19

Changed / Added
- Added prefix-aware navigation helpers and dynamic URL prefix support across dashboard, tabs, auth pages, and project home URLs, fixing issues when locale or prefix is nil.
- Introduced comprehensive dashboard branding and theming:
  - Configurable branding, title suffix, and logo handling.
  - Shared theme controller with daisyUI integration, color scheme guide, and improved theme switcher placement.
- Enhanced dashboard navigation:
  - Configurable subtab styling, redirects, highlights, and mobile subtab support.
  - Multiple context selectors with dependency support.
  - Reserved additional locale path segments for dashboard and users.
- Added context-aware features:
  - Context-aware badges with update helpers, guards for nil contexts, and improved preservation during tab refresh.
  - Consistent context-aware merge behavior.
- Improved authentication and user setup:
  - Added fetch_phoenix_kit_current_user to the auto-setup pipeline.
  - Fixed auth pages and titles to use centralized Settings/Config branding.
- Performance and quality improvements:
  - Optimized Presence and Config modules to reduce repeated checks and lookups.
  - Added dashboard_assigns/1 helper to prevent unnecessary layout re-rendering.
  - Fixed hardcoded branding and paths to rely on configuration fallbacks.
- Documentation updates:
  - Added guides for dashboard theming, tab path formats, subtab behavior, and context selectors.
  - Added prominent built-in features section and reduced overall documentation size.
Maintenance:
- Fixed Credo/Dialyzer issues, formatting problems, and test failures.
- Cleaned up unused Dialyzer ignores and added ignores for test support files.

1.7.26 - 2026-01-18

Language switcher fix

1.7.25 - 2026-01-16

Bug fix - Added check for nil on language_swithcer on log-in page

1.7.24 - 2026-01-15

Add Shop module with products, categories, cart, and checkout flow
Add user billing profiles for reusable billing information
Add payment options selection in checkout (bank transfer, card payment)
Add user order pages with UUID-based URLs
Add PubSub broadcasts to Billing module for real-time updates
Add automatic default currency for orders
Add Billing and Shop tabs to user dashboard tab system
Add automatic dashboard tabs refresh when modules are enabled/disabled
Fix user dashboard layout sidebar height calculation
Fix OAuth avatar display in admin navigation

1.7.23 - 2026-01-14

Added user functions, language switcher on login page (also support for Estonian and Russian on login)
Removed logs spamming about oban jobs

1.7.22 - 2026-01-13

Add AWS config module with centralized credential management
Add context selector for multi-tenant dashboard navigation
Add comprehensive user dashboard tab system with CLI generator
Consolidate Publishing module into self-contained structure
Publishing Module: Versioning, AI Translation, Per-Language URLs & Real-time Updates
Fixed referralcodes to referrals for more universal code

1.7.21 - 2026-01-10

Publishing Module: Versioning, AI Translation, Per-Language URLs & Real-time Updates
Fixed referralcodes to referrals for more universal code
Consolidate OAuth config through Config.UeberAuth abstraction

1.7.20 - 2026-01-09

Fix user avatar fallback when Gravatar is unavailable
Fixed issues with phx_kit install
Add scheduled job cancellation when disabling modules
Fix race condition in file controller for parallel requests

1.7.19 - 2026-01-07

We are doing code cleanup and refactoring to move forward with more new modules and more features:

Moved referral_codes module to correct location lib/modules and fixed issue with install not working
Standardize admin UI styling and add reusable components
Move Emails module to lib/modules/emails with PhoenixKit.Modules.Emails namespace
Migrate Entities, AI, and Blogging modules to lib/modules/ with PhoenixKit.Modules namespace
Updated the javascript usage to not create userspace javascript files
Move Sitemap and Billing modules to lib/modules/ with consolidated namespace
Move DB and Sync modules to lib/modules/ with PhoenixKit.Modules namespace
Moved posts module files to lib/modules folder
Add DB Explorer module

1.7.18 - 2026-01-03

Blog Versioning, Caching System, and Complete Programmatic API
Add Cookie Consent Widget (Legal Module Phase 2)
Add Legal module improvements and cookie consent enhancements

← Previous Page PhoenixKit - The Elixir Phoenix Starter Kit for SaaS apps

Next Page → PhoenixKit Integration Guide