To Show Weather Forecast for Selected City ( in City Selection Box ) you need to first have Templatic-AdManager plugin downloaded ,installed and activated at your sites backend.
The Service for showing the Weather forecast is provided by Forecast ( http://blog.forecast.io/forecast-embeds/ ).
The Forecast Embed is an HTML code which when used in theme will show a concise little display of current conditions, the weekly forecast, and weather alerts (if any) for whatever location you specify.

How to Use the HTML code with Templatic Ad – Manager Plugin

• First install and activate Templatic AdManager plugin at your site ( themes backend )
• Go to wp-admin -> Tevolution -> Manage Locations -> Select ‘Manage Ads’ checkbox in Activate location management for option.
• Go to -> Manage Ads -> Add New Ad .
• Now give appropriate Title to this Ad like “New York Weather” ( for New York City ) (Please Note that this code will only work for Cities added in Manage Locations section at themes backend. )
• After giving the Title, Select the Country, State and City ( Location & Map ) for which you want to show the Weather forecast.
• Then in Advertisement Settings first select the Advertisement type as ‘Code’.
• In the Next step add the below HTML code at ‘Enter HTML code’ textarea.

<iframe id=”forecast_embed” type=”text/html” frameborder=”0″ height=”245″ width=”100%” src=”http://forecast.io/embed/#lat=40.7127&lon=-74.0059&name=NewYork“> </iframe>

The embed takes a few parameters (bold text): the longitude and latitude of the point you want the forecast for, the name of the location as you want it to appear at the top of the embed, and the width of the embed (which can either be in pixels or percentage). The height is fixed at 245px.
You can find the latitude and longitude of most locations using a tool like itouchmap.
• After all the above steps select the other options in Add New Ad page as per your choice i.e the options like ‘Select Display Categories’ and ‘Advertisement Display Location’ and finally Publish the Ad.
• If you have selected the Ad to be shown on Category Page than it will show the Weather format as below

• You can also use the T – Display Ad widget in widget section at themes backend to show the Weather forecast at your desired area.
NOTE: As the Ad is posted selecting the city, the Widget or Ad at front end will show the Weather as per the city selected in City Selection box.

Optional Parameters

There are also a few of optional parameters, marked in bold text:

<iframe id=”forecast_embed” type=”text/html” frameborder=”0″ height=”245″ width=”100%” src=”http://forecast.io/embed/#lat=42.3583&lon=-71.0603&name=NewYork&color=#00aaff&font=Georgia&units=uk“> </iframe>

You can change the font from the default Helvetica, the color of the temperature bars, and the localization of the units (‘us’ for Fahrenheit and mph, ‘uk’ for Celsius and mph, ‘ca’ for Celsius and km/h, and ‘si’ for Celsius and m/s).

IF YOU FIND ANY DIFFICULTY IN MAKING THIS WORK AT YOUR SITE, PLEASE REFER THE URL http://blog.forecast.io/forecast-embeds/

Important

This Location Manager guide is for version 2.0 and newer. To open the old guide please click here.

Install and activate

Assuming you already have Directory installed, Location Manager should be installed as well. However, if you want to install just this particular plugin, follow these instructions.

1. Connect to member area and under “Plugin Downloads” section download the Tevolution – Location Manager Plugin to your hard drive.
2. Navigate to wp-admin -> Plugins -> Add New -> Upload and upload the downloaded zip file.
3. Activate the plugin once the upload process is completed.

The purpose of Location Manager

In short, Location Manager is the component that enables the city functionality inside Directory. Here’s some basic information about that plugin, i.e. the things you should know before you commit to using it…

• Despite the fact location management is divided into three levels (countries, states and cities), only cities are interactive. In other words, you can’t “visit” a specific country or state, just cities within those countries and states.
• Cities are essentially listing filters. Simply put, listings from one city won’t show in the other one.
• Location Manager increases page load times because all content must be constantly filtered by cities as well as other parameters. Don’t use the plugin if you don’t really need it. For example, if the area you’re covering with your directory is really small, there is no real need to filter content by cities since content from one city might be interesting to residents of a nearby city.
• Always be aware of the city you’re “in”. If the listing you just added isn’t displaying on the homepage (or category page), check your current city. It’s possible you added the listing inside a city different than the one you’re currently “visiting”.

General Settings

The majority of Location Manager settings are available from Tevolution ⇨ Manage Locations. Here’s a list of options available in that area…

City selector style

This option defines the look of the city selector available inside your theme header (usually the top left corner). Here’s how they look in the front-end.

City selector levels

The option you choose here will affect both the city selector and the multi city field inside your submission forms. In other words, if you select the “Only Cities” option visitors won’t be required to input the country and state while submitting listings.

Is it possible to change the country > state > city hierarchy?
It’s not easy, but yes, it’s possible. For example, let’s imagine you want to change the hierarchy levels to city > neighborhood. Here’s how you do it:

1. Inside the “City selector levels” option select “One Country”.
2. Go to Manage Locations ⇨ States (tab) and add your city as a state. For example, create a new state called “Los Angeles”.
3. Go to Manage Locations ⇨ Cities (tab) and add your neighborhood as a city. Instead of entering the city name as “Los Angeles”, instead enter “Beverly Hills”. Adjust the pin on the map if necessary.
4. Open the en_US.po language file (click here for a tutorial).
5. Translate all necessary instances of the word “state” into “city”.
6. Translate all necessary instances of the word “city” into “neighborhood”.

If you did everything correctly you should now have a two-level hierarchy with cities and neighborhoods.

Location Tracking Method

Location Manager has an IP tracker built-in that allows your theme to pinpoint the visitors location. The “Location Tracking Method” option allows you define the service that will be used for this. I recommend you change this only if you’re experiencing problems with the default (Freegeoip) option.

To enable the MaxMind option follow these steps

1. Download this zip file.
2. Extract the file using software like 7-Zip.
3. Connect to your server with FTP. Click here for a tutorial if you haven’t done it before.
4. Place the contents of the zip file inside the /wp-content/plugins/Tevolution-LocationManager/ folder on your server.
5. Enable the “MaxMind” option inside Tevolution ⇨ Manage Locations.

Homepage Displays

Choose what happens when visitors come to your site.

Default city – displays your default city. You can set the default city from the Cities tab.
Ask to show nearest city – upon arrival visitors will see a strip at the top asking them to share their location.
Nearest city – visitors will be taken to the city nearest to them without the ability to stop the process.

Activate location management for

The multi-city functionality will only be active for post types selected here. If you want blog posts to show inside all cities don’t check the “Post” box.

Note: New post types that you create and those enabled by add-ons (e.g. Events or Properties) won’t be automatically selected here. You will have to enable location management for them manually.

Track city visits (city logs)

Enable this if you want to see how visits are distributed across your cities. City log information is available from Tevolution ⇨ Manage Locations ⇨ City Logs (tab).

Add a city

To add your own city navigate to Tevolution ⇨ Manage Locations ⇨ Cities (tab) ⇨ Add new city.

Country & State

Choose the country and state appropriate for the city you’re adding. In case the country or state isn’t available, you can add a new one from the Country and/or State tab.

Map Type

Set the type of your map. If you want to add some flair to your maps consider getting the Map Customizer add-on.

Map Scaling Factor

Choose how much of the map to show. 1 displays the whole globe while 19 shows a specific house. An appropriate level for a city is around 13.

City Name

This is the most important field inside the whole form. By entering a value you are setting both the name of the city and its location. As soon as you stop typing your city name the little map will zoom on it. Feel free to move the pin in order to better define the location of your city.

City latitude and longitude

These two fields are populated automatically as soon as you enter a value inside the “City Name” field. They will also be automatically updated if you move the pin around (inside the small map).

Homepage / Category page map display

These settings let you control the behavior of the map. If you want to show all available listings at all times be sure to select the “Fit all available listings” option. If you want to respect the zoom level set under “Map Scaling Factor”, choose that option.

Post Type & Categories

Choose the post types and categories that you plan on showcasing in this city. Selected post types and categories will appear inside the homepage map.

City Message

Write a city description that you can display when visitors are browsing that particular city. To actually show the description enter the following shortcode inside a regular “Text” widget.

[city_message]

Background Color and Background Image

Choose a color by clicking on the input field and using the color picker. Set a background image by clicking on Browse, uploading an image and then clicking on “Set as background image” in the bottom right corner. Ideal image size is 1920 pixels. The area affected by both the color and image is the area on the left and right side of the container. Example.

Note: The changes you make here will override those inside Appearance ⇨ Customizer. Also, if you set both a background color and a background image, the image will have priority.

Header Background Color and Image

Choose a color by clicking on the input field and using the color picker. Set a header background image by clicking on Browse, uploading an image and then clicking on “Set as header image” in the bottom right corner. Ideal image size is 1240 pixels. The area affected by both the color and image is the area usually populated with the logo and the search bar. Example.

Note: The changes you make here will override those inside Appearance ⇨ Customizer. Also, if you set both a header background color and a header background image, the image will have priority.

Add countries & states

You can add new countries and states from the “Countries” and “States” tabs inside the Tevolution ⇨ Manage Locations section. Most world countries are already added so you don’t really have to add them manually. However, if you do commit to that, make sure to add countries first since you’re required to select a country while adding a state.

Map Shortcode

Use the below shortcode to display content (one or most post types) within a specific city. To create a page using this shortcode navigate to Pages ⇨ Add New and paste in the code.

[TCITY-DIRECTORYMAP cityid='1' post_type='listing' height='500'][/TCITY-DIRECTORYMAP]

cityid – the ID of the city you want to show. The city ID is displayed when hovering over a city inside Manage Locations ⇨ Cities (tab). Screenshot.
post_type – enter the post type you want to show (e.g. listing, event, property, etc). To display multiple post types separate them with a comma. For example, to display listings and properties, enter the value like this: ‘listing,property’.
height – enter the map height in pixels.

Bulk upload cities

To use this functionality you’ll first need to install the optional (and free) Bulk Import/Export plugin. Here are the installation steps…

1. Download the Bulk Import/Export extension.
2. Navigate to Plugins ⇨ Add New ⇨ Upload and load the downloaded zip file. Activate the plugin once the installation is complete.
3. To start using the plugin navigate to Tevolution ⇨ Bulk Import/Export.
4. To bulk upload city focus on the CSV City Import section

How to bulk upload cities?

Start by downloading the sample CSV file available at the bottom of the CSV City Import section. The content you add must match the structure inside that file. To actually edit the CSV you’ll need a text editor like Notepad++, or even better, Microsoft Excel. For general tips on editing CSV files open the Bulk Upload section of our Tevolution guide.

Important!

This guide is for Directory 2. To open the guide for Directory 1.1.9 and older please click here

Install Directory using the WordPress back-end

Easy installation

1. Connect to the member area and expand the “Directory” area within the “Directory Downloads” section. Download the Easy Installation .zip file.
2. Login to your WordPress dashboard and navigate to Appearance ⇨ Themes ⇨ Add New ⇨ Upload. Load the .zip file you just downloaded.
3. Activate the theme once the installation process is done.
4. Enter the license key. You can get it from the member area, under “Your Subscriptions” inside the right sidebar. Screenshot.
5. Go to the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo. The dummy data activation process can last up to 1-2 minutes. Don’t interrupt it.

Easy installation – Video Tutorial (watch in HD and full screen)

Traditional installation

This installation type is necessary on servers that don’t allow plugins to be loaded automatically (which is the case with the Easy Installation method). Traditional installations basically means loading each Directory component separately. Instead of installing one file (like with Easy Installation) you’ll instead manually install 3 plugins and 1 theme.

1. Download all files available under “Traditional Installation” inside member area.
2. Login to your WordPress dashboard and navigate to Plugins ⇨ Add New ⇨ Upload.
3. Load the tevolution.zip you just downloaded. Activate the plugin once the installation is done.
4. Enter the license key. You can get it from the member area, under “Your Subscriptions” inside the right sidebar. Screenshot.
5. Navigate to Plugins ⇨ Add New ⇨ Upload and load the Tevolution-Directory.zip. Activate the plugin once the installation is done.
6. Navigate to Plugins ⇨ Add New ⇨ Upload for the last time and load the Tevolution-LocationManager.zip. Activate the plugin once the installation is done.
7. Navigate to Appearance ⇨ Themes ⇨ Add New ⇨ Upload. Load the Directory theme file you previously downloaded. Activate the theme once the installation process is done.
8. While in the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo. The dummy data activation process can last up to 1-2 minutes. Don’t interrupt it.

Install Directory using FTP

Installing via FTP is necessary on servers that aren’t optimized for WordPress and can often interrupt the installation process because of the long execution time. Good news is that this type of install isn’t particularly hard, just longer compared to installing from the back-end.

1. Download all files available under “Traditional Installation” inside member area and extract them using software like 7-Zip. Use the “Extract here” option; don’t extract into a new folder.
2. Assuming you read the above linked FTP tutorial, navigate to /wp-content/plugins/ on your server and upload the three plugin folders (Tevolution, Tevolution-Directory and Tevolution-LocationManager)
3. Navigate to /wp-content/themes/ and upload the 4th (theme) folder
4. Login to your WordPress dashboard and go to Plugins. Activate Tevolution and enter the license key available inside our member area.
5. Go to the Plugins section again and activate Tevolution – Directory and then Tevolution – Location Manager.
6. Navigate to Appearance ⇨ Themes and activate the Directory theme.
7. While in the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo.

Possible installation issues/errors

Because of the vast array of different server setups, Directory installation sometimes doesn’t always go as smooth as we’d like. Here are the most frequent issues we’ve observed so far as well as instructions on how to solve them.

Blank page after activating the theme

Assuming you installed and activated the three mandatory plugins, a blank page after activating Directory usually means not enough server memory has been assigned to WordPress. This needs to be fixed in two stages; first we regain access to the back-end and then we make sure it doesn’t happen again.

Restoring wp-admin access

This is a common WordPress problem caused by plugin-plugin or plugin-theme conflicts. To restore the back-end we just need to deactivate the theme or plugin that caused the crash. Here are the steps:

1. Connect to your server with FTP.
2. Depending on what caused the crash (plugin or theme) navigate to either /wp-content/plugins or /wp-content/themes. In this particular issue, the theme caused the problem so go to /wp-content/themes.
3. Rename the theme folder (in this case Directory) to anything else. For example: Directory-temp
4. Navigate to your WordPress dashboard (it should open now) and go to Appearance ⇨ Themes. Load a stock WordPress theme (e.g. Twenty Fourteen) if it wasn’t loaded automatically.
5. Go back to your server and rename the theme back to its original name.
6. Navigate to Appearance ⇨ Themes again and re-activate your primary theme. In our case, Directory.

Follow these steps to fix the memory problem that caused the blank page

1. Connect to your server with FTP
2. Open wp-config.php located inside your root WordPress folder
3. Add the following line of code at the very bottom of the file:

   define( 'WP_MEMORY_LIMIT', '64M' );

500 Internal Server Error after loading sample data

From my experience this error is usually caused when the hosting provider sets the max script execution time too low. Since loading sample data can take up to a minute, the execution time needs to be long enough to complete the process. For this particular issue, we recommend contacting your hosting provider for assistance. Here are some of the things you can request/mention:

• Request them to increase the max_execution_time variable inside the php.ini file
• Ask them to tweak the max_input_time Apache setting (controls execution time for everything, not just PHP)

In case they can’t or don’t want to help, here’s something you can try using the .htaccess file: http://stackoverflow.com/a/8744184

Upgrading from Directory 1 to Directory 2

Stuff you need to know before upgrading

• Upgrading will undo your customizations. This is because all files are updated during the upgrade process. If you customized your site using plugins, there’s a chance some tweaks will still work.
• “T – Advertisement” and “T – About Us” widgets have been removed from Directory. If you’re using them on your current site just copy/paste their content inside a text file. Once the new theme is installed simply paste your contents inside the default WordPress “Text” widget.
• “All in One Search” widget has been renamed/replaced with “Instant Search” widget. The new widget comes with only 1 input field and displays instant results as soon as visitors start typing. Similar to the previous widget, you can add your custom fields inside the widget.
• Because of major CSS changes inside Directory 2 there’s a good chance most of your CSS tweaks (entered inside the Custom CSS Editor) won’t work. You will have to redo those.
• Color changes made inside Appearance ⇨ Customize ⇨ will be undone after upgrading to Directory 2.
• Support for the “Are you a human” and “WP-reCAPTCHA” plugins has been removed. Directory now uses WP-reCAPTCHA API for protecting forms against spam. The feature is built-in to no additional plugins are necessary. Click here to read more setting up captcha inside Directory 2.
• Certain features that were included inside Tevolution in earlier versions are now optional (free) plugins. Most notable of these is the Bulk Import/Export feature. For more info on how to get these features in Directory 2 please click here.
• You might experience issues with corrupted widgets if you’re running PHP version 5.2 and older. Backup your text-based widgets inside text files and re-create them after the upgrade. Click here for more info on how you can see your PHP version.

Upgrading through the Dashboard

Go to wp-admin ⇨ Themes and see if you have any theme update notifications. Are you being prompted to update Directory to version 2.0 (or higher)? If yes, that means that Directory 2 is available and ready to be installed on your site. Along with updating the four main Directory components, upgrade to Directory 2 will require you to update everything else as well. Any Directory add-on or child theme you have installed must be updated to the latest version.

It’s important you perform the updates/steps in the following order

1. Make sure you have a working backup of your site. Here are some plugins you can use.
2. Install and activate a maintenance plugin while performing these updates. I personally like this one.
3. Navigate to wp-admin ⇨ Plugins and update all your add-ons (if you have any). It’s important you update the add-ons before updating Tevolution.
4. Update Tevolution.
5. Update Tevolution-Directory and Tevolution-Location Manager.
6. Navigate to wp-admin ⇨ Themes and update the parent Directory theme.
7. Update your child theme (if you’re using one).

Note: While updating you’ll be asked to enter your Templatic credentials. In case you forgot the password reset it from the member area login screen. If you experience other account-related issues please submit a query using the contact form (choose Billing / Account issue).

Traditional upgrade

Traditional upgrading means you’ll be overwriting files directly on your server (through FTP or cPanel). Instructions below will be written with FTP in mind. If you haven’t used FTP in the past please open our FTP tutorial.

1. Make sure you have a working backup of your site. Here are some plugins you can use.
2. Install and activate a maintenance plugin while performing these updates. I personally like this one.
3. Download the zip files for all 4 Directory components (3 plugins, 1 theme) from the member area.
4. Extract the zip files using software like 7-Zip. Use the “Extract Here” option.
5. Connect to the server and navigate to /wp-content/plugins.
6. Rename the current Tevolution folder by adding -old at the end. For example: Tevolution -> Tevolution-old.
7. Upload the updated Tevolution folder from your hard drive to /wp-content/plugins.
8. Repeat the process for the other two plugins (Tevolution-Directory and Tevolution-LocationManager) and also for any add-on you have installed. You must update all add-ons to their latest version in order for them to work with Directory 2.
9. Navigate to /wp-content/themes and rename the current Directory folder to Directory-old.
10. Upload the new Directory folder from your hard drive to /wp-content/themes.
11. If you’re using a child theme (like SpotFinder or CityGuide), you can update it the same way as you just did with the parent Directory theme.
12. Delete all the -old folders if you don’t need them.

Possible issues after upgrading

Once the upgrade is complete you mind notice some weird graphical glitches with your theme. These are most common…

Design broken on listing detail pages
This can happen on other ages as well (category page, author page, etc) but is usually most noticeable on the listing detail page. From my experience this was usually caching related. Hard refreshing (CTRL + F5) or manually clearing the browser cache should solve this problem.

Color options inside Appearance ⇨ Customize not responding to changes
If this is happening to you please follow these steps.

1. Connect to your server with FTP and navigate to /wp-content/themes/Directory/css.
2. Open the admin_style.css file.
3. Delete all contents of this file. CTRL + A and then Backspace should do the trick.
4. Go back to Appearance ⇨ Customize. The color settings should work now.

Setup permalinks

Setting up permalinks at the very beginning (just after installation) is important because Directory provides a lot of tools for customizing them. If you customize permalinks after Google indexes your site a bunch of visitors will land on 404 pages.

Directory is optimized to work with “Post name” permalinks. To active them follow these steps:

1. Navigate to wp-admin ⇨ Settings ⇨ Permalinks.
2. Under “Common Settings” choose the Post name option.
3. Hit “Save Changes” to confirm the change.

With Post name permalinks active, you can tweak permalinks further by navigating to Tevolution ⇨ Settings ⇨ Permalinks (tab). Inside this section you either remove or edit slugs for: Categories, Tags, Individual listings, Authors, Cities and even your custom post types.

For example, Listing category pages in Directory contain the “listingcategory” slug. To remove that just disable the “Listing Categories Base” option inside the Permalinks section.
Old URL: example.com/listingcategory/places
New URL: example.com/places

Change the logo

To change the logo go to Appearance ⇨ Customize ⇨ Site Logo ⇨ Upload image for logo. Default logo size is 279×42 pixels. You can use that same section to change the favicon as well.

If your uploaded logo is larger than the default one you’ll most likely have to tweak the CSS for that area. Insert this code to Appearance ⇨ Custom CSS Editor.

#branding {
padding-top: 45px;
padding-bottom: 36px;
}

Tweak the space above and below the logo by lowering or increasing those padding values.

Setup the navigation menus

Directory comes with three custom menu locations:

• Primary – displayed above the logo
• Secondary - displayed below the logo
• Footer - displayed at the very bottom of the site (next to the footer credits)

To create a menu go to Appearance ⇨ Menus. When done, just assign it to one of the three areas mentioned earlier. For detailed instructions on how to do this, watch the following video

How to create a mega menu?

Mega Menus are navigation menus with multiple columns under a single menu item. An example of such a menu can be seen by visiting the Directory demo site and hovering over the “Theme Features” menu item.

For details on creating a mega menu visit the mega menu tutorial.

Enable registration and setup register/login forms

To enable registrations inside WordPress navigate to Settings ⇨ General and choose “Anyone can register” under the “Membership” option.

Installing the theme created two important pages: Login and Register. You will find these pages in Pages ⇨ All Pages. From there you can change the page name and even the content. Do not remove the shortcode from each page as that’s what’s generating the login/register forms within the pages.

Change theme colors

Using the WordPress Customizer you can change the colors in real-time. To do that head over to Appearance ⇨ Customize ⇨ Color Settings. Edit an option and wait a few moments to see how it affects your site.

From the Customizer you can also change the background, just expand the “Background Settings” section. Once the background image is uploaded you’ll be able to tweak it’s position, repeat property and attachment.

