themicly/shopcrafty-popular-search

PopularSearch add-on for Shopcrafty.

v1.0.0 2026-07-28 16:47 UTC

Requires

• php: ^8.3
• illuminate/support: ^13.0
• themicly/shopcrafty: ^1.0

Requires (Dev)

• laravel/pint: ^1.0
• orchestra/testbench: ^11.0
• phpunit/phpunit: ^12.0

MIT

• Themicly
• Md. Rakibul Islam

Published on Packagist.org on 2026-07-28 16:48 UTC

README

Popular search terms and storefront search analytics for Shopcrafty.

Requirements

• PHP 8.3+
• Laravel 13+
• themicly/shopcrafty 1.0+

Installation

composer require themicly/shopcrafty-popular-search
php artisan migrate

The package is auto-discovered by Laravel. Popular search terms remain configured through Admin → Themes → Storefront settings when the addon is installed.

Features

• Normalizes search terms by trimming, collapsing whitespace, and lowercasing
• Counts each term once per visitor session
• Ignores search analytics in Shopcrafty demo mode
• Records explicit searches and settled predictive-search queries
• Admin report at /admin/reports/search-terms
• Popular-term settings metadata for the Shopcrafty settings UI

The report supports filtering, popularity/recent sorting, and pagination.

Views and services

• Views use the popularsearch:: namespace
• SearchTermRecorder records normalized terms
• SearchTerm reads aggregated terms from catalog_search_terms
• popularsearch.search-terms is the Livewire report component

License

MIT. Targets PHP 8.3+ and Laravel 13+.