winter/modules/backend/widgets/Search.php

<?php namespace Backend\Widgets;

use Input;
use October\Rain\Support\Util;
use Backend\Classes\WidgetBase;

/**
 * Search Widget
 * Used for building a toolbar, Renders a search container.
 *
 * @package october\backend
 * @author Alexey Bobkov, Samuel Georges
 */
class Search extends WidgetBase
{
    /**
     * {@inheritDoc}
     */
    public $defaultAlias = 'search';

    /**
     * @var string Search placeholder text
     */
    public $placeholder;

    /**
     * @var string Active search term pulled from session data
     */
    public $activeTerm;

    /**
     * @var string Custom partial file definition, in context of the controller.
     */
    public $customPartial;

    /**
     * Constructor.
     */
    public function __construct($controller, $configuration = [])
    {
        parent::__construct($controller, $configuration);

        /*
         * Process configuration
         */
        if (isset($this->config->prompt))
            $this->placeholder = trans($this->config->prompt);

        if (isset($this->config->partial))
            $this->customPartial = $this->config->partial;
    }

    /**
     * Renders the widget.
     */
    public function render()
    {
        $this->prepareVars();

        if ($this->customPartial)
            return $this->controller->makePartial($this->customPartial);
        else
            return $this->makePartial('search');
    }

    /**
     * Prepares the view data
     */
    public function prepareVars()
    {
        $this->vars['placeholder'] = $this->placeholder;
        $this->vars['value'] = $this->getActiveTerm();
    }

    /**
     * Search field has been submitted.
     */
    public function onSubmit()
    {
        /*
         * Save or reset search term in session
         */
        $term = post('term');
        if (strlen($term))
            $this->putSession('term', $term);
        else
            $this->resetSession();

        /*
         * Trigger class event, merge results as viewable array
         */
        $params = func_get_args();
        $result = $this->fireEvent('search.submit', [$params]);
        return Util::arrayMerge($result);
    }

    /**
     * Returns an active search term for this widget instance.
     */
    public function getActiveTerm()
    {
        return $this->activeTerm = $this->getSession('term', '');
    }
}