Changelog

User Profile Pages Enhancements:

• Enhanced profile header with gradient backgrounds and glow effects
• Improved avatar presentation with gradient border and better shadows
• Fixed avatar parallax (now stays fixed on scroll)
• Repositioned score badge directly under username with icon
• Larger, bolder typography with better spacing
• Enhanced stats cards with gradient borders and hover animations
• Improved player activity section with better card designs
• Added 3D tilt effect to game cards on mouse movement
• Implemented entrance animations with stagger effects
• Better responsive design for mobile devices

Organization Pages Improvements:

• Enhanced sidebar with modern type breakdown filters
• Improved package cards with better hover states
• Added gradient backgrounds and smooth transitions
• Better filter buttons with active state indicators
• Enhanced package overlay with fade-in effects
• Improved grid layout and spacing
• Added loading states and animations

Pagination Enhancements:

• Modern container design with gradient backgrounds
• Enhanced buttons with icon animations
• Smart ellipsis for large page counts
• Improved info display with package and page indicators
• Added Material Icons for Previous/Next buttons
• Smooth entrance and hover animations
• Better accessibility and responsive design
• Glow effect on active page

Animations & Effects:

• Entrance animations for all major sections
• Staggered fade-in effects for stats and cards
• Number counting animations
• 3D tilt effects on game cards
• Smooth transitions with cubic-bezier easing
• Shine effects on hover
• Reduced motion support

Accessibility:

• Improved focus states for keyboard navigation
• Better color contrast
• ARIA labels and semantic HTML
• High contrast mode support
• Screen reader friendly

Responsive Design:

• Better breakpoints (1024px, 768px, 480px)
• Mobile-optimized layouts
• Touch-friendly interactions
• Flexible grids that adapt to screen size

Technical:

• Created frontend/css/org-enhancements.css
• Enhanced frontend/css/user-profile.css
• Improved frontend/css/pagination.css
• Updated frontend/js/user-profile.js with new animations
• Updated frontend/js/org-page.js with enhanced interactions
• Added IMPROVEMENTS.md documentation

• Implement Ko-fi webhook handler for real-time donation processing
• Create public donation page (/donate) with supporter list and stats
• Add admin donation management interface with test donation creation
• Implement currency formatting helper for proper amount display
• Add donation database with SQLite storage and statistics tracking
• Secure verification token in config file (not committed)
• Add masked token display in admin panel with copy functionality
• Integrate donation link in footer navigation
• Style donation pages to match dark theme design system

• Create centralized breadcrumb helper with consistent rendering
• Add proper ARIA attributes for accessibility (role, aria-label, aria-current)
• Implement auto-generated separators via CSS
• Fix 'About This Package' JSON rendering bug with proper parser
• Support JSON description structures (headings, lists, code, images, attachments)
• Update all 13 pages to use standardized breadcrumb component
• Consolidate breadcrumb CSS into packages.css
• Add responsive breadcrumb styles for mobile devices
• Remove unnecessary hover effects and animations
• Enhance description section CSS for tables, attachments, and additional elements
• Maintain theme consistency across all pages

Pages updated:

• index.php (package detail, user profile, error pages)
• settings.php, legal.php, about.php, credits.php
• newspost.php, news.php, orgnews.php, release-notes.php
• changelog.php, api-doc.php, ugc-charts.php

All changes validated with no syntax errors or diagnostics issues.

• Show only first 5 tags by default when more than 5 exist
• Add toggle button to expand/collapse all tags
• Maintain accessibility with proper ARIA attributes
• Keep Material Symbols icons and existing styling
• Add smooth transitions and theme-consistent design

• Created new Credits page (/credits) with full acknowledgements
• Special thanks section to Facepunch Studios with contact info
• Organized credits into sections: Core Tech, Frontend, Backend, APIs, Infrastructure
• Enhanced visual presentation with card-based layouts and icons
• Improved About page with mission statement and unique content
• Added 'What Makes Us Different' section highlighting key features
• Removed duplicate content between About and Credits pages
• Added Credits link to footer navigation
• Integrated Credits route into routing system
• Both pages now fully responsive and visually polished