Remove footer credits

The credits can be removed from Appearance ⇨ Customize ⇨ Footer. Instead of the code there by default, enter this instead

<p class="copyright">© 2014 Your Website Name</p>

Change the currency

If you’re not in the United States or a territory that uses USD as their currency, head over to Tevolution ⇨ Monetization ⇨ Currency (tab) to change it. Instead of $ enter your currency symbol and instead of USD enter the three-letter currency code.

For more details about Currency settings click here.

Directory comes with the ability to add multiple cities within the theme. Once added, these cities become content filters. In other words, if a listing is added to one city (e.g. New York), it won’t display in other cities (e.g. London). It’s worth noting that these filters affect everything, not just the homepage map. If you try searching for a New York listing within London, you simply won’t be able to find it. To create and manage cities go to Tevolution ⇨ Manage Locations.

 
Here are some things you need to know about the multi-city functionality

• Despite the fact location management is divided into three levels (countries, states and cities), only cities are interactive. In other words, you can’t “visit” a specific country or state, just cities within those countries and states.
• Cities are essentially listing filters. Simply put, listings from one city won’t show in the other one.
• Multi-city functionality increases page load times because all content must be constantly filtered by cities as well as other parameters.
• All multi-city features are powered by the Tevolution – Location Manager plugin. This plugin is optional. Don’t use the plugin if you don’t really need it. For example, if the area you’re covering with your directory is really small, there is no real need to filter content by cities since content from one city might be interesting to residents of a nearby city.
• Always be aware of the city you’re “in”. If the listing you just added isn’t displaying on the homepage (or category page), check your current city. It’s possible you added the listing inside a city different than the one you’re currently “visiting”.

Add a city

To add your own city navigate to Tevolution ⇨ Manage Locations ⇨ Cities (tab) ⇨ Add new city.

Country & State

Choose the country and state appropriate for the city you’re adding. In case the country or state isn’t available, you can add a new one from the Country and/or State tab.

Map Type

Set the type of your map. If you want to add some flair to your maps consider getting the Map Customizer add-on.

Map Scaling Factor

Choose how much of the map to show. 1 displays the whole globe while 19 shows a specific house. An appropriate level for a city is around 13.

City Name

This is the most important field inside the whole form. By entering a value you are setting both the name of the city and its location. As soon as you stop typing your city name the little map will zoom on it. Feel free to move the pin in order to better define the location of your city.

City latitude and longitude

These two fields are populated automatically as soon as you enter a value inside the “City Name” field. They will also be automatically updated if you move the pin around (inside the small map).

Homepage / Category page map display

These settings let you control the behavior of the map. If you want to show all available listings at all times be sure to select the “Fit all available listings” option. If you want to respect the zoom level set under “Map Scaling Factor”, choose that option.

Post Type & Categories

Choose the post types and categories that you plan on showcasing in this city. Selected post types and categories will appear inside the homepage map.

City Message

Write a city description that you can display when visitors are browsing that particular city. To actually show the description enter the following shortcode inside a regular “Text” widget.

[city_message]

Background Color and Background Image

Choose a color by clicking on the input field and using the color picker. Set a background image by clicking on Browse, uploading an image and then clicking on “Set as background image” in the bottom right corner. Ideal image size is 1920 pixels. The area affected by both the color and image is the area on the left and right side of the container. Example.

Note: The changes you make here will override those inside Appearance ⇨ Customizer. Also, if you set both a background color and a background image, the image will have priority.

Header Background Color and Image

Choose a color by clicking on the input field and using the color picker. Set a header background image by clicking on Browse, uploading an image and then clicking on “Set as header image” in the bottom right corner. Ideal image size is 1240 pixels. The area affected by both the color and image is the area usually populated with the logo and the search bar. Example.

Note: The changes you make here will override those inside Appearance ⇨ Customizer. Also, if you set both a header background color and a header background image, the image will have priority.

Add countries & states

You can add new countries and states from the “Countries” and “States” tabs inside the Tevolution ⇨ Manage Locations section. Most world countries are already added so you don’t really have to add them manually. However, if you do commit to that, make sure to add countries first since you’re required to select a country while adding a state.

Location Settings

The majority of these settings are available from Tevolution ⇨ Manage Locations. Here’s a list of options available in that area…

City selector style

This option defines the look of the city selector available inside your theme header (usually the top left corner). Here’s how they look in the front-end.

City selector levels

The option you choose here will affect both the city selector and the multi city field inside your submission forms. In other words, if you select the “Only Cities” option visitors won’t be required to input the country and state while submitting listings.

Is it possible to change the country > state > city hierarchy?
It’s not easy, but yes, it’s possible. For example, let’s imagine you want to change the hierarchy levels to city > neighborhood. Here’s how you do it:

1. Inside the “City selector levels” option select “One Country”.
2. Go to Manage Locations ⇨ States (tab) and add your city as a state. For example, create a new state called “Los Angeles”.
3. Go to Manage Locations ⇨ Cities (tab) and add your neighborhood as a city. Instead of entering the city name as “Los Angeles”, instead enter “Beverly Hills”. Adjust the pin on the map if necessary.
4. Open the en_US.po language file (click here for a tutorial).
5. Translate all necessary instances of the word “state” into “city”.
6. Translate all necessary instances of the word “city” into “neighborhood”.

If you did everything correctly you should now have a two-level hierarchy with cities and neighborhoods.

Location Tracking Method

Directory an IP tracker built-in that allows your theme to pinpoint the visitors location. The “Location Tracking Method” option allows you define the service that will be used for this. I recommend you change this only if you’re experiencing problems with the default (Freegeoip) option.

To enable the MaxMind option follow these steps

1. Download this zip file.
2. Extract the file using software like 7-Zip.
3. Connect to your server with FTP. Click here for a tutorial if you haven’t done it before.
4. Place the contents of the zip file inside the /wp-content/plugins/Tevolution-LocationManager/ folder on your server.
5. Enable the “MaxMind” option inside Tevolution ⇨ Manage Locations.

Homepage Displays

Choose what happens when visitors come to your site.

Default city – displays your default city. You can set the default city from the Cities tab.
Ask to show nearest city – upon arrival visitors will see a strip at the top asking them to share their location.
Nearest city – visitors will be taken to the city nearest to them without the ability to stop the process.

Activate location management for

The multi-city functionality will only be active for post types selected here. If you want blog posts to show inside all cities don’t check the “Post” box.

Note: New post types that you create and those enabled by add-ons (e.g. Events or Properties) won’t be automatically selected here. You will have to enable location management for them manually.

Track city visits (city logs)

Enable this if you want to see how visits are distributed across your cities. City log information is available from Tevolution ⇨ Manage Locations ⇨ City Logs (tab).

Map Shortcode

Use the below shortcode to display content (one or most post types) within a specific city. To create a page using this shortcode navigate to Pages ⇨ Add New and paste in the code.

[TCITY-DIRECTORYMAP cityid='1' post_type='listing' height='500'][/TCITY-DIRECTORYMAP]

cityid – the ID of the city you want to show. The city ID is displayed when hovering over a city inside Manage Locations ⇨ Cities (tab). Screenshot.
post_type – enter the post type you want to show (e.g. listing, event, property, etc). To display multiple post types separate them with a comma. For example, to display listings and properties, enter the value like this: ‘listing,property’.
height – enter the map height in pixels.

Bulk upload cities

To use this functionality you’ll first need to install the optional (and free) Bulk Import/Export plugin. Here are the installation steps…

1. Download the Bulk Import/Export extension.
2. Navigate to Plugins ⇨ Add New ⇨ Upload and load the downloaded zip file. Activate the plugin once the installation is complete.
3. To start using the plugin navigate to Tevolution ⇨ Bulk Import/Export.
4. To bulk upload city focus on the CSV City Import section

How to bulk upload cities?

Start by downloading the sample CSV file available at the bottom of the CSV City Import section. The content you add must match the structure inside that file. To actually edit the CSV you’ll need a text editor like Notepad++, or even better, Microsoft Excel. For general tips on editing CSV files open the Bulk Upload section of this guide.

Single city functionality

If you plan on using Directory as a classic directory where all listings display at the same time (there are no cities) you should look to use Directory in what we call the “single-city” mode. Follow these steps to get started:

1. Go to wp-admin ⇨ Plugins and deactivate the Tevolution – Location Manager plugin.
2. Go to Appearance ⇨ Widgets and place the T → Homepage Map – single city inside the Homepage Banner area.
3. Tweak the map location and settings by going to Tevolution ⇨ Settings ⇨ Map Settings (tab).

The biggest benefit of using a single city is the boost in performance. Without all those additional filters/queries your site will work noticeably faster. Another benefit are cleaner and shorter URLs. Without the Tevolution – Location Manager plugin, your URLs won’t have the /city/city_name slug within them.

Adding listings is probably something that both you and your visitors will be doing a lot. However, before you start adding listings make sure to complete these tasks:

1. Create categories. Do that from wp-admin ⇨ Listings ⇨ Listing categories.
2. Create your cities. That’s assuming you’re not using the single-city mode. Defining cities before adding content is important because you need to assign a city while creating the listing.
3. Create/edit custom fields. If you plan on adding unique custom fields to your site, do that before adding the listings. Custom fields can be tweaked from Tevolution ⇨ Custom Fields

Add listings from the back-end

To add a listing go to wp-admin ⇨ Listings ⇨ Add Listing. Inside the “Add New Listing” screen that opens you should enter the title, description and populate the fields located below the main content area. You can control which fields show inside this area from Tevolution ⇨ Custom Fields. For more details on that section click here.

Below the custom fields you should see available price packages. To create and manage your price packages navigate to Tevolution ⇨ Monetization.

Added a listing, but it’s not showing on the site (the front-end)?

There can be several reasons for this but these are the most common

• The city you’re “visiting” in the front-end doesn’t match the city in which you submitted the listing. Use the city selector (top right corner) to change the city.
• By default the Homepage Display Posts widget is configured to only show featured listings. Configure the widget (from Appearance ⇨ Widgets) and make it display what you want.

Add listings from the front-end

Front-end submission is done using the “Submit Listing” form. A page containing this form should have been created when you activated the theme, you’ll find it from wp-admin ⇨ Pages. The URL of that page will be something like www.your-domain.com/submit-listing. In case you deleted this page (or it was never created), go to Pages -> Add New and insert the following shortcode:

[submit_form post_type='listing']

Now that the page is created both you (the admin) and your visitors can use it to submit content. Similar to the back-end submit section, most of the input fields available inside the form can be modified from the Tevolution ⇨ Custom Fields section. You can also use that section to add new fields. To modify the “Select a package” section of the submission form, navigate to Tevolution ⇨ Monetization section. Click here for details on how to create price packages.

How and where to moderate user submitted listings?

Once users submit listings they will show up inside the wp-admin ⇨ Listings section. From there you can draft, publish or edit them. Another place from where you can manage them is Tevolution ⇨ Transactions. Use that section to bulk confirm or bulk reject transactions/listings. For more information about Transactions click here.

To set the default status for submitted listings (publish/draft) navigate to Tevolution ⇨ Settings ⇨ Submission page settings ⇨ Default status for free/paid submissions

Homepage

The homepage in Directory is a regular WordPress page created with the Front Page Template. The page template is designed to load widgets entered in Appearance ⇨ Widgets. This page is usually created during theme installation. However, if it’s not, i.e., if your homepage is not showing widgets follow these steps to fix it:

1. Go to Pages ⇨ Add New. Enter the page title as “Home” (for consistency sake, this isn’t really important) and on the right side, under Page Attributes ⇨ Template choose the “Front Page Template”. Publish the page.
2. Navigate to Settings ⇨ Reading and under “Front page displays” choose “A static page”. In the “Front page” dropdown choose “Home”.
3. Go to Appearance ⇨ Widgets to populate areas such as “Homepage Banner”, “Homepage Sidebar” and “Homepage – Main Content” with widgets.

1 – City selector

This is the location from where visitors can change their active city. You can change settings for the city selector from Tevolution ⇨ Manage Locations. Control the appearance and behavior of the city selector by tweaking “City selector style” and “City selector levels” inside the Manage Locations area. Click here to read more about this section.

Quick note: If you cannot see that city selector at the top it likely means that you haven’t activated (or installed) the Location Manager plugin.

2 – Primary navigation menu area

By default this menu area doesn’t show inside the theme. To make it show head over to Appearance ⇨ Menus. Create a menu and assign it to the “Primary” location (under Menu Settings). For more details on how the menus actually work, check out this video.

Quick note: Login and Register buttons are added automatically to this menu. Also, the Register button will show only if the “Membership” option is turned on in Settings ⇨ General.

How to change the login and register popups into normal links?
To do that first install the Code Snippets plugin. Then add the following code inside a new snippet: http://snippi.com/s/majrcl0 (click on the link to view the code)

How to remove the login, register and logout links?
Install the Code Snippets plugin and then add the following code inside a new snippet

add_filter('tmpl_logreg_links','tmpl_logreg_links_return');

function tmpl_logreg_links_return(){
 return array('');
}

3 – Site logo

To change the logo go to Appearance ⇨ Customize ⇨ Site Logo ⇨ Upload image for logo. Default logo size is 279×42 pixels. You can use that same section to change the favicon as well.

If your uploaded logo is larger than the default one you’ll most likely have to tweak the CSS for that area. Insert this code to Appearance ⇨ Custom CSS Editor.

#branding {
padding-top: 45px;
padding-bottom: 36px;
}

Tweak the space above and below the logo by lowering or increasing those padding values.

4 – Header search

To re-create this area go to Appearance ⇨ Widgets and place the “T – Instant Search” widget to the “Header” area. The widget comes with a lot of settings, tweak them to your liking.

5 – Secondary navigation menu area

To setup the main menu navigate to Appearance ⇨ Menus. When done creating the menu assign it to the “Secondary” location. For detailed instructions on using menus watch this video

How to create a menu with multi-column items (mega menu)?
To create an extensive navigation menu visit our mega menu article. To get a better idea how this menu looks open the Directory 2 live demo and hover over the “Theme Features” menu item.

Want to style your navigation bar with icons?
If yes, just use Front Awesome icons. To apply an icon expand the menu item you want to edit and insert the icon code inside the “Navigation Label” field (next to your item name). For example:

<i class="fa fa-home"></i> Home

<i class="fa fa-spoon"></i> Restaurants

If you did everything correctly, your menu should look something like this

 
How to add login, register and logout buttons to the secondary menu?
Install the Code Snippets plugin and then add the following code inside a new snippet

add_filter('tmpl_logreg_links','tmpl_logreg_links_return');

function tmpl_logreg_links_return(){
 return array('primary','secondary');
}

6 – Homepage map

The homepage map can be enabled/displayed by going to Appearance ⇨ Widgets and placing the “Homepage map – multi city” or “Homepage map – single city” widget inside the “Homepage Banner” widget area. The theme will display only one of these widgets at the same time. The “multi city” variant will display when Location Manager plugin is enabled and “single city” variant will display when it’s inactive. For more details on single city functionality click here.

If you loaded the dummy data your homepage map should already be showing. In that case head over to Tevolution ⇨ Manage Locations to edit the map. The map you see on the homepage is directly connected to the city it’s supposed to show. In other words, to edit the map, edit the city. You can edit your city from the “Cities” tab inside the Manage Locations area. Screenshot.

When editing a city use the small map displayed under the “City Name” field to set the position of the map. You can alter the position after entering the address by dragging the pinpoint icon within the map. Control how much (or how little) of your city is shown by adjusting the “Map scaling factor”.

Why aren’t my listings showing up inside the homepage map?
Here are the most common reasons (and solutions) to this problem:

1. You haven’t selected any categories to show for that city (fix it by editing the city inside Tevolution ⇨ Manage Locations ⇨ Cities).
2. The listing you submitted (are looking for) doesn’t have a city assigned to it. Edit the listing and assign the city. I’m assuming here you’re not running Directory in single-city mode.
3. You’re looking inside the wrong city, i.e. not the city you assigned the listing to. Change the active city from the city selector in the top left corner.
4. You already have over 400 listings on the map. To reduce load times Directory will display only 400 listings on the map. To display all available listings open the \plugins\Tevolution-LocationManager\functions\google_map_widget.php file and locate this code around line 239.

   'posts_per_page' => 400,

   Replace it with

   'posts_per_page' => -1,

5. The wrong widget is entered inside the “Homepage Banner” area. The widget you should use is T – Homepage Map (either multi-city or single-city). Map widgets such as T – Category Page Map, T – Detail Page Map or T – Google Map Location should not be used for this purpose.
6. If you’re using Directory in single-city mode make sure the coordinates are entered correctly inside Tevolution ⇨ Settings ⇨ Map Settings (tab).
7. The address field contains an empty space at the end. This can happen when pasting address from another source. To resolve the problem edit the listings address and remove the extra space.

Want to display a slider instead of the map?
To achieve this just go to Appearance ⇨ Widgets and place the “T – Homepage Banner” widget into the “Homepage Banner” widget area. To display static images inside the slider check the “Use custom images” box inside the widget and enter image URLs. Images can be uploaded from Media ⇨ Add New. Don’t forget to copy the “File URL” value after uploading an image.

Note: If you don’t want your slider displaying across the full width of the site go to Tevolution ⇨ Settings ⇨ Map Settings and disable the “Show map in full width” option

7 – Map categories

Just like the actual map, map categories are also assigned while creating/editing the city. Head over to Tevolution ⇨ Manage Locations ⇨ Cities and edit a city (or create a new one). To make sure your categories are displayed make sure to make a selection inside the “Post Type” and “Categories” field.

8 – Category list

To setup this area navigate to Appearance ⇨ Widgets and place the “T – All Categories List” widget inside the “Homepage – Main Content” area.

9 – Homepage sidebar

Edit this section by going to Appearance ⇨ Widgets and placing widgets inside the “Homepage Sidebar” widget area. Widgets used in the image above are:

• T – Popular Posts (sort by comments)
• T – Recent Reviews
• Text (with an embedded YouTube video)
• T – Popular Posts (sort by views)

10 and 11 – Homepage main content area

This area is primarily used for displaying recent or featured listings. To setup the area go to Appearance ⇨ Widgets and place the “T – Homepage Display Posts” widget inside the “Homepage – Main Content” area. The widget comes with several options built-in, including the ability to change the overall appearance of the listings (list or grid).

Quick tip: To select multiple categories inside the Categories field press and hold the CTRL (CMD) key and click on each category. To select all categories click on the first one, hold the shift key and then click on the last one.

12 – The footer

Edit this section by going to Appearance ⇨ Widgets and placing widgets inside the “Footer” widget area. Widgets used in the image above are:

• Text
• T – Social Media
• T – Newsletter

How to insert icons inside the Social Media widget?
Icons are are generated by Font Awesome. You should insert the icon (and text) inside the “Social Text” field. Example:

<i class="fa fa-facebook"></i>Find us on Facebook

13 – The credits

The credits can be removed from Appearance ⇨ Customize ⇨ Footer. Instead of the code there by default, enter this instead

<p class="copyright">© 2014 Your Website Name</p>

14 – Footer menu

To setup this menu navigate to Appearance ⇨ Menus. When done creating the menu assign it to the “Footer” location.

Category page

Category pages (as the one screenshoted below) are generated automatically as soon as you create a category from Listings ⇨ Listing Categories. To tweak category page options navigate to Tevolution ⇨ Settings ⇨ Category page. For more details on how to edit each of the category page components check out this image…
 

1 – Category page map

To display the category page map in this way navigate to Appearance ⇨ Widgets and place the “T – Category Page Map” widget inside the “Listing Category Pages – Below Header” area. In case your map isn’t showing even after inserting the widget please go to Tevolution ⇨ Settings ⇨ Category Page. Disable the “Map view” option.

The category page map is very versatile, it can be displayed in three ways:

• As a big map below the header (as displayed inside the screenshot above)
• As a tab (next to List and Grid buttons) – to enable this just turn on the “Map view” option mentioned above.
• As a sidebar widget – to set this up go to Appearance ⇨ Widgets and place the “T – Category Page Map” widget inside the “Listing Category Page Sidebar” area.

2 – Breadcrumbs

Displays a path to your current category. Breadcrumbs can be disabled from Appearance ⇨ Theme Settings.

3 – Category description

This text can be entered while creating (or editing) a category from Listings ⇨ Listing Categories. Screenshot.

4 – Sub-categories

If the category being displayed contains any sub-categories, they will show here.

5 – View switchers

Using these buttons you can quickly change the layout of the page from grid to list. You can enable a third option (Map View) by going to Tevolution ⇨ Settings ⇨ Category Page ⇨ Map View. To set the default view for category pages go to Tevolution ⇨ Settings ⇨ Category Page ⇨ Default page view.

6 – Sorting options

Using this sorting options dropdown visitors can easily change the sorting method used to display listings. To select which options display here go to Tevolution ⇨ Settings ⇨ Category Page and check the boxes under “Sorting options”.

7 – Category page sidebar

You can edit this area of the theme by going to Appearance ⇨ Widgets and placing widgets inside the “Listing Category Page Sidebar”. Widgets displayed in the image above are…

• Text (with an image displayed using HTML)
• T – Search by Miles Range
• T – Browse by Categories/Tags

8 – The actual listings

This area displays the listings within your category.

How to set a featured image?
When adding a listing from the back-end use the “Featured Image” box located inside the right sidebar. You can also do it by simply uploading an image to the listing image gallery.

9 – Add to favorites button

Visitors can mark listings as favorites in order to locate them more easily in the future. Favorite listings are displayed inside author pages, under the “My Favorites” tab.

10 – Pinpoint button

Clicking on the pinpoint button will focus the category page map on that particular listing. You can tweak settings for this feature in Tevolution ⇨ Settings ⇨ Category Page.

Listing detail page

The listing detail page is what you get after opening an individual listing (created from Listing ⇨ Add Listing). For more information about elements on that page check out the image below.

1 – Breadcrumbs

Displays a path to your listing. Breadcrumbs can be disabled from Appearance ⇨ Theme Settings.

2 – Comment/Review information

In this section visitors can see how many people reviewed the listing and also the overall start rating. If reviews are an important part of your website consider getting the Multi Rating add-on.

3 – Listing header fields

Each of these three fields can be controlled from Tevolution ⇨ Custom Fields. For example, to hide the “Email” field, click to edit the field (in the Custom Fields section) and then under “Show the field in” uncheck the “Detail page” option.

The code that displays this area is located in /wp-content/plugins/Tevolution-Directory/templates/single-listing.php around line 80. Edit the contents of this DIV

