mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-08-26 20:45:47 +02:00
193 lines
5.8 KiB
Markdown
193 lines
5.8 KiB
Markdown
# SearchContext
|
|
|
|
## Introduction
|
|
|
|
Manages searching of properties on one or more `[api:DataObject]` types, based on a given set of input parameters.
|
|
`[api:SearchContext]` is intentionally decoupled from any controller-logic,
|
|
it just receives a set of search parameters and an object class it acts on.
|
|
|
|
The default output of a `[api:SearchContext]` is either a `[api:SQLSelect]` object for further refinement, or a
|
|
`[api:DataObject]` instance.
|
|
|
|
In case you need multiple contexts, consider namespacing your request parameters by using `FieldList->namespace()` on
|
|
the $fields constructor parameter.
|
|
|
|
`[api:SearchContext]` is mainly used by `[ModelAdmin](/reference/modeladmin)`, our generic data administration interface. Another
|
|
implementation can be found in generic frontend search forms through the [genericviews](http://silverstripe.org/generic-views-module) module.
|
|
|
|
## Usage
|
|
|
|
Getting results
|
|
|
|
:::php
|
|
singleton('MyDataObject')->getDefaultSearchContext();
|
|
|
|
|
|
### Defining fields on your DataObject
|
|
|
|
See `[api:DataObject::$searchable_fields]`.
|
|
|
|
### Customizing fields and filters
|
|
|
|
In this example we're defining three attributes on our MyDataObject subclass: `PublicProperty`, `HiddenProperty`
|
|
and `MyDate`. The attribute `HiddenProperty` should not be searchable, and `MyDate` should only search for dates
|
|
*after* the search entry (with a `GreaterThanFilter`). Similiar to the built-in `DataObject->getDefaultSearchContext()`
|
|
method, we're building our own `getCustomSearchContext()` variant.
|
|
|
|
:::php
|
|
class MyDataObject extends DataObject {
|
|
private static $db = array(
|
|
'PublicProperty' => 'Text'
|
|
'HiddenProperty' => 'Text',
|
|
'MyDate' => 'Date'
|
|
);
|
|
|
|
public function getCustomSearchContext() {
|
|
$fields = $this->scaffoldSearchFields(array(
|
|
'restrictFields' => array('PublicProperty','MyDate')
|
|
));
|
|
$filters = array(
|
|
'PublicProperty' => new PartialMatchFilter('PublicProperty'),
|
|
'MyDate' => new GreaterThanFilter('MyDate')
|
|
);
|
|
return new SearchContext(
|
|
$this->class,
|
|
$fields,
|
|
$filters
|
|
);
|
|
}
|
|
}
|
|
|
|
### Generating a search form from the context
|
|
|
|
:::php
|
|
class Page_Controller extends ContentController {
|
|
public function SearchForm() {
|
|
$context = singleton('MyDataObject')->getCustomSearchContext();
|
|
$fields = $context->getSearchFields();
|
|
$form = new Form($this, "SearchForm",
|
|
$fields,
|
|
new FieldList(
|
|
new FormAction('doSearch')
|
|
)
|
|
);
|
|
return $form;
|
|
}
|
|
public function doSearch($data, $form) {
|
|
$context = singleton('MyDataObject')->getCustomSearchContext();
|
|
$results = $context->getResults($data);
|
|
return $this->customise(array(
|
|
'Results' => $results
|
|
))->renderWith('Page_results');
|
|
}
|
|
}
|
|
|
|
|
|
### Pagination
|
|
|
|
For pagination records on multiple pages, you need to wrap the results in a
|
|
`PaginatedList` object. This object is also passed the generated `SQLSelect`
|
|
in order to read page limit information. It is also passed the current
|
|
`SS_HTTPRequest` object so it can read the current page from a GET var.
|
|
|
|
:::php
|
|
public function getResults($searchCriteria = array()) {
|
|
$start = ($this->request->getVar('start')) ? (int)$this->request->getVar('start') : 0;
|
|
$limit = 10;
|
|
|
|
$context = singleton('MyDataObject')->getCustomSearchContext();
|
|
$query = $context->getQuery($searchCriteria, null, array('start'=>$start,'limit'=>$limit));
|
|
$records = $context->getResults($searchCriteria, null, array('start'=>$start,'limit'=>$limit));
|
|
|
|
if($records) {
|
|
$records = new PaginatedList($records, $this->request);
|
|
$records->setPageStart($start);
|
|
$records->setPageLength($limit);
|
|
$records->setTotalItems($query->unlimitedRowCount());
|
|
}
|
|
|
|
return $records;
|
|
}
|
|
|
|
|
|
notice that if you want to use this getResults function, you need to change the function doSearch for this one:
|
|
|
|
:::php
|
|
public function doSearch($data, $form) {
|
|
$context = singleton('MyDataObject')->getCustomSearchContext();
|
|
$results = $this->getResults($data);
|
|
return $this->customise(array(
|
|
'Results' => $results
|
|
))->renderWith(array('Catalogo_results', 'Page'));
|
|
}
|
|
|
|
|
|
The change is in **$results = $this->getResults($data);**, because you are using a custom getResults function.
|
|
|
|
Another thing you cant forget is to check the name of the singleton you are using in your project. the example uses
|
|
**MyDataObject**, you need to change it for the one you are using
|
|
|
|
For more information on how to paginate your results within the template, see [Tutorial: Site Search](/tutorials/4-site-search).
|
|
|
|
|
|
### The Pagination Template
|
|
|
|
to show the results of your custom search you need at least this content in your template, notice that
|
|
Results.PaginationSummary(4) defines how many pages the search will show in the search results. something like:
|
|
|
|
**Next 1 2 *3* 4 5 … 558**
|
|
|
|
|
|
:::ss
|
|
<% if $Results %>
|
|
<ul>
|
|
<% loop $Results %>
|
|
<li>$Title, $Autor</li>
|
|
<% end_loop %>
|
|
</ul>
|
|
<% else %>
|
|
<p>Sorry, your search query did not return any results.</p>
|
|
<% end_if %>
|
|
|
|
<% if $Results.MoreThanOnePage %>
|
|
<div id="PageNumbers">
|
|
<p>
|
|
<% if $Results.NotFirstPage %>
|
|
<a class="prev" href="$Results.PrevLink" title="View the previous page">Prev</a>
|
|
<% end_if %>
|
|
|
|
<span>
|
|
<% loop $Results.PaginationSummary(4) %>
|
|
<% if $CurrentBool %>
|
|
$PageNum
|
|
<% else %>
|
|
<% if $Link %>
|
|
<a href="$Link" title="View page number $PageNum">$PageNum</a>
|
|
<% else %>
|
|
…
|
|
<% end_if %>
|
|
<% end_if %>
|
|
<% end_loop %>
|
|
</span>
|
|
|
|
<% if $Results.NotLastPage %>
|
|
<a class="next" href="$Results.NextLink" title="View the next page">Next</a>
|
|
<% end_if %>
|
|
</p>
|
|
</div>
|
|
<% end_if %>
|
|
|
|
|
|
## Available SearchFilters
|
|
|
|
See `[api:SearchFilter]` API Documentation
|
|
|
|
## API Documentation
|
|
`[api:SearchContext]`
|
|
|
|
## Related
|
|
|
|
* [ModelAdmin](/reference/modeladmin)
|
|
* [RestfulServer module](https://github.com/silverstripe/silverstripe-restfulserver)
|
|
* [Tutorial: Site Search](/tutorials/4-site-search)
|