kaystrobach/visualsearch

package to handle advanced facetted searches

FLOW.VisualSearch

, _(*1)

This package provides a powerful search component for Flow ecosystem. Any search repository can be made searchable by extending SearchableRepository and providing an appropriate configuration. The front-end component is provided as a Fluid partial., _(*2)

, _(*3)

Installation

composer require kaystrobach/visualsearch:^3.0.0

Usage

To make a repository searchable, extend SearchableRepository or implement the SearchableRepositoryInterface. Note that the defaultSearchName property should set to the name of the corresponding search configuration., _(*4)

<?php

namespace Poke\Search\Domain\Repository;

use Neos\Flow\Annotations as Flow;
use Neos\Flow\Persistence\Repository;

use KayStrobach\VisualSearch\Domain\Repository\SearchableRepository;

/**
 * @Flow\Scope("singleton")
 */
class PokemonRepository extends SearchableRepository
{
    /**
     * @var string
     */
    protected $defaultSearchName = 'pokemon';

    public function findByName(string $name)
    {
        ...
    }
}

The repository can now be queried using the findByDefaultQuery method, e.g., from inside a controller action., _(*5)

public function indexAction() {
    $this->view->assign('pokemon', $this->pokemonRepository->findByDefaultQuery());
}

To actually display the search component, include the search partial in your template., _(*6)

<f:render partial="Visualsearch/Search" arguments="{searchName:'pokemon', pokemon:pokemon}" contentAs="value">
    ...
</f:render>

Configuration

Search configurations are defined in the Configuration/VisualSearch.yaml file. Please see the demo package for an example configuration., _(*7)

Theming

The search component can be styled using the following CSS properties:, _(*8)

Development

Install front-end dependencies via npm., _(*9)

cd Resources/Private/App
npm install

After making changes to the front-end code, run the build script to bundle the assets., _(*10)

npm run build

Linters are available for both JavaScript and CSS templates., _(*11)

npm run lint:js
npm run lint:css

License

This project is licensed under the MIT License., _(*12)