<div class="entry-header-custom-right">

Please do not make changes directly inside the theme. Use Code Snippets or your own custom plugin to customize Directory. For customization details open the Directory customization article.

4 – Website link

Points to the URL the author provided inside the “Website” field. This field can be modified from Tevolution ⇨ Custom Fields.

5 – Claim Ownership

This feature visitors to claim listings on your site as their own. This is particularly useful in the early days of the site since you (the admin) will most likely add a lot of content yourself in order to make the directory appear bigger. For setting up this feature please open the Tevolution guide.

6 – Send to Friend form

Allows the visitor to send a quick email (containing a link to the listing) to a friend. This form can be disabled from Tevolution ⇨ Settings ⇨ Email Settings & Notifications (tab) ⇨ Detail Page forms.

To enable captcha for this form navigate to Tevolution ⇨ Settings ⇨ Captcha.

7 – Send Inquiry form

Allows visitors to get in touch with the listing author, i.e. the person who submitted the listing to the site. This form can be disabled from Tevolution ⇨ Settings ⇨ Email Settings & Notifications (tab) ⇨ Detail Page forms. To enable captcha for this form navigate to Tevolution ⇨ Settings ⇨ Captcha.

How can a get a copy of inquiry emails sent to authors?
You can do that by customizing the tevolution_send_inquiry_form() function located inside /wp-content/plugins/Tevolution/tmplconnector/monetize/templatic-generalization/general_functions.php. Or… you can go to Plugins ⇨ Add New ⇨ Upload and install this simple plugin. It contains the customized function.
http://templatic.com/docs/wp-content/uploads/2014/10/directory-inquiry-tweak.zip

The plugin will send copies to the email address defined in wp-admin ⇨ Settings ⇨ General.

8 – Add to favorites button

The favorites button allows website visitors to save specific listings for later viewing. Once saved (favorited), the listing will become available inside the visitors front-end profile, under the “My Favorites” tab. Screenshot.

9 – Social buttons

These buttons are created based on the values entered inside the Facebook, Twitter and Google + field. You can edit these fields from Tevolution ⇨ Custom Fields.

10 – Detail page sidebar

To edit this area go to Appearance ⇨ Widgets and place widgets inside the “Listing Detail Page Sidebar” area. The widgets used inside the image above are:

• Text (simple image displayed with HTML)
• T – In The Neighborhood
• T – Browse by Categories/Tags

11 – Tabs

These tabs are displayed automatically as long as a value is provided for the field. For instance, if the “Video” field stays empty, the tab won’t show.

If you want to tinker with the code for this area do it in \wp-content\plugins\Tevolution-Directory\templates\directory-listing-single-content.php around line 50. Please note that this path is specific to the Directory parent theme. It won’t work if you’re using a child theme or you’re trying to edit an Event or Property.

12 – Gallery images

When adding listings from the back-end these images can be set by using the “Image Gallery” section inside the right sidebar. The first image inside the gallery will display as the main image inside the post. Please note that these images must be uploaded for that specific post (don’t try loading images from the gallery).

13 – Actual listing content/description

This is the text added inside the “Listing Description” field in the front-end, or the main content box inside the back-end. The area can display HTML and Shortcodes.

14 – Share buttons

You can enable or disable specific sharing buttons from Tevolution ⇨ Settings ⇨ Detail Page ⇨ Show sharing buttons.

15 – View counters

These display how many times the listing was visited today and also since submission. You can enable or disable view counters from Tevolution ⇨ Settings ⇨ Detail Page ⇨ View counters.

16 – The listings category

This area displays the categories in which the listing is submitted. If you want to remove it, just add this to Appearance ⇨ Custom CSS Editor

.bottom_line {
display: none !important;
}

17 – Previous/Next buttons

These buttons allow visitors to quickly navigate to the next listing within the same category as the one being displayed. If you don’t need these, hide them by adding the following code to Appearance ⇨ Custom CSS Editor.

.pos_navigation {
display: none !important;
}

18 – Comments/Reviews

Comments can be moderated from wp-admin ⇨ Comments. You can also see reviews after opening the listing in the back-end. Certain comment settings are also available from the Appearance ⇨ Theme Settings ⇨ Comments Settings (tab) section.

19 – Submit a comment/review

If you want to disable comments for a specific listing the best way is to Quick Edit it (from wp-admin ⇨ Listings) and untick “Allow Comments” in the quick edit window.

To disable ratings and use regular comments go to Tevolution ⇨ Settings ⇨ Detail Page ⇨ Ratings. If you want to make it so that a rating must be provided while submitting a comment, turn on the “Force Ratings” option.

20 – Related listings

This section shows listings from the same category (or tag) as the one currently displayed. For editing related listing settings navigate to Tevolution ⇨ Settings ⇨ Detail page. There are several options available that control the Related Listings section.

Setting up the Blog

The Blog in Directory is essentially just a category holding individual posts. So… follow these steps to create a Blog

1. Create a new category in Posts ⇨ Categories and name it Blog.
2. Add posts to that category by going to Posts ⇨ Add New.
3. By adding the posts our Blog page was automatically created. You can see it by going to Posts ⇨ Categories and clicking on the “View” link

Quick tips

1. To increase the number of entries available per-page on category pages (default is 5), go to wp-admin ⇨ Settings ⇨ Reading and change the value associated with the “Blog pages show at most” option.
2. I also recommend adding this Blog category to your navigation menu. Do that by going to Appearance ⇨ Menus and creating a new menu. Expand the categories dropdown, choose “Blog” and hit “Add to menu”. For details on creating custom menus watch our video tutorial.

Author page (user dashboard)

This is the page that opens when you visit a user profile within the theme. Each users profile page can be accessed from a URL like this one: your-domain.com/author/the_username. Another way to access it is by clicking on your username inside the top navigation bar. You can see an example of an author page on our Directory demo site. To change the author slug inside that URL visit the Tevolution ⇨ Settings ⇨ Custom Permalinks section and change/remove the Author Base.

From the dashboard page all website users can manage their submitted listings, favorites and of course their own profile. The best part of the dashboard page is that you can control exactly which info appears there. Go to Tevolution ⇨ Custom Fields ⇨ User profile fields to edit existing profile fields or add new ones.

 
Note: When creating a new profile field make sure to check-mark “User dashboard page” within the “Show the field in” option. If you don’t, the value won’t show inside the user dashboard page.

What do the edit, renew, upgrade and delete buttons mean?

This screenshot showcases which buttons I’m talking about.

Edit: This button displays while the listing is still active (package duration/alive days haven’t passed). The form that opens will be very similar to the actual submission form. The most important thing missing are the price packages. If you have WYSIWYG Submission installed, the edit process will also be in WYSIWYG format.

Renew: This button shows once the listing expires, it allows visitors to edit/update their listing and then pay for it to be submitted on the site again. Price packages do display inside the renew form.

Upgrade: Almost identical to the Edit form, however it allows visitors to select a different price package.

Delete: Deletes the listing. Listings deleted from the front-end user dashboard will also be deleted (forever) from the back-end.

How to edit my profile?

Each user can edit their profile from this URL: your-domain.com/profile. A link to this page is also provided underneath the avatar inside the author/dashboard page. To modify the profile page, go to Pages ⇨ Add New and edit the “Profile” page. The profile page is a regular WordPress page with a shortcode that generates the profile fields. This allows you to easily add new content inside the page (above or below the profile fields) or to change its title or slug.

If you accidentally deleted the profile page, re-create it by following these steps:

1. Go to Pages ⇨ Add New and create a new page. Enter whichever title you want.
2. Insert the following shortcode as the content for that page

   [tevolution_profile]

3. Go to Tevolution ⇨ Settings ⇨ Registration Page and choose the page you just created within the dropdown for the “Profile Page” option.

How to edit profiles from other users?

As the admin, you can edit profiles from all members by going to the wp-admin ⇨ Users section.

How to create “People” page as seen on the demo?

This is the page in question. It has been automatically created when you installed the theme. You’ll find it inside the wp-admin ⇨ Pages section.

If you accidentally deleted the people page, re-create it by following these steps:

1. Go to Pages ⇨ Add New and create a new page. Enter whichever title you want.
2. Insert the following shortcode as the content for that page

   [tevolution_author_list role='subscriber' users_per_page='8'][/tevolution_author_list]

Along with custom post types and price packages, custom fields are one of the pillars of Tevolution. Custom fields are used to associate custom information with a listing. This listing can be a regular WordPress post, page or a custom post type that you created. These fields are the most important part of a submission form, without them visitors couldn’t submit anything on your site. In short, when you open a page such as this one, most of the content you see is manipulated by custom fields.

To start tweaking your custom fields navigate to Tevolution ⇨ Custom Fields.

Adding and managing custom fields

Add a new custom field

You can add a new field by navigating to Tevolution ⇨ Custom Fields Setup ⇨ Add a custom field. Listed below are all the options/field appearing inside the “Add a custom field” form.

Enable for
Choose the post types with which you want to use the new field. This allows you to have totally unique sets of custom fields for each post type.

Select the categories
Similar how a field can be specific to a certain post type, it can also be specific to a category within a post type. Category-specific custom fields are turned off by default, however you can easily activate them by navigating to Tevolution ⇨ Settings ⇨ Submission page and enabling the “Show custom fields categorywise” option.

If you have category-specific custom fields turned off I recommend selecting all available categories when creating a custom field. This will make them show inside the submission form even if you enable the option somewhere down the line.

Heading
By selecting the heading you are essentially deciding how the field will be grouped. Most Templatic themes come with at least two grouping areas: taxonomy_name and Contact Information. Simply choose the group that you find more appropriate for your field.

New groups can be created by adding a custom field and choosing the “Heading” field type.

Label of Field option will transform the label of your field into a heading. This is useful for big input types like Text Editor.

Type
By setting the type you decide what kind of input will visitors see. Will it be a simple text field or a multi checkbox with lots of options? You decide by choosing a field type. Most field types are self-explanatory so I’ll just explain those that aren’t.

Geo Map – used to generate a location using a map. If you’re using a Templatic theme, chances are you already have this field inside your submission form. Please note that you cannot have two Geo Map fields inside the same form. This field type is provided in case you need map-related features inside your custom post type.

Heading – creates a new group for your custom fields. More info about the heading type is available in this paragraph.

oEmbed Video – allows visitors to add a video by simply pasting links from YouTube, Vimeo and other sites. For a list of supported sites click here.

Post categories – gives the ability to choose a category inside the front-end submission form. Templatic themes come with this field built-in; you don’t need to add it manually. Use this only with your custom post types.

Range Type – a simple text field with the ability to work with a pre-defined range of values. It’s also the only field type designed to work as a Range Slider inside the search form. The range for the “Range Type” field is set inside the “Show on search as” option within the “Display Options” section. Choose the “Range Slider” option and then set the min/max values. For example, let’s imagine you are creating a field called “Your height (in centimeters)”. Let’s set 50 as the minimum value and 250 as the maximum. All those filling out the submission form will have to choose a number within this range.

 
Select/Radio/Multi Checkbox – these are fields used for selecting pre-defined options. Select and Multi Checkbox allow visitors to select multiple options, while the Radio buttons allows only one to be selected. All three of these field types work as associative arrays. They allow you to set a key and a value for that key. Of course, both the key and the value can be identical.

 
Label
The name of your field. If you selected “Label of Field” as the heading, this name is what will be used as the heading.

Unique Variable Name
Also sometimes referred to as the “HTML variable”, this is a unique key that defines the field inside the database. Functions such as get_post_meta() use the Unique Variable Name to display information. It’s important that you don’t use any spaces, numbers, special characters or capital letters when defining the variable name. Stick to small letters and underscores ( _ ).

Description
The text displayed below the input area. Use it to provide more details about the field and (if necessary) how to use the field.

Default value
You can use this as an example of how should a value be entered. The default value will disappear as soon as visitors start typing their own information.

Active
Make sure this option is checked. The field won’t work otherwise.

Want to add validation?
Enable this option if you want to force visitors to provide a value to this custom field. Once you enable this two more options will appear.

Validation type
Choose the type of validation you want to force upon the field. Keep in mind that not all field types work with all validation types. For instance, the Text Editor field only works with “Require”.

Required field warning message
This is the message that will display to visitors if they forget to fill out the field.

Position (display order)
Controls the position of your custom field within the group it’s in. Another way to tweak the position is from the Tevolution ⇨ Custom Fields Setup screen. You can change the display order by simply dragging and dropping custom fields in the desired spot.

Display location
Choose whether to show the field inside the back-end, front-end or both.

Show the field in
This section let’s you control where will the field (or in most cases, its value) be displayed. If you’re creating a field where the values are private (for your eyes only) make sure to deselect all options accept “Submission form” and “Back-end”. Selecting options such as “Advanced search form” will reveal additional options to enter. You’ll be able to select how is the field presented inside the advanced search form.

CSS Class
In this option you can enter a CSS class that will apply to the label of the custom field that you’re creating. This allows you to make the field stand out from the rest. The place where you can define/write the class is custom.css. For instance, to change the color of the label and to increase the font size we would add something like this

.mycustomclass {
color: red;
font-size: 20px;
}

Once the class is created enter the class name ( mycustomclass ) inside the CSS class field.

In the above example, the end result would look like this

Extra Parameter
Unlike the CSS class option that controls the label, this option controls the input field itself. We control the field by defining attributes for the HTML input tag.

For instance, to define a placeholder for the field we would input something like this

placeholder="my placeholder text"

In that case the end result would be…

Managing custom fields

To manage custom fields navigate to the Tevolution ⇨ Custom Fields Setup section. Here are some tasks you can complete from that section

Order fields
Field position can be changed either by setting the sort order number while creating the field or by dragging and dropping the field inside the Custom Fields section. After the field has been created the sorting order can only be changed from the Custom Fields section.

Please note: A custom field position greatly depends on the position of its heading (group). In other words, the changes you make by dragging and dropping fields inside Tevolution ⇨ Custom Fields are affecting the field within its group, not the submission page as a whole. Let’s assume the “Contact Information” heading is displayed at the bottom of the submission page. Within that heading group there is a “Facebook” field. Setting the sorting order of that field to 1 won’t display it at the top of the submission page, it will just display it at the top of the “Contact Information” group.

Quickly change the heading type
You can change the heading type of a specific field by clicking on the dropdown under the “Heading Type” column. Screenshot.

Change which fields are displaying
By clicking on tabs at the top of the page you select to display only fields for a specific post type, or only search-related custom fields.

Reset custom fields
Click on the “Reset Custom Fields” button at the bottom right corner of the page to discard all your changes and start over.

Choose how many fields display per-page
Click on the “Screen Options” button at the top right corner of the page and set the number of fields to show per-page.

User Profile Fields

Profile fields are essentially custom fields for the register form. You can manage them from Tevolution ⇨ Custom Fields ⇨ User Profile Fields. To add a new field just click on the “Add a new field” button at the top. The fields inside the form are fairly self-explanatory. They are also similar to “regular” custom fields. You can read more about those here.

Here’s an example of a profile field

 
The default location of your register form is http://your-domain.com/register. That’s where your newly added user profile fields will appear (assuming you set them to display inside the register form).

Custom Post Types

Post types in WordPress are essentially a new way to organize your content. Instead of relying on just posts and pages, you can create new types such as “Places”, “Reviews” or “Testimonials”. Each of these post types will then come with matching taxonomies (categories and tags). If you’re interested in learning more about custom post types be sure to read this codex article.

Directory comes with one post type per-installed, “Listing”. You can add additional post types such as Property, Event or Classified by installing premium add-ons. I recommend you don’t create new post types unless there is a clear need for them. If you can organize your content using categories, do that – it’s much easier.

Create a new post type

To start creating a new post type navigate to Tevolution ⇨ Custom Post Types ⇨ Add Custom Post Type. Fields inside this section are fairly self-explanatory so I won’t be going into any details. However, keep this in mind:

• Each slug you enter must be unique!
• Slugs shouldn’t contain any numbers, capital letters, spaces or symbols. Use only small letters.
• Enable the “Category-specific map markers” option if you plan on displaying content from your new post type on a map.

Setting up a new post type

After creating the post type you’ll need to create some other things as well in order to make it useful. Most important of which are…

Categories
You can add categories by expanding your post type and selecting the categories option. New post types are always grouped between the Comments and Appearance sections inside the wp-admin sidebar area.

 
Custom fields
Creating new custom fields will allow you to define what kind of information you and your visitors submit for the new post type. By default you can only enter a post title, description, images and excerpt. By creating new fields you can create input fields with radio buttons, file uploaders, checkboxes, etc.

Custom fields can be created from Tevolution ⇨ Custom Fields Setup. To learn more about custom fields click here.

Price packages
Price packages need to be defined if you plan on allowing visitors to submit content (for your new post type). They are displayed at the bottom of the submission form.

To learn more about price packages click here.

Submission form
Along with price packages, generating a submission form is also necessary in order to allow visitors to submit content. This submission form will contain all the custom fields and price packages you created for the new post type. Follow these steps to generate a submission page:

1. Navigate to wp-admin ⇨ Pages ⇨ Add New.
2. Set the page title to whatever you want.
3. Paste the following code to the main (description) box

   [submit_form post_type='POST_TYPE_SLUG']

4. Publish the page.

POST_TYPE_SLUG is the slug you set while creating the new post type. Example…

[submit_form post_type='listing']
[submit_form post_type='event']

Customizing the new post type

If you’re skilled with HTML, CSS and PHP you can customize the appearance of category and detail pages of your new post type. To do that follow these steps:

1. Connect to your server and navigate to /plugins/Tevolution/templates.
2. Create a copy of single-tevolution.php (detail page) or taxonomy-tevolution.php (category page), depending on which page you want to customize.
3. Paste the copied file to your theme root folder.
4. Rename the file by changing the tevolution part to match your post type and taxonomy slug. For example: single-event.php / taxonomy-ecategory.php
5. Open your new file (inside the theme root folder) and make the changes you want. Tevolution will display your changes as soon as you save & upload the file; no additional tweaking is necessary.

Price Packages are the primary method of making money inside Directory. Once created, these packages appear inside submission forms. Visitors must select a price package before they can proceed with submitting a post. If you don’t plan on allowing front-end submissions, you also don’t have to worry about creating price packages.

Create a price package

To create a price package navigate to Tevolution ⇨ Monetization ⇨ Price Packages (tab) ⇨ Add New Package. Most of the fields inside this form are self-explanatory so I’ll focus on explaining those that deserve extra attention.

Package Type

The first option you make while creating a price package is also the most important one. You can choose between two types: Single submission and Subscription.

Single submission
Price packages created with this type allow authors to submit just one listing. In other words, 1 payment = 1 submission.

Subscription
These packages will allow authors to submit multiple listings for a single payment. You can define exactly how many listings can be submitted and in which time frame.

Number of posts (sub)

This option allows you to define the number of submissions available inside the package. It’s one of many parameters you can use to differentiate price packages. Charge more for packages that allow visitors to submit more posts.

Select post type & Select categories

The price packages you create are both post type and category specific. If you want to create a universal price package (for all post types and categories) check the “Select All” button in both options.

Amount

This is essentially the price of your package, i.e. the amount people will have to pay in order to purchase the package. Avoid entering thousand separators inside the field, enter just the number value. Enter 0 to make the package free.

Package Duration

The value entered here controls the validity / alive days for all posts submitted with that particular package. If you set it to 30 days, all posts submitted using the package will be active for 30 days. After 30 days they will expire.

Allow users to submit listing within following days (sub)

The time restriction for your price package. Define how many days visitors have to submit their posts. Enter just the number in this field. Similar to the “Number of posts” field, this is another parameter for differentiating packages. Charge more for packages that give visitors more time to submit their posts.

Allow one submission before payment (sub)

Enabling this option will allow visitors to make a submission while purchasing the subscription price package, i.e. before they actually complete the payment. Otherwise, they won’t be able to submit anything until the payment is processed. This submission will be deducted from the overall “Number of posts”.

Number of free posts allowed (sub)

Use this option if you want to allow a preset number of free submission before paying for the subscription price package. The option is very similar to the “Allow one submission before payment” setting. However, these free posts aren’t deducted from the overall “Number of posts” once an actual payment is made.

Recurring package

By creating a recurring package you can automatically charge your members at the end of the billing period (that you define). Once they are charged their submitted listings are automatically renewed.

Billing Period for Recurring package
Choose how often should visitors be billed. This value should match the “Package Duration” field.

Number of cycles
Set the number of repetitions (recurrences) for the package. For example, if you set the billing period to 1 month and the number of cycles to 12, your visitors will be automatically billed for 1 year. For unlimited billing cycles just enter a big number here.

Free trial period
This option allows visitors to get the full package benefits during the first billing period. During checkout they will essentially purchase the subscription, but won’t be billed for it until the second billing period.

Featured options

Featured listings are differently-styled listings that appear first on homepage or category pages. Some widgets even allow you to display just featured listings. In other words, they provide more exposure which is why you can charge extra for this privilege.

To reveal additional featured options check the “Home Page” or “Category page” boxes.

Homepage/Category page featured price
Set the price listing authors will need to pay in order to make their listings featured. Check the “Package amount includes the homepage/category page feature price” box if you want to make the listings submitted with this package featured by default.

Featured status duration
Define how long the listings will be featured by entering a number (of days). If you don’t enter anything here listings will be featured for the full duration of the package (the time entered under “Package Duration”).

Currency Settings

From Tevolution ⇨ Monetization ⇨ Currency (tab) you can setup the plugin to use your own currency (default is USD). Be careful when entering the three letter ISO currency code since a badly defined currency code will prevent the payment gateways from working. For the full list of ISO currency codes open this link.

Popular currency symbols and codes

• British Pound: £ – GBP
• Euro: € – EUR
• Canadian Dollar: $ – CAD
• Indian Rupee: ₹ – INR
• Australian Dollar: $ – AUD
• Japanese Yen: ¥ – JPY

 
If you need to change the location of the symbol in relation to the value, tweak the “Currency Position” option. These are the options…

• Use currency symbol as prefix – $10
• Space between amount and prefixed symbol – $ 10
• Use currency symbol as suffix – 10$
• Space between amount and suffixed symbol – 10 $

Payment Gateways

From Tevolution ⇨ Monetization ⇨ Payment Gateways (tab) you can control the available payment methods on your site. By default Directory comes with two payment methods.

