# Mofect On-Site Search Plugin Documentation

Created: July 2018 / Current Version: 1.0.0 / by Mofect

## Introduction

Thank you for purchasing our product. If you have any questions that are beyond the scope of this help file, You can asking on the support forum after you sign up with your purchased code. Thanks so much!

#### Support Forums

Any questions that are beyond the scope of this help file, asking on support forum.

Visit Support Forum

#### Follow Us

Follow us on social networks and don’t miss our new upcoming products.

Facebook Twitter Medium

## WordPress Installation

If you are first time to use WordPress, I think maybe you need to read the offical documentation for how to use WordPress, click here to read it.

About WordPress installation, you should download the latest version of WordPress code from WordPress.org, then upload all the WordPress files to your webhost(Some webhost is provide one-click installation, e.g. Bluehost or Siteground), then, visit your website with your IP address or domain name, fill the MY SQL and Administrator information step by step. You can refer to the following Video:

Also, there are many useful How-to videos in WordPress.tv

## Plugin Installation

Unzip the downloaded package. Find the zipped theme file called mofect_onsite_search_v1.x.zip.

Go to “Plugins > Add New” in your dashboard side menu. Upload the installation file, and activate this plugin.

You can also unzip the installation zip file and upload the theme folder to “/wp-content/plugins” directory via FTP client.

## Settings

After the plugin is activated, please go to “Mofect Search > Settings” page. At the current stage, there are 4 options over there.

Enable Live Search

The live search feature is that the search result will be displayed quickly and synchronously when the user typing the keyword. This is one of core feature in this plugin.

Enable Keyword Tracking

Keyword Tracking is another core feature of this plugin. If you enable it, the keywords which the user entered will be saved in the database, and you can see the tracking information as user device, user location, search volume and so on via Mofect Search > Dashboard Page.

As you can see the tracking information list above, if there’s nothing was found when the user searching ing a keyword, then it will return “No Result” to the keyword status, the next option can help you append the featured content when no result found.

Show Featured Content

Enable it to show the featured content when no result found. Your featured content will be appeared in the live search result area.

Featured Content

Now, you can specific the post id in this field, the supported post types are ‘post’ and ‘product’, it means you can enter the standard WordPress post id and WooCommerce product id here. Multiple IDs should be separated by English comma.

## Basic Usage

There are four methods to use Mofect On-Site Search Bar on your site:

1. Shortcode: [mofect_searchbar]

You can insert this shortcode to anywhere you want. The following parameters are available to use in the shortcode tag.

- label = ‘Search’
- placeholder = ‘Enter Keyword’
- layout = ‘list’ or ‘grid’
- post_type = ‘post’ All post types are supported by default, you can specific one for the search result such as “product”.
- posts_per_page = ’12’. The number of result will be appeared in the result list.
- orderby = ‘date’ or ‘rand’
- order = ‘desc’ or ‘asc’.
- category = ‘cat_slug1,cat_slug2’. You can limit the search range within the specific categories, just add category slugs here, multiple category slugs should be separated by English comma.
- extra_class = ‘your_custom_search’. The safe way to customize the search bar style is set the extra CSS selector with this parametor, then you can write your custom CSS in your theme as .your_custom_search{…..}

2. PHP Function:

If you want to replace the search form in your theme file, you can use this method and the following arguments you can use in this function and the usage as same as the shortcode.

    $args = array(
    		'label'          => esc_html__('Search Product','moss'),
    		'placeholder'    => esc_html__('Keyword','moss'),
    		'post_type'      => 'post',
    		'posts_per_page' => '12',
    		'orderby'        => 'date',
    		'order'          => 'desc',
    		'category'	 => '',
    		'extra_class'    => '',
    		'layout'	 => 'list'
            );

3. Use in The Page Builder

Mofect Search Bar is integrated into the popular page builder such as WPBakery Page Builder, KingComposer, Elementor and Beaver Builder. You can find Mofect Search element in these page builder panel, just drag it and drop to the page.

4. Use Widget

If you want to add the search bar as a widget to your page, just go to Appearance > Widgets, you will find On-Site Search Widget is available to use.

## Keyword Tracking

If you enabled keyword tracking feature in the settings page, you will be able to collect the keywords which were searched by your visitors on your site, know what’s your visitors interested in and find the correct direction of your content building.

Let’s select a keyword on dashboard or Mofect Search > Keywords list, just edit it, you can see the following screen, looks similar to the post editing screen, right?

In Keyword Statistics section, you will get all searching records of this keywords, know the search date, the client information and whether it was no result found or not.

If no result was assigned to this keyword, you can search and add the specific content in the Keyword Setting section below.

This feature is very useful for some cases if the visitor typed an wrong spelled keyword, for example, if the visitor want to search “Milk”, but he or she typed as “Mllk”, now you can also assign the correct content which is related to “Mllk”.

Also, the keyword categories are ready to use for organizing the keywords, for example, you can add all “No result” keywords to a category, it’s easy to find out them in next time.

## Localization

This theme is ready for localization. We have made every string translate able with the text domain “moss“, use Poedit editor to translate it, or install Loco Translation plugin to translate the text.

If you choose use Poedit to create your own language file, please do it as following steps

1. Go to /wp-content/plugins/mofect-onsite-search/languages directory, you will find the moss.pot file
2. Just base on this file teplate and create your language file. (ie. pt_BR.po, de_DE.po, etc.)
3. Then, open this file with Poedit editor, translate all words to your language, save the file.
4. Go to “Setting > General > Site language”, you will find the language options at the bottom, select your language.

## Upgrade

If you have registered your purchased code, you can enjoy the plugin auto update. When we release the new version, you only need to click upgrade the plugin via Plugins page.

For manually upgrade the theme, you can get the new version on your CodeCanyon download page. Please note that if you haven’t modified any source files of this plugin, just remove the old version and reinstall the new version directly.

## Thanks for your reading, enjoy this plugin now!