• Add full news article routing and display system
• Fetch news from package LatestNews field and /news API
• Implement modern glassmorphism design for articles
• Add horizontal news card layout with hover effects
• Improve Description section with rich HTML rendering
• Add Latest News section to package detail pages
• Implement news article pages with sections, author cards, and hero media
• Add SEO meta tags (Open Graph, Twitter Card)
• Add breadcrumb navigation and back buttons
• Implement caching for news data
• Add proper 404 error handling
• Style news cards with gradient effects and animations
• Make all layouts responsive for mobile devices

• Support direct linking to specific sections via URL hashes:
• /legal#terms - Terms of Service
• /legal#privacy - Privacy Policy
• /legal#data-collection - Data Collection Details
• /legal#user-rights - Your Rights
• /legal#contact - Contact Information
• Auto-scroll to section based on URL hash on page load
• Update URL hash when clicking quick navigation items
• Handle browser back/forward navigation with hashchange event
• Add visual feedback for active navigation item
• Add .htaccess rewrite rule for /legal without .php extension
• Update settings.php link to use hash-based navigation
• Smooth scroll with header offset for better UX

• Support direct linking to specific tabs via URL hashes:
• /settings#account
• /settings#privacy
• /settings#notifications
• /settings#appearance
• Auto-activate tab based on URL hash on page load
• Update URL hash when switching tabs (without page reload)
• Handle browser back/forward navigation with hashchange event
• Add .htaccess rewrite rule for /settings without .php extension
• Update legal.php links to use hash-based navigation
• Maintain backward compatibility with existing routing

• Add data export API endpoint at /backend/api/settings.php
• Implement 'Download My Data' button in Privacy & Data settings tab
• Export user data in machine-readable JSON format including:
• Profile information (Steam ID, username, avatar)
• User preferences (theme, layout, notifications)
• Session history with obscured IP addresses
• Update legal.php with data portability information
• Configure routing for /api/settings endpoint
• Add user-friendly UI with loading states and toast notifications

• Created fully functional legal page at /legal with ToS and Privacy Policy
• Added TL;DR summary section for quick understanding
• Implemented interactive features: smooth scrolling, section highlighting, copy-to-clipboard
• Added visual data retention timeline with color-coded badges
• Created comprehensive FAQ section with 8 common questions
• Enhanced data collection section with visual cards
• Added actionable user rights guide with step-by-step instructions
• Implemented version history tracking
• Added print/save as PDF functionality
• Included scroll-to-top button and notification system
• Updated footer with both official s&box Discord and s&box Explorer Discord links
• Added proper meta tags for SEO
• Fully responsive design consistent with existing codebase
• Print-friendly styles for documentation purposes

• Added 3-tab interface: Active Now, Recent (7 Days), All History
• All History shows unique users only (no duplicates)
• IP addresses obscured in All History tab (e.g., 5.55.x.x)
• Added session duration and status badges
• Improved UI with Material icons and color-coded activity status

• Add visual distinction for commit types (feat, fix, chore, refactor, docs, style, perf, test, ci)
• Each type has unique color scheme, icon, and badge
• Add filter bar to view commits by type
• Filter buttons show commit counts per type
• Filters persist across pagination
• Mobile-responsive filter design
• Integrate seamlessly with existing theme system

Layout & Visual Improvements:

• Added consistent spacing variables (--spacing-xs through --spacing-2xl)
• Enhanced typography with responsive clamp() sizing for all headings
• Improved card hover effects with gradient overlays and animated accent lines
• Optimized package cards with subtle scale effects (reduced from 4px to 3px)
• Enhanced breadcrumb navigation with proper separators and hierarchy
• Added smooth transitions and reduced excessive hover effects for natural feel

Breadcrumb Enhancements:

• Fixed breadcrumb structure: Home Organization Package
• Removed manual '/' separators, added CSS-based separators
• Enhanced styling with hover effects and icon animations
• Improved accessibility with better focus states
• Added proper ARIA labels and semantic structure

