PHPackages capell-app/search - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Search & Filtering](/categories/search) 4. / 5. capell-app/search ActiveLibrary[Search & Filtering](/categories/search) capell-app/search ================= Production-grade site search for Capell with relevance-tuned results, synonyms, typo tolerance, curated promotions, and admin search insights. 4.x-dev(1mo ago)012↓100%proprietaryPHPPHP ^8.4 Since Jul 9Pushed 1mo agoCompare [ Source](https://github.com/capell-app/search)[ Packagist](https://packagist.org/packages/capell-app/search)[ Docs](https://github.com/capell-app/search)[ RSS](/packages/capell-app-search/feed)WikiDiscussions 4.x Synced 1mo ago READMEChangelog (6)Dependencies (9)Versions (4)Used By (0) Search ====== [](#search) What This Extension Adds ------------------------ [](#what-this-extension-adds) Search is an **Available**, **Schema-owning** Capell package in the **Capell Search & SEO** product group. It ships as `capell-app/search` and extends these surfaces: admin, frontend, console. Search gives every Capell site a fast, themeable search experience: a results page, header search field, and type-ahead autocomplete, backed by a pluggable driver contract (database, Site Discovery URL registry, or Laravel Scout/Meilisearch/Typesense). Curate results with synonyms, typo corrections, and promoted "best bet" answers, and tune ranking with source weighting plus exact-match, recency, and click-through boosts. The admin dashboard surfaces top searches, trending terms, and - critically - zero-result queries, so editors see exactly where content is missing. Privacy-first by default: visitor identifiers are hashed and query logs auto-purge on a configurable retention window. After install, admins get package-owned management surfaces and public users may see package-owned frontend output or routes. Status details: - Status: Available - Tier: premium - Bundle: search-seo - Composer package: `capell-app/search` - Namespace: `Capell\Search` - Theme key: not applicable Why It Matters -------------- [](#why-it-matters) **For developers:** The package gives developers package-owned service providers, Actions, Data objects, models, Laravel routes, Filament classes, and Blade views instead of pushing this behaviour into core or application code. **For teams:** Production-grade site search for Capell - relevance-tuned results with synonyms, typo tolerance, and curated promotions, plus admin insights into what visitors search for and where you have no answers. Screens And Workflow -------------------- [](#screens-and-workflow) Screenshot contract: `docs/screenshots.json`. - Frontend search results page (frontend, required). - Header search field (frontend, required). - Top searches widget (admin, required). - Trending searches widget (admin, required). - Zero-result searches widget (admin, required). - Site search settings screen (admin, required). - Annotated search curation settings (admin, required). Technical Shape --------------- [](#technical-shape) - Service providers: `Capell\Search\Providers\SearchServiceProvider`, `Capell\Search\Providers\AdminServiceProvider`. - Config files: `packages/search/config/capell-search.php`. - Migrations: `packages/search/database/migrations/2026_05_10_190868_01_create_search_logs_table.php`, `packages/search/database/migrations/2026_05_21_000002_add_fulltext_index_to_search_database_table.php`. - Settings migrations: `packages/search/database/settings/2026_05_10_190869_01_add_search_settings.php`. - Settings classes: `SearchSettings`. - Models: `SearchLog`. - Filament classes: `SearchSettingsPage`, `SearchDashboardSettingsContributor`, `SearchSettingsSchema`, `BuildsSearchInsightsWindow`, `SearchOverviewStatsFilamentWidget`, `TopSearchesFilamentWidget`, `TrendingSearchesFilamentWidget`, `ZeroResultSearchesFilamentWidget`. - Route files: `packages/search/routes/web.php`. - Actions: `ApplySearchResultEnhancementsAction`, `BuildAutocompleteQuerySuggestionsAction`, `BuildSearchFacetGroupsAction`, `BuildTopClickedResultsQueryAction`, `BuildTopSearchesQueryAction`, `BuildTrendingSearchesQueryAction`, `BuildZeroResultSearchesQueryAction`, `CreatePromotedResultFromZeroResultSearchAction`, `CreateSynonymFromZeroResultSearchAction`, `FlushScoutSearchSourcesAction`, `GenerateSearchClickTokenAction`, `IndexScoutSearchSourcesAction`, `and 14 more`. - Data objects: `AutocompleteQuerySuggestionData`, `AutocompleteSearchResponseData`, `AutocompleteSearchResultData`, `PromotedSearchResultData`, `SearchFacetGroupData`, `SearchFacetOptionData`, `SearchFilterData`, `SearchInsightsWindowData`, `SearchQueryMetadataData`, `SearchRequestData`, `SearchResultData`, `SearchTermSummaryData`, `and 1 more`. - Command signatures: `search:flush`, `search:index`, `search:purge`. - Console command classes: `FlushSearchCommand`, `IndexSearchCommand`, `PurgeSearchLogsCommand`. - Manifest contributions: `admin-page: Capell\Search\Manifest\SearchSettingsPageContribution`, `console-command: Capell\Search\Manifest\SearchConsoleCommandsContribution`, `dashboard-widget: Capell\Search\Manifest\TopSearchesWidgetContribution`, `dashboard-widget: Capell\Search\Manifest\TrendingSearchesWidgetContribution`, `dashboard-widget: Capell\Search\Manifest\ZeroResultSearchesWidgetContribution`, `health-check: Capell\Search\Manifest\SearchHealthContribution`, `model: Capell\Search\Manifest\SearchLogModelContribution`, `overview-stat: Capell\Search\Manifest\SearchOverviewStatsContribution`, `route: Capell\Search\Manifest\SearchFrontendRouteContribution`, `scheduled-job: Capell\Search\Manifest\SearchLogPurgeScheduleContribution`, `setting: Capell\Search\Manifest\SearchSettingsContribution`. - Health checks: `Capell\Search\Health\SearchHealthCheck`. - Blade views: `packages/search/resources/views/components/facets.blade.php`, `packages/search/resources/views/components/form.blade.php`, `packages/search/resources/views/components/header/autocomplete-results.blade.php`, `packages/search/resources/views/components/header/search-dialog.blade.php`, `packages/search/resources/views/components/header/search-modal.blade.php`, `packages/search/resources/views/components/header/search-trigger.blade.php`, `packages/search/resources/views/components/results.blade.php`, `packages/search/resources/views/filament/widgets/search-overview-stats.blade.php`, `packages/search/resources/views/layouts/frontend.blade.php`, `packages/search/resources/views/pages/search.blade.php`. - Cache tags: `search`. Data Model ---------- [](#data-model) - Required tables: `search_logs`. - Models: `SearchLog`. - Migration files: `2026_05_10_190868_01_create_search_logs_table.php`, `2026_05_21_000002_add_fulltext_index_to_search_database_table.php`. - Migration impact: run host migrations through the package install flow before opening package surfaces. - Deletion/retention behaviour: Docs gap unless the package has an explicit pruning command, retention setting, or tested cascade path. Install Impact -------------- [](#install-impact) - Admin navigation: adds package-owned Filament classes when registered. - Permissions: none declared in `capell.json`. - Public routes: route files exist and must be reviewed before public enablement. - Database changes: package migrations are declared. - Settings: `Capell\Search\Settings\SearchSettings`. - Queues or schedules: none detected in standard package paths. - Cache tags: `search`. - Commands: `search:flush`, `search:index`, `search:purge`. Common Pitfalls --------------- [](#common-pitfalls) - Run migrations before opening package resources or public routes. - Configure package settings before testing production-like workflows. - Review route middleware, throttling, signed URLs, and public-output safety before exposing routes. - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries. - Run package commands from the host app; in this repository use `vendor/bin/pest` for package tests. - Keep `composer.json`, `composer.local.json`, `capell.json`, docs, screenshots, and tests aligned when the package surface changes. Troubleshooting --------------- [](#troubleshooting) SymptomLikely causeCheckFixPackage surface is missing after installProvider or manifest is not loadedConfirm `capell.json`, package `composer.json`, and provider registrationReinstall the package, refresh Composer autoload, and clear host cachesAdmin screen or command fails on missing tablePackage migrations have not runCheck the tables listed in `Data Model`Run host migrations and rerun the focused package testRoute returns unexpected outputRoute cache, middleware, or signed URL setup does not match the package route fileCheck the route files listed in `Technical Shape`Clear route cache and verify middleware before exposing public routesBackground work does not runQueue worker or scheduled command is not activeCheck package jobs, commands, and host scheduler configurationStart the queue or scheduler, then run the focused command or package testPublic output leaks unexpected stateRender data, cache variation, or authoring boundary has regressedCheck public Blade, cache tags, and public-output safety testsMove data loading out of Blade and rerun the package public-output testsQuick Start ----------- [](#quick-start) 1. Install the package: `composer require capell-app/search`. 2. Run the required setup: `php artisan migrate`. 3. Open the related Capell admin surface and verify Search appears. Next Steps ---------- [](#next-steps) - [Package docs](docs/README.md) - [Overview](docs/overview.md) - [Screenshot contract](docs/screenshots.json) - [Marketplace assets](docs/assets/marketplace/) - [Capell content language plan](../../docs/CONTENT_LANGUAGE_PLAN.md) - [Capell documentation design system](../../docs/DESIGN_SYSTEM.md) - [Capell and package ERD notes](../../docs/erd/capell-and-package-erds.md) - Related packages: [Seo Suite](../seo-suite/README.md), [Site Discovery](../site-discovery/README.md), [Url Manager](../url-manager/README.md). - Focused tests: `vendor/bin/pest packages/search/tests --configuration=phpunit.xml`. ### Health Score 38 — LowBetter than 83% of packages Maintenance91 Actively maintained with recent releases Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 53d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/85b211531c530cd60c8e1b7b2c125c7e42192c820cde99fb6b201b1dde7a9d96?d=identicon)[capell-app](/maintainers/capell-app) --- Top Contributors [![capell-app-user](https://avatars.githubusercontent.com/u/213955377?v=4)](https://github.com/capell-app-user "capell-app-user (28 commits)") --- Tags capellcapell-cmslaravelphpscoutsearchtypesensesearchlaravelcmscapell ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/capell-app-search/health.svg) ``` [![Health](https://phpackages.com/badges/capell-app-search/health.svg)](https://phpackages.com/packages/capell-app-search) ``` ### Alternatives [relaticle/custom-fields User Defined Custom Fields for Laravel Filament 16472.9k](/packages/relaticle-custom-fields)[danestves/laravel-polar A package to easily integrate your Laravel application with Polar.sh 8327.5k](/packages/danestves-laravel-polar)[tarfin-labs/event-machine Event-driven state machines for Laravel with event sourcing, type-safe context, and full audit trail. 219.6k](/packages/tarfin-labs-event-machine) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)