# Domain Seller - Domain For Sale Responsive Template

Selling your domains couldn't be easier with domain seller.

Go To My Themeforest Profile

Thanks for purchasing Domain Seller! This guide will cover the setup and common customisation tasks you may encounter. If you need support feel free to contact me via E-mail.

# Basic Setup get up and running, fast.

Note that since this theme uses PHP, you will need to run it on an actual web server to view the results. If you want to preview changes on your local computer, I suggest using a local server such as MAMP (supports both OS X and Windows). If you are using a local server, also note that non-SMTP emails will not be sent until you upload Domain Seller to your web host.

## Option 1 - Using the Visual Editor

Domain Seller comes with a visual editor that updates in real-time as you make changes, so you can see how a change will look before saving it (in most cases).

You can login to the editor with either a Google, Microsoft, or LinkedIn account.
To set this up, you'll need to input your email, and set up an app using the account provider of your choice. It's easier than it sounds! Just follow these steps, and use the checkboxes if you want to keep track of your progress—it will be remembered even after closing this window and coming back later.

1. Open config.php in your text editor
2. Go to line 69, it should start with `'editor_login_email'`
3. Replace the placeholder value with the email address associated with your account. For example, if you want to use Google, and that account logs in with “info@somecompany.com”, use that address.
4. Set up an app with the account provider of your choice:

Google

1. Go to the Google Developers Console
2. Click the Create Project button
3. Give it a title, for example "Domain Seller" then click Create
4. Go to APIs & Auth, then Credentials
5. Under OAuth, click Create a new Client ID
6. Choose "Web Application" as the type, then click Configure consent screen
7. Enter a Product name, example: "Domain Seller" then click Save
8. Under "Authorized redirect URIs", enter your domain's URL, followed by `/auth/google/oauth2callback`. For example, if your domain was "mydomain.com", you would enter `http://mydomain.com/auth/google/oauth2callback`
9. Now the credentials we need are ready. Under the heading "Client ID for web application", copy the "Client ID" value
10. In config.php, go to line 60 and paste the value in place of `*GOOGLE_CLIENT_ID_VALUE*`
11. It's the same idea for "Client secret". Copy that setting from the Google Developers Console and paste it in place of `*GOOGLE_CLIENT_SECRET_VALUE*`. You've set up OAuth with Google!

Microsoft

1. Go to the Microsoft account Developer Center
2. Under "My applications", click Create application
3. Enter the Application name, for example "Domain Seller", read the terms of use, then click I accept
4. Go to API Settings
5. Fill out the Redirect URLs field with your domain's URL, followed by `/auth/live/oauth2callback`. For example, if your domain was "mydomain.com", you would enter `http://mydomain.com/auth/live/oauth2callback`. Save the change
6. Go to App Settings
7. Copy the Client ID and paste that value into config.php (line 65), replacing `*LIVE_CLIENT_ID_VALUE*`
8. Repeat the last step, this time with the Client secret and `*LIVE_CLIENT_SECRET_VALUE*`. You've set up OAuth with Microsoft!

LinkedIn

1. Go to the LinkedIn Developers website
2. Click Create Application
3. Fill in the required fields. The data you enter will only be seen by you. For the Application Logo URL feel free to use this one: `https://dl.dropboxusercontent.com/u/827897/db2-app-icon-310.png`. Then read and agree to the terms of use and click Submit
4. Under "OAuth 2.0", fill out the "Authorized Redirect URLs" field with your domain's URL, followed by `/auth/linkedin/oauth2callback`. For example, if your domain was "mydomain.com", you would enter `http://mydomain.com/auth/linkedin/oauth2callback`, click Add, then click Update to save your changes
5. Copy the Client ID and paste that value into config.php (line 71), replacing `*LINKEDIN_API_KEY_VALUE*`
6. Repeat the last step, this time with the Client Secret and `*LINKEDIN_SECRET_KEY_VALUE*`. You've set up OAuth with LinkedIn!

1. Upload the files to your web hosting. Use FTP to upload all the files inside the domainseller folder to your web root. For most web hosts this will be `public_html`. If you're having trouble uploading the files please contact your web host for support.
2. Browse to `http://yourdomain.com/?editor` (replacing yourdomain.com with your actual domain name) and log in with the account provider you set up, then edit away!

config.php - example of changing the editor_login_email setting.

    'editor_login_email' => 'hello@somedomain.com',

## Visual Editor - Editing with ease

`The Visual Editor` is perfect for those without any technical knowledge. You can design your website quickly, and then devote your time and energy on what is really important like selling those domains. Below is a complete breakdown of each option and what it does.
Remember to always save your changes when you have finished editing.

