{"id":35478045,"url":"https://github.com/callmemagnus/nextcloud-searchpage","last_synced_at":"2026-02-17T22:06:07.821Z","repository":{"id":197723629,"uuid":"699193904","full_name":"callmemagnus/nextcloud-searchpage","owner":"callmemagnus","description":"App for Nextcloud providing a proper search page","archived":false,"fork":false,"pushed_at":"2026-01-31T02:17:31.000Z","size":1372,"stargazers_count":11,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-31T17:41:57.743Z","etag":null,"topics":["nextcloud","nextcloud-apps"],"latest_commit_sha":null,"homepage":"","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/callmemagnus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSES/AGPL-3.0-or-later.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-02T06:11:34.000Z","updated_at":"2026-01-31T02:17:32.000Z","dependencies_parsed_at":"2026-01-16T12:00:49.054Z","dependency_job_id":null,"html_url":"https://github.com/callmemagnus/nextcloud-searchpage","commit_stats":null,"previous_names":["callmemagnus/nextcloud-searchpage"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/callmemagnus/nextcloud-searchpage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callmemagnus%2Fnextcloud-searchpage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callmemagnus%2Fnextcloud-searchpage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callmemagnus%2Fnextcloud-searchpage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callmemagnus%2Fnextcloud-searchpage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/callmemagnus","download_url":"https://codeload.github.com/callmemagnus/nextcloud-searchpage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callmemagnus%2Fnextcloud-searchpage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29559966,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T21:50:49.831Z","status":"ssl_error","status_checked_at":"2026-02-17T21:46:15.313Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["nextcloud","nextcloud-apps"],"created_at":"2026-01-03T13:13:02.169Z","updated_at":"2026-02-17T22:06:07.809Z","avatar_url":"https://github.com/callmemagnus.png","language":"Svelte","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: Magnus Anderssen \u003cmagnus@magooweb.com\u003e\nSPDX-License-Identifier: CC0-1.0\n--\u003e\n\n# The Search Page\n\nA dedicated search interface for Nextcloud that provides a proper search page with admin configuration options. This app leverages Nextcloud's unified search API to query all available search providers and display results in a browsable, user-friendly format.\n\nPlace this app in one of the application folders of your nextcloud server (e.g. **nextcloud/apps/**).\n\n- [Changelog](https://raw.githubusercontent.com/callmemagnus/nextcloud-searchpage/main/CHANGELOG.md)\n- [Help translate this application](https://app.transifex.com/nextcloud/nextcloud/thesearchpage/)\n\n## Features\n\n- **Unified Search Interface**: Search across all Nextcloud search providers from a single page\n- **Admin Configuration**: Control which search providers are available to users\n- **Customizable Result Limits**: Set maximum number of results per provider\n- **Modern UI**: Built with Svelte 5\n- **Pagination Support**: Load more results for providers that support pagination\n\n## Philosophy of this application\n\nThis application only uses official APIs provided by Nextcloud.\n\nIt works as described below (fresh arrival on page):\n\n1. User arrives on the application page\n2. Page fetches the available providers of the Nextcloud instance\n3. User types a search query\n4. Page fetches the result of each provider for the given search query\n\nIf the URL contains predefined values, the step 3 is not necessary.\n\nThe application must not depend on other applications (except the core Nextcloud). This brings the following caveats\n\n- not possible (yet) to fetch more information on results as the existing search API is quite light\n- not possible to make specific behaviors for a given provider\n\n## Admin Configuration\n\nAdministrators can configure search provider behavior from **Settings → Administration → The Search Page**:\n\n1. **Enable Provider Restrictions**: Toggle to activate provider management\n2. **Provider Restrictions**: Control which search providers are available to users\n3. **Provider Limits**: Set the maximum number of results displayed per provider\n\nAll settings are saved via the SettingsController API and persist across sessions.\n\n## Building the app\n\nThe app can be built by using the provided Makefile by running:\n\n    make\n\nThis requires the following things to be present:\n\n- make\n- which\n- tar: for building the archive\n- curl: used if phpunit and composer are not installed to fetch them from the web\n- npm: for building and testing everything JS\n\n### Backend (`lib/`)\n\nThe PHP backend provides:\n\n- **PageController**: Serves the main search page\n- **SettingsController**: API endpoints for admin settings (get/save provider configuration)\n- **ProviderService**: Business logic for managing provider restrictions and limits\n- **Admin Settings**: Admin panel integration for configuring search providers\n\n### Frontend\n\nThe app includes two Svelte 5 applications:\n\n**Search Page (`static/search-page/`)**: The main search interface\n\n- Search box with real-time query handling\n- Provider filtering and result display\n- Pagination support for providers\n- Session persistence for search state\n\n**Settings Page (`static/settings-page/`)**: Admin configuration interface\n\n- Provider restrictions table (enable/disable providers)\n- Provider limits table (set result limits)\n- Real-time save feedback\n\n**Shared Package (`static/shared/`)**: Common utilities and constants used by both applications\n\n## Development\n\n### Build Commands\n```bash\nnpm run build          # Production build (minified, no sourcemaps)\nnpm run lint           # Run ESLint on TypeScript and Svelte files\nnpm run dev            # Development build (with sourcemaps)\n```\n\n### PHP Code Quality\n```bash\ncomposer run lint                    # PHP syntax check\ncomposer run cs:check               # PHP-CS-Fixer dry-run\ncomposer run cs:fix                 # Auto-fix PHP code style\ncomposer run psalm                  # Static analysis\ncomposer run psalm:update-baseline  # Update Psalm baseline\n```\n\n## Running tests\n\n### PHP Tests\nYou can use the provided Makefile to run all tests:\n\n```bash\nmake test                                                    # Run all PHP tests\nvendor/phpunit/phpunit/phpunit -c tests/phpunit.xml          # Unit tests only\nvendor/phpunit/phpunit/phpunit -c phpunit.integration.xml    # Integration tests only\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcallmemagnus%2Fnextcloud-searchpage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcallmemagnus%2Fnextcloud-searchpage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcallmemagnus%2Fnextcloud-searchpage/lists"}