• PayPal – used for online payments. You will need to create a PayPal account before you can use it. To setup the payment method just enter your PayPal email, i.e. the email you used to sign up for PayPal.
• Pre Bank Transfer – used for offline payments. After submitting a listing, authors will see your bank account details along with the amount required to pay. Once you verify the payment (by checking your bank account) proceed by confirming their submission in Tevolution ⇨ Transactions. Don’t forget to add your own bank details by editing the Pre Bank Transfer payment method.

Transactions

From Tevolution ⇨ Transactions you can approve or deny all transactions that happen on your site, i.e. within your submission forms. You can also use this section to search for specific transactions and even export search results into CSV files.

By default, paid PayPal submissions will be automatically approved while free submissions and paid Pre Bank Transfer submissions will be automatically drafted. You can change these settings from Settings ⇨ Submission page.

Approving a transaction

1. Navigate to Tevolution ⇨ Transactions.
2. Checkmark the transactions you want to approve.
3. Click on the “Bulk Actions” dropdown and choose “Approve”.
4. Click on “Apply” to confirm the change.

To see transaction details click on the transaction ID

Alternate way to display Price Packages

The way price packages are displayed inside the submission page isn’t all-that pretty. There’s a lot of dynamic information to show so there isn’t a lot of room for experimentation. However, there is an elegant way to make price packages look pretty. After creating a price package, Directory provides you with a link to that price package inside the submission form. You can reveal it by clicking on “Short Link” while in Tevolution ⇨ Monetization ⇨ Price Packages (tab).

 
The Short Link you just copied will open the submission page with the price package auto-selected. This allows you to create a totally new page and describe your price packages there. The actual submission can then be initiated by clicking on a button that’s linked to a specific price package. Pricing tables are a good way to display this type of information. I created the below table in literally 5 minutes using the Easy Pricing Tables plugin. I’m hoping yours will be far less ugly than mine

Directory allows you to create advanced pages using a number of different shortcodes. These shortcodes can be inserted into other content types as well (posts, listings, etc), but are best used with regular WordPress pages.

Start by creating a new page from wp-admin ⇨ Pages ⇨ Add New. Most shortcodes can be inserted into pages by using the Templatic shortcodes button located inside the Visual editor.

Submit pages

Submit pages (e.g. “Submit Listing”) are used to submit content from the front-end. They combine all three areas explained earlier in the guide; Post types, Custom fields and Price packages. These pages are usually generated automatically by the theme or plugin you’re using alongside Tevolution. To manually create such a page simply paste the following shortcode.

[submit_form post_type='']

post_type – enter the slug post type you want to use. For example…

[submit_form post_type='listing']
[submit_form post_type='event']

Register, login and profile pages

Directory will try to generate these three pages as soon as you activate the plugin. However, in case you can’t see them inside wp-admin ⇨ Pages section, use the following shortcodes to generate them.

Login

[tevolution_login]

Edit Profile

[tevolution_profile]

Register

[tevolution_register]

Why is there no password field when registering?
This is because passwords are automatically generated and sent the users email (the one entered while registering). This passwordless register process is standard in WordPress. Unfortunately there is no easy way to add a password field to the register form.

What is the difference between the register form and the register link/popup?
The register link (the one located inside the theme header) opens the popup for those that want a quick and painless register process. The popup doesn’t contain custom register fields and always features just two fields; username and email.

Map pages

Even though most Templatic themes come with homepage and category page maps, sometimes that’s not enough to display all relevant content. Map shortcodes allow you to generate maps within regular pages.

Multi post type map / Full width map

This map can display listings from any of your post types. It will display all available listings regardless of the current city. To generate the map enter this shortcode:

[tevolution_listings_map post_type="" image="thumbnail" latitude="" longitude="" map_type="" zoom_level=""]

This map also has the ability to display over the whole page. Here’s an example. To activate the full width mode change the page template to “Full Width Map”.

Single post type map

Use this map if you want to focus on just a single post (e.g. listings). The map will display all available listings regardless of the current city. To generate the map enter this shortcode:

[map_page post_type="" image="thumbnail" latitude="" longitude="" map_type="ROADMAP" map_display="ROADMAP" zoom_level="13" height="500"]

Map shortcode options

post_type – define which post types should the map display (e.g. “event,listing”).
image – define which image size should the map use. Keep this set to “thumbnail” unless you know what you’re doing.
latitude and longitude – set the focus point for the map. You can generate those values on this site.
map_type – available values are: ROADMAP, TERRAINMAP, SATELLITEMAP and STREETMAP.
zoom_level – define how big of an area should the map display. The larger the number, the more zoomed in the map is. 12 or 13 is a good zoom level for focusing on a city.

People page

People page lists authors on your site and displays some basic information about them. Here’s an example of such a page.

You can generate this page by entering the following shortcode inside any WordPress page or post:

[tevolution_author_list role="" users_per_page=""]

role – define which users should be displayed on the page (authors, editors, subscribers, etc). You should mostly keep this set to “subscriber”.
users_per_page – define how many users to show on each page.

If you want to customize this page, you can do so by editing this file: wp-content/plugins/Tevolution/tmplconnector/shortcodes/shortcode_people.php

Advanced Search page

Advanced Search page allows visitors to easily search through the site. You can add new fields to this page by creating them in Tevolution ⇨ Custom Fields and assigning them to display inside the “Advanced search form”. Screenshot.

Follow these steps to create an advanced search page:

1. Install the Widgetize Pages Light plugin.
2. Create a new widget area (with the plugin)
3. Insert the Advanced Search widget inside that area and configure it
4. Create a new page by going to Pages ⇨ Add New. Insert the shortcode for that new widget inside your page.

Outside of features such as custom fields and price packages, the majority of settings in Directory are available within the three sections mentioned below: Tevolution ⇨ Settings, Appearance ⇨ Theme Settings and Appearance ⇨ Customize.

General Settings

Accessible from Tevolution ⇨ Settings ⇨ General Settings (tab), this settings area is where you can make most Directory changes. Most of the settings are pretty self-explanatory so I’ll focus on those that require additional explanations.

Submission Page

Submission pages are used to submit content from the front-end. For details on how to create such a page open this part of the guide. Submission page settings are available from Tevolution ⇨ Settings ⇨ Submission Page.

Category specific fields
By default each custom field you create will work with all categories created for a specific post type. If you enable this option, fields not selected to show for a specific category will disappear from the submission form as soon as that category is selected.

Category display
The choice you make here will determine the look of the categories field inside the submission form. Available choices are: Checkbox, Multi-select and Select. Checkbox and Multi-select allow visitors to select multiple categories while Select allows only one to be selected. Here’s a screenshot of how each of them looks like.

Default status for free/paid submissions
Decide what happens when someone submits a listing. Is it drafted or published? Drafted listings can be approved (i.e. published) from the Tevolution ⇨ Transactions section.

Category Page

The options you set here control your category and tag pages. For example: your-domain.com/listingcategory/places.

Default page view
Choose the default style for category page listings. Each visitor will be able to change their view at any time by using the view switches provided in category pages. Screenshot.

Map view
This option enables/disables the map tab in category pages. Keep the option turned off if you plan on using category page map widgets.

Note: To enable the big category page map (as displayed in our demo) go to Appearance ⇨ Widgets and place the “T – Category Page Map” widget inside the “Listing Category Pages – Below Header” area.

Pinpoint functionality
This feature allows visitors to bring up a listing on the category page map. They do it by clicking on the “Pinpoint” icon. This functionality only works when “Map view” is turned off.

Sorting options
These are the options appearing inside the sort dropdown in category pages. Certain Directory add-ons can enable additional sorting options. Screenshot.

Detail Page

Detail page is the specific/individual page for a post, listing, event or whichever custom post type you created.

Filter related posts by
Depending on which option you choose, related posts (displayed below the main content inside detail pages) will be shown either from the same category as currently viewed post or from the same tag as the currently viewed post.

Show Ratings
Ratings are essentially those little stars that display while entering comments (and in various pages throughout the theme). Assuming you’re using Directory, if you want more rating-related options check out our Multi Rating plugin.

Registration Page

In this section you can connect your previously created registration pages with the matching options. As mentioned earlier, these pages should be created automatically as soon as you install the plugin, chances are you don’t need to tinker with it.

From this section you have the ability to setup social login through Facebook, Google and Twitter. After clicking on each checkbox, the plugin will request your APP ID and Secret Key. Follow the steps below for instructions on creating a new app for each platform.

 
Creating a Facebook app

1. Login to your Facebook account or create a new one.
2. Open the Facebook Developers page. Allow developer access if you get prompted for that.
3. Inside the top left corner click on Apps ⇨ Add a new app.
4. In the popup that opens click on the “Advanced Setup” link displayed below the four main platforms.
5. Set the Display Name to whatever you want. Leave Namespace blank. Choose “No” for making it a test version of an app. Set category to “Communication”.
6. Hit “Create App” and fill in the captcha.
7. You should now see your app. Inside the left sidebar choose “Settings”.
8. Enter your email inside the “Contact Email” field.
9. Click on “+ Add Platform” and choose Website.
10. Enter your Site URL. You can leave the Mobile Site URL field blank.
11. Click on “Save Changes” in the bottom right corner.
12. Inside the left sidebar click on “Status & Review”.
13. Under “Do you want to make this app and all its live features available to the general public?” change NO to YES.
14. Inside the left sidebar click on “Dashboard” and then copy the App ID and the App Secret key.
15. Paste the App ID and Secret key inside the Registration settings on your site.

 
Creating a Google+ app

1. Login to your Google account or create a new one.
2. Open the Google Developers Console.
3. Click on “Create Project” at the top of the page. Enter the name and identifier (you can use the default values).
4. Inside the left sidebar click on APIs & auth ⇨ APIs.
5. Under the “Browse APIs” section search for “Google+” and then enable the “Google+ API” (set the Status to ON).
6. Inside the left sidebar click on APIs & auth ⇨ Credentials.
7. Click on “Create new Client ID” and then enter these values…
   Application Type: Web application
   Authorized javascript origins: leave empty
   Authorized redirect URI:

   http://YOUR_SITE.com/wp-content/plugins/Tevolution/tmplconnector/monetize/templatic-registration/hybridauth/?hauth.done=Google

Don’t forget to swap the YOUR_SITE part with your own domain.

8. While in APIs & auth ⇨ Credentials copy the “CLIENT ID” and “CLIENT SECRET” values available in the “Client ID for web application” section.
9. Paste the values inside the Settings ⇨ Registration settings on your site.

 
Creating a Twitter app

1. Login to your Twitter account or create a new one.
2. Open the Twitter dev page.
3. Click on “Create new app”
4. Inside the “Application Details” fill in the Name and Description you want for the app. Also enter the location (URL) of your site. Enter this as the Callback URL:

   http://YOUR_SITE.com/wp-content/plugins/Tevolution/tmplconnector/monetize/templatic-registration/hybridauth?hauth.done=Twitter

   Don’t forget to swap the YOUR_SITE part with your own domain.

5. Your app should now be showing. Click on the “Settings” tab and check the “Allow this application to be used to Sign in with Twitter” option.
6. Open the “Keys and Access Tokens” tab.
7. Copy your “Consumer” and “Consumer Secret” keys
8. Paste the values inside Settings ⇨ Registration settings on your site.

Claim Ownership

In this section you can enable claim ownership functionality for specific post types by check-marking them in the “Enable claim ownership for” option. Once enabled, a “Claim Ownership” button will appear inside the detail page of selected post types for all visitors of site except admin user/user who is not owner of that specific post. The claim ownership button can also be generated using a shortcode. The shortcode can be placed inside an actual listing, or inside a text widget.

[claim_ownership]

What is claim ownership?
Claim ownership is a feature that allows visitors to claim listings on your site as their own. This is particularly useful in the early days of the site since you (the admin) will most likely add a lot of content yourself in order to make the directory appear bigger. The Claim Ownership feature will make it easier for you to transfer that listing to the rightful owner when they requests control over it.

How to process a claim?
Submitted claims can be rejected or accepted from Tevolution ⇨ Submitted Claims. To perform an action use the three little icons located under the “Action” column. These allow you to view more information about the claim (including the actual claim text), verify the claim or deny the claim.

Once you click on the verify icon the plugin will automatically assign the listing to the user who submitted the claim. Clicking on “Verify” will also open the listing in question. To confirm that the author change was made check who is set as the Author of the listing. If you can’t see this information click on “Screen Options” in the top right corner and enable the Author field.

Note: If a guest submits a claim and that claim is then verified by you (the admin), Directory will automatically create a new account with the provided username and email address. After verification, Directory will also send a notification email(with username and password) to the claimant in order to notify them that the claim was accepted.

Map Settings

Show maps on mobile devices
Maps on mobile devices can often fill out the whole screen, confusing the visitor. Turn this option off in order to hide maps on phones.

Show map in full width
Decide whether to display the map across the full width of your screen or within the regular theme container (1200px). The option controls the actual widget areas in which maps show – not the maps themselves. Any widget placed inside “Homepage Banner” and “Listing Category Page – Below Header” areas will be stretched to full width.

Single city map settings
These options display only when Location Manager is deactivated. The information you define here will be applied to both your homepage and category page map.

For more details on how to use single-city mode click here.

Captcha

Captcha is something you should setup as soon as possible since spambots will start visiting your site and auto-submitting forms just days after you create it.

Follow these steps to get started:

1. Navigate to Tevolution ⇨ Settings ⇨ Captcha (tab).
2. Use this website to generate captcha keys. Enter those keys inside the “Site Key” and “Secret Key” fields.
3. Use the “Enable spam verification for” option to define in which forms captcha should be active.

Emails and notifications

From Tevolution ⇨ Settings ⇨ Email Settings & Notifications (tab) you can manage all emails sent out by the Directory theme. This includes registration emails to admin and user, submission notifications, password resets and more. You can edit each of these emails by clicking on the “Quick Edit” button inside the Email Templates section.

Outgoing Emails Method
Edit this setting only if you want to modify the layout of outgoing emails. Plugins that modify emails almost exclusively focus on the wp_mail() function. So… make sure you select that option if you want to modify emails via a plugin. An example of a plugin that does this is WP Better Emails. I should mention that this is really just an example, we haven’t tested Directory with this particular plugin.

Detail Page Forms

• Send to Friend: Website visitors will be able to use this form to send the page link to a friend.
• Send Inquiry: Website visitors can use this form to get in touch with the listing author. Keep in mind that if you (the admin) submitted most of the content, questions submitted using this form will go to you.

My emails aren’t being sent, what should I do?
In most cases your emails aren’t being sent because of the email address you entered inside the Settings ⇨ General section. Some hosts (most notably BlueHost) require you to use an email address associated with your hosting in order to work. So, if you have a website called my-awesome-site.com hosted on such a server, make sure the email you enter inside General Settings is something like email@my-awesome-site.com.

Another possible reason why emails don’t work is because certain email headers aren’t supported on your server. In the PHP mail() function the “From” address is an additional header (i.e. it’s not required to send the email). If your host doesn’t support them you’ll have to disable those headers. If you think this might be the reason why your emails aren’t working please contact your host for confirmation. If they confirm, contact our support and we’ll tweak the email function on your site.

Permalink Settings

To open this section navigate to Tevolution ⇨ Settings ⇨ Permalink Settings (tab). You can use this section to alter the structure of URLs for individual listings, category pages and other types of pages.

If your tweaks start causing 404 errors in the front-end click on the “Reset all rules” button to undo your changes.

Theme Settings

To see available theme settings please navigate to wp-admin ⇨ Appearance ⇨ Theme Settings.

Global layout

This option controls the overall look of pages on your site (include the homepage, category page and detail page). Available options are…

• One Column – just the main content area (no sidebars anywhere)
• Two Columns, Left – content on the left, sidebar on the right. This is the default layout
• Two Columns, Right – content on the right, sidebar on the left.

Right-to-Left (RTL) text orientation

Enable this only if you translated the theme into languages such as Arabic or Hebrew. Otherwise leave it disabled.

Sticky header

Enable this if you want to show your navigation menu even when scrolling down the page.

Quick tip: You can change the opacity of the sticky header by adding this code to Appearance ⇨ Custom CSS Editor.

body .sticky_main {
opacity: 0.8;
}

Set the opacity value between 0.1 and 1. Click here for more information.

Breadcrumbs

Breadcrumbs are essentially the path from the homepage to the page the visitor is on. If you don’t need them, just turn off this option. In Directory, the post type (e.g. Listing) is a valid part of the breadcrumb and can’t be removed without tweaking the code. Screenshot.

Google Analytics tracking code

Paste your Google Analytics code in this area. If for some reason it doesn’t work you should open the header.php file (from Appearance ⇨ Editor) and paste it in between the < head > tags.

Mobile app view

By enabling this option you can alter the look of your site on mobile phones. When turned off the “regular” responsive design will be used. This mode is designed specifically for smartphones and won’t appear on tablets or desktops (when you resize the browser window).

Key differences between mobile app view and desktop view are

• Site header is designed in a different way. For city selector and search there are icons on which users can click. It’s worth noting that header design can depends on the child theme that’s currently active.
• Homepage: Listing title and address with image will be available. No content/excerpt/custom fields will be displayed.
• Listing Category Page: List and Map view are provided.
• Listing Detail page: Different icons are given for mail, phone, etc…Clicking on “call” icons directly calls the number from the phone.
• Listing Detail page: Information such as map, special offer, description, etc… are provided as accordion instead of tabs to have a better look.
• Listing Detail page: Popups like Send Inquiry or Send to Friend are not provided.
• Sidebar contents which is available in desktop view is not given in to the mobile view.
• Footer widget area is not displayed inside the mobile view.

 
Here’s the homepage and detail page with the mode ON and OFF

 

Design Settings

To open this section navigate to wp-admin ⇨ Appearance ⇨ Customize. From this section you can make design-related changes to Directory. Here are the options available…

Site logo

For instructions regarding the logo click here.

Navigation

Choose which menu displays in which menu area. It’s better to control these things from Appearance ⇨ Menus.

Color settings

Set different colors for different areas of the theme. Please note that specific city colors can override the global background you set in this area.

For making more extensive design tweaks use the Appearance ⇨ Custom CSS Editor area. To learn more about making CSS changes open this video.

Background settings

Set a background image by clicking on the “No image” grey box and then on “select a file”. Select a file on your hard drive and click “Open”. Control the look of your background image by tweaking the repeat property, position and scrolling.

Please note that specific city backgrounds can override the global background you set in this area.

Static Front Page

Directory will assign the correct Home page during activation. Don’t change these settings unless you know what you’re doing.

Footer

This box controls the bottom right corner of your site (the credits). Feel free to remove the “Designed by Templatic” part if you want.

Create pages using page templates?

Available templates

Directory comes with below mentioned built in Page Templates.

• Archive Page  – shows the posts month wise.
• Contact Us Page – shows a contact form. To create a Contact Us page select the Contact Us page template and go to Appearance ⇨ Widgets. Place the “T – Contact Us” widget inside the “Contact Page – Main Content” widget area. Inquires sent using such form goes to the email address specified in wp-admin ⇨ Settings ⇨ General. If you’re looking to customize the contact page, the relevant code is located inside the \wp-content\themes\Directory\page-templates\contact-us.php file.
• Front Page – creates a static Home Page. Click here for more info about setting up the homepage.
• Full width - makes your page full width (removes the sidebar).

Utilizing page templates

Just follow these steps…

1. Create a new page from wp-admin ⇨ Pages ⇨ Add New
2. Select any page template from the Template option given in Page Attributes section on the right side of your screen and publish it.

Theme Widgets

• T – Advanced Search –  Simply select the post type in it (like listing, events etc) for which you want to show advance search and save it. You can show any custom field in the advance search form by checking the “Advanced Search” box inside the “Show the field in” option while creating the custom field from wp-admin ⇨ Tevolution ⇨ Custom Fields.
• T – All Categories List – Show categories and their sub-categories. Use in the Homeage – Main Content area.
• T – Browse By Categories/Tags – Shows a list of list of categories or tags for the selected post type
• T – Category Page Map – The widget allows you to display a map on category pages. Comes in two variants (single-city and multi-city). They’ll show depending on whether or not you have the Location Manager plugin enabled. To use it make sure that “Map View” is disabled in Tevolution ⇨ Settings ⇨ Category Page.
• T – Contact Us – Shows a simple contact form that your visitors can use to get in touch with you. Emails will be sent to the address entered in wp-admin ⇨ Settings ⇨ General. To create a better contact form I recommend using the Contact Form 7 plugin.
• T – City DropDown – The widget will display the same cities as the header city selector, i.e. the ones you create in Tevolution ⇨ Manage Locations ⇨ Cities (tab). You should use it only once in a page to let it work accurately.
• T – Detail Page Map – Use inside detail pages of any post type. It shows a map based on the address and map view entered for that particular listing. Works best inside sidebar areas.
• T – Display Authors – Lists the authors on your site. You can choose the author role from the drop down given in the widget. Works best in sidebar areas.
• T – Display Posts – Show posts from any post type with post thumbnail, post title, post content, etc. Works in both sidebar and main content areas.
• T – Facebook Like Box – Shows a box with resizable style helpful to show Facebook fans on your site.
• T – Flickr Photos – Shows photos from Flickr on your site. Enter the title for your widget, the Flickr ID, number of images to display and you’re done. Get your Flickr ID here.
• T – Google Map Location – A simple widget that shows you a map of the address entered in it. You can use it on your contact us page.
• T – Homepage Display Posts – It will show your featured posts of any custom post like events, listing etc on your home page. Featured posts will be displayed above ordinary posts.
• T – Homepage Map – Comes in two variants (single-city and multi-city) depending on whether or not the Location Manager plugin is active. Click here for more info about the homepage map.
• T – Homepage Banner – It displays a slider for selected post type or custom images that you set in the widget. Click here for more info about this widget.
• T – Instant Search – Allows visitors to search through different types of content and also different areas (listing titles, categories, custom fields, etc). It has the ability to display relevant results as soon as you start typing.
• T – In The Neighborhood –  Displays listings that are in the vicinity of the listing that’s currently displayed. Use this inside the “Listing Detail Page Sidebar” widget area.
• T – Login Box – It shows “Login” and “Registration” links prior to login and after user logs in, it shows their profile dashboard links. Use this in sidebar areas.
• T – Newsletter - Shows a subscribe box with which users can subscribe your newsletter. Some of the suitable areas are Homepage – Main Content, Footer and any sidebar area.
• T – Popular Posts – It lists the popular post as per total views, daily views or comments.
• T – Recent Reviews – Shows the latest commented listing from any post type available on the site.
• T – Search by Miles Range – Allows visitors to enter an address and a mile range. This will create a perimeter from which listings are then pulled. Use this inside the “Listing Category Page Sidebar” area.
• T – Social Media – Provides a link to your account on various social media sites. Some of the suitable widget areas are Sidebar areas, subsidiary areas etc. Click here for more info.
• T – Testimonials – Allows you to display testimonial sentences on your site with a matching text and link. You can also set animation to it using the fields like “Set Time Out”, “Set the speed” and “Transition type”.
• T – Twitter Feed – Helpful to show your latest tweets from Twitter. Read our detailed tutorial for more info on using this widget.