Admin Panel - User Session Tracking:

• Created comprehensive session tracking system (config/session_tracking.php)
• Added user_sessions database table with indexes
• Implemented automatic activity tracking on page loads
• Created /admin/active-users.php showing real-time logged-in users
• Added session statistics: active now, today, this week, all-time
• Tracks Steam ID, username, avatar, IP address, login/activity times
• Auto-refreshes every 30 seconds for real-time monitoring
• Created /admin/test-sessions.php debug page for troubleshooting

Admin Panel UI:

• Added User Activity card with live statistics
• Enhanced visual consistency with gradient backgrounds
• Added animated accent lines on hover for cards
• Improved responsive design for mobile/tablet
• Better spacing and typography throughout
• Fixed Material Symbols icon loading and CSS

Routing & Access:

• Fixed router.php to allow direct access to admin PHP files
• Updated .htaccess to properly route admin and auth directories
• Ensured admin pages are accessible while maintaining security

Technical Improvements:

• Fixed SQL date/time queries for better SQLite compatibility
• Added proper error handling and logging
• Implemented session cleanup (30-day retention)
• Added database connection fallbacks
• All PHP files validated with no syntax errors

Thematic Consistency:

• Unified shadow depths and border treatments
• Consistent transition timing (0.2-0.3s) across all components
• Enhanced focus states for better accessibility
• Improved color contrast and visual hierarchy

• Implement /ugc/charts/game and /ugc/charts/map endpoints
• Fetch live data from Facepunch Services API with 30-minute cache
• Display 5 chart sections: Popular Today, Popular This Month, Trending Now, Most Favorited, Newest Releases
• Integrate with CacheManager for centralized SQLite-based caching
• Add responsive design with glassmorphism effects and smooth animations
• Include Charts navigation link in header
• Support stale cache fallback on API failures

• Split 's&box Explorer' text into individual letter spans using JavaScript
• Add CSS animations for letter-by-letter slide-in effect with bounce
• Animation triggers only when hovering over the brand icon
• Includes staggered delays, color transitions, and smooth cubic-bezier easing
• Scoped to .nav-brand and its children for minimal impact"

• Implement CacheManager class for centralized cache handling
• Add migration utility for existing JSON caches to SQLite
• Support multiple cache types (org_packages, user_packages, etc.)
• Include database schema and initialization

• Add authentication state tracking to prevent unnecessary API calls
• Handle 401 Unauthorized responses gracefully
• Implement proper fallback behavior for unauthenticated users
• Skip server saves when user is not authenticated
• Improve error handling and logging for theme settings

• Added a red animated badge to mark non-working features in the UI
• Created CSS animations for pulsing and shining effects
• Improved accessibility with proper ARIA labels
• Enhanced the layout preference section in settings

• Add user profile page with settings
• Implement theme switching functionality
• Update API endpoints for user preferences
• Modify .htaccess for new routes
• Update changelog with recent changes

• Enhance theme management and user profile UI
• Update API endpoints and header includes
• Add user settings functionality
• Update configuration templates

• Added lightbox-data.php to manage media data for the lightbox component
• Included the script in index.php for media pages
• Updated changelog.json with the latest changes

• Added main.js, package-detail.js, and user-profile.js
• Updated refresh-worker.php and index.php with new features
• Updated changelog.json to reflect recent changes

• Updated favicon declarations to remove duplicates
• Fixed web manifest paths and configuration
• Added proper browserconfig.xml for Windows tiles
• Improved .htaccess rules for static assets
• Ensured proper content types for web manifest
• Added proper cache control headers for static assets

• Updated fixAvatarUrl to handle Steam avatars and ensure highest resolution
• Process avatar URLs in meta-tags.php to use full resolution avatars
• Improved URL handling for both Steam and s&box avatar sources
• Updated Twitter card meta tags with correct profile information
• Ensured HTTPS is used for all avatar URLs

