- Changed $appName property visibility from private to protected
- OCP\AppFramework\Controller requires protected visibility
- Error: "must be protected (as in class OCP\AppFramework\Controller)"
- Same applies to $request property
- This is the final routing/access fix after 7 hours of debugging
- Fixed: Routes, navigation, parent constructor, class name, path conflicts
- All issues resolved - controller now properly extends OCP\AppFramework\Controller
- Controller now fully compatible with Nextcloud's DI and permission system
The error showed that protected property visibility is required by Nextcloud's Controller base class.
This is the final fix for all routing and access issues!
- Added parent::__construct() call to PageController
- Fixes: "must be an instance of OCP\AppFramework\Controller"
- Error: Argument 1 passed to Dispatcher was PageController, not Controller
- This is the CRITICAL fix for controller DI in Nextcloud
- PageController now properly extends OCP\AppFramework\Controller
- Maintains simple HTML output for testing
The error showed the controller wasn't properly extending the base class.
Nextcloud's Dispatcher requires all controllers to extend OCP\AppFramework\Controller.
- Renamed AdminController to PageController
- Route name is 'page#index' so controller must be 'PageController'
- Fixes Could not resolve PageController error
- Updated routes.php to use PageController
- Updated info.xml navigation to point to PageController
- Removed old AdminController.php
- Improved HTML output with better styling and next steps
This was the root cause: Controller class name must match route name.
Route: page#index → Controller: PageController
App routing should now work correctly!
- Changed route URL from /admin to / (root path)
- /admin was conflicting with Nextcloud built-in admin routes
- Now uses apps/analyticshub/ instead
- Changed route name from admin#index to page#index
- Follows Nextcloud naming conventions
- Updated info.xml navigation
- Points to analyticshub.page.index
- Removed <settings> section (can cause conflicts)
- Updated AdminController
- Added request path to diagnostic output
- Better styling for simple HTML page
The route was conflicting with Nextcloud's admin system.
New URL: https://teamworkapps.com/index.php/apps/analyticshub/
- Changed AdminController to use simple echo/exit instead of TemplateResponse
- Eliminates TemplateResponse complexity
- Direct HTML output for debugging
- Simplified routes.php to single admin route
- Removed test route (no longer needed)
- Simple GET only route
- Simplified Application.php
- Removed resource loading
- Minimal bootstrap
If this shows 'Controller is working' page, routing is confirmed working.
If it still redirects to dashboard, it's a Nextcloud routing issue.
This is a minimal test version to confirm routing works before building full UI.
- Fixed AdminController to extend OCP\AppFramework\Controller
- Annotations (@NoAdminRequired, @NoCSRFRequired) now work
- Proper parent::__construct() call
- Added test route /admin/test for debugging
- Returns JSON to confirm controller works
- Helps diagnose routing vs permission issues
- Simplified routes to essential ones only
- admin#index and admin#test
This should resolve 'Access forbidden' for system admin users.
The key fix was extending the proper Controller base class.
- Simplified AdminController to minimal version
- Removed complex dependency injection
- Added @NoAdminRequired and @NoCSRFRequired annotations
- Minimal constructor with just appName
- Simplified routes.php
- Removed requirements array
- Clean route definitions
- Fixed admin template
- Kept same UI but removed non-standard calls
- Self-contained CSS and simple form
- This addresses 'Access forbidden' error when accessing admin page
The issue was likely caused by:
1. Missing annotations on admin controller
2. Complex DI not working properly
3. Route configuration issues
Simplified version should resolve access issues.
- Removed settings/navigation from appinfo/info.xml
- These sections can cause routing conflicts
- App now relies purely on routes.php
- Simplified Application.php
- Removed manual service/controller registration
- Let Nextcloud DI framework handle it automatically
- Fixed admin template to use Nextcloud standards
- Removed non-standard style() call
- Added proper l10n support with p($l->t(...))
- Clean template structure
- Created css/admin.css
- Nextcloud-compatible styling
- Matches design language
- Created js/admin.js
- Handles Save Configuration button
- Handles Test Connection button
- Uses OC, OC.Notification APIs
This should fix admin page not appearing issue.
Users can access via: Settings → Administration → Additional Settings
- Created appinfo/Application.php (Nextcloud app bootstrap)
- Extends OCP\AppFramework\App
- Registers proper app ID: analyticshub
- Loads CSS and JS files
- Removed obsolete lib/App.php file
- Updated all AppInfo::APP_NAME references to Application::APP_NAME
- AdminController, ApiV1Controller
- GoogleAnalyticsService, LLMService
- Fixed dependency injection in AdminController
- Injected IConfig service properly
- Added missing use statements
This is the core fix for the app not appearing in Nextcloud.
Nextcloud requires appinfo/Application.php to initialize the app.
- Created appinfo/routes.php to register all routes
- Admin routes: index, save, load, getStatus
- API v1 routes: reports, getReport, generate, getStatus
- Report routes: index, generate
- Added index() method to AdminController
- Renders admin template via TemplateResponse
- Updated info.xml and appinfo/info.xml
- Fixed navigation entry to point to route: analyticshub.admin.index
- Added settings and navigation sections
- App now appears in Settings → Administration after enable/disable
Fixes issue where app didn't show up in Nextcloud toolbar after being enabled.
- Changed all analytics-hub/ references to analyticshub/ in docs
- Updated README.md and STATUS.md installation instructions
- Ensures consistency with folder rename (commit 8a445c4)
- App ID and folder name now match: analyticshub
- Renamed analytics-hub/ → analyticshub/
- App ID in info.xml is 'analyticshub' (no hyphen)
- Nextcloud requires folder name to match app ID exactly
- Fixes 'Could not download app analyticshub' error during installation
Installation:
- Upload analyticshub/ folder to /var/www/nextcloud/apps/
- Folder name must match app ID in info.xml
- Changed PHP min-version from 8.0 to 7.4 in appinfo/info.xml
- Replaced all str_contains() calls with strpos() !== false
- GoogleAnalyticsService.php: 1 instance
- LLMService.php: 6 instances
- Verified no other PHP 8.0+ features in use
- Plugin now compatible with PHP 7.4 and PHP 8.0+