How to translate Directory?

Directory can be translated using Poedit software. Detailed instructions for that are available inside our localization tutorial. Please read that article.

Here are some things that are specific to Directory and thus not explained inside the localization article…

Directory has a global PO file

The global PO file contains strings from all 4 main components. Each of the components (1 theme, 3 plugins) also has its own PO file with strings only from that component. I highly recommend using the global PO file for translating since it’s much easier to manage 1 file instead of 4 separate ones.
The location of the global PO file is: /wp-content/themes/Directory/languages/en_US.po

Directory has separate front-end and back-end strings

The global en_US.po file mentioned earlier contains front-end strings. If you want to translate the back-end area use the admin-en_US.po file. This is a global back-end PO file which contains strings from all 4 main components.
The location of the global back-end PO file is: /wp-content/themes/Directory/languages/admin-en_US.po

Translating add-ons

Text strings from add-ons aren’t included inside the global PO file. To translate an add-on you will need to translate its specific PO file. Each Directory add-on has a languages folder which contains a en_US.po file with text strings from that add-on. For example, here’s a path to the PO file for the Fields Monetization add-on:
/wp-content/plugins/Tevolution-FieldsMonetization/languages/en_US.po

Translating Directory in multiple languages

Let’s assume you want to translate Directory in German and Italian. If you followed the instructions inside the translation article correctly you should now have these two MO files: de_DE.mo and it_IT.mo. These files (along with their PO counterparts) should be located inside the /Directory/languages folder.

Follow these steps to complete the process…

1. Connect to your server and open the /wp-content directory.
2. Inside wp-content create a new folder called languages.
3. Paste your MO files inside this folder. In our case, those are de_DE.mo and it_IT.mo
4. By creating the languages folder we added a new setting inside WordPress. Go to wp-admin ⇨ Settings ⇨ General ⇨ Site Langauge. Use this option to switch between your languages; in our case Italian and German.
5. When you’ll need to make translation changes do not update files inside the /wp-content/languages folder. Update them inside the /wp-content/themes/Directory/languages folder.

Third-party plugin compatibility

WooCommerce

With WooCommerce you can transform your site into an online store. WooCommerce will handle all your products, shipping, tax and more.

To install the plugin navigate to Plugins ⇨ Add New and search for “WooCommerce”. Install and activate the first plugin in the results. For more details on how to actually use the plugin open the WooCommerce Docs.

Other supported plugins

• WordPress SEO by Yoast – by far the best SEO plugin inside the WordPress plugins directory. Since Directory doesn’t come with SEO features built-in it’s highly recommended you install a plugin such as WP SEO by Yoast.
• Gravity Forms – Gravity Forms is a premium plugin, but definitely worth it. It allows you to setup everything from simple contact forms to extensive and powerful order forms.
• Google Analytics Dashboard – helpful to keep track record of  your site statistics that includes number of visits, number of visitors, bounce rates, organic searches, pages per visit directly on your Admin Dashboard. Templatic’s directory add-on “Admin Dashboard” may also help you with further features.
• Comment Images – with the help of this plugin you can let your users upload their image right on the comment form.
• Simple Google Static Map – show a static Google map of a particular city

Style text with shortcodes

The easiest way to add buttons or columns into a post or page is to use shortcodes. You will find details on how to install and use them inside our Shortcodes article.

How to customize Directory?

You should avoid editing theme files directly at all cost. Instead, use a child theme or (even better), a plugin for PHP tweaks. CSS changes should be added to Appearance ⇨ Custom CSS Editor.

Open the Directory Customization article for details on how to customize this theme.

To streamline the plugin as much as possible certain features are available as optional (free) extensions. Download links for each feature are provided below.

Bulk Import/Export

Bulk Import allows you to populate the site with a lot of content in a short amount of time. If you already have a lot of content, this feature also allows you to export it. Both import and export work with CSV files. Import and export is available for both the actual content (events, properties, posts) and cities (controlled by the Location Manager add-on)

Installing the extension

1. Download the Bulk Import/Export extension.
2. Navigate to Plugins ⇨ Add New ⇨ Upload and load the downloaded zip file. Activate the plugin once the installation is complete.
3. To start using the plugin navigate to Tevolution ⇨ Bulk Import/Export.

How to edit a CSV file?

Using CSV files you’ll be able to upload up to 10,000 posts at once. To get started use the sample files provided in Tevolution ⇨ Bulk Import/Export as a base for your own CSV. A CSV is basically a simple text file. You can use any text editor to edit it; even something like Notepad++ would work in theory. Only in theory because editing a CSV as a plain text file is extremely hard and generally not recommended. Instead, you should use either OpenOffice Calc or Microsoft Office Excel. We’ve explained how to use both in the sections below.

OpenOffice Calc
OpenOffice is a free alternative to Microsoft’s Office suite, and Calc is an alternative to Excel. You can download it from here.

Assuming you have Calc installed and a sample file downloaded, follow these steps to get started:

1. Open Calc and click on File -> Open (or hit CTRL + O on your keyboard)
2. Locate the sample CSV file on your hard drive and click Open
3. In the popup that appears you should now see 4 sections of options: Import, Separator options, Other options and Fields
4. Set the values for the “Import” section like this
   Character set: Unicode (UTF-8)
   Language: English (USA)
   From row: 1
5. Inside the “Separator options” section choose the “Separated by” option and then select “Comma”. Uncheck other boxes if they are selected by default.
6. In “Other options” leave everything unchecked
7. In the “Fields” section left mouse click on the first field and then drag the horizontal slider to the right (to the end). Now press and hold the SHIFT key and click on the last field. All fields should now be selected.
8. With the fields selected choose “Text” under the Column type option
9. Click OK in the top right corner to start editing the CSV
10. Once you’re done with adding data save the file by going to File -> Save or by hitting CTRL + S on the keyboard

Not adding data in English? To avoid encoding issues and missing characters, you must save the file in the encoding appropriate for your language. To do that go to File -> Save As…, at the bottom of the popup you should see a “Edit filter settings” checkbox. Click on it and then hit Save. A popup should now appear in which you need to select the character set (leave the rest as is). Choose the appropriate encoding and hit OK. Do not choose UTF-8. UTF-8 encoded files created with Calc do not work correctly in Directory. No such problem with UTF-8 CSVs created with Excel.

Here’s a list of a few popular encodings

• Western Europe (ISO-8859-15/EURO – includes German, Swedish, Spanish, Italian, and more
• Eastern Europe (Windows-1250/WinLatin2) – includes Polish, Slovak, Croatian, Serbian (latin) and more
• Cyrillic (ISO-8859-5) – includes Bulgarian, Belarusian, Russian, Serbian and Macedonian

You can also use Google to determine the character encoding for your language. Just search for “character set for [your_language]”.

Microsoft Office Excel
Unlike Calc, Excel can create UTF-8 encoded CSV files just fine. Some languages are only supported by UTF-8 (like Hindi), making Excel the only viable option for editing the CSV.

1. Assuming you’re Windows, go the Control Panel -> Clock, Language and Region -> Region and language (or just search for “Region and language” using the start menu). In the “Region and language” popup click on “Additional settings” in the bottom right corner. Set the “List separator” to a comma [ , ].
2. Open a new Excel spreadsheet and click on Data in the top navigation bar. After that click on “From Text”.
3. Locate the sample CSV file on your hard drive and click Open.
4. Select the “Delimited” option and set the File origin to Unicode (UTF-8). Click on Next.
5. Uncheck “Tab” and select “Comma” as the delimiter. You should see a change in the data preview below. Click on Next.
6. Under data preview, left mouse click on the first field and then drag the horizontal slider to the right (to the end). Now press and hold the SHIFT key and click on the last field. All fields should now be selected.
7. With the fields selected, choose “Text” as the column data format in the top left corner of the popup. Click on Finish to complete the process.
8. Click on Ok to import the data into the existing worksheet. Start adding your content.
9. Once you’re done with adding data save the file by clicking on the office icon and choosing “Save As”. Under “Save as type” select “CSV (Comma delimited”. You’ll likely see some warnings after saving – select Yes for everything.

Additional info about specific CSV columns

templatic_post_author
The ID of the author. You can get this info by hover over the user in wp-admin ⇨ Users (similar to how you obtain post IDs).

templatic_post_name
The URL slug of the listing. Example: this-is-a-URL-slug

featured_type
This field accepts 4 possible values: none, both, h, c.
none – the listing isn’t featured
both – listing is featured on category page and homepage
h – listing is featured on the homepage
c – listing is featured on the category page

templatic_img
Inside this field you should enter the image filename. If you have multiple images separate them with semicolons. Example: music.png;cooldude.jpg;thirdimage.jpeg.

After the bulk upload you need to transfer those images to /wp-content/uploads/bulk (create the bulk folder if it’s not already created).

listing_logo
Enter the full URL to the logo image. You can upload the images from wp-admin ⇨ Media ⇨ Add New.

alive_days
Number of days the listing will be active on the site. Once that time expires the listing will be trashed or drafted. The exact action depends on your selection in Tevolution ⇨ Settings ⇨ Submission page ⇨ Default status for expired listings.

templatic_post_status
Set to publish or draft, depending on whether or not you want the listings to be available right after submission.

General tips for adding data

CSV files require a specific structure in order to work. Because of that peculiar structure they can often be tricky to edit. Here are some of the tips that should help you make the process a bit less time-consuming.

• In our sample CSV a comma [ , ] is used for the separator. Do not change it to another symbol
• When you need to enter a comma as a value (instead of a separator), wrap the whole value in quotation marks [” “]. For instance, if you need to enter multiple categories, enter them like this “Category1,Category2,Category3″
• Separate images with a semicolon [ ; ]. Example: img1.png;img2.jpg;img3.gif (commas aren’t necessary in this case)
• HTML is allowed in CSV files, feel free to use it. However, be aware of quotes. When writing HTML you must use quotes for most tags (including anchor and image). To avoid problems with the CSV, make sure to escape every quote. You do this by doubling up on quotes.
  For example, instead of this: This is a link
  Enter this: This is a link
• Inline CSS is also allowed, just make sure to escape quotes as mentioned for HTML
• Enter dates and time in the ISO format -> YYYY-MM-DD hh:mm. For example, the 2013. Christmas day at 3pm in this format would be: 2013-12-25 15:00

Bulk Export

To export your content into a CSV file choose the post type of the listings you want to export (in the CSV Export section) and click on the blue “Export To CSV” button.

How is it helpful?
Bulk Export can be helpful for…

• Taking regular backups of all your records.
• Transferring content to a different site.
• Lending/selling your data to someone.

Website crashing while exporting listings?
This can happen when exporting a large number of listings (over 1000). You can fix the problem by increasing the memory available to WordPress. Do that by adding the following code to your wp-config.php file.

define('WP_MEMORY_LIMIT', '512M');

IP Blocker

This extension will allow you to block specific IP addresses from your site and also implement SSL for the registration and submission pages.

Installing the extension

1. Download the IP Blocker extension.
2. Navigate to Plugins ⇨ Add New ⇨ Upload and load the downloaded zip file. Activate the plugin once the installation is complete.
3. To start using the plugin navigate to Tevolution ⇨ Settings ⇨ Security Settings (tab).

Coupon Manager

Installing this extension will allow you to create discounts for your own price packages. This is great when running promotions (like for Christmas or Black Friday).

Installing the extension

1. Download the Coupon Manager extension.
2. Navigate to Plugins ⇨ Add New ⇨ Upload and load the downloaded zip file. Activate the plugin once the installation is complete.
3. To start using the plugin navigate to Tevolution ⇨ Monetization ⇨ Manage Coupons (tab).

By creating coupons you can offer discounts on your own price packages. This is great when running promotions (like for Christmas or Black Friday). To create a coupon go to Tevolution ⇨ Monetization ⇨ Manage Coupons ⇨ Add a new coupon. Coupons can be limited to a specific time-frame by setting a start and end date. If you want the coupon to never expire, just enter an end date well into the future.

On submit pages the coupon code field will show automatically inside the last (Payment) step

Even though Directory comes with a crazy amount of features built-in there is even more stuff you can add by purchasing premium add-ons. Some of the most popular add-ons at the moment include…

• Fields Monetization – add more variety to your price packages by controlling which fields show up for which price package.
• Events – enables a new post type inside your theme; events. Recurring events functionality is also available with this plugin.
• List Filter – add custom fields as new filters for the listing category pages. Also works on search results pages.
• Tabs Manager – allows you to display existing or new custom fields as tabs on the listing detail page.
• Category Icons – display a nice Front Awesome icon every time categories are listed. Works with category widgets and sub-categories within parent category pages.

To speed up your Directory-powered website you should look into speeding up WordPress in general. Instructions on how to do that have been provided in this article
http://templatic.com/docs/how-to-speed-up-your-website/

How to make a specific listing featured?

To feature a listing you first need a price package in which the featured options have been enabled. Follow these steps to complete the process…

1. Assuming you don’t have any price packages with featured options, navigate to Tevolution ⇨ Monetization and click on the “Add New Package” button.
2. Under “Featured Options” near the bottom of the form click on the “Homepage” and/or “Category Page” options.
3. Enter the featured price for the homepage/category page and the duration in case you want the featured time to be different than the overall duration of the price package.
4. With all that done, open a listing on your site (in the back-end) and scroll down to the bottom of the edit page.
5. Under the “Price Packages” section you should now see your new price package. Click “Select” to select the package.
6. Once you do that featured options should appear below the price packages. Click on those checkboxes to make the listing featured.
7. Save the listing to finish the process.

Note: The process is exactly the same if you need to feature an event, property, classified, etc. Just make sure you select the appropriate post type when creating the price package.

How to enable social login through Facebook, Twitter, etc?

Social login can be controlled from Tevolution ⇨ Settings ⇨ Registration page ⇨ Allow user to login from social sites. For details on how to create Facebook, Twitter or Google+ apps click here.

How to remove the “Select All” option when selecting categories on the “Submit Listing” page?

To remove that option just add the following snippet of code to Appearance ⇨ Custom CSS Editor

.category_label .cf_checkbox > label{ 
    text-indent:-9999px; 
    height:0px; 
} 
.category_label .cf_checkbox ul label{ 
    text-indent: 0; 
}

How to configure SEO settings?

Directory theme doesn’t come with SEO features built-in. Instead, we are providing full support for these two popular SEO plugins

• WordPress SEO by Yoast
• All in One SEO Pack

How to hide the city selector?

If you want to use Directory with multiple cities, but don’t want to display the header city selector, just enter the following code to Appearance ⇨ Custom CSS Editor.

body .toggle_handler {
display: none;
}
#show_togglebox-button #show_togglebox_wrap {
display: none;
}

Why aren’t changes to my custom fields showing?

By default the theme will cache custom fields. To disable caching go to Tevolution ⇨ Custom Fields and click on the “Disable Cache” button at the top of the page.

Can authors upgrade their listings to a more expensive price package?

Yes, they can. An option for upgrading a listing is available inside the user dashboard. It will display as long as the listing is still active. Once it expires the “Upgrade” button will be replaced with a “Renew” button.

How to remove the WordPress admin toolbar?

The easiest way to achieve this is by using a plugin. Follow these steps…

1. Navigate to wp-admin ⇨ Plugins ⇨ Add New and search for Admin Bar Disabler. Install and activate the first plugin within those search results.
2. With the plugin installed navigate to wp-admin ⇨ Settings ⇨ Admin Bar Disabler and choose for which usergroups you want to show or hide the admin bar.

How to enable infinite scrolling?

1. Install and activate the Infinite-Scroll plugin.
2. With the plugin active go to Settings ⇨ Infinite Scroll.
3. Enter the following under the Content Selector option

   #loop_listing_taxonomy,#loop_listing_archive,#tmpl-search-results

4. Enter the following under the Navigation Selector option

   .pagination

5. Enter the following under the Next Selector option

   .next

6. Leave the rest as-is and click on “Save Options”.

With this completed infinite scrolling should now be enabled in all category pages, the “all listings” page and also all search pages.

How to create a contact form?

1. Go to Pages ⇨ Add New and create a page using the “Contact Us” page template.
2. Go to Appearance ⇨ Widgets and insert the “T – Contact Us” widget inside the “Contact Page – Main Content” widget area.

Messages submitted using the contact form will go to the email address specified in Settings ⇨ General.

Site loads blank frequently(for GoDaddy users)?*

GoDaddy users sometimes have problem that their site loads blank frequently after each 4-5 pages. Try updating PHP version on the site. You can update the PHP version from your GoDaddy cPanel itself or you may ask GoDaddy support too.

How to use WP REST API in Directory and child themes?

Find answer of this in more details here – http://templatic.com/docs/how-to-use-wp-rest-api-in-directory-and-child-themes/

WPML

Precautions required while translating individual custom fields in multiple languages using WPML.

If you have configured your WPML plugin content correctly, you should able to see the + sign next to each individual custom fields at your wp-admin >> Tevolution >> Custom field module.

See https://drive.google.com/file/d/0B4zqYzsurbeFZjhxTFNZWUozd3M/view

Click Upon that + sign for the required custom field you need to translate.

Take care of the following points while translating custom fields using WPML:

• During the translation process, do not change the HTML variable name for any custom field. Keep it identical as of your default language.
• Also do not change rest of the settings including Validation Options, Display Options, Miscellaneous Options etc..
• If any of your custom field is holding a field type as Multi select or radio, then do not change a value for the field “Option values”. Instead you can modify value for the field “option title”.
• You can change the content for Label, description, and default value fields.

We recently announced compatibility of the WP Rest API plugin with the theme. You can easily get your data in JSON format using this plugin with Directory. It will become useful to you if you are thinking to send your data to a third party application.

WP REST API will allow you to send listing information to other applications. It will also make it easier to receive information from other sources. Install the plugin simply and start using it.

Directory have city base URL structure. Thus to get city based data, check the following URL structures. You will need to change the city name, post type slug names there into the URLs. Words are highlighted which needs to be changed.

City Details:

Get only city details like name, latitude, longitude, map icon, etc…

Syntax – Sitedomain/wp-json/city/city_slug/

Example – Sitedomain/wp-json/city/philadelphia/

City wise listing details:

Get posts of listing post type with the for specific city

Syntax – Sitedomain/wp-json/city/city_slug/post/type/post_type_slug/

Example – Sitedomain/wp-json/city/philadelphia/post/type/listing/

Get listings of a category from specific city (By using category ID):

Get posts of listing post type with the filter of city, post type, taxonomy and category id

Syntax – Sitedomain/wp-json/city/city_slug/post/type/post_type_slug/taxonomy/taxonomy_slug/category_id/numeric_category_id

Example – Sitedomain /wp-json/city/philadelphia/post/type/listing/taxonomy/listingcategory/category_id/7

Get listings of a category from specific city (By using category Name):

Get posts of listing post type with the filter of city, post type, taxonomy and category name.

Syntax – Sitedomain/wp-json/city/city_slug/post/type/post_type_slug/taxonomy/taxonomy_slug/category_name/category_slug

Example – Sitedomain/wp-json/city/philadelphia/post/type/listing/taxonomy/listingcategory/category_name/place

Get listings of a tag from specific city (By using tag Name):

Get posts of listing post type with the filter of city, post type, taxonomy of tag and taxonomy tag.

Syntax – Sitedomain/wp-json/city/city_slug/post/type/post_type_slug/taxonomy/taxonomy_slug/tag_name/tag_slug

Example – Sitedomain/wp-json/city/philadelphia/post/type/listing/taxonomy/listingtags/tag_name/place

More details on the plugin’s features are provided here: http://wp-api.org/#posts_retrieve-posts

iFrames allow you to display parts of other themes/sites inside your own website. For instance, if you have the Directory theme installed inside a sub-domain you can use iFrames to display that sub-site in various parts of your main site. Getting this to work is simple, all you do is paste the iFrame code inside an appropriate page or (Text) widget.

The iFrame code should look something like this

<div style="overflow: hidden;">
<iframe frameborder="0" style="height: 700px; margin-top: -218px; width: 100%;" src="http://templatic.com/demos/directory/"></iframe>
</div>

Here’s what some of these controls mean…

height – set the height of the frame (in pixels)

margin-top – cuts the top of the embedded page. Useful if you want to hide the top part. For example, enter -32px to hide the WordPress admin bar. Insert -218px to hide the header or -250px to hide the header + admin bar.

width – enter a fixed width (in pixels) or as a percentage. Entering 100% will make the iFrame span across the whole element in which you placed it.

Example: Displaying Directory inside TwentyFifteen

Let’s imagine you want to display the Directory demo inside the homepage of the stock WordPress Twenty Fifteen theme. Here’s how you’d do it…

1. Go to Pages -> Add New and create a new page called “Homepage”.
2. Switch the content window to “Text” and insert the following code

   <div style="overflow: hidden;">
   <iframe frameborder="0" style="height: 700px; margin-top: 0px; width: 100%;" src="http://templatic.com/demos/directory/"></iframe>
   </div>

3. Go to Settings -> Reading and under “Front Page Displays” select your new “Homepage” map as the static front page.

If you did everything correctly your new homepage should look something like this

We find some users ask us there is no password field on my site’s registration form. Templatic themes use WordPress standard procedure for registraion. It displays Email Id and Username fields on the registration form. Depending on the theme, there might be extra fields or renamed fields. It will not ask for the password while registering on the site.

The password will be sent to site users by using registration email. It will be an auto-generated password. Users can change the password from their profile page after logging in on the site.

Theme Installation

Easy Installation

1. Connect to the member area and expand the “Listings Directory Child Theme” area within the “Directory Downloads” section. Download the Easy Installation .zip file.
2. Login to your WordPress dashboard and navigate to Appearance ⇨ Themes ⇨ Add New ⇨ Upload. Load the .zip file you just downloaded.
3. Activate the theme once the installation process is done.
4. Enter the license key. You can get it from the member area, under “Your Subscriptions” inside the right sidebar. Screenshot.
5. Go to the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo. The dummy data activation process can last up to 1-2 minutes. Don’t interrupt it.

Easy installation – Video Tutorial (watch in HD and full screen)

Listings installation video from Templatic on Vimeo.

Install Listing using FTP

Installing via FTP is necessary on servers that aren’t optimized for WordPress and can often interrupt the installation process because of the long execution time. Good news is that this type of install isn’t particularly hard, just longer compared to installing from the back-end.

1. Download all files available under “Traditional Installation” in “Directory” section inside member area and extract them using software like 7-Zip. Use the “Extract here” option; don’t extract into a new folder.
2. Assuming you read the above linked FTP tutorial, navigate to /wp-content/plugins/ on your server and upload the three plugin folders (Tevolution, Tevolution-Directory and Tevolution-LocationManager)
3. Navigate to /wp-content/themes/ and upload the Directory folder and Listings folder.
4. Login to your WordPress dashboard and go to Plugins. Activate Tevolution and enter the license key available inside our member area.
5. Go to the Plugins section again and activate Tevolution – Directory and then Tevolution – Location Manager.
6. Navigate to Appearance ⇨ Themes and activate the Listings theme.
7. While in the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo.

Home Page Configuration

See the below image for the HomePage configuration and accordingly check the points given after that to set up the widgets.

1) Logo: Change Logo

