# Simple Html Search
Simple Html Search is a Wordpress plugin that let you completly customize a search bar, filtering by post title or custom fields and so forth,
you just need to write the HTML to define it graphically.
Same thing for the results, you specify what you need writing HTML, and how to display it.
### Search bar usage
The search bar can be customized with multiple filters, potentially with any filter, the code below shows a basic example filtering by multiple methods.
``` name="tile_like" ```
means that the input doesn't need to be exact to the title value but just similar or containig some words
``` name="post_type" ```
is literally the post type, usually "post", or "page" etc, you may refer to "Post Type Parameters" on official Wordpress's documentation
``` name="tax_query_category" ```
You may also need to filter by category, where "category" is the name of the category
``` name="tax_query_post_tag" ```
filter by tag where "post_tag" is the name of the tag
``` name="meta_query_my_attribute_name" ```
filter by custom field, "my_attribute_name" is the name of the attribute you want to filter
``` name="limit" value="5" hidden="true" ```
sets the results to the first 5, any may be hidden also.
```html
```
you may need also a select automatically filled with post_type or any custom value, just define it in **inflateWith** attribute,
then in **name** attribute write the field you need to display, that value will be used as filter in the search.
```html
```
in this example, all posts that have the category "category1" will be shown in the select, and used in the search using the title_like value
```javascript
```
it's mandatory to call simple_html_search_select_event() function when we want to auto populate a select tag
### Search Result usage
On the result side, any layout can be done with multiple html tags and custom styles.
You must specify what field you need to show as output, you can achive this through the "id" attribute.
For instance if you need to display the title or the author name, you have to define an "id" with the specified name, and so forth.
``` id="title" ```
post title
``` id="category__name" ```
post categories
``` id="tag__name" ```
post tags
``` id="meta__my_attribute"> ```
post attribute, where "my_attribute" is the name of the attribute
``` id="body"> ```
post body content
``` id="excerpt" ```
post excerpt
``` id="author_name" ```
post author name
``` img id="thumbnail" width="100" height="auto" ```
show the thumbnail image
``` img id="thumbnail" src="url/to/placeholder.jpg" width=100 height=auto ```
display image with a placeholder if thumbnail doesn't exists
### put all together
> the search bar
```html
```