• Implemented package version history API integration
• Added fetchPackageVersions() function to fetch version data
• Created collapsible version history section on package detail page
• Display version ID, date, changelog, file count, size, and engine version
• Added formatBytes() utility function for human-readable file sizes
• Fixed FullIdent fallback when not present in API response
• Changed hero image to use last screenshot (most recent) instead of first
• Added version history CSS styling with hover effects and clean layout
• Version list shows up to 10 most recent versions

• Added 10 new API endpoints (featured, trending, downloads, rating, updated, sounds, particles, status, package list, player overview)
• Extended package type filters to include all 12 types (added sounds and particles)
• Enhanced sort dropdown with 5 new sorting options (Featured, Trending, Most Downloaded, Highest Rated, Recently Updated)
• Implemented AJAX-based filtering for instant results without page reloads
• Updated fetchPackagesApi to use new specialized endpoints
• Added support for type-specific API endpoints (/api.php/packages/{type})
• Improved filter button functionality with visual feedback
• Enhanced sort dropdown to work seamlessly with new API endpoints
• Updated API documentation (api-doc.php) with all new endpoints
• Created comprehensive testing tool (tools/test-api-endpoints.php)
• All 45+ API endpoints now fully functional and integrated
• Maintained backward compatibility with existing functionality

• Added /orgnews page showing all package news from organizations
• Created newspost.php for displaying full news posts with sections
• Updated API with news endpoints (/api.php/news and /api.php/news/org)
• Added news routes to index.php
• Updated navigation header with News and Org News links
• Improved schema.py to discover more API endpoints dynamically
• News posts display rich content including images, galleries, and formatted text

• Created install-git-hooks scripts for Windows, Linux, and Mac
• Pre-commit hook automatically generates changelog.json
• Automatically adds changelog.json to commit if changed
• Updated README with installation instructions
• No more manual changelog generation needed
• Hook can be disabled by deleting .git/hooks/pre-commit

• Added pagination showing 20 commits per page
• Shows all commits (87 total) instead of just 50
• Added GitHub commits link button in header
• Pagination shows current page, prev/next, and page numbers
• Added hover effects for pagination buttons
• Updated generate-changelog.php to support 'all' parameter
• Displays commit count and range info
• Responsive pagination layout

• Created changelog.php that displays git commits as a changelog
• Groups commits by date with sticky date headers
• Shows commit subject, body, author, time, and hash
• Matches S&box design system with gradients and styling
• Added changelog link to all navigation menus
• Added route handling for /changelog in index.php
• Beautiful card-based layout with hover effects
• Color-coded commit metadata badges

• Implemented reusable CollapsibleManager JavaScript module
• Added comprehensive CSS styling with multiple variants (compact, accordion, card, etc.)
• Applied collapsible sections to package detail pages (usage stats, reviews, package details, config, dependencies)
• Applied collapsible sections to API documentation endpoints
• Added state persistence using localStorage
• Included keyboard navigation and accessibility features (ARIA attributes)
• Added expand/collapse all controls
• Usage Statistics section expanded by default, others collapsed
• Improves page responsiveness and reduces initial page length

• Update api-doc.php to use live API testing instead of mock data
• Add proper response display with success/error indicators and response times
• Fix Copy cURL button with fallback for non-HTTPS environments
• Add API root endpoint showing available endpoints and documentation link
• Fix favicon.ico being incorrectly cached as org route
• Add comprehensive path exclusion for static files (favicon, robots.txt, etc)
• Restore comprehensive package fetching with alphabetical scanning
• Fix cache auto-refresh logic to properly update after 30 minutes
• Increase execution timeout to 120 seconds for large org fetches
• Remove tag-based queries to reduce API calls and improve speed