Go to your Wp-admin > Appearance > Customizer. Logo image can be changed from the section “Site Logo”.

2) City Selector: City selector shows the current city user have selected. Site will display listings added in to that city only on front end. More details on this is provided here: http://templatic.com/docs/directory-theme-guide/#locationsettings

3) Search widget: Explain widget option as per usage

Allows visitors to search through different types of content and also different areas (listing titles, categories, custom fields, etc). It has the ability to display relevant results as soon as you start typing

In Listing theme, this widget is placed at Appearance > Widgets > Homepage Banner area.

If you want to allow users to search from their current selected city only then enable the option “Search from current city” in to the widget settings.

Search can also be modified by enabling it for different fields from “Enable to Search form”.

4)Add Listing Button: This button is provided in to WP-admin > Appearance > Widgets > Navigation Right. N to the text widget below code is added to show the button:

<a class="submit-small-button button" href="http://templatic.com/demos/direcotry/submit-listing">Add Listing</a>

Change value in href to change your submit listing page link.

How to change color of this button?

Add below classes in to the Appearance > Custom CSS Editor and change the color codes as per your need:

.primary_menu_wrapper .submit-small-button.button {
background-color: #11b6d2;
border: none;
margin: 0;
}
.primary_menu_wrapper .submit-small-button.button:hover {
background-color: #73cb00;
}

5) Top Navigation: To Set up primary menu, Go to Wp-admin > Appearance > Menus. Create a Menus and assign it to the location: Primary.

6) Main Navigation: To setup the main menu navigate to Appearance ⇨ Menus. When done creating the menu assign it to the “Secondary” location. For detailed instructions on using menus watch this video How to create a menu with multi-column items (mega menu)?
To create an extensive navigation menu visit our mega menu article. To get a better idea how this menu looks open the Directory 2 live demo and hover over the “Theme Features” menu item.

Want to style your navigation bar with icons?
If yes, just use Front Awesome icons. To apply an icon expand the menu item you want to edit and insert the icon code inside the “Navigation Label” field (next to your item name). For example:

If you did everything correctly, your menu should look something like this
How to add login, register and logout buttons to the secondary menu?
Install the Code Snippets plugin and then add the following code inside a new snippet

7) Slider & 8) Search:

Please see this screenshot to set up these areas:

9) Main Slider textText: Find businesses,hotels or services: To change this text, open .po file from Listings/Themes/Languages folder using poEdit tool and there you will be able to translate the text.

10) Please see this screenshot to set up this area:

To display features posts only select “Only Featured” inside the “Sorting Options” dropdown in widget of “T > Homepage Display Posts”.

Quick tip: To select multiple categories inside the Categories field press and hold the CTRL (CMD) key and click on each category. To select all categories click on the first one, hold the shift key and then click on the last one.

11) Please see this screenshot to set up this area:

12) Please see this screenshot to set up this area:

13) Footer: Please see this screenshot to set up this area:

Category Page

Breadcrumbs

Displays the path to the category you’re viewing. The only breadcrumb option is available in Appearance ⇨ Theme Settings. It allows you to turn breadcrumbs On or Off.

Category title

The name of the category you’re viewing. You can change it by editing the category itself. Do that from wp-admin ⇨ Listings ⇨ Listings Categories.

View switchers

Controls how properties are displayed. You can choose from List, Grid and Map view. Settings related to this area can be found in Tevolution ⇨ Settings ⇨ Category page (tab).

Sorting dropdown

Choose the order in which the listings will be displayed. You can control which options are available from Tevolution ⇨ Settings ⇨ Category page (tab).

Category Description

Category description can be added from wp-admin ⇨ Listings ⇨ Listings Categories ⇨ Add/Edit Category ⇨ Description field. It is useful when you want to make the category pages SEO wise or when you want to give the description what that category is all about and will display which type of listings on the site.

Listings:

Listings added in to the category gets displayed here.

How to set a featured image?
When adding an property from the back-end use the “Featured Image” box located inside the right sidebar. You can also do it by simply uploading an image to the property image gallery.

6 – Category sidebar

To re-create this area navigate to Appearance ⇨ Widgets and insert the following widgets inside the “Listing Category Page Sidebar”

• Text: For Advertisement.
• T – Advanced Search: To enable search on the page
• T – Browse By Categories

This area can also have one more feature called List Filter. It will add awesome option for your readers to search the business easily by using AJAX.

Pagination

To control the number of listings displayed per each page go to Settings ⇨ Reading and edit the “Blog pages show at most” option. To make each category display all available properties just add a really high number.

Another look of Category page

Give your category page a look like below image only by doing two changes in to Wp-admin settings:

1. Go to Appearance > Widgets > Listing Category Pages –Below Header. Remove the Category page map – Multi city widget from there.
2. Go to WP-admin > Tevolution > General Settings > Category Page. Turn on the Option “Map view”. You can also make the map view to default view by selecting “Map” in to “Default page view” option.

Big Slider area possibilities

A) Slider behind Search Full width: Go to Wp-admin > Appearance > Widgets > Homepage Banner. Place Homepage Banner widget to have slider.

B) Map behind Search Full width: Alternatively Map can also be displayed by using “T > Homepage Map – Multi city” widget.

C) The full width Map and slider can be made to fit content width too like this by turning off “Show map in full width” option in to Tevolution General Settings > Map Settings.

Change Listing Header image

A) How to change header background image in all the listing detail page?

Go to your WordPress installation folder. Go to the folder Themes/Listings/Images. Replace your new image with “default_banner_header.jpg”. Make sure to keep the name of the image in same name and extension.

B) How to change header background image in individual listing image?

Add/Edit the listing at your Wp-admin. Upload the new banner image in to the field “Listing Banner” and save the changes. Listing owners can also do the same from submit listing page on front end.

Manage your Submit Listing Page

How to Add/edit options on submit page?

Submit page can be created by using this shortcode:

[submit_form post_type='listing']

To add/edit/remove different options go to WP-admin > Tevolution > Custom Fields. Here you can add/edit/delete different fields. Please read more here.for this and explore the section more properly.

Specific fields on specific category. Is this possible?

Yes, off course. Go to Tevolution > General Settings > Submission Page. Enable the option “Category specific fields”.

This option is useful when you want to assign some specific fields to some specific category. Such as field like “Time Duration” to “Event” category.

Set your “Terms and Conditions”

Terms and Conditions are really helpful to define a business’s limits and the user’s limits. I would say it is a safeguard for any business. To enable go to Tevolution > General Settings > Submission Page. Enable the option “Terms and conditions”. If you want to give a link to a detailed “Terms and Conditions”, just add the link using anchor tag inside “Terms and condition text” box there.

Secure your site with Captcha

Stopping spam submissions is must. Captcha on different forms can be configured from Tevolution > General Settings > captcha. More details is available here: http://templatic.com/docs/directory-theme-guide/#generalsettings.

Monetize

Different ways to Monetize

Monetization section is given at Tevolution > Monetization settings. Meanings of different options given there are very well explained in this guide – http://templatic.com/docs/directory-theme-guide/#monetization

There are different tricks and ideas you can manage the monetization section well. I am listing here some of the useful things as per I have experienced:

1. Free Package: Allow users to list their business for a short period on the site for free. Here, “Amount” field will be blank.
2. Get a small but regular fee: This is also a nice option to have continued revenue in coming. It will also build a user’s relationship. I would say it is small and steady. You can give pricing the way that users will pay a small amount on each fix duration to you.

To do so, enable the “Recurring package” option in to Tevolution > Monetization > Price Packages > Add/Edit price package page.

3. Get paid high for more number of listings: You can also allow users to submit multiple number of listings on a single package purchase. For that package type “Subscription ” is required to be purchase.

Just a tip. I would have been given an offer like this:

Submit one listings at $10 while with “Subscription Package” you can submit up to 5 number of listings with $45. This way users can get attracted to add more business on the site.

4. Specialize categories: Make some important and highlighted categories on the site which you usually highlight on Homepage, category, etc… For these categories some special price can be defined. I am sure business owners will be eager to list the business on the special category which is a plus part of the site.

To do so, go to WP-admin > Listings > Listing Categories. Add/Edit categories and there you can mention price for the category.

How to add different options to pay on the site?

By default theme provides you two systems to get paid:

1. Bank Transfer
2. PayPal

These systems can be configured at Tevolution > Monetization > Payment Gateways. More details on this is provided here.

Give more options to pay.

How to change currency?

Change the currency to accept payments in your currency amount from Tevolution > Monetization > Currency. Checkout more details here.

How to provide discount to your listing owners?

Hmm. This is a good way to have some more business on some special occasions or festive days. So as the other businesses do, you can also give some discounts to users to get the deal. Read more details: http://templatic.com/docs/directory-theme-guide/#managing_coupons

Where to see details of the payments?

Payment details can be seen at Tevolution > Transaction section. Entries of more than zero price only will come here. Transactions can be approve, rejected by the site owner this way.

Send expiration reminder

This is very important feature to get a re-business for existing customers. Send them reminders on particular duration before their listing expiration. So that they get some time and repay again to you by renewing the listing after it gets expired.

Reminder mail duration can be set as per your requirement at Tevolution > Settings > general Settings > Submission Page Settings > User listing expiry notification email option.

This Mail notification can be customized from Tevolution > Settings > Email Settings & Notifications > Listing expiration notification to user.

Get Users on site

How to allow visitors to register?

Go to WordPress General settings and enable the option “Anyone can register”.

Allow visitors to easily login with their social media accounts

There are many internet users like me who do not like to create new accounts on different websites. In such a case they just love to use their existing social media accounts on the new websites.

Directory also entertain such users by providing login feature through their social media accounts. To enable them, go to Tevolution > General Settings > Registration Page section. For how to get keys there, see the section named “Registration Page” in this guide.

Want some more information from users on their profile?

User specific fields can be created at Tecolution > Custom Fields > User Custom fields. These are used when you want to take some details from the listing owners and show it on the authors page. Foe example, we are taking their social media accounts. More details is provided here.

You should also visit how the author’s details are being displayed on their dashboard: http://templatic.com/docs/directory-theme-guide/#userdashboard

Add content easily as Admin

How to add different listing contents in bulk?

Until now we talked about process when listing owners will submit the listing. When site owner is thinking to add number of listings on the site, Bulk Upload is a good feature that can be used to save some time. More details on this is available here.

How can I add cities?

Go to Wp-admin > Manahe Locations > Cities > Add cities. From here cities can be added. Read this guide for how to add the cities and what is the exact feature of the the cities in to Directory.

How to add cities in bulk?

To add cities in Bulk, Bulk Import plugin is required. This section gives you more details – http://templatic.com/docs/directory-theme-guide/#bulkupload

We have some ready made CSV files of city list which might be useful to you while adding new cities. There are cities available for US, UK, Canada, Spain and more. Visit the forum thread.

Cities

How to show nearest city’s listings to visitors?

Let the site visitors surf their nearest listings by choosing “Ask To Show Nearest City” or “Nearest City” option in to Tevolution > Manage Locations settings.

Difference between these two options is well explained in to “Location Tracking” section here.

I want to make State wise Directory. Possible?

Why not? See the “City selector levels” section in to the same Location Settings guide.

Get statistics of cities being visited on the site

Enable the option “Track city visits (city logs)” in to Manage location settings of Tevolution and then go to Tevolution > Manage Locations > City Logs. There you will see the details on which city has more visits, etc…

This can be very useful for the future site enhancement and business expansion. For example, If particular country’s visits are more than a payment gateway of that country can be added to the site.

Show “similar businesses” to visitors

It is a very good practice to give some choices when user is viewing something. So that he can find the most fit thing for him. Similar listings does the same thing. It can be configured from Tevolution > Settings > Detail Page section. Set the option “Filter related posts by” to fit your requirement of the site.

Charge extra money by “Claim Ownership”

Many directory owners users the theme to list the businesses for free initially. Once they approach the business owners, business owners can be told to claim their listings form this feature. It can be enabled from Tevlution > General Settings > Claim Ownership section.

You can also charge the users who are claiming for the listing by using “Paid Claim” add-on.

Give an attractive “Mobile App” look

Yes, you can make the site look like an App when users are surfing site on their mobile by turning option “Mobile app view (Beta)” on at Wp-admin > Appearance > Theme Settings.

Customize theme’s style by using Custom CSS Editor

Custom CSS Editor given at Wp-admin > Appearance is very useful o customize the theme’s style and though keep them when updating theme/plugins.

Want to change direction of content to RTL?

When you are usimg a RTL language, this is very essential and most time saving feature. Enable “Right-to-Left (RTL) text orientation” from Wp-admin > Appearance > Theme Settings.

List the listing owners on single page

You can list all the listing owners on a single by using below shortcode at Wp-admin > Pages.

[PHP] [tevolution_author_list role=’subscriber’ users_per_page=’8′][/tevolution_author_list][/PHP]

More details

Get more familiar with customer by customizing the Mails & Notification

Go to Wp-admin > Tevolution > Settings > Email Settings & Notifications. Hereyou can change the content of the emails that are being sent to the site users.

Note that the shortcodes used there can not be exchanged in to the other email notifications. Shortcodes used in the particular mail can only be used there. Additional

Modify URLs of the site for SEO/user-friendly purpose

“Permalink Settings” section given at Tevolutin > Settings is really very important in terms to personalize the URLs of your site and making the SEO as per your needs.

If your tweaks start causing 404 errors in the front-end click on the “Reset all rules” button to undo your changes.

Add a new type of business listings by creating post types

Custom Post Types section at Tevolution > Custom Fields section is very helpful when you want to list different type of businesses on the same directory. Find more details here.

Create your Blog

The Blog in Directory is essentially just a category holding individual posts. So… follow these steps to create a Blog

1. Create a new category in Posts ⇨ Categories and name it Blog.
2. Add posts to that category by going to Posts ⇨ Add New.
3. By adding the posts our Blog page was automatically created. You can see it by going to Posts ⇨ Categories and clicking on the “View” link

Quick tips

1. To increase the number of entries available per-page on category pages (default is 5), go to wp-admin ⇨ Settings ⇨ Reading and change the value associated with the “Blog pages show at most” option.
2. I also recommend adding this Blog category to your navigation menu. Do that by going to Appearance ⇨ Menus and creating a new menu. Expand the categories dropdown, choose “Blog” and hit “Add to menu”. For details on creating custom menus watch our video tutorial.

Extend your Directory Business

Monetization Oriented

• Get some money by showing restricted content by using Access Manager
• Get some extra money showcasing more details of their business by using Fields Monetization.
• Charge users and Allow listing owners to view statistics of their business with Listings Statistics
• Turn your Directory theme into a fully fledged Real Estate portal.
• Earn money with providing various advertisements city wise by using Ad Manager.

Features Oriented

• Let your visitors submit business very easily with WYSIWYG editor.
• Allow listing owners to upload a voucher or coupon to their listings with Listing Vouchers.
• Provide various rating option to rate the listings with Multi Rating
• More cool features

1. Installation:

First of all, please check that you have the following 3 plugins installed on your site:

WPML String Translation

WPML Translation Management

Sitepress Multilingual CMS

Once you have installed the above plugins, follow the WPML steps mentioned in to the guide below to complete the installation:

https://wpml.org/documentation/getting-started-guide/language-setup/

2. Basic Setup:

After doing so, go to WP-admin >> Theme and Plugins localization and choose ” Translate the theme and plugins using WPML’s String Translation” option and save.

Select Translate the theme and plugins using WPML’s String Translation, to manage translating texts from theme/plugin template files via WPML’s String Translation admin screen.

With this option selected, WPML will scan the theme and find the texts that can be translated. It reports what it finds and let you enter translations, right from within WordPress.

Refer to the below attached link for how to scan the themes and plugins:

https://wpml.org/documentation/getting-started-guide/theme-localization/

Once you done with this, go to WP-admin >> Translation Management >> Multilingual Content Setup >> Custom fields translation >> Translate >> Enable the radio buttons and save.

3. Translate Booking Form:

You can translate the Booking Form page title from theme backend by clicking on plus (+) sign. For translating other sections of the booking form, continue reading below:

3.1 Translate “Review booking cost” section

For translating this section, go to WP-admin >> WPML >> String Translation >> search for the string using “Search for” box >> Translate the string >> Enable the option “Translation is complete” >> Save. That’s it!

See the below attached screenshot for more clarification:

Same as you can translate remaining strings showing under the section “Review Booking Cost”.

 

3.2 Translate “Booking Information” & “Address Information” sections

You can translate the custom fields showing under the “Booking Information” and “Address Information” sections from WP-admin >> Tevolution >> Custom Fields.

Here, click on the plus (+) sign, you will redirect to the add a new field page. Enable the post type, select the categories and change the Label of the field to translate the field.

Same as you can translate other custom fields too.

Once you will translate all the custom fields, it will show you translated custom fields in the theme backend and front end in the related language of the site.

Note: Please do not change the “Unique variable name” of the custom field. It should be same as original language’s custom field.

3.3 Translate “Payment Gateway”

This process is also the same as translating the “Review Booking Cost” section. You can translate these strings from string translation section (WP-admin >> WPML >> String Translation).

4. Translate Translate Rooms, Houses, Bookings

You can translate Rooms or Houses or Bookings by clicking on the plus (+) sign from the relevant sections.

WP-admin >> Room

WP-admin >> House

WP-admin >> Booking

Note: Same as you can translate posts and pages too from the relevant sections by clicking on plus (+) sign.

4.1 Translate Translate Rooms, Houses, Booking Categories

For translating the Room categories, go to WP-admin >> Room >> Room Categories and edit the category, you will redirect to the edit category page.

From here, click on “Add” link to translate it.

Same as you can translate other post type’s categories too.

Note: Keep slug same as original language’s slug

 

4.2 Booking Availability

It will automatically update the booking availabilities in all the languages once any user booked the room/house.

5. Translate widget strings

You can translate the widget strings from WP-admin >> WPML >> String Transaction section.

If you are unable to find any backend string in the string translation section, then go to WPML->String translation and scroll to the bottom of the page. There, click on Translate texts in admin screens.

This screen lets you choose which admin-options need to be translated. You’ll see everything that the theme saves. Search the string, enable the checkbox and click on “Apply” button.

Next, click on the link to go to the String translation page and now the strings would appear on the string translation page.

For more details, please refer to this guide:

https://wpml.org/2010/03/wpml-1-7-3-language-editing-and-translation-for-admin-texts/

Install theme

Install JobsDirectory using the WordPress back-end

Easy installation

1. Connect to themember area and expand the “JobsDirectory” area within the “My Downloads” section. Download the Easy Installation .zip file.
2. Login to your WordPress dashboard and navigate to Appearance ⇨ Themes ⇨ Add New ⇨ Load the .zip file you just downloaded.
3. Activate the theme once the installation process is done.
4. Enter the license key. You can get it from the member area, under “My Downloads” inside Download pop up.Screenshot.
5. Go to the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo. The dummy data activation process can last up to 1-2 minutes. Don’t interrupt it.

 

Want to hire us to complete the install for you?

If you don’t have time to tinker with installing JobsDirectory purchase one of our installation packages and we’ll do it for you! If you already purchased one of the installation packages please claim it here.

Manual Installation

This installation type is necessary on servers that don’t allow plugins to be loaded automatically (which is the case with the Easy Installation method). Traditional installations basically means loading each JobsDirectory component separately. Instead of installing one file (like with Easy Installation) you’ll instead manually install 3 plugins and 1 theme.

1. Download all files available under “Traditional Installation” inside member area.
2. Login to your WordPress dashboard and navigate to Plugins ⇨ Add New
3. Load the tevolution.zip you just downloaded. Activate the plugin once the installation is done.
4. Enter the license key. You can get it from the member area, under “My Downloads” inside Download pop up.Screenshot.
5. Navigate to Plugins ⇨ Add New ⇨ Upload and load the Tevolution-Jobs.zip. Activate the plugin once the installation is done.
6. Navigate to Plugins ⇨ Add New ⇨ Upload for the last time and load the Tevolution-LocationManager.zip. Activate the plugin once the installation is done.
7. Navigate to Appearance ⇨ Themes ⇨ Add New ⇨ Load the Directory theme file you previously downloaded. Do not activate the theme.
8. Navigate to Appearance ⇨ Themes ⇨ Add New ⇨ Load the JobsDirectory theme file you previously downloaded. Activate the theme once the installation process is done.
9. While in the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo. The dummy data activation process can last up to 1-2 minutes. Don’t interrupt it.

Install JobsDirectory using FTP

Installing via FTP is necessary on servers that aren’t optimized for WordPress and can often interrupt the installation process because of the long execution time. Good news is that this type of install isn’t particularly hard, just longer compared to installing from the back-end.

For general instructions about using FTP please open this tutorial.

1. Download all filesavailable under “Traditional Installation” inside member area and extract them using software like 7-Zip. Use the “Extract here” option; don’t extract into a new folder.
2. Assuming you read the above linked FTP tutorial, navigate to /wp-content/plugins/ on your server and upload the three plugin folders (Tevolution, Tevolution-Jobs and Tevolution-LocationManager)
3. Navigate to /wp-content/themes/ and upload the Directory (theme) folder.
4. Navigate to /wp-content/themes/ and upload the JobsDirectory theme folder.
5. Login to your WordPress dashboard and go to Plugins. Activate Tevolution and enter the license key available inside our member area.
6. Go to the Plugins section again and activate Tevolution – Jobs and then Tevolution – Location Manager.
7. Navigate to Appearance ⇨ Themes and activate the JobsDirectory theme.
8. While in the Appearance ⇨ Themes section, click on the blue “Install sample data” button to populate your site with dummy data and make it look like our demo.

