Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via our email. Thanks so much!
Vidopticon Video Search Engine Plugin is a powerful tool to generate a custom video search engine on your web site, without your further intervention.
- This plugin is a great tool to generate a passive income! Do you want to earn money even while you sleep? - You can define custom ads to be shown between search results? - No problem! Vidopticon Video Search Engine plugin is the right thing for you!
Our intuitive, easy-to-use system allows you to create a custom video search engine for your site.
The resulting video search engine is fully customizable and rich in content. List of customizable content in the search engine:
Result title, URL, description
Ability to display an image
Ability to ad custom ads between video search results
Ads can be links, images or custom ads from ad providers, like AdSense (or any HTML code)
Fully customizale appearance (CSS)
Add or remove content from the video search results
Other plugin features:
Suggestions while you are typing
Voice typing support
Shorte.st link shortener support - it will allow you to earn a passive income
Ability to log visitor search queries
Fully customizable search results
Filter results - banned words list, allowed words list
Maximum words count in title and description
Search engine is fully translatable and customizable
I also provided a Quick Install Guide to feature an easy plugin installation for everyone.
To make this plugin work, first, you'll need to install the plugin. The easiest method is to take the .zip file you've downloaded and upload it via Plugins > Add New > Upload Plugin in the WordPress Dashboard. Once the plugin is installed, be sure to Activate it.
Now that you've installed and activated the plugin, you'll see a new menu item created inside WordPress called 'Vidopticon Video Search Engine'. First thing first, let's head over to Settings > Vidopticon Video Search Engine and take a look at what options are available.
Please use this shortcode in post/page content:
[vidopticon-search-engine]
Shortcode parameters: search_text = The text that appears above the search box search_prefill = Force search for a predefined string search_description = Description that appears in the search box find_text = Text that appears on the search button width = CSS width parameter of the search form. Examples: auto/100%/450px backgound_color = CSS background color of the form border_color = CSS border color of the form. Example: red border_width = CSS border width of the form. Example: 1px font_type = CSS font type of the form. Example: Arial, sans-serif font_size = CSS font size of the form. Example: 13px navigation_font_size = font size of the navigation form. Example: 20px text_color = CSS color of the text. Example: #000000 link_color = CSS color of links. Example: #198ADC custom_css = Custom CSS to add to the page. Example: .bloggerDiv{display:none;}td {border: 0px solid transparent !important;} ad_density = How often should ads apear between search results. Example: 3 max = How many results to display at once. Example: 7 result_div_id = HTML ID of the div that contains the form. Example: pnpSearchResult searching = Text of the 'Searching' status of the plugin. Example: Searching... google_ads = off/on - do you want to enable Google Ads in the plugin? safe_search = off/on - do you want to use safe search to filter adult content? autocorrect = off/on - do you want to use autocorrect while searching? search_type = all/news/image - set the default search that will be realized by the form fromPublishedDate = publish start date, from when to search articles from. Only aplicable to news search. Example: 2016-01-01 toPublishedDate = publish end date, until when to search articles. Only aplicable to news search. Example: 2019-01-01
Refreshingly, Vidopticon Video Search Engine has a super-simple settings screen. Let's look at first at the settings panel:
Here you can find the steps needed in configuring your plugin even if you have no HTML knowledge at all. You can find options for:
HINT! Don't forget to click the Save button every time you modified your settings, otherwise the modifications will be lost!
Main Settings:
Vidopticon Video Search Engine Main Switch: Enable or disable the Vidopticon Video Search Engine. This acts like a main switch.
YouTube API Keys (Comma separated list): Insert your YouTube API keys (comma separated list). Get one here.
Enable Suggestions While Typing: Do you want to enable suggestions while typing for search boxes?
Enable Voice Recognition: Do you want to enable voice recognition for the search boxes?
Enable 'Load More' Navigator Do you want to enable the 'Load More' navigator in results?
Banned Words List: Do not include results that's title or content contains at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
Required Words List: Do not include results that's title or content does not contain at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
Require All Words in the 'Required Words List': Do you want to all words defined in the required words list? If you uncheck this, if only one word is found, the article will be published.
Maximum Title Word Count: Set the maximum word count for the title of search results. To disable this feature, leave this field blank.
Maximum Content Word Count: Set the maximum word count for the content of search results. To disable this feature, leave this field blank.
Source Channel ID: Select the channel ID from where you want to get your videos. How to get my channel ID?
Video Language: Select the language which you want to restrict search to.
Video Event Type: The event type parameter restricts a search to broadcast events.Acceptable values are: completed Only include completed broadcasts. live Only include active broadcasts. upcoming Only include upcoming broadcasts.
Video Source Location: Select the address from where the videos will be collected. In the first textfield, you can input a street address or a latitude, longitude pair (ex: '37.781157 -122.398720' or 'Oxford street, London'. In the second textfield, you can input a radius for this location, in miles or kilometers (ex: '1mi' or '3km')Returns videos by users located within a given radius of the given latitude/longitude. The location is preferentially taking from the Geotagging API, but will fall back to their YouTube profile. The parameter value is specified by latitude,longitude,radius, where radius units must be specified as either mi (miles) or km (kilometers). To disable this feature, leave both textfields blank.
Channel Type: Select the result type you want to get from the query. Valid types are: Show or Any.
Safe Search: The safeSearch parameter indicates whether the search results should include restricted content as well as standard content. Acceptable values are:moderate YouTube will filter some content from search results and, at the least, will filter content that is restricted in your locale. Based on their content, search results could be removed from search results or demoted in search results. This is the default parameter value.none YouTube will not filter the search result set.strict YouTube will try to exclude all restricted content from the search result set. Based on their content, search results could be removed from search results or demoted in search results.
Region Code: The Region Code parameter instructs the API to return search results for the specified country.
Video Caption: The videoCaption parameter indicates whether the API should filter video search results based on whether they have captions. Acceptable values are:any Do not filter results based on caption availability.closedCaption Only include videos that have captions.none Only include videos that do not have captions.
Video Definition: The videoDefinition parameter lets you restrict a search to only include either high definition (HD) or standard definition (SD) videos. HD videos are available for playback in at least 720p, though higher resolutions, like 1080p, might also be available.Acceptable values are:any Return all videos, regardless of their resolution.high Only retrieve HD videos.standard Only retrieve videos in standard definition.
Video Dimension: The videoDimension parameter lets you restrict a search to only retrieve 2D or 3D videos.Acceptable values are: 2d Restrict search results to exclude 3D videos.3d Restrict search results to only include 3D videos.any Include both 3D and non-3D videos in returned results. This is the default value.
Video Duration: The videoDuration parameter filters video search results based on their duration.Acceptable values are:any Do not filter video search results based on their duration. This is the default value.long Only include videos longer than 20 minutes.medium Only include videos that are between four and 20 minutes long (inclusive).short Only include videos that are less than four minutes long.
Video License: The videoLicense parameter filters search results to only include videos with a particular license. YouTube lets video uploaders choose to attach either the Creative Commons license or the standard YouTube license to each of their videos.Acceptable values are:any Return all videos, regardless of which license they have, that match the query parameters.creativeCommon Only return videos that have a Creative Commons license. Users can reuse videos with this license in other videos that they create. Learn more.youtube Only return videos that have the standard YouTube license.
Video Type: The videoType parameter lets you restrict a search to a particular type of videos.Acceptable values are:any Return all videos.episode Only retrieve episodes of shows.movie Only retrieve movies.
Video Syndication: The videoSyndicated parameter lets you to restrict a search to only videos that can be played outside youtube.com. Acceptable values are:any Return all videos, syndicated or not.true Only retrieve syndicated videos.
Search Order: The order parameter specifies the method that will be used to order resources in the API response. The default value is relevance.Acceptable values are:date Resources are sorted in reverse chronological order based on the date they were created.rating Resources are sorted from highest to lowest rating.relevance Resources are sorted based on their relevance to the search query. This is the default value for this parameter.title Resources are sorted alphabetically by title.videoCount Channels are sorted in descending order of their number of uploaded videos.viewCount Resources are sorted from highest to lowest number of views. For live broadcasts, videos are sorted by number of concurrent viewers while the broadcasts are ongoing.
Video Embeddable: The videoEmbeddable parameter lets you to restrict a search to only videos that can be embedded into a webpage. Acceptable values are:any Return all videos, embeddable or not.true Only retrieve embeddable videos.
Video Category: Select the YouTube video category in which you want to search in.
Shorte.st API Token: If you wish to shorten outgoing links using shorte.st, please enter your API token here. To sign up for a new account, click here. To get your API token after you have signed up, click here. To disable URL shortening, leave this field blank.
Maximum Number Of Links To Monetize: Set the maximum number of links to monetize from the top of the results. To disable this settings, leave this field blank.
Randomize Ad Order: Do you want to randomize the order of ads? If you disable this feature, ads will be shown in the exact order like you define them.
Do Not Show Same Ad Twice: Do you want to not show the same ad twice on the same search result?
Show Only Ads That Matched Searched Keywords: Do you want to show only ads that match the searched keywords?
YouTube Search - Result Title Template: Set the title template that will be used, when displaying results for YouTube search. Possible shortcodes are: %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_title_with_url%%, %%item_thumbnail_with_url%%, %%item_image_with_url%%, %%item_title_with_url_new_tab%%, %%item_thumbnail_with_url_new_tab%%, %%item_image_with_url_new_tab%%, %%item_url%%, %%item_description%%, %%item_published%%, %%item_published_since%%, %%item_channel%%, %%item_channel_id%%, %%item_image_url%%, %%item_image_height%%, %%item_image_width%%, %%item_thumbnail_url%%, %%item_thumbnail_height%%, %%item_thumbnail_width%%
YouTube Search - Result URL Template: Set the title template that will be used, when displaying results for YouTube search. Possible shortcodes are: %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_title_with_url%%, %%item_thumbnail_with_url%%, %%item_image_with_url%%, %%item_title_with_url_new_tab%%, %%item_thumbnail_with_url_new_tab%%, %%item_image_with_url_new_tab%%, %%item_url%%, %%item_description%%, %%item_published%%, %%item_published_since%%, %%item_channel%%, %%item_channel_id%%, %%item_image_url%%, %%item_image_height%%, %%item_image_width%%, %%item_thumbnail_url%%, %%item_thumbnail_height%%, %%item_thumbnail_width%%
YouTube Search - Result Description Template: Set the title template that will be used, when displaying results for YouTube search. Possible shortcodes are: %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_title_with_url%%, %%item_thumbnail_with_url%%, %%item_image_with_url%%, %%item_title_with_url_new_tab%%, %%item_thumbnail_with_url_new_tab%%, %%item_image_with_url_new_tab%%, %%item_url%%, %%item_description%%, %%item_published%%, %%item_published_since%%, %%item_channel%%, %%item_channel_id%%, %%item_image_url%%, %%item_image_height%%, %%item_image_width%%, %%item_thumbnail_url%%, %%item_thumbnail_height%%, %%item_thumbnail_width%%
YouTube Search - Display Thumbnail Image: Set the title template that will be used, when displaying results for YouTube search. Possible shortcodes are: %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_title_with_url%%, %%item_thumbnail_with_url%%, %%item_image_with_url%%, %%item_title_with_url_new_tab%%, %%item_thumbnail_with_url_new_tab%%, %%item_image_with_url_new_tab%%, %%item_url%%, %%item_description%%, %%item_published%%, %%item_published_since%%, %%item_channel%%, %%item_channel_id%%, %%item_image_url%%, %%item_image_height%%, %%item_image_width%%, %%item_thumbnail_url%%, %%item_thumbnail_height%%, %%item_thumbnail_width%%
Date Format (%%item_published%% Shortcode): Set the date format for the %%item_published%% shortcode.Example: Y-m-d H:i:s. To leave this at it's default value, leave this field blank.
Click To Start Voice Recognition: Set the text that will be displayed for the 'Click To Start Voice Recognition' string.
Voice Recognition Started: Set the text that will be displayed for the 'Voice Recognition Started' string.
Voice Recognition Paused: Set the text that will be displayed for the 'Voice Recognition Paused' string.
Voice Recognition Failed: Set the text that will be displayed for the 'Voice Recognition Failed' string.
Powered By: Set the text that will be displayed for the 'Powered By' string.
Matching Results Found: Translate or change this string that is displayed in the search form.
No Results Found: Translate or change this string that is displayed in the search form.
Load More: Translate or change this string that is displayed in the search form.
Loading: Translate or change this string that is displayed in the search form.
Use This Proxy When Accessing YouTube API: Use this proxy when accessing YouTube API. Enter it in this format: ip:port, or user:password@ip:port . Check here a list of free proxies.
Enable Usage Tracking: Do you want to enable usage tracking for search queries?
Enable Logging for Plugin: Do you want to enable logging for plugin?
Automatically Clear Logs After: Choose if you want to automatically clear logs after a period of time.
First List of Possible Sentences (%%random_sentence%%): Insert some sentences from which you want to get one at random. You can also use variables defined below. %something ==> is a variable. Each sentence must be sepparated by a new line.
Second List of Possible Sentences (%%random_sentence2%%): Insert some sentences from which you want to get one at random. You can also use variables defined below. %something ==> is a variable. Each sentence must be sepparated by a new line.
List of Possible Variables: Insert some variables you wish to be exchanged for different instances of one sentence. Please format this list as follows:Variablename => Variables (seperated by semicolon) Example: adjective => clever;interesting;smart;huge;astonishing;unbelievable;nice;adorable;beautiful;elegant;fancy;glamorous;magnificent;helpful;awesome
Activity and Loggind Screen:
Restore Plugin Default Settings: Hit this button and the plugin settings will be restored to their default values. Warning! All settings will be lost!
Activity Log: This is the main log of your plugin. Here will be listed every single instance of the rules you run or are automatically run by schedule jobs (if you enable logging, in the plugin configuration).
How to customize resulting posts with built in shortcodes?
You can use the following shortcodes in post title and content editing:
%%random_sentence%% - generates a random sentence (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
%%random_sentence2%% - generates a random sentence (from the second generator) (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
%%item_title%% - the title of the search result
%%item_url%% - the url of the search result
%%item_title_with_url%% - adds the title with a link added to it
%%item_thumbnail_with_url%% - adds the thumbnail with a link added to it
%%item_image_with_url%% - adds the image with a link added to it
%%item_title_with_url_new_tab%% - adds the title with a link added to it (new tab)
%%item_thumbnail_with_url_new_tab%% - adds the thumbnail with a link added to it (new tab)
%%item_image_with_url_new_tab%% - adds the image with a link added to it (new tab)
%%item_description%% - the description of the search result
%%item_published%% - the publication date of the search result
%%item_published_since%% - adds the time elapsed since the publishing of the search result
%%item_channel%% - adds the channel name to the results displaying
%%item_channel_id%% - adds the channel id to the results displaying
%%item_image_url%% - the image URL of the search result
%%item_image_height%% - the image height of the search result
%%item_image_width%% - the image width of the search result
%%item_thumbnail_url%% - the thumbnail URL of the search result
%%item_thumbnail_height%% - the thumbnail height of the search result
%%item_thumbnail_width%% - the thumbnail width of the search result
How to work with 'Random Sentence Generator'?
You can use the Random Sentence Generator by inserting list of sentences to the 'First List of Possible Sentences (%%random_sentence%%)' text field. Here, you can add full sentences, or sentences with variables. Variables are structured as: %something. A possible list of sentences can be:
Meet this %adjective %noun %sentence_ending
This is the %adjective %noun ever%sentence_ending
I %love_it %nouns , because they are the %adjective %sentence_ending
My %family says this plugin is very %adjective %sentence_ending
These %nouns are quite %adjective %sentence_ending
You can define variables in the 'List of Possible Variables:' textfield. Here you can define values to variables, values which will be used in the random sentence forming. Variables can be defined as follows:
Vidopticon Video Search Engine is a simple, yet powerful tool you can use to create an autoblog with ease. The setup and settings of the plugin couldn't have been easier. Now, let's go and enjoy the results of this great plugin! Have fun using it!
Once again, thank you so much for purchasing this item. As I said at the beginning, I'd be glad to help you if you have any questions regarding this plugin and I'll do my best to assist.