Setting | Description
--- | ---
Domains
`Add Domains` | In the editor you can manually add each domain for multi-domain setup. To learn more please refer to Multi-Domain Setup. When entering these fields the information will be shown on each domain including the domain you have installed Domain Seller on. Note: The first thing you should do is change yourdomain.com to the name of your domain you have uploaded Domain Seller to in order to view all the features.
`Domain` | The domain name and link shown in the more domain portfolio section.
`Price` | (optional) The price or minimum price of the domain you wish to sell.
`Price Description` | (optional) The description below the price e.g. `Minimum bid`
`Stat Description` | (optional) Some text in the offer form below "submit your offer" e.g. `Premium domain`
`Domain Portfolio ON/OFF` | The domain portfolio is the left or top tab (depending on which screen size you are using) titled "more domains", this is turned `>ON` by default. To disable, toggle it `OFF`
Main Text
`Text Next To The Domain Name` | (optional) Custom text next to the domain name you would like to show `e.g. is now available for sale. Hurry and make an offer`
`Text Under The Domain Name` | (optional) Custom text under the domain name you would like to show `e.g. Or Please Call +00 000 000 0000`
Offer Form These settings relate to the email notification you receive when someone sends you an offer. If no password and SMTP server is entered, email will be sent without authentication, however I recommend filling it out to improve the deliverability of email.
`Recipient Name` | Will show up as the "From" name in the emails you receive.
`Recipient Email` | Your email address.
`Recipient Email Password` | (optional) Your email password, required to send the emails using SMTP.
`Smtp Server` | (optional) The SMTP server address of your email provider. If you're not sure what this is, search online (example: "gmail smtp server address") or contact your provider directly.
reCAPTCHA spam protection reCAPTCHA works to prevent spam by asking users to check a box before sending the form. To use this feature, sign up with your domain name at Google's reCAPTCHA website. You will need the public and private keys provided by the website for the settings below. If you’re using reCAPTCHA with multiple domains please take note of the following – Google has disabled a feature called “secure token” on May 18th, 2016. Instead of entering all your domains in reCAPTCHA’s admin page simply disable Domain Name Validation in “Advanced Settings” on the reCAPTCHA admin page to benefit from this change.
`Recaptcha ON/OFF` | Enable reCAPTCHA spam protection? To enable, toggle it `ON` To disable, toggle it `OFF`
`Recaptcha Site Key` | Paste the site key from the reCAPTCHA website here.
`Recaptcha Private Key` | Paste the private key from the reCAPTCHA website here.
Footer
`Social Footer Section ON/OFF` | The social footer section are the social icons in the footer this will turn the section on and off, this is turned `ON` by default. To disable, toggle it `OFF`
`Website Visits ON/OFF` | The website visits shows how many people visit your website this is located in the footer and turned `ON` by default. To disable, toggle it `OFF`
`Text Above The Social Icons` | (optional) Custom text above the social icons `e.g. Lets Get Connected`
`Twitter ID` | (optional) Just your twitter name without the "@" symbol, which will be linked to your Twitter profile page.
| `Facebook ID` | (optional) Just your Facebook ID or name, which will be linked to your Facebook profile page. | `Google Plus ID` | (optional) Just your Google Plus ID or name, which will be linked to your Google Plus profile page. | `Linkedin ID ID` | (optional) Just your Linkedin ID or name, which will be linked to your Linkedin profile page. | `Youtube ID` | (optional) Just your Youtube ID or name, which will be linked to your Youtube profile page. | `Pinterest ID` | (optional) Just your Pinterest ID or name, which will be linked to your Pinterest profile page. | `Tumblr ID` | (optional) Just your Tumblr ID or name, which will be linked to your Tumblr profile page.
Theme Style
`Background Color` | (optional) Adds a custom background color and a background color to the Footer, Offer Form, Domain Portfolio and more domains button.
`Text Color` | (optional) Adds a custom text color to the body, footer, header, offer form header, domain portfolio header and more domain button.
`Theme Color` | (optional) Adds a custom text color to the domain text, footer icons, stats icon, price, offer form body text and more domain portfolio links.
`Image` | (optional) Adds a background image to the website.
`Texture` | (optional) Adds a texture overlay to the background image or texture to the websites background.
Google Adsense
`Client Handle` | In order to obtain this go to your google adsense page and click on AD units, then click on get code for the advert you wish to use and within the ad code copy just your data-ad-client ID
| `Slot Handle` | In order to obtain this go to your google adsense page and click on AD units, then click on get code for the advert you wish to use and within the ad code copy just your data-ad-slot ID

# Multi-Domain Setup using multiple domains with one install

This is the cool part—you can have multiple domains point to one installation of Domain Seller, and it will automatically show the right info for the current domain!

Requirements: you must have either a CPanel web host that allows parked/alias domains, or a Plesk web host that allows you to set up alias domains. Alternately, if you have a server tech, they'll be able to set alias domains up.

1. Point each domain name to your web hosting's nameservers
2. Except for your primary domain, set up domain aliases for each domain name that point to your primary domain name (the one you signed up with for your web hosting).
   - CPanel instructions
   - Plesk instructions
3. In the editor select domains and add your domains one by one including the price, price description and description (optional).

Now browse to each domain and test it out, you should be all set!
Note that if you've just updated the nameservers for your domains, it could take up to 48 hours to work.

# Styling customising the design

## Adding Background Images

You can add a custom background image by placing an image file inside the folder "assets/images/" using this format: `bg-imagename.jpg`.
Now go to Theme Style in the editor panel and select your new image. Save and refresh your browser

## Adding Background Textures

You can add a custom texture image by placing an image file inside the folder "assets/images/" using this format: `texture-texturename.png`.
Now go to Theme Style in the editor panel and select your new . Save and refresh your browser

## Editing the CSS

The main stylesheet is located at `assets/css/design.css` You can change the theme stying if your familiar with the CSS language.

# Credits

Thank you to the open-source community.

- jQuery—the "write less, do more" library for JavaScript
- Dirty Forms—a jQuery plugin to help prevent users from losing data when editing forms
- PHP Mailer—The PHP email class
- jQuery Validation Plugin—form validation made easy
- Bootstrap—the most popular HTML, CSS, and JavaScript framework for developing responsive, mobile first projects on the web
- Font Awesome—Gives you scalable vector icons that can instantly be customised
- Big Slide—jQuery plugin for creating off-screen slide panel navigation
- Opauth—multi-provider authentication framework for PHP
- Google Fonts

Thats all folks! I hope you found this documentation helpful. For support and customisation requests, feel free to contact me via E-mail. For other custom web design or development, please visit my website for pricing and contact options.