{"id":23152977,"url":"https://github.com/t3n/neos-debug","last_synced_at":"2025-08-17T20:33:24.384Z","repository":{"id":34859113,"uuid":"184896126","full_name":"t3n/neos-debug","owner":"t3n","description":"Adds a debug panel to your Neos CMS website","archived":false,"fork":false,"pushed_at":"2024-01-10T13:06:50.000Z","size":19571,"stargazers_count":30,"open_issues_count":23,"forks_count":16,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-11-30T15:42:54.839Z","etag":null,"topics":["flow","flowframework","neos-fusion","neos-package","neos-plugin","neoscms"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/t3n.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-04T13:06:58.000Z","updated_at":"2023-08-15T08:14:57.000Z","dependencies_parsed_at":"2024-06-21T16:35:19.491Z","dependency_job_id":null,"html_url":"https://github.com/t3n/neos-debug","commit_stats":{"total_commits":101,"total_committers":12,"mean_commits":8.416666666666666,"dds":0.5247524752475248,"last_synced_commit":"048365523b2dd57b1b45f3e0a6aeb68c98a92d43"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t3n%2Fneos-debug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t3n%2Fneos-debug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t3n%2Fneos-debug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t3n%2Fneos-debug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/t3n","download_url":"https://codeload.github.com/t3n/neos-debug/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230168481,"owners_count":18183936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flow","flowframework","neos-fusion","neos-package","neos-plugin","neoscms"],"created_at":"2024-12-17T19:20:02.336Z","updated_at":"2024-12-17T19:20:02.915Z","avatar_url":"https://github.com/t3n.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CircleCI](https://circleci.com/gh/t3n/neos-debug.svg?style=svg)](https://circleci.com/gh/t3n/neos-debug) [![Latest Stable Version](https://poser.pugx.org/t3n/neos-debug/v/stable)](https://packagist.org/packages/t3n/neos-debug) [![License](https://poser.pugx.org/t3n/neos-debug/license)](https://packagist.org/packages/t3n/neos-debug)\n\n# t3n.Neos.Debug\n\nThe t3n.Neos.Debug package is a small helper package to add a debug panel to your Neos CMS website. \nAt this point in time you're able to debug your content cache configuration as well as sql queries.\nAdditionally, the Server-Timing http header can be enabled that will add request timings to responses. \nThose then can be viewed in the browser network tab.\n\n_Note: This is still a very early rough version. Contributions are welcome in any Error. Nevertheless, it's already adding value to your debug experience_\n\n![Neos CMS Demo Site with enabled debug console](t3n-neos-debug.jpg 'Neos CMS Demo Site with enabled debug console')\n![Server-Timing header in the browser network tab](server-timing-example.jpg 'Viewing the timings in the browser network tab')\n\n## Installation \u0026 configuration\n\nInstall the package via composer\n\n```\ncomposer require t3n/neos-debug --dev\n```\n\nThe debug mode is disabled by default. To enable it add this to your Settings.yaml\n\n```yaml\nt3n:\n  Neos:\n    Debug:\n      enabled: true\n```\n\nTo bring up the debug panel run this command in your js console:\n```js\n__enable_neos_debug__()\n```\n\n_Disclaimer: Once the debug mode is enabled you might expose sensitive data. Make sure to **not** use this in production. At least be warned_\n\nIn a previous version of this package your current user needed a specific role as well. We dropped this requirement for now as you could not use this package if you don't have a frontend login on your site. Once the package is active it will render some metadata in your html output.\n\nTo get the debugger running you now need to include some javascript and css to acutally render the debug console. This package ships two fusion prototypes to include all resources. If your Document extends `Neos.Neos:Page` you don't need to include anything. We already added the resources to `Neos.Neos:Page` prototype.\n\n### HTTP Server-Timing header   \n\nThe header is disabled by default. To enable it add this to your Settings.yaml\n\n```yaml\nt3n:\n  Neos:\n    Debug:\n      serverTimingHeader:\n        enabled: true\n```   \n\nIf you only want the header with all timings but not the debug mode, do this:\n\n```yaml\nt3n:\n  Neos:\n    Debug:                                                  \n      enabled: true\n      htmlOutput:\n        enabled: false\n      serverTimingHeader:\n        enabled: true\n```\n\n## Usage\n\nTo enable the cache visualization open your browsers developer console and execute\n`__enable_neos_debug__()`. This will bring up the debug console at the bottom of your screen.\n\n### 🔦 Inspect\n\nOnce you enable the inspect mode a visualization will pop up and add overlays on your cached parts. Cached parts are marked green, uncached red and dynamic caches are marked yellow. If you hover the loupe you will also see some meta data regarding the cache.\n\n### ⚡️ Cache\n\nThis module will add a new modal including some statistics regarding cache hits and misses as well as a table of all rendered cache entries.\n\n### 🗄 SQL\n\nIn addition to the content cache we're also exposing some debug SQL informations and statistics. It will also detect slow queries. You can configure from when a query should be marked as slow:\n\n```yaml\nt3n:\n  Neos:\n    Debug:\n      sql:\n        # Set when a query should be considered as slow query. In ms\n        slowQueryAfter: 10\n```\n\n### 🚫 Close\n\nTo shutdown the debug console simply close it. If you'd like to persist the active debug state you can add a `true` to the method\n\n```\n__enable_neos_debug__(true)\n```\n\nThis will set a cookie and the debug mode will still be active after a page refresh.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft3n%2Fneos-debug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ft3n%2Fneos-debug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft3n%2Fneos-debug/lists"}