• Add full player data display from S&Box API endpoint
• Implement player stats grid (games played, sessions, hours, achievements, favorites, score)
• Add online/offline status indicator with animated pulse effect
• Display most played and latest played games with rich cards
• Show player avatar customization details
• Add player activity section with enhanced styling
• Implement caching for player data (5-minute TTL)
• Update all pages to use S&Box favicon (https://sbox.game/favicon.ico)
• Create modular player-activity.php include file
• Enhance CSS with gradient effects, hover animations, and improved layouts
• Fix fetchPlayerData to use S&Box API directly instead of self-referencing
• Add proper error handling and fallbacks for missing data

• Automatically redirect /u/steamid64 to /u/vanityurl
• Resolve vanity URLs to Steam IDs for player data
• Support both formats: /u/76561197991348132/ and /u/PatrickJr/
• Use Steam API to resolve vanity URLs
• Seamless user experience with clean URLs

• Fetch player data from S&box API using Steam ID
• Display player stats, achievements, and activity
• Redirect users to their profile after Steam login (/u/steamid/)
• Admins still go to admin panel
• Organizations use direct route (/orgname/)
• Player profiles use /u/ route (/u/steamid/)

• Admins redirected to /admin/ panel after login
• Regular users redirected to homepage
• Better UX for different user roles

• Cache Analytics: total packages, avg per org, largest org
• Recent Logs Viewer: last 30 entries with color coding
• Disk Space Monitor: show free disk space
• Bulk Operations: refresh all cached organizations at once
• Enhanced System Info: added OpenSSL status, disk space
• Better statistics and insights
• Color-coded log levels (ERROR=red, WARNING=orange, SUCCESS=green)

• Cache under 30 minutes: served instantly
• Cache over 30 minutes: auto-refreshes on next visit
• Ensures data is always reasonably fresh
• Admin can still force refresh anytime with ?refresh=1

• Create dedicated admin panel at /admin/
• Cache management: view stats, clear cache, refresh specific orgs
• System information: PHP version, extensions, limits
• Quick actions: refresh organizations, clear logs
• List all cached organizations with age and size
• Admin badge in navigation links to admin panel
• Require admin authentication for access
• Beautiful gradient UI with cards and statistics

• Implement Steam OpenID authentication
• Add admin system with configurable Steam IDs
• Protect cache refresh functionality (admin-only)
• Add user menu with avatar, username, and admin badge
• Create auth endpoints: login, callback, logout
• Add Steam login button to navigation
• Style authentication UI with responsive design
• Add .gitignore for sensitive config files
• Include config.example.php for setup instructions

• Bypass S&box API 400-package limit using multi-query strategy
• Phase 1: General org search (400 packages)
• Phase 2: Type-specific queries (11 types)
• Phase 3: Tag-based queries for types hitting limits
• Phase 4: Alphabetical scanning for high-volume types (200+ packages)
• Implement 1-hour caching to improve load times
• Add cache status indicator with manual refresh option
• Increase execution time to 5 minutes for refresh operations
• Add pagination to organization pages (20 per page)
• Successfully fetch 1,717+ packages for Facepunch (vs 400 before)
• Update API documentation with all endpoints
• Add helpful notices about API limitations

• Redesign sort dropdown with modern, consistent styling
• Add custom dropdown arrow and smooth transitions
• Implement 6 sort options: Default, Popular, Favorites, Recent, Trending, Name
• Add client-side sorting logic for all sort types
• Sort by upvotes, favorites, update date, active users, or alphabetically
• Preserve sort selection across pagination
• Reset to page 1 when changing sort order
• Make dropdown fully responsive on mobile
• Add hover and focus states matching site design
• Integrate sort parameter with type filters

• Add pagination component with 20 items per page default
• Create pagination.css with responsive, accessible design
• Add pagination.php helper with calculation and rendering functions
• Add pagination.js for smooth interactions and keyboard navigation
• Implement type filters (Games, Maps, Libraries, Clothing, Models)
• Filters now reload page with proper URL parameters
• Pagination preserves filter state across pages
• Add fetchPackagesByType() function for filtered API requests
• Update filter buttons to show active state based on URL
• Include first/prev/next/last navigation buttons
• Add items per page selector (20, 30, 50, 100)
• Display info showing current range and total items