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!
This plugin will allow you to build from scratch an autoblogging system, based on Yelp feeds you define (based on location, keywords and search terms).
This plugin provides one solution to the ongoing search for new blog content. It not only provides a steady stream of rich, searchable content, it also helps to keep your website up to date with the latest uploaded items. You can build rules that will generate posts that are near to unique in website crawlers's eyes. They require none to very little customization.
The goal is to achieve the following:
Yelpomatic Automatic Post Generator will import items from any content from public Yelp content, you define to your blog, based on search keywords. Resulting blog posts are fully customizable and rich in content. List of customizable stuff for each post:
post content - including the responsive embedded Yelp title, map (with geolocation), reviews, address, coordinates, Yelp links and much more
wide range of item search options: search based on a search term, from a specific address, coordinates, language, filter category, price level, open now, open at, attributes search and many other search attributes!
import Yelp reviews as comments to the generated post - customize the comment template as you like
generate content in any language that is also supported by Yelp: english, french, spanish, german, czech, danish, filipino, italian, japanese, malay, norvegian, dutch, polish, portugese, swedish, turkish, chinese
if you can't find your desired language in the above list, you can still use Google Translate to get content in any possible language
post author user name
post status (published, draft, pending, private, trash)
automatically generate post categories or tags from Yelp item, description content or hashtags from description
manually add post categories or tags to items
generate post or page or any other custom post type
automatically generate a featured image for the post
enable/disable comments for the generated post
enable/disable pingbacks/trackbacks for the generated post
wide range of post filtering options
customize post title and content (with the included wide variaty of relevant post shortcodes)
Other plugin features:
Google Translate support ' select the language in which you want to post your articles
Text Spinner support ' automatically modify generated text, changing words with their synonyms ' great SEO value!
Using Native Yelp API
Keyword Replacer (replace relevant keywords with your links)
Random sentence generator (relevant sentences - as you define them)
shortcode for including a map to a predefined location, with a predefined popup text, in a post
detailed plugin activity logging
scheduled rule runs
This plugin needs an Affiliate ID for you to get revenue for item sales. But how to get one?
You can check out the YouTube video below, where I create a new APP and use it in the plugin!
Plugin requirements:
php CURL extension (install to Debian/Ubuntu etc with apt-get install php5-curl )
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 'Yelpomatic Automatic Post Generator'. First thing first, let's head over to Settings > Yelpomatic Automatic Post Generator and take a look at what options are available.
Refreshingly, Yelpomatic Automatic Post Generator 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:
Yelpomatic Automatic Post Generator Main Switch: Enable or disable the Yelpomatic Automatic Post Generator. This acts like a main switch.
Yelp App ID: Insert your Yelp App ID. Click here to get one.
Yelp App Secret: Insert your Yelp App Secret.Click here to get one.
Google Maps API Key: Insert your Google Maps API Key. How to get one? Visit the APIs Console at https://code.google.com/apis/console and log in with your Google Account. Click the Services link from the left-hand menu. Activate the Google Maps API v3 service. Click the API Access link from the left-hand menu. Your API key is available from the API Access page, in the Simple API Access section. If you leave this field blank, a default key will be used. For better performance and reliability, please introduce your own Google Maps API Key.
'Read More' Button Text: Insert your desired text for the 'Read More' button.
'Get Directions' Link Text: Insert your desired text for the 'Get Directions' link.
'Health Inspections' Link Text: Insert your desired text for the 'Health Inspections' link.
'View Menu' Link Text: Insert your desired text for the 'Health Inspections' link.
'Review Highlights' Link Text: Insert your desired text for the 'Health Inspections' link.
'Questions' Link Text: Insert your desired text for the 'Review Highlights' link.
Automatically Shorten URLs: Choose if you want to automatically shorten URLs using Goo.gl URL shortener.
Goo.gl API key: Insert your goo.gl api key. To lean more about this, please visit this link.
Strip Links From Generated Post Content: Choose if you want to strip links from the generated post content.
Show Extended Item Information Metabox in Post: Choose if you want to show an extended information metabox under every plugin generated post.
Enable Logging for Rules: Do you want to enable logging for rules?
Enable Detailed Logging for Rules: Do you want to enable detailed logging for rules? Note that this will dramatically increase the size of the log this plugin generates.
Automatically Clear Logs After: Choose if you want to automatically clear logs after a period of time.
Timeout for Rule Running (seconds): Set the timeout (in seconds) for every rule running. I recommend that you leave this field at it's default value (3600).
Send Rule Running Summary in Email: Choose if you want to receive a summary of the rule running in an email.
Email Address: Input the email adress where you want to send the report. You can input more email addresses, separated by commas.
Minimum Title Word Count: Set the minimum word count for post titles. Items that have less than this count will not be published. To disable this feature, leave this field blank.
Maximum Title Word Count: Set the maximum word count for post titles. Items that have more than this count will not be published. To disable this feature, leave this field blank.
Banned Words List: Do not include posts 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 posts 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.
Automatically Translate Content To: Do you want to automatically translate generated content using Google Translate?
Skip Posts That Do Not Have Images: Choose if you want to skip posts that do not have images.
Spin Text Using Word Synonyms: Do you want to randomize text by changing words of a text with synonyms using one of the listed methods? Note that this is an experimental feature and can in some instances drastically increase the rule running 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
Custom HTML Code #1: Insert a custom HTML code that will replace the %%custom_html%% variable. This can be anything, even an Ad code.
Custom HTML Code #2: Insert a custom HTML code that will replace the %%custom_html2%% variable. This can be anything, even an Ad code.
ID (Affiliate Keyword Replacer Tool Settings:) This is the ID of the rule.
DEL (Affiliate Keyword Replacer Tool Settings:) Do you want to delete this rule?
Search Keyword (Affiliate Keyword Replacer Tool Settings:) This keyword will be replaced with a link you define.
Replacement Keyword (Affiliate Keyword Replacer Tool Settings:) This keyword will replace the search keyword you define. Leave this field blank if you only want to add an URL to the specified keyword.
Link To Add (Affiliate Keyword Replacer Tool Settings:) Define the link you want to appear the defined keyword. Leave this field blank if you only want to replace the specified keyword without linking from it.
Yelp Search to WordPress:
ID This is the ID of the rule.
Search Location This field is required. Specifies the combination of "address, neighborhood, city, state or zip, optional country" to be used when searching for businesses. You can also enter the latitude and longitude of the location you want to query, strictly in this format: (latitude, longitude). ex: (37.79, -122.40). If you do not respect this coordinates notation standard, input will be considered as an address.
Keyword Search Optional. Search term (e.g. "food", "restaurants"). If term isn't included we search everything. The term keyword also accepts business names such as "Starbucks".
Schedule (Hours) Select the interval in hours after which you want this rule to run.
Max Posts At A Time Select the maximum number of posts that this rule can create at once. 0-50 interval allowed..
Del: Do you want to delete this rule?
Post Status: Select the status that you want for the automatically generated posts to have.
Item Type : Select the type (post/page) for your automatically generated item.
Post Author : Select the author that you want to assign for the automatically generated posts.
Active: Do you want to enable this rule? You can deactivate any rule (you don't have to delete them to deactivate them).
Info: The number of items (posts, pages) this rule has generated so far.
Actions: Do you want to run this rule now? Note that only one instance of a rule is allowed at once.
Advanced Plugin Settings Dropdown Screen:
Generated Post Title: Set the title of the generated posts for user rules. You can use the following shortcodes: %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_excerpt%%, %%item_cat%%, %%item_tags%%
Generated Post Content: Set the content of the generated posts for user rules. You can use the following shortcodes: %%item_location%%, %%item_lat%%, %%item_lon%%, %%item_review_count%%, %%item_transactions%%, %%item_tags%%, %%item_phone%%, %%item_all_images%%, %%item_price%%, %%item_schedule%%, %%item_rating%%, %%item_questions%%, %%item_review_highlights%%, %%pinterest_share_button%%, %%twitter_share_button%%, %%google_plus_share_button%%, %%facebook_share_button%%, %%item_view_menu%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_url%%, %%item_read_more_button%%, %%item_show_image%%, %%item_image_URL%%, %%item_excerpt%%, %%item_get_directions%%, %%item_health_inspections%%
Imported Comment Content: Set the content of the generated comments from reviews, for user rules. You can use the following shortcodes: %%review_text%%, %%review_rating%%, %%review_username%%, %%review_user_image%%, %%review_created_time%%, %%review_url%%
Import Comments: Do you want to automatically generate post comments from item's comments feed?
Grab Extra Info: When checked, the plugin will try to grab extra information for each business. You will get extra info like: business images and open hours. %%item_all_images%% and %%item_schedule%% shortcodes will get values.
Filter Category: Optional. Category to filter the search results with.
Search Radius: Optional. Search radius in meters. If the value is too large, a AREA_TOO_LARGE error may be returned. The max value is 40000 meters (25 miles).
Result Language: Optional. Specify the locale (language) to return the business information in.
Sort Results Order: Optional. Sort the results by one of the these modes: best_match, rating, review_count or distance. By default it's best_match. The rating sort is not strictly sorted by the rating value, but by an adjusted rating value that takes into account the number of ratings, similar to a bayesian average. This is so a business with 1 rating of 5 stars doesn't immediately jump to the top.
Price Level: Optional. Pricing levels to filter the search result with: $, $$, $$$ or $$$$.
Open Now: Optional. When checked, only returns the businesses open now. Notice that 'Open At' and 'Open Now' cannot be used together. In this case, 'Open Now' will have priority.
Open At: Optional. Input a time in the same timezone of the search location. Input format must be: mm/dd/yyyy --:-- AM/PM. If specified, it will return business open at the given time. Notice that 'Open At' and 'Open Now' cannot be used together. In this case, 'Open Now' will have priority.
Attributes Search: Optional. Additional filters to restrict search results. Possible values are: hot_and_new - Hot and New businesses, request_a_quote - Businesses that have the Request a Quote feature, waitlist_reservation - Businesses that have an online waitlist, cashback - Businesses that offer Cash Back, deals - Businesses that offer Deals
Generated Post Format: If your template supports "Post Formats", than you can select one here. If not, leave this at it\'s default value.
Additional Post Category: Select the post category that you want for the automatically generated posts to have.
Automatically Add Post Categories From Items: Do you want to automatically add post categories from the feed items?
Automatically Add Post Tags From Items: Do you want to automatically add post tags from the feed items?
Additional Post Tags: Select the post tags that you want for the automatically generated posts to have.
Enable Comments For Generated Posts: Do you want to enable comments for the generated posts?
Enable Pingbacks/Trackbacks For Generated Posts: Do you want to enable pingbacks and trackbacks for the generated posts?
Automatically Get Featured Image for Generated Post: Do you want to set featured image for generated post (to the first image that was found in the post)?
Default Featured Image if No Image Available for Item: Insert a link to a valid image that will be set for the featured image for the posts that do not have a valid image attached or if you disabled automatical featured image generation. To disable this feature, leave this field blank.
Activity and Loggind Screen:
Rules Currently Running: These rules are currently running on your server.
Restore Plugin Default Settings: Hit this button and the plugin settings will be restored to their default values. Warning! All settings will be lost!
Delete All Posts Generated by this Plugin: Hit this button and all posts generated by this plugin will be deleted!
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:
%%item_location%% - the location of the business
%%item_lat%% - the latitude of the business
%%item_lon%% - the longitude of the business
%%item_review_count%% - business review count
%%item_transactions%% - the transactions offered by the business
%%item_tags%% - business tags
%%item_phone%% - business phone number
%%item_all_images%% - all images with the business (max 3)
%%item_price%% - avarage, user estimated price of the business
%%item_schedule%% - opening schedule of the business
%%item_rating%% - business rating (max 5)
%%item_questions%% - link to frequent questions about the business
%%item_review_highlights%% - link to review highlights about the business
%%pinterest_share_button%% - share the business on Pinterest
%%twitter_share_button%% - share the business on Twitter
%%google_plus_share_button%% - share the business on Google Plus
%%facebook_share_button%% - share the business on Facebook
%%item_view_menu%% - link to business's menu
%%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 geenrator) (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
%%item_title%% - title (name) of the business
%%item_url%% - URL of the business
%%item_read_more_button%% - a read more button (that leads to the business URL)
\
%%item_show_image%% - displays the business's image
%%item_image_URL%% - the URL of the business's image
%%item_excerpt%% - the excerpt of the post (usually the business name)
%%item_get_directions%% - link to business's 'Get Directions' page
%%item_health_inspections%% - link to business's 'Health Inspections' page
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:
These random sentences can be used in post titles or post content, by adding the %%random_sentence%% or %%random_sentence2%% shortcode.
Available shortcode
You can also use the following shortcode in your content: [yelpmatic_map].
Use the [yelpmatic_map] shortcode to display a map, pointing to a custom, predefined location, with a predefined hint showing in a popup box.
Example of shortcode usage: [yelpmatic_map lat=47.498384 lng=19.040528 zoom=12 height=300px text="Budapest - a nice city to visit"].
Shortcode parameters:
lat - the latitude where you want the map to point
lng - the longitude where you want the map to point
zoom - the zoom level of the map. Valid range is: 1-20. EX: 1: World, 5: Landmass/continent, 10: City, 15: Streets, 20: Buildings
height - the height of the map, in pixels
text - the text to be shown in thepopup on the map
Yelpomatic Automatic Post Generator 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.