feat: implement comprehensive logging system for Icon Manager

  - Add lightweight initialization pattern to prevent log spam during plugin startup
  - Create dedicated icon-manager-YYYY-MM-DD.log files with proper rotation (30 days)
  - Implement LoggingTrait with template substitution for readable log messages
  - Add log level configuration (error/warning/info/trace) with proper filtering
  - Fix log target configuration to match Translation Manager's clean format
  - Add comprehensive logging throughout services:
    * Cache operations (hits/misses/clears) with performance timing
    * SVG scanning and parsing with error handling
    * Icon set validation with detailed error messages in readable format
    * Database operations with performance metrics
  - Create logs management interface in Control Panel:
    * View, filter, and search log entries by date/level/content
    * Download log files for external analysis
    * Display file sizes and entry counts
    * Real-time filtering without form submission
  - Update documentation (README.md, CONFIGURATION.md) with logging features
  - Add log configuration section to settings with current level display
  - Enhance log messages to include meaningful context in readable format:
    * Icon set names instead of just IDs
    * Icon types and counts
    * Cache expiration times
    * Detailed validation errors
  - Create comprehensive translation file with 200+ logging-related strings

Author: bhlindemann

README.md

@@ -98,11 +98,14 @@ return [
     'dev' => [
         // Use source icons in dev
         'iconSetsPath' => '@root/src/icons',
-        
+
         // Enable caching in dev for performance
         'enableCache' => true,
         'cacheDuration' => 3600, // 1 hour
-        
+
+        // Detailed logging for development
+        'logLevel' => 'trace',
+
         // Allow all icon types for testing
         'enabledIconTypes' => [
             'svg-folder' => true,
@@ -126,16 +129,19 @@ return [
     'production' => [
         // Production icons path
         'iconSetsPath' => '@webroot/dist/assets/icons',
-        
+
         // Optimize for production
         'enableCache' => true,
         'cacheDuration' => 2592000, // 30 days
-        
+
+        // Minimal logging for production
+        'logLevel' => 'warning',
+
         // Only stable icon types in production
         'enabledIconTypes' => [
             'svg-folder' => true,
             'svg-sprite' => false, // Beta
-            'font-awesome' => false, // Beta  
+            'font-awesome' => false, // Beta
             'material-icons' => false, // Beta
         ],
     ],
@@ -153,6 +159,7 @@ See [Configuration Documentation](docs/CONFIGURATION.md) for all available optio
 - **enableCache** - Whether to cache icon data for better performance
 - **cacheDuration** - How long to cache icon data, in seconds
 - **enabledIconTypes** - Enable/disable specific icon set types
+- **logLevel** - Logging verbosity: error, warning, info, or trace
 
 ### Creating Icon Sets
 
@@ -433,10 +440,40 @@ return [
 
 ## Logging
 
-Icon Manager logs warnings and errors to dedicated date-based log files:
+Icon Manager includes comprehensive logging with configurable levels:
+
+### Log Levels
+- **Error**: Critical errors only
+- **Warning**: Errors and warnings
+- **Info**: General information
+- **Trace**: Detailed debugging (includes performance metrics)
+
+### Configuration
+```php
+// config/icon-manager.php
+return [
+    'logLevel' => 'info', // error, warning, info, or trace
+];
+```
+
+### Log Files
 - **Location**: `storage/logs/icon-manager-YYYY-MM-DD.log`
-- **What's logged**: Missing icons, errors, warnings
-- **Not logged**: Info messages, routine operations
+- **Retention**: 30 days (automatic cleanup)
+- **Format**: Structured logs with context data
+- **Web Interface**: View and filter logs in CP at Icon Manager → Logs
+
+### What's Logged
+- **Error**: File system failures, SVG parsing errors, database errors
+- **Warning**: Missing icons, empty content, slow operations (>1s)
+- **Info**: Icon set operations, cache clears, major actions
+- **Trace**: Cache hits/misses, performance timing, API requests
+
+### Log Management
+Access logs through the Control Panel:
+1. Navigate to Icon Manager → Logs
+2. Filter by date, level, or search terms
+3. Download log files for external analysis
+4. View file sizes and entry counts
 
 ## Environment-Specific Paths
 

docs/CONFIGURATION.md

@@ -16,14 +16,17 @@ You can override plugin settings by creating an `icon-manager.php` file in your
 return [
     // Plugin settings
     'pluginName' => 'Icon Manager',
-    
+
     // Icon sets path
     'iconSetsPath' => '@root/src/icons',
-    
+
     // Caching settings
     'enableCache' => true,
     'cacheDuration' => 86400, // 24 hours in seconds
-    
+
+    // Logging settings
+    'logLevel' => 'info', // error, warning, info, trace
+
     // Icon types to enable
     'enabledIconTypes' => [
         'svg-folder' => true,
@@ -60,6 +63,7 @@ return [
         'iconSetsPath' => '@root/src/icons',
         'enableCache' => true,
         'cacheDuration' => 3600, // 1 hour
+        'logLevel' => 'trace', // Detailed logging for development
         'enabledIconTypes' => [
             'svg-folder' => true,
             'svg-sprite' => true,
@@ -80,10 +84,11 @@ return [
         'iconSetsPath' => '@webroot/dist/assets/icons',
         'enableCache' => true,
         'cacheDuration' => 2592000, // 30 days
+        'logLevel' => 'warning', // Minimal logging for production
         'enabledIconTypes' => [
             'svg-folder' => true,
             'svg-sprite' => false, // Beta
-            'font-awesome' => false, // Beta  
+            'font-awesome' => false, // Beta
             'material-icons' => false, // Beta
         ],
     ],
@@ -99,6 +104,7 @@ return [
     'enableCache' => getenv('ICON_MANAGER_CACHE') === 'true',
     'cacheDuration' => (int)getenv('ICON_CACHE_DURATION') ?: 86400,
     'iconSetsPath' => getenv('ICON_SETS_PATH') ?: '@root/icons',
+    'logLevel' => getenv('ICON_LOG_LEVEL') ?: 'info',
 ];
 ```
 
@@ -117,6 +123,14 @@ return [
 - **enableCache**: Enable/disable icon data caching for better performance
 - **cacheDuration**: How long to cache icon data in seconds
 
+#### Logging Settings
+
+- **logLevel**: Logging verbosity level
+  - `error` - Critical errors only
+  - `warning` - Errors and warnings
+  - `info` - General information (recommended for production)
+  - `trace` - Detailed debugging with performance metrics (development only)
+
 #### Icon Type Settings
 
 - **enabledIconTypes**: Enable/disable specific icon set types
@@ -159,6 +173,44 @@ For production environments:
 'cacheDuration' => min((int)getenv('CACHE_DURATION') ?: 86400, 604800), // Max 7 days
 ```
 
+## Logging Configuration
+
+### Log Levels and Performance
+
+Choose the appropriate log level for your environment:
+
+- **Production**: Use `warning` or `error` to minimize log volume
+- **Staging**: Use `info` for operational visibility
+- **Development**: Use `trace` for debugging and performance analysis
+
+### Log File Management
+
+- **Location**: `storage/logs/icon-manager-YYYY-MM-DD.log`
+- **Retention**: 30 days automatic cleanup
+- **File Size**: Includes file size display in CP interface
+- **Web Interface**: Access via Icon Manager → Logs in Control Panel
+
+### Environment-Specific Logging
+
+```php
+'dev' => [
+    'logLevel' => 'trace', // Full debugging
+],
+'staging' => [
+    'logLevel' => 'info', // Operations monitoring
+],
+'production' => [
+    'logLevel' => 'warning', // Errors and warnings only
+],
+```
+
+### Performance Impact
+
+- **trace**: High verbosity, includes cache operations and timing
+- **info**: Moderate verbosity, normal operations
+- **warning**: Low verbosity, problems only
+- **error**: Minimal verbosity, critical issues only
+
 ## Icon Metadata Configuration
 
 You can also configure icon metadata files alongside your icon configuration. See the main README for details on `metadata.json` structure and multilingual label support.

src/IconManager.php

@@ -353,48 +353,54 @@ private function _clearIconCache(): void
      */
     private function _registerLogTarget(): void
     {
-        // Prevent duplicate registration across requests
-        if (self::$_logTargetRegistered) {
+        // Skip if already configured
+        if (isset(Craft::$app->getLog()->targets['icon-manager'])) {
             return;
         }
 
-        if (Craft::$app->has('log')) {
-            // Get base logs path
-            $logsPath = Craft::$app->getPath()->getLogPath();
-            
-            // Use date-based log file naming
-            $date = date('Y-m-d');
-            $logFile = $logsPath . "/icon-manager-{$date}.log";
-            
-            // Get log level from settings with fallback
-            $logLevel = $this->getSettings()->logLevel ?? 'error';
-
-            // Map log level to array of levels to include
-            $levels = match ($logLevel) {
-                'trace' => ['error', 'warning', 'info', 'trace'],
-                'info' => ['error', 'warning', 'info'],
-                'warning' => ['error', 'warning'],
-                'error' => ['error'],
-                default => ['error', 'warning', 'info']
-            };
-
-            // Create a new log target instance
-            $target = new \yii\log\FileTarget([
-                'logFile' => $logFile,
-                'categories' => ['icon-manager', 'icon-manager*', 'lindemannrock\iconmanager\*'],
-                'logVars' => [],
-                'levels' => $levels,
-                'maxFileSize' => 10240, // 10MB
-                'maxLogFiles' => 30, // Keep 30 days
-                'rotateByCopy' => false
-            ]);
-            
-            // Add the target to the log dispatcher
-            Craft::$app->getLog()->targets[] = $target;
-
-            // Mark as registered
-            self::$_logTargetRegistered = true;
-        }
+        // Get base logs path
+        $logsPath = Craft::$app->getPath()->getLogPath();
+
+        // Use date-based log file naming
+        $date = date('Y-m-d');
+        $logFile = $logsPath . "/icon-manager-{$date}.log";
+
+        // Get log level from settings with fallback
+        $logLevel = $this->getSettings()->logLevel ?? 'error';
+
+        // Map log level to array of levels to include
+        $levels = match ($logLevel) {
+            'trace' => ['error', 'warning', 'info', 'trace'],
+            'info' => ['error', 'warning', 'info'],
+            'warning' => ['error', 'warning'],
+            'error' => ['error'],
+            default => ['error', 'warning', 'info']
+        };
+
+        // Create a new log target instance
+        $target = new \yii\log\FileTarget([
+            'logFile' => $logFile,
+            'categories' => ['icon-manager'],
+            'logVars' => [],
+            'levels' => $levels,
+            'maxFileSize' => 10240, // 10MB
+            'maxLogFiles' => 30, // Keep 30 days
+            'prefix' => function ($message) {
+                $user = Craft::$app->has('user', true) ? Craft::$app->getUser() : null;
+                $userId = $user && !$user->getIsGuest() ? $user->getId() : '-';
+                return "[user:{$userId}]";
+            },
+            'rotateByCopy' => false
+        ]);
+
+        // Add the target to the log dispatcher and ensure it's available immediately
+        Craft::$app->getLog()->targets['icon-manager'] = $target;
+
+        // Initialize the target immediately
+        $target->init();
+
+        // Mark as registered
+        self::$_logTargetRegistered = true;
     }
 
 }

src/controllers/IconsController.php

@@ -9,6 +9,7 @@
 namespace lindemannrock\iconmanager\controllers;
 
 use lindemannrock\iconmanager\IconManager;
+use lindemannrock\iconmanager\traits\LoggingTrait;
 
 use Craft;
 use craft\web\Controller;
@@ -19,6 +20,8 @@
  */
 class IconsController extends Controller
 {
+    use LoggingTrait;
+
     /**
      * @var array|bool|int Allow anonymous access
      */
@@ -32,17 +35,26 @@ public function actionRender(): Response
         $request = Craft::$app->getRequest();
         $iconSetHandle = $request->getRequiredParam('iconSet');
         $iconName = $request->getRequiredParam('icon');
-        
+
+        $this->logTrace("Icon render request: {$iconSetHandle}:{$iconName}", [
+            'iconSet' => $iconSetHandle,
+            'icon' => $iconName,
+            'userAgent' => $request->getUserAgent(),
+            'ip' => $request->getUserIP()
+        ]);
+
         $iconSet = IconManager::getInstance()->iconSets->getIconSetByHandle($iconSetHandle);
         if (!$iconSet || !$iconSet->enabled) {
+            $this->logWarning("Icon render failed - icon set not found or disabled: {$iconSetHandle}");
             throw new \yii\web\NotFoundHttpException('Icon set not found');
         }
-        
+
         $icon = IconManager::getInstance()->icons->getIcon($iconSetHandle, $iconName);
         if (!$icon) {
+            $this->logWarning("Icon render failed - icon not found: {$iconSetHandle}:{$iconName}");
             throw new \yii\web\NotFoundHttpException('Icon not found');
         }
-        
+
         // Return SVG content
         return $this->asRaw($icon->getContent())->format(Response::FORMAT_RAW);
     }
@@ -53,21 +65,29 @@ public function actionRender(): Response
     public function actionGetData(): Response
     {
         $this->requireAcceptsJson();
-        
+
         $request = Craft::$app->getRequest();
         $iconSetHandle = $request->getRequiredParam('iconSet');
         $iconName = $request->getRequiredParam('icon');
-        
+
+        $this->logTrace("Icon data request (AJAX): {$iconSetHandle}:{$iconName}", [
+            'iconSet' => $iconSetHandle,
+            'icon' => $iconName,
+            'requestType' => 'ajax-data'
+        ]);
+
         $iconSet = IconManager::getInstance()->iconSets->getIconSetByHandle($iconSetHandle);
         if (!$iconSet || !$iconSet->enabled) {
+            $this->logWarning("Icon data request failed - icon set not found: {$iconSetHandle}");
             return $this->asJson(['error' => 'Icon set not found']);
         }
-        
+
         $icon = IconManager::getInstance()->icons->getIcon($iconSetHandle, $iconName);
         if (!$icon) {
+            $this->logWarning("Icon data request failed - icon not found: {$iconSetHandle}:{$iconName}");
             return $this->asJson(['error' => 'Icon not found']);
         }
-        
+
         return $this->asJson([
             'success' => true,
             'icon' => [