1. Description of the theme

This theme will help you build your own escort directory in minutes.
Once you install it it's ready to go.
No need for configurations, no need for 10 extra plugins, just the theme.
We built this theme based on client feedback and we'll continue to update the theme and make it even better.

2. Installation

2.1 Method 1: install the theme from your WordPress Administration Panel

1. Go to your WordPress Administration Panel (http://DOMAIN.COM/wp-admin/), login if necessary, and navigate to "Appearance"->"Themes".
   
2. Click the "Install theme" tab and then the "Upload" link from that page.
   
3. Click on the "Browser" button and navigate to the theme directory and select the escortwp.zip file then click the "Install Now" button.
4. After you upload the theme you should see a screen like in the image bellow. Click the "Activate" link.
   

2.2 Method 2: install the theme by FTP

1. On your computer navigate to the folder containing the theme and unzip the archive escortwp.zip. This should create a new folder named "escortwp".
2. Open your favorite FTP client(we recommend FileZilla for a free alternative or FlashFXP for a paid alternative)
3. Log in to your web server and navigate to the directory where WordPress has been installed, then (within the WordPress installation) to the themes subdirectory. Normally the themes directory is in /wp-content/themes/
4. Using your FTP client copy the entire "escortwp" folder (including the folder itself) from your computer to the /wp-content/themes/ directory on the web server
5. Go to your WordPress Administration Panel (http://DOMAIN.COM/wp-admin/), login if necessary, and navigate to "Appearance"->"Themes".
   
   You should see "EscortWP" on the list of available themes. Simply click "Activate" under the theme's thumbnail and the theme will take it from there.

3. Getting started and what you should know about your theme

After you have activated your theme you will see an installation screen for the theme.
The theme comes with a predefined list of all the countries in the world. You can choose to add the whole list to your website so that escorts from all over the world can add their profiles.
If you prefer to manage a site with escorts only from a certain region or from a single country then install the theme without any countries and then add only the countries you need.

Adding countries is done from the WordPress Admin Panel by clicking "Escorts"->"Countries"

After you have installed the theme the first things you should do is change your permalink structure so your website can use more search engine friendly urls.

To do this you will have to go to your WordPress Admin Panel and click "Settings"->"Permalinks"
From the "Common Settings" choose "Post name" from the list and then click "Save changes".

When you first install your blog, WordPress will automatically add a set of demo widgets to your sidebars. You don't need them so you should remove them from the sidebar of the theme.
To do this you will have to go to the page located at "Appearance"->"Widgets".
In this page you will see a list of widgets in the right side of the page. Click on the widget name(your cursor pointer will change) and drag it to the left side of the page under "Available Widgets" section.

If you do want to leave some of the widgets in the sidebar that is not a problem but we think you won't need most of the widgets from that predefined list.

After this we recommended you go to the front page of the site and check your admin pages and set your site settings.

All your admin pages can be found on the front side of your website. You will find all your admin pages hidden under a drop down menu in the top right sidebar labeled "Admin links". You will not find any admin pages in your WordPress Admin Panel.
Everything is done from the front side of your site and you will manage all the escorts from the front side also.

All other user types from your website will also have this dropdown menu but it will only contain links needed to manage their specific account type.

All escorts should be added from the frontpage of the site. Never add escorts or agencies from the WordPress Admin Panel like you would add a normal blog post.

On your website there are two types of escorts: independent escorts and escorts added by agencies.
Independent escorts can edit their own account and can only add a single escort account for themselves.
Agencies can add multiple escorts account under a single master agency account. These escorts have no way of editing the accounts by themselves.

If you have lots of escorts to add then we recommended that you add an agency first(you have a link in your admin dropdown) and then add all the escorts under that account.
As an admin you can't add escorts under your account. The admin account is only used for managing the site.

4. Theme admin pages

4.1 Blacklisted Clients

This is the page where you can add clients to the blacklist or search for clients who have been already added by you or by agencies.

The blacklisted clients section serves to have a list of clients who created problems for the escorts that is viewable by all agencies on the website

When adding a client to the blacklist you will need to fill in all 3 fields.

When searching for a client in the blacklist you can search only be email or only by phone.

4.2 Blacklisted Escorts

The escorts blacklist is visible to normal and VIP members and is used to have a list of escorts who have created problems for the agencies or the clients.

On this page you can add an escort or search for escorts that are already in on the blacklist.

4.3 Manage Job Adverts

Admins and agencies can post job offers

If anyone is interested in a job posted by an agency then they can visit the jobs section from the website

4.4 Add agency

If you need to add lots of escorts to the website you will need to first create an agency and then add the escorts under that agency.

In the process of creating a new agency the theme will also create a separate username for that agency. On this page you can create accounts on behalf of other agencies or you can create accounts to use for yourself.

If the account is for yourself you don't necessarily need to remember the username and password since admins have access to the agency's escorts. Just enter a valid email address in the process of adding the agency.

4.5 Add independent escort

When adding an independent escort the theme will create a separate username for that escort. You can then pass the username login information to the escort or manage the escort yourself.
When adding an escort as an admin, the email address does not need to be validated anymore and if you set a price for escort registration the account will get published on the site without the need for payment

4.6 Activate tour

If you have chosen a manual payment option in your Payment settings page and you also chose a price for tour adding to your website then you will have to manually activate the tours added by escorts or by agencies.

Escorts or agencies will contact you once they have made the payment for a tour and they will communicate the tour ID to you. After you confirmed the payment has been made you will have to click the link and a new panel will appear above your right sidebar.

Enter the tour ID there and simply click the "Activate tour" button.

4.7 Activate/Extend VIP user

If you have chosen a manual payment option in your Payment settings page and you also chose a price for users to become VIP members on your website then you will have to manually activate the VIP status for your members.

Members will contact you once they have made the payment and they will communicate their user ID to you. After you have confirmed the payment was made you will have to click the link and a new panel will appear above your right sidebar.

Enter the user ID in the field, choose the period you want your user to have VIP status, and simply click the "Activate VIP user" button.

If an user already has VIP status and you want to extend his status then the process is the same. The period of time you choose will be added to time the user still has left from his VIP status

From this section you can also remove the VIP status of members. The theme automatically removes the VIP status when the time expires but if you want to remove the status for a user manually then you can do that too. You don't need to select any period for this step. Just enter the user ID.

4.8 Site Settings

1. Site language

   The theme comes by default with an english language file. If you have created a new language file then you can change the default website language from this field.
   

   If you want to translate your theme from english to another language you will have to go to your /lang folder from the theme directory and duplicate the english.php file and rename the file to the new language name (Example: chinese.php, spanish.php, dutch.php).
   All files should have lowercase names and without any spaces or special characters in the name.
   Open your new file and translate all the sentences from english to your preferred language.
   If a sentence begins with uppercase then you should also write your translation with uppercase. This is for pure aspect purposes only.
   If you use the ' (single quote) symbol in your translation then you will have to write it like this: \'
   Put a back slash in front of the sign.

   Once you have translated everything your new language should be displayed in the dropdpown list for you to select.
   If you feel like sharing your translation then please send the new language file to contact@escortwp.com so we can include it in the theme.

2. Site name & Site description

   The "Site name" field will be used as the your website's overall name. The name you enter will also be used in the top left part of the header. If you uploaded a logo then the logo will be displayed instead of the name, in the header.

   The "Site description" will be displayed under the site's name in the header. IF you have uploaded a logo for your website then the description will be displayed under the logo

3. Site logo

   You can upload a logo for your website that will be displayed in the top left part of the header and also on the login page.

   The logo will be displayed in its original size so make sure you resize your logo to look good in the header, before you upload it.

   If a logo is already uploaded and you upload a new one then the old logo image is automatically deleted.

4. Social sites

   If you use social website then you can enter your profile url in these fields.

   The urls will be placed in the top right part of the website in icon format

5. Manually activate...

   Here you have the option to choose what you want to manually activate yourself or what you want to be activate automatically. The option names are pretty self-explanatory

   If you choose to activate the agencies or escorts profiles manually then the profiles will not become activate until you do so even if the users pays for their account

   All user accounts need to pass the email validation check first.

4.9 Hide/Show Site Sections

Here you will be able to edit what parts of the site to hide or change settings for some parts of the website.

Some options are self-explanatory so we'll only explain some of the options.

1. Show header slider?

   The header slider is a carousel type slider that displays escort profile. The slider is displayed in the top section of the website, immediately after the header.

   For an escort to appear in the slider they first need to buy a "featured" status.

   The slider shows only 5 escorts at a time in random order(each refresh of the website changes profiles being displayed) and the rest of the escorts can be viewed by clicking on some arrows

   If you have disabled the display of the header slider and have set a price for the featured status then the payment button for the featured status will not be shown until you activate the slider.

2. Show agreement/disclaimer

   If you activate this option then users who visit your website will first need to confirm they are 18(or of legal age in their country) and also agree with your terms of service before viewing the site.

   If you want to change the text from the disclaimer then edit the file "footer-tos-18years-agreement-overlay.php" from your theme directory.

3. Show unchecked services on escort profile page?

   When an escort registers on your website they can choose what services they can provide for their clients.

   By default, the unchecked services are still displayed on the escort's profile but with a red X icon next to the service to indicate the service is not available. The available services will have a green checked icon to indicate that service is available.

   If you choose "No" then the unchecked services will not be listed on the escort's profile anymore. Only the available services will be shown.

4. Show language dropdown in header?

   If you have more then one language file for your website then you might want to give the possibility to your visitors to choose their own language.

   Activating this option will place a dropdown list in the header, next to the "Login/Logout" link, with all the available languages for your website.

   The option a user selects is stored in a cookie on the visitor's computer so it's not mandatory for the user to be registered on your website for the visitor to navigate your website in his prefered language.

4.10 Edit Registration Form

From this page you can control what fields an escort needs to fill in in order to register on your website, what fields are mandatory in the registration process and also the fields you wish to have available on the advanced search page

Some of the fields can't be changed because the theme needs those fields in order to correctly display the escort on your website

When you choose to hide a fields from the registration field, the "mandatory" and the "use in search page" fields will also be set to "no" after you save the page
If you hide a field from the registration form then there is no need to have the field mandatory anymore and there is no point to have it as a filter in the search page either

4.11 Payment Settings

The theme offers several payment options to choose from.

Choosing any of the payment options means you need to first have an account on the chosen payment processor site so you can accept payments in your account.
We would like to point out that Payza(formerly known as AlertPay) and PayPal will not accept adult payments so be carefull how you use them.

When choosing one of the payment processors you will have to fill in certain identification information so that the theme can create the payment buttons.

The theme also provides a manual payment option.
Choosing "Other" from the payment gateway list will allow you to to use a bank account for your payments, Western Union, Moneybookers or any other payment processor you want.

Whatever you write as the payment instructions will be displayed instead of the payment buttons.

Your users will see the instructions and will need to follow them in order to buy anything on your website.
Since this is a manual form of payment you will need to activate/upgrade/edit the account yourself after you confirm the payment. The theme has all the manual upgrade options at your disposal.

The following payment options are for the automated payment options and they will not work if you choose "Other" from the payment gateway.
You should still configure the payments since the values will be seen by your users when they will try to buy something with the manual payment option.

If you choose an automatic payment gateway then the confirmation of payment, payment emails, account activation, checking expired accounts, sending reminders before an account expires, all of this will be handled by the theme.

1. Agency registration
   Charge a fee when a user registers on your website for an agency account

   Setting a price for this option means that any user who registers on your website as an agency will have to pay a price in order to have his account published on your site.

   The payment a user makes can be configured in several ways

   If you want your user to buy a lifetime account then select "Forever" as the period.
   If you do this then you can't choose "Yes" from "recurring payments".

   If you choose a period of at least 1 day as the period the account will be active after the payment then you have two options. You can either choose "No" for the "recurring payments" option wich means the user pays once and he will not be billed again when the period expires or you can choose "Yes" from the "recurring payments" field and when the user first pays he will actually create a subscription on your website. When the period expires the user will be automatically billed again for his account.

   If the recurring payment is not activated and an agency does not continue the subscription payment then the agency account with all the escorts added by that agency will be deleted from the site after the period expires.
   The user will be notified by email 2 days before this happens to give the user time to pay for the extension of his account

   Users with a subscription payment will not get those emails since their account will auto renew automatically

2. Agency adding escort
   Charge a fee each time an agency wants to add a new escort to their agency profile
3. Independent Escort Registration
   Charge a fee when a user registers on your website for an independent escort account

   This is different from the "Agency adding escort" option because independent escorts can only add a single escort profile(theirs), while an agency can add as many escorts as they want

4. Premium options
   Charge a fee when an escort wants to have a "Premium" label

   Check the escort labels section for more details about what it means to be a premium escort.

5. Featured options
   Charge a fee when an escort want's to become a featured escort

   Check the escort labels section for more details about what it means to be a premium escort.

6. Tour options
   Charge a one time fee when an escort adds a tour to her profile
7. VIP options
   Charge a fee when a member wants to become a VIP member and have extra access to the site

   If you set a price for the VIP section then you also need to choose what the VIP member receives for his payment.

   Checking options from the "Keep the following profile sections locked until payment is made" list will restrict access to normal members to those sections until they pay a fee.
   Leaving sections unchecked means that those sections will be visible to normal members also.

   The fee can be set to unlock a single escort profile or to unlock all escort profile(VIP status).

   If you want the user to pay each time he wants to unlock the profile of an escort then the unlocked profile will stay unlocked forever.
   You can't choose a period or a recurring method if the payment is for unlock only.

   True VIP members are only the ones who pay a membership for your website and they will have access to all escorts.

   If a user fails to renew his subscription then hes VIP status will be removed. The user will not be deleted from the website.

The payment options are pretty easy to understand but if you are unsure of some of the upgrades a user can buy then visit the "User labels" section.

4.12 Email Settings

On this page you can choose what notifications you want to receive from your website.

From the first section of the page you can choose the identity you want o have when users receive an email from your website. The emails can be for account registration, account activation, reminders to extend their subscription etc

The email signature will be at the end of all emails sent from your website, even in the emails sent by a user to an escort with the help of the contact form.

The second section of the page lets when to be notified of user actions on your website.
The email you write here will only be used to send notifications to that email. It will not be used for anything else.

4.13 WordPress Admin

Sometimes you might need to go to your WordPress Admin Panel to install plugins or manage other aspects not covered by the theme. This is a quick shortcut link to help you get there.

5. Website sections

5.1. Frontpage

The frontpage is structured in the following manner:
- a header (shown on all pages of the website)
- a left sidebar with a country list (shown on all pages of the website)
- a right sidebar with a "Quick search" section and if the user is logged in then the sidebar will also display account option links (shown on all pages of the website)
- the middle section will display a list of premium escorts first, followed by a list of normal escorts with the newest registered escorts shown and unde that a list of newest escort reviews
- under all of this there will be the widgetized footer area (shown on all pages of the website)

5.2. Our Escorts (Female/Male/Gay/Trans/Independent)

The "Our escorts" page will display all the escorts from your website, of all genders and independent or agency escorts all in a single list.
Premium escorts, as usual, will be shown first.

From that page, or from the header dropdown, a visitor can choose to go to a certain gender page or to only see independent escorts.
Gender specific pages contain independent escorts and agency escorts in a single list while the independent escorts page will have all the genders in a single list.

5.3. Escorts on Tour

The escorts on your website can add tours to their profiles. This shows visitors that that certain escorts will be traveling to another city or country, other then the usual city she signed up as being part of.
All escort tours can be seen on this page.

5.4. Agencies

This page holds a list of all the agencies from your website, along with the number of escorts each agency added, in alphabetical order from A to Z.

5.5. Escort Reviews

Escort reviews will be shown on the individual escort profile pages but they can also be viewed in this page as a full review list.

5.6. Job Adverts

Admins and agencies have the option in their account to add job offers on your website. This page shows all jobs posted and they can also be filtered by "offering" and "looking"

5.7. Blacklisted Escorts

The blacklist escorts page is visible to normal and VIP members and is used to have a list of escorts who have created problems for the agencies or the clients.

5.8. Search

This is the page where your visitors can search for a specific kind of escorts.

5.9. Contact Us

This page is used to send you messages. You don't need to install any kind of contact form plugin for the form to work.

6. User types

6.1 Independent escorts

Users who register on your website as an independent escort can add and manage a single escort profile(theirs).

6.2 Agencies

Agencies can add and manage an unlimited number of escort profiles. Besides the escort profiles they can also manage their own agency profile page. They can not add multiple agency profile. Just a single one.

6.3 Normal members

Normal members do not have many options on the website but a simple visitor will not be able to add reviews to an escort for example so in order to add a review a visitor will need to register on the website.
Registered users can also contact escorts(unless you chose to reserve this only for VIP) and add escorts to a favorites list.

6.4 VIP members

If you chose to activate VIP membership on your website then this type of member will be able to do whatever the normal member account can't

7. Escort labels

7.1. Premium

A premium escort will always be shown first in all the escort listings from your website above the normal escorts. Premium escorts will also have a gold colored "Premium" label next to their picture.

7.2. Verified

All escorts have a section in their account named "100% verify".
On that page escorts can upload an image with themselves holding a piece of paper with your website's name.
This ensured that the account has been added by the escort and not by someone else.

When an escort ads an image to the "100% verify" page you will be notified by email and you will receive the url of the escort. After you confirm that the escort is a real person then you can grant "Verified" status to the escort.

7.3. New

All escorts that have registered on your website in less then 2 weeks ago will have a pink "New" label on their thumbnail image.

7.4. Featured

The featured status is not a label since it will not be shown on their profile thumbnail in the listings. An escort can buy a "Featured" status if you chose a price for the status.

After an escort has purchased a featured status they will be placed in the header slider for more visibility.

8. Known theme incompatibilities with other plugins:

1. wp super cache(or any other caching plugin)
   The pages will not reflect some changes made by the profile user. For example newly uploaded images.
2. maintenance mode In maintenance mode the AJAX requests from the theme will not work. Ajax is used for image uploading and other featuers.
3. JetPack plugin
   It seems to be a bug in the "Shortcode Embeds" section of the Jetpack plugin that makes the agency page repeat itself. Go to your Jetpack page, in your WordPress admin section, click "Learn more" from the "Shortcode Embeds" extension and then a "Deactivate" button will appear next to the "Learn more" button. Click the "Deactivate" button and it should fix the problem.