How to add content on site?

Adding content to the site is easiest as well as tricky stuff. Thus I recommend a flow which can help you adding content easily. For example, adding jobs prior adding cities will require job posts to update again with new city added afterwards. Below is a flow starting from adding categories to adding jobs in bulk we recommend you can start adding your content. However, it depends on your choice and requirement how to add content to the site.

Add Categories & Tags

Go to WP-admin > Jobs > Job Categories. You can add new categories over here.

How can I add cities?

Go to WP-admin > Manage Locations > Cities > Add cities. From here cities can be added. Read this guide for how to add the cities and what is the exact feature of the cities in to Directory.

How to add cities in bulk?

To add cities in Bulk, Bulk Import plugin is required. This section gives you more details –http://templatic.com/docs/directory-theme-guide/#bulkupload

We have some readymade CSV files of city list which might be useful to you while adding new cities. There are cities available for US, UK, Canada, Spain and more. Visit the forum thread.

How to add a Job as site owner?

Go to WP-admin > Jobs > Add Jobs. Here you can add Jobs as admin. Please refer the screenshots below. It explains the things to be filled up in order to add a job to the site.

How to add a Job as a Job Provider/Employer?

On the site, Job providers submit the Jobs from front end submit Job page. For example, see this Submit Job page on demo.

How you can configure this page is well explained here.

How to add different Jobs in bulk?

Until now we talked about process when job provider will submit the job. When site provider is thinking to add number of jobs on the site, Bulk Upload is a good feature that can be used to save some time. More details on this are available here.

Different Home page

Homepage1

This is the page that you have when sample data is installed. It has all jobs listed with pagination. Number of jobs being displayed in one page can be increased or decreased from WordPress settings > Reading settings > Blog pages show at most option.

You will get more details on how to set up other widgets in to the HomePage2 section.

Homepage2

If you want to display widgets without sidebar then this page is used. It will look like the screenshot given below. To do so, go to WP-admin > Settings > Reading. Set the Static page to Home page. Make sure that the page you select here is having “Front Page Template” selected in it when you add/edit that page.

Homepage3

This is the home page with Map. You can list all the pin icons on the map on a big area on the Home Page. Map will give a lots of flexibility to users to find the jobs they are looking for in to the area they need. This is a unique and a useful way to give details of jobs to job seeker in to your Job portal.

This is how it will look when you have a map on the home page.

To achieve this look, go to WP-admin > Appearance > Widgets > Homepage Banner. Place “T > Homepage map – Multi city” widget in this area.

Homepage4

This is the home page with Slider. You can have a slider on a big area on the Home Page. With slider you can showcase various things that will be helpful to Job seekers as well as Job providers. For example, you can show case different services you are providing and give a detailed page link to know more about the services.

This is how it will look when you have a slider on the home page.

To achieve this look, go to WP-admin > Appearance > Widgets > Homepage Banner. Place “T > Homepage map – Multi city” widget in this area.

Quick tips

Job portal services sometimes differ city wise and jobs are generally being searched by candidates city wise. Thus instead of displaying a common banner for all the cities, you can also have a city wise slider on home page by using “Location Slider” add-on.

Category page configuration

Category and search pages are the most second pages any visitor go to while searching for a job or while thinking to post the job on any portal. Thus set up the categories and their views as it suits most needs of the site visitors.

Various sections in to category page are explained below:

1. Configure tabs

On the category page there are different tabs to surf different types of Jobs. If you want to add/edit this tab, this can be easily done by editing the custom field named “Job Types”. This is well explained here.

2. Increase/decrease number of post

How to increase/decrease the number of post showing in category page?

Please traverse to WP-admin >> Setting >> Reading >> Blog page shows at most >> from here you can increase/decrease the number of post showing in category page.

3. Set up sidebar

Different widgets relevant to the audience and for purpose of increasing sales can be placed in to the Jobs category page sidebar.

Go to WP-admin >> Appearance >> Widgets. “Job Category Page Sidebar” is the area in which different widgets can be placed. As per our recommendation, different widgets that suit this area are:

• T > Login Box
• Advertisements
• T > Browse by Categories/Tags
• T > Featured Job: Highlights a most important Job. As a site owner you can use this widget to charge some of the clients to highlight their Jobs when they need excellent candidates or candidates on urgent basis.
• List Filter*

Quick tips

1. To increase the number of entries available per-page on category pages (default is 5), go to wp-admin ⇨ Settings ⇨ Reading and change the value associated with the “Blog pages show at most” option.
2. I also recommend adding this Blog category to your navigation menu. Do that by going to Appearance ⇨ Menus and creating a new menu. Expand the categories dropdown, choose “Blog” and hit “Add to menu”. For details on creating custom menus watch ourvideo tutorial.

Detail page configuration

Detail page consists of various things with detailed information about particular job. We will cover here purpose of that information including how to set up them.

Header Fields: Fields like address, website, etc… are displayed by default in to the theme. They can be altered from Tevolution >> Custom fields section.

You can also add some more fields to highlight some more information of the jobs by using Header Fields plugin.

Send Inquiry/Send to Friend: These are the mails which enable your users to contact the company which posted the job or send recommendation to someone for that job.

To enable of disable them, go to WP-admin >> Tevolution >> Settings >> Email Settings & Notifications. Options can be disabled or enabled from “Detail Page Forms”.

Claim ownership: Please go here to read more on this.

Related Jobs by Category: Related jobs in to the same category enabled job seeker to have a look of the similar positions he/she is searching for. For example: a person looking for PHP developer post will have other three similar jobs of PHP development in to the same page. Thus he will have more options to choose from.

“Number of related posts” can be set up from WP-admin >> Tevolution >> Settings >> General Settings >> Detail Page. You can also choose various other options which can be configured to set the related jobs as per the site requirement. The options are: Filter related posts by, Enable distance-aware related posts for & Set the distance.

Other Jobs by same company: This is an important feature in to Job Portal. It provides other vacancies available in to the same company which give a bigger view of the company to the candidate for sure.

Comments & Ratings: People can comment and give ratings to jobs using this feature. Comments on the site can be enabled from WordPress setting’s Discussion settings.

Star ratings on the site can be enabled from WP-admin >> Tevolution >> Settings >> General Settings >> Detail Page >> Ratings option.

“Force Ratings” option is also there. If enabled, visitors won’t be able to submit a comment without entering a rating first.

Sidebar: Different widgets relevant to the audience and for purpose of increasing sales can be placed in to the Job’s detail page sidebar.

Go to WP-admin >> Appearance >> Widgets. “Job Detail Page Sidebar” is the area in which different widgets can be placed. As per our recommendation, different widgets that suit this area are:

• T > Browse by Categories/Tags
• T > Related Jobs
• Advertisements
• T > Detail Page Map

Submit Job

How to create submit page

Submit page can be created by using this shortcode:

To add/edit/remove different options go to WP-admin > Tevolution > Custom Fields. Here you can add/edit/delete different fields. Please read more here.for this and explore the section more properly.

What are the different Job Types available?

Different job types helps the jobs to bifurcate further and thus search for the right job and candidate becomes easier. By default we have provided three job types: Full Time, Part Time & Freelance.

If you want to add/edit/remove these job types, go to your WordPress’s Tevolution >> Custom Fields settings. Edit the field named “Job Type”. Change titles in option “Option Title” & “Option values”. Save the field.

 
There are different colors associated with the types. You can define these colors at Tevolution >> Settings >> Category page >> Set the title and colors for job types option. These color tags affects on the various pages such as Home Page, category page, etc…
 

How to Add/edit options on submit job page?

The first thing you see on submit Job page is price packages. To create and manage your price packages navigate to Tevolution ⇨ Monetization. More details.

You can control which fields show inside this area from Tevolution ⇨ Custom Fields. For more details on that section click here.

Category wise fields

Do you want specific fields on choosing specific category? Is this possible? Yes, off course. Go to Tevolution > General Settings > Submission Page. Enable the option “Category specific fields”.

This option is useful when you want to assign some specific fields to some specific category. Such as field like “CPA certified?” to “Accounting Jobs” category.

Set your “Terms & Conditions”

Terms and Conditions are really helpful to define a business’s limits and the user’s limits. I would say it is a safeguard for any business. To enable go to Tevolution > General Settings > Submission Page. Enable the option “Terms and conditions”. If you want to give a link to a detailed “Terms and Conditions”, just add the link using anchor tag inside “Terms and condition text” box there.

Secure your site with Captcha

Secure your site with Captcha

Stopping spam submissions is must. Captcha on different forms can be configured from Tevolution > General Settings > captcha. More details is available here: http://templatic.com/docs/directory-theme-guide/#generalsettings.

How candidates can apply to the job?

This is very important aspect of a Job Portal site. Employer can choose from below two options to get the candidate details:

1. Via Email: When candidate will click on apply now button, it will open an Email pop – up from where candidates will be able to compose mails from different mailing systems such as Gmail.
2. Via URL: When candidate will click on apply now button, it will redirect user to the URL provided in to the backend. Generally, URL is company’s career page from where candidates can apply.
3. Are you looking for any other method? – Let us know here. If we will receive similar requests we will consider implementing it in future. Please mention that you are going from this guide.

Various useful pages

All Employers Page

You can list all the Job Providers on a single by using below shortcode at Wp-admin > Pages.

[PHP] [tevolution_author_list role=’subscriber’ users_per_page=’8′][/tevolution_author_list][/PHP]

More details

Contact Us Page

Shows a contact form. To create a Contact Us page select the Contact Us page template and go to Appearance ⇨ Widgets. Place the “T – Contact Us” widget inside the “Contact Page – Main Content” widget area. Inquires sent using such form goes to the email address specified in wp-admin ⇨ Settings ⇨ General. If you’re looking to customize the contact page, the relevant code is located inside the \wp-content\themes\Directory\page-templates\contact-us.php file.

Sales Department

Different ways to Monetize

Monetization section is given at Tevolution > Monetization settings. Meanings of different options given there are very well explained in this guide – http://templatic.com/docs/directory-theme-guide/#monetization

There are different tricks and ideas you can manage the monetization section well. I am listing here some of the useful things as per I have experienced:

1. Free Package: Allow users to list their jobs for a short period on the site for free. Here, “Amount” field will be blank.
2. Get a small but regular fee: This is also a nice option to have continued revenue in coming. It will also build a user’s relationship. I would say it is small and steady. You can give pricing the way that users will pay a small amount on each fix duration to you.

To do so, enable the “Recurring package” option in to Tevolution > Monetization > Price Packages > Add/Edit price package page.

3. Get paid high for more number of jobs: You can also allow users to submit multiple numbers of jobs on a single package purchase. For that package type “Subscription” is required to be purchase.

Just a tip. I would have been given an offer like this:

Submit one jobs at $10 with “Subscription Package” while you can submit up to 5 number of jobs with $45. This way users can get attracted to add more business on the site where $10 & $45 are just example prices.

4. Specialize categories: Make some important and highlighted categories on the site which you usually highlight on Homepage, category, etc… For these categories some special price can be defined. I am sure job providers/employers will be eager to list the jobs on the special category which is a plus part of the site.

To do so, go to WP-admin > jobs > job Categories. Add/Edit categories and there you can mention price for the category.

How to add different options to pay on the site?

By default theme provides you two systems to get paid:

1. Bank Transfer
2. PayPal

These systems can be configured at Tevolution > Monetization > Payment Gateways. More details on this is provided here.

Give more options to pay.

How to change currency?

Change the currency to accept payments in your currency amount from Tevolution > Monetization > Currency. Checkout more details here.

How to provide discount to your job providers?

Hmm. This is a good way to have some more business on some special occasions or festive days. So as the other businesses do, you can also give some discounts to users to get the deal. Read more details: http://templatic.com/docs/directory-theme-guide/#managing_coupons

Where to see details of the payments?

Payment details can be seen at Tevolution > Transaction section. Entries of more than zero price only will come here. Transactions can be approve, rejected by the site owner this way.

Send expiration reminder

This is very important feature to get a re-business for existing customers. Send them reminders on particular duration before their job expiration. So that they get some time and repay again to you by renewing the job after it gets expired.

Reminder mail duration can be set as per your requirement at Tevolution > Settings > general Settings > Submission Page Settings > User job expiry notification email option.

This Mail notification can be customized from Tevolution > Settings > Email Settings & Notifications > Job expiration notification to user.

Get more sales

by “Claim Ownership”

Claim ownership gives you real owners of the jobs and paid claim will give you a way to charge the owners before you verify their claim

 
by “Access Manager”

• Get some money by showing restricted content by usingAccess Manager

by “Category Pricing”

You can give a specific price to specific category to charge your users for different purpose. Such as:

1. Highlight that special category on the site somewhere like “Urgent Requirements”
2. Give some specific fields to that category and charge users to display those additional information on the site. When user will select the category, at that time only those fields will appear on submit job page. More details.

by “Field Monetization”

• Get some extra money showcasing more details of their business by usingFields Monetization.

by “Ad Manager”

• Earn money with providing various advertisements city wise by usingAd Manager.

by “Jobs Statistics”

Charge users and Allow job provider to view statistics of their business with Listings Statistics

Get Users on site

How to allow visitors to register?

Go to WordPress General settings and enable the option “Anyone can register”.

Allow visitors to easily login with their social media accounts

There are many internet users like me who do not like to create new accounts on different websites. In such a case they just love to use their existing social media accounts on the new websites.

Directory also entertain such users by providing login feature through their social media accounts. To enable them, go to Tevolution > General Settings > Registration Page section. For how to get keys there, see the section named “Registration Page” in this guide.

Want some more information from users on their profile?

User specific fields can be created at Tecolution > Custom Fields > User Custom fields. These are used when you want to take some details from the job providers and show it on the authors page. Foe example, we are taking their social media accounts. More details is provided here.

You should also visit how the author’s details are being displayed on their dashboard:http://templatic.com/docs/directory-theme-guide/#userdashboard

Manage Cities

Cities is an important feature of the site which decides which content will appear and when. This section is coming from Tevolution-Location Manager Settings. Click here to see how to add cities.

How to show nearest city’s jobs to visitors?

Let the site visitors surf their nearest jobs by choosing “Ask To Show Nearest City” or “Nearest City” option in to Tevolution > Manage Locations settings.

Difference between these two options is well explained in to “Location Tracking” section here.

I want to make State wise Directory. Possible?

Why not? See the “City selector levels” section in to the same Location Settings guide.

Get statistics of cities being visited on the site

Enable the option “Track city visits (city logs)” in to Manage location settings of Tevolution and then go to Tevolution > Manage Locations > City Logs. There you will see the details on which city has more visits, etc…

This can be very useful for the future site enhancement and business expansion. For example, If particular country’s visits are more than a payment gateway of that country can be added to the site.

SEO

We provide compatibility with WordPress SEO plugin and All in on SEO plugin which you can use to improvise your site’s SEO.

Modify URLs of the site for SEO user-friendly purpose

“Permalink Settings” section given at Tevolutin > Settings is really very important in terms to personalize the URLs of your site and making the SEO as per your needs.

If your tweaks start causing 404 errors in the front-end click on the “Reset all rules” button to undo your changes.

Create your Blog

The Blog in Directory is essentially just a category holding individual posts. So… follow these steps to create a Blog

1. Create a new category in Posts ⇨ Categories and name itBlog.
2. Add posts to that category by going to Posts ⇨ Add New.
3. By adding the posts our Blog page was automatically created. You can see it by going to Posts ⇨ Categories and clicking on the “View” link

Personalize theme design

Give an attractive “Mobile App” look

Yes, you can make the site look like an App when users are surfing site on their mobile by turning option “Mobile app view (Beta)” on at Wp-admin > Appearance > Theme Settings.

Customize theme’s style by using Custom CSS Editor

Custom CSS Editor given at Wp-admin > Appearance is very useful o customize the theme’s style and though keep them when updating theme/plugins.

Want to change direction of content to RTL?

When you are usimg a RTL language, this is very essential and most time saving feature. Enable “Right-to-Left (RTL) text orientation” from Wp-admin > Appearance > Theme Settings.

Advanced

Add a new type of business listings by creating post types

Custom Post Types section at Tevolution > Custom Fields section is very helpful when you want to list different type of businesses on the same directory. Find more details here.

Get more familiar with customer by customizing the Mails & Notification

Go to WP-admin > Tevolution > Settings > Email Settings & Notifications. Here you can change the content of the emails that are being sent to the site users.

Note that the shortcodes used there cannot be exchanged in to the other email notifications. Shortcodes used in the particular mail can only be used there. Additional

Featured Job widget

Highlights a most important Job. As a site owner you can use this widget to charge some of the clients to highlight their Jobs when they need excellent candidates or candidates on urgent basis.

Freebies

You get some of the freebies as well! These are quite useful freebies which can affect the whole site and experience. Take a look at them here:

Shortcodes

Templatic – Shortcodes plugin can be used to give different styles in your site. See Shortcodes plugin in action. This article will give you more details on how to use them.

IP Blocker

This extension will allow you to block specific IP addresses from your site and also implement SSL for the registration and submission pages.

Installing the extension

1. Download the IP Blocker extension.
2. Navigate to Plugins ⇨ Add New ⇨ Upload and load the downloaded zip file. Activate the plugin once the installation is complete.
3. To start using the plugin navigate toTevolution ⇨ Settings ⇨ Security Settings (tab).

Bulk Import/Export

Using Bulk Import/Export plugin you can insert multiple data in bulk on the site. You can get more details here on how to install and use this plugin.

Coupon Manager

This is for providing discounts to your site users when they submit Jobs. You can provide discounts while festive season or while a new service release on the site. You can get more details here on how to install and use this plugin.

100 category icons

We have designed 100 category icons especially for you guys as a gift. Grab them here.

Mega Menu

When you see the demo, you must be pausing for a second on the three level menu under “Theme Features”. This feature is available for free in to the theme. Menu will have a different look if the jQuery Mega Menu plugin is not installed. You can get more details here on how to install and use this plugin.

Directory theme guide

Go deeper by reading Directory theme guide.

Extend your Directory Business

A person having good experience will come back automatically to same place. Extend the site to increase overall site visitors/user experience.

• Let your visitors submit business very easily with WYSIWYG editor.
• Allow Jog Providers to upload a voucher or coupon to their jobs with Listing Vouchers.
• Provide various rating option to rate the jobs with Multi Rating
• More cool features

Theme Support

We are always a step ahead to help you. Contact us at – Theme support

Customize your site

As JobsDirectory is a huge application we have provided some basic help to you in Customize Jobs Directory. So that you can edit the code easily.

Hire US

Hire us for your project!

Installation

1. Download the plugin fromTemplatic member area. You’ll find it inside the “My Plugins” sub-section.
2. Navigate to WP-admin ⇨ Plugins ⇨ Add New ⇨ Use the “Browse” button to load the previously downloaded .zip file. Click on “Install Now” to confirm.
3. Once the plugin is finished installing, click on the “Activate” button.

Load Sample Data

As soon as you active the Deals add-on a new post type will be created on your site – Deals. If you want to load a few sample properties, click on “install sample data” given at the top of the plugins page which comes after plugin activation.

Add Content

Where to start adding content at your Deals Plugin?

You must be having so many things in your mind to do with your new set up site and most likely be confused which start would be good for you. By looking at our previous queries from you guys and difficulties, we suggest below flow to add content to your site. So that it will create less hassle for you if you want to edit something in future. To add new content at your site please go through this workflow.

1. Add new Deals categories
2. Add new Deals tags
3. Add a Deal

Add new Deals categories

Traverse to WP-admin >> Deals >> Deals categories >> Fill up the fields like Name, Slug, Parent option, Description >> Add new Deals categories.

Add new Deals Tags

Traverse to WP-admin >> Deals >> Deals Tags>> Fill up the fields like Name, Slug, Description >> Add new Deals Tags.

Add new Deal

Traverse to WP-admin >> Deals >> Add a Deals >> Fill Appropriate data >> Click on “Publish” button

From here you can fill up the related information of the Deal like, Add information of Seller, Product, Deal and Purchase Limit. Once you fill up the appropriate information in this fields you can assign the categories and tags, Gallery Image, Featured Image to this deal from the sidebar and click on “Publish” Button.

Seller Information

In Seller Information you need to add the Information about the seller like “Name”, “Email”, “Phone”, “Website” and “Seller Description” as shown in this image.

Product Information

In this section you need to provide the information about the product like, “Total no of items”, “Regular Price”, “Our Price” as shown in this image.

Deal Information

In this section you need to provide the information about the Deal like, “Deal type”, “Start date”, “Start time”, “Disable deal Expiration date”, “End date”, “End time” as shown in this image.

There are four types of deal.

1. Custom link Deal
2. Digital Product Deal
3. Coupon Email/Print Online
4. Coupon Email/Print Product

Custom link Deal

In this deal type you can set the affiliate link , so whenever user click on that deal from the front page it will redirect the user to that given affiliate link.

Digital Product Deal

In this Deal type you can upload the product. So that user can download that product from here. You can set the products like and docs file, audio file etc..

So user can easily download that products.

Coupon Email/Print Online

In this deal type you can set some coupons to this deal. You have the option here to set the single coupon or multiple coupons . If you select the single coupons then this coupons code will apply to all of your products listed here. And if you select multiple coupons code then you need to insert multiple coupons code with (,) separator. Suppose in last section you have set “Total number of items” to “10”. Then here you need to add 10 coupons code with (,) separator if you have select the multiple coupon option.

Coupon Email/Print Product

You can include the shipping cost in this deal type so it will charge extra shipping charge to that purchased deal.

Also you have an option to set the address of the deal, So when User is in particular city it will show the deals which are listed it this city. Suppose you have set the location of London here, so it will show this deal to those users who are in London city.

Purchase Limit

In this section you need to provide the range of the purchase, minimum number of deal and maximum number of deal which user can purchase.

Price Packages

Select your price package for this deal from the list of the available packages.

Deal categories

You can assign the related deal categories from the right sidebar area, which you have already add in your deal categories.

You can also create a new categories from here by clicking on “Add new deal categories”. So you can add new categories in this deal from here.

Deal Tags

You can tag the related deal from the right sidebar area, which you have already add in your deal tags or you can add new tags from here.

Add Image gallery

From here you can add multiple images of deal in gallery by clicking on “Add images gallery”. To select multiple images from the media library press ctrl + click and select the images.

Submit Deals

Once you activate the plugin at your site and install sample data it will automatically create a page named “Submit deal” at your site. So you can submit a deal from the front end of your site. If you will not able to find this page then you can also create it manually by your own.

How to create submit page

Create a new page named “Submit deal” and add this given shortcode. So this will allow you to submit a deal from the front end. You can also add a menu tab of this page, for that you can refer this link for more information about how to set up menu.
Submit page can be created by using this shortcode:

Submit a deal from the front end site.
To submit a deal from the front end site please open this mentioned URL “www.yourdominname.com/submit-deal/” so you will able to see the Price package here as shown in this screenshot.

Once you select the Price Package, please take a look to this video which shows you how to submit a deal from the front End.

How to Add/Remove different type of new custom fields?

To add/edit/remove different options, go to WP-admin > Tevolution > Custom Fields. Here you can add/edit/delete different fields. Please read more here.for this and explore the section more properly.

Manage Pages

Home Page

Featured Deal

To show the featured deal at your home page, you need to add the widget named “T – Featured deals” at “Homepage main Content” area.

First you need to set a deal as a featured deal, you will get the detail information of how to set the deal as a featured deal from this link now scroll down you will get the section named “Featured options”.

Traverse to wp-admin >> Appearance >> Widget >> Place the “T – Featured deals” widget >> at “Homepage main Content” area >> Select the deal which you want to show you at homepage. and save the settings. Now take a look at your homepage.

Show deals on Homepage.

To display the deals on homepage traverse to wp-admin >> Appearance >> Widget >> Place the “T – Homepage Display deals” widget >> at “Homepage main Content” area.

In this widget you can show categories wise deals, to show the deals as per their status like Live, future, Expired. Also you have different type of sorting option to show the deals. do all the settings as per your needs and save it.

Category Page/Archive Page

In the category page we have distribute the deals as per its status. You can see in the above screenshot the deals are distributed as per its deal status like All, Live, Expired, Upcomming. And also there is a sorting option through which you can sort the deals.

We have distributed deals as per status as Live, Expired, Upcomming.

How to show different deal categories in the category sidebar area?

To show the different deals category in sidebar area, traverse to wp-admin >> Appearance >> Widget >> Place “T – Browse by category” widget at “Category Page sidebar” area >> Now select the “deal” option in “Select Post type” option and save the settings.

Like this way you can show the deals category in sidebar area.

Detail Page

You can see the deal details near by the deal image. In which you can see all the detail information of the deals. If you want to purchase the deal then simply click on the “Buy Now” button.

Once you click on Buy now button it will ask you to fill up the billing address and Shipment Address. Fill up those details and then it will take you to further steps like login and payment.

How to add/remove social media sharing buttons and “Send to friend” ,“Send Inquiry” from detail page?

• For Social Sharing buttons

Please traverse to WP-admin >> Tevolution >> Settings >> General Settings >>Detail Page settings >> Show sharing Buttons >> To remove those buttons from front end, disable this all options and save the settings.

• For “Send to friend” and “Send Inquiry”.

• Please traverse to WP-admin >> Tevolution >> Settings >> Email settings and notification >>Detail page Forms >> to remove this options disable this options and save the settings.

How to enable/disable the comments/review section in detail page?

Please traverse to WP-admin >> Settings >> Discussion >> From here you can change the settings to enable the comment section as shown in screenshot.

If still you are not able to enable the comments/review section, make sure that this given options are enable.

For Individual listing:

Please traverse to WP-admin >> Products >> edit product >>Screen option at top-right corner >> Enable author options >> Now scroll down to the page and go to “Review Settings” >> Enable options “Allow review” >> Save the settings.

For Pages and Post:

If you want to enable comments on Page/Post then,

Please traverse to WP-admin >> Appearance >> Customize >> Detail Page setting >> Enable comments on page/post >> Save and published.

You can also enable the “View Counter” from third settings.

Author Page

Through the Author page you can track the deals. From here can get the details about the deals which you have purchased as well which you have submit.

The deals which you have submit are given as “Deals” in Author Page.

So you can track all the deals which you have submitted. You can also Edit/Upgrade/Delete the deal from here. You can get the Transaction of individual deal by clicking on “Transaction” button.

If you want to approved the pending deals you can do it from the wp-admin >> Tevolution >> deal Transaction >> Here you can see the list of pending and approved deals. So you can approved from here. From the same section you can generate a report of your deal transaction from here.

For that traverse to wp-admin >> Tevolution >> Deal Transaction >> You can able to generate the report from here. And also you can approved the pending deals from here.

And the deals which you have purchased are given as “Purchased deals”.

In the purchased deals you can get the information like Deal Name, Coupons, Expires Status, Print/Download status of the individual deal.

If you want to print the coupon then simply click on the print link. So you will able to print the coupon which are available to print.

You can also change the text which is given in the Print voucher. For that please traverse to wp-admin >> Tevolution >> Settings >> Email and Notification >> Print voucher text >> Quick Edit. You can Edit the print message from here. You can refer this screenshot here.

Making site available in multiple languages benefits bringing in more visitors on the site for sure and thus sell. Not agree? See the benefits of Multilingual website here.

On the same time, Directory + WPML using at a time requires a lot of patience of yours. Both are big applications and thus they require very correct configuration to get the intended output.

We are trying here to make it easier for you with some start up help in translation. After activating WPML packages, complete the installation of it by selecting your languages and language selector position.

Now, Start translating content!

DON’T: When you think to translate content, don’t jump in to posts/listings first. Some of the other steps are required prior to get translated. So that content can be translated after that easily.

These are five easy steps you can follow one by one:

1. First and very important step is: You will need to translate your Frontpage from WP-admin >> Pages in the other languages to be displayed on the frontend when switching languages. Click on the plus (+) sign to translate the pages in the other languages.
   Don’t check this right now. You will not be able to see the home page still in multiple languages because there are other content still which needs to be translated.
2. Now, translate the custom fields from WP-admin >> Tevolution >> Custom Fields Setup. If you don’t find here the plus (+) sign, refer Directory theme guide’s WPML section FAQ.
3. Categories/Tags: Go to WP-admin > Listings > Listings Categories/Tags and translate the categories or tags available. You can do the same with “Posts” post type or any other post type you are using.
4. Translate your posts/listings/events/etc…
5. Widgets and Strings: For translating the backend widget strings or remaining strings on the frontend, please go to WP-admin >> WPML >> String Translation. More details.

These were some small tips to start translations with Templatic Themes. WPML’s expert documentation is always there to help you deeper for this.

Google maps are backbone of our Directory themes, What if you can have the map in your own language on the Directory theme? Nice no? Yes, you can translate the Google Map language in your Directory theme or any other theme using Google Maps.

Let’s see how can we achieve this:

• Open the relative file of MAP from where the map parameters like zooming factor and all are given. You will be able to find a line of code something like this:
• <script type=”text/javascript” src=”http://maps.googleapis.com/maps/api/js?sensor=false”></script>
• If you are not able to find the whole line, just try to look for the “src” URL. Replace it with this one:
• <script type=”text/javascript” src=”http://maps.googleapis.com/maps/api/js?sensor=false&language=es”></script>
• As you can see that it has only added “&language=es” in to the URL end. es is the language code. You can have a list of available languages and their codes here.
• There can be some more text after “sensor=false” in your file. At the end of the src just append the language parameter with “&” sign(&language=es).

Google developers are providing more detailed information here – https://developers.google.com/maps/documentation/javascript/basics#Language

Should you have any suggestions/ questions, do let me know here.

We’ve had a customers in general have an issue where their site is showing a blank page or 500 Internal server error frequently. All of them were using GoDaddy server.

We generally recommend users to use Site5 hosting to run the template without having such an issue(s) as Directory is an application like theme so it is natural that it will require more server resources then other simple WordPress themes and as soon as your site gets traction both content and traffic on your website will increase simultaneously so your website will need more server resources for better performance.

If you are on a shared hosting your server resources will be shared with other websites on the same server so you will get limited resources for your website which will ultimately result in an underperforming website. On the other hand if you go with a dedicated server all server resources will be available for your website and it will perform much better.

However, if you would like to go with GoDaddy server, here is a list of some solutions which you should try to resolve the issue:

Solution – 1:

First of all, check the PHP version you are using. It should be 5.5 or greater.

You can refer to this link for how to update the PHP version:

https://www.godaddy.com/help/view-or-change-your-php-version-3937

Solution – 2:

Check your site’s error log. You can ask your web host for the error log. If you are getting the error mentioned below in your error log, then follow these steps:

Error: Connection reset by peer: mod_fcgid: error reading data from FastCGI server

Steps:

• Go to /home/sitename/fcgi-bin
• Use this command to reset the immutable flag: chattr -i php5.fcgi
• Then delete the /home/sitename/etc and /home/sitename/fcgi-bin directories (making sure that anything that’s not PHP related in etc is saved)
• Using virtualmin switch back to apache mod_php mode and then back to FCGId mode. The site should now work. Don’t forget to chow any files/directories in public_html that were apache to : Note that these are both usually the sitename.

If you guys are not aware about the steps mentioned above, then consult with your web host regarding this as they would be better able to help you resolve this matter.

Security in WordPress is taken very seriously, but as with any other system there are potential security issues that may arise if some basic security precautions aren’t taken.

This article will go through some common forms of vulnerabilities, and the things you can do to help keep your WordPress installation secure.

This article is not the ultimate quick fix to your security concerns. If you have specific security concerns or doubts, you should discuss them with people whom you trust to have sufficient knowledge of computer security and WordPress.

Fundamentally, security is not about perfectly secure systems. Such a thing might well be impractical, or impossible to find and/or maintain. A secure server protects the privacy, integrity, and availability of the resources under the server administrator’s control.

Decide which security you need on your server by determining the software and data that needs to be secured. The rest of this guide will help you with this.

Updating WordPress

Main article: Updating WordPress.

The latest version of WordPress is always available from the main WordPress website at https://wordpress.org. Official releases are not available from other sites — never download or install WordPress from any website other than https://wordpress.org.

Since version 3.7, WordPress has featured automatic updates. Use this functionality to ease the process of keeping up to date. You can also use the WordPress Dashboard to keep informed about updates. Read the entry in the Dashboard or the WordPress Developer Blog to determine what steps you must take to update and remain secure.

If a vulnerability is discovered in WordPress and a new version is released to address the issue, the information required to exploit the vulnerability is almost certainly in the public domain. This makes old versions more open to attack, and is one of the primary reasons you should always keep WordPress up to date.

If you are an administrator in charge of more than one WordPress installation, consider using Subversion to make management easier.

How To rename WordPress wp-content directory

To successfully rename the wp-content directory and still have a fully functional website, you need to follow the below steps carefully. Do not miss any of the steps.

• Open the WordPress folder and rename the wp-content folder to “content“( I chose to rename it as content, you can choose any name you want).

Note: After renaming this folder, any activated plugin or theme will be deactivated and will not be listed in their respective pages, since WordPress cannot find them from the default location, wp-content.

• Open the wp-config.php file located at root folder of the WordPress and find below line of code which resides normally at the end of the file:require_once(ABSPATH . ‘wp-settings.php’);
• Above this, add below section of code:

define (‘WP_CONTENT_FOLDERNAME’, ‘content‘);

define (‘WP_CONTENT_DIR’, ABSPATH . WP_CONTENT_FOLDERNAME) ;

define (‘WP_CONTENT_URL’, ‘http://siteurl.com/’.WP_CONTENT_FOLDERNAME);

define (‘WP_PLUGIN_DIR’, WP_CONTENT_DIR . ‘/plugins’);

define (‘WP_PLUGIN_URL’, WP_CONTENT_URL.’/plugins’);

How to change the URL of WordPress Login screen

Many hacking scripts are written specifically to look for “wp-login.php” or “/wp-admin”. So renaming them will harden the website for sure.

• You can rename the wp-login.php or wp-admin slug using the third party plugin named “Rename wp-login.php (unmaintained)“.
• After activating plugin, go to wp-admin >> Settings >> Permalinks >> Rename wp-login.php >> Login URL. Insert “tech“(you can give any name you want) and save.
• Now, your WordPress login screen URL is: http://siteurl.com/tech

Plugins

First of all, make sure your plugins are always updated. Also, if you are not using a specific plugin, delete it from the system.

File Permissions

Some neat features of WordPress come from allowing various files to be writable by the web server. However, allowing write access to your files is potentially dangerous, particularly in a shared hosting environment.

It is best to lock down your file permissions as much as possible and to loosen those restrictions on the occasions that you need to allow write access, or to create specific folders with less restrictions for the purpose of doing things like uploading files.

Disable File Editing

The WordPress Dashboard by default allows administrators to edit PHP files, such as plugin and theme files. This is often the first tool an attacker will use if able to login, since it allows code execution.

WordPress has a constant to disable editing from Dashboard. Placing this line in wp-config.php is equivalent to removing the ‘edit_themes’, ‘edit_plugins’ and ‘edit_files’ capabilities of all users:

define(‘DISALLOW_FILE_EDIT’, true);

1. What if you are not seeing some of the taxonomy options at your menu settings column shown at the left sidebar panel.

While configuring a WordPress custom menu using wp-admin >> Appearance >> Menus section and in case if the system is not populating some of the additional taxonomy options, make sure that you have already checked those meta boxes from the screen option shown at the top left.

2. What is your front end submission form is not populating certain custom fields.

If you are come up with any issue with submission form, All we have to check the settings of Tevolution custom fields because submission form is entirely associated with the custom field module.

If you are not seeing any custom fields over the submission form, Go through your wp-admin >> Tevolution >> Custom fields >> Edit those individual custom field which are currently not populating over the front end,  Now From the “Display Options” make sure that you have already checked the option that says ” Submission form (field will show on editing screen regardless) “.

Make sure that you have already selected appropriate post types and their respective categories from those custom fields’ settings.

Also if you have activated a plugin called “Tevolution-FieldsMonetization” along with the existing directory configuration, Go through your wp-admin >> Tevolution >> Monetization >> Edit those existing price packages >> Make sure that you have selected those custom fields and categories.

3. If we need to increase number of posts to be shown on individual category pages.

With the initial directory setup, Category pages are populating only 5 posts, If you wish to increase this numbers, Go through your wp-admin >> Settings >> Reading settings >> Input the value for the field that says “Blog pages show at most” field.

4. What if the home page multicity map widget is not populating any post type and categories.

Sometimes if we are not seeing any categories and post type over the home page map, Go to the wp-admin >> Tevolution >> Manage Locations >> Cities tab >> Edit your existing cities and make sure that you have already selected those post types and their respective categories.

And for the single city map, you can check those cities and post types from the widget “T → Homepage Map – Single city” placed at any of your active widget area.

5. What if your imported cities are not populating at the header city selector region.

If We have successfully imported some of the cities using the bulk import/export plugin but those cities are not populating at header city selector or T->City Dropdown widget, then we have to assign certain listing/event post to those existing cities.  if those cities are empty or we can say if they are not holding any posts, then they will not be populate over the front end.

6. What if you are not seeing Multy city custom field for the submission page of any post type.

First of all,  Please go through your wp-admin >> Tevolution >> Custom fields >> Edit one of your existing custom field named as “Multi City” (holding an html variable name as post_city_id) and make sure that the custom field is already active and you have checked those post type along with their associated categories.

Now go to your wp-admin >> Tevolution >> Manage Locations >> Check that post type for the option “Activate location management for”

That’s all for today and i hope you will like the topics.

How we can find complete file path for the required page?

This can be useful for any WordPress based theme. if you need to amend certain code for a specific module/page and if you are unable to locate correct file,  you can try performing a below steps.

• Open one of the WordPress files named as template-loader.php placed at “wp-includes” folder.
• At a very end of the file contents, You will find the code as:

if ( $template = apply_filters( 'template_include', $template ) )
include( $template );
return;
endif;

Replace it with the below code:

if ( $template = apply_filters( 'template_include', $template ) ){
echo $template;
include( $template );
return;
}
endif;

• Save the file and refresh the front page
• At top of the page, you will get a complete file path which is used as a main template for the related page

How to find database table prefix for a WordPress multisite.

If you have configured multiple sites using a WordPress multisite network and if we face any sort of trouble finding a correct prefix for any site, follow the below mentioned steps.

• Open the functions.php file located at your theme’s root folder. (functions.php file of the site for which you need to amend the database table contents)
• Just after the opening PHP tag i.e <?php insert the code as echo $wpdb->prefix; and refresh your sites home page, you will get the associated prefix at the top.

Also, check the video link at: https://drive.google.com/file/d/0B4zqYzsurbeFa2FQdXpQb0cwQmM/view?usp=sharing

Events you have added does not appear on the website due to one of the following reasons:

1. Also make sure that you have not changed option values for that particular custom field. we need to keep values as “Regular event, Recurring event“. You can edit values for option title field instead.
2. First of all, Go to Your wp-admin >> Tevolution >>  Custom fields >> Click over the event post type tab >> Make sure that you have already enabled one of the default mandatory custom field named as “Consider this event as” (Holding an html variable named as event_type )
3. Also make sure that below listed custom fields are already active and visible at both font end/back end.

• Event start date,
• Event End date,
• Start time,
• End time. 

4. Along with this, if you are getting the pid=0 upon successful submission, make sure that you have already enabled custom fields Post Title, Post Category, Post Content, Post images from the same Custom Fields module.

This is one of the most common problem for which we are receiving many support queries since the initial release of Directory.

If you are facing any relevant issue with the image upload process, here are few troubleshooting tips you can consider before asking for support.

1. First of all, Go to your Wp-admin >> Settings >> Submission Page >> Specify appropriate image size in kilobyte for the field that says “Maximum image upload size“

2. Now connect your ftp (https://templatic.com/docs/how-to-upload-and-edit-files-on-your-server-ftp-tutorial/) and go through the folder wp-content\themes\Directory\images\ and make sure that one of the sub-folder is already exist with the name as tmp  (the directory should look look like wp-content\themes\Directory\images\tmp )

3. In case if the system has not auto-generated that folder during the directory activation process, try adding that folder manually with the same name and assign writable permission as 777 to it.

4. If the issue still persists, Try deactivating all your third party non templatic installed plugins.

I hope this will certainly gonna help you to resolve similar issues with the upload process.

Many times we are receiving support queries in which some of the directory users needed to configure country Based directory site instead of cities.

There is no direct way to do this but we have a workaround for this which works quite well, Follow these steps to achieve this:

1) First of all, Go through your Wp-admin >> Tevolution >> Manage Locations >> Set City selector levels as “Only Cities“

2) Now go through the cities tab, While editing or inserting the cities, Choose your required country from the first drop-down, select any random state and keep the same as of your selected country for the city name field.

3) Save all the changes.

4) Now you can change the naming directly from the .po/.mo file placed at your themes/Directory/languages folder.  (depends upon which directory product you are using right now, if you have activated any child theme then you have to translate .po/.mo file contents from the themes/directorychildtheme name/languages folder.  )

Replace the term “city” entirely with the “country” from .po/.mo file.

For example the string initially reads select your nearest city, we have to replace it with “Select Your nearest country“

Do the same for all the rest of the strings too.

5)  After doing all the settings, you should also need to assign few listings under those countries in order to populate them over the front end city selector region.

If you have been using WordPress for a few years, then you have encountered the white screen of death at least once.

The reason why this issue is frustrating for users is because it locks you out of your WordPress admin panel. Because there is no error output in most cases, you are left clueless to figure out what is the issue.

The worst thing about white screen of death is that sometimes it will only affect a certain part of your site. For example, you may only see the white screen of death on your WordPress admin while everything else works fine. In other cases, you may only see it on a specific post whereas everything else runs just fine.

In this article, we will show you how to fix the white screen of death by looking at a few possible solutions.

Note: Before you make any changes to your site, make sure you have sufficient backups.

Increasing the Memory Limit

Usually this issue happens because your memory is being exhausted. This is how you can increase your WordPress memory on your server:

1. Edit your wp-config.php file located at root folder of the WordPress and enter something like:

define(‘WP_MEMORY_LIMIT’, ‘256M’);

WordPress memory can be different to the server – you need to set this regardless of server memory settings

http://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP

2. If you have access to your PHP.ini file, change the line in PHP.ini

If your line shows 32M try 256M:

memory_limit = 256M ;

3. If you don’t have access to PHP.ini try adding this to an .htaccess file:

php_value memory_limit 256M

4. If none of the above works then talk to your host.

Disabling All Third Party Plugins

If increasing the memory limit did not help, then you need to start troubleshooting. In our experience of troubleshooting this issue, we have always found that the issue is either with a specific plugin or a theme. Let’s go ahead and disable all the third party plugins installed on your site.

If this fixes the issue, then enable one plugin at a time to get to the bottom of the issue.

Error in Code

You were modifying your theme’s functions.php file or another PHP file via the WordPress Theme Editor. You might even see a message like this on your white screen:

Parse error: syntax error, unexpected $end in /home/name/public_html/wordpress/wp-content/themes/your_theme/functions.php on line 231

This means there’s a flaw in your code. WordPress can’t work if your code is broken, so you’ll have to revisit the file you were modifying and change it back to how it was before the white screen appeared.

The problem, of course, is that you may not be able to access the file because a white screen stands between you and the WordPress Theme Editor. This is very likely to be true if you were modifying functions.php when you were thwarted by the white screen of death. The best way to fix the problem is to upload a working version of the file (we’ll use functions.php as an example) to WordPress using your FTP tool.

Corrupted file(s)

The files or database may be corrupted due to malware or another cause. Contact your web host and ask them to diagnose the problem.

Cause unknown

It’s situations like this when WP_DEBUG really comes in handy. Not sure why you’re white screening? Just read the error message and remove, modify, or overwrite the file that’s breaking your site. Even if you’re not using WP_DEBUG, fear not. There are other ways to bring your website back.

To do that follow below steps:

• Go to you active WordPress folder > wp-config.php
• There will be a method defined

define(‘WP_DEBUG’, false);

• Just write true at the place of false
• Refresh your site’s front end.
• This will activate the debug mode & then you will be able to see the exact error in the exact file in your browser screen.
• Also, you can add the code “error_reporting(E_ALL);” in php file in your particular Theme folder for the same above purpose.

Generally, it occurs when due to any reason, the same function or class name is used at more than one place/file. So, to rectify it,

• Go to the files which are written in the error & locate the function/class that are used more than single time using the “Line Number” mentioned in the error.
• Add the code for class

if(!class_exists(‘class_name’)){

• OR for functions

if(!function_exists(‘function_name’)){

• Above the line number shown in the error
• Save the file & refresh your site. It must be working now!

Hope this helps whenever you face this white